Skip to content

Latest commit

 

History

History
831 lines (557 loc) · 32.1 KB

CHANGELOG.md

File metadata and controls

831 lines (557 loc) · 32.1 KB

Changelog

All notable changes to StyledConsole will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.10.4] - 2026-01-22

🖥️ CLI Preview Tool & JSON Schema

This release adds a command-line interface for exploring StyledConsole features and a JSON Schema for IDE autocomplete.

Added

  • CLI Tool: New styledconsole command with 6 subcommands:
    • styledconsole demo — Interactive feature showcase
    • styledconsole palette [name] — List or preview 90 color palettes
    • styledconsole effects [name] — List or preview 47 effect presets
    • styledconsole icons [search] — List or search 200+ icons
    • styledconsole render <file> — Render YAML/JSON config files
    • styledconsole schema — Get JSON Schema path for IDE configuration
  • JSON Schema: Full schema for declarative configs at styledconsole/schemas/styledconsole.schema.json
    • Enables IDE autocomplete and validation for YAML/JSON config files
    • Supports VS Code, JetBrains, and other schema-aware editors
    • Covers all 11 object types: text, frame, banner, table, layout, vertical, horizontal, grid, group, spacer, rule
    • Includes shorthand syntax definitions (frame:, banner:, row:, column:, grid:)
    • Documents all 32+ effect presets and 9 border styles
  • Schema API: New styledconsole.schemas module with get_schema_path() and get_schema() functions
  • Entry Point: styledconsole command available after installation via [project.scripts]
  • CLI Tests: 20 new tests covering all CLI functionality

Documentation

  • Updated Getting Started guide with CLI section
  • Added CLI Preview Tool section to main README
  • Updated docs/README.md with CLI quick start commands

[0.10.3] - 2026-01-21

📚 Golden Path Documentation & Visual Upgrades

This release focuses on improving the onboarding experience with comprehensive "Golden Path" documentation, new complex examples, and a visual overhaul of the gallery.

Added

  • Golden Path Guide (docs/GETTING_STARTED.md): A comprehensive 30-second to 5-minute guide covering:
    • First frame creation
    • Emojis, colors, and gradients
    • Background effects and progress bars
    • Building complete dashboards
  • New Complex Examples:
    • enum_showcase.py: Demonstrates all v0.10.2 Enums (Border, Effect, Align, etc.)
    • background_combinations.py: Large dashboards with background gradients and alerts
    • grid_dashboard.py: 2x2/3-column grids, complete dashboard layouts, cyberpunk themes
  • Gallery Updates:
    • Added Background Layer Effects section
    • Added 90 Curated Color Palettes section

Changed

  • README Overhaul:
    • Added positioning statement: "StyledConsole is to Rich what Tailwind is to CSS"
    • Highlighted "Getting Started" link
    • Updated Key Features table with Background Effects and Enums
  • Documentation:
    • docs/README.md now features a prominent "Start Here" section

[0.10.2] - 2026-01-18

Added

  • StrEnum Types for IDE Autocomplete: New enum types provide IDE autocomplete and type safety while maintaining backward compatibility with string values:

    • Border: SOLID, ROUNDED, DOUBLE, HEAVY, THICK, ROUNDED_THICK, ASCII, MINIMAL, DOTS
    • Effect: 47 preset effects including FIRE, OCEAN, RAINBOW, CYBERPUNK, etc.
    • Align: LEFT, CENTER, RIGHT
    • Direction: VERTICAL, HORIZONTAL, DIAGONAL
    • Target: CONTENT, BORDER, BOTH
    • LayoutMode: VERTICAL, HORIZONTAL, GRID
    • ExportFormat: HTML, TEXT, PNG, WEBP, GIF
    from styledconsole import Console, Border, Effect, Align
console = Console()
console.frame("Hello", border=Border.ROUNDED, effect=Effect.OCEAN, align=Align.CENTER)
# String values still work for backward compatibility
console.frame("Hello", border="rounded", effect="ocean", align="center")

  • Background Layer Support for Effects: Gradient effects can now be applied to background colors in addition to foreground text:

    from styledconsole import EffectSpec

# Foreground gradient (default)
effect = EffectSpec.gradient("red", "blue", layer="foreground")

# Background gradient
effect = EffectSpec.gradient("red", "blue", layer="background")

  • Intelligent Error Messages with Suggestions: Error messages now include "Did you mean?" suggestions using fuzzy matching:

    • Border styles: "rounde" → Did you mean 'rounded'?
    • Effect presets: "rainbo" → Did you mean 'rainbow'?
    • Palette names: "ocea" → Did you mean 'ocean'?
    • Object types: "fram" → Did you mean 'frame'?
    • Color names: "gren" → Did you mean 'green'?
    • Alignment: "middle" → Did you mean 'center'?

  • Suggestions Utility Module: New styledconsole.utils.suggestions module with Levenshtein distance-based fuzzy matching utilities

Changed

  • resolve_effect() now returns 4 values: (position, color, target, layer) instead of 3
  • Registry base class now uses fuzzy matching for error suggestions

[0.10.1] - 2026-01-13

Added

  • Unit tests for presets/layouts.py (15 new tests)
  • Unit tests for presets/tables.py (19 new tests)

Changed

Fixed

  • Test coverage improved from 79% to 81%

[0.10.0] - 2026-01-12

🎉 Major API Overhaul - Four-Layer Architecture

This release introduces a complete architectural redesign with four composable API layers, giving developers full control over how they build terminal UIs.

New Architecture Layers

1. Builder Layer (Fluent API)

from styledconsole import FrameBuilder, BannerBuilder, TableBuilder, LayoutBuilder

frame = (FrameBuilder()
    .title("Dashboard")
    .content("Hello World")
    .effect("ocean")
    .build())

2. Model Layer (Direct Construction)

from styledconsole import Frame, Banner, Table, Layout, Text, Style, ConsoleObject

frame = Frame(
    title="Status",
    content=Text("Online", style=Style(color="green")),
    border_style="rounded"
)

3. Renderer Layer (Output Targets)

from styledconsole import TerminalRenderer, HTMLRenderer, RenderContext

renderer = TerminalRenderer()
renderer.render(frame, context=RenderContext(width=80))

4. Declarative Layer (Configuration-Driven)

from styledconsole import Declarative, load_dict, load_yaml, load_json, from_template

# From Python dict
ui = load_dict({"type": "frame", "title": "Hello", "content": "World"})

# From YAML/JSON files
ui = load_yaml("config.yaml")
ui = load_json("config.json")

# From Jinja2 templates
ui = from_template("dashboard.j2", context={"user": "Alice"})

Added

  • Builder Classes: FrameBuilder, BannerBuilder, TableBuilder, LayoutBuilder with fluent method chaining
  • Model Classes: Frame, Banner, Table, Layout, Text, Style, ConsoleObject base class
  • Renderer Protocol: TerminalRenderer, HTMLRenderer, RenderContext for multi-target output
  • Declarative Facade: Declarative class with load_dict(), load_yaml(), load_json(), from_template() functions
  • Template System: Jinja2 integration with built-in component macros and filters
  • 11 v0.10 Examples: Complete examples demonstrating all four API layers in 10_v010_api/

Migration from v0.9.x

The existing Console API remains fully supported. The new layers are additive:

# v0.9.x style (still works)
console = Console()
console.frame("Hello", effect="ocean")

# v0.10.0 style (new option)
frame = FrameBuilder().content("Hello").effect("ocean").build()
TerminalRenderer().render(frame)

See MIGRATION.md for the complete migration guide.

Testing

  • 968 tests passing (975 total, 7 Kitty terminal-specific skipped)
  • 79.23% code coverage
  • Full backward compatibility with v0.9.x API

[0.9.9.6] - 2026-01-10

Rich Integration & Quality Improvements

This release focuses on cleaner integration with the underlying Rich library, fixing duplication and improving visual stability.

Changed

  • Internal Core Refactoring:
    • Theme Integration: StyledConsole themes now natively power Rich markup (e.g., [success]Text[/]).
    • Color Blending: Replaced custom RGB interpolation with rich.color.blend_rgb for more accurate gradients.
    • Text Styling: Refactored utils/color.py to use rich.text.Text objects, improving nested style and multiline support.
  • Emoji Support:
    • VS16 Fix: Added utils/rich_compat.py with patched_cell_len() to correctly measure emojis in modern terminals (fixing alignment issues).
    • Sanitization: Standardized emoji fallback logic in utils/sanitize.py.

Fixed

  • StyledColumns Bug: Fixed an issue where StyledColumns would strip color from ASCII fallback icons when emoji support was disabled.
  • Layout Issues: Fixed "Safey Analysis" frame layout in emoji_integration_demo.py.

Feature Expansion

This release expands the effects system with palettes, phase animations, horizontal/grid layouts, and the StyledColumns component.

Added

  • Horizontal & Grid Layouts for frame_group(): Arrange frames side-by-side or in grids

    console.frame_group(items, layout="horizontal", gap=2)
console.frame_group(items, layout="grid", columns=3, item_width=30)
console.frame_group(items, layout="grid", columns="auto", min_columns=2)
    • columns= parameter: Number of columns or "auto" for terminal-width calculation
    • min_columns= parameter: Minimum columns when using auto-calculation
    • item_width= parameter: Width of each item frame in horizontal/grid layouts

  • Palette System (data/palettes.py): 90 curated color palettes with category filtering

    from styledconsole import PALETTES, get_palette, list_palettes, get_palette_categories

# Get palette colors
ocean = get_palette("ocean_depths")  # {"colors": [...], "categories": [...]}

# List palettes by category
vibrant = list_palettes("vibrant")  # ["fire", "neon", "sunset", ...]
pastel = list_palettes("pastel")    # ["pastel_candy", "soft_dream", ...]

# Create effect from palette
console.frame("Content", effect=EffectSpec.from_palette("ocean_depths"))
    • Categories: warm, cool, vibrant, muted, pastel, dark, bright, monochrome, rainbow

  • Extended Color Registry (data/colors.py): 949+ named colors

    • CSS4 colors (148), Rich colors (251), Extended colors (944 filtered)
    • Filtering API to exclude crude/inappropriate names

  • Phase Animation System: Smooth gradient animations with phase cycling

    from styledconsole import EffectSpec, cycle_phase, PHASE_INCREMENT_DEFAULT

phase = 0.0
for frame in range(30):
    effect = EffectSpec.rainbow(phase=phase)
    console.frame("Animated!", effect=effect)
    phase = cycle_phase(phase)  # Increments and wraps at 1.0
    • phase= parameter on EffectSpec.gradient(), .multi_stop(), .rainbow()
    • cycle_phase() helper for smooth animation loops
    • PHASE_FULL_CYCLE (1.0) and PHASE_INCREMENT_DEFAULT (0.033) constants
    • .with_phase() method for functional-style updates

  • Neon Rainbow Palette: Cyberpunk-style vivid colors for rainbows

    console.frame("NEON", effect=EffectSpec.rainbow(neon=True))

  • StyledColumns (columns.py): Policy-aware Rich Columns wrapper

    from styledconsole import Console, StyledColumns

console = Console()
columns = StyledColumns(["Item 1", "Item 2", "Item 3"], padding=(0, 2))
console.print(columns)

# Or via Console API
console.columns(["A", "B", "C"], equal=True, expand=True)
    • Automatic emoji-to-ASCII sanitization when policy.emoji=False
    • VS16 emoji width fix for proper column alignment in modern terminals
    • Full Rich Columns API compatibility

  • EffectSpec.from_palette(): Create multi-stop gradients from named palettes

    effect = EffectSpec.from_palette("fire", direction="horizontal")
console.frame("Fire gradient from palette!", effect=effect)

  • Palette Utilities (utils/palette.py):

    • create_palette_effect(): Quick effect creation from palette name
    • palette_from_dict(): Import custom palettes from dict format

Changed

  • Console.frame(): Now accepts effect= parameter alongside legacy gradient params
  • Console.frame_group(): Extended with columns=, min_columns=, item_width= parameters
  • RenderingEngine: Refactored with _render_vertical_frame_group() and _render_horizontal_frame_group() private methods

Developer Dependencies

  • Added requests>=2.31.0 for palette fetching utilities
  • Added beautifulsoup4>=4.12.0 for HTML parsing in examples
  • Added lxml>=5.0.0 for XML processing

Testing

  • 968 tests passing (975 total, 7 Kitty terminal-specific skipped)
  • 79.23% code coverage
  • New test file: test_columns.py for StyledColumns

[0.9.9.4] - 2026-01-05

Fixed

  • PyPI Publishing: Version bump to resolve TestPyPI filename reuse issue with v0.9.9.3

[0.9.9.3] - 2026-01-05

Console API Integration

Effects system is now fully integrated into the Console API with effect= parameter.

Added

  • effect= parameter for Console.frame(): Apply effects directly in frame calls 
    console.frame("Hello", effect="fire")
console.frame("World", effect=EFFECTS.ocean)
console.frame("Custom", effect=EffectSpec.gradient("red", "blue"))
  • effect= parameter for Console.banner(): Apply effects to ASCII art banners 
    console.banner("SUCCESS", effect="rainbow_neon")
console.banner("ALERT", effect=EFFECTS.fire)
  • Public exports: EFFECTS and EffectSpec now exported from main styledconsole module
  • StyleContext.effect field: New field to hold resolved effect specification

Deprecated

  • start_color/end_color in frame(): Use effect=EffectSpec.gradient(start, end) instead
  • border_gradient_start/border_gradient_end in frame(): Use effect=EffectSpec.gradient(..., target='border') instead
  • rainbow=True in banner(): Use effect="rainbow" instead
  • start_color/end_color in banner(): Use effect=EffectSpec.gradient(start, end) instead

All deprecated parameters continue to work with deprecation warnings. They will be removed in v1.0.0.

Fixed

  • Kitty Terminal ZWJ Emoji Alignment: Fixed frame alignment issues when using ZWJ (Zero Width Joiner) emoji sequences like 👨‍💻 (Developer) or 🏳️‍🌈 (Rainbow Flag) in Kitty terminal
    • Kitty renders ZWJ components separately when fonts lack ligature support, resulting in wider visual width than other terminals
    • visual_width() now correctly calculates component-summed widths (e.g., 👨‍💻 = 4 cells instead of 2) specifically for Kitty
    • Other modern terminals (WezTerm, iTerm2, Ghostty, Alacritty) continue to use single-glyph width-2 calculation
    • Fixes misalignment in core/emoji_integration_demo.py and validation/emoji_comparison.py
  • Wide Symbol Character Width: Fixed width calculation for wide non-emoji symbols like trigram (☰) in modern terminals
    • _grapheme_width_modern() now correctly trusts wcwidth results for all characters, not just zero-width
    • Previously incorrectly calculated trigram (☰ U+2630) as width 1 when it should be width 2
    • Fixes frame border misalignment for lines containing wide Unicode symbols

Testing

  • 968 tests passing (core test suite)
  • 31 effect integration tests
  • 41 effect system tests
  • 80.42% code coverage
  • Full backward compatibility maintained

[0.9.9.2] - [UNRELEASED]

Note: Version 0.9.9.2 was never officially released. Its bug fixes have been integrated into v0.9.9.3.

Effects System Foundation

New declarative effects system with 32 pre-configured presets and extensible architecture.

Added

  • EffectSpec (effects/spec.py): Frozen dataclass for declarative effect definitions
    • Factory methods: EffectSpec.gradient(), EffectSpec.multi_stop(), EffectSpec.rainbow()
    • Immutable with with_direction(), with_target(), reversed() modifiers
  • EffectRegistry (effects/registry.py): Named effect preset catalog
    • 10 gradient presets: fire, ocean, sunset, forest, aurora, lavender, peach, mint, steel, gold
    • 7 rainbow presets: standard, pastel, neon, muted, reverse, horizontal, diagonal
    • 6 themed presets: matrix, cyberpunk, retro, vaporwave, dracula, nord_aurora
    • 5 semantic presets: success, warning, error, info, neutral
    • 4 border-only presets: border_fire, border_ocean, border_rainbow, border_gold
  • Effect Resolver (effects/resolver.py): Bridge between specs and strategies
    • resolve_effect() converts EffectSpec or preset name to strategy tuple
    • Direction, color source, and target filter mapping
  • MultiStopGradient: 3+ color gradient interpolation with custom stop positions
  • EnhancedRainbow: Rainbow with saturation, brightness, and reverse controls
  • ReversedColorSource: Wrapper strategy for reversing any color source

Testing

  • 1028 tests passing (159 new tests for effects system)
  • 82.11% code coverage
  • All pre-commit hooks passing

[0.9.9.1] - 2026-01-03

Documentation & PyPI Compatibility

Restructured documentation for better PyPI compatibility and added GitHub Sponsors support.

Changed

  • README.md: Simplified, text-focused README that renders properly on PyPI (no images)
  • docs/GALLERY.md: New auto-generated visual showcase with all example images
  • GitHub Sponsors: Added GitHub Sponsors to FUNDING.yml and README badges
  • Generation System: Updated scripts/readme/generate.py to produce both README and GALLERY

Fixed

  • PyPI Rendering: README now renders correctly on PyPI without broken image links
  • Version Badges: Updated all version references to 0.9.9.1

[0.9.9] - 2026-01-02

🎨 Image Export & Table System

Major feature release adding comprehensive image export capabilities, table/layout system, and critical bug fixes.

Added

  • Image Export System: Full-featured image export with emoji rendering, font styles, and customizable themes
    • export_image() method supporting PNG, WebP, and GIF formats
    • Smart emoji renderer with fallback font support for special characters
    • Font loader with automatic font discovery across Linux, macOS, and Windows
    • Image theme system with customizable background, text, and border colors
    • Automatic image cropping to remove unnecessary padding
  • Table System: Declarative table API with gradient support
    • StyledTable class with Rich-based rendering
    • GradientTable for automatic border gradient effects
    • Support for border styles, colors, and custom formatting
  • Layout Presets: Pre-configured layouts for common use cases
    • Three-column layout, two-column split, header-content-footer
    • JSON data display, statistics dashboard, error report layouts
  • Virtual Terminal Mode: Consistent rendering for image/HTML export
    • Forces predictable terminal behavior for export consistency
    • Patches Rich's cell width calculations for perfect alignment
  • README Generation Pipeline: Automated documentation with live examples
    • scripts/readme/ package for generating README from template
    • Automatic image generation from code examples
    • Consistent visual identity across all documentation images

Fixed

  • Console.theme Property: Added missing @property decorator for proper attribute access
  • Emoji Renderer Alignment: Fixed emoji width calculations to respect Rich's patched cell_len
  • Font Loader Complexity: Refactored to reduce cyclomatic complexity from 31 to acceptable levels
  • Type Safety: Fixed all mypy type errors with proper annotations and type: ignore comments
  • Code Quality: Fixed ruff lint issues (unpacking syntax, dict lookups, line length)

Changed

  • Complexity Checks: Added console.py and image_exporter.py to MI exclusion list (architectural coordinators)
  • Render Target System: Enhanced with "image" and "html" targets for export-aware rendering
  • Terminal Manager: Added virtual mode for consistent export behavior

Testing

  • ✅ 869 tests passing (all tests including new features)
  • ✅ 80.08% code coverage
  • ✅ All pre-commit hooks passing (ruff, mypy, complexity checks)
  • ✅ Python 3.10-3.14 compatibility verified

Documentation

  • Updated README with accurate test count (869) and coverage (80%)
  • Added comprehensive image export documentation
  • Included visual examples for all major features
  • Updated USER_GUIDE with table and export examples

[0.9.8.1] - 2025-12-28

🧹 Test Release & Documentation Cleanup

This is a test release to validate the TestPyPI publication workflow and prepare for the 0.9.9 release. Focus on infrastructure improvements and documentation organization.

Changed

  • Examples Execution: Examples now use uv run from main repository for correct package context.
  • Documentation Structure: Simplified public documentation (README, CONTRIBUTING) to focus on user-facing content.
  • Version Badge: Updated README version badge to reflect current release.

Fixed

  • Examples Runner: Fixed module import issues by detecting main repository and using uv run python.
  • TTY Detection: Added graceful degradation for terminal validation scripts running in non-interactive environments.
  • Code Quality: Fixed linting errors (line length, f-string usage, iterable unpacking).

Testing

  • ✅ All 37 examples passing
  • ✅ 943 tests passing (90% coverage)
  • ✅ Code quality checks passing (make qa)
  • ✅ No TODO/debug statements in codebase

[0.9.8] - 2025-12-27

🏛️ Registry Pattern Refactoring & Infrastructure

This update introduces a unified Registry pattern for managing styles, icons, and themes, improving extensibility and maintainability.

Added

  • core/registry.py: Generic Registry base class with case-insensitive lookup and attribute-style access.
  • tests/unit/test_registry.py: Comprehensive unit tests for the registry system.
  • Support Info: Added Ko-fi support badges and section to README.md.
  • Repository Funding: Created .github/FUNDING.yml for Ko-fi sponsorship.

Changed

  • Border Styles: Migrated styles.py to use BorderRegistry.
  • Box Mappings: Migrated box_mapping.py to use BoxRegistry.
  • Icon System: Refactored IconProvider to use IconRegistry while maintaining full backward compatibility.
  • Theme System: Replaced THEMES class with ThemeRegistry instance and restored legacy filters.
  • Gradient Engine: Consolidated logic into effects/engine.py (migrated from core/gradient_utils.py).

Fixed

  • Icon Alignment: Fixed edge cases where icons would cause slight frame misalignments in certain terminals.
  • Theme Filtering: Restored solid_themes() and gradient_themes() methods in the new registry.
  • Nested Gradients: Fixed rendering issues with nested gradient frames.

Removed

  • core/gradient_utils.py: All functionality migrated to effects/engine.py and utils/color.py.

[0.9.7] - 2025-12-26

🧩 Context Object Pattern & Validation

This patch introduces a StyleContext Context Object to centralize rendering style parameters, adds defensive validation and filtering, and tightens emoji validation heuristics for terminal safety.

Added

  • StyleContext: Immutable dataclass encapsulating frame/style parameters.
  • Early ZWJ/Skin-tone detection: validate_emoji() now flags ZWJ and skin-tone sequences as unsafe for general terminal output (still allowed in modern terminals).

Changed

  • Defensive construction: FrameGroupContext now filters captured kwargs to StyleContext fields, preventing TypeErrors when extra args are present.
  • Stricter validation: StyleContext.__post_init__ now validates margin tuple length and requires paired gradient fields (start_color/end_color).

Tests

  • Added unit tests for context validation and group kwarg filtering.
  • Full test-suite run: 936 tests passing after fixes.

[0.9.6] - 2025-12-07

🖥️ Modern Terminal Detection

This release adds automatic detection of modern terminals (Kitty, WezTerm, iTerm2, Ghostty, Alacritty, Windows Terminal) with full Unicode/emoji support.

Added

  • Modern terminal detection: Auto-detect terminals (Kitty, WezTerm, iTerm2, Ghostty, Alacritty, Windows Terminal) with correct VS16/ZWJ support.
  • is_modern_terminal(): New helper function for terminal capability check.
  • TerminalProfile: Enhanced with terminal_name and modern_emoji fields.
  • _grapheme_width_modern(): Correct width calculation for modern terminals.
  • Environment Overrides: STYLEDCONSOLE_MODERN_TERMINAL and STYLEDCONSOLE_LEGACY_EMOJI support.

Changed

  • visual_width(): Now uses modern width calculation when in modern terminal.
  • emoji_safe: Automatically True for modern terminals.
  • Width calculation: VS16 emojis now correctly width 2 in modern terminals.

[0.9.5] - 2025-12-07

🎯 Symbol Facade Unification

This release establishes icons as the primary facade for terminal output, with EMOJI serving as the underlying data layer.

Changed

  • Internal Refactoring: icon_data.py now uses EMOJI.* references instead of literals.
  • Documentation Hierarchy: Updated guides to recommend icons as the primary API.
  • Export reordering: __init__.py reordered to prioritize icons.
  • Example Migration: All 38 example files updated to use icons.

[0.9.1] - 2025-12-07

😀 Emoji DRY Refactoring

DRY emoji architecture using emoji package as single source of truth.

Added

  • emoji_registry.py: New single source of truth for 4000+ emojis.
  • CLDR Canonical Names: All emoji names updated to follow CLDR standard.
  • CuratedEmojis: Category-organized name lists for discovery.
  • Emoji Search: EMOJI.search() and EMOJI.get() methods.

Changed

  • Memory Optimization: Added slots=True to Icon dataclass.

Deprecated

  • EmojiConstants: Now triggers DeprecationWarning, use EMOJI directly.

[0.9.0] - 2025-12-03

🚀 Icon Provider & Runtime Policy

Icon Provider with colored ASCII fallback, Runtime Policy for env-aware rendering, and QA standardization.

Added

  • Icon Provider: 224 curated icons with automatic colored ASCII fallback.
  • RenderPolicy: Centralized environment detection (NO_COLOR, TERM=dumb, CI).
  • Progress Theming: Bar charts and progress indicators now inherit theme colors.
  • Makefile Standards: Unified make qa, make test, and make hooks targets.

Changed

  • Policy Integration: propagates through color, box mapping, progress, and animation.
  • Animation Fallback: Static print fallback for non-TTY environments.

[0.8.0] - 2025-11-30

🌈 Theme System & Gradients

Introduction of the semantic theme system and multi-color gradient engine.

Added

  • Theme Engine: Support for Primary/Secondary/Success/Error semantic mappings.
  • Predefined Themes: Monokai, Moonlight, Fire, Sunny, and Oceanic.
  • Gradient Frames: Support for border_gradient_start and border_gradient_end.

[0.7.0] - 2025-11-20

🏛️ Frame Groups & Layout

Added support for organized layouts and nested frame groups.

Added

  • FrameGroupContext: Context manager for consistent layout alignment via console.group().
  • Width Alignment: align_widths=True flag for uniform inner frames.

[0.6.0] - 2025-11-15

📏 Visual Width Refactoring

Major overhaul of text measurement logic and modularization.

Changed

  • Visual Width: Consolidated all width logic into utils/text.py.
  • Grapheme Splitting: Improved handling of complex Unicode sequences.
  • Refactoring: Split text.py into modular components for better maintainability.

[0.5.1] - 2025-11-12

🧹 Code Quality Improvements

Refinement of internal rendering logic and code quality improvements based on comprehensive code review.

Changed

  • Rendering Logic: Simplified RenderingEngine API; internal cleanup of ANSI state handling.
  • Type Safety: Improved type hints across core and utils modules.
  • Presets: Updated Dashboard preset for better visual stability on Windows terminals.

Fixed

  • Memory Leak: Fixed minor memory leak in ExportManager when handling large HTML outputs.
  • Color Parsing: Corrected rounding errors in RGB-to-Hex conversion.

[0.5.0] - 2025-11-10

📚 Documentation & Project Structure

Formalized project structure and documentation suite.

Added

  • Developer & User Guides: Initial comprehensive documentation suite in docs/.
  • CONTRIBUTING.md: Contribution guidelines.
  • DOCUMENTATION_POLICY.md: Rules for maintainable documentation.

[0.4.0] - 2025-11-05

🎬 Animation Support & BREAKING CHANGES

Initial support for animated terminal output and core architecture cleanup.

Added

  • Animation Engine: Frame-based animation with frame rate control.
  • Rainbow Cycling: Built-in cycling gradient effects.
  • Border Styles: Added ROUNDED_THICK and THICK border styles.

Changed

  • 🚨 BREAKING CHANGE: Removed deprecated FrameRenderer and Frame classes. Use Console.frame() instead.
  • Refactor: Significant reduction in cyclomatic complexity across console.py.

[0.3.0] - 2025-10-21

💪 Rich-Native Rendering

A major architectural shift to use rich natively for rendering, improving stability and compatibility.

Changed

  • Rich Integration: Replaced custom rendering logic with native rich.panel.Panel.
  • Layouts: Updated LayoutComposer for full Rich compatibility.
  • Text Alignment: Leveraged Rich's Text.align() API for perfect visual centering.

Fixed

  • ANSI Wrapping: Resolved critical ANSI wrapping bugs by leveraging Rich's internal layout engine.
  • Alignment: Fixed visual misalignment in THICK border style.

[0.1.0] - 2025-10-19

🎉 Initial Public Release

First official release of StyledConsole - production ready!

Added

  • High-Level Console API: Main Console class with frame, banner, text, and rule methods.
  • Gradient Effects: gradient_frame(), diagonal_gradient_frame(), and rainbow_frame().
  • CSS4 Color Support: Full support for 148 named CSS4 colors.
  • Banner System: Integration with pyfiglet for 120+ ASCII fonts with gradient support.
  • Layout Management: Support for stacking and side-by-side frame positioning.
  • Terminal Detection: Auto-detection of color depth and emoji safety.
  • Export Manager: Support for exporting terminal output to HTML and plain text.

Changed

  • Color Migration: Migrated all internal examples from hex codes to CSS4 names.
  • Emoji Heuristics: Initial implementation of "Tier 1" safe emoji list.