BitLogger/docs/api/default-style-tag-registry.md

name, group, category, update-time, description, key-word

name	group	category	update-time	description	key-word
default-style-tag-registry	api	formatter	20260520	Create the built-in style tag registry containing default semantic and color tags.	style registry default public

Default-style-tag-registry

Create the built-in StyleTagRegistry containing the library's default style tags. This helper is useful when callers want to start from the standard tag set and then extend or override it.

Interface

pub fn default_style_tag_registry() -> StyleTagRegistry {

output

• StyleTagRegistry - Registry seeded with built-in tags and aliases.

Explanation

Detailed rules explaining key parameters and behaviors

• The returned registry contains the library's built-in style tag set.
• Callers can extend or override entries before attaching the registry to a formatter.
• This helper is useful when custom tags should coexist with built-in semantic tags.

How to Use

Here are some specific examples provided.

When Need Built-in Tags Plus Local Overrides

When a formatter should keep defaults but customize one tag:

let tags = default_style_tag_registry().set_tag("success", fg=Some("#00ffaa"), underline=true)

In this example, the built-in registry is reused and then locally overridden.

Error Case

e.g.:

• If the formatter disables style markup, built-in tags may not be applied even though the registry exists.

• If callers need a clean registry with no built-in tags, use style_tag_registry() instead.

Notes

1. This helper is the easiest way to preserve the standard tag vocabulary.

2. It is commonly paired with text_formatter(...).with_style_tags(...).