feat(fact_image): add Bengali text auto-detection and font support

.gitattributes

@@ -1 +1,2 @@
 *.mp3 filter=lfs diff=lfs merge=lfs -text
+*.ttf filter=lfs diff=lfs merge=lfs -text

modules/fact_image/services/text_overlay.py

@@ -5,6 +5,7 @@ Supports heading with background + fact text with shadow
 """
 import logging
 import re
+import unicodedata
 from pathlib import Path
 from typing import Tuple, Optional, Dict, Any
 from PIL import Image, ImageDraw, ImageFont
@@ -38,6 +39,9 @@ class TextOverlay:
     TEXT_TOP_PERCENT = 0.45  # Fact text starts at 45% from top
     GAP_HEADING_TEXT = 60  # Gap between heading and fact text (fallback)
     
+    # Path to Bengali font (bundled in static/fonts/)
+    BENGALI_FONT = Path(__file__).parent.parent.parent.parent / "static" / "fonts" / "Bangla_Unicode.ttf"
+    
     def __init__(self, font_path: Optional[str] = None):
         """
         Initialize text overlay service.
@@ -48,15 +52,33 @@ class TextOverlay:
         self.font_path = font_path
         self._font_cache = {}
     
-    def _get_font(self, size: int, bold: bool = False) -> ImageFont.FreeTypeFont:
-        """Get font at specified size (cached)"""
-        cache_key = (size, bold)
+    @staticmethod
+    def _has_bengali(text: str) -> bool:
+        """
+        Check if text contains any Bengali script characters.
+        Bengali Unicode range: U+0980 - U+09FF
+        Auto-detects — works for pure Bengali, pure English, or mixed.
+        """
+        if not text:
+            return False
+        for ch in text:
+            if '\u0980' <= ch <= '\u09FF':
+                return True
+        return False
+    
+    def _get_font(self, size: int, bold: bool = False, bengali: bool = False) -> ImageFont.FreeTypeFont:
+        """Get font at specified size (cached). Uses Bengali font when bengali=True."""
+        cache_key = (size, bold, bengali)
         if cache_key not in self._font_cache:
             try:
-                if self.font_path and Path(self.font_path).exists():
+                # Bengali font path
+                if bengali and self.BENGALI_FONT.exists():
+                    self._font_cache[cache_key] = ImageFont.truetype(str(self.BENGALI_FONT), size)
+                    logger.debug(f"Loaded Bengali font at size {size}")
+                elif self.font_path and Path(self.font_path).exists():
                     self._font_cache[cache_key] = ImageFont.truetype(self.font_path, size)
                 else:
-                    # Try common system fonts
+                    # Try common system fonts (Latin)
                     if bold:
                         font_names = ['DejaVuSans-Bold.ttf', 'Arial-Bold.ttf', 'Roboto-Bold.ttf', 'FreeSansBold.ttf']
                     else:
@@ -174,7 +196,12 @@ class TextOverlay:
         Returns:
             Path to output image
         """
-        logger.info(f"Adding text overlay: heading='{heading}', text='{text[:30]}...'")
+        # Detect Bengali INDEPENDENTLY for heading and text
+        # So any combination works: BN heading + EN text, EN heading + BN text, etc.
+        heading_is_bengali = self._has_bengali(heading or "")
+        text_is_bengali = self._has_bengali(text)
+        
+        logger.info(f"Adding text overlay: heading='{heading}' (bn={heading_is_bengali}), text='{text[:30]}...' (bn={text_is_bengali})")
         
         # Load image
         img = Image.open(image_path).convert('RGBA')
@@ -218,9 +245,9 @@ class TextOverlay:
         else:
             text_font_size = 32  # Minimum for very long text
         
-        # Get fonts with dynamic sizes (both bold)
-        heading_font = self._get_font(heading_font_size, bold=True)
-        text_font = self._get_font(text_font_size, bold=True)
+        # Get fonts — each uses its OWN Bengali detection
+        heading_font = self._get_font(heading_font_size, bold=True, bengali=heading_is_bengali)
+        text_font = self._get_font(text_font_size, bold=True, bengali=text_is_bengali)
         
         # Word wrap text with dynamic font to fit max_width
         words = text.split()
@@ -272,7 +299,8 @@ class TextOverlay:
         
         # Draw heading with background (UPPERCASE)
         if heading:
-            heading_upper = heading.upper()  # Convert to UPPERCASE
+            # Bengali has no uppercase — skip .upper() for Bengali text
+            heading_upper = heading if self._has_bengali(heading) else heading.upper()
             # Get text bounding box - returns (left, top, right, bottom)
             heading_bbox = draw.textbbox((0, 0), heading_upper, font=heading_font)
             # The bbox includes font metrics offset

static/fonts/Bangla_Italic.ttf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:245fa5d1b454f0fd63033f9d9893190edca4b82787fac569151b79326ca25ec7
+size 116468

static/fonts/Bangla_Unicode.ttf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:33a515c00aff1bfd401614cc60df1f383bd6fd3733d0fcbaba1b63f4d69f8f71
+size 112140