✨ Add configurable style markup modes

docs/README-en.md

@@ -183,6 +183,18 @@ let logger = Logger::new(text_console_sink(formatter), target="styled")
 logger.info("<accent>styled</> output and <danger>alert</>")
 ```
 
+Disable style markup parsing:
+
+```moonbit
+let formatter = text_formatter(
+  color_mode=ColorMode::Always,
+).without_style_markup()
+
+let logger = Logger::new(text_console_sink(formatter), target="raw")
+
+logger.info("<red>kept as raw text</>")
+```
+
 JSON config loading:
 
 ```moonbit
@@ -208,6 +220,18 @@ let logger = build_logger(config)
 logger.info("<accent>styled from json</>")
 ```
 
+JSON `style_markup` mode:
+
+```moonbit
+let config = parse_logger_config_text(
+  "{\"sink\":{\"kind\":\"text_console\",\"text_formatter\":{\"color_mode\":\"always\",\"style_markup\":\"disabled\"}}}",
+)
+
+let logger = build_logger(config)
+
+logger.info("<red>still raw</>")
+```
+
 Native file sink:
 
 ```moonbit
@@ -257,6 +281,7 @@ match logger.file_runtime_state() {
 - `QueueConfig`, `TextFormatterConfig`, and `SinkConfig` can also be exported independently through `queue_config_to_json(...)` / `stringify_queue_config(...)`, `text_formatter_config_to_json(...)` / `stringify_text_formatter_config(...)`, and `sink_config_to_json(...)` / `stringify_sink_config(...)`.
 - Supported keys include `min_level`, `target`, `timestamp`, `sink.kind`, `sink.path`, `sink.append`, `sink.auto_flush`, `sink.rotation`, `sink.text_formatter`, and `queue`.
 - `TextFormatter` and `TextFormatterConfig` now include `color_mode = Never | Auto | Always` for ANSI text coloring control.
+- `TextFormatter` and `TextFormatterConfig` also include `style_markup = disabled | builtin | full` so callers can choose whether style markup is parsed and whether custom tags are active.
 - `message` also supports lightweight inline style tags such as `<red>...</>`, `<b>...</>`, `<#ff0000>...</>`, and `<bg:#202020>...</>`.
 - Runtime style-tag APIs now include `TextStyle`, `StyleTagRegistry`, `style_tag_registry()`, `default_style_tag_registry()`, `set_tag(...)`, and `define_alias(...)`.
 - Style-tag lookup priority is formatter-local `style_tags` > global style tag registry > builtin tags.
@@ -286,6 +311,7 @@ match logger.file_runtime_state() {
 - `file_sink_state_to_json(...)`, `stringify_file_sink_state(...)`, `runtime_file_state_to_json(...)`, and `stringify_runtime_file_state(...)` can export file and queued-file snapshots directly as JSON for diagnostics or reporting.
 - `sink.text_formatter.template` currently supports fixed tokens: `{timestamp}`, `{timestamp_ms}`, `{level}`, `{target}`, `{message}`, and `{fields}`.
 - `sink.text_formatter.color_mode` currently supports `never`, `auto`, and `always`.
+- `sink.text_formatter.style_markup` currently supports `disabled`, `builtin`, and `full`.
 - `sink.text_formatter.style_tags.<name>` currently supports `fg`, `bg`, `bold`, `dim`, `italic`, and `underline`.
 - Config-driven sink assembly currently supports `console`, `json_console`, `text_console`, and `file`.
 - `queue` remains a synchronous bounded wrapper around the final sink, not an async runtime.

docs/changes/0.4.0.md

@@ -14,6 +14,8 @@ version 0.4.0
 - 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(...)`
 - feat: support minimal `sink.text_formatter.style_tags` JSON config parsing and serialization for custom formatter tag styles
+- feat: add `StyleMarkupMode = Disabled | Builtin | Full` plus formatter helpers so callers can explicitly disable style parsing or allow builtin-only parsing
+- feat: support `sink.text_formatter.style_markup` in JSON config parsing and serialization
 
 ### Test
 
@@ -24,11 +26,13 @@ version 0.4.0
 - 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
 - test: cover formatter `style_tags` JSON parsing, config roundtrip, JSON helper export, and config-driven styled formatter rendering
+- test: cover disabled markup mode, builtin-only mode, and config-driven `style_markup` behavior
 
 ### Example
 
 - docs: add `color_mode` usage examples to formatter documentation
 - docs: add runtime and JSON `style_tags` examples, and document current JSON schema scope
+- docs: add runtime and JSON examples for toggling style markup parsing
 
 ### Notes
 
@@ -37,3 +41,4 @@ version 0.4.0
 - 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
 - JSON config currently supports concrete style objects only; alias-style declarations remain runtime-only
+- users can now decide whether custom style parsing is enabled through runtime formatter APIs or `sink.text_formatter.style_markup`