silvery 0.17.0 → 0.17.2

package/dist/progress-bar-COPSBlT9.mjs

@@ -0,0 +1,155 @@
+import { a as chalk } from "./spinner-DSByknyx.mjs";
+import { d as getTerminalWidth, f as isTTY, i as CURSOR_HIDE, m as write, s as CURSOR_SHOW } from "./ansi-CXLE_pt1.mjs";
+import { i as formatETA, n as calculateETA } from "./eta-DLiVPaSD.mjs";
+//#region packages/ag-react/src/ui/cli/progress-bar.ts
+/**
+* CLI ProgressBar - Determinate progress indicator with ETA
+*/
+/** Default format string */
+const DEFAULT_FORMAT = ":bar :percent | :current/:total | ETA: :eta";
+/**
+* ProgressBar class for CLI progress indication
+*
+* @example
+* ```ts
+* const bar = new ProgressBar({ total: 100 });
+* bar.start();
+* for (let i = 0; i <= 100; i++) {
+*   await doWork();
+*   bar.update(i);
+* }
+* bar.stop();
+* ```
+*/
+var ProgressBar = class {
+	total;
+	format;
+	width;
+	complete;
+	incomplete;
+	stream;
+	hideCursor;
+	phases;
+	current = 0;
+	phase = null;
+	startTime = null;
+	isActive = false;
+	etaBuffer = [];
+	constructor(options = {}) {
+		this.total = options.total ?? 100;
+		this.format = options.format ?? DEFAULT_FORMAT;
+		this.width = options.width ?? 40;
+		this.complete = options.complete ?? "█";
+		this.incomplete = options.incomplete ?? "░";
+		this.stream = options.stream ?? process.stdout;
+		this.hideCursor = options.hideCursor ?? true;
+		this.phases = options.phases ?? {};
+	}
+	/**
+	* Start the progress bar
+	*/
+	start(initialValue = 0, initialTotal) {
+		if (initialTotal !== void 0) this.total = initialTotal;
+		this.current = initialValue;
+		this.startTime = Date.now();
+		this.isActive = true;
+		this.etaBuffer = [{
+			time: this.startTime,
+			value: initialValue
+		}];
+		if (this.hideCursor && isTTY(this.stream)) write(CURSOR_HIDE, this.stream);
+		this.render();
+		return this;
+	}
+	/**
+	* Update progress value
+	*/
+	update(value, tokens) {
+		this.current = Math.min(value, this.total);
+		const now = Date.now();
+		this.etaBuffer.push({
+			time: now,
+			value: this.current
+		});
+		if (this.etaBuffer.length > 10) this.etaBuffer.shift();
+		if (this.isActive) this.render(tokens);
+		return this;
+	}
+	/**
+	* Increment progress by amount (default: 1)
+	*/
+	increment(amount = 1, tokens) {
+		return this.update(this.current + amount, tokens);
+	}
+	/**
+	* Set the current phase (for multi-phase progress)
+	*/
+	setPhase(phaseName, options) {
+		this.phase = phaseName;
+		if (options?.total !== void 0) this.total = options.total;
+		if (options?.current !== void 0) {
+			this.current = options.current;
+			this.etaBuffer = [{
+				time: Date.now(),
+				value: this.current
+			}];
+		}
+		if (this.isActive) this.render();
+		return this;
+	}
+	/**
+	* Stop the progress bar
+	*/
+	stop(clear = false) {
+		if (!this.isActive) return this;
+		this.isActive = false;
+		if (clear && isTTY(this.stream)) write(`
+		else write("\n", this.stream);
+		if (this.hideCursor && isTTY(this.stream)) write(CURSOR_SHOW, this.stream);
+		return this;
+	}
+	/** Get ETA in seconds using smoothed rate */
+	getETASeconds() {
+		return calculateETA(this.etaBuffer, this.current, this.total);
+	}
+	/**
+	* Render the progress bar
+	*/
+	render(tokens) {
+		const percent = this.total > 0 ? this.current / this.total : 0;
+		const eta = this.getETASeconds();
+		const completeLength = Math.round(this.width * percent);
+		const incompleteLength = this.width - completeLength;
+		const bar = this.complete.repeat(completeLength) + this.incomplete.repeat(incompleteLength);
+		const phaseDisplay = this.phase ? this.phases[this.phase] ?? this.phase : "";
+		const elapsed = this.startTime ? (Date.now() - this.startTime) / 1e3 : 0;
+		const rate = elapsed > 0 ? this.current / elapsed : 0;
+		let output = this.format.replace(":bar", chalk.cyan(bar)).replace(":percent", `${Math.round(percent * 100)}%`.padStart(4)).replace(":current", String(this.current)).replace(":total", String(this.total)).replace(":eta", formatETA(eta)).replace(":elapsed", formatETA(elapsed)).replace(":rate", rate.toFixed(1)).replace(":phase", chalk.dim(phaseDisplay));
+		if (tokens) for (const [key, value] of Object.entries(tokens)) output = output.replace(`:${key}`, String(value));
+		const termWidth = getTerminalWidth(this.stream);
+		if (output.length > termWidth) output = output.slice(0, termWidth - 1);
+		if (isTTY(this.stream)) write(`
+	}
+	/**
+	* Get current progress ratio (0-1)
+	*/
+	get ratio() {
+		return this.total > 0 ? this.current / this.total : 0;
+	}
+	/**
+	* Get current progress percentage (0-100)
+	*/
+	get percentage() {
+		return Math.round(this.ratio * 100);
+	}
+	/**
+	* Dispose the progress bar (calls stop)
+	*/
+	[Symbol.dispose]() {
+		this.stop();
+	}
+};
+//#endregion
+export { ProgressBar as t };
+
+//# sourceMappingURL=progress-bar-COPSBlT9.mjs.map

package/dist/progress-bar-COPSBlT9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-bar-COPSBlT9.mjs","names":[],"sources":["../packages/ag-react/src/ui/cli/progress-bar.ts"],"sourcesContent":["/**\n * CLI ProgressBar - Determinate progress indicator with ETA\n */\n\nimport chalk from \"@silvery/ink/chalk\"\nimport type { ProgressBarOptions } from \"../types.js\"\nimport { CURSOR_HIDE, CURSOR_SHOW, CURSOR_TO_START, CLEAR_LINE_END, write, isTTY, getTerminalWidth } from \"./ansi\"\nimport { calculateETA, formatETA, DEFAULT_ETA_BUFFER_SIZE, type ETASample } from \"../utils/eta\"\n\n/** Default format string */\nconst DEFAULT_FORMAT = \":bar :percent | :current/:total | ETA: :eta\"\n\n/**\n * ProgressBar class for CLI progress indication\n *\n * @example\n * ```ts\n * const bar = new ProgressBar({ total: 100 });\n * bar.start();\n * for (let i = 0; i <= 100; i++) {\n *   await doWork();\n *   bar.update(i);\n * }\n * bar.stop();\n * ```\n */\nexport class ProgressBar {\n  private total: number\n  private format: string\n  private width: number\n  private complete: string\n  private incomplete: string\n  private stream: NodeJS.WriteStream\n  private hideCursor: boolean\n  private phases: Record<string, string>\n\n  private current = 0\n  private phase: string | null = null\n  private startTime: number | null = null\n  private isActive = false\n\n  // ETA smoothing - track last N update times\n  private etaBuffer: ETASample[] = []\n\n  constructor(options: ProgressBarOptions = {}) {\n    this.total = options.total ?? 100\n    this.format = options.format ?? DEFAULT_FORMAT\n    this.width = options.width ?? 40\n    this.complete = options.complete ?? \"█\"\n    this.incomplete = options.incomplete ?? \"░\"\n    this.stream = options.stream ?? process.stdout\n    this.hideCursor = options.hideCursor ?? true\n    this.phases = options.phases ?? {}\n  }\n\n  /**\n   * Start the progress bar\n   */\n  start(initialValue = 0, initialTotal?: number): this {\n    if (initialTotal !== undefined) {\n      this.total = initialTotal\n    }\n\n    this.current = initialValue\n    this.startTime = Date.now()\n    this.isActive = true\n    this.etaBuffer = [{ time: this.startTime, value: initialValue }]\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_HIDE, this.stream)\n    }\n\n    this.render()\n    return this\n  }\n\n  /**\n   * Update progress value\n   */\n  update(value: number, tokens?: Record<string, string | number>): this {\n    this.current = Math.min(value, this.total)\n\n    // Update ETA buffer\n    const now = Date.now()\n    this.etaBuffer.push({ time: now, value: this.current })\n    if (this.etaBuffer.length > DEFAULT_ETA_BUFFER_SIZE) {\n      this.etaBuffer.shift()\n    }\n\n    if (this.isActive) {\n      this.render(tokens)\n    }\n\n    return this\n  }\n\n  /**\n   * Increment progress by amount (default: 1)\n   */\n  increment(amount = 1, tokens?: Record<string, string | number>): this {\n    return this.update(this.current + amount, tokens)\n  }\n\n  /**\n   * Set the current phase (for multi-phase progress)\n   */\n  setPhase(phaseName: string, options?: { current?: number; total?: number }): this {\n    this.phase = phaseName\n\n    if (options?.total !== undefined) {\n      this.total = options.total\n    }\n    if (options?.current !== undefined) {\n      this.current = options.current\n      // Reset ETA buffer on phase change\n      this.etaBuffer = [{ time: Date.now(), value: this.current }]\n    }\n\n    if (this.isActive) {\n      this.render()\n    }\n\n    return this\n  }\n\n  /**\n   * Stop the progress bar\n   */\n  stop(clear = false): this {\n    if (!this.isActive) {\n      return this\n    }\n\n    this.isActive = false\n\n    if (clear && isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${CLEAR_LINE_END}`, this.stream)\n    } else {\n      write(\"\\n\", this.stream)\n    }\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_SHOW, this.stream)\n    }\n\n    return this\n  }\n\n  /** Get ETA in seconds using smoothed rate */\n  private getETASeconds(): number | null {\n    return calculateETA(this.etaBuffer, this.current, this.total)\n  }\n\n  /**\n   * Render the progress bar\n   */\n  private render(tokens?: Record<string, string | number>): void {\n    const percent = this.total > 0 ? this.current / this.total : 0\n    const eta = this.getETASeconds()\n\n    // Build the bar\n    const completeLength = Math.round(this.width * percent)\n    const incompleteLength = this.width - completeLength\n    const bar = this.complete.repeat(completeLength) + this.incomplete.repeat(incompleteLength)\n\n    // Get phase display name\n    const phaseDisplay = this.phase ? (this.phases[this.phase] ?? this.phase) : \"\"\n\n    // Calculate rate\n    const elapsed = this.startTime ? (Date.now() - this.startTime) / 1000 : 0\n    const rate = elapsed > 0 ? this.current / elapsed : 0\n\n    // Replace tokens in format string\n    let output = this.format\n      .replace(\":bar\", chalk.cyan(bar))\n      .replace(\":percent\", `${Math.round(percent * 100)}%`.padStart(4))\n      .replace(\":current\", String(this.current))\n      .replace(\":total\", String(this.total))\n      .replace(\":eta\", formatETA(eta))\n      .replace(\":elapsed\", formatETA(elapsed))\n      .replace(\":rate\", rate.toFixed(1))\n      .replace(\":phase\", chalk.dim(phaseDisplay))\n\n    // Replace custom tokens\n    if (tokens) {\n      for (const [key, value] of Object.entries(tokens)) {\n        output = output.replace(`:${key}`, String(value))\n      }\n    }\n\n    // Truncate to terminal width\n    const termWidth = getTerminalWidth(this.stream)\n    if (output.length > termWidth) {\n      output = output.slice(0, termWidth - 1)\n    }\n\n    if (isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${output}${CLEAR_LINE_END}`, this.stream)\n    }\n  }\n\n  /**\n   * Get current progress ratio (0-1)\n   */\n  get ratio(): number {\n    return this.total > 0 ? this.current / this.total : 0\n  }\n\n  /**\n   * Get current progress percentage (0-100)\n   */\n  get percentage(): number {\n    return Math.round(this.ratio * 100)\n  }\n\n  /**\n   * Dispose the progress bar (calls stop)\n   */\n  [Symbol.dispose](): void {\n    this.stop()\n  }\n}\n"],"mappings":"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"}