@phreshos/cli 0.1.4 → 0.1.6

package/dist/init.js

@@ -1,8 +1,8 @@
 import {} from "@phreshos/core";
 import { configFile, readManifest } from "./project.js";
-import { dim, heading, line } from "./style.js";
+import { dim } from "./style.js";
 import ensureProjectDependency, { projectScript } from "./project-dependency.js";
-import questions from "./questions.js";
+import prompts from "./prompts.js";
 import { existsSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 /**
@@ -16,139 +16,130 @@ import { resolve } from "node:path";
 export default async function init(options = {}, directory = process.cwd(), coreRange = "^0.1.0") {
     const manifest = await readManifest(directory);
     const path = resolve(directory, configFile);
-    const prompts = questions();
-    const { interactive, ask, yes } = prompts;
+    const interaction = prompts();
+    const { interactive, ask, yes } = interaction;
     const explicitShape = options.server === true || options.client === true;
     if (existsSync(path) && options.force !== true && !interactive)
         throw new Error(`${configFile} already exists — use --force to replace it`);
-    try {
-        if (existsSync(path) && options.force !== true) {
-            heading(configFile, "already initialized");
-            if (!await yes("The existing configuration must be replaced before this project can be initialized again.", "Replace it?", false)) {
-                console.log(`  ${dim("No changes made.")}\n`);
-                return;
-            }
-        }
-        heading("Initialize Program", manifest.name);
-        line("identity", manifest.name, "package.json");
-        if (manifest.version)
-            line("version", manifest.version, "package.json");
-        if (manifest.description)
-            line("description", manifest.description, "package.json");
-        console.log("");
-        let serverSelected = options.server === true;
-        let clientSelected = options.client === true;
-        if (!explicitShape) {
-            if (!interactive)
-                throw new Error("Choose at least one half with --server, --client, or both");
-            serverSelected = await yes("A Server runs on the host machine and can keep working without an open desktop.", "Does this Program have a Server?", true);
-            clientSelected = !serverSelected || await yes("A Client runs through a desktop and provides the Program's visual interface.", "Does this Program have a Client?", true);
+    interaction.begin("Initialize Program", manifest.name);
+    if (existsSync(path) && options.force !== true) {
+        interaction.detail(configFile, "already initialized");
+        if (!await yes("The existing configuration must be replaced before this project can be initialized again.", "Replace it?", false)) {
+            interaction.finish("No changes made");
+            return;
         }
-        if (!serverSelected && !clientSelected)
-            throw new Error("A Program must have a server half, a client half, or both");
-        const name = options.name ?? (interactive ? await ask("This name is shown to people; the package name remains the Program identity.", "What name should people see?", manifest.name) : undefined);
-        if (name !== undefined && name.trim().length === 0)
-            throw new Error("--name must not be empty");
-        let apiDocs = options.apiDocs;
-        if (interactive && apiDocs === undefined) {
-            const suggested = ["api-docs.md", "README.md"].find(file => existsSync(resolve(directory, file)));
-            if (await yes("API documentation explains only the services this Program itself provides.", "Does this Program provide API documentation?", Boolean(suggested))) {
-                apiDocs = await ask("The path is resolved from the project root and becomes the official API entry point.", "Where is the API documentation file?", suggested);
-            }
-        }
-        if (apiDocs !== undefined && apiDocs.trim().length === 0)
-            throw new Error("An API documentation path must not be empty");
-        let buildCommand = options.buildCommand;
-        if (interactive && buildCommand === undefined) {
-            const suggested = manifest.scripts?.build && projectScript(directory, manifest.packageManager, "build");
-            const builds = await yes("Production operations need the Program's built files.", "Build before start, install, and pack?", Boolean(suggested));
-            if (builds)
-                buildCommand = await ask("This command produces the production Server and Client files.", "What command builds the Program?", suggested || undefined);
+    }
+    interaction.detail("identity", manifest.name, "package.json");
+    if (manifest.version)
+        interaction.detail("version", manifest.version, "package.json");
+    if (manifest.description)
+        interaction.detail("description", manifest.description, "package.json");
+    let serverSelected = options.server === true;
+    let clientSelected = options.client === true;
+    if (!explicitShape) {
+        if (!interactive)
+            throw new Error("Choose at least one half with --server, --client, or both");
+        serverSelected = await yes("A Server runs on the host machine and can keep working without an open desktop.", "Does this Program have a Server?", true);
+        clientSelected = !serverSelected || await yes("A Client runs through a desktop and provides the Program's visual interface.", "Does this Program have a Client?", true);
+    }
+    if (!serverSelected && !clientSelected)
+        throw new Error("A Program must have a server half, a client half, or both");
+    const name = options.name ?? (interactive ? await ask("This name is shown to people; the package name remains the Program identity.", "What name should people see?", manifest.name) : undefined);
+    if (name !== undefined && name.trim().length === 0)
+        throw new Error("--name must not be empty");
+    let apiDocs = options.apiDocs;
+    if (interactive && apiDocs === undefined) {
+        const suggested = ["api-docs.md", "README.md"].find(file => existsSync(resolve(directory, file)));
+        if (await yes("API documentation explains only the services this Program itself provides.", "Does this Program provide API documentation?", false)) {
+            apiDocs = await ask("The path is resolved from the project root and becomes the official API entry point.", "Where is the API documentation file?", suggested);
         }
-        if (buildCommand !== undefined && buildCommand.trim().length === 0)
-            throw new Error("A build command must not be empty");
-        let server;
-        if (serverSelected) {
-            const location = options.serverLocation ?? (interactive ? await ask("The system runs the production Server from this project-relative directory.", "Where are the production Server files?", "build/server") : "");
-            const startCommand = options.serverStartCommand ?? (interactive ? await ask("This command runs inside the production Server directory.", "What command starts the production Server?", "node main.js") : "");
-            if (!location)
-                throw new Error("--server-location is required without a terminal");
-            if (!startCommand)
-                throw new Error("--server-start-command is required without a terminal");
-            let development = options.serverDevelopmentStartCommand;
-            if (interactive && development === undefined) {
-                const suggested = manifest.scripts?.dev && projectScript(directory, manifest.packageManager, "dev");
-                if (await yes("Development mode can run the Server directly from the project source.", "Run the Server from source during development?", Boolean(suggested && !clientSelected))) {
-                    development = await ask("This command remains attached to the phresh dev session.", "What command starts the development Server?", suggested || undefined);
-                }
+    }
+    if (apiDocs !== undefined && apiDocs.trim().length === 0)
+        throw new Error("An API documentation path must not be empty");
+    let buildCommand = options.buildCommand;
+    if (interactive && buildCommand === undefined) {
+        const suggested = manifest.scripts?.build && projectScript(directory, manifest.packageManager, "build");
+        const builds = await yes("Production operations need the Program's built files.", "Build before start, install, and pack?", Boolean(suggested));
+        if (builds)
+            buildCommand = await ask("This command produces the production Server and Client files.", "What command builds the Program?", suggested || undefined);
+    }
+    if (buildCommand !== undefined && buildCommand.trim().length === 0)
+        throw new Error("A build command must not be empty");
+    let server;
+    if (serverSelected) {
+        const location = options.serverLocation ?? (interactive ? await ask("The system runs the production Server from this project-relative directory.", "Where are the production Server files?", clientSelected ? "dist/server" : "dist") : "");
+        const startCommand = options.serverStartCommand ?? (interactive ? await ask("This command runs inside the production Server directory.", "What command starts the production Server?", "node main.js") : "");
+        if (!location)
+            throw new Error("--server-location is required without a terminal");
+        if (!startCommand)
+            throw new Error("--server-start-command is required without a terminal");
+        let development = options.serverDevelopmentStartCommand;
+        if (interactive && development === undefined) {
+            const suggested = manifest.scripts?.dev && projectScript(directory, manifest.packageManager, "dev");
+            if (await yes("Development mode can run the Server directly from the project source.", "Run the Server from source during development?", Boolean(suggested && !clientSelected))) {
+                development = await ask("This command remains attached to the phresh dev session.", "What command starts the development Server?", suggested || undefined);
             }
-            if (development !== undefined && development.trim().length === 0)
-                throw new Error("A server development command must not be empty");
-            server = { location, startCommand, ...development && { development: { startCommand: development } } };
         }
-        let client;
-        if (clientSelected) {
-            const location = options.clientLocation ?? (interactive ? await ask("The system serves the production Client from this project-relative directory.", "Where are the production Client files?", "dist") : "");
-            if (!location)
-                throw new Error("--client-location is required without a terminal");
-            let developmentUrl = options.clientDevelopmentUrl;
-            let developmentStartCommand = options.clientDevelopmentStartCommand;
-            if (interactive && developmentUrl === undefined && developmentStartCommand === undefined) {
-                const suggested = manifest.scripts?.dev && projectScript(directory, manifest.packageManager, "dev");
-                if (await yes("A development server can provide live updates instead of built Client files.", "Use a Client development server?", Boolean(suggested))) {
-                    developmentUrl = await ask("The desktop opens this exact HTTP or HTTPS address during phresh dev.", "What URL serves the development Client?", "http://localhost:5173/");
-                    if (await yes("The CLI can own the development server and stop it when the session ends.", "Should phresh dev start the Client server?", Boolean(suggested))) {
-                        developmentStartCommand = await ask("This command remains attached to the phresh dev session.", "What command starts the Client development server?", suggested || undefined);
-                    }
+        if (development !== undefined && development.trim().length === 0)
+            throw new Error("A server development command must not be empty");
+        server = { location, startCommand, ...development && { development: { startCommand: development } } };
+    }
+    let client;
+    if (clientSelected) {
+        const location = options.clientLocation ?? (interactive ? await ask("The system serves the production Client from this project-relative directory.", "Where are the production Client files?", serverSelected ? "dist/client" : "dist") : "");
+        if (!location)
+            throw new Error("--client-location is required without a terminal");
+        let developmentUrl = options.clientDevelopmentUrl;
+        let developmentStartCommand = options.clientDevelopmentStartCommand;
+        if (interactive && developmentUrl === undefined && developmentStartCommand === undefined) {
+            const suggested = manifest.scripts?.dev && projectScript(directory, manifest.packageManager, "dev");
+            if (await yes("A development server can provide live updates instead of built Client files.", "Use a Client development server?", Boolean(suggested))) {
+                developmentUrl = await ask("The desktop opens this exact HTTP or HTTPS address during phresh dev.", "What URL serves the development Client?", "http://localhost:5173/");
+                if (await yes("The CLI can own the development server and stop it when the session ends.", "Should phresh dev start the Client server?", Boolean(suggested))) {
+                    developmentStartCommand = await ask("This command remains attached to the phresh dev session.", "What command starts the Client development server?", suggested || undefined);
                 }
             }
-            if (developmentStartCommand !== undefined && developmentUrl === undefined)
-                throw new Error("--client-development-url is required with --client-development-start-command");
-            if (developmentUrl !== undefined && developmentUrl.trim().length === 0)
-                throw new Error("A client development URL must not be empty");
-            if (developmentUrl !== undefined && !httpUrl(developmentUrl))
-                throw new Error("A client development URL must use HTTP or HTTPS");
-            if (developmentStartCommand !== undefined && developmentStartCommand.trim().length === 0)
-                throw new Error("A client development command must not be empty");
-            client = {
-                location,
-                ...developmentUrl && { development: { url: developmentUrl, ...developmentStartCommand && { startCommand: developmentStartCommand } } }
-            };
         }
-        const described = {
-            identity: manifest.name,
-            name,
-            version: manifest.version,
-            description: manifest.description,
-            apiDocs,
-            buildCommand
+        if (developmentStartCommand !== undefined && developmentUrl === undefined)
+            throw new Error("--client-development-url is required with --client-development-start-command");
+        if (developmentUrl !== undefined && developmentUrl.trim().length === 0)
+            throw new Error("A client development URL must not be empty");
+        if (developmentUrl !== undefined && !httpUrl(developmentUrl))
+            throw new Error("A client development URL must use HTTP or HTTPS");
+        if (developmentStartCommand !== undefined && developmentStartCommand.trim().length === 0)
+            throw new Error("A client development command must not be empty");
+        client = {
+            location,
+            ...developmentUrl && { development: { url: developmentUrl, ...developmentStartCommand && { startCommand: developmentStartCommand } } }
         };
-        const config = server
-            ? { ...described, server, ...client && { client } }
-            : { ...described, client: client };
-        await ensureProjectDependency("@phreshos/core", coreRange, directory);
-        writeFileSync(path, compose(config));
-        heading(configFile, "created");
-        if (config.server)
-            line("server", config.server.startCommand, `./${config.server.location}`);
-        if (config.client)
-            line("client", `./${config.client.location}`);
-        console.log("");
-        const next = [config.server?.development || config.client?.development ? "phresh dev" : null, "phresh start", "phresh install"].filter(Boolean);
-        console.log(`  ${dim("Next:")} ${next.join(`  ${dim("or")}  `)}`);
-        if (config.client) {
-            heading("Client requirements");
-            line("base URL", "./", "required for production assets");
-            if (config.client.development)
-                line("CORS", "enabled", "required on the development server");
-            console.log("");
-        }
-        else
-            console.log("");
     }
-    finally {
-        prompts.close();
+    const described = {
+        identity: manifest.name,
+        name,
+        version: manifest.version,
+        description: manifest.description,
+        apiDocs,
+        buildCommand
+    };
+    const config = server
+        ? { ...described, server, ...client && { client } }
+        : { ...described, client: client };
+    await ensureProjectDependency("@phreshos/core", coreRange, directory);
+    writeFileSync(path, compose(config));
+    if (config.server)
+        interaction.detail("server", config.server.startCommand, `./${config.server.location}`);
+    if (config.client)
+        interaction.detail("client", `./${config.client.location}`);
+    const next = [config.server?.development || config.client?.development ? "phresh dev" : null, "phresh start", "phresh install"].filter(Boolean);
+    interaction.message();
+    interaction.message(`${dim("Next:")} ${next.join(`  ${dim("or")}  `)}`);
+    if (config.client) {
+        interaction.message();
+        interaction.detail("base URL", "./", "required for production assets");
+        if (config.client.development)
+            interaction.detail("CORS", "enabled", "required on the development server");
     }
+    interaction.finish(`${configFile} created`);
 }
 function compose(config) {
     const blocks = [

package/dist/pack.js

@@ -17,7 +17,7 @@ import build from "./build-command.js";
  * a declared half always has a location, even when the system chose it.
  *
  * There is **no wrapping directory**. `program.json`, `server/`,
- * `client/` and `icons/` sit at the package's root, and the directory
+ * `client/` and optional `icon.png` sit at the package's root, and the directory
  * the system installs into is named from the program's own `identity`.
  * The archive itself therefore needs no second naming layer.
  *
@@ -41,11 +41,8 @@ export default async function pack(directory = process.cwd()) {
         if (!zip.getEntry("client/index.html"))
             throw new Error(`The client files have no index.html — ${config.client.location} is not where a client half is`);
     }
-    // Icons are the program's own affair rather than either half's: a
-    // headless program is shown too. Packaged like a half, and like a
-    // half their place is not the program's to choose.
-    if (config.icons)
-        place(zip, directory, config.icons, "icons");
+    if (config.icon)
+        file(zip, directory, config.icon, "icon.png", "Program icon");
     if (config.apiDocs)
         document(zip, directory, config.apiDocs);
     zip.addFile("program.json", Buffer.from(JSON.stringify(program(config, version), null, 4) + "\n"));
@@ -64,6 +61,7 @@ function program(config, version) {
         version,
         description: config.description,
         apiDocs: config.apiDocs ? "api-docs.md" : undefined,
+        icon: config.icon ? "icon.png" : undefined,
         ...config.server && { server: { location: "server", start: config.server.start, installCommand: config.server.installCommand, startCommand: config.server.startCommand } },
         ...config.client && { client: { location: "client", start: config.client.start, title: config.client.title, size: config.client.size, position: config.client.position, layer: config.client.layer, minimize: config.client.minimize } }
     };
@@ -77,8 +75,11 @@ function place(zip, directory, location, half) {
     zip.addLocalFolder(from, half);
 }
 function document(zip, directory, location) {
+    file(zip, directory, location, "api-docs.md", "API documentation file");
+}
+function file(zip, directory, location, target, label) {
     const from = resolve(directory, location);
     if (!existsSync(from) || !statSync(from).isFile())
-        throw new Error(`The API documentation file is not at ${location}`);
-    zip.addFile("api-docs.md", readFileSync(from));
+        throw new Error(`The ${label} is not at ${location}`);
+    zip.addFile(target, readFileSync(from));
 }

package/dist/program-intake.js

@@ -1,6 +1,6 @@
 import { connect } from "node:net";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { isAbsolute, join } from "node:path";
 /**
  * The local Program intake, from the CLI's side.
  *
@@ -19,7 +19,15 @@ import { join } from "node:path";
  * the Program says, then how it ended. None pretends to be a remote method
  * returning through an unrelated transport.
  */
-export const socketPath = join(homedir(), ".phreshos", "intake.sock");
+export function programIntakePath(environment = process.env, userHome = homedir()) {
+    const instanceHome = environment.PHRESHOS_HOME;
+    if (instanceHome === undefined)
+        return join(userHome, ".phreshos", "intake.sock");
+    if (!isAbsolute(instanceHome))
+        throw new Error("PHRESHOS_HOME must be an absolute filesystem path");
+    return join(instanceHome, "intake.sock");
+}
+export const socketPath = programIntakePath();
 export default function speak(question, heard, path = socketPath, signal) {
     return new Promise(function (settle, refuse) {
         const socket = connect(path);

package/dist/project-dependency.js

@@ -1,46 +1,21 @@
 import { line } from "./style.js";
 import { spawn } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
-import { relative, resolve } from "node:path";
+import { resolve } from "node:path";
 /** Returns the package-manager command that runs one project script. */
 export function projectScript(directory, declared, script) {
     return `${projectPackageManager(directory, declared).name} run ${script}`;
 }
-/**
- * Resolves an SDK through the one source policy shared by `init` and `create`.
- *
- * A CLI running from this repository uses its sibling dev-kit. A distributed
- * CLI has no such sibling and keeps the published range embedded in its
- * generated template.
- */
-export function projectDependency(name, range, directory) {
-    const workspace = manifestAt(resolve(import.meta.dirname, "..", "..", ".."));
-    const sourceDirectory = resolve(import.meta.dirname, "..", "..", localDirectories[name]);
-    const manifest = manifestAt(sourceDirectory);
-    if (workspace?.name === "@phreshos/workspace" && manifest?.name === name && manifest.version && accepts(range, manifest.version)) {
-        const local = relative(directory, sourceDirectory).replaceAll("\\", "/") || ".";
-        return {
-            installSpecifier: sourceDirectory,
-            manifestSpecifier: `file:${local}`,
-            local: true
-        };
-    }
-    return {
-        installSpecifier: `${name}@${range}`,
-        manifestSpecifier: range,
-        local: false
-    };
-}
 /** Detects the package manager declared by, present in, or invoking a project. */
 export function projectPackageManager(directory, declared, preferred) {
     const named = preferred ?? packageManagerName(declared) ?? packageManagerFromLocks(directory) ?? packageManagerFromInvocation();
     return managers[named ?? "npm"];
 }
 /** Installs the dependencies already declared by a generated project. */
-export async function installProjectDependencies(directory, preferred) {
+export async function installProjectDependencies(directory, preferred, output = "inherit") {
     const manifest = manifestAt(directory);
     const manager = projectPackageManager(directory, manifest?.packageManager, preferred);
-    await run(manager.name, manager.installArgs, directory);
+    await run(manager.name, manager.installArgs, directory, output);
     return manager.name;
 }
 /**
@@ -56,32 +31,33 @@ export default async function ensureProjectDependency(name, range, directory = p
     if (manifest.dependencies?.[name] || manifest.devDependencies?.[name])
         return;
     const manager = projectPackageManager(directory, manifest.packageManager);
-    const source = projectDependency(name, range, directory);
-    line("dependency", name, `${manager.name}, ${source.local ? "local dev-kit" : range}`);
-    await run(manager.name, [...manager.addArgs(section), source.installSpecifier], directory);
+    line("dependency", name, `${manager.name}, ${range}`);
+    await run(manager.name, [...manager.addArgs(section), `${name}@${range}`], directory);
     console.log("");
 }
-function run(command, args, directory) {
+function run(command, args, directory, output = "inherit") {
     return new Promise(function (settle, refuse) {
+        let diagnostic = "";
         const child = spawn(command, args, {
             cwd: directory,
-            stdio: "inherit",
+            stdio: output === "capture" ? ["ignore", "pipe", "pipe"] : "inherit",
             shell: process.platform === "win32"
         });
+        if (output === "capture") {
+            child.stdout?.on("data", chunk => { diagnostic += String(chunk); });
+            child.stderr?.on("data", chunk => { diagnostic += String(chunk); });
+        }
         child.once("error", error => refuse(new Error(`Could not run ${command}: ${error.message}`)));
         child.once("exit", function (code, signal) {
             if (signal)
                 refuse(new Error(`${command} ended on ${signal}`));
             else if (code !== 0)
-                refuse(new Error(`${command} exited with ${code ?? 0}`));
+                refuse(new Error(`${command} exited with ${code ?? 0}${diagnostic.trim() ? `\n\n${diagnostic.trim()}` : ""}`));
             else
                 settle();
         });
     });
 }
-function accepts(range, version) {
-    return range === "workspace:*" || range === version || range === `^${version}` || range === `~${version}`;
-}
 function manifestAt(directory) {
     const path = resolve(directory, "package.json");
     if (!existsSync(path))
@@ -114,13 +90,6 @@ function packageManagerFromInvocation() {
 function isPackageManager(value) {
     return value === "bun" || value === "npm" || value === "pnpm" || value === "yarn";
 }
-const localDirectories = {
-    "@phreshos/core": "core-sdk",
-    "@phreshos/client": "client-sdk",
-    "@phreshos/server": "server-sdk",
-    "@phreshos/react": "react-sdk",
-    "@phreshos/cli": "cli"
-};
 const managers = {
     bun: {
         name: "bun",

package/dist/project.js

@@ -6,11 +6,10 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     }
     return path;
 };
-import { layers } from "@phreshos/core";
+import { isRelativeValue, layers } from "@phreshos/core";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
-import { isRelativeValue } from "./relative-value.js";
 export const configFile = "phresh.config.ts";
 export async function readConfig(directory = process.cwd()) {
     const path = resolve(directory, configFile);
@@ -40,7 +39,7 @@ function coherent(config) {
         throw new Error("A program's identity is kebab-case, because it is also the name of its directory");
     if (!config.server && !config.client)
         throw new Error("A program must have a server half, a client half, or both");
-    for (const field of ["name", "version", "description", "icons"]) {
+    for (const field of ["name", "version", "description", "icon"]) {
         if (config[field] !== undefined && typeof config[field] !== "string")
             throw new Error(`A program's ${field} must be text`);
     }

package/dist/prompts.js

@@ -0,0 +1,105 @@
+import { cancel, confirm, intro, isCancel, log, outro, select, spinner, text } from "@clack/prompts";
+import colors from "picocolors";
+import { column, heading, line } from "./style.js";
+/** Signals an ordinary interactive cancellation rather than an operation failure. */
+export class PromptCancelled extends Error {
+}
+/**
+ * One interaction language shared by commands that can ask questions.
+ *
+ * Clack owns terminal behavior. This adapter owns only the product's wording
+ * and the rule that automation never opens or waits for a prompt.
+ */
+export default function prompts() {
+    const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    function begin(title, context) {
+        if (interactive)
+            intro(`${colors.bold(title)}${context ? ` ${colors.dim(`· ${context}`)}` : ""}`);
+        else
+            heading(title, context);
+    }
+    function finish(message) {
+        if (interactive)
+            outro(colors.bold(message));
+        else
+            heading(message);
+    }
+    function detail(label, value, source) {
+        if (interactive)
+            log.message(`${colors.dim(column(label))}${value}${source ? `  ${colors.dim(source)}` : ""}`);
+        else
+            line(label, value, source);
+    }
+    function message(value = "") {
+        if (interactive)
+            log.message(value);
+        else
+            console.log(value ? `  ${value}` : "");
+    }
+    async function progress(message, completed, work) {
+        if (!interactive)
+            return await work();
+        const indicator = spinner();
+        indicator.start(message);
+        try {
+            const result = await work();
+            indicator.clear();
+            log.success(completed, { spacing: 0 });
+            return result;
+        }
+        catch (error) {
+            indicator.error(`${message} failed`);
+            throw error;
+        }
+    }
+    async function ask(explanation, question, fallback) {
+        if (!interactive)
+            throw new Error(`${question} Supply the corresponding option when no terminal is attached`);
+        log.message(colors.dim(explanation));
+        const value = await text({
+            message: question,
+            placeholder: fallback,
+            defaultValue: fallback
+        });
+        if (isCancel(value))
+            stop();
+        return value.trim();
+    }
+    async function yes(explanation, question, fallback) {
+        if (!interactive)
+            throw new Error(`${question} Supply the corresponding option when no terminal is attached`);
+        log.message(colors.dim(explanation));
+        const value = await confirm({ message: question, initialValue: fallback });
+        if (isCancel(value))
+            stop();
+        return value;
+    }
+    async function choose(explanation, question, values, fallback) {
+        if (!interactive)
+            throw new Error(`${question} Supply the corresponding option when no terminal is attached`);
+        log.message(colors.dim(explanation));
+        const value = await select({
+            message: question,
+            options: values.map(value => ({ value, label: value })),
+            initialValue: fallback
+        });
+        if (isCancel(value))
+            stop();
+        return value;
+    }
+    function stop() {
+        cancel("No changes made");
+        throw new PromptCancelled();
+    }
+    return {
+        interactive,
+        begin,
+        finish,
+        detail,
+        message,
+        progress,
+        ask,
+        yes,
+        choose
+    };
+}

package/dist/style.js

@@ -1,16 +1,8 @@
-/**
- * How every command looks.
- *
- * Six escapes rather than a dependency, and nothing at all where a
- * terminal would print them instead of obeying them. Shared because four
- * commands speaking three visual languages is worse than any one of
- * them: a person reading `phresh install` after `phresh init` should not
- * have to work out that it is the same tool.
- */
-const colour = process.stdout.isTTY && !process.env.NO_COLOR;
-const escape = String.fromCharCode(27);
-export const dim = (text) => colour ? `${escape}[2m${text}${escape}[22m` : text;
-export const bold = (text) => colour ? `${escape}[1m${text}${escape}[22m` : text;
+import colors from "picocolors";
+/** The quiet and emphatic text used by non-interactive command reports. */
+export const dim = colors.dim;
+export const bold = colors.bold;
+export const accent = colors.cyan;
 // A label, what it says, and where that came from. The label is quiet
 // and the value is not, because the value is the thing being reported.
 //
@@ -18,7 +10,10 @@ export const bold = (text) => colour ? `${escape}[1m${text}${escape}[22m` : text
 // even when one overruns: a label that runs into its value is worse than
 // a column that does not line up.
 export function line(label, value, note) {
-    console.log(`  ${dim(label.padEnd(12))}${value}${note ? `  ${dim(note)}` : ""}`);
+    console.log(`  ${dim(column(label))}${value}${note ? `  ${dim(note)}` : ""}`);
+}
+export function column(label) {
+    return label.length < 12 ? label.padEnd(12) : `${label} `;
 }
 export function heading(title, note) {
     console.log("");