wukong-progress 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [杨琼]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# wukong-progress
+
+🎨 A Node.js / ESM style CLI progress bar library that supports:
+
+- Single / multiple progress bars
+- Group / Stage / prefix
+- Concurrent task API (wrap async functions)
+- Automatic terminal width adaptation
+- Optional colored output (chalk, auto fallback)
+- JSON fallback (for non-TTY environments)
+- Full ESM + Node.js 18+ compatible
+- Works on Windows / Linux / macOS
+
+---
+## English | [简体中文](./README.zh-CN.md)
+---
+## 🚀 Installation
+
+```bash
+yarn add wukong-progress chalk
+# or
+npm install wukong-progress chalk
+```
+
+---
+
+## ⚡️ Basic Usage
+
+### Single Progress Bar
+
+```js
+import chalk from "chalk";
+import { createMultiBar } from "wukong-progress";
+
+const mb = createMultiBar();
+const bar = mb.create(100, {
+  prefix: chalk.cyan("Build"),
+  format: "Build [:bar] :percent :current/:total",
+});
+
+async function run() {
+  for (let i = 0; i <= 100; i++) {
+    await new Promise((r) => setTimeout(r, 20));
+    bar.tick();
+  }
+  mb.stop();
+  console.log(chalk.green("\nDone!\n"));
+}
+
+run();
+```
+
+### Multiple Progress Bars
+
+```js
+import chalk from "chalk";
+import { createMultiBar } from "wukong-progress";
+
+const mb = createMultiBar();
+const build = mb.create(100, {
+  prefix: chalk.blue("Build"),
+  format: "Build [:bar] :percent",
+});
+const test = mb.create(50, {
+  prefix: chalk.magenta("Test"),
+  format: "Test  [:bar] :percent",
+});
+
+async function run() {
+  for (let i = 0; i <= 100; i++) {
+    await new Promise((r) => setTimeout(r, 15));
+    if (i <= 50) test.tick();
+    build.tick();
+  }
+  mb.stop();
+  console.log(chalk.green("\nAll tasks done!\n"));
+}
+
+run();
+```
+
+---
+
+### Group / Stage / prefix
+
+```js
+import chalk from "chalk";
+import { createMultiBar } from "wukong-progress";
+
+const mb = createMultiBar();
+const buildGroup = mb.group("Build Group");
+buildGroup.create(50, {
+  prefix: chalk.blue("Compile"),
+  format: "Compile [:bar] :percent",
+});
+buildGroup.create(30, {
+  prefix: chalk.cyan("Bundle"),
+  format: "Bundle  [:bar] :percent",
+});
+
+const testGroup = mb.group("Test Group");
+testGroup.create(20, {
+  prefix: chalk.magenta("Unit"),
+  format: "Unit [:bar] :percent",
+});
+testGroup.create(10, {
+  prefix: chalk.yellow("E2E"),
+  format: "E2E  [:bar] :percent",
+});
+
+async function run() {
+  const allTasks = [...buildGroup.bars, ...testGroup.bars];
+
+  for (let i = 0; i < 50; i++) {
+    await new Promise((r) => setTimeout(r, 20));
+    allTasks.forEach((bar) => {
+      if (!bar.state.complete) bar.tick();
+    });
+  }
+
+  mb.stop();
+  console.log(chalk.green("\nGroups completed!\n"));
+}
+
+run();
+```
+
+---
+
+### JSON Fallback (non-TTY / CI)
+
+```js
+import { Writable } from "node:stream";
+import { createMultiBar } from "wukong-progress";
+
+let out = "";
+const stream = new Writable({
+  write(chunk, _, cb) {
+    out += chunk;
+    cb();
+  },
+});
+
+const mb = createMultiBar({ stream, json: true });
+const bar = mb.create(5, { prefix: "JSON" });
+
+async function run() {
+  for (let i = 0; i <= 5; i++) {
+    await new Promise((r) => setTimeout(r, 20));
+    bar.tick();
+  }
+  mb.stop();
+
+  console.log("JSON fallback output:");
+  console.log(out);
+}
+
+run();
+```
+
+---
+
+## 🎨 Colored Output (optional)
+
+- Use `chalk` to color prefixes and bar output
+- Auto fallback to plain text if chalk is not installed
+- Example:
+
+```js
+prefix: chalk.green('Build'),
+format: chalk.green('Build [:bar] :percent')
+```
+
+---
+
+## 📂 Examples Folder
+
+```bash
+node examples/index.mjs
+```
+
+- Interactive selection of examples:
+
+  - Single Bar
+  - Multi Bar
+  - Group / Stage
+  - JSON Fallback
+
+- Fully compatible with Windows / Linux / macOS
+- All examples use async/await + chalk colored output
+
+---
+
+## ⚡️ Testing
+
+```bash
+# Node.js native test
+yarn test:node
+
+# Vitest snapshot test
+yarn test:vitest
+
+# Run all tests
+yarn test
+```
+
+- ✅ Node:test for progress logic
+- ✅ Vitest snapshot for rendering stability
+- ✅ Supports mock TTY / ANSI strip / JSON fallback
+
+---
+
+## 💻 Use Cases
+
+- CLI tools
+- Automation scripts
+- GitHub Actions / CI
+- Concurrent task visualization
+- Progress visualization + JSON logging for analytics

package/README.zh-CN.md

@@ -0,0 +1,217 @@
+
+# wukong-progress
+
+🎨 Node.js / ESM 风格的 CLI 进度条库，支持：
+
+- 单条 / 多条进度条
+- Group / Stage / prefix
+- 并发任务 API（wrap async fn）
+- 自动适配终端宽度
+- 彩色渲染（chalk，可选，自动降级）
+- JSON fallback（非 TTY）
+- 完全 ESM + Node.js 18+ 兼容
+- 可在 Windows / Linux / macOS 使用
+  
+---
+## 中文 | [English](./README.md)
+---
+
+## 🚀 安装
+
+```bash
+yarn add wukong-progress chalk
+# or
+npm install wukong-progress chalk
+```
+
+---
+
+## ⚡️ 基本用法
+
+### 单条进度条
+
+```js
+import chalk from 'chalk'
+import { createMultiBar } from 'wukong-progress'
+
+const mb = createMultiBar()
+const bar = mb.create(100, { prefix: chalk.cyan('Build'), format: 'Build [:bar] :percent :current/:total' })
+
+async function run() {
+  for (let i = 0; i <= 100; i++) {
+    await new Promise(r => setTimeout(r, 20))
+    bar.tick()
+  }
+  mb.stop()
+  console.log(chalk.green('\nDone!\n'))
+}
+
+run()
+```
+
+### 多条进度条
+
+```js
+import chalk from 'chalk'
+import { createMultiBar } from 'wukong-progress'
+
+const mb = createMultiBar()
+const build = mb.create(100, { prefix: chalk.blue('Build'), format: 'Build [:bar] :percent' })
+const test  = mb.create(50,  { prefix: chalk.magenta('Test'), format: 'Test  [:bar] :percent' })
+
+async function run() {
+  for (let i = 0; i <= 100; i++) {
+    await new Promise(r => setTimeout(r, 15))
+    if (i <= 50) test.tick()
+    build.tick()
+  }
+  mb.stop()
+  console.log(chalk.green('\nAll tasks done!\n'))
+}
+
+run()
+```
+
+---
+
+### Group / Stage / prefix
+
+```js
+import chalk from 'chalk'
+import { createMultiBar } from 'wukong-progress'
+
+const mb = createMultiBar()
+const buildGroup = mb.group('Build Group')
+buildGroup.create(50, { prefix: chalk.blue('Compile'), format: 'Compile [:bar] :percent' })
+buildGroup.create(30, { prefix: chalk.cyan('Bundle'),  format: 'Bundle  [:bar] :percent' })
+
+const testGroup = mb.group('Test Group')
+testGroup.create(20, { prefix: chalk.magenta('Unit'), format: 'Unit [:bar] :percent' })
+testGroup.create(10, { prefix: chalk.yellow('E2E'),  format: 'E2E  [:bar] :percent' })
+
+async function run() {
+  const allTasks = [...buildGroup.bars, ...testGroup.bars]
+
+  for (let i = 0; i < 50; i++) {
+    await new Promise(r => setTimeout(r, 20))
+    allTasks.forEach(bar => {
+      if (!bar.state.complete) bar.tick()
+    })
+  }
+
+  mb.stop()
+  console.log(chalk.green('\nGroups completed!\n'))
+}
+
+run()
+```
+
+---
+
+### JSON fallback（非 TTY 或 CI）
+
+```js
+import { Writable } from 'node:stream'
+import { createMultiBar } from 'wukong-progress'
+
+let out = ''
+const stream = new Writable({
+  write(chunk, _, cb) {
+    out += chunk
+    cb()
+  }
+})
+
+const mb = createMultiBar({ stream, json: true })
+const bar = mb.create(5, { prefix: 'JSON' })
+
+async function run() {
+  for (let i = 0; i <= 5; i++) {
+    await new Promise(r => setTimeout(r, 20))
+    bar.tick()
+  }
+  mb.stop()
+
+  console.log('JSON fallback output:')
+  console.log(out)
+}
+
+run()
+```
+
+---
+
+## 🎨 彩色渲染（可选）
+
+-   使用 `chalk` 可以给 prefix、bar 和提示上色
+    
+-   不依赖彩色也能降级到普通文本
+    
+-   示例：
+    
+
+```js
+prefix: chalk.green('Build'),
+format: chalk.green('Build [:bar] :percent')
+```
+
+---
+
+## 📂 Examples 文件夹
+
+```bash
+node examples/index.mjs
+```
+
+-   交互式选择运行示例：
+    
+    -   Single Bar
+        
+    -   Multi Bar
+        
+    -   Group / Stage
+        
+    -   JSON Fallback
+        
+-   Windows / Linux / macOS 全平台兼容
+    
+-   所有示例都用 async/await + chalk 彩色渲染
+    
+
+---
+
+## ⚡️ 测试
+
+```bash
+# Node.js 原生测试
+yarn test:node
+
+# Vitest snapshot 测试
+yarn test:vitest
+
+# 全部测试
+yarn test
+```
+
+-   ✅ Node:test 测试进度条逻辑
+    
+-   ✅ Vitest snapshot 测试渲染稳定性
+    
+-   ✅ 支持 mock TTY / ANSI strip / JSON fallback
+    
+
+---
+
+## 💻 适用场景
+
+-   CLI 工具
+    
+-   自动化脚本
+    
+-   GitHub Actions / CI
+    
+-   多任务并发显示
+    
+-   可视化进度 / JSON 输出结合日志分析
+    
+

package/dist/index.mjs

@@ -0,0 +1,159 @@
+// src/color.mjs
+var chalk = null;
+try {
+  const mod = await import("chalk");
+  chalk = mod.default;
+} catch {
+}
+var color = {
+  bar: (s) => chalk ? chalk.cyan(s) : s,
+  dim: (s) => chalk ? chalk.dim(s) : s,
+  percent: (s) => chalk ? chalk.green(s) : s
+};
+
+// src/utils.mjs
+var clamp = (n, min, max) => Math.min(Math.max(n, min), max);
+var formatTime = (sec) => {
+  if (!isFinite(sec)) return "--";
+  if (sec < 60) return `${sec.toFixed(1)}s`;
+  const m = Math.floor(sec / 60);
+  const s = Math.floor(sec % 60);
+  return `${m}m${s}s`;
+};
+var termWidth = (stream) => stream.columns || 80;
+
+// src/bar.mjs
+function createBar(ctx, opts) {
+  const state = {
+    total: opts.total,
+    current: 0,
+    start: Date.now(),
+    format: opts.format,
+    minWidth: opts.minWidth ?? 10,
+    prefix: opts.prefix ?? "",
+    hideOnComplete: opts.hideOnComplete ?? false,
+    complete: false
+  };
+  function update(n) {
+    state.current = clamp(n, 0, state.total);
+    if (state.current >= state.total) {
+      state.complete = true;
+    }
+    ctx.render();
+  }
+  function tick(n = 1) {
+    update(state.current + n);
+  }
+  function render(width) {
+    const elapsed = (Date.now() - state.start) / 1e3;
+    const percent = state.current / state.total;
+    const staticLen = state.format.replace(":bar", "").replace(":percent", "100%").replace(":current", state.total).replace(":total", state.total).replace(":eta", "00s").length;
+    const barWidth = Math.max(
+      state.minWidth,
+      width - staticLen - state.prefix.length - 4
+    );
+    const filled = Math.round(barWidth * percent);
+    const bar = color.bar("\u2588".repeat(filled)) + color.dim("\u2591".repeat(barWidth - filled));
+    const rate = state.current / elapsed;
+    const eta = rate ? (state.total - state.current) / rate : Infinity;
+    return (state.prefix ? `${state.prefix} ` : "") + state.format.replace(":bar", bar).replace(":percent", color.percent(`${Math.round(percent * 100)}%`)).replace(":current", state.current).replace(":total", state.total).replace(":elapsed", formatTime(elapsed)).replace(":eta", formatTime(eta));
+  }
+  return {
+    state,
+    tick,
+    update,
+    render
+  };
+}
+
+// src/group.mjs
+function createGroup(ctx, name) {
+  const bars = [];
+  function create(total, opts = {}) {
+    const bar = ctx._createBar({
+      ...opts,
+      prefix: opts.prefix ?? name,
+      total
+    });
+    bars.push(bar);
+    return bar;
+  }
+  return { create, bars };
+}
+
+// src/json.mjs
+function renderJSON(stream, bars) {
+  const payload = {
+    type: "progress",
+    bars: bars.map((b) => ({
+      name: b.state.prefix,
+      current: b.state.current,
+      total: b.state.total,
+      percent: Math.round(
+        b.state.current / b.state.total * 100
+      ),
+      complete: b.state.complete
+    }))
+  };
+  stream.write(`${JSON.stringify(payload)}
+`);
+}
+
+// src/multibar.mjs
+function createMultiBar({
+  stream = process.stderr,
+  clearOnComplete = false,
+  json = false
+} = {}) {
+  const bars = [];
+  let lines = 0;
+  let active = true;
+  const isJSON = json || !stream.isTTY;
+  let ctx = null;
+  function group(name) {
+    return createGroup(ctx, name);
+  }
+  function render() {
+    if (!active) return;
+    if (isJSON) {
+      renderJSON(stream, bars);
+      return;
+    }
+    if (lines > 0) {
+      stream.write(`\x1B[${lines}A`);
+    }
+    const width = termWidth(stream);
+    const visible = bars.filter(
+      (b) => !(b.state.complete && b.state.hideOnComplete)
+    );
+    const output = visible.map((b) => b.render(width));
+    stream.write(`${output.join("\n")}
+`);
+    lines = output.length;
+  }
+  function stop() {
+    active = false;
+    if (!isJSON && clearOnComplete) {
+      stream.write(`\x1B[${lines}A\x1B[J`);
+    }
+  }
+  function _createBar(opts) {
+    const bar = createBar(ctx, opts);
+    bars.push(bar);
+    render();
+    return bar;
+  }
+  ctx = {
+    render,
+    _createBar
+  };
+  return {
+    create: (total, opts = {}) => _createBar({ ...opts, total }),
+    group,
+    stop
+  };
+}
+export {
+  createMultiBar
+};
+//# sourceMappingURL=index.mjs.map

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "wukong-progress",
+  "version": "0.1.1",
+  "description": "Lightweight ESM CLI progress bar for Node.js with multiple bars, groups, stages and JSON fallback",
+  "keywords": [
+    "cli",
+    "progress",
+    "progress-bar",
+    "esm",
+    "node",
+    "terminal",
+    "multibar",
+    "async",
+    "concurrent",
+    "cli-tool",
+    "json-fallback",
+    "wukong"
+  ],
+  "homepage": "https://tomatobybike.github.io/wukong-progress/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tomatobybike/wukong-progress"
+  },
+  "license": "MIT",
+  "author": "Tom <tomatobybike@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.mjs"
+  },
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "bin": {
+    "wukong-progress": "dist/index.mjs"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "README.zh.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build.js",
+    "check:npm:login": "node scripts/check-npm-login.mjs",
+    "example": "node examples/index.mjs",
+    "format": "prettier --write \"src/**/*.{js,mjs}\"",
+    "lint": "eslint src --ext .js,.mjs src",
+    "lint:fix": "eslint src --ext .js,.mjs --fix",
+    "pack": "npm pack",
+    "prepare": "husky install",
+    "prepublishOnly": "yarn lint && yarn build",
+    "prettierall": "npx prettier --write 'src/**/*.{js,jsx}'",
+    "push:tags": "git push origin main --follow-tags",
+    "prerelease": "yarn lint",
+    "release": "yarn check:npm:login && yarn release:patch && npm publish && yarn push:tags",
+    "release:major": "yarn lint && standard-version --release-as major",
+    "release:minor": "yarn lint && standard-version --release-as minor",
+    "release:patch": "yarn lint && standard-version --release-as patch",
+    "release:rollback": "git reset --hard HEAD~1 && git tag -d $(git tag --points-at HEAD~1)",
+    "report": "wukong-progress report ./profile.json -o my-report.html --open",
+    "sort": "sort-package-json",
+    "test": "npm run test:node && npm run test:vitest",
+    "test:node": "node --test test/node/render.node.test.mjs",
+    "test:vitest": "vitest run"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "lint-staged"
+    }
+  },
+  "lint-staged": {
+    "package.json": [
+      "sort-package-json"
+    ],
+    "src/**/*.js": [
+      "prettier --write",
+      "eslint --fix"
+    ]
+  },
+  "dependencies": {
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@trivago/prettier-plugin-sort-imports": "6.0.0",
+    "eslint": "8.57.1",
+    "eslint-config-airbnb-base": "15.0.0",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-import-resolver-alias": "1.1.2",
+    "eslint-plugin-import": "2.32.0",
+    "eslint-plugin-prettier": "5.5.4",
+    "eslint-plugin-simple-import-sort": "12.1.1",
+    "husky": "9.1.7",
+    "lint-staged": "16.2.7",
+    "prettier": "3.7.4",
+    "prettier-plugin-packagejson": "2.5.20",
+    "sort-package-json": "3.6.0",
+    "standard-version": "9.5.0",
+    "strip-ansi": "^7.1.2",
+    "vitest": "^1.3.0"
+  },
+  "packageManager": "yarn@1.22.22",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/bar.mjs

@@ -0,0 +1,67 @@
+import { color } from './color.mjs'
+import { clamp, formatTime } from './utils.mjs'
+
+export function createBar(ctx, opts) {
+  const state = {
+    total: opts.total,
+    current: 0,
+    start: Date.now(),
+    format: opts.format,
+    minWidth: opts.minWidth ?? 10,
+    prefix: opts.prefix ?? '',
+    hideOnComplete: opts.hideOnComplete ?? false,
+    complete: false
+  }
+  function update(n) {
+    state.current = clamp(n, 0, state.total)
+    if (state.current >= state.total) {
+      state.complete = true
+    }
+    ctx.render()
+  }
+  function tick(n = 1) {
+    update(state.current + n)
+  }
+
+  function render(width) {
+    const elapsed = (Date.now() - state.start) / 1000
+    const percent = state.current / state.total
+
+    const staticLen = state.format
+      .replace(':bar', '')
+      .replace(':percent', '100%')
+      .replace(':current', state.total)
+      .replace(':total', state.total)
+      .replace(':eta', '00s').length
+
+    const barWidth = Math.max(
+      state.minWidth,
+      width - staticLen - state.prefix.length - 4
+    )
+
+    const filled = Math.round(barWidth * percent)
+    const bar =
+      color.bar('█'.repeat(filled)) + color.dim('░'.repeat(barWidth - filled))
+
+    const rate = state.current / elapsed
+    const eta = rate ? (state.total - state.current) / rate : Infinity
+
+    return (
+      (state.prefix ? `${state.prefix} ` : '') +
+      state.format
+        .replace(':bar', bar)
+        .replace(':percent', color.percent(`${Math.round(percent * 100)}%`))
+        .replace(':current', state.current)
+        .replace(':total', state.total)
+        .replace(':elapsed', formatTime(elapsed))
+        .replace(':eta', formatTime(eta))
+    )
+  }
+
+  return {
+    state,
+    tick,
+    update,
+    render
+  }
+}

package/src/color.mjs

@@ -0,0 +1,12 @@
+let chalk = null
+
+try {
+  const mod = await import('chalk')
+  chalk = mod.default
+} catch { /* empty */ }
+
+export const color = {
+  bar: s => (chalk ? chalk.cyan(s) : s),
+  dim: s => (chalk ? chalk.dim(s) : s),
+  percent: s => (chalk ? chalk.green(s) : s),
+}

package/src/group.mjs

@@ -0,0 +1,15 @@
+export function createGroup(ctx, name) {
+  const bars = []
+
+  function create(total, opts = {}) {
+    const bar = ctx._createBar({
+      ...opts,
+      prefix: opts.prefix ?? name,
+      total,
+    })
+    bars.push(bar)
+    return bar
+  }
+
+  return { create, bars }
+}

package/src/index.mjs

@@ -0,0 +1 @@
+export { createMultiBar } from './multibar.mjs'

package/src/json.mjs

@@ -0,0 +1,16 @@
+export function renderJSON(stream, bars) {
+  const payload = {
+    type: 'progress',
+    bars: bars.map(b => ({
+      name: b.state.prefix,
+      current: b.state.current,
+      total: b.state.total,
+      percent: Math.round(
+        (b.state.current / b.state.total) * 100
+      ),
+      complete: b.state.complete,
+    })),
+  }
+
+  stream.write(`${JSON.stringify(payload)  }\n`)
+}

package/src/multibar.mjs

@@ -0,0 +1,69 @@
+import { createBar } from './bar.mjs'
+import { createGroup } from './group.mjs'
+import { renderJSON } from './json.mjs'
+import { termWidth } from './utils.mjs'
+
+export function createMultiBar({
+  stream = process.stderr,
+  clearOnComplete = false,
+  json = false
+} = {}) {
+  const bars = []
+  let lines = 0
+  let active = true
+
+  const isJSON = json || !stream.isTTY
+
+  let ctx = null
+  function group(name) {
+    return createGroup(ctx, name)
+  }
+
+  function render() {
+    if (!active) return
+
+    if (isJSON) {
+      renderJSON(stream, bars)
+      return
+    }
+
+    if (lines > 0) {
+      stream.write(`\x1b[${lines}A`)
+    }
+
+    const width = termWidth(stream)
+    const visible = bars.filter(
+      (b) => !(b.state.complete && b.state.hideOnComplete)
+    )
+
+    const output = visible.map((b) => b.render(width))
+
+    stream.write(`${output.join('\n')}\n`)
+    lines = output.length
+  }
+
+  function stop() {
+    active = false
+    if (!isJSON && clearOnComplete) {
+      stream.write(`\x1b[${lines}A\x1b[J`)
+    }
+  }
+
+  function _createBar(opts) {
+    const bar = createBar(ctx, opts)
+    bars.push(bar)
+    render()
+    return bar
+  }
+
+  ctx = {
+    render,
+    _createBar
+  }
+
+  return {
+    create: (total, opts = {}) => _createBar({ ...opts, total }),
+    group,
+    stop
+  }
+}

package/src/utils.mjs

@@ -0,0 +1,14 @@
+export const clamp = (n, min, max) =>
+  Math.min(Math.max(n, min), max)
+
+export const formatTime = sec => {
+  // eslint-disable-next-line no-restricted-globals
+  if (!isFinite(sec)) return '--'
+  if (sec < 60) return `${sec.toFixed(1)}s`
+  const m = Math.floor(sec / 60)
+  const s = Math.floor(sec % 60)
+  return `${m}m${s}s`
+}
+
+export const termWidth = stream =>
+  stream.columns || 80