@ree-auz/nook 0.1.0 → 0.1.1

package/src/prompt.mjs

@@ -1,100 +1,100 @@
-import { createInterface } from "node:readline/promises";
-import { NookError } from "./errors.mjs";
-import { line, useColor } from "./ui.mjs";
-
-/**
- * Asks questions on the terminal. With `yes`, every question takes its default.
- * Without a terminal and without `yes`, asking is an error, so scripts never hang.
- */
-export function createPrompter({ yes = false, input = process.stdin, output = process.stderr } = {}) {
-  const interactive = Boolean(input.isTTY);
-  // Questions get a mark like every other line, so their text lines up.
-  const mark = (text) => line("ask", text, useColor(output));
-
-  async function raw(question) {
-    if (!interactive)
-      throw new NookError(`Needs an answer ("${question.trim()}"); run it in a terminal`);
-    const rl = createInterface({ input, output });
-    try {
-      return (await rl.question(question)).trim();
-    } finally {
-      rl.close();
-    }
-  }
-
-  return {
-    yes,
-    interactive,
-    async ask(question, fallback = "") {
-      if (yes) return fallback;
-      const answer = await raw(mark(`${question}${fallback ? ` [${fallback}]` : ""}: `));
-      return answer || fallback;
-    },
-    /** Shows `initial` already typed so it can be edited; Enter keeps it. */
-    async edit(question, initial) {
-      if (yes || !interactive) return initial;
-      const rl = createInterface({ input, output });
-      try {
-        const pending = rl.question(mark(`${question}: `));
-        rl.write(initial);
-        return (await pending).trim() || initial;
-      } finally {
-        rl.close();
-      }
-    },
-    async confirm(question, fallback = false) {
-      if (yes) return fallback;
-      for (;;) {
-        const answer = (await raw(mark(`${question} ${fallback ? "[Y/n]" : "[y/N]"} `))).toLowerCase();
-        if (!answer) return fallback;
-        if (["y", "yes"].includes(answer)) return true;
-        if (["n", "no"].includes(answer)) return false;
-      }
-    },
-    /** choices: [{ key, label }]; returns the chosen key. */
-    async choose(question, choices, fallback) {
-      if (yes) return fallback;
-      output.write(`${mark(question)}\n`);
-      choices.forEach((choice, index) =>
-        output.write(`  ${index + 1}. ${choice.label}${choice.key === fallback ? " (default)" : ""}\n`),
-      );
-      for (;;) {
-        const answer = await raw(mark("Choose a number: "));
-        if (!answer) return fallback;
-        const picked = choices[Number(answer) - 1];
-        if (picked) return picked.key;
-      }
-    },
-  };
-}
-
-/** Splits "--a 'b c'" into ["--a", "b c"]. Supports single and double quotes. */
-export function splitArgs(text) {
-  const out = [];
-  let current = "";
-  let quote = null;
-  let started = false;
-  for (const char of text) {
-    if (quote) {
-      if (char === quote) quote = null;
-      else current += char;
-    } else if (char === '"' || char === "'") {
-      quote = char;
-      started = true;
-    } else if (/\s/.test(char)) {
-      if (started) out.push(current);
-      current = "";
-      started = false;
-    } else {
-      current += char;
-      started = true;
-    }
-  }
-  if (quote) throw new NookError(`Unclosed quote in: ${text}`);
-  if (started) out.push(current);
-  return out;
-}
-
-export function joinArgs(args) {
-  return args.map((arg) => (/[\s"']/.test(arg) || arg === "" ? JSON.stringify(arg) : arg)).join(" ");
-}
+import { createInterface } from "node:readline/promises";
+import { NookError } from "./errors.mjs";
+import { line, useColor } from "./ui.mjs";
+
+/**
+ * Asks questions on the terminal. With `yes`, every question takes its default.
+ * Without a terminal and without `yes`, asking is an error, so scripts never hang.
+ */
+export function createPrompter({ yes = false, input = process.stdin, output = process.stderr } = {}) {
+  const interactive = Boolean(input.isTTY);
+  // Questions get a mark like every other line, so their text lines up.
+  const mark = (text) => line("ask", text, useColor(output));
+
+  async function raw(question) {
+    if (!interactive)
+      throw new NookError(`Needs an answer ("${question.trim()}"); run it in a terminal`);
+    const rl = createInterface({ input, output });
+    try {
+      return (await rl.question(question)).trim();
+    } finally {
+      rl.close();
+    }
+  }
+
+  return {
+    yes,
+    interactive,
+    async ask(question, fallback = "") {
+      if (yes) return fallback;
+      const answer = await raw(mark(`${question}${fallback ? ` [${fallback}]` : ""}: `));
+      return answer || fallback;
+    },
+    /** Shows `initial` already typed so it can be edited; Enter keeps it. */
+    async edit(question, initial) {
+      if (yes || !interactive) return initial;
+      const rl = createInterface({ input, output });
+      try {
+        const pending = rl.question(mark(`${question}: `));
+        rl.write(initial);
+        return (await pending).trim() || initial;
+      } finally {
+        rl.close();
+      }
+    },
+    async confirm(question, fallback = false) {
+      if (yes) return fallback;
+      for (;;) {
+        const answer = (await raw(mark(`${question} ${fallback ? "[Y/n]" : "[y/N]"} `))).toLowerCase();
+        if (!answer) return fallback;
+        if (["y", "yes"].includes(answer)) return true;
+        if (["n", "no"].includes(answer)) return false;
+      }
+    },
+    /** choices: [{ key, label }]; returns the chosen key. */
+    async choose(question, choices, fallback) {
+      if (yes) return fallback;
+      output.write(`${mark(question)}\n`);
+      choices.forEach((choice, index) =>
+        output.write(`  ${index + 1}. ${choice.label}${choice.key === fallback ? " (default)" : ""}\n`),
+      );
+      for (;;) {
+        const answer = await raw(mark("Choose a number: "));
+        if (!answer) return fallback;
+        const picked = choices[Number(answer) - 1];
+        if (picked) return picked.key;
+      }
+    },
+  };
+}
+
+/** Splits "--a 'b c'" into ["--a", "b c"]. Supports single and double quotes. */
+export function splitArgs(text) {
+  const out = [];
+  let current = "";
+  let quote = null;
+  let started = false;
+  for (const char of text) {
+    if (quote) {
+      if (char === quote) quote = null;
+      else current += char;
+    } else if (char === '"' || char === "'") {
+      quote = char;
+      started = true;
+    } else if (/\s/.test(char)) {
+      if (started) out.push(current);
+      current = "";
+      started = false;
+    } else {
+      current += char;
+      started = true;
+    }
+  }
+  if (quote) throw new NookError(`Unclosed quote in: ${text}`);
+  if (started) out.push(current);
+  return out;
+}
+
+export function joinArgs(args) {
+  return args.map((arg) => (/[\s"']/.test(arg) || arg === "" ? JSON.stringify(arg) : arg)).join(" ");
+}

package/src/shared.mjs

@@ -1,97 +1,97 @@
-import { copyFileSync, mkdirSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { dirname, join, relative, sep } from "node:path";
-import { gitTry, ignoredPaths } from "./git.mjs";
-import { exists } from "./home.mjs";
-
-export const DEFAULT_INCLUDE = [".env*"];
-/** Suffixes that mark a committed template: `.env.example` is the template for `.env`. */
-export const TEMPLATE_SUFFIX = /^(.+)\.(example|sample|template|dist)$/;
-/** Ignored secret files other tools use; init offers them one by one. */
-export const KNOWN_SECRET_FILES = [".dev.vars", "config/master.key", ".envrc"];
-
-/** Patterns from .worktreeinclude (gitignore syntax), or the default `.env*`. */
-export function includePatterns(repo) {
-  const file = join(repo, ".worktreeinclude");
-  if (!exists(file)) return { patterns: DEFAULT_INCLUDE, source: "default" };
-  const patterns = readFileSync(file, "utf8")
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter((line) => line && !line.startsWith("#"));
-  return { patterns, source: ".worktreeinclude" };
-}
-
-/** Files in `repo` that match the patterns and that git ignores. Paths use "/". */
-export function sharedCandidates(repo, patterns) {
-  if (!patterns.length) return [];
-  const args = ["ls-files", "-z", "--others", "--ignored"];
-  for (const pattern of patterns) args.push(`--exclude=${pattern}`);
-  const listed = gitTry(args, { cwd: repo });
-  if (!listed.ok) return [];
-  const files = listed.out.split("\0").filter(Boolean);
-  const ignored = ignoredPaths(repo, files);
-  return files.filter((file) => ignored.has(file)).sort();
-}
-
-/**
- * Committed templates for files git ignores, as { from, to }, in any folder:
- * `.env.example` -> `.env`, `apps/api/.dev.vars.sample` -> `apps/api/.dev.vars`.
- * A template whose target git does not ignore is a normal file and is left out.
- */
-export function templateFiles(repo) {
-  const listed = gitTry(["ls-files", "-z"], { cwd: repo });
-  if (!listed.ok) return [];
-  const pairs = [];
-  for (const from of listed.out.split("\0").filter(Boolean)) {
-    const match = TEMPLATE_SUFFIX.exec(from);
-    // A library's own template in a committed vendor folder (showdoc's guzzle phpunit.xml.dist) is not the project's.
-    if (match && !match[1].endsWith("/") && !/(^|\/)(vendor|node_modules)\//.test(from)) pairs.push({ from, to: match[1] });
-  }
-  const ignored = ignoredPaths(repo, pairs.map((pair) => pair.to));
-  return pairs.filter((pair) => ignored.has(pair.to)).sort((a, b) => a.to.localeCompare(b.to));
-}
-
-export function knownSecretFiles(repo, already) {
-  const present = KNOWN_SECRET_FILES.filter((file) => exists(join(repo, file)) && !already.includes(file));
-  const ignored = ignoredPaths(repo, present);
-  return present.filter((file) => ignored.has(file));
-}
-
-/** Every file below `dir`, relative, with "/" separators. */
-export function listFiles(dir) {
-  if (!exists(dir)) return [];
-  const out = [];
-  const walk = (current) => {
-    for (const entry of readdirSync(current, { withFileTypes: true })) {
-      const full = join(current, entry.name);
-      if (entry.isDirectory()) walk(full);
-      else if (entry.isFile() || statSync(full).isFile()) out.push(relative(dir, full).split(sep).join("/"));
-    }
-  };
-  walk(dir);
-  return out.sort();
-}
-
-export function copyFile(from, to) {
-  mkdirSync(dirname(to), { recursive: true });
-  copyFileSync(from, to);
-}
-
-/**
- * Copies the shared folder into a new workspace. Only files git ignores in the
- * workspace are copied, so a shared file never overwrites a tracked one.
- */
-export function copyShared(sharedDir, workspace) {
-  const files = listFiles(sharedDir);
-  const ignored = ignoredPaths(workspace, files);
-  const copied = [];
-  const skipped = [];
-  for (const file of files) {
-    if (!ignored.has(file)) {
-      skipped.push(file);
-      continue;
-    }
-    copyFile(join(sharedDir, file), join(workspace, file));
-    copied.push(file);
-  }
-  return { copied, skipped };
-}
+import { copyFileSync, mkdirSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, relative, sep } from "node:path";
+import { gitTry, ignoredPaths } from "./git.mjs";
+import { exists } from "./home.mjs";
+
+export const DEFAULT_INCLUDE = [".env*"];
+/** Suffixes that mark a committed template: `.env.example` is the template for `.env`. */
+export const TEMPLATE_SUFFIX = /^(.+)\.(example|sample|template|dist)$/;
+/** Ignored secret files other tools use; init offers them one by one. */
+export const KNOWN_SECRET_FILES = [".dev.vars", "config/master.key", ".envrc"];
+
+/** Patterns from .worktreeinclude (gitignore syntax), or the default `.env*`. */
+export function includePatterns(repo) {
+  const file = join(repo, ".worktreeinclude");
+  if (!exists(file)) return { patterns: DEFAULT_INCLUDE, source: "default" };
+  const patterns = readFileSync(file, "utf8")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter((line) => line && !line.startsWith("#"));
+  return { patterns, source: ".worktreeinclude" };
+}
+
+/** Files in `repo` that match the patterns and that git ignores. Paths use "/". */
+export function sharedCandidates(repo, patterns) {
+  if (!patterns.length) return [];
+  const args = ["ls-files", "-z", "--others", "--ignored"];
+  for (const pattern of patterns) args.push(`--exclude=${pattern}`);
+  const listed = gitTry(args, { cwd: repo });
+  if (!listed.ok) return [];
+  const files = listed.out.split("\0").filter(Boolean);
+  const ignored = ignoredPaths(repo, files);
+  return files.filter((file) => ignored.has(file)).sort();
+}
+
+/**
+ * Committed templates for files git ignores, as { from, to }, in any folder:
+ * `.env.example` -> `.env`, `apps/api/.dev.vars.sample` -> `apps/api/.dev.vars`.
+ * A template whose target git does not ignore is a normal file and is left out.
+ */
+export function templateFiles(repo) {
+  const listed = gitTry(["ls-files", "-z"], { cwd: repo });
+  if (!listed.ok) return [];
+  const pairs = [];
+  for (const from of listed.out.split("\0").filter(Boolean)) {
+    const match = TEMPLATE_SUFFIX.exec(from);
+    // A library's own template in a committed vendor folder (showdoc's guzzle phpunit.xml.dist) is not the project's.
+    if (match && !match[1].endsWith("/") && !/(^|\/)(vendor|node_modules)\//.test(from)) pairs.push({ from, to: match[1] });
+  }
+  const ignored = ignoredPaths(repo, pairs.map((pair) => pair.to));
+  return pairs.filter((pair) => ignored.has(pair.to)).sort((a, b) => a.to.localeCompare(b.to));
+}
+
+export function knownSecretFiles(repo, already) {
+  const present = KNOWN_SECRET_FILES.filter((file) => exists(join(repo, file)) && !already.includes(file));
+  const ignored = ignoredPaths(repo, present);
+  return present.filter((file) => ignored.has(file));
+}
+
+/** Every file below `dir`, relative, with "/" separators. */
+export function listFiles(dir) {
+  if (!exists(dir)) return [];
+  const out = [];
+  const walk = (current) => {
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      const full = join(current, entry.name);
+      if (entry.isDirectory()) walk(full);
+      else if (entry.isFile() || statSync(full).isFile()) out.push(relative(dir, full).split(sep).join("/"));
+    }
+  };
+  walk(dir);
+  return out.sort();
+}
+
+export function copyFile(from, to) {
+  mkdirSync(dirname(to), { recursive: true });
+  copyFileSync(from, to);
+}
+
+/**
+ * Copies the shared folder into a new workspace. Only files git ignores in the
+ * workspace are copied, so a shared file never overwrites a tracked one.
+ */
+export function copyShared(sharedDir, workspace) {
+  const files = listFiles(sharedDir);
+  const ignored = ignoredPaths(workspace, files);
+  const copied = [];
+  const skipped = [];
+  for (const file of files) {
+    if (!ignored.has(file)) {
+      skipped.push(file);
+      continue;
+    }
+    copyFile(join(sharedDir, file), join(workspace, file));
+    copied.push(file);
+  }
+  return { copied, skipped };
+}

package/src/status.mjs

@@ -1,30 +1,30 @@
-import { exists } from "./home.mjs";
-import { gitTry, refExists } from "./git.mjs";
-
-/** Uncommitted changes, or null when the folder is missing or not readable. */
-export function changeCount(path) {
-  if (!exists(path)) return null;
-  const status = gitTry(["status", "--porcelain", "--untracked-files=normal"], { cwd: path });
-  if (!status.ok) return null;
-  return status.out ? status.out.split(/\r?\n/).length : 0;
-}
-
-/** Commits the branch has that `base` lacks (ahead), and the reverse (behind). */
-export function aheadBehind(repo, branch, base) {
-  if (!refExists(repo, `refs/heads/${branch}`)) return null;
-  const result = gitTry(["rev-list", "--left-right", "--count", `${base}...refs/heads/${branch}`], { cwd: repo });
-  if (!result.ok) return null;
-  const [behind, ahead] = result.out.split(/\s+/).map(Number);
-  return { ahead, behind };
-}
-
-export function branchTip(repo, branch) {
-  const result = gitTry(["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`], { cwd: repo });
-  return result.ok ? result.out : null;
-}
-
-/** True when `commit` is `other` or one of its ancestors (false when either is unknown). */
-export function contains(repo, other, commit) {
-  if (commit === other) return true;
-  return gitTry(["merge-base", "--is-ancestor", commit, other], { cwd: repo }).ok;
-}
+import { exists } from "./home.mjs";
+import { gitTry, refExists } from "./git.mjs";
+
+/** Uncommitted changes, or null when the folder is missing or not readable. */
+export function changeCount(path) {
+  if (!exists(path)) return null;
+  const status = gitTry(["status", "--porcelain", "--untracked-files=normal"], { cwd: path });
+  if (!status.ok) return null;
+  return status.out ? status.out.split(/\r?\n/).length : 0;
+}
+
+/** Commits the branch has that `base` lacks (ahead), and the reverse (behind). */
+export function aheadBehind(repo, branch, base) {
+  if (!refExists(repo, `refs/heads/${branch}`)) return null;
+  const result = gitTry(["rev-list", "--left-right", "--count", `${base}...refs/heads/${branch}`], { cwd: repo });
+  if (!result.ok) return null;
+  const [behind, ahead] = result.out.split(/\s+/).map(Number);
+  return { ahead, behind };
+}
+
+export function branchTip(repo, branch) {
+  const result = gitTry(["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`], { cwd: repo });
+  return result.ok ? result.out : null;
+}
+
+/** True when `commit` is `other` or one of its ancestors (false when either is unknown). */
+export function contains(repo, other, commit) {
+  if (commit === other) return true;
+  return gitTry(["merge-base", "--is-ancestor", commit, other], { cwd: repo }).ok;
+}

package/src/tools.mjs

@@ -1,23 +1,23 @@
-import spawn from "cross-spawn";
-import { which } from "./agents.mjs";
-
-function run(command, args) {
-  const result = spawn.sync(command, args, { encoding: "utf8", timeout: 15000, windowsHide: true });
-  return { ok: !result.error && result.status === 0, out: `${result.stdout ?? ""}${result.stderr ?? ""}`.trim() };
-}
-
-/** gh and docker are optional helpers; this only reports their state. */
-export function toolStatus(env = process.env) {
-  const status = {};
-  const gh = which("gh", env);
-  status.gh = !gh ? "not installed" : run(gh, ["auth", "status"]).ok ? "logged in" : "not logged in";
-  const docker = which("docker", env);
-  status.docker = !docker ? "not installed" : run(docker, ["info", "--format", "{{.ServerVersion}}"]).ok ? "running" : "not running";
-  return status;
-}
-
-export function gitVersion() {
-  const result = run("git", ["--version"]);
-  const match = /(\d+)\.(\d+)/.exec(result.out);
-  return result.ok && match ? { text: result.out, major: Number(match[1]), minor: Number(match[2]) } : null;
-}
+import spawn from "cross-spawn";
+import { which } from "./agents.mjs";
+
+function run(command, args) {
+  const result = spawn.sync(command, args, { encoding: "utf8", timeout: 15000, windowsHide: true });
+  return { ok: !result.error && result.status === 0, out: `${result.stdout ?? ""}${result.stderr ?? ""}`.trim() };
+}
+
+/** gh and docker are optional helpers; this only reports their state. */
+export function toolStatus(env = process.env) {
+  const status = {};
+  const gh = which("gh", env);
+  status.gh = !gh ? "not installed" : run(gh, ["auth", "status"]).ok ? "logged in" : "not logged in";
+  const docker = which("docker", env);
+  status.docker = !docker ? "not installed" : run(docker, ["info", "--format", "{{.ServerVersion}}"]).ok ? "running" : "not running";
+  return status;
+}
+
+export function gitVersion() {
+  const result = run("git", ["--version"]);
+  const match = /(\d+)\.(\d+)/.exec(result.out);
+  return result.ok && match ? { text: result.out, major: Number(match[1]), minor: Number(match[2]) } : null;
+}

package/src/ui.mjs

@@ -1,60 +1,60 @@
-/**
- * Line prefixes in the style of worktrunk: ◎ a step that runs now, ✓ done,
- * ▲ needs attention, ✗ failed, ○ information, ┃ an item under the line above,
- * ? a question.
- * Colors only on a terminal, and never when NO_COLOR is set (no-color.org).
- */
-const UNICODE = { step: "◎", ok: "✓", warn: "▲", fail: "✗", info: "○", item: "┃", ask: "?" };
-// Older Windows consoles show ✓ and ✗ as "?"; √ and × exist in their code pages
-// (the same fallbacks as the figures package).
-const FALLBACK = { ...UNICODE, ok: "√", fail: "×" };
-const COLORS = { step: 36, ok: 32, warn: 33, fail: 31, info: 2, item: 2, ask: 35 };
-
-/** The checks of the is-unicode-supported package, plus Warp. */
-export function unicodeSupported(env = process.env, platform = process.platform) {
-  if (platform !== "win32") return env.TERM !== "linux";
-  return (
-    Boolean(env.WT_SESSION) ||
-    Boolean(env.TERMINUS_SUBLIME) ||
-    env.ConEmuTask === "{cmd::Cmder}" ||
-    ["Terminus-Sublime", "vscode", "WarpTerminal"].includes(env.TERM_PROGRAM) ||
-    ["xterm-256color", "alacritty", "rxvt-unicode", "rxvt-unicode-256color"].includes(env.TERM) ||
-    env.TERMINAL_EMULATOR === "JetBrains-JediTerm"
-  );
-}
-
-const SYMBOLS = unicodeSupported() ? UNICODE : FALLBACK;
-
-export function useColor(stream, env = process.env) {
-  return Boolean(stream?.isTTY) && !("NO_COLOR" in env) && env.TERM !== "dumb";
-}
-
-export function line(kind, text, color = false) {
-  const symbol = SYMBOLS[kind];
-  const mark = color ? `\x1b[${COLORS[kind]}m${symbol}\x1b[0m` : symbol;
-  return kind === "item" ? `   ${mark} ${text}` : `${mark} ${text}`;
-}
-
-/**
- * Indents another program's output by two columns, under the text of the line
- * above it. Docker Compose starts its lines with one space; that space goes.
- * Returns a function that takes chunks and returns them indented.
- */
-export function indenter(width = 2) {
-  const pad = " ".repeat(width);
-  let state = "start"; // start of a line, after one leading space, or inside it
-  return (chunk) => {
-    let out = "";
-    for (const char of String(chunk)) {
-      const newline = char === "\n" || char === "\r";
-      if (state === "mid") out += char;
-      else if (newline) out += char;
-      else if (state === "start" && char === " ") {
-        state = "space";
-        continue;
-      } else out += pad + (state === "space" && char === " " ? "  " : char);
-      state = newline ? "start" : "mid";
-    }
-    return out;
-  };
-}
+/**
+ * Line prefixes in the style of worktrunk: ◎ a step that runs now, ✓ done,
+ * ▲ needs attention, ✗ failed, ○ information, ┃ an item under the line above,
+ * ? a question.
+ * Colors only on a terminal, and never when NO_COLOR is set (no-color.org).
+ */
+const UNICODE = { step: "◎", ok: "✓", warn: "▲", fail: "✗", info: "○", item: "┃", ask: "?" };
+// Older Windows consoles show ✓ and ✗ as "?"; √ and × exist in their code pages
+// (the same fallbacks as the figures package).
+const FALLBACK = { ...UNICODE, ok: "√", fail: "×" };
+const COLORS = { step: 36, ok: 32, warn: 33, fail: 31, info: 2, item: 2, ask: 35 };
+
+/** The checks of the is-unicode-supported package, plus Warp. */
+export function unicodeSupported(env = process.env, platform = process.platform) {
+  if (platform !== "win32") return env.TERM !== "linux";
+  return (
+    Boolean(env.WT_SESSION) ||
+    Boolean(env.TERMINUS_SUBLIME) ||
+    env.ConEmuTask === "{cmd::Cmder}" ||
+    ["Terminus-Sublime", "vscode", "WarpTerminal"].includes(env.TERM_PROGRAM) ||
+    ["xterm-256color", "alacritty", "rxvt-unicode", "rxvt-unicode-256color"].includes(env.TERM) ||
+    env.TERMINAL_EMULATOR === "JetBrains-JediTerm"
+  );
+}
+
+const SYMBOLS = unicodeSupported() ? UNICODE : FALLBACK;
+
+export function useColor(stream, env = process.env) {
+  return Boolean(stream?.isTTY) && !("NO_COLOR" in env) && env.TERM !== "dumb";
+}
+
+export function line(kind, text, color = false) {
+  const symbol = SYMBOLS[kind];
+  const mark = color ? `\x1b[${COLORS[kind]}m${symbol}\x1b[0m` : symbol;
+  return kind === "item" ? `   ${mark} ${text}` : `${mark} ${text}`;
+}
+
+/**
+ * Indents another program's output by two columns, under the text of the line
+ * above it. Docker Compose starts its lines with one space; that space goes.
+ * Returns a function that takes chunks and returns them indented.
+ */
+export function indenter(width = 2) {
+  const pad = " ".repeat(width);
+  let state = "start"; // start of a line, after one leading space, or inside it
+  return (chunk) => {
+    let out = "";
+    for (const char of String(chunk)) {
+      const newline = char === "\n" || char === "\r";
+      if (state === "mid") out += char;
+      else if (newline) out += char;
+      else if (state === "start" && char === " ") {
+        state = "space";
+        continue;
+      } else out += pad + (state === "space" && char === " " ? "  " : char);
+      state = newline ? "start" : "mid";
+    }
+    return out;
+  };
+}