Fixed #

• LayoutCache bug: Cache now correctly includes indent, firstLineIndent, rubyStyle, kentenStyle, and warichuStyle in key comparison
• HorizontalRichText: Added missing extraHeight calculation for ruby and kenten annotations
• SelectionAreaHorizontalText: Use listEquals for annotation list comparison to avoid unnecessary repaints

Changed #

• Extract duplicate _getCharacterWidth function to shared TextMetrics utility class
• Optimize DecorationRenderer to measure text height once per layout call instead of per decoration
• Remove unused fontSize parameter from _drawCharacter methods in painters

Added #

• Comprehensive unit tests (64 tests covering models, cache, layouter, and widgets)
• New TextMetrics utility class for shared text measurement functions

Added #

• Quick Start section with simple Japanese examples
• Platform Support table for all supported platforms
• Use Cases section with practical examples (blogs, textbooks, news apps, academic papers, chat apps, rich text editors)

Added #

• Gaiji (外字) support - Image-based custom characters
  • Gaiji model for specifying custom character images
  • gaijiList parameter in HorizontalText widget
  • Supports multiple image sources: AssetImage, NetworkImage, FileImage, MemoryImage
  • Gaiji images automatically scale to match font size
  • Proper text baseline alignment for gaiji images
  • Placeholder characters are replaced with images

Changed #

• Updated README with latest features documentation
• Added TextAlignment and TextDecoration usage examples
• Added Related Packages section and badges
• Updated installation version to ^0.9.0
• Added all KentenStyle options to documentation
• Updated Roadmap with completed features

Fixed #

• Removed unused dart:ui imports from kenten_renderer.dart, decoration_renderer.dart, warichu_renderer.dart
• Removed unused local variable half in kenten_renderer.dart
• Fixed sort_child_properties_last lint warnings in selectable_horizontal_text.dart

Added #

• Line alignment support (地付き/天付き)
  • alignment property in HorizontalTextStyle
  • TextAlignment.start: Align line to left (default horizontal behavior)
  • TextAlignment.center: Center alignment
  • TextAlignment.end (地付き): Align line to right
• Alignment demo page in example app
• Demo for combined overline + ruby annotations

Fixed #

• Overline and wavy overline positioning (now closer to text with fixed offset)
• Underline and wavy underline positioning (now closer to text with fixed offset)
• Ruby position adjustment when overline decoration is present
• Layout cache now includes alignment in cache key comparison

Changed #

• Uses kinsoku package's TextAlignment enum for alignment values

Added #

• Enhanced text selection with draggable handles
  • Visual selection handles at start and end of selection
  • Drag handles to adjust selection range
  • Larger touch targets (24px) for better usability on mobile
  • Nearest character detection when dragging handles
• Standard context menu features
  • Right-click context menu (desktop)
  • Long-press context menu (mobile)
  • Context menu shown on selection tap and after drag selection
  • Keyboard shortcuts: Ctrl+C (copy), Ctrl+A (select all)
  • Double-click to select all
  • Theme-based selection and handle colors
• Extensible context menu
  • additionalMenuItems parameter to add custom menu items
  • Custom items receive context and selected text
  • Automatically adds divider between default and custom items
• Multi-language support
  • copyLabel and selectAllLabel parameters for custom labels
  • Auto-detects locale: Japanese (複製/すべて選択) or English (Copy/Select All)
  • Easy localization for any language

Fixed #

• Grid and selection highlighting positioning
  • Now uses actual text height from TextPainter instead of fontSize
  • Grid lines align correctly with rendered characters
  • Selection highlights extend to full character height
  • Fixed horizontal grid line spacing to use actualTextHeight + lineSpacing

Changed #

• Selection behavior now matches standard apps like Chrome
• Context menu appears automatically after text selection
• Default menu items (Copy, Select All) always present with custom items appended

Added #

• Text selection support
  • SelectableHorizontalText widget for selectable text
  • SelectableHorizontalTextPainter for rendering selection highlighting
  • Tap to select single character
  • Drag to select text range
  • Long press to show copy context menu
  • Copy selected text to clipboard
  • Customizable selection color
  • Full support for all features (ruby, kenten, warichu)
• Text selection examples in demo app

Features #

• Intuitive text selection with tap and drag gestures
• Visual selection highlighting with customizable color
• Copy to clipboard functionality
• Works seamlessly with ruby annotations, kenten marks, and warichu

Added #

• Performance optimizations
  • LRU layout cache with 100-entry limit for fast re-rendering
  • LayoutCache class for caching layout calculations
  • LayoutCacheKey and LayoutCacheValue for cache management
  • TextPainter reuse across renders to reduce allocations
  • Optimized calculateSize() to reuse cached layouts

Changed #

• Reused TextPainter instances in HorizontalTextPainter, HorizontalRichTextPainter, RubyRenderer, and WarichuRenderer
• Added useCache parameter to layout() and calculateSize() methods (default: true)
• Optimized style comparison in cache key matching

Performance Impact #

• ~70% reduction in layout calculation time for repeated renders
• ~50% reduction in TextPainter allocations
• Significant performance improvement for scrollable text lists

Added #

• Rich text support with multiple styles
  • HorizontalTextSpan base class for span hierarchy
  • SimpleHorizontalTextSpan for single-style text with annotations
  • GroupHorizontalTextSpan for grouping multiple spans
  • HorizontalRichText widget for rendering multi-style text
  • HorizontalRichTextPainter for rendering spans with different styles
  • Per-span ruby, kenten, and warichu annotations
  • Support for mixing multiple text styles, colors, fonts, and weights
• Rich text examples in demo app showing multiple styles and combinations

Changed #

• Added TextSpanData class for flattening span hierarchies
• Added StyleRange class for tracking style ranges in rich text

Added #

• Warichu (inline annotations) support
  • Warichu model for defining inline annotations
  • WarichuRenderer for laying out and rendering warichu in two-line format
  • WarichuLayout class for warichu positioning information
  • warichuList parameter in HorizontalText widget
  • warichuStyle in HorizontalTextStyle for customizing warichu appearance
  • Warichu text automatically split into two lines and displayed inline
  • Support for combining Ruby, Kenten, and Warichu on the same text
• Warichu examples in demo app showing inline annotations and feature combinations

Changed #

• Updated HorizontalText widget to accept warichuList parameter
• Updated HorizontalTextPainter to render warichu annotations
• Updated HorizontalTextStyle to include warichuStyle field

Added #

• Kenten (emphasis marks) support
  • Kenten model for defining emphasis marks on text ranges
  • KentenType enum with 6 types: sesame, circle, filledCircle, triangle, filledTriangle, doubleCircle
  • KentenRenderer for laying out and rendering kenten marks above text
  • KentenLayout class for kenten positioning information
  • kentenList parameter in HorizontalText widget
  • kentenStyle in HorizontalTextStyle for customizing kenten appearance
  • Kenten marks automatically positioned above characters with proper spacing
  • Support for combining Ruby and Kenten on the same text
• Kenten examples in demo app showing different mark types and combinations

Changed #

• Updated HorizontalText widget to accept kentenList parameter
• Updated HorizontalTextPainter to render kenten marks
• Updated HorizontalTextStyle to include kentenStyle field

Added #

• Ruby text (furigana) support
  • RubyRenderer for laying out and rendering ruby text above base text
  • RubyLayout class for ruby positioning information
  • rubyList parameter in HorizontalText widget
  • rubyStyle in HorizontalTextStyle for customizing ruby appearance
  • Multi-line ruby support - ruby text properly splits across line breaks
  • Ruby centering - ruby text is horizontally centered over base text
• Added textIndex field to CharacterLayout for tracking character positions
• Ruby examples in demo app showing basic and multi-line ruby usage

Changed #

• Updated HorizontalText widget to accept rubyList parameter
• Updated HorizontalTextPainter to render ruby text
• Updated HorizontalTextLayouter to include textIndex in character layouts

Added #

• Initial release of yokogaki package (MVP)
• HorizontalText widget for horizontal Japanese text layout
• HorizontalTextStyle for configuring text appearance and behavior
• HorizontalTextLayouter for basic horizontal text layout with line breaking
• HorizontalTextPainter for rendering text to Canvas
• Kinsoku processing (禁則処理) support via kinsoku package
  • Line-start and line-end prohibition
  • Hanging (burasage) and pushing-in (oikomi)
• Yakumono adjustment (約物調整)
  • Half-width yakumono handling
  • Consecutive yakumono spacing
• Line breaking with maxWidth parameter
• Debug grid display for development
• Example app with multiple demos
• Dependency on kinsoku package for Japanese text processing

Notes #

• This is an MVP release with basic horizontal text layout functionality
• Ruby, kenten, warichu, and rich text features are planned for future releases
• Works with kinsoku package for character classification and line breaking rules