/**
 * @file Stateless helpers shared by `spinner/*` modules — the `ciSpinner`
 *   constant for non-interactive output, the `COLOR_INHERIT` sentinel for
 *   shimmer color references, plus pure formatters (`desc`, `formatProgress`,
 *   `normalizeText`, `renderProgressBar`) used by both the factory and the
 *   `withSpinner*` wrappers.
 */
import type { ProgressInfo, SpinnerStyle } from './types';
/**
 * Sentinel value indicating the shimmer should track the spinner's current
 * color rather than holding its own palette reference.
 */
export declare const COLOR_INHERIT = "inherit";
/**
 * Minimal spinner style for CI environments. Uses empty frame and max interval
 * to effectively disable animation in CI.
 */
export declare const ciSpinner: SpinnerStyle;
/**
 * Create a property descriptor for defining non-enumerable properties. Used for
 * adding aliased methods to the Spinner prototype.
 *
 * @param value - Value for the property.
 *
 * @returns Property descriptor object
 */
export declare function desc(value: unknown): {
    __proto__: null;
    configurable: boolean;
    value: unknown;
    writable: boolean;
};
/**
 * Format progress information as a visual progress bar with percentage and
 * count.
 *
 * @example
 *   '███████░░░░░░░░░░░░░ 35% (7/20 files)'
 *
 * @param progress - Progress tracking information.
 *
 * @returns Formatted string with colored progress bar, percentage, and count
 */
export declare function formatProgress(progress: ProgressInfo): string;
/**
 * Normalize text input by trimming leading whitespace. Non-string values are
 * converted to empty string.
 *
 * @param value - Text to normalize.
 *
 * @returns Normalized string with leading whitespace removed
 */
export declare function normalizeText(value: unknown): string;
/**
 * Render a progress bar using block characters (█ for filled, ░ for empty).
 *
 * @default width=20
 *
 * @param percentage - Progress percentage (0-100)
 * @param width - Total width of progress bar in characters.
 *
 * @returns Colored progress bar string
 */
export declare function renderProgressBar(percentage: number, width?: number): string;
