Plain Text Formatter

Purpose & User Intent: The Plain Text Formatter solves the problem of converting irregular, multi-source plain text into consistent, machine-friendly formatting. Target users include technical writers, software developers, data engineers, and content teams who export or copy text from diverse editors. It is used when a stable, predictable plain-text representation is required for code comments, documentation, data pipelines, or version-controlled manuscripts. The tool minimizes manual edits and ensures repeatable results across teams. Core Logic & Features: The tool applies controlled wrapping and whitespace normalization. Required features include: input_text (multiline string), wrap_width (integer 20–200), and option flags for trimming trailing spaces and collapsing internal whitespace. Optional/advanced features include preserving leading indentation, preserving blank lines, selecting line-ending style (LF or CRLF), and per-paragraph wrapping. The underlying algorithm uses greedy word-wrapping: accumulate words until the next would exceed wrap_width, then start a new line; paragraphs are separated by blank lines; tabs are converted to spaces if configured. The tool does not perform language translation, grammar correction, or semantic restructuring. Inputs & Outputs: Inputs: input_text (string, multiline), wrap_width (int, 20–200 chars), trim_trailing_spaces (bool), collapse_spaces (bool), preserve_indentation (bool), line_ending (str: \"LF\" or \"CRLF\"). Outputs: formatted_text (string, multiline), summary (string) describing applied options and results. Validation ensures wrap_width is within range; empty input yields empty output; non-text inputs are rejected. Algorithms & Calculations: Normalization step converts line endings to the chosen style. Word-wrapping is greedy and respects word boundaries when possible. If a single word exceeds wrap_width and wrapping inside words is not allowed, the word is placed on its own line, potentially exceeding the limit. Trailing spaces are removed if specified; indentation for lines is preserved when requested. Error & Edge Cases: Empty input returns empty output. Very long tokens may exceed wrap width. Invalid wrap_width falls back to a safe default. Non-text characters are preserved by default and may affect wrapping if wide characters are present. External data sources are not accessed. Industry/Region & Localization: Primarily character-based, language-neutral formatting suitable for Latin scripts; supports LF/CRLF; no locale-aware hyphenation by default; suitable for cross-region documentation and codebases. Assumptions & Exclusions: Assumes input is plain text; not a code formatter or syntax highlighter; does not perform spelling or grammar correction; excludes rich-text conversion or formatting beyond whitespace and line-wrapping.