BitLogger/docs/changes/0.4.0.md

BitLogger Update Changes

version 0.4.0

Feature

• feat: add ColorMode = Never | Auto | Always for text formatter color control
• feat: add ANSI level, target, timestamp, and field rendering to format_text(...)
• feat: add color_mode to TextFormatter and TextFormatterConfig
• feat: support text_formatter.color_mode in JSON config parsing and serialization
• feat: add inline style markup support in message text for ANSI text formatter output
• feat: support named color tags like <red>...</>, style tags like <b>...</>, and hex tags like <#ff0000>...</> / <bg:#010203>...</>
• feat: keep JSON formatter output unchanged and limit inline style parsing to text message rendering only
• feat: add TextStyle, StyleTagRegistry, style_tag_registry(), and default_style_tag_registry() for reusable inline style tags
• feat: add formatter-local style_tags, global style tag registry helpers, builtin-tag override support, and alias reuse via define_alias(...)

Test

• test: cover ANSI text formatter rendering in Always mode
• test: cover Auto mode fallback behavior when NO_COLOR is present
• test: cover config parsing and serialization for color_mode
• test: cover named inline color tags in ANSI mode
• test: cover plain mode tag stripping, nested tags, hex tags, and unknown-tag fallback behavior
• test: cover custom tags, builtin-tag override, formatter-vs-global priority, global registry fallback, and alias reuse

Example

• docs: add color_mode usage examples to formatter documentation

Notes

• Auto currently uses a conservative rule: if NO_COLOR exists, ANSI is disabled; otherwise ANSI is enabled
• inline style markup currently supports short close </> only
• unknown or invalid inline tags currently fall back to plain text and do not raise formatter errors
• formatter-local tag lookup currently takes precedence over global tag lookup, and global lookup takes precedence over builtin tags