prawn_hebrew 0.0.5 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad2256a5c7e53cc0b335bce5f5284ad3d33372d8580239c83283a4ab2542796c
-  data.tar.gz: 4464fb1beb01533773a6eb1969455c539af02619fb6e4153d93a3682ca988121
+  metadata.gz: 2d1ef260d0ff7646b39769526d9c62e7b218213c0984566510a98255d9457939
+  data.tar.gz: 9ed590c393eeb60137e41a0d2f354513f001f07049d27964c2708acd8c0aa437
 SHA512:
-  metadata.gz: fd4e466a35cdfa7d047419c0b49e08b6fb0b16dce0a1e36649f9245ed645ce81bbfefd5fb6783e7a0c0d5497d3af4086c7488c6925ffabd73db7524156d9c21f
-  data.tar.gz: 7268788094ed4044b2b4621bfa3598a0bf3eb6fd5e8bfa8105b752fa41a9be764625dee7be864407db8f4444fc36633188e80cbe2873f016ca2bb0ac5e06238f
+  metadata.gz: ad3ab20f48d5d3240b53772ef58da9753ea42f1efa30fba7bee40dcfe23ad1988d4d913160385a7f09097eeae45710d2cb6ef85278586e060bfea2c3aa709539
+  data.tar.gz: 83933c5108021e9c0d3c8b3c483220ab31640401b49af8332803bfac48d184ac0612251ef8c5638dc8f0620ec99c50fa6a31d8ab291860dafea4bd4943fd80c2

data/lib/prawn_hebrew.rb

@@ -4,19 +4,21 @@ require_relative 'version'
 module PrawnHebrew
   module Text
     DEFAULT_HEBREW_FONT = 'GveretLevinHebrew'.freeze
-    DEFAULT_ENGLISH_FONT = 'Arial'.freeze
+    DEFAULT_ENGLISH_FONT = 'Helvetica'.freeze
+    
+    # Set to true for debugging which text rendering path is used
+    DEBUG_MODE = false
 
-    # Returns array of text fragments for Prawn's formatted_text methods
-    # Example:
-    #   formatted_text_box hebrew_formatted_text('שלום world'), at: [0,100]
     def hebrew_formatted_text(text, size: 12, style: :normal, hebrew_font: DEFAULT_HEBREW_FONT, english_font: DEFAULT_ENGLISH_FONT)
       words = text.to_s.split(/(\s+|\n)/)
       hebrew_run = []
       fragments = []
+      
+      styles = style.is_a?(Array) ? style : [style].compact
 
       words.each do |word|
         if word.strip.empty?
-          fragments << { text: word, font: english_font, size: size, style: style } if word != ' '
+          fragments << { text: word, font: english_font, size: size, styles: styles } if word != ' '
           next
         end
 
@@ -25,34 +27,89 @@ module PrawnHebrew
         else
           unless hebrew_run.empty?
             hebrew_run.reverse.each_with_index do |hw, idx|
-              fragments << { text: hw, font: hebrew_font, size: size, direction: :rtl, style: style }
-              fragments << { text: ' ', font: hebrew_font, size: size, direction: :rtl, style: style } if idx < hebrew_run.length - 1
+              fragments << { text: hw, font: hebrew_font, size: size, direction: :rtl, styles: styles }
+              fragments << { text: ' ', font: hebrew_font, size: size, direction: :rtl, styles: styles } if idx < hebrew_run.length - 1
             end
             fragments << { text: ' ' }
             hebrew_run.clear
           end
-          fragments << { text: "#{word} ", font: english_font, size: size, style: style }
+          fragments << { text: "#{word} ", font: english_font, size: size, styles: styles }
         end
       end
 
       unless hebrew_run.empty?
         hebrew_run.reverse.each_with_index do |hw, idx|
-          fragments << { text: hw, font: hebrew_font, size: size, direction: :rtl, style: style }
-          fragments << { text: ' ', font: hebrew_font, size: size, direction: :rtl, style: style } if idx < hebrew_run.length - 1
+          fragments << { text: hw, font: hebrew_font, size: size, direction: :rtl, styles: styles }
+          fragments << { text: ' ', font: hebrew_font, size: size, direction: :rtl, styles: styles } if idx < hebrew_run.length - 1
         end
       end
-
       fragments
     end
 
-    # Helper combining hebrew_formatted_text with formatted_text_box
     def hebrew_text_box(text, size: 12, style: :normal,
                         hebrew_font: DEFAULT_HEBREW_FONT,
-                        english_font: DEFAULT_ENGLISH_FONT, **box_opts)
-      fragments = hebrew_formatted_text(text, size: size, style: style,
-                                        hebrew_font: hebrew_font,
-                                        english_font: english_font)
-      formatted_text_box(fragments, box_opts)
+                        english_font: DEFAULT_ENGLISH_FONT,
+                        direction: :auto, **box_opts)
+      
+      # Handle font specification in box_opts or use defaults
+      final_hebrew_font = box_opts.delete(:hebrew_font) || hebrew_font
+      final_english_font = box_opts.delete(:english_font) || english_font
+      final_size = box_opts.delete(:size) || size
+      rotation = box_opts.delete(:rotate) || 0
+      char_spacing = box_opts.delete(:character_spacing) || 0
+      leading = box_opts.delete(:leading) || 0
+      
+      # Check if text contains Hebrew characters
+      contains_hebrew = text.to_s =~ /\p{Hebrew}/
+      
+      # If direction is auto, determine based on content
+      if direction == :auto
+        direction = contains_hebrew ? :rtl : :ltr
+      end
+      
+      # For completely English text (no Hebrew characters and LTR direction), 
+      # use standard Prawn text_box for better performance and compatibility
+      if !contains_hebrew && direction == :ltr
+        render_english_only_text(text, final_size, style, final_english_font, 
+                                 rotation, char_spacing, leading, box_opts)
+      else
+        # For Hebrew text or RTL direction, use formatted text approach
+        if rotation != 0
+          rotate(rotation, origin: box_opts[:at] || [0, 0]) do
+            render_hebrew_text_content(text, contains_hebrew, direction, final_size, style, 
+                               final_hebrew_font, final_english_font, char_spacing, leading, box_opts)
+          end
+        else
+          render_hebrew_text_content(text, contains_hebrew, direction, final_size, style, 
+                             final_hebrew_font, final_english_font, char_spacing, leading, box_opts)
+        end
+      end
+    end
+    
+    private
+    
+    # Render pure English text using standard Prawn text_box for optimal performance
+    def render_english_only_text(text, final_size, style, final_english_font, 
+                                 rotation, char_spacing, leading, box_opts)
+          font(final_english_font) do
+            text_box(text.to_s, { size: final_size, style: style }.merge(box_opts))
+          end
+    end
+    
+    # Render Hebrew text or mixed text using formatted text approach
+    def render_hebrew_text_content(text, contains_hebrew, direction, final_size, style, 
+                           final_hebrew_font, final_english_font, char_spacing, leading, box_opts)
+      # Apply character spacing and leading if specified
+      character_spacing(char_spacing) do
+        fragments = hebrew_formatted_text(text, size: final_size, style: style,
+                                          hebrew_font: final_hebrew_font,
+                                          english_font: final_english_font)
+        
+        # Add leading to box_opts if specified
+        box_opts[:leading] = leading if leading > 0
+        
+        formatted_text_box(fragments, box_opts)
+      end
     end
   end
 end

data/lib/version.rb

@@ -1,3 +1,3 @@
-module PrawnHebrew
-  VERSION = "0.0.1"
-end
+module PrawnHebrew
+  VERSION = "0.0.7"
+end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: prawn_hebrew
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.7
 platform: ruby
 authors:
 - Ben Lite
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-06-19 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Working with hebrew words in prawn
-email: benlite96@gmail.com
+email:
+- benlite96@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -22,7 +22,6 @@ homepage: https://rubygems.org/gems/prawn_hebrew
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -37,8 +36,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Hebrew Text in Prawn
 test_files: []