@mudah-cli/mudah 0.7.0 → 0.9.0

package/dist/commands/telemetry.command.js

@@ -0,0 +1,55 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { Command } from '@mudah-cli/console';
+import { clearTelemetryLog, readTelemetryLog, TELEMETRY_FILE, t } from '@mudah-cli/core';
+/**
+ * Built-in `telemetry` — summarize the events written to
+ * `.mudah/telemetry.jsonl` (see `telemetry: true` in `mudah.json`), or clear
+ * the log. Under `--json` the summary is emitted as a data payload.
+ */
+export default class TelemetryCommand extends Command {
+    signature = 'telemetry [--clear]';
+    description = 'Summarize or clear the local telemetry log';
+    descriptionKey = 'cmd.telemetry.description';
+    async handle() {
+        const file = join(this.app.basePath, TELEMETRY_FILE);
+        if (this.option('clear') === true) {
+            const removed = clearTelemetryLog(file);
+            this.output.success(removed ? `Cleared ${file}` : t('telemetry.empty'));
+            return;
+        }
+        if (!existsSync(file)) {
+            this.output.info(t('telemetry.absent'));
+            this.output.hint('Set "telemetry": true in mudah.json (or MUDAH_TELEMETRY=1) and run a command.');
+            return;
+        }
+        const summary = readTelemetryLog(file);
+        if (this.output.isMachineReadable) {
+            this.output.emit('data', 'telemetry', summary);
+            return;
+        }
+        if (summary.events === 0) {
+            this.output.info(t('telemetry.empty'));
+            return;
+        }
+        this.output.section('Telemetry');
+        this.output.keyValue('file', file);
+        this.output.keyValue('events', String(summary.events));
+        this.output.keyValue('span', `${summary.spanMs}ms`);
+        this.output.line();
+        this.output.table([
+            { header: 'name', align: 'left' },
+            { header: 'count', align: 'right' },
+            { header: 'total', align: 'right' },
+            { header: 'max', align: 'right' },
+            { header: 'mean', align: 'right' },
+        ], summary.rows.map((row) => [
+            row.name,
+            String(row.count),
+            `${row.totalMs}ms`,
+            `${row.maxMs}ms`,
+            `${row.meanMs}ms`,
+        ]));
+    }
+}
+//# sourceMappingURL=telemetry.command.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `test` command: spawn vitest, or list matching `*.test.ts` files.
+ */
+export default class TestCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    static exitCodes: {
+        1: string;
+    };
+    handle(): Promise<number>;
+}

package/dist/commands/test.command.js

@@ -0,0 +1,83 @@
+import { spawn } from 'node:child_process';
+import { readdir } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { Command } from '@mudah-cli/console';
+async function walkTests(dir, pattern, acc) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name === '.git')
+            continue;
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walkTests(full, pattern, acc);
+            continue;
+        }
+        if (!entry.name.endsWith('.test.ts'))
+            continue;
+        if (pattern !== undefined && !full.includes(pattern) && !entry.name.includes(pattern))
+            continue;
+        acc.push(full);
+    }
+}
+function runVitest(cwd, pattern, flags) {
+    return new Promise((resolve) => {
+        const args = ['vitest', flags.watch ? 'watch' : 'run'];
+        if (pattern !== undefined)
+            args.push(pattern);
+        if (flags.coverage)
+            args.push('--coverage');
+        if (process.env['UPDATE_SNAPSHOT'] === '1')
+            args.push('--update');
+        const child = spawn('npx', ['--no-install', ...args], {
+            cwd,
+            stdio: 'inherit',
+            env: process.env,
+        });
+        child.on('error', () => resolve(undefined));
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+}
+/**
+ * Built-in `test` command: spawn vitest, or list matching `*.test.ts` files.
+ */
+export default class TestCommand extends Command {
+    signature = 'test {pattern?} [--watch] [--coverage] [--fail-empty] [--update]';
+    description = 'Discover *.test.ts files and run vitest';
+    descriptionKey = 'cmd.test.description';
+    static exitCodes = { 1: 'No tests found (--fail-empty) or vitest failed' };
+    async handle() {
+        const pattern = this.arg('pattern');
+        const base = this.app.basePath;
+        const files = [];
+        await walkTests(base, pattern, files);
+        this.output.section('Tests');
+        this.output.keyValue('files', String(files.length));
+        if (this.option('update') === true) {
+            process.env['UPDATE_SNAPSHOT'] = '1';
+        }
+        if (files.length === 0) {
+            this.output.warn('No *.test.ts files found.');
+            return this.option('fail-empty') === true ? 1 : 0;
+        }
+        if (process.env['VITEST'] === undefined) {
+            const code = await runVitest(base, pattern, {
+                watch: this.option('watch') === true,
+                coverage: this.option('coverage') === true,
+            });
+            if (code !== undefined)
+                return code;
+        }
+        for (const file of files) {
+            this.output.raw(`  ${relative(base, file)}\n`);
+        }
+        this.output.muted(process.env['VITEST'] ? 'listed (already inside vitest)' : 'vitest not available — listed files');
+        return 0;
+    }
+}
+//# sourceMappingURL=test.command.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `tutorial` command: an interactive walkthrough.
+ * Non-TTY or `--plain` prints every step and exits.
+ */
+export default class TutorialCommand extends Command {
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    handle(): Promise<number>;
+    private printStep;
+}

package/dist/commands/tutorial.command.js

@@ -0,0 +1,57 @@
+import { Command } from '@mudah-cli/console';
+const STEPS = [
+    {
+        title: 'create app',
+        body: 'npm create @mudah-cli/mudah my-app && cd my-app && npm install',
+    },
+    {
+        title: 'make command',
+        body: 'node bin/my-app.js make command hello\n# or: make tui picker | make plugin audit',
+    },
+    {
+        title: 'TestTui',
+        body: "import { TestTui } from '@mudah-cli/mudah/testing';\nconst tui = TestTui.mount(screen.root, { cols: 80, rows: 24 });\ntui.send('down').send('enter');\nexpect(tui.snapshot()).toContain('title');",
+    },
+    {
+        title: 'doctor',
+        body: 'node bin/my-app.js doctor\n# prints runtime, manifest, terminal caps, and a TUI dumpTree sample',
+    },
+];
+/**
+ * Built-in `tutorial` command: an interactive walkthrough.
+ * Non-TTY or `--plain` prints every step and exits.
+ */
+export default class TutorialCommand extends Command {
+    signature = 'tutorial';
+    description = 'Interactive walkthrough: create app, make command, TestTui, doctor';
+    descriptionKey = 'cmd.tutorial.description';
+    async handle() {
+        const plain = this.output.mode === 'plain' || process.stdin.isTTY !== true;
+        this.output.section('Mudah tutorial');
+        if (plain) {
+            for (const [i, step] of STEPS.entries())
+                this.printStep(i, step);
+            this.output.success('tutorial complete');
+            return 0;
+        }
+        for (const [i, step] of STEPS.entries()) {
+            this.printStep(i, step);
+            const more = i < STEPS.length - 1;
+            if (more) {
+                const ok = await this.confirm('Continue?', true);
+                if (!ok) {
+                    this.output.muted('Stopped. Re-run tutorial to continue.');
+                    return 0;
+                }
+            }
+        }
+        this.output.success('tutorial complete');
+        return 0;
+    }
+    printStep(index, step) {
+        this.output.line();
+        this.output.info(`${index + 1}. ${step.title}`);
+        this.output.raw(`${step.body}\n`);
+    }
+}
+//# sourceMappingURL=tutorial.command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tutorial.command.js","sourceRoot":"","sources":["../../src/commands/tutorial.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO7C,MAAM,KAAK,GAA4B;IACrC;QACE,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,gEAAgE;KACvE;IACD;QACE,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,kFAAkF;KACzF;IACD;QACE,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,mMAAmM;KAC1M;IACD;QACE,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,iGAAiG;KACxG;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,SAAS,GAAG,UAAU,CAAC;IACvB,WAAW,GAAG,oEAAoE,CAAC;IACnF,cAAc,GAAG,0BAA0B,CAAC;IAE5C,KAAK,CAAC,MAAM;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE;gBAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YAClC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBACjD,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;oBAC3D,OAAO,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,SAAS,CAAC,KAAa,EAAE,IAAkB;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACpC,CAAC;CACF"}

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

@@ -3,5 +3,6 @@ import { Command } from '@mudah-cli/console';
 export default class VersionCommand extends Command {
     signature: string;
     description: string;
+    descriptionKey: string;
     handle(): Promise<void>;
 }

package/dist/commands/version.command.js

@@ -3,6 +3,7 @@ import { Command } from '@mudah-cli/console';
 export default class VersionCommand extends Command {
     signature = 'version';
     description = 'Show the application version';
+    descriptionKey = 'cmd.version.description';
     async handle() {
         this.output.info(`${this.app.manifest.name} v${this.app.manifest.version}`);
     }

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

@@ -1 +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"}
+{"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;IAC7C,cAAc,GAAG,yBAAyB,CAAC;IAE3C,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/commands/watch.command.d.ts

@@ -0,0 +1,13 @@
+import { Command, type ConsoleKernel } from '@mudah-cli/console';
+/**
+ * Built-in `watch` command: re-run a command when files change.
+ * Reads `mudah.json` `watch` defaults when args are omitted.
+ */
+export default class WatchCommand extends Command {
+    private readonly kernel;
+    signature: string;
+    description: string;
+    descriptionKey: string;
+    constructor(kernel: ConsoleKernel);
+    handle(): Promise<number>;
+}

package/dist/commands/watch.command.js

@@ -0,0 +1,62 @@
+import { Command } from '@mudah-cli/console';
+import { createWatcher, pathsFromGlob } from '../watcher.js';
+/**
+ * Built-in `watch` command: re-run a command when files change.
+ * Reads `mudah.json` `watch` defaults when args are omitted.
+ */
+export default class WatchCommand extends Command {
+    kernel;
+    signature = 'watch {command?} {glob?} [--once] [--debounce=]';
+    description = 'Watch files and re-run a command';
+    descriptionKey = 'cmd.watch.description';
+    constructor(kernel) {
+        super();
+        this.kernel = kernel;
+    }
+    async handle() {
+        const configured = this.app.manifest.watch;
+        const target = this.arg('command') ?? configured?.command;
+        const glob = this.arg('glob') ?? configured?.glob ?? 'src/**';
+        const once = this.option('once') === true;
+        const debounce = Number(this.option('debounce') ?? configured?.debounceMs ?? 150) || 150;
+        this.output.info(`watch glob=${glob} debounce=${debounce}ms`);
+        if (target === undefined) {
+            this.output.muted('Pass a command to re-run, e.g. watch doctor src/**');
+            return 0;
+        }
+        if (!this.kernel.has(target)) {
+            throw this.usageError(`Unknown command "${target}".`, 'Run "help" to list all commands.');
+        }
+        const runOnce = async () => {
+            try {
+                return await this.kernel.dispatch([target]);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.output.error(message);
+                return 1;
+            }
+        };
+        const code = await runOnce();
+        if (once || process.stdin.isTTY !== true) {
+            this.output.muted('not watching (non-TTY or --once)');
+            return code;
+        }
+        const base = this.app.basePath;
+        const stop = createWatcher(pathsFromGlob(base, glob), (filename) => {
+            if (filename)
+                process.env['MUDAH_WATCH_FILE'] = filename;
+            this.output.muted('change detected — re-running…');
+            void runOnce();
+        }, { debounceMs: debounce, ignore: configured?.ignore });
+        this.output.muted('watching for changes (ctrl+c to stop)');
+        await new Promise((resolve) => {
+            process.once('SIGINT', () => {
+                stop();
+                resolve();
+            });
+        });
+        return 0;
+    }
+}
+//# sourceMappingURL=watch.command.js.map

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

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

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-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, checkForUpdate, clearUpdateCache, compareSemVer, discoverPlugins, findPluginPackages, formatUpdateNudge, loadManifest, loadPlugin, parseSemVer, type MudahManifest, type LazyProviderOptions, type PluginDiscoveryOptions, type PluginInfo, type ProviderClass, type AppEvents, type UpdateCheckOptions, type UpdateCheckResult, } from '@mudah-cli/core';
-export { ConfigRepository, ConfigValidationError, assertSchema, defineConfig, env, loadEnvFile, loadConfigFiles, s, validateSchema, type Schema, type SchemaIssue, type SchemaResult, } from '@mudah-cli/config';
+export { assertRemoteUrl, assertSchema, type ConfigLayer, ConfigRepository, type ConfigSource, ConfigValidationError, createSecretStore, defineConfig, env, envSecretDriver, fileSecretDriver, formatPrecedence, installConfigReloadSignal, keyringSecretDriver, loadConfigFiles, loadEnvFile, loadRemoteConfig, type PrecedenceRow, REDACT_KEYS, type RedactOptions, redactSecrets, resolveSecret, type Schema, type SchemaIssue, type SchemaResult, SecretStore, s, schemaAt, validateSchema, watchConfig, } from '@mudah-cli/config';
+export { ArgumentParseError, type CoercionType, Command, type ParsedInput, type ParsedSignature, parseInput, parseSignature, } from '@mudah-cli/console';
 export { Container } from '@mudah-cli/container';
+export { type AppEvents, Application, addMessages, CommandCancelled, checkForUpdate, clearUpdateCache, compareSemVer, createTelemetry, defaultCacheDir, discoverPlugins, EventBus, ExitError, findPluginPackages, formatGraph, formatUpdateNudge, gatePlugin, getLocale, hasLocale, hasMessage, type LazyProviderOptions, loadManifest, loadMessages, loadPlugin, localeFromEnv, locales, type MudahManifest, type PluginDiscoveryOptions, type PluginInfo, type ProviderClass, parseSemVer, pluginGraph, ServiceProvider, setLocale, setLocaleFromEnv, type Telemetry, type TelemetryEvent, type TelemetryOptions, type TelemetrySink, t, type UpdateCheckOptions, type UpdateCheckResult, UsageError, } from '@mudah-cli/core';
 export { detectCapabilities, type TerminalCapabilities } from '@mudah-cli/terminal';
+export { type AutocompleteShell, normalizeAutocompleteShell, renderAutocompleteScript, } from './autocomplete.js';
+export { applyPluginUpdate, fetchLatestVersion } from './commands/plugins.update.command.js';
+export { clearWorkspaceIndex, commandFileDiagnostics, commandSignatureItems, completionItems, decodeLspFrames, diagnosticsFor, encodeLspFrame, extractSignatures, filePathToUri, fileUriToPath, handleLspMessage, hoverContents, type IndexedCommand, indexWorkspaceCommands, initializeResult, type LspDiagnostic, type LspMessage, mudahJsonDiagnostics, publishDiagnostics, workspaceCommandItems, workspaceCommandsIndex, } from './lsp.js';
+export { type RunOptions, run } from './run.js';
+export { createWatcher, hotReloadPlugins, pathsFromGlob, type WatcherOptions, watchPlugins, } from './watcher.js';

package/dist/index.js

@@ -1,9 +1,12 @@
-export { run } from './run.js';
-export { createWatcher } from './watcher.js';
+export { assertRemoteUrl, assertSchema, ConfigRepository, ConfigValidationError, createSecretStore, defineConfig, env, envSecretDriver, fileSecretDriver, formatPrecedence, installConfigReloadSignal, keyringSecretDriver, loadConfigFiles, loadEnvFile, loadRemoteConfig, REDACT_KEYS, redactSecrets, resolveSecret, SecretStore, s, schemaAt, validateSchema, watchConfig, } from '@mudah-cli/config';
 // 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, checkForUpdate, clearUpdateCache, compareSemVer, discoverPlugins, findPluginPackages, formatUpdateNudge, loadManifest, loadPlugin, parseSemVer, } from '@mudah-cli/core';
-export { ConfigRepository, ConfigValidationError, assertSchema, defineConfig, env, loadEnvFile, loadConfigFiles, s, validateSchema, } from '@mudah-cli/config';
+export { ArgumentParseError, Command, parseInput, parseSignature, } from '@mudah-cli/console';
 export { Container } from '@mudah-cli/container';
+export { Application, addMessages, CommandCancelled, checkForUpdate, clearUpdateCache, compareSemVer, createTelemetry, defaultCacheDir, discoverPlugins, EventBus, ExitError, findPluginPackages, formatGraph, formatUpdateNudge, gatePlugin, getLocale, hasLocale, hasMessage, loadManifest, loadMessages, loadPlugin, localeFromEnv, locales, parseSemVer, pluginGraph, ServiceProvider, setLocale, setLocaleFromEnv, t, UsageError, } from '@mudah-cli/core';
 export { detectCapabilities } from '@mudah-cli/terminal';
+export { normalizeAutocompleteShell, renderAutocompleteScript, } from './autocomplete.js';
+export { applyPluginUpdate, fetchLatestVersion } from './commands/plugins.update.command.js';
+export { clearWorkspaceIndex, commandFileDiagnostics, commandSignatureItems, completionItems, decodeLspFrames, diagnosticsFor, encodeLspFrame, extractSignatures, filePathToUri, fileUriToPath, handleLspMessage, hoverContents, indexWorkspaceCommands, initializeResult, mudahJsonDiagnostics, publishDiagnostics, workspaceCommandItems, workspaceCommandsIndex, } from './lsp.js';
+export { run } from './run.js';
+export { createWatcher, hotReloadPlugins, pathsFromGlob, watchPlugins, } from './watcher.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,WAAW,GASZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,GAAG,EACH,WAAW,EACX,eAAe,EACf,CAAC,EACD,cAAc,GAIf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAA6B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EAEZ,gBAAgB,EAEhB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,GAAG,EACH,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,gBAAgB,EAEhB,WAAW,EAEX,aAAa,EACb,aAAa,EAIb,WAAW,EACX,CAAC,EACD,QAAQ,EACR,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,yFAAyF;AACzF,OAAO,EACL,kBAAkB,EAElB,OAAO,EAGP,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAEL,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EAEV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,OAAO,EAKP,WAAW,EACX,WAAW,EACX,eAAe,EACf,SAAS,EACT,gBAAgB,EAKhB,CAAC,EAGD,UAAU,GACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAA6B,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAEL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC7F,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EAEb,sBAAsB,EACtB,gBAAgB,EAGhB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAmB,GAAG,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,aAAa,EAEb,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/lsp.d.ts

@@ -0,0 +1,147 @@
+/** Mudah JSON-RPC LSP: initialize, completion, hover, diagnostics, document sync. */
+export interface LspMessage {
+    jsonrpc: '2.0';
+    id?: number | string;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export interface CompletionItem {
+    label: string;
+    kind?: number;
+    detail?: string;
+    documentation?: string;
+}
+export declare const MANIFEST_KEYS: readonly [{
+    readonly label: 'name';
+    readonly detail: 'Application name';
+}, {
+    readonly label: 'version';
+    readonly detail: 'Semver version';
+}, {
+    readonly label: 'bin';
+    readonly detail: 'Binary name';
+}, {
+    readonly label: 'description';
+    readonly detail: 'One-line description';
+}, {
+    readonly label: 'ui';
+    readonly detail: 'Theme / motion / color';
+}, {
+    readonly label: 'updates';
+    readonly detail: 'Update nudge (default true)';
+}, {
+    readonly label: 'commands';
+    readonly detail: 'Extra command module paths';
+}, {
+    readonly label: 'providers';
+    readonly detail: 'Extra provider module paths';
+}, {
+    readonly label: 'telemetry';
+    readonly detail: 'Opt-in boot/perf telemetry';
+}, {
+    readonly label: 'watch';
+    readonly detail: 'Declarative file watcher';
+}];
+export declare const SIGNATURE_SNIPPETS: CompletionItem[];
+/** A command found on disk by {@link indexWorkspaceCommands}. */
+export interface IndexedCommand {
+    /** Command name from the signature (`db:status`). */
+    name: string;
+    /** The full signature string. */
+    signature: string;
+    description: string;
+    /** Absolute path to the `*.command.ts` file. */
+    file: string;
+    /** 1-based line of the `signature` assignment. */
+    line: number;
+}
+/** Convert a `file://` URI to a filesystem path (best effort). */
+export declare function fileUriToPath(uri: string): string;
+/** Convert an absolute path to a `file://` URI. */
+export declare function filePathToUri(path: string): string;
+interface RawSignature {
+    signature: string;
+    index: number;
+}
+/** Every `signature = '...'` assignment in a command source file. */
+export declare function extractSignatures(text: string): RawSignature[];
+/**
+ * Scan a directory tree for `*.command.ts` files and index their signatures.
+ * Replaces any previous index. Returns the indexed commands sorted by name.
+ */
+export declare function indexWorkspaceCommands(rootDir: string): IndexedCommand[];
+/** The current workspace command index. */
+export declare function workspaceCommandsIndex(): readonly IndexedCommand[];
+/** Drop the workspace index (tests, or when the root changes). */
+export declare function clearWorkspaceIndex(): void;
+/**
+ * Completion items for workspace commands, annotated with the file they came
+ * from so the editor can show a useful detail line.
+ */
+export declare function workspaceCommandItems(root?: string): CompletionItem[];
+export declare function initializeResult(): {
+    capabilities: {
+        textDocumentSync: number;
+        completionProvider: {
+            triggerCharacters: string[];
+        };
+        hoverProvider: boolean;
+        diagnosticProvider: {
+            interFileDependencies: boolean;
+            workspaceDiagnostics: boolean;
+        };
+    };
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+};
+export declare function uriOf(params: unknown): string;
+export declare function completionItems(params: unknown): CompletionItem[];
+/** Pull `signature = '...'` strings from an open `*.command.ts` buffer. */
+export declare function commandSignatureItems(text: string): CompletionItem[];
+export interface LspDiagnostic {
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+    severity: 1 | 2 | 3 | 4;
+    source: 'mudah';
+    message: string;
+}
+/**
+ * Signature diagnostics for an open `*.command.ts` buffer: each declared
+ * signature is validated with the real parser, and duplicate command names
+ * across the workspace are flagged.
+ */
+export declare function commandFileDiagnostics(uri: string, text: string): LspDiagnostic[];
+/** Schema diagnostics for an open `mudah.json` buffer. */
+export declare function mudahJsonDiagnostics(uri: string, text: string): LspDiagnostic[];
+/** Diagnostics for whichever document type this URI is, if any. */
+export declare function diagnosticsFor(uri: string, text: string): LspDiagnostic[];
+/** LSP notification for the current buffer, if it is a manifest or command file. */
+export declare function publishDiagnostics(uri: string): LspMessage | undefined;
+export declare function hoverContents(params: unknown): {
+    kind: 'markdown';
+    value: string;
+} | null;
+/** Handle one JSON-RPC request. Notifications (no id) may return undefined. */
+export declare function handleLspMessage(msg: LspMessage): LspMessage | undefined;
+/** LSP Content-Length framing. */
+export declare function encodeLspFrame(message: LspMessage): string;
+export declare function decodeLspFrames(buffer: string): {
+    messages: LspMessage[];
+    rest: string;
+};
+export {};