@nimrobo/mcporter-remote 0.1.0

package/dist/cli/list-command.js

@@ -0,0 +1,372 @@
+import ora from 'ora';
+import { MCPORTER_VERSION } from '../runtime.js';
+import { setStdioLogMode } from '../sdk-patches.js';
+import { extractEphemeralServerFlags } from './ephemeral-flags.js';
+import { prepareEphemeralServerTarget } from './ephemeral-target.js';
+import { splitHttpToolSelector } from './http-utils.js';
+import { chooseClosestIdentifier, renderIdentifierResolutionMessages } from './identifier-helpers.js';
+import { formatExampleBlock } from './list-detail-helpers.js';
+import { classifyListError, formatSourceSuffix, renderServerListRow } from './list-format.js';
+import { buildAuthCommandHint, buildJsonListEntry, createEmptyStatusCounts, createUnknownResult, printSingleServerHeader, printToolDetail, summarizeStatusCounts, } from './list-output.js';
+import { consumeOutputFormat } from './output-format.js';
+import { dimText, extraDimText, supportsSpinner, yellowText } from './terminal.js';
+import { consumeTimeoutFlag, LIST_TIMEOUT_MS, withTimeout } from './timeouts.js';
+import { loadToolMetadata } from './tool-cache.js';
+import { formatTransportSummary } from './transport-utils.js';
+export function extractListFlags(args) {
+    let schema = false;
+    let timeoutMs;
+    let requiredOnly = true;
+    let verbose = false;
+    let includeSources = false;
+    const format = consumeOutputFormat(args, {
+        defaultFormat: 'text',
+        allowed: ['text', 'json'],
+        enableRawShortcut: false,
+        jsonShortcutFlag: '--json',
+    });
+    const ephemeral = extractEphemeralServerFlags(args);
+    let index = 0;
+    while (index < args.length) {
+        const token = args[index];
+        if (token === '--schema') {
+            schema = true;
+            args.splice(index, 1);
+            continue;
+        }
+        if (token === '--yes') {
+            args.splice(index, 1);
+            continue;
+        }
+        if (token === '--all-parameters') {
+            requiredOnly = false;
+            args.splice(index, 1);
+            continue;
+        }
+        if (token === '--verbose') {
+            verbose = true;
+            args.splice(index, 1);
+            continue;
+        }
+        if (token === '--sources') {
+            includeSources = true;
+            args.splice(index, 1);
+            continue;
+        }
+        if (token === '--timeout') {
+            timeoutMs = consumeTimeoutFlag(args, index, { flagName: '--timeout' });
+            continue;
+        }
+        index += 1;
+    }
+    return { schema, timeoutMs, requiredOnly, ephemeral, format, verbose, includeSources };
+}
+export async function handleList(runtime, args) {
+    const flags = extractListFlags(args);
+    let target = args.shift();
+    if (target) {
+        const split = splitHttpToolSelector(target);
+        if (split) {
+            target = split.baseUrl;
+        }
+    }
+    const prepared = await prepareEphemeralServerTarget({
+        runtime,
+        target,
+        ephemeral: flags.ephemeral,
+    });
+    target = prepared.target;
+    if (!target) {
+        const previousStdioLogMode = setStdioLogMode('silent');
+        try {
+            const servers = runtime.getDefinitions();
+            const perServerTimeoutMs = flags.timeoutMs ?? LIST_TIMEOUT_MS;
+            const perServerTimeoutSeconds = Math.round(perServerTimeoutMs / 1000);
+            if (servers.length === 0) {
+                if (flags.format === 'json') {
+                    const payload = {
+                        mode: 'list',
+                        counts: createEmptyStatusCounts(),
+                        servers: [],
+                    };
+                    console.log(JSON.stringify(payload, null, 2));
+                }
+                else {
+                    console.log('No MCP servers configured.');
+                }
+                return;
+            }
+            if (flags.format === 'text') {
+                console.log(`mcporter ${MCPORTER_VERSION} — Listing ${servers.length} server(s) (per-server timeout: ${perServerTimeoutSeconds}s)`);
+            }
+            const spinner = flags.format === 'text' && supportsSpinner
+                ? ora(`Discovering ${servers.length} server(s)…`).start()
+                : undefined;
+            const renderedResults = flags.format === 'text'
+                ? Array.from({ length: servers.length }, () => undefined)
+                : undefined;
+            const summaryResults = Array.from({ length: servers.length }, () => undefined);
+            let completedCount = 0;
+            const tasks = servers.map((server, index) => (async () => {
+                const startedAt = Date.now();
+                try {
+                    const tools = await withTimeout(runtime.listTools(server.name, { autoAuthorize: false, allowCachedAuth: true }), perServerTimeoutMs);
+                    return {
+                        server,
+                        status: 'ok',
+                        tools,
+                        durationMs: Date.now() - startedAt,
+                    };
+                }
+                catch (error) {
+                    return {
+                        server,
+                        status: 'error',
+                        error,
+                        durationMs: Date.now() - startedAt,
+                    };
+                }
+            })().then((result) => {
+                summaryResults[index] = result;
+                if (renderedResults) {
+                    const rendered = renderServerListRow(result, perServerTimeoutMs, { verbose: flags.verbose });
+                    renderedResults[index] = rendered;
+                    completedCount += 1;
+                    if (spinner) {
+                        spinner.stop();
+                        console.log(rendered.line);
+                        const remaining = servers.length - completedCount;
+                        if (remaining > 0) {
+                            spinner.text = `Listing servers… ${completedCount}/${servers.length}`;
+                            spinner.start();
+                        }
+                    }
+                    else {
+                        console.log(rendered.line);
+                    }
+                }
+                return result;
+            }));
+            await Promise.all(tasks);
+            if (flags.format === 'json') {
+                const jsonEntries = summaryResults.map((entry, index) => {
+                    const serverDefinition = servers[index] ?? entry?.server ?? servers[0];
+                    if (!serverDefinition) {
+                        throw new Error('Unable to resolve server definition for JSON output.');
+                    }
+                    const normalizedEntry = entry ?? createUnknownResult(serverDefinition);
+                    return buildJsonListEntry(normalizedEntry, perServerTimeoutSeconds, {
+                        includeSchemas: Boolean(flags.schema),
+                        includeSources: Boolean(flags.verbose || flags.includeSources),
+                    });
+                });
+                const counts = summarizeStatusCounts(jsonEntries);
+                console.log(JSON.stringify({ mode: 'list', counts, servers: jsonEntries }, null, 2));
+                return;
+            }
+            if (spinner) {
+                spinner.stop();
+            }
+            const errorCounts = createEmptyStatusCounts();
+            renderedResults?.forEach((entry) => {
+                if (!entry) {
+                    return;
+                }
+                const category = entry.category ?? 'error';
+                errorCounts[category] = (errorCounts[category] ?? 0) + 1;
+            });
+            const okSummary = `${errorCounts.ok} healthy`;
+            const parts = [
+                okSummary,
+                ...(errorCounts.auth > 0 ? [`${errorCounts.auth} auth required`] : []),
+                ...(errorCounts.offline > 0 ? [`${errorCounts.offline} offline`] : []),
+                ...(errorCounts.http > 0 ? [`${errorCounts.http} http errors`] : []),
+                ...(errorCounts.error > 0 ? [`${errorCounts.error} errors`] : []),
+            ];
+            console.log(`✔ Listed ${servers.length} server${servers.length === 1 ? '' : 's'} (${parts.join('; ')}).`);
+            return;
+        }
+        finally {
+            setStdioLogMode(previousStdioLogMode);
+        }
+    }
+    const resolved = resolveServerDefinition(runtime, target);
+    if (!resolved) {
+        return;
+    }
+    target = resolved.name;
+    const definition = resolved.definition;
+    const timeoutMs = flags.timeoutMs ?? LIST_TIMEOUT_MS;
+    const sourcePath = definition.sources?.length || definition.source
+        ? formatSourceSuffix(definition.sources ?? definition.source, true, { verbose: flags.verbose })
+        : undefined;
+    const transportSummary = formatTransportSummary(definition);
+    const startedAt = Date.now();
+    if (flags.format === 'json') {
+        try {
+            const metadataEntries = await withTimeout(loadToolMetadata(runtime, target, { includeSchema: true }), timeoutMs);
+            const durationMs = Date.now() - startedAt;
+            const payload = {
+                mode: 'server',
+                name: definition.name,
+                status: 'ok',
+                durationMs,
+                description: definition.description,
+                transport: transportSummary,
+                source: definition.source,
+                sources: flags.verbose || flags.includeSources ? definition.sources : undefined,
+                tools: metadataEntries.map((entry) => ({
+                    name: entry.tool.name,
+                    description: entry.tool.description,
+                    inputSchema: entry.tool.inputSchema,
+                    outputSchema: entry.tool.outputSchema,
+                    options: entry.options,
+                })),
+            };
+            console.log(JSON.stringify(payload, null, 2));
+            return;
+        }
+        catch (error) {
+            const durationMs = Date.now() - startedAt;
+            const authCommand = buildAuthCommandHint(definition);
+            const advice = classifyListError(error, definition.name, timeoutMs, { authCommand });
+            const payload = {
+                mode: 'server',
+                name: definition.name,
+                status: advice.category,
+                durationMs,
+                description: definition.description,
+                transport: transportSummary,
+                source: definition.source,
+                sources: flags.verbose || flags.includeSources ? definition.sources : undefined,
+                issue: advice.issue,
+                authCommand: advice.authCommand,
+                error: advice.summary,
+            };
+            console.log(JSON.stringify(payload, null, 2));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    try {
+        // Always request schemas so we can render CLI-style parameter hints without re-querying per tool.
+        const metadataEntries = await withTimeout(loadToolMetadata(runtime, target, { includeSchema: true }), timeoutMs);
+        const durationMs = Date.now() - startedAt;
+        const summaryLine = printSingleServerHeader(definition, metadataEntries.length, durationMs, transportSummary, sourcePath, {
+            printSummaryNow: false,
+        });
+        if (metadataEntries.length === 0) {
+            console.log('  Tools: <none>');
+            console.log(summaryLine);
+            console.log('');
+            return;
+        }
+        const examples = [];
+        let optionalOmitted = false;
+        for (const entry of metadataEntries) {
+            const detail = printToolDetail(definition, entry, Boolean(flags.schema), flags.requiredOnly);
+            examples.push(...detail.examples);
+            optionalOmitted ||= detail.optionalOmitted;
+        }
+        const uniqueExamples = formatExampleBlock(examples);
+        if (uniqueExamples.length > 0) {
+            console.log(`  ${dimText('Examples:')}`);
+            for (const example of uniqueExamples) {
+                console.log(`    ${example}`);
+            }
+            console.log('');
+        }
+        if (flags.requiredOnly && optionalOmitted) {
+            console.log(`  ${extraDimText('Optional parameters hidden; run with --all-parameters to view all fields.')}`);
+            console.log('');
+        }
+        console.log(summaryLine);
+        console.log('');
+        return;
+    }
+    catch (error) {
+        const durationMs = Date.now() - startedAt;
+        printSingleServerHeader(definition, undefined, durationMs, transportSummary, sourcePath);
+        const message = error instanceof Error ? error.message : 'Failed to load tool list.';
+        const timeoutMs = flags.timeoutMs ?? LIST_TIMEOUT_MS;
+        const authCommand = buildAuthCommandHint(definition);
+        const advice = classifyListError(error, definition.name, timeoutMs, { authCommand });
+        console.warn(`  Tools: <timed out after ${timeoutMs}ms>`);
+        console.warn(`  Reason: ${message}`);
+        if (advice.category === 'auth' && advice.authCommand) {
+            console.warn(`  Next: run '${advice.authCommand}' to finish authentication.`);
+        }
+    }
+}
+export function printListHelp() {
+    const lines = [
+        'Usage: mcporter list [server | url] [flags]',
+        '',
+        'Targets:',
+        '  <name>                 Use a server from config/mcporter.json or editor imports.',
+        '  https://host/mcp       List an HTTP server directly; mcporter infers the entry.',
+        '',
+        'Ad-hoc servers:',
+        '  --http-url <url>       Register an HTTP server for this run.',
+        '  --allow-http           Permit plain http:// URLs with --http-url.',
+        '  --stdio <command>      Run a stdio MCP server (repeat --stdio-arg for args).',
+        '  --stdio-arg <value>    Append args to the stdio command (repeatable).',
+        '  --env KEY=value        Inject env vars for stdio servers (repeatable).',
+        '  --cwd <path>           Working directory for stdio servers.',
+        '  --name <value>         Override the display name for ad-hoc servers.',
+        '  --description <text>   Override the description for ad-hoc servers.',
+        '  --persist <path>       Write the ad-hoc definition to config/mcporter.json.',
+        '  --yes                  Skip confirmation prompts when persisting.',
+        '',
+        'Display flags:',
+        '  --schema               Show tool schemas when listing servers.',
+        '  --all-parameters       Include optional parameters in tool docs.',
+        '  --json                 Emit a JSON summary instead of text.',
+        '  --verbose              Show all config sources for matching servers.',
+        '  --sources              Include source arrays in JSON output without other verbose details.',
+        '  --timeout <ms>         Override the per-server discovery timeout.',
+        '',
+        'Examples:',
+        '  mcporter list',
+        '  mcporter list linear --schema',
+        '  mcporter list https://mcp.example.com/mcp',
+        '  mcporter list --http-url https://localhost:3333/mcp --schema',
+    ];
+    console.error(lines.join('\n'));
+}
+function resolveServerDefinition(runtime, name) {
+    try {
+        const definition = runtime.getDefinition(name);
+        return { definition, name };
+    }
+    catch (error) {
+        if (!(error instanceof Error) || !/Unknown MCP server/i.test(error.message)) {
+            throw error;
+        }
+        const suggestion = suggestServerName(runtime, name);
+        if (!suggestion) {
+            console.error(error.message);
+            return undefined;
+        }
+        const messages = renderIdentifierResolutionMessages({
+            entity: 'server',
+            attempted: name,
+            resolution: suggestion,
+        });
+        if (suggestion.kind === 'auto' && messages.auto) {
+            console.log(dimText(messages.auto));
+            return resolveServerDefinition(runtime, suggestion.value);
+        }
+        if (messages.suggest) {
+            console.error(yellowText(messages.suggest));
+        }
+        console.error(error.message);
+        return undefined;
+    }
+}
+function suggestServerName(runtime, attempted) {
+    const definitions = runtime.getDefinitions();
+    const names = definitions.map((entry) => entry.name);
+    return chooseClosestIdentifier(attempted, names);
+}
+//# sourceMappingURL=list-command.js.map

package/dist/cli/list-command.js.map

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

package/dist/cli/list-detail-helpers.d.ts

@@ -0,0 +1,41 @@
+import type { GeneratedOption } from './generate/tools.js';
+import type { FlagUsageExtra } from './list-signature.js';
+export type { FlagUsageExtra } from './list-signature.js';
+export { formatCallExpressionExample, formatExampleBlock, formatFlagLabel, formatFlagUsage, formatFunctionSignature, formatOptionalSummary, } from './list-signature.js';
+export interface SelectDisplayOptionsResult {
+    displayOptions: GeneratedOption[];
+    hiddenOptions: GeneratedOption[];
+}
+export interface ToolDocInput {
+    serverName: string;
+    toolName: string;
+    description?: string;
+    outputSchema?: unknown;
+    options: GeneratedOption[];
+    requiredOnly: boolean;
+    colorize?: boolean;
+    exampleMaxLength?: number;
+    flagExtras?: FlagUsageExtra[];
+    defaultReturnType?: string;
+    callSelector?: string;
+    wrapExampleExpression?: boolean;
+}
+export interface ToolDocModel {
+    docLines?: string[];
+    signature: string;
+    tsSignature: string;
+    flagUsage: string;
+    optionalSummary?: string;
+    examples: string[];
+    displayOptions: GeneratedOption[];
+    hiddenOptions: GeneratedOption[];
+    optionDocs: ToolOptionDoc[];
+}
+export interface ToolOptionDoc {
+    option: GeneratedOption;
+    flagLabel: string;
+    description: string;
+}
+export declare function selectDisplayOptions(options: GeneratedOption[], requiredOnly: boolean, minVisible?: number): SelectDisplayOptionsResult;
+export declare function buildToolDoc(input: ToolDocInput): ToolDocModel;
+//# sourceMappingURL=list-detail-helpers.d.ts.map

package/dist/cli/list-detail-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-detail-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/list-detail-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAW1D,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,aAAa,EAAE,eAAe,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EAAE,EAC1B,YAAY,EAAE,OAAO,EACrB,UAAU,SAA6B,GACtC,0BAA0B,CAuB5B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CA8C9D"}

package/dist/cli/list-detail-helpers.js

@@ -0,0 +1,99 @@
+import { buildDocComment } from './list-doc-comments.js';
+import { formatCallExpressionExample, formatExampleBlock, formatFlagLabel, formatFlagUsage, formatFunctionSignature, formatOptionalSummary, } from './list-signature.js';
+import { extraDimText } from './terminal.js';
+export { formatCallExpressionExample, formatExampleBlock, formatFlagLabel, formatFlagUsage, formatFunctionSignature, formatOptionalSummary, } from './list-signature.js';
+const DEFAULT_MIN_VISIBLE_PARAMS = 5;
+export function selectDisplayOptions(options, requiredOnly, minVisible = DEFAULT_MIN_VISIBLE_PARAMS) {
+    if (!requiredOnly || options.length <= minVisible) {
+        return { displayOptions: options, hiddenOptions: [] };
+    }
+    const included = new Set();
+    options.forEach((option, index) => {
+        if (option.required) {
+            included.add(index);
+        }
+    });
+    let includedCount = included.size;
+    if (includedCount < minVisible) {
+        for (let index = 0; index < options.length && includedCount < minVisible; index += 1) {
+            if (included.has(index)) {
+                continue;
+            }
+            included.add(index);
+            includedCount += 1;
+        }
+    }
+    const displayOptions = options.filter((_option, index) => included.has(index));
+    const hiddenOptions = options.filter((_option, index) => !included.has(index));
+    return { displayOptions, hiddenOptions };
+}
+export function buildToolDoc(input) {
+    const { serverName, toolName, description, outputSchema, options, requiredOnly, colorize = true, exampleMaxLength, flagExtras, defaultReturnType, } = input;
+    const { displayOptions, hiddenOptions } = selectDisplayOptions(options, requiredOnly);
+    const docLines = buildDocComment(description, options, { colorize });
+    const signature = formatFunctionSignature(toolName, displayOptions, outputSchema, {
+        colorize,
+        defaultReturnType,
+    });
+    const tsSignature = formatFunctionSignature(toolName, displayOptions, outputSchema, {
+        colorize: false,
+        defaultReturnType,
+    });
+    const flagUsage = formatFlagUsage(displayOptions, flagExtras, { colorize });
+    const optionalSummary = hiddenOptions.length > 0 ? formatOptionalSummary(hiddenOptions, { colorize }) : undefined;
+    const optionDocs = options.map((option) => buildOptionDoc(option, { colorize }));
+    const callExample = formatCallExpressionExample(serverName, toolName, displayOptions.length > 0 ? displayOptions : options, { callSelector: input.callSelector, wrapExpression: input.wrapExampleExpression });
+    const examples = callExample
+        ? formatExampleBlock([callExample], { maxExamples: 1, maxLength: exampleMaxLength ?? 80 })
+        : [];
+    return {
+        docLines,
+        signature,
+        tsSignature,
+        flagUsage,
+        optionalSummary,
+        examples,
+        displayOptions,
+        hiddenOptions,
+        optionDocs,
+    };
+}
+function buildOptionDoc(option, opts) {
+    return {
+        option,
+        flagLabel: formatFlagLabel(option),
+        description: formatOptionDescription(option, opts),
+    };
+}
+function formatOptionDescription(option, opts) {
+    const colorize = opts?.colorize ?? false;
+    const tint = colorize ? extraDimText : (value) => value;
+    let description = option.description ? option.description : `Set ${option.property}.`;
+    const detailParts = [];
+    if (option.enumValues && option.enumValues.length > 0) {
+        detailParts.push(`choices: ${option.enumValues.join(', ')}`);
+    }
+    if (option.defaultValue !== undefined) {
+        detailParts.push(`default: ${formatHelpValue(option.defaultValue)}`);
+    }
+    if (option.exampleValue) {
+        detailParts.push(`example: ${option.exampleValue}`);
+    }
+    if (detailParts.length > 0) {
+        description += ` (${detailParts.join('; ')})`;
+    }
+    return tint(description);
+}
+function formatHelpValue(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => String(entry)).join(', ');
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (value && typeof value === 'object') {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+//# sourceMappingURL=list-detail-helpers.js.map

package/dist/cli/list-detail-helpers.js.map

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

package/dist/cli/list-doc-comments.d.ts

@@ -0,0 +1,6 @@
+import type { GeneratedOption } from './generate/tools.js';
+export declare function buildDocComment(description: string | undefined, options: GeneratedOption[], opts?: {
+    colorize?: boolean;
+}): string[] | undefined;
+export declare function wrapCommentText(text: string, width?: number): string[];
+//# sourceMappingURL=list-doc-comments.d.ts.map

package/dist/cli/list-doc-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-doc-comments.d.ts","sourceRoot":"","sources":["../../src/cli/list-doc-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,eAAe,EAAE,EAC1B,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,MAAM,EAAE,GAAG,SAAS,CAoCtB;AA2DD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAqB,GAAG,MAAM,EAAE,CAwBlF"}