@looma/prisma-cli 0.1.1

package/dist/shell/command-meta.js

@@ -0,0 +1,294 @@
+//#region src/shell/command-meta.ts
+const COMMAND_DESCRIPTOR_ID = Symbol("prisma.commandDescriptorId");
+const DESCRIPTORS = [
+	{
+		id: "root",
+		path: ["prisma"],
+		description: "Unified Prisma CLI.",
+		docsPath: "docs/product/vision.md",
+		examples: ["prisma auth login", "prisma project list"],
+		longDescription: "The Prisma CLI groups commands by developer workflow and keeps human and agent behavior aligned."
+	},
+	{
+		id: "auth",
+		path: ["prisma", "auth"],
+		description: "Authentication and identity commands.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-login",
+		examples: ["prisma auth login", "prisma auth whoami"]
+	},
+	{
+		id: "auth.login",
+		path: [
+			"prisma",
+			"auth",
+			"login"
+		],
+		description: "Start an authenticated CLI session.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-login",
+		examples: ["prisma auth login"]
+	},
+	{
+		id: "auth.logout",
+		path: [
+			"prisma",
+			"auth",
+			"logout"
+		],
+		description: "Clear the current CLI session.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-logout",
+		examples: ["prisma auth logout"]
+	},
+	{
+		id: "auth.whoami",
+		path: [
+			"prisma",
+			"auth",
+			"whoami"
+		],
+		description: "Show the current authenticated identity.",
+		docsPath: "docs/product/command-spec.md#prisma-auth-whoami",
+		examples: ["prisma auth whoami", "prisma auth whoami --json"]
+	},
+	{
+		id: "project",
+		path: ["prisma", "project"],
+		description: "Project discovery and repo linking commands.",
+		docsPath: "docs/product/command-spec.md#prisma-project-list",
+		examples: ["prisma project list", "prisma project show"]
+	},
+	{
+		id: "app",
+		path: ["prisma", "app"],
+		description: "App deployment and release commands.",
+		docsPath: "docs/product/command-spec.md#prisma-app-deploy---app-name",
+		examples: ["prisma app build --build-type nextjs", "prisma app deploy --app hello-world"]
+	},
+	{
+		id: "env",
+		path: ["prisma", "env"],
+		description: "Environment context and safety commands.",
+		docsPath: "docs/product/command-spec.md#prisma-env-list",
+		examples: ["prisma env list", "prisma env use production"]
+	},
+	{
+		id: "project.list",
+		path: [
+			"prisma",
+			"project",
+			"list"
+		],
+		description: "List projects for the authenticated workspace.",
+		docsPath: "docs/product/command-spec.md#prisma-project-list",
+		examples: ["prisma project list", "prisma project list --json"]
+	},
+	{
+		id: "project.show",
+		path: [
+			"prisma",
+			"project",
+			"show"
+		],
+		description: "Show the linked project for the current repo.",
+		docsPath: "docs/product/command-spec.md#prisma-project-show",
+		examples: ["prisma project show", "prisma project show --json"]
+	},
+	{
+		id: "project.link",
+		path: [
+			"prisma",
+			"project",
+			"link"
+		],
+		description: "Link the current repo to an existing project.",
+		docsPath: "docs/product/command-spec.md#prisma-project-link-project",
+		examples: ["prisma project link", "prisma project link proj_123"]
+	},
+	{
+		id: "env.list",
+		path: [
+			"prisma",
+			"env",
+			"list"
+		],
+		description: "List environments for the linked project.",
+		docsPath: "docs/product/command-spec.md#prisma-env-list",
+		examples: ["prisma env list", "prisma env list --json"]
+	},
+	{
+		id: "env.show",
+		path: [
+			"prisma",
+			"env",
+			"show"
+		],
+		description: "Show the current active environment context.",
+		docsPath: "docs/product/command-spec.md#prisma-env-show",
+		examples: ["prisma env show", "prisma env show --json"]
+	},
+	{
+		id: "env.use",
+		path: [
+			"prisma",
+			"env",
+			"use"
+		],
+		description: "Change the local default environment context.",
+		docsPath: "docs/product/command-spec.md#prisma-env-use-name",
+		examples: ["prisma env use", "prisma env use production"]
+	},
+	{
+		id: "app.build",
+		path: [
+			"prisma",
+			"app",
+			"build"
+		],
+		description: "Build the local app into a deployable artifact.",
+		docsPath: "docs/product/command-spec.md#prisma-app-build---entry-path---build-type-autobunnextjs",
+		examples: ["prisma app build --build-type nextjs", "prisma app build --build-type bun --entry server.ts"]
+	},
+	{
+		id: "app.run",
+		path: [
+			"prisma",
+			"app",
+			"run"
+		],
+		description: "Start a local framework dev server.",
+		docsPath: "docs/product/command-spec.md#prisma-app-run---entry-path---build-type-autobunnextjs---port-port",
+		examples: ["prisma app run --build-type nextjs", "prisma app run --build-type bun --entry server.ts --port 3000"]
+	},
+	{
+		id: "app.deploy",
+		path: [
+			"prisma",
+			"app",
+			"deploy"
+		],
+		description: "Build and release the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-deploy---app-name",
+		examples: ["prisma app deploy", "prisma app deploy --app hello-world"]
+	},
+	{
+		id: "app.show",
+		path: [
+			"prisma",
+			"app",
+			"show"
+		],
+		description: "Show the current state of the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-show---app-name",
+		examples: ["prisma app show", "prisma app show --app hello-world"]
+	},
+	{
+		id: "app.open",
+		path: [
+			"prisma",
+			"app",
+			"open"
+		],
+		description: "Open the live URL for the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-open---app-name",
+		examples: ["prisma app open", "prisma app open --app hello-world"]
+	},
+	{
+		id: "app.logs",
+		path: [
+			"prisma",
+			"app",
+			"logs"
+		],
+		description: "Show or stream logs for a deployment.",
+		docsPath: "docs/product/command-spec.md#prisma-app-logs---app-name---deployment-id",
+		examples: ["prisma app logs", "prisma app logs --deployment dep_123"]
+	},
+	{
+		id: "app.list-deploys",
+		path: [
+			"prisma",
+			"app",
+			"list-deploys"
+		],
+		description: "List deployments for the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-list-deploys---app-name",
+		examples: ["prisma app list-deploys", "prisma app list-deploys --app hello-world"]
+	},
+	{
+		id: "app.show-deploy",
+		path: [
+			"prisma",
+			"app",
+			"show-deploy"
+		],
+		description: "Show one deployment in detail.",
+		docsPath: "docs/product/command-spec.md#prisma-app-show-deploy-deployment",
+		examples: ["prisma app show-deploy dep_123"]
+	},
+	{
+		id: "app.promote",
+		path: [
+			"prisma",
+			"app",
+			"promote"
+		],
+		description: "Switch the live deployment for the selected app.",
+		docsPath: "docs/product/command-spec.md#prisma-app-promote-deployment---app-name",
+		examples: ["prisma app promote dep_123", "prisma app promote dep_123 --app hello-world"]
+	},
+	{
+		id: "app.rollback",
+		path: [
+			"prisma",
+			"app",
+			"rollback"
+		],
+		description: "Restore the selected app to an earlier deployment.",
+		docsPath: "docs/product/command-spec.md#prisma-app-rollback---app-name---to-deployment",
+		examples: ["prisma app rollback", "prisma app rollback --app hello-world --to dep_123"]
+	},
+	{
+		id: "app.remove",
+		path: [
+			"prisma",
+			"app",
+			"remove"
+		],
+		description: "Remove the selected app from the linked project.",
+		docsPath: "docs/product/command-spec.md#prisma-app-remove---app-name--y---yes",
+		examples: ["prisma app remove --app hello-world", "prisma app remove --app hello-world --yes"]
+	}
+];
+const DESCRIPTORS_BY_ID = new Map(DESCRIPTORS.map((descriptor) => [descriptor.id, descriptor]));
+function attachCommandDescriptor(command, descriptorId) {
+	const descriptor = getCommandDescriptor(descriptorId);
+	command[COMMAND_DESCRIPTOR_ID] = descriptor.id;
+	command.description(descriptor.description);
+	return command;
+}
+function getCommandDescriptor(id) {
+	const descriptor = DESCRIPTORS_BY_ID.get(id);
+	if (!descriptor) throw new Error(`Unknown command descriptor "${id}".`);
+	return descriptor;
+}
+function getDescriptorForCommand(command) {
+	const descriptorId = command[COMMAND_DESCRIPTOR_ID];
+	if (descriptorId) return getCommandDescriptor(descriptorId);
+	const path = getCommandPath(command);
+	const descriptor = DESCRIPTORS.find((candidate) => candidate.path.join(" ") === path.join(" "));
+	if (!descriptor) throw new Error(`No command descriptor registered for "${path.join(" ")}".`);
+	return descriptor;
+}
+function getCommandPath(command) {
+	const names = [];
+	let current = command;
+	while (current) {
+		if (current.name()) names.unshift(current.name());
+		current = current.parent ?? null;
+	}
+	return names;
+}
+function formatDescriptorLabel(descriptor) {
+	return descriptor.path.length === 1 ? descriptor.path[0] : descriptor.path.slice(1).join(" ");
+}
+//#endregion
+export { attachCommandDescriptor, formatDescriptorLabel, getCommandDescriptor, getDescriptorForCommand };

package/dist/shell/command-runner.js

@@ -0,0 +1,33 @@
+import { CliError } from "./errors.js";
+import { getCommandDescriptor } from "./command-meta.js";
+import { resolveGlobalFlags } from "./global-flags.js";
+import { createCommandContext } from "./runtime.js";
+import { writeHumanError, writeHumanLines, writeJsonError, writeJsonSuccess } from "./output.js";
+//#region src/shell/command-runner.ts
+async function runCommand(runtime, commandName, options, handler, presenter) {
+	const flags = resolveGlobalFlags(runtime.argv, options);
+	const context = await createCommandContext(runtime, flags);
+	const descriptor = getCommandDescriptor(commandName);
+	try {
+		const success = await handler(context);
+		if (flags.json) {
+			writeJsonSuccess(context.output, {
+				...success,
+				result: presenter.renderJson ? presenter.renderJson(success.result) : success.result
+			});
+			return;
+		}
+		if (flags.quiet) return;
+		writeHumanLines(context.output, presenter.renderHuman(context, descriptor, success.result));
+	} catch (error) {
+		if (error instanceof CliError) {
+			if (flags.json) writeJsonError(context.output, commandName, error);
+			else writeHumanError(context.output, context.ui, error, { trace: flags.trace });
+			process.exitCode = error.exitCode;
+			return;
+		}
+		throw error;
+	}
+}
+//#endregion
+export { runCommand };

package/dist/shell/errors.js

@@ -0,0 +1,64 @@
+//#region src/shell/errors.ts
+var CliError = class extends Error {
+	code;
+	domain;
+	severity;
+	summary;
+	why;
+	fix;
+	where;
+	meta;
+	docsUrl;
+	exitCode;
+	nextSteps;
+	constructor(options) {
+		super(options.summary);
+		this.name = "CliError";
+		this.code = options.code;
+		this.domain = options.domain;
+		this.severity = "error";
+		this.summary = options.summary;
+		this.why = options.why;
+		this.fix = options.fix;
+		this.where = options.where ?? null;
+		this.meta = options.meta ?? {};
+		this.docsUrl = options.docsUrl ?? null;
+		this.exitCode = options.exitCode ?? 1;
+		this.nextSteps = options.nextSteps ?? [];
+	}
+};
+function usageError(summary, why, fix, nextSteps = [], domain = "cli") {
+	return new CliError({
+		code: "USAGE_ERROR",
+		domain,
+		summary,
+		why,
+		fix,
+		exitCode: 2,
+		nextSteps
+	});
+}
+function authRequiredError(nextSteps = ["prisma auth login"]) {
+	return new CliError({
+		code: "AUTH_REQUIRED",
+		domain: "auth",
+		summary: "Authentication required",
+		why: "This command needs an authenticated session.",
+		fix: "Run prisma auth login, or rerun the command in a TTY to sign in interactively.",
+		exitCode: 1,
+		nextSteps
+	});
+}
+function featureUnavailableError(summary, why, fix, nextSteps = [], domain = "cli") {
+	return new CliError({
+		code: "FEATURE_UNAVAILABLE",
+		domain,
+		summary,
+		why,
+		fix,
+		exitCode: 1,
+		nextSteps
+	});
+}
+//#endregion
+export { CliError, authRequiredError, featureUnavailableError, usageError };

package/dist/shell/global-flags.js

@@ -0,0 +1,25 @@
+import { Option } from "commander";
+//#region src/shell/global-flags.ts
+function addGlobalFlags(command) {
+	return command.option("--json", "Emit structured JSON output.").option("-q, --quiet", "Reduce human-oriented output.").option("-v, --verbose", "Increase human-oriented output detail.").option("--trace", "Show deeper diagnostics for failures.").option("-y, --yes", "Accept supported confirmation prompts.").addOption(new Option("--interactive", "Force interactive behavior when prompts are supported.")).addOption(new Option("--no-interactive", "Disable interactive behavior and prompts.")).addOption(new Option("--color", "Force color output in supported terminals.")).addOption(new Option("--no-color", "Disable color output."));
+}
+function getExplicitBoolean(argv, positive, negative) {
+	for (let index = argv.length - 1; index >= 0; index -= 1) {
+		const value = argv[index];
+		if (value === positive) return true;
+		if (value === negative) return false;
+	}
+}
+function resolveGlobalFlags(argv, options) {
+	return {
+		json: options.json === true || argv.includes("--json"),
+		quiet: options.quiet === true || argv.includes("--quiet") || argv.includes("-q"),
+		verbose: options.verbose === true || argv.includes("--verbose") || argv.includes("-v"),
+		trace: options.trace === true || argv.includes("--trace"),
+		yes: options.yes === true || argv.includes("--yes") || argv.includes("-y"),
+		interactive: getExplicitBoolean(argv, "--interactive", "--no-interactive"),
+		color: getExplicitBoolean(argv, "--color", "--no-color")
+	};
+}
+//#endregion
+export { addGlobalFlags, resolveGlobalFlags };

package/dist/shell/help.js

@@ -0,0 +1,78 @@
+import { formatDescriptorLabel, getDescriptorForCommand } from "./command-meta.js";
+import { resolveGlobalFlags } from "./global-flags.js";
+import { createShellUi, padDisplay, wrapText } from "./ui.js";
+//#region src/shell/help.ts
+function renderHelp(command, runtime) {
+	const descriptor = getDescriptorForCommand(command);
+	const ui = createShellUi(runtime, resolveGlobalFlags(runtime.argv, {}));
+	const rail = ui.isTTY ? ui.dim("│") : "│";
+	const lines = [`${formatDescriptorLabel(descriptor)} ${ui.dim("→")} ${ui.dim(descriptor.description)}`, ""];
+	const visibleCommands = command.commands.filter((candidate) => candidate.name() !== "help" && !candidate.hidden);
+	const visibleOptions = command.options.filter((candidate) => !candidate.hidden);
+	if (visibleCommands.length > 0) lines.push(...renderCommandRows(rail, ui, visibleCommands));
+	if (visibleOptions.length > 0) {
+		if (visibleCommands.length > 0) lines.push(`${rail}`);
+		lines.push(...renderOptionRows(rail, ui, visibleOptions));
+	}
+	if (descriptor.examples && descriptor.examples.length > 0) {
+		lines.push(`${rail}`);
+		lines.push(`${rail}  Examples:`);
+		for (const example of descriptor.examples) lines.push(`${rail}    $ ${example}`);
+	}
+	if (descriptor.longDescription) {
+		lines.push(`${rail}`);
+		const wrapped = wrapText(descriptor.longDescription, Math.max(ui.width - 3, 40));
+		for (const line of wrapped) lines.push(`${rail}  ${line}`);
+	}
+	if (descriptor.docsPath) {
+		lines.push(`${rail}`);
+		lines.push(`${rail}  ${ui.accent(padDisplay("Read more", 16))}  ${ui.link(descriptor.docsPath)}`);
+	}
+	lines.push("");
+	return `${lines.join("\n")}`;
+}
+function renderCommandRows(rail, ui, commands) {
+	return renderAlignedRows(rail, ui, commands.map((command) => {
+		const descriptor = getDescriptorForCommand(command);
+		return {
+			term: renderCommandTerm(command),
+			description: descriptor.description
+		};
+	}));
+}
+function renderOptionRows(rail, ui, options) {
+	return renderAlignedRows(rail, ui, options.map((option) => ({
+		term: option.flags,
+		description: option.description || "",
+		defaultValue: option.defaultValueDescription ?? formatDefaultValue(option.defaultValue)
+	})));
+}
+function renderAlignedRows(rail, ui, rows) {
+	const termWidth = rows.reduce((width, row) => Math.max(width, row.term.length), 0);
+	const descriptionWidth = Math.max(ui.width - 3 - termWidth - 4, 30);
+	const lines = [];
+	for (const row of rows) {
+		const [firstLine, ...rest] = wrapText(row.description, descriptionWidth, " ".repeat(termWidth + 2));
+		lines.push(`${rail}  ${ui.accent(padDisplay(row.term, termWidth))}  ${firstLine}`);
+		for (const line of rest) lines.push(`${rail}  ${" ".repeat(termWidth)}  ${line.trimStart()}`);
+		if (row.defaultValue) lines.push(`${rail}  ${" ".repeat(termWidth)}  ${ui.dim(`default: ${row.defaultValue}`)}`);
+	}
+	return lines;
+}
+function renderCommandTerm(command) {
+	const argumentsList = command.registeredArguments.map(renderArgumentLabel).join(" ");
+	return `${command.name()}${argumentsList ? ` ${argumentsList}` : ""}`;
+}
+function renderArgumentLabel(argument) {
+	const name = argument.name();
+	return argument.required ? `<${name}>` : `[${name}]`;
+}
+function formatDefaultValue(value) {
+	if (value === void 0) return null;
+	if (Array.isArray(value)) return value.join(", ");
+	if (typeof value === "boolean" || typeof value === "number") return String(value);
+	if (typeof value === "string" && value.length > 0) return value;
+	return null;
+}
+//#endregion
+export { renderHelp };

package/dist/shell/output.js

@@ -0,0 +1,48 @@
+import { renderNextSteps, renderSummaryLine } from "./ui.js";
+//#region src/shell/output.ts
+function writeJsonSuccess(output, success) {
+	output.stdout.write(`${JSON.stringify({
+		ok: true,
+		...success
+	}, null, 2)}\n`);
+}
+function writeJsonError(output, command, error) {
+	output.stdout.write(`${JSON.stringify({
+		ok: false,
+		command,
+		error: {
+			code: error.code,
+			domain: error.domain,
+			severity: error.severity,
+			summary: error.summary,
+			why: error.why,
+			fix: error.fix,
+			where: error.where,
+			meta: error.meta,
+			docsUrl: error.docsUrl
+		},
+		warnings: [],
+		nextSteps: error.nextSteps
+	}, null, 2)}\n`);
+}
+function writeHumanLines(output, lines) {
+	if (lines.length === 0) return;
+	output.stderr.write(`${lines.join("\n")}\n`);
+}
+function writeHumanError(output, ui, error, options) {
+	const lines = [renderSummaryLine(ui, "error", `${error.summary} [${error.code}]`)];
+	if (error.where) lines.push(...["", `Where: ${error.where}`]);
+	if (error.why) {
+		if (!error.where) lines.push("");
+		lines.push(`Why: ${error.why}`);
+	}
+	if (error.fix) lines.push(`Fix: ${error.fix}`);
+	if (!options.trace) {
+		lines.push("");
+		lines.push("More: Re-run with --trace for deeper diagnostics");
+	}
+	lines.push(...renderNextSteps(error.nextSteps));
+	writeHumanLines(output, lines);
+}
+//#endregion
+export { writeHumanError, writeHumanLines, writeJsonError, writeJsonSuccess };

package/dist/shell/prompt.js

@@ -0,0 +1,31 @@
+import { usageError } from "./errors.js";
+import { isCancel, select, text } from "@clack/prompts";
+//#region src/shell/prompt.ts
+async function selectPrompt(options) {
+	const promptOptions = options.choices.map((choice) => ({
+		label: choice.label,
+		value: choice.value
+	}));
+	const response = await select({
+		input: options.input,
+		output: options.output,
+		message: options.message,
+		options: promptOptions
+	});
+	if (isCancel(response)) throw usageError("Interactive prompt canceled", "The command was canceled before a selection was made.", "Re-run the command and choose an option to continue.");
+	return response;
+}
+async function textPrompt(options) {
+	const response = await text({
+		input: options.input,
+		output: options.output,
+		message: options.message,
+		placeholder: options.placeholder,
+		validate: options.validate
+	});
+	if (isCancel(response)) throw usageError("Interactive prompt canceled", "The command was canceled before a value was entered.", "Re-run the command and provide a value to continue.");
+	return response;
+}
+function disposePromptState(_input) {}
+//#endregion
+export { disposePromptState, selectPrompt, textPrompt };

package/dist/shell/runtime.js

@@ -0,0 +1,51 @@
+import { LocalStateStore } from "../adapters/local-state.js";
+import { MockApi } from "../adapters/mock-api.js";
+import { createShellUi } from "./ui.js";
+import { renderHelp } from "./help.js";
+import path from "node:path";
+//#region src/shell/runtime.ts
+const DEFAULT_STATE_DIR_NAME = path.join(".prisma", "cli");
+function configureRuntimeCommand(command, runtime) {
+	return command.helpCommand(false).configureHelp({ formatHelp: (configuredCommand) => renderHelp(configuredCommand, runtime) }).configureOutput({
+		writeOut: (text) => {
+			runtime.stderr.write(text);
+		},
+		writeErr: (text) => {
+			runtime.stderr.write(text);
+		},
+		outputError: (text, write) => {
+			write(text);
+		}
+	}).exitOverride();
+}
+async function createCommandContext(runtime, flags) {
+	const fixturePath = runtime.fixturePath ?? runtime.env.PRISMA_CLI_MOCK_FIXTURE_PATH;
+	const stateDir = resolveStateDir(runtime);
+	let loadedApi;
+	if (fixturePath) loadedApi = await MockApi.load(fixturePath);
+	return {
+		get api() {
+			if (!loadedApi) throw new Error("context.api accessed in real mode. Set runtime.fixturePath or PRISMA_CLI_MOCK_FIXTURE_PATH to use fixture mode.");
+			return loadedApi;
+		},
+		stateStore: new LocalStateStore(stateDir),
+		output: {
+			stdout: runtime.stdout,
+			stderr: runtime.stderr
+		},
+		flags,
+		runtime,
+		ui: createShellUi(runtime, flags)
+	};
+}
+function resolveStateDir(runtime) {
+	return runtime.stateDir ?? runtime.env.PRISMA_CLI_STATE_DIR ?? path.join(runtime.cwd, DEFAULT_STATE_DIR_NAME);
+}
+function canPrompt(context) {
+	if (context.flags.json) return false;
+	if (context.flags.interactive === false) return false;
+	if (context.runtime.env.CI && context.flags.interactive !== true) return false;
+	return Boolean(context.runtime.stdin.isTTY && context.runtime.stderr.isTTY);
+}
+//#endregion
+export { canPrompt, configureRuntimeCommand, createCommandContext };

package/dist/shell/ui.js

@@ -0,0 +1,59 @@
+import stringWidth from "string-width";
+import stripAnsi from "strip-ansi";
+import wrapAnsi from "wrap-ansi";
+import { createColors } from "colorette";
+//#region src/shell/ui.ts
+const DEFAULT_WIDTH = 80;
+function createShellUi(runtime, flags) {
+	const isTTY = Boolean(runtime.stderr.isTTY);
+	const colorEnabled = resolveColorEnabled(runtime, flags, isTTY);
+	const colors = createColors({ useColor: colorEnabled });
+	return {
+		isTTY,
+		colorEnabled,
+		width: runtime.stderr.columns && runtime.stderr.columns > 0 ? runtime.stderr.columns : DEFAULT_WIDTH,
+		quiet: flags.quiet,
+		verbose: flags.verbose,
+		trace: flags.trace,
+		accent: (text) => colors.cyan(text),
+		success: (text) => colors.greenBright(text),
+		error: (text) => colors.redBright(text),
+		warning: (text) => colors.yellow(text),
+		info: (text) => colors.blue(text),
+		link: (text) => colors.blue(text),
+		dim: (text) => colors.dim(text),
+		strong: (text) => colors.bold(text)
+	};
+}
+function renderSummaryLine(ui, status, text) {
+	return `${status === "success" ? ui.success("✔") : status === "error" ? ui.error("✘") : status === "warning" ? ui.warning("⚠") : ui.info("ℹ")} ${text}`;
+}
+function renderNextSteps(steps) {
+	if (steps.length === 0) return [];
+	return [
+		"",
+		steps.length === 1 ? "Next step:" : "Next steps:",
+		...steps.map((step) => `- ${step}`)
+	];
+}
+function wrapText(text, width, indent = "") {
+	return wrapAnsi(text, width, {
+		hard: false,
+		trim: false
+	}).split("\n").map((line, index) => index === 0 ? line : `${indent}${line}`);
+}
+function padDisplay(text, width) {
+	const padding = Math.max(width - stringWidth(stripAnsi(text)), 0);
+	return `${text}${" ".repeat(padding)}`;
+}
+function maskValue(value) {
+	return value.replace(/([A-Za-z0-9._%+-]{1,})(?=@)/g, "****").replace(/:\/\/[^:@/\s]+:[^@/\s]+@/g, "://****:****@");
+}
+function resolveColorEnabled(runtime, flags, isTTY) {
+	if (flags.color === true) return true;
+	if (flags.color === false) return false;
+	if (runtime.env.NO_COLOR !== void 0) return false;
+	return isTTY;
+}
+//#endregion
+export { createShellUi, maskValue, padDisplay, renderNextSteps, renderSummaryLine, wrapText };