ratatui_ruby 0.7.2 → 0.7.3

data/doc/contributors/v1.0.0_blockers.md

@@ -5,13 +5,8 @@ SPDX-License-Identifier: CC-BY-SA-4.0
 
 # alignment_audit
 ## alignment_audit
-- Colors
-  - Reset (1)
-- Enums and Constants
-  - LegendPosition (4)
 - Symbol Sets
-  - Marker::HalfBlock (1)
-  - line::Set, bar::Set, block::Set, scrollbar::Set
+  - line::Set, block::Set, scrollbar::Set
 - Layout
   - Rect methods (~13)
   - Constraint batch constructors (6)
@@ -24,294 +19,12 @@ SPDX-License-Identifier: CC-BY-SA-4.0
 
 ######  MISALIGNED (non-additive, breaking)
 
-**All items fixed in v0.7.0:**
-
-- ~~Text::Line missing `style:` field~~ ✅ Added
-- ~~Widgets::Table uses `highlight_style:`~~ ✅ Renamed to `row_highlight_style:`
-
-
----
-
-
-### alignment_audit_colors
-##### v0.7.0 Alignment Audit: Colors
-
-Audit of color alignment between Ratatui/Crossterm and RatatuiRuby.
-
-> [!IMPORTANT]
-> **MISSING** = Can be added as new features, backwards-compatible.
-> **MISALIGNED** = Requires breaking changes before v1.0.0.
-
----
-
-######  Summary
-
-| Color Type | Ratatui | RatatuiRuby | Status |
-|------------|---------|-------------|--------|
-| Named colors (8 base) | ✅ | ✅ Symbols | ✅ Aligned |
-| Named colors (8 light) | ✅ | ✅ Symbols | ✅ Aligned |
-| `Reset` | ✅ | ⚠️ Not documented | MISSING |
-| `Rgb(r, g, b)` | ✅ | `"#RRGGBB"` | ✅ Aligned |
-| `Indexed(u8)` | ✅ | Integer (0-255) | ✅ Aligned |
-
----
-
-######  MISALIGNED (Breaking Changes Required)
-
-**None.** All exposed color types are correctly aligned.
-
----
-
-######  MISSING — Reset Color
-
-| Ratatui | Ruby | Status |
-|---------|------|--------|
-| `Color::Reset` | ❌ Not documented | MISSING |
-
-**Impact**: Users cannot explicitly reset foreground/background to terminal default.
-
-**Recommendation**: Document `:reset` symbol support if already implemented in Rust backend, or add support if missing.
-
----
-
-######  Aligned — Named Colors (Base)
-
-| Ratatui | Ruby Symbol |
-|---------|-------------|
-| `Color::Black` | `:black` |
-| `Color::Red` | `:red` |
-| `Color::Green` | `:green` |
-| `Color::Yellow` | `:yellow` |
-| `Color::Blue` | `:blue` |
-| `Color::Magenta` | `:magenta` |
-| `Color::Cyan` | `:cyan` |
-| `Color::Gray` | `:gray` |
-
----
-
-######  Aligned — Named Colors (Light/Bright)
-
-| Ratatui | Ruby Symbol |
-|---------|-------------|
-| `Color::DarkGray` | `:dark_gray` |
-| `Color::LightRed` | `:light_red` |
-| `Color::LightGreen` | `:light_green` |
-| `Color::LightYellow` | `:light_yellow` |
-| `Color::LightBlue` | `:light_blue` |
-| `Color::LightMagenta` | `:light_magenta` |
-| `Color::LightCyan` | `:light_cyan` |
-| `Color::White` | `:white` |
-
----
-
-######  Aligned — RGB Colors
-
-| Ratatui | Ruby |
-|---------|------|
-| `Color::Rgb(255, 0, 0)` | `"#FF0000"` |
-| `Color::Rgb(0, 255, 0)` | `"#00FF00"` |
-| `Color::Rgb(0, 0, 255)` | `"#0000FF"` |
-
-Ruby accepts hex strings in the format `"#RRGGBB"`.
-
----
-
-######  Aligned — Indexed Colors (256-color palette)
-
-| Ratatui | Ruby |
-|---------|------|
-| `Color::Indexed(0)` | `0` |
-| `Color::Indexed(42)` | `42` |
-| `Color::Indexed(255)` | `255` |
-
-Ruby accepts integers 0-255 representing the Xterm 256-color palette:
-- 0-15: Standard and bright ANSI colors
-- 16-231: 6×6×6 color cube
-- 232-255: Grayscale ramp
-
----
-
-######  Supported Modifiers
-
-Ruby supports all Ratatui style modifiers:
-
-| Ratatui | Ruby Symbol |
-|---------|-------------|
-| `Modifier::BOLD` | `:bold` |
-| `Modifier::DIM` | `:dim` |
-| `Modifier::ITALIC` | `:italic` |
-| `Modifier::UNDERLINED` | `:underlined` |
-| `Modifier::SLOW_BLINK` | `:slow_blink` |
-| `Modifier::RAPID_BLINK` | `:rapid_blink` |
-| `Modifier::REVERSED` | `:reversed` |
-| `Modifier::HIDDEN` | `:hidden` |
-| `Modifier::CROSSED_OUT` | `:crossed_out` |
-
----
-
-######  Recommendations
-
-| Priority | Item | Notes |
-|----------|------|-------|
-| Low | Document `:reset` color | May already be supported |
-
-All missing items are **additive** and do not require breaking changes.
-
-
----
-
-
-### alignment_audit_enums_constants
-##### v0.7.0 Alignment Audit: Enums and Constants
-
-Audit of enum and constant alignment between Ratatui/Crossterm and RatatuiRuby.
-
-> [!IMPORTANT]
-> **MISSING** = Can be added as new features, backwards-compatible.
-> **MISALIGNED** = Requires breaking changes before v1.0.0.
 
 ---
 
-######  Summary
-
-| Enum | Ratatui Variants | Ruby Symbols | Status |
-|------|------------------|--------------|--------|
-| `Alignment` | 3 | 3 | ✅ Aligned |
-| `BorderType` | 6 | 6+ | ✅ Aligned (Ruby adds `:hidden`) |
-| `Flex` | 6 | 6 | ✅ Aligned |
-| `HighlightSpacing` | 3 | 3 | ✅ Aligned |
-| `Borders` | 6 flags | 5 symbols | ✅ Aligned |
-| `GraphType` | 2 | 2 | ✅ Aligned |
-| `LegendPosition` | 8 | 4 | ⚠️ MISSING 4 |
-| `ListDirection` | 2 | 2 | ✅ Aligned |
-| `RenderDirection` (Sparkline) | 2 | 2 | ✅ Aligned |
-
----
-
-######  MISALIGNED (Breaking Changes Required)
-
-**None.** All exposed enum values are correctly aligned.
-
----
 
-######  MISSING — LegendPosition Variants
 
-| Ratatui | Ruby | Status |
-|---------|------|--------|
-| `TopLeft` | `:top_left` | ✅ |
-| `TopRight` | `:top_right` | ✅ |
-| `BottomLeft` | `:bottom_left` | ✅ |
-| `BottomRight` | `:bottom_right` | ✅ |
-| `Top` | ❌ | MISSING |
-| `Bottom` | ❌ | MISSING |
-| `Left` | ❌ | MISSING |
-| `Right` | ❌ | MISSING |
-
-**Impact**: Users cannot place chart legends at edge-center positions.
-
----
-
-######  Aligned Enums (Detail)
-
-######  `Alignment`
-
-| Ratatui | Ruby | Used By |
-|---------|------|---------|
-| `Left` | `:left` | Paragraph, Line, Block title |
-| `Center` | `:center` | Paragraph, Line, Block title |
-| `Right` | `:right` | Paragraph, Line, Block title |
-
----
 
-######  `BorderType`
-
-| Ratatui | Ruby | Characters |
-|---------|------|------------|
-| `Plain` | `:plain` | `┌─┐│└┘` |
-| `Rounded` | `:rounded` | `╭─╮│╰╯` |
-| `Double` | `:double` | `╔═╗║╚╝` |
-| `Thick` | `:thick` | `┏━┓┃┗┛` |
-| `QuadrantInside` | `:quadrant_inside` | `▗▄▖▐▝▘` |
-| `QuadrantOutside` | `:quadrant_outside` | `▛▀▜▌▙▟` |
-| N/A | `:hidden` | Ruby extension (spaces) |
-
----
-
-######  `Flex`
-
-| Ratatui | Ruby |
-|---------|------|
-| `Legacy` | `:legacy` |
-| `Start` | `:start` |
-| `End` | `:end` |
-| `Center` | `:center` |
-| `SpaceBetween` | `:space_between` |
-| `SpaceAround` | `:space_around` |
-
----
-
-######  `HighlightSpacing`
-
-| Ratatui | Ruby | Used By |
-|---------|------|---------|
-| `Always` | `:always` | Table, List |
-| `WhenSelected` | `:when_selected` | Table, List |
-| `Never` | `:never` | Table, List |
-
----
-
-######  `Borders` (Bitflags)
-
-| Ratatui | Ruby |
-|---------|------|
-| `NONE` | `[]` (empty array) |
-| `TOP` | `:top` |
-| `BOTTOM` | `:bottom` |
-| `LEFT` | `:left` |
-| `RIGHT` | `:right` |
-| `ALL` | `:all` |
-
-Ruby uses array of symbols: `borders: [:top, :bottom]` vs Ratatui's `Borders::TOP | Borders::BOTTOM`.
-
----
-
-######  `GraphType`
-
-| Ratatui | Ruby |
-|---------|------|
-| `Scatter` | `:scatter` |
-| `Line` | `:line` |
-
----
-
-######  `ListDirection`
-
-| Ratatui | Ruby |
-|---------|------|
-| `TopToBottom` | `:top_to_bottom` |
-| `BottomToTop` | `:bottom_to_top` |
-
----
-
-######  `RenderDirection` (Sparkline)
-
-| Ratatui | Ruby |
-|---------|------|
-| `LeftToRight` | `:left_to_right` |
-| `RightToLeft` | `:right_to_left` |
-
----
-
-######  Recommendations
-
-| Priority | Item | Notes |
-|----------|------|-------|
-| Low | Add `:top`, `:bottom`, `:left`, `:right` to `legend_position` | Edge-center legend positions |
-
-All missing items are **additive** and do not require breaking changes.
-
-
----
 
 
 ### alignment_audit_granular_level
@@ -325,29 +38,6 @@ This document audits alignment between RatatuiRuby v0.7.0 and the upstream Ratat
 
 ---
 
-######  MISALIGNED (Breaking Changes Required)
-
-These require breaking changes before v1.0.0.
-
-######  `Text::Line` — ~~Missing `style` Field~~ ✅ Fixed
-
-| Current Ruby API | Ratatui API | Status |
-|------------------|-------------|--------|
-| `Line.new(spans:, alignment:, style:)` | `Line { style, alignment, spans }` | ✅ Aligned |
-
-**Fixed in v0.7.0**: Added `style:` parameter.
-
----
-
-######  `Widgets::Table` — ~~Deprecated Parameter Name~~ ✅ Fixed
-
-| Ruby Parameter | Ratatui Parameter | Status |
-|----------------|-------------------|--------|
-| `row_highlight_style:` | `row_highlight_style` | ✅ Aligned |
-
-**Fixed in v0.7.0**: Renamed `highlight_style:` → `row_highlight_style:`.
-
----
 
 ######  MISSING — Layout Module
 
@@ -397,13 +87,6 @@ These require breaking changes before v1.0.0.
 
 ######  `Style::Style` — Missing Parameters/Methods
 
-| Missing | Ratatui API | Notes |
-|---------|-------------|-------|
-| `sub_modifier` | `style.remove_modifier(Modifier::BOLD)` | Remove specific modifiers |
-| `underline_color` | `style.underline_color(Color::Red)` | Set underline color separately |
-
----
-
 ######  MISSING — Text Module
 
 ######  `Text::Span` — Missing Methods
@@ -430,14 +113,6 @@ These require breaking changes before v1.0.0.
 
 ---
 
-######  MISSING — Widgets Module
-
-######  `Widgets::List` — Missing Parameters
-
-| Missing Parameter | Ratatui Name | Notes |
-|-------------------|--------------|-------|
-| N/A | N/A | List is fully aligned |
-
 ---
 
 ######  `Widgets::Table` — Missing Row Methods (via `Widgets::Row`)
@@ -448,109 +123,76 @@ These require breaking changes before v1.0.0.
 
 ---
 
-######  `Widgets::Gauge` — Widget Not Implemented
-
-Ratatui has `Gauge` and `LineGauge` widgets. These are not currently exposed in RatatuiRuby.
 
----
 
-######  `Widgets::Sparkline` — Missing Parameters
+######  Widget Computation Methods — Missing
 
-| Missing Parameter | Ratatui Name | Notes |
-|-------------------|--------------|-------|
-| `max` | `max` | Maximum value for scaling |
-| `bar_set` | `bar_set` | Custom bar symbols |
+These are public `&self` methods on upstream widgets that compute/query values without rendering.
 
----
+| Widget | Missing Method | Ratatui API | Notes |
+|--------|----------------|-------------|-------|
 
-######  `Widgets::Tabs` — Missing Parameters
+| `List` | `len` | `list.len()` → `usize` | Number of items in the list |
+| `List` | `is_empty` | `list.is_empty()` → `bool` | True if no items (`empty?` in Ruby) |
+| `Canvas` | `get_point` | `canvas.get_point(x, y)` → `Option<(usize, usize)>` | Map coordinates to grid cell |
 
-| Missing Parameter | Ratatui Name | Notes |
-|-------------------|--------------|-------|
-| `padding` | `padding` | Padding between tabs |
-| `divider` | `divider` | Divider between tabs |
+> [!NOTE]
+> `Paragraph#line_count(width)` and `Paragraph#line_width` ARE exposed ✓
+> `Tabs#width` IS exposed ✓
 
 ---
 
-######  `Widgets::Chart` — Fully Aligned
+######  State Navigation Methods — Missing
 
-Chart, Axis, and Dataset parameters are all aligned with Ratatui equivalents.
+ListState and TableState have navigation helpers that are not exposed.
 
----
+| State Class | Missing Method | Ratatui API | Notes |
+|-------------|----------------|-------------|-------|
+| `ListState` | `select_next` | `state.select_next()` | Move selection to next item |
+| `ListState` | `select_previous` | `state.select_previous()` | Move selection to previous item |
+| `ListState` | `select_first` | `state.select_first()` | Jump to first item |
+| `ListState` | `select_last` | `state.select_last()` | Jump to last item |
 
-######  MISSING — Event Module (Crossterm)
+| `TableState` | `selected_cell` | `state.selected_cell()` | Get (row, col) tuple |
+| `TableState` | `with_selected_cell` | `state.with_selected_cell((r,c))` | Builder pattern |
+| `TableState` | `select_next_column` | `state.select_next_column()` | Navigate columns |
+| `TableState` | `select_previous_column` | `state.select_previous_column()` | Navigate columns |
+| `TableState` | `select_first_column` | `state.select_first_column()` | Jump to first column |
+| `TableState` | `select_last_column` | `state.select_last_column()` | Jump to last column |
 
-######  `MediaKeyCode` — All Values Aligned
+---
 
-Ruby exposes all crossterm `MediaKeyCode` variants with snake_case mapping:
+######  Layout Module — Additional Missing
 
-| Crossterm | Ruby |
-|-----------|------|
-| `Play` | `:play` / `"play"` |
-| `Pause` | `:media_pause` / `"media_pause"` |
-| `PlayPause` | `:play_pause` / `"play_pause"` |
-| `Reverse` | `:reverse` / `"reverse"` |
-| `Stop` | `:stop` / `"stop"` |
-| `FastForward` | `:fast_forward` / `"fast_forward"` |
-| `Rewind` | `:rewind` / `"rewind"` |
-| `TrackNext` | `:track_next` / `"track_next"` |
-| `TrackPrevious` | `:track_previous` / `"track_previous"` |
-| `Record` | `:record` / `"record"` |
-| `LowerVolume` | `:lower_volume` / `"lower_volume"` |
-| `RaiseVolume` | `:raise_volume` / `"raise_volume"` |
-| `MuteVolume` | `:mute_volume` / `"mute_volume"` |
+| Module | Missing | Ratatui API | Notes |
+|--------|---------|-------------|-------|
+| `Rect` | `as_position` | `rect.as_position()` → `Position` | Convert to Position |
+| `Rect` | `as_size` | `rect.as_size()` → `Size` | Convert to Size |
+| `Constraint` | `apply` | `constraint.apply(length)` → `u16` | Compute constrained size |
+| `Layout` | `split_with_spacers` | `layout.split_with_spacers(area)` | Returns segments AND spacers |
 
 ---
 
-######  `ModifierKeyCode` — All Values Aligned
-
-Ruby exposes all crossterm `ModifierKeyCode` variants:
-
-| Crossterm | Ruby |
-|-----------|------|
-| `LeftShift` | `:left_shift` |
-| `LeftControl` | `:left_control` |
-| `LeftAlt` | `:left_alt` |
-| `LeftSuper` | `:left_super` |
-| `LeftHyper` | `:left_hyper` |
-| `LeftMeta` | `:left_meta` |
-| `RightShift` | `:right_shift` |
-| `RightControl` | `:right_control` |
-| `RightAlt` | `:right_alt` |
-| `RightSuper` | `:right_super` |
-| `RightHyper` | `:right_hyper` |
-| `RightMeta` | `:right_meta` |
-| `IsoLevel3Shift` | `:iso_level3_shift` |
-| `IsoLevel5Shift` | `:iso_level5_shift` |
 
----
 
-######  `KeyModifiers` — All Values Aligned
+######  Color — Missing Constructors
 
-| Crossterm | Ruby |
-|-----------|------|
-| `SHIFT` | `"shift"` |
-| `CONTROL` | `"ctrl"` |
-| `ALT` | `"alt"` |
-| `SUPER` | `"super"` |
-| `HYPER` | `"hyper"` |
-| `META` | `"meta"` |
+| Missing | Ratatui API | Notes |
+|---------|-------------|-------|
+| `from_u32` | `Color::from_u32(0xRRGGBB)` | Construct from hex integer |
+| `from_hsl` | `Color::from_hsl(hsl)` | Construct from HSL (requires palette feature) |
+| `from_hsluv` | `Color::from_hsluv(hsluv)` | Construct from HSLuv (requires palette feature) |
 
 ---
 
-######  Summary
+######  Buffer — Missing Query Methods
 
-| Category | Count | Priority |
-|----------|-------|----------|
-| **MISALIGNED** (breaking) | ~~2~~ 0 | ✅ All fixed in v0.7.0 |
-| **MISSING methods** | ~25 | Low (additive) |
-| **MISSING parameters** | ~10 | Low (additive) |
-| **MISSING widgets** | Gauge, LineGauge | Medium (new features) |
-
-######  Pre-v1.0.0 Checklist
-
-- [x] Add `style:` parameter to `Text::Line`
-- [x] Rename `highlight_style:` → `row_highlight_style:` in `Widgets::Table`
+| Missing Method | Ratatui API | Notes |
+|----------------|-------------|-------|
+| `content` | `buffer.content()` → `&[Cell]` | Get all cells as slice |
+| `get` | `buffer.get(x, y)` → `&Cell` | Get cell at position |
+| `index_of` | `buffer.index_of(x, y)` → `usize` | Position to linear index |
+| `pos_of` | `buffer.pos_of(i)` → `(u16, u16)` | Linear index to position |
 
 ---
 
@@ -564,80 +206,7 @@ This document audits strict alignment between RatatuiRuby v0.7.0 and the upstrea
 > The TUI facade API is explicitly excluded from this audit. It provides ergonomic shortcuts that intentionally diverge from Ratatui naming.
 
 ---
-
-######  Module Structure Alignment
-
-| Rust Module | Ruby Module | Status | Notes |
-|-------------|-------------|--------|-------|
-| `ratatui::layout` | `RatatuiRuby::Layout` | ✅ Aligned | Rect, Constraint, Layout |
-| `ratatui::widgets` | `RatatuiRuby::Widgets` | ✅ Aligned | All widgets |
-| `ratatui::widgets::table` | `RatatuiRuby::Widgets` | ✅ Aligned | Row, Cell in Widgets (Rust has table submodule) |
-| `ratatui::style` | `RatatuiRuby::Style` | ✅ Aligned | Style, Color support |
-| `ratatui::text` | `RatatuiRuby::Text` | ✅ Aligned | Span, Line |
-| `ratatui::buffer` | `RatatuiRuby::Buffer` | ✅ Aligned | Cell for inspection |
-
 ---
-
-######  Class-by-Class Audit
-
-######  Layout Module
-
-######  `Layout::Rect`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `x` | `u16` | `Integer` | ✅ |
-| `y` | `u16` | `Integer` | ✅ |
-| `width` | `u16` | `Integer` | ✅ |
-| `height` | `u16` | `Integer` | ✅ |
-
-| Method | Ratatui | RatatuiRuby | Status |
-|--------|---------|-------------|--------|
-| `new(x, y, width, height)` | ✅ | ✅ | ✅ Aligned |
-| `contains(position)` | ✅ | `contains?(px, py)` | ✅ Aligned (Ruby uses two args) |
-| `intersects(other)` | ✅ | `intersects?(other)` | ✅ Aligned |
-| `intersection(other)` | ✅ | ✅ | ✅ Aligned |
-| `area()` | ✅ | ❌ Missing | Gap |
-| `left()`, `right()`, `top()`, `bottom()` | ✅ | ❌ Missing | Gap (trivial: `x`, `x+width`, etc.) |
-| `union(other)` | ✅ | ❌ Missing | Gap |
-| `inner(margin)` | ✅ | ❌ Missing | Gap |
-| `offset(offset)` | ✅ | ❌ Missing | Gap |
-
-**Verdict**: Core constructor and hit-testing aligned. Additional geometric methods are gaps for future work.
-
----
-
-######  `Layout::Constraint`
-
-| Constructor | Ratatui | RatatuiRuby | Status |
-|-------------|---------|-------------|--------|
-| `Length(u16)` | ✅ | `length(v)` | ✅ Aligned |
-| `Percentage(u16)` | ✅ | `percentage(v)` | ✅ Aligned |
-| `Min(u16)` | ✅ | `min(v)` | ✅ Aligned |
-| `Max(u16)` | ✅ | `max(v)` | ✅ Aligned |
-| `Fill(u16)` | ✅ | `fill(v=1)` | ✅ Aligned |
-| `Ratio(u32, u32)` | ✅ | `ratio(num, denom)` | ✅ Aligned |
-
-| Batch Constructor | Ratatui | RatatuiRuby | Status |
-|-------------------|---------|-------------|--------|
-| `from_lengths([...])` | ✅ | ❌ Missing | Gap |
-| `from_percentages([...])` | ✅ | ❌ Missing | Gap |
-| `from_mins([...])` | ✅ | ❌ Missing | Gap |
-| `from_maxes([...])` | ✅ | ❌ Missing | Gap |
-| `from_fills([...])` | ✅ | ❌ Missing | Gap |
-| `from_ratios([...])` | ✅ | ❌ Missing | Gap |
-
-**Verdict**: All constraint variants aligned. Batch constructors are convenience gaps.
-
----
-
-######  `Layout::Layout`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `direction` | `:horizontal` / `:vertical` | `:horizontal` / `:vertical` | ✅ Aligned |
-| `constraints` | `Vec<Constraint>` | `Array<Constraint>` | ✅ Aligned |
-| `flex` | `Flex` enum | Symbol (`:start`, `:center`, etc.) | ✅ Aligned |
 | `margin` | `Margin` | ❌ Missing | Gap |
 | `spacing` | `u16` | ❌ Missing | Gap |
 
@@ -645,147 +214,6 @@ This document audits strict alignment between RatatuiRuby v0.7.0 and the upstrea
 
 ---
 
-######  Widgets Module
-
-######  `Widgets::Row`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `cells` | `Vec<Cell>` | `Array` | ✅ Aligned |
-| `style` | `Style` | `Style` | ✅ Aligned |
-| `height` | `u16` | `Integer` | ✅ Aligned |
-| `top_margin` | `u16` | `Integer` | ✅ Aligned |
-| `bottom_margin` | `u16` | `Integer` | ✅ Aligned |
-
-**Verdict**: ✅ Fully aligned.
-
----
-
-######  `Widgets::Cell`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `content` | `Text` | `String`/`Span`/`Line` | ✅ Aligned |
-| `style` | `Style` | `Style` | ✅ Aligned |
-
-**Verdict**: ✅ Fully aligned.
-
----
-
-######  `Widgets::Table`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `rows` | `Vec<Row>` | `Array` | ✅ Aligned |
-| `header` | `Option<Row>` | `Array` or `nil` | ✅ Aligned |
-| `footer` | `Option<Row>` | `Array` or `nil` | ✅ Aligned |
-| `widths` | `Vec<Constraint>` | `Array<Constraint>` | ✅ Aligned |
-| `column_spacing` | `u16` | `Integer` | ✅ Aligned |
-| `style` | `Style` | `Style` | ✅ Aligned |
-| `highlight_style` | `Style` | `Style` | ✅ Aligned |
-| `highlight_symbol` | `Option<Text>` | `String` | ✅ Aligned |
-| `selected_row` | via state | `selected_row` | ✅ Aligned |
-| `selected_column` | via state | `selected_column` | ✅ Aligned |
-| `highlight_spacing` | `HighlightSpacing` | Symbol | ✅ Aligned |
-| `flex` | `Flex` | Symbol | ✅ Aligned |
-| `offset` | via state | `offset` | ✅ Aligned |
-| `block` | `Option<Block>` | `Block` | ✅ Aligned |
-
-**Verdict**: ✅ Fully aligned.
-
----
-
-######  Style Module
-
-######  `Style::Style`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `fg` | `Option<Color>` | `Symbol`/`String`/`Integer` | ✅ Aligned |
-| `bg` | `Option<Color>` | `Symbol`/`String`/`Integer` | ✅ Aligned |
-| `add_modifier` | `Modifier` | `modifiers: Array` | ⚠️ Different API |
-| `sub_modifier` | `Modifier` | ❌ Missing | Gap |
-| `underline_color` | `Option<Color>` | ❌ Missing | Gap |
-
-**API Difference**: Ratatui uses `add_modifier(Modifier::BOLD)` and `sub_modifier()`. Ruby uses `modifiers: [:bold]` array. This is an intentional Rubyism for ergonomics while being functionally equivalent.
-
-**Verdict**: Functionally aligned with idiomatic Ruby API.
-
----
-
-######  Text Module
-
-######  `Text::Span`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `content` | `Cow<str>` | `String` | ✅ Aligned |
-| `style` | `Style` | `Style` | ✅ Aligned |
-
-| Constructor | Ratatui | RatatuiRuby | Status |
-|-------------|---------|-------------|--------|
-| `raw(content)` | ✅ | ❌ (use `new`) | Gap (trivial) |
-| `styled(content, style)` | ✅ | `styled(content, style)` | ✅ Aligned |
-
-| Method | Ratatui | RatatuiRuby | Status |
-|--------|---------|-------------|--------|
-| `width()` | ✅ | ❌ Missing | Gap |
-
-**Verdict**: Core aligned. Missing `width()` instance method and `raw()` constructor.
-
----
-
-######  `Text::Line`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `spans` | `Vec<Span>` | `Array<Span>` | ✅ Aligned |
-| `style` | `Style` | ❌ Missing | Gap |
-| `alignment` | `Option<Alignment>` | `alignment` | ✅ Aligned |
-
-| Method | Ratatui | RatatuiRuby | Status |
-|--------|---------|-------------|--------|
-| `width()` | ✅ | ✅ | ✅ Aligned |
-| `left_aligned()` | ✅ | ❌ (use constructor) | Gap |
-| `centered()` | ✅ | ❌ (use constructor) | Gap |
-| `right_aligned()` | ✅ | ❌ (use constructor) | Gap |
-
-**Verdict**: Core aligned. Missing `style` field on Line (Ratatui has line-level style separate from span styles).
-
----
-
-######  Buffer Module
-
-######  `Buffer::Cell`
-
-| Attribute | Ratatui | RatatuiRuby | Status |
-|-----------|---------|-------------|--------|
-| `char` / `symbol` | `String` | `char` | ✅ Aligned |
-| `fg` | `Color` | `Symbol`/`String`/`Integer` | ✅ Aligned |
-| `bg` | `Color` | `Symbol`/`String`/`Integer` | ✅ Aligned |
-| `modifiers` | `Modifier` | `Array<Symbol>` | ⚠️ Ruby array vs Rust bitflags |
-
-**Verdict**: ✅ Aligned (read-only inspection).
-
----
-
-######  Summary
-
-######  Fully Aligned ✅
-
-- **Module structure**: All 5 modules map correctly
-- **Widgets::Row**: All 5 attributes aligned
-- **Widgets::Cell**: Both attributes aligned  
-- **Widgets::Table**: All major attributes aligned
-- **Layout::Constraint**: All 6 variants aligned
-- **Layout::Rect**: Constructor and hit-testing aligned
-
-######  Intentional Ruby Idioms ⚠️
-
-These are **not misalignments**. They are deliberate API choices that provide functional equivalence with idiomatic Ruby patterns:
-
-- **Style modifiers**: Array `[:bold, :italic]` vs Rust's `add_modifier(BOLD | ITALIC)`
-- **Buffer::Cell modifiers**: Same array-based approach
 
 ---
 
@@ -810,105 +238,23 @@ These are gaps that can be filled in future minor releases without breaking exis
 | `Span` | `raw()` constructor | New class method (alias for `new`) |
 | `Line` | `left_aligned()`, `centered()`, `right_aligned()` | New instance methods (fluent) |
 
-######  MISALIGNED Structure (Breaking Changes Required) ⚠️
-
-> [!CAUTION]
-> These gaps represent **structural misalignment** where the current API shape differs from Ratatui in a way that cannot be fixed without breaking changes. **Must be addressed before v1.0.0.**
-
-| Component | Current API | Ratatui API | Required Change |
-|-----------|-------------|-------------|-----------------|
-| `Text::Line` | No `style` field | Has `style: Style` | Add `style:` parameter to `Line.new()` |
-
-**Details:**
-
-######  `Text::Line` Missing `style` Field
-
-Ratatui's `Line` has three fields:
-```rust
-pub struct Line<'a> {
-    pub style: Style,        // ← Missing in Ruby
-    pub alignment: Option<Alignment>,
-    pub spans: Vec<Span<'a>>,
-}
-```
-
-Ruby's `Line` has only two:
-```ruby
-class Line < Data.define(:spans, :alignment)
-```
-
-**Impact**: Users cannot set a line-level style that applies uniformly across all spans. They must either:
-1. Apply the same style to every span manually, or
-2. Wrap the line in a styled container
-
-**Required Fix**: Add `style:` parameter to `Line.new()`. This is a **breaking change** because:
-- Positional argument order changes (if used positionally)
-- `Data.define` member list changes
-
-**Recommendation**: Fix in v0.8.0 or earlier, before v1.0.0 API freeze.
-
----
-
-######  Conclusion
-
-The v0.7.0 namespace restructuring achieves **strict alignment** with Ratatui's module hierarchy as specified in the design principles. All new types (`Widgets::Row`, `Widgets::Cell`, `Buffer::Cell`) follow the established pattern.
-
-######  Release Guidance
-
-| Category | Count | Action |
-|----------|-------|--------|
-| **Fully Aligned** | 6 components | ✅ No action needed |
-| **Intentional Idioms** | 2 items | ✅ Document as Ruby conventions |
-| **MISSING (additive)** | 14 features | 📋 Add in future minor releases |
-| **MISALIGNED (breaking)** | 1 issue | ⚠️ **Must fix before v1.0.0** |
-
-The single misalignment (`Text::Line` missing `style` field) is the only blocking issue for v1.0.0 API stability. All other gaps are additive and can be addressed incrementally.
-
----
 
 
 ### alignment_audit_symbol_sets
-##### v0.7.0 Alignment Audit: Symbol Sets
-
 Audit of symbol set alignment between Ratatui's `symbols::` module and RatatuiRuby.
 
 > [!IMPORTANT]
 > **MISSING** = Can be added as new features, backwards-compatible.
 > **MISALIGNED** = Requires breaking changes before v1.0.0.
 
----
-
-######  Summary
-
-| Symbol Category | Ratatui | RatatuiRuby | Status |
-|-----------------|---------|-------------|--------|
-| `Marker` enum | 5 variants | 4 exposed | ⚠️ MISSING 1 |
-| `border::Set` | 12 predefined sets | Via `border_type:` symbols | ✅ Aligned |
-| Custom `border::Set` | Custom struct | Via `border_set:` hash | ✅ Aligned |
-| `line::Set` | 4 predefined sets | ❌ Not exposed | MISSING |
-| `bar::Set` | 2 predefined sets | ❌ Not exposed | MISSING |
-| `block::Set` | 2 predefined sets | ❌ Not exposed | MISSING |
 | `scrollbar::Set` | 4 predefined sets | ❌ Not exposed | MISSING |
 | `shade` constants | 5 constants | ❌ Not exposed | MISSING |
 
----
-
-######  MISALIGNED (Breaking Changes Required)
-
-**None.** All exposed symbol sets are correctly aligned.
-
----
 
 ######  MISSING — Marker Enum
 
 ######  `Marker::HalfBlock`
 
-| Ratatui | RatatuiRuby | Status |
-|---------|-------------|--------|
-| `Marker::Dot` | `:dot` | ✅ |
-| `Marker::Block` | `:block` | ✅ |
-| `Marker::Bar` | `:bar` | ✅ |
-| `Marker::Braille` | `:braille` | ✅ |
 | `Marker::HalfBlock` | ❌ Not exposed | MISSING |
 
 **Impact**: Users cannot use the `HalfBlock` marker type, which provides double-resolution square pixels using `█`, `▄`, and `▀` characters.
@@ -966,46 +312,7 @@ Ratatui provides `symbols::shade` constants:
 - `LIGHT` — `░`
 - `MEDIUM` — `▒`
 - `DARK` — `▓`
-- `FULL` — `█`
-
-**Ruby Status**: Not exposed as constants.
-
----
-
-######  Currently Aligned
-
-######  `border_type:` Parameter
-
-Ruby's `Block.new(border_type:)` maps to Ratatui's `border::Set`:
-
-| Ruby Symbol | Ratatui Constant | Characters |
-|-------------|------------------|------------|
-| `:plain` | `border::PLAIN` | `┌─┐│└┘` |
-| `:rounded` | `border::ROUNDED` | `╭─╮│╰╯` |
-| `:double` | `border::DOUBLE` | `╔═╗║╚╝` |
-| `:thick` | `border::THICK` | `┏━┓┃┗┛` |
-| `:quadrant_outside` | `border::QUADRANT_OUTSIDE` | `▛▀▜▌▙▟` |
-| `:quadrant_inside` | `border::QUADRANT_INSIDE` | `▗▄▖▐▝▘` |
-| `:hidden` | ❌ Custom Ruby | Empty borders (spaces) |
-
-######  `border_set:` Parameter
-
-Ruby supports custom border characters via hash:
-
-```ruby
-Block.new(border_set: {
-  top_left: "╭",
-  top_right: "╮",
-  bottom_left: "╰",
-  bottom_right: "╯",
-  vertical_left: "│",
-  vertical_right: "│",
-  horizontal_top: "─",
-  horizontal_bottom: "─"
-})
-```
 
-This is functionally equivalent to Ratatui's custom `border::Set`.
 
 ---