import * as CliOutput from "effect/cli/CliOutput";
import type { FlagDoc, HelpDoc } from "effect/cli/HelpDoc";
/**
* Compact enum-style flag types so one long choice list (`--log-level`'s
* nine choices) doesn't widen the description column for every flag.
*/
const compactFlagType = (type: string): string => {
if (type === "boolean" || type.length <= 24) return type;
const bracketed = type.startsWith("<") && type.endsWith(">");
const value = bracketed ? type.slice(1, -1) : type;
const choices = value.split("|");
const compact =
choices.length > 2 ? `${choices.slice(0, 2).join("|")}|…` : `${value.slice(0, 21)}…`;
return bracketed ? `<${compact}>` : compact;
};
const compactFlag = (flag: FlagDoc): FlagDoc => ({
...flag,
type: compactFlagType(flag.type),
});
const compactDoc = (doc: HelpDoc): HelpDoc => ({
...doc,
flags: doc.flags?.map(compactFlag),
globalFlags: doc.globalFlags?.map(compactFlag),
});
/**
* Bound every line to the terminal width, breaking at spaces; continuation
* lines keep the original indent plus two columns. The default formatter
* never wraps, so long descriptions would otherwise run off the terminal.
*/
const wrapLines = (text: string, width: number): string =>
text
.split("\n")
.flatMap((line) => {
if (line.length <= width) return [line];
const continuation = `${line.match(/^\s*/)![0]} `;
const out: string[] = [];
let current: string | undefined;
for (const word of line.trim().split(/\s+/)) {
if (current === undefined) {
current = `${line.match(/^\s*/)![0]}${word}`;
} else if (current.length + word.length + 1 <= width) {
current += ` ${word}`;
} else {
out.push(current);
current = continuation + word;
}
}
if (current !== undefined) out.push(current);
return out;
})
.join("\n");
/**
* Help formatter for plain (non-interactive) runs: the default effect/cli
* formatter with colors off, enum flag types compacted, and output wrapped
* to the terminal width — CI logs, redirected output, and coding agents
* get parseable, bounded lines.
*/
export const plainCliFormatter = (options: { columns: number }): CliOutput.Formatter => {
const columns = Math.max(60, Math.min(options.columns, 120));
const fallback = CliOutput.defaultFormatter({ colors: false });
return {
formatCliError: fallback.formatCliError,
formatError: fallback.formatError,
formatErrors: fallback.formatErrors,
formatVersion: fallback.formatVersion,
formatHelpDoc: (doc) => wrapLines(fallback.formatHelpDoc(compactDoc(doc)), columns),
};
};