From de6b0910635f7f893b1102aadafddaa818cc9cd0 Mon Sep 17 00:00:00 2001
From: Ivan Kostiashov <onlyno21@gmail.com>
Date: Thu, 5 Feb 2026 19:43:19 +0300
Subject: [PATCH] feat(tui-big-text): add support for wrapping BigText in a
 Block widget

---
 Cargo.lock                   |  1 +
 tui-big-text/Cargo.toml      |  1 +
 tui-big-text/src/big_text.rs | 35 ++++++++++++++++++++++++++++++++++-
 3 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/Cargo.lock b/Cargo.lock
index 7113def..c592899 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -2093,6 +2093,7 @@ dependencies = [
  "itertools",
  "ratatui",
  "ratatui-core",
+ "ratatui-widgets",
  "strum",
  "tokio",
 ]
diff --git a/tui-big-text/Cargo.toml b/tui-big-text/Cargo.toml
index 8e5ba6a..50a9c40 100644
--- a/tui-big-text/Cargo.toml
+++ b/tui-big-text/Cargo.toml
@@ -17,6 +17,7 @@ derive_builder.workspace = true
 font8x8 = { version = "0.3.1", default-features = false, features = ["unicode"] }
 itertools.workspace = true
 ratatui-core.workspace = true
+ratatui-widgets.workspace = true
 
 [dev-dependencies]
 color-eyre.workspace = true
diff --git a/tui-big-text/src/big_text.rs b/tui-big-text/src/big_text.rs
index 4c35dfa..3b2712a 100644
--- a/tui-big-text/src/big_text.rs
+++ b/tui-big-text/src/big_text.rs
@@ -9,6 +9,7 @@ use ratatui_core::layout::{Alignment, Rect};
 use ratatui_core::style::Style;
 use ratatui_core::text::{Line, StyledGrapheme};
 use ratatui_core::widgets::Widget;
+use ratatui_widgets::block::{Block, BlockExt};
 
 use crate::PixelSize;
 
@@ -84,6 +85,10 @@ pub struct BigText<'a> {
     /// Defaults to `Alignment::default()` (=> Alignment::Left)
     #[builder(default)]
     pub alignment: Alignment,
+
+    /// Block to wrap the widget in
+    #[builder(default, setter(into, strip_option))]
+    pub block: Option<Block<'a>>,
 }
 
 impl BigText<'static> {
@@ -118,13 +123,17 @@ impl<'a> BigTextBuilder<'a> {
             style: self.style.unwrap_or_default(),
             pixel_size: self.pixel_size.unwrap_or_default(),
             alignment: self.alignment.unwrap_or_default(),
+            block: self.block.as_ref().cloned().unwrap_or_default(),
         }
     }
 }
 
 impl Widget for BigText<'_> {
     fn render(self, area: Rect, buf: &mut Buffer) {
-        let layout = layout(area, &self.pixel_size, self.alignment, &self.lines);
+        self.block.as_ref().render(area, buf);
+        let inner = self.block.inner_if_some(area);
+
+        let layout = layout(inner, &self.pixel_size, self.alignment, &self.lines);
         for (line, line_layout) in self.lines.iter().zip(layout) {
             for (g, cell) in line.styled_graphemes(self.style).zip(line_layout) {
                 render_symbol(g, cell, buf, &self.pixel_size);
@@ -223,6 +232,7 @@ mod tests {
                 style,
                 pixel_size,
                 alignment,
+                block: None,
             }
         );
     }
@@ -1135,4 +1145,27 @@ mod tests {
         ]);
         assert_eq!(buf, expected);
     }
+
+    #[test]
+    fn render_with_block() {
+        let big_text = BigText::builder()
+            .lines(vec![Line::from("In Block")])
+            .block(Block::bordered().title("Big Text Block"))
+            .build();
+        let mut buf = Buffer::empty(Rect::new(0, 0, 65, 10));
+        big_text.render(buf.area, &mut buf);
+        let expected = Buffer::with_lines(vec![
+            "┌Big Text Block─────────────────────────────────────────────────┐",
+            "│ ████                   ██████   ███                    ███    │",
+            "│  ██                     ██  ██   ██                     ██    │",
+            "│  ██    █████            ██  ██   ██     ████    ████    ██  ██│",
+            "│  ██    ██  ██           █████    ██    ██  ██  ██  ██   ██ ██ │",
+            "│  ██    ██  ██           ██  ██   ██    ██  ██  ██       ████  │",
+            "│  ██    ██  ██           ██  ██   ██    ██  ██  ██  ██   ██ ██ │",
+            "│ ████   ██  ██          ██████   ████    ████    ████   ███  ██│",
+            "│                                                               │",
+            "└───────────────────────────────────────────────────────────────┘",
+        ]);
+        assert_eq!(buf, expected);
+    }
 }