/** * Pure loading message formatting utilities for CLI progress output. * * Generates contextual loading messages that describe what the CLI * is doing, on what subject, and optionally in which org. * * All functions are pure (no side effects, no external state) and return * formatted strings. * * @module utils/formatting/loading-messages */ /** * Generates a contextual loading message for CLI progress display. * * Produces a human-readable string describing the current operation, * suitable for use with spinners or progress indicators. The message * follows the pattern: "Action Subject from OrgAlias..." or * "Action Subject..." when no org is provided. * * @param action - The verb describing the operation (e.g. "Analyzing", "Fetching", "Exporting") * @param subject - The target of the operation (e.g. "Account", "definitions", "field metadata") * @param org - Optional org alias or username for context * @returns A formatted loading message string ending with "..." * * @example * loadingMessage('Analyzing', 'Account', 'myOrg') * // "Analyzing Account from myOrg..." * * @example * loadingMessage('Fetching', 'field metadata') * // "Fetching field metadata..." * * @example * loadingMessage('Exporting', '42 definitions', 'prod') * // "Exporting 42 definitions from prod..." */ export declare function loadingMessage(action: string, subject: string, org?: string): string;