@lerna/output

@lerna/output is an internal Lerna utility that provides console output functionality with npmlog integration. It ensures clean console output during Lerna operations by temporarily clearing progress indicators, logging content, and then restoring progress display.

Package Information

• Package Name: @lerna/output
• Package Type: npm
• Language: JavaScript (CommonJS)
• Installation: npm install @lerna/output
• Node.js Support: ^14.15.0 || >=16.0.0

Core Imports

const { output } = require("@lerna/output");

Alternative import pattern:

const output = require("@lerna/output").output;

Basic Usage

const { output } = require("@lerna/output");

// Simple console output with progress clearing
output("Hello, world!"); 

// Multiple arguments (like console.log)
output("Processing", 42, "files", { status: "complete" });

// Use in Lerna operations where progress bars are active
output("✅ Build completed successfully");
output("📦 Publishing packages...");

Capabilities

Console Output with Progress Management

Provides clean console output that doesn't interfere with npmlog progress indicators.

/**
 * Outputs arguments to console with npmlog progress management
 * @param {...any} args - Arguments to log (same as console.log)
 * @returns {undefined}
 */
function output(...args): undefined;

The output function:

• Calls log.clearProgress() to temporarily hide progress indicators
• Logs all provided arguments using console.log(...args)
• Calls log.showProgress() to restore progress display
• Accepts any number of arguments of any type (same interface as console.log)

Dependencies

• npmlog@^6.0.2 - Required for progress clearing and showing functionality

Implementation Notes

• This is an internal Lerna tool, primarily designed for use within the Lerna ecosystem
• The function is a wrapper around console.log with npmlog integration
• Progress management ensures clean output during long-running Lerna operations
• Uses CommonJS module exports (module.exports.output = output)
• No TypeScript definitions provided
• No browser/ESM support (Node.js only)