@youngwat/git-file-manager 0.0.0-stage → 1.0.0

package/src/log.js

@@ -0,0 +1,79 @@
+'use strict';
+
+/**
+ * 终端输出与错误类型。零依赖：非 TTY 或设置了 NO_COLOR 时自动关色。
+ */
+
+const useColor = !process.env.NO_COLOR
+  && (Boolean(process.stdout.isTTY) || process.env.GFM_FORCE_COLOR === '1');
+
+function paint(code, text) {
+  return useColor ? `\u001b[${code}m${text}\u001b[0m` : String(text);
+}
+
+const C = {
+  bold: (t) => paint('1', t),
+  dim: (t) => paint('2', t),
+  red: (t) => paint('31', t),
+  green: (t) => paint('32', t),
+  yellow: (t) => paint('33', t),
+  cyan: (t) => paint('36', t),
+};
+
+/** 可预期的失败：只打印 message（+ hint），不打堆栈 */
+class CliError extends Error {
+  constructor(message, hint) {
+    super(message);
+    this.name = 'CliError';
+    this.hint = hint;
+  }
+}
+
+let verbose = false;
+
+/** 粗略显示宽度：CJK 全角字符按 2 列算 */
+function dispWidth(str) {
+  let w = 0;
+  for (const ch of String(str)) {
+    const cp = ch.codePointAt(0);
+    w += (cp >= 0x1100 && (cp <= 0x115f
+      || (cp >= 0x2e80 && cp <= 0xa4cf)
+      || (cp >= 0xac00 && cp <= 0xd7a3)
+      || (cp >= 0xf900 && cp <= 0xfaff)
+      || (cp >= 0xfe30 && cp <= 0xfe6f)
+      || (cp >= 0xff00 && cp <= 0xff60)
+      || (cp >= 0xffe0 && cp <= 0xffe6))) ? 2 : 1;
+  }
+  return w;
+}
+
+function pad(str, width) {
+  const gap = width - dispWidth(str);
+  return gap > 0 ? str + ' '.repeat(gap) : String(str);
+}
+
+/** 简易表格：返回多行字符串 */
+function renderTable(headers, rows) {
+  const all = [headers, ...rows];
+  const widths = headers.map((_, i) => Math.max(...all.map((r) => dispWidth(r[i] == null ? '' : r[i]))));
+  return all
+    .map((r) => '  ' + r.map((cell, i) => pad(cell == null ? '' : String(cell), widths[i])).join('  ').trimEnd())
+    .join('\n');
+}
+
+module.exports = {
+  C,
+  CliError,
+  renderTable,
+  dispWidth,
+  setVerbose: (v) => { verbose = Boolean(v); },
+  isVerbose: () => verbose,
+  step: (title) => console.log(`\n${C.bold('>> ' + title)}`),
+  ok: (msg) => console.log(`  ${C.green('[ok]')} ${msg}`),
+  warn: (msg) => console.log(`  ${C.yellow('[warn]')} ${msg}`),
+  bad: (msg) => console.log(`  ${C.red('[fail]')} ${msg}`),
+  info: (msg) => console.log(`  ${msg}`),
+  plain: (msg) => console.log(msg),
+  debug: (msg) => { if (verbose) console.log(C.dim(`  . ${msg}`)); },
+  title: (msg) => console.log(C.bold(msg)),
+};