By EbraSha

Author: ebrasha

README.fa.md

@@ -80,7 +80,7 @@ composer require abdal/phpian-render
 ```json
 {
     "require": {
-        "abdal/phpian-render": "^1.0"
+        "abdal/phpian-render": "^1.1"
     }
 }
 ```
@@ -216,6 +216,40 @@ if (!$renderer->isRTL($text2)) {
 }
 ```
 
+### استفاده از Static Methods (بدون نیاز به ایجاد نمونه)
+
+```php
+<?php
+
+use Abdal\PhpianRender\PhpianRender;
+
+// استفاده از متدهای static بدون نیاز به ایجاد نمونه
+$text = 'سلام دنیا';
+
+// پردازش کامل
+$processed = PhpianRender::processStatic($text, [
+    'reshape' => true,
+    'bidi' => true,
+    'convertNumbers' => true,
+]);
+
+// Reshape
+$reshaped = PhpianRender::reshapeStatic($text);
+
+// تبدیل اعداد
+$converted = PhpianRender::convertNumbersStatic('عدد 123', 'persian');
+
+// تشخیص RTL
+$isRTL = PhpianRender::isRTLStatic($text);
+
+// Word Wrap
+$wrapped = PhpianRender::wordWrapStatic('متن طولانی', 20);
+
+// دریافت نسخه پکیج
+$version = PhpianRender::getVersion();
+echo "Version: $version";
+```
+
 ### استفاده از کلاس‌های مستقل
 
 ```php

README.md

@@ -80,7 +80,7 @@ Or add to `composer.json`:
 ```json
 {
     "require": {
-        "abdal/phpian-render": "^1.0"
+        "abdal/phpian-render": "^1.1"
     }
 }
 ```
@@ -216,6 +216,40 @@ if (!$renderer->isRTL($text2)) {
 }
 ```
 
+### Using Static Methods (No Instance Required)
+
+```php
+<?php
+
+use Abdal\PhpianRender\PhpianRender;
+
+// Use static methods without creating an instance
+$text = 'سلام دنیا';
+
+// Full processing
+$processed = PhpianRender::processStatic($text, [
+    'reshape' => true,
+    'bidi' => true,
+    'convertNumbers' => true,
+]);
+
+// Reshape
+$reshaped = PhpianRender::reshapeStatic($text);
+
+// Convert numbers
+$converted = PhpianRender::convertNumbersStatic('عدد 123', 'persian');
+
+// RTL detection
+$isRTL = PhpianRender::isRTLStatic($text);
+
+// Word wrap
+$wrapped = PhpianRender::wordWrapStatic('متن طولانی', 20);
+
+// Get package version
+$version = PhpianRender::getVersion();
+echo "Version: $version";
+```
+
 ### Using Standalone Classes
 
 ```php

composer.json

@@ -2,6 +2,7 @@
     "name": "abdal/phpian-render",
     "description": "Comprehensive PHP package for Persian/Arabic text rendering in graphical environments with RTL support",
     "type": "library",
+    "version": "1.2.0",
     "keywords": [
         "persian",
         "arabic",

examples/basic-usage.php

@@ -78,5 +78,27 @@
     'clean' => true,
 ]);
 echo "Original: $text\n";
-echo "Fully Processed: $processed\n";
+echo "Fully Processed: $processed\n\n";
+
+// Example 8: Static method calls (no need to instantiate)
+echo "=== Example 8: Static Method Calls ===\n";
+$text = 'سلام دنیا';
+
+// Using static methods directly
+$processed = PhpianRender::processStatic($text);
+echo "Static Process: $processed\n";
+
+$reshaped = PhpianRender::reshapeStatic($text);
+echo "Static Reshape: $reshaped\n";
+
+$isRTL = PhpianRender::isRTLStatic($text) ? 'Yes' : 'No';
+echo "Static IsRTL: $isRTL\n";
+
+$converted = PhpianRender::convertNumbersStatic('عدد 123', 'persian');
+echo "Static Convert: $converted\n\n";
+
+// Example 9: Get version
+echo "=== Example 9: Get Version ===\n";
+$version = PhpianRender::getVersion();
+echo "Package Version: $version\n";
 

src/PhpianRender.php

@@ -22,6 +22,7 @@
 /**
  * PhpianRender main class
  * Provides a unified interface for all RTL text processing features
+ * Supports both instance and static method calls
  */
 class PhpianRender
 {
@@ -31,6 +32,11 @@ class PhpianRender
     private DiacriticsHandler $diacriticsHandler;
     private Helper $helper;
 
+    /**
+     * Static instance for static method calls
+     */
+    private static ?PhpianRender $staticInstance = null;
+
     /**
      * Constructor
      */
@@ -43,6 +49,19 @@ public function __construct()
         $this->helper = new Helper();
     }
 
+    /**
+     * Get or create static instance
+     *
+     * @return PhpianRender
+     */
+    private static function getStaticInstance(): PhpianRender
+    {
+        if (self::$staticInstance === null) {
+            self::$staticInstance = new self();
+        }
+        return self::$staticInstance;
+    }
+
     /**
      * Process text with all RTL features
      *
@@ -59,6 +78,7 @@ public function process(string $text, array $options = []): string
             'numberLocale' => 'persian', // 'persian' or 'arabic'
             'preserveDiacritics' => true,
             'clean' => false,
+            'reverse' => true, // Reverse text for RTL display (like PersianRender)
         ];
 
         $options = array_merge($defaultOptions, $options);
@@ -77,6 +97,9 @@ public function process(string $text, array $options = []): string
             $diacritics = $extracted['diacritics'];
         }
 
+        // Check if text is mixed (RTL + LTR) or pure RTL
+        $isMixed = $this->isMixedText($text);
+
         // Reshape characters
         $reshapedText = $text;
         if ($options['reshape']) {
@@ -94,8 +117,17 @@ public function process(string $text, array $options = []): string
         }
 
         // Process bidirectional text
+        // For mixed texts (RTL + LTR), use BiDi algorithm
+        // For pure RTL texts, just reverse the entire text (like PersianRender)
         if ($options['bidi']) {
-            $text = $this->bidi->process($text);
+            if ($isMixed) {
+                // Mixed text: use BiDi algorithm
+                $text = $this->bidi->process($text);
+            } elseif ($options['reverse'] && $this->helper->isRTL($text)) {
+                // Pure RTL text: reverse entire text (like PersianRender.php)
+                $chars = mb_str_split($text, 1, 'UTF-8');
+                $text = implode('', array_reverse($chars));
+            }
         }
 
         // Convert numbers
@@ -109,6 +141,64 @@ public function process(string $text, array $options = []): string
         return $text;
     }
 
+    /**
+     * Check if text contains both RTL and LTR characters
+     *
+     * @param string $text Input text
+     * @return bool True if text is mixed
+     */
+    private function isMixedText(string $text): bool
+    {
+        $hasRTL = false;
+        $hasLTR = false;
+        $chars = mb_str_split($text, 1, 'UTF-8');
+
+        foreach ($chars as $char) {
+            if (ctype_space($char) || ctype_punct($char)) {
+                continue;
+            }
+
+            // Check if it's RTL
+            $codePoint = $this->getCharCodePoint($char);
+            if (($codePoint >= 0x0590 && $codePoint <= 0x08FF) ||
+                ($codePoint >= 0x0600 && $codePoint <= 0x06FF) ||
+                in_array($codePoint, [0x067E, 0x0686, 0x06AF, 0x0698])) {
+                $hasRTL = true;
+            } else {
+                // Check if it's LTR (Latin characters or numbers)
+                if (($codePoint >= 0x0041 && $codePoint <= 0x007A) ||
+                    ($codePoint >= 0x0030 && $codePoint <= 0x0039)) {
+                    $hasLTR = true;
+                }
+            }
+
+            if ($hasRTL && $hasLTR) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Get Unicode code point of a character
+     *
+     * @param string $char Character
+     * @return int Code point
+     */
+    private function getCharCodePoint(string $char): int
+    {
+        $bytes = unpack('C*', mb_convert_encoding($char, 'UTF-32BE', 'UTF-8'));
+        if (empty($bytes)) {
+            return 0;
+        }
+        $codePoint = 0;
+        foreach ($bytes as $byte) {
+            $codePoint = ($codePoint << 8) | $byte;
+        }
+        return $codePoint;
+    }
+
     /**
      * Reshape text only
      *
@@ -217,5 +307,88 @@ public function getHelper(): Helper
     {
         return $this->helper;
     }
+
+    /**
+     * Get package version
+     *
+     * @return string Package version
+     */
+    public static function getVersion(): string
+    {
+        return Version::getVersion();
+    }
+
+    // ========== Static Methods ==========
+
+    /**
+     * Process text with all RTL features (static)
+     *
+     * @param string $text Input text
+     * @param array $options Processing options
+     * @return string Processed text
+     */
+    public static function processStatic(string $text, array $options = []): string
+    {
+        return self::getStaticInstance()->process($text, $options);
+    }
+
+    /**
+     * Reshape text only (static)
+     *
+     * @param string $text Input text
+     * @return string Reshaped text
+     */
+    public static function reshapeStatic(string $text): string
+    {
+        return self::getStaticInstance()->reshape($text);
+    }
+
+    /**
+     * Process bidirectional text only (static)
+     *
+     * @param string $text Input text
+     * @return string Processed text
+     */
+    public static function processBiDiStatic(string $text): string
+    {
+        return self::getStaticInstance()->processBiDi($text);
+    }
+
+    /**
+     * Convert numbers (static)
+     *
+     * @param string $text Input text
+     * @param string $locale Target locale ('persian' or 'arabic')
+     * @return string Text with converted numbers
+     */
+    public static function convertNumbersStatic(string $text, string $locale = 'persian'): string
+    {
+        return self::getStaticInstance()->convertNumbers($text, $locale);
+    }
+
+    /**
+     * Word wrap for RTL text (static)
+     *
+     * @param string $text Text to wrap
+     * @param int $width Maximum line width
+     * @param string $break Line break character
+     * @param bool $cut Whether to cut words
+     * @return string Wrapped text
+     */
+    public static function wordWrapStatic(string $text, int $width = 75, string $break = "\n", bool $cut = false): string
+    {
+        return self::getStaticInstance()->wordWrap($text, $width, $break, $cut);
+    }
+
+    /**
+     * Check if text is RTL (static)
+     *
+     * @param string $text Text to check
+     * @return bool True if RTL
+     */
+    public static function isRTLStatic(string $text): bool
+    {
+        return self::getStaticInstance()->isRTL($text);
+    }
 }