@optique/core 1.3.0-dev.2529 → 1.3.0-dev.2532

package/dist/terminal-internal.js

@@ -0,0 +1,262 @@
+import { getDisplayWidth } from "./displaywidth.js";
+import { defaultTerminalTheme } from "./terminal.js";
+
+//#region src/terminal-internal.ts
+function terminalText(text) {
+	return {
+		type: "text",
+		text
+	};
+}
+function valuesFormatter(theme) {
+	if (theme.values != null && theme.values !== defaultTerminalTheme.values) return theme.values;
+	if (theme.value != null && theme.value !== defaultTerminalTheme.value) return defaultTerminalTheme.values;
+	return (term, context) => ({
+		type: "style",
+		style: { foreground: "green" },
+		children: [defaultTerminalTheme.values(term, context)]
+	});
+}
+function formatTerminalTerm(term, theme = {}, quotes = false, usage) {
+	const quote = (s) => quotes ? `\`${s}\`` : s;
+	let text;
+	switch (term.type) {
+		case "text": return terminalText(term.text);
+		case "lineBreak": throw new TypeError("Hard breaks must be rendered at the message level.");
+		case "optionName":
+			text = quote(term.optionName);
+			break;
+		case "optionNames":
+			text = term.optionNames.map(quote).join("/");
+			break;
+		case "metavar":
+			text = quote(term.metavar);
+			break;
+		case "value":
+			text = quotes ? JSON.stringify(term.value) : term.value;
+			break;
+		case "values":
+			text = term.values.map((v) => quotes ? JSON.stringify(v) : v).join(" ");
+			break;
+		case "envVar":
+			text = quote(term.envVar);
+			break;
+		case "commandLine":
+			text = quote(term.commandLine);
+			break;
+		case "url":
+			text = quotes ? `<${term.url.href}>` : term.url.href;
+			break;
+		case "programName":
+			text = term.programName;
+			break;
+		case "label":
+		case "errorLabel":
+			text = term.label;
+			break;
+		case "syntaxPunctuation":
+			text = term.punctuation;
+			break;
+		default: throw new TypeError(`Invalid MessageTerm type: ${term["type"]}.`);
+	}
+	const ctx = {
+		quotes,
+		text,
+		usage,
+		format: (child) => formatTerminalTerm(child, theme, quotes, usage)
+	};
+	switch (term.type) {
+		case "optionName": return (theme.optionName ?? defaultTerminalTheme.optionName)(term, ctx);
+		case "optionNames": return (theme.optionNames ?? defaultTerminalTheme.optionNames)(term, ctx);
+		case "metavar": return (theme.metavar ?? defaultTerminalTheme.metavar)(term, ctx);
+		case "value": return (theme.value ?? defaultTerminalTheme.value)(term, ctx);
+		case "values": return valuesFormatter(theme)(term, ctx);
+		case "envVar": return (theme.envVar ?? defaultTerminalTheme.envVar)(term, ctx);
+		case "commandLine": return (theme.commandLine ?? defaultTerminalTheme.commandLine)(term, ctx);
+		case "url": return (theme.url ?? defaultTerminalTheme.url)(term, ctx);
+		case "programName": return (theme.programName ?? defaultTerminalTheme.programName)(term, ctx);
+		case "label": return (theme.label ?? defaultTerminalTheme.label)(term, ctx);
+		case "syntaxPunctuation": return (theme.syntaxPunctuation ?? defaultTerminalTheme.syntaxPunctuation)(term, ctx);
+		case "errorLabel": return (theme.errorLabel ?? defaultTerminalTheme.errorLabel)(term, ctx);
+	}
+}
+const colorNames = [
+	"black",
+	"red",
+	"green",
+	"yellow",
+	"blue",
+	"magenta",
+	"cyan",
+	"white",
+	"brightBlack",
+	"brightRed",
+	"brightGreen",
+	"brightYellow",
+	"brightBlue",
+	"brightMagenta",
+	"brightCyan",
+	"brightWhite"
+];
+function colorCode(color, background) {
+	const channel = (n) => {
+		if (!Number.isInteger(n) || n < 0 || n > 255) throw new RangeError("Terminal color channels must be integers from 0 to 255.");
+		return n;
+	};
+	if (typeof color === "string") {
+		const i = colorNames.indexOf(color);
+		if (i < 0) throw new RangeError("Unknown terminal color.");
+		return String((background ? 40 : 30) + (i >= 8 ? 60 + i - 8 : i));
+	}
+	const prefix = background ? 48 : 38;
+	if ("index" in color) return `${prefix};5;${channel(color.index)}`;
+	return `${prefix};2;${color.map(channel).join(";")}`;
+}
+function styleCode(style) {
+	const codes = [];
+	if (style.bold) codes.push(1);
+	if (style.dim) codes.push(2);
+	if (style.italic) codes.push(3);
+	if (style.underline) codes.push(4);
+	if (style.foreground != null) codes.push(colorCode(style.foreground, false));
+	if (style.background != null) codes.push(colorCode(style.background, true));
+	return codes.length ? `\x1b[${codes.join(";")}m` : "";
+}
+function sameStyle(a, b) {
+	return a.bold === b.bold && a.dim === b.dim && a.italic === b.italic && a.underline === b.underline && JSON.stringify(a.foreground) === JSON.stringify(b.foreground) && JSON.stringify(a.background) === JSON.stringify(b.background);
+}
+function* fragmentTokens(fragment, scopes = [], inherited = {}) {
+	if (fragment.type === "text") {
+		yield {
+			text: fragment.text,
+			width: getDisplayWidth(fragment.text),
+			scopes
+		};
+		return;
+	}
+	let next = scopes;
+	let style = inherited;
+	if (fragment.type === "style") {
+		styleCode(fragment.style);
+		style = {
+			...inherited,
+			...fragment.style
+		};
+		if (!sameStyle(style, inherited)) next = [...scopes, {
+			kind: "style",
+			style: fragment.style
+		}];
+	} else if (fragment.type === "link") next = [...scopes, {
+		kind: "link",
+		href: fragment.href
+	}];
+	for (const child of fragment.children) yield* fragmentTokens(child, next, style);
+}
+function serializeTokens(tokens, colors = false, resetSuffix = "", ambient = {}) {
+	let output = "";
+	let active = [];
+	function transition(next) {
+		let common = 0;
+		while (common < active.length && common < next.length && active[common] === next[common]) common++;
+		const surviving = active.slice(0, common);
+		const restored = surviving.reduce((style, scope) => ({
+			...style,
+			...scope.style
+		}), ambient);
+		let reset = false;
+		let closedLink = false;
+		for (let i = active.length - 1; i >= common; i--) if (active[i].kind === "link") {
+			output += `\x1b]8;;\x1b\\${resetSuffix}${styleCode(restored)}`;
+			closedLink = true;
+		} else reset = true;
+		active = surviving;
+		if (closedLink) {
+			const parentLink = active.findLast((scope) => scope.kind === "link");
+			if (parentLink != null) output += `\x1b]8;;${parentLink.href}\x1b\\`;
+		}
+		if (reset) output += "\x1B[0m" + resetSuffix + styleCode(restored);
+		for (const scope of next.slice(common)) {
+			if (scope.kind === "link") output += `\x1b]8;;${scope.href}\x1b\\`;
+			else if (scope.style) if (Object.values(scope.style).includes(false)) {
+				const inherited = active.reduce((s, x) => ({
+					...s,
+					...x.style
+				}), ambient);
+				output += "\x1B[0m" + resetSuffix + styleCode({
+					...inherited,
+					...scope.style
+				});
+			} else output += styleCode(scope.style);
+			active = [...active, scope];
+		}
+	}
+	const items = [...tokens];
+	for (let i = 0; i < items.length; i++) {
+		const token = items[i];
+		if (colors && token.width === -1) {
+			const next = items.slice(i + 1).find((t) => t.width !== -1)?.scopes ?? [];
+			let common = 0;
+			while (common < active.length && common < next.length && active[common] === next[common]) common++;
+			transition(active.slice(0, common));
+		} else if (colors) transition(token.scopes);
+		output += token.text;
+	}
+	if (colors) transition([]);
+	return output;
+}
+/**
+* Serializes one semantic leaf for a terminal surface outside a message.
+* @param term The semantic leaf to render.
+* @param theme Optional overrides for the default terminal theme.
+* @param colors Whether to emit styles and hyperlinks.
+* @param usage The leaf's usage context, when applicable.
+* @param ambient The style surrounding the rendered leaf.
+* @returns The leaf's styled or plain representation.
+* @throws {TypeError} If the term is a hard break or has an unknown type.
+* @throws {RangeError} If a color channel or palette index is invalid.
+* @since 1.3.0
+* @internal
+*/
+function renderTerminalTerm(term, theme, colors, usage, ambient) {
+	return serializeTokens(fragmentTokens(formatTerminalTerm(term, theme, false, usage)), colors, "", ambient);
+}
+/** Memoizes semantic leaves for one layout pass, including measurement. */
+function cacheTerminalTheme(theme = {}) {
+	function cache(formatter) {
+		const fragments = /* @__PURE__ */ new Map();
+		return (term, context) => {
+			const key = JSON.stringify([
+				term,
+				context.quotes,
+				context.usage
+			]);
+			let fragment = fragments.get(key);
+			if (fragment == null) {
+				fragment = formatter(term, context);
+				fragments.set(key, fragment);
+			}
+			return fragment;
+		};
+	}
+	return {
+		optionName: cache(theme.optionName ?? defaultTerminalTheme.optionName),
+		optionNames: cache(theme.optionNames ?? defaultTerminalTheme.optionNames),
+		metavar: cache(theme.metavar ?? defaultTerminalTheme.metavar),
+		value: cache(theme.value ?? defaultTerminalTheme.value),
+		values: cache(valuesFormatter(theme)),
+		envVar: cache(theme.envVar ?? defaultTerminalTheme.envVar),
+		commandLine: cache(theme.commandLine ?? defaultTerminalTheme.commandLine),
+		url: cache(theme.url ?? defaultTerminalTheme.url),
+		programName: cache(theme.programName ?? defaultTerminalTheme.programName),
+		label: cache(theme.label ?? defaultTerminalTheme.label),
+		syntaxPunctuation: cache(theme.syntaxPunctuation ?? defaultTerminalTheme.syntaxPunctuation),
+		errorLabel: cache(theme.errorLabel ?? defaultTerminalTheme.errorLabel),
+		annotationStyles: theme.annotationStyles == null ? void 0 : {
+			default: theme.annotationStyles.default == null ? void 0 : { ...theme.annotationStyles.default },
+			choices: theme.annotationStyles.choices == null ? void 0 : { ...theme.annotationStyles.choices }
+		}
+	};
+}
+
+//#endregion
+export { cacheTerminalTheme, formatTerminalTerm, fragmentTokens, renderTerminalTerm, serializeTokens, styleCode, terminalText };

package/dist/terminal.cjs

@@ -0,0 +1,73 @@
+
+//#region src/terminal.ts
+const plain = (text) => ({
+	type: "text",
+	text
+});
+const styled = (text, style) => ({
+	type: "style",
+	style,
+	children: [plain(text)]
+});
+/**
+* Optique's built-in terminal theme, with every formatter available for delegation.
+* @since 1.3.0
+*/
+const defaultTerminalTheme = {
+	optionName: (_term, ctx) => styled(ctx.text, ctx.usage === "command" ? { bold: true } : { italic: true }),
+	optionNames: (term, ctx) => ({
+		type: "concat",
+		children: term.optionNames.flatMap((name, i) => [...i === 0 ? [] : [ctx.format({
+			type: "syntaxPunctuation",
+			punctuation: "/",
+			kind: "messageOptionSeparator"
+		})], ctx.format({
+			type: "optionName",
+			optionName: name
+		})])
+	}),
+	metavar: (_term, ctx) => ctx.usage === "optionValue" ? {
+		type: "style",
+		style: { underline: true },
+		children: [styled(ctx.text, { dim: true })]
+	} : styled(ctx.text, ctx.usage === "argument" ? { underline: true } : { bold: true }),
+	value: (_term, ctx) => ctx.usage === "literal" ? plain(ctx.text) : styled(ctx.text, { foreground: "green" }),
+	values: (term, ctx) => ({
+		type: "concat",
+		children: term.values.flatMap((value, i) => [...i === 0 ? [] : [plain(" ")], ctx.format({
+			type: "value",
+			value
+		})])
+	}),
+	envVar: (_term, ctx) => styled(ctx.text, {
+		bold: true,
+		underline: true
+	}),
+	commandLine: (_term, ctx) => styled(ctx.text, { foreground: "cyan" }),
+	url: (term, ctx) => ({
+		type: "link",
+		href: term.url.href,
+		children: [plain(ctx.text)]
+	}),
+	programName: (_term, ctx) => styled(ctx.text, { bold: true }),
+	label: (term, ctx) => term.kind === "usageSummary" || term.kind === "choices" ? plain(ctx.text) : styled(ctx.text, {
+		bold: true,
+		dim: true
+	}),
+	syntaxPunctuation: (term, ctx) => [
+		"alternative",
+		"messageOptionSeparator",
+		"defaultPrefix",
+		"defaultSuffix",
+		"choicesPrefix",
+		"choicesSuffix"
+	].includes(term.kind) ? plain(ctx.text) : styled(ctx.text, { dim: true }),
+	errorLabel: (_term, ctx) => plain(ctx.text),
+	annotationStyles: {
+		default: { dim: true },
+		choices: { dim: true }
+	}
+};
+
+//#endregion
+exports.defaultTerminalTheme = defaultTerminalTheme;

package/dist/terminal.d.cts

@@ -0,0 +1,129 @@
+import { MessageTerm } from "./message.cjs";
+
+//#region src/terminal.d.ts
+
+/**
+ * A program's executable name.
+ * @since 1.3.0
+ */
+interface ProgramNameTerm {
+  readonly type: "programName";
+  readonly programName: string;
+}
+/**
+ * A heading or annotation label.
+ * @since 1.3.0
+ */
+interface LabelTerm {
+  readonly type: "label";
+  readonly label: string;
+  readonly kind: "usage" | "usageSummary" | "section" | "examples" | "author" | "bugs" | "choices";
+}
+/**
+ * Punctuation supplied by a terminal renderer.
+ * @since 1.3.0
+ */
+interface SyntaxPunctuationTerm {
+  readonly type: "syntaxPunctuation";
+  readonly punctuation: string;
+  readonly kind: "optionalOpen" | "optionalClose" | "groupOpen" | "groupClose" | "alternative" | "ellipsis" | "passthrough" | "optionSeparator" | "messageOptionSeparator" | "defaultPrefix" | "defaultSuffix" | "choicesPrefix" | "choicesSuffix";
+}
+/**
+ * The label preceding an error message.
+ * @since 1.3.0
+ */
+interface ErrorLabelTerm {
+  readonly type: "errorLabel";
+  readonly label: string;
+}
+/**
+ * Semantic leaves shared by message, usage, and help renderers.
+ * @since 1.3.0
+ */
+type TerminalTerm = MessageTerm | ProgramNameTerm | LabelTerm | SyntaxPunctuationTerm | ErrorLabelTerm;
+/**
+ * A terminal color. RGB channels and palette indices are integers from 0 to 255.
+ * @since 1.3.0
+ */
+type TerminalColor = "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "brightBlack" | "brightRed" | "brightGreen" | "brightYellow" | "brightBlue" | "brightMagenta" | "brightCyan" | "brightWhite" | readonly [number, number, number] | {
+  readonly index: number;
+};
+/**
+ * Inherited terminal styling; false disables an inherited attribute.
+ * @since 1.3.0
+ */
+interface TerminalStyle {
+  readonly foreground?: TerminalColor;
+  readonly background?: TerminalColor;
+  readonly bold?: boolean;
+  readonly dim?: boolean;
+  readonly italic?: boolean;
+  readonly underline?: boolean;
+}
+/**
+ * Structured output. Each text leaf is an indivisible wrapping unit.
+ * @since 1.3.0
+ */
+type TerminalFragment = {
+  readonly type: "text";
+  readonly text: string;
+} | {
+  readonly type: "concat";
+  readonly children: readonly TerminalFragment[];
+} | {
+  readonly type: "style";
+  readonly style: TerminalStyle;
+  readonly children: readonly TerminalFragment[];
+} | {
+  readonly type: "link";
+  readonly href: string;
+  readonly children: readonly TerminalFragment[];
+};
+/**
+ * Context supplied to a semantic formatter.
+ * @since 1.3.0
+ */
+interface TerminalFormatContext {
+  /** Whether the default display text includes quotes. */
+  readonly quotes: boolean;
+  /** Default display text, quoted but not styled. */
+  readonly text: string;
+  /** The purpose of a leaf originating in a usage description. */
+  readonly usage?: "argument" | "optionValue" | "command" | "literal";
+  /** Formats a child through the effective theme. Same-role recursion is the author's responsibility. */
+  readonly format: (term: Exclude<TerminalTerm, {
+    readonly type: "lineBreak";
+  }>) => TerminalFragment;
+}
+/**
+ * Formats a semantic leaf without emitting ANSI.
+ * @since 1.3.0
+ */
+type TerminalFormatter<T extends TerminalTerm = TerminalTerm> = (term: T, context: TerminalFormatContext) => TerminalFragment;
+type Role = Exclude<TerminalTerm["type"], "text" | "lineBreak">;
+type Formatters = { readonly [K in Role]: TerminalFormatter<Extract<TerminalTerm, {
+  readonly type: K;
+}>> };
+/**
+ * A partial theme; omitted roles retain their defaults.
+ * @since 1.3.0
+ */
+type TerminalTheme = Partial<Formatters> & {
+  /** Surrounding annotation styles. Missing styles are dim; {} disables dim. */
+  readonly annotationStyles?: {
+    readonly default?: TerminalStyle;
+    readonly choices?: TerminalStyle;
+  };
+};
+/**
+ * Optique's built-in terminal theme, with every formatter available for delegation.
+ * @since 1.3.0
+ */
+declare const defaultTerminalTheme: Formatters & {
+  readonly annotationStyles: {
+    readonly default: TerminalStyle;
+    readonly choices: TerminalStyle;
+  };
+};
+//#endregion
+export { ErrorLabelTerm, LabelTerm, ProgramNameTerm, SyntaxPunctuationTerm, TerminalColor, TerminalFormatContext, TerminalFormatter, TerminalFragment, TerminalStyle, TerminalTerm, TerminalTheme, defaultTerminalTheme };

package/dist/terminal.d.ts

@@ -0,0 +1,129 @@
+import { MessageTerm } from "./message.js";
+
+//#region src/terminal.d.ts
+
+/**
+ * A program's executable name.
+ * @since 1.3.0
+ */
+interface ProgramNameTerm {
+  readonly type: "programName";
+  readonly programName: string;
+}
+/**
+ * A heading or annotation label.
+ * @since 1.3.0
+ */
+interface LabelTerm {
+  readonly type: "label";
+  readonly label: string;
+  readonly kind: "usage" | "usageSummary" | "section" | "examples" | "author" | "bugs" | "choices";
+}
+/**
+ * Punctuation supplied by a terminal renderer.
+ * @since 1.3.0
+ */
+interface SyntaxPunctuationTerm {
+  readonly type: "syntaxPunctuation";
+  readonly punctuation: string;
+  readonly kind: "optionalOpen" | "optionalClose" | "groupOpen" | "groupClose" | "alternative" | "ellipsis" | "passthrough" | "optionSeparator" | "messageOptionSeparator" | "defaultPrefix" | "defaultSuffix" | "choicesPrefix" | "choicesSuffix";
+}
+/**
+ * The label preceding an error message.
+ * @since 1.3.0
+ */
+interface ErrorLabelTerm {
+  readonly type: "errorLabel";
+  readonly label: string;
+}
+/**
+ * Semantic leaves shared by message, usage, and help renderers.
+ * @since 1.3.0
+ */
+type TerminalTerm = MessageTerm | ProgramNameTerm | LabelTerm | SyntaxPunctuationTerm | ErrorLabelTerm;
+/**
+ * A terminal color. RGB channels and palette indices are integers from 0 to 255.
+ * @since 1.3.0
+ */
+type TerminalColor = "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "brightBlack" | "brightRed" | "brightGreen" | "brightYellow" | "brightBlue" | "brightMagenta" | "brightCyan" | "brightWhite" | readonly [number, number, number] | {
+  readonly index: number;
+};
+/**
+ * Inherited terminal styling; false disables an inherited attribute.
+ * @since 1.3.0
+ */
+interface TerminalStyle {
+  readonly foreground?: TerminalColor;
+  readonly background?: TerminalColor;
+  readonly bold?: boolean;
+  readonly dim?: boolean;
+  readonly italic?: boolean;
+  readonly underline?: boolean;
+}
+/**
+ * Structured output. Each text leaf is an indivisible wrapping unit.
+ * @since 1.3.0
+ */
+type TerminalFragment = {
+  readonly type: "text";
+  readonly text: string;
+} | {
+  readonly type: "concat";
+  readonly children: readonly TerminalFragment[];
+} | {
+  readonly type: "style";
+  readonly style: TerminalStyle;
+  readonly children: readonly TerminalFragment[];
+} | {
+  readonly type: "link";
+  readonly href: string;
+  readonly children: readonly TerminalFragment[];
+};
+/**
+ * Context supplied to a semantic formatter.
+ * @since 1.3.0
+ */
+interface TerminalFormatContext {
+  /** Whether the default display text includes quotes. */
+  readonly quotes: boolean;
+  /** Default display text, quoted but not styled. */
+  readonly text: string;
+  /** The purpose of a leaf originating in a usage description. */
+  readonly usage?: "argument" | "optionValue" | "command" | "literal";
+  /** Formats a child through the effective theme. Same-role recursion is the author's responsibility. */
+  readonly format: (term: Exclude<TerminalTerm, {
+    readonly type: "lineBreak";
+  }>) => TerminalFragment;
+}
+/**
+ * Formats a semantic leaf without emitting ANSI.
+ * @since 1.3.0
+ */
+type TerminalFormatter<T extends TerminalTerm = TerminalTerm> = (term: T, context: TerminalFormatContext) => TerminalFragment;
+type Role = Exclude<TerminalTerm["type"], "text" | "lineBreak">;
+type Formatters = { readonly [K in Role]: TerminalFormatter<Extract<TerminalTerm, {
+  readonly type: K;
+}>> };
+/**
+ * A partial theme; omitted roles retain their defaults.
+ * @since 1.3.0
+ */
+type TerminalTheme = Partial<Formatters> & {
+  /** Surrounding annotation styles. Missing styles are dim; {} disables dim. */
+  readonly annotationStyles?: {
+    readonly default?: TerminalStyle;
+    readonly choices?: TerminalStyle;
+  };
+};
+/**
+ * Optique's built-in terminal theme, with every formatter available for delegation.
+ * @since 1.3.0
+ */
+declare const defaultTerminalTheme: Formatters & {
+  readonly annotationStyles: {
+    readonly default: TerminalStyle;
+    readonly choices: TerminalStyle;
+  };
+};
+//#endregion
+export { ErrorLabelTerm, LabelTerm, ProgramNameTerm, SyntaxPunctuationTerm, TerminalColor, TerminalFormatContext, TerminalFormatter, TerminalFragment, TerminalStyle, TerminalTerm, TerminalTheme, defaultTerminalTheme };

package/dist/terminal.js

@@ -0,0 +1,72 @@
+//#region src/terminal.ts
+const plain = (text) => ({
+	type: "text",
+	text
+});
+const styled = (text, style) => ({
+	type: "style",
+	style,
+	children: [plain(text)]
+});
+/**
+* Optique's built-in terminal theme, with every formatter available for delegation.
+* @since 1.3.0
+*/
+const defaultTerminalTheme = {
+	optionName: (_term, ctx) => styled(ctx.text, ctx.usage === "command" ? { bold: true } : { italic: true }),
+	optionNames: (term, ctx) => ({
+		type: "concat",
+		children: term.optionNames.flatMap((name, i) => [...i === 0 ? [] : [ctx.format({
+			type: "syntaxPunctuation",
+			punctuation: "/",
+			kind: "messageOptionSeparator"
+		})], ctx.format({
+			type: "optionName",
+			optionName: name
+		})])
+	}),
+	metavar: (_term, ctx) => ctx.usage === "optionValue" ? {
+		type: "style",
+		style: { underline: true },
+		children: [styled(ctx.text, { dim: true })]
+	} : styled(ctx.text, ctx.usage === "argument" ? { underline: true } : { bold: true }),
+	value: (_term, ctx) => ctx.usage === "literal" ? plain(ctx.text) : styled(ctx.text, { foreground: "green" }),
+	values: (term, ctx) => ({
+		type: "concat",
+		children: term.values.flatMap((value, i) => [...i === 0 ? [] : [plain(" ")], ctx.format({
+			type: "value",
+			value
+		})])
+	}),
+	envVar: (_term, ctx) => styled(ctx.text, {
+		bold: true,
+		underline: true
+	}),
+	commandLine: (_term, ctx) => styled(ctx.text, { foreground: "cyan" }),
+	url: (term, ctx) => ({
+		type: "link",
+		href: term.url.href,
+		children: [plain(ctx.text)]
+	}),
+	programName: (_term, ctx) => styled(ctx.text, { bold: true }),
+	label: (term, ctx) => term.kind === "usageSummary" || term.kind === "choices" ? plain(ctx.text) : styled(ctx.text, {
+		bold: true,
+		dim: true
+	}),
+	syntaxPunctuation: (term, ctx) => [
+		"alternative",
+		"messageOptionSeparator",
+		"defaultPrefix",
+		"defaultSuffix",
+		"choicesPrefix",
+		"choicesSuffix"
+	].includes(term.kind) ? plain(ctx.text) : styled(ctx.text, { dim: true }),
+	errorLabel: (_term, ctx) => plain(ctx.text),
+	annotationStyles: {
+		default: { dim: true },
+		choices: { dim: true }
+	}
+};
+
+//#endregion
+export { defaultTerminalTheme };