antigravity-rtl-patcher 2.3.3 → 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,121 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [3.0.0] - 2024-09-06
+
+### 🎉 Major Rewrite - Utils.js Injection Approach
+
+This is a **breaking change** that completely rewrites the injection strategy for better control and features.
+
+### ✨ Added
+
+- **Advanced UI Panel** - Rich hover-activated widget with comprehensive customization
+- **Custom Font Support** - Set separate fonts for Persian/Arabic, English, and code
+- **Typography Controls** - Real-time line height (1.2-2.5) and font size (11-22px) adjustment
+- **Persistent Configuration** - Settings saved to `~/.antigravity-rtl-v3.json`
+- **Force RTL Mode** - Override auto-detection for consistent RTL layout
+- **Enhanced Keyboard Shortcuts** - `Alt + R` to toggle RTL
+- **@ Sign Fix** - Type `@` with `Shift+2` on Persian keyboard
+- **DevTools Enabled** - Automatically enable DevTools for debugging
+- **Colorful CLI Banner** - Beautiful gradient ASCII art banner
+- **Update Command** - `agy-rtl update` to check for new versions
+
+### 🔧 Changed
+
+- **Injection Point**: Changed from `preload.js` to `dist/utils.js` for better lifecycle control
+- **Config Storage**: Moved from localStorage to filesystem (`~/.antigravity-rtl-v3.json`)
+- **Detection Algorithm**: Improved RTL text detection with smarter first-character analysis
+- **UI Architecture**: Complete redesign with Tailwind-inspired styling
+- **Dependencies**: Added `figlet`, `picocolors`, and `prompts` for better CLI experience
+
+### 🗑️ Removed
+
+- Old `preload-inject.js` payload (replaced with `utils-inject.js`)
+- localStorage-based configuration (replaced with file-based config)
+
+### 🐛 Fixed
+
+- Better handling of mixed RTL/LTR content
+- Improved code block preservation in RTL contexts
+- More reliable font loading mechanism
+- Enhanced list padding in RTL mode
+
+### 📚 Documentation
+
+- Completely rewritten README with v3.0 features
+- Added troubleshooting section
+- Added keyboard shortcuts reference
+- Added configuration file documentation
+
+---
+
+## [2.3.4] - 2024-09-06
+
+### ✨ Added
+
+- Auto-update checker before patching
+- `update` command to manually check for updates
+- Update notification system
+
+### 📚 Documentation
+
+- Added update instructions to README
+- Emphasized `@latest` usage in documentation
+
+---
+
+## [2.3.3] - 2024-09-06
+
+### 🐛 Fixed
+
+- Improved RTL text detection logic
+- Better layout rendering for mixed content
+
+---
+
+## [2.3.1] - 2024-09-06
+
+### 🐛 Fixed
+
+- Bug fixes for layout issues
+- Added IDE detection to skip patching IDE versions
+
+---
+
+## Earlier Versions
+
+See [GitHub Releases](https://github.com/VaFa1726/antigravity-rtl-patcher/releases) for details on versions before 2.3.1.
+
+---
+
+## Migration Guide: v2.x → v3.0
+
+### What Changed
+
+1. **Configuration Location**: Your old settings in localStorage will not carry over. You'll need to reconfigure the RTL settings using the new UI panel.
+
+2. **UI Location**: The old status icon is replaced with a hover-activated globe icon in the bottom-right corner.
+
+3. **New Features**: Take advantage of custom fonts, typography controls, and Force RTL mode.
+
+### How to Upgrade
+
+```bash
+# Restore old version
+npx antigravity-rtl-patcher restore
+
+# Install new version
+npx antigravity-rtl-patcher@latest patch
+
+# Restart Antigravity
+```
+
+Your old backup will work fine. The new patch is completely independent.
+
+---
+
+[3.0.0]: https://github.com/VaFa1726/antigravity-rtl-patcher/releases/tag/v3.0.0
+[2.3.4]: https://github.com/VaFa1726/antigravity-rtl-patcher/releases/tag/v2.3.4
+[2.3.3]: https://github.com/VaFa1726/antigravity-rtl-patcher/releases/tag/v2.3.3
+[2.3.1]: https://github.com/VaFa1726/antigravity-rtl-patcher/releases/tag/v2.3.1

package/README.md

@@ -1,6 +1,6 @@
 # Antigravity RTL Patcher
 
-Smart RTL and Persian/Arabic typography support for the [Antigravity](https://antigravity.dev) desktop app. Patches the Electron runtime to detect right-to-left text and apply proper styling automatically.
+Advanced RTL and Persian/Arabic typography support for the [Antigravity](https://antigravity.dev) desktop app. Patches the Electron runtime to detect right-to-left text and apply proper styling with a rich, customizable UI.
 
 [![npm version](https://img.shields.io/npm/v/antigravity-rtl-patcher)](https://www.npmjs.com/package/antigravity-rtl-patcher)
 [![npm downloads](https://img.shields.io/npm/dt/antigravity-rtl-patcher)](https://www.npmjs.com/package/antigravity-rtl-patcher)
@@ -8,73 +8,226 @@ Smart RTL and Persian/Arabic typography support for the [Antigravity](https://an
 
 ---
 
-## Install
+## ✨ What's New in v3.0
+
+- 🎨 **Advanced UI Panel** - Hover widget with comprehensive customization options
+- 🔤 **Custom Font Support** - Set separate fonts for Persian, English, and code
+- 📏 **Typography Controls** - Adjust line height and font size in real-time
+- 💾 **Persistent Config** - Settings saved to `~/.antigravity-rtl-v3.json`
+- ⚡ **Keyboard Shortcuts** - `Alt + R` to toggle RTL, `Shift + 2` for @ symbol
+- 🔧 **Force RTL Mode** - Override auto-detection for consistent RTL layout
+- 🎯 **Enhanced Detection** - Smarter RTL text recognition algorithm
+- 🚀 **DevTools Enabled** - Built-in developer tools for debugging
+
+---
+
+## ⚡ Quick Install
+
+Always use `@latest` to ensure you get the newest version:
 
 ```bash
-npx antigravity-rtl-patcher patch
+npx antigravity-rtl-patcher@latest patch
 ```
 
 If Antigravity is installed in a system directory, use `sudo`:
 
 ```bash
-sudo npx antigravity-rtl-patcher patch
+sudo npx antigravity-rtl-patcher@latest patch
 ```
 
-Restart Antigravity after patching.
+Restart Antigravity after patching to see the RTL widget appear in the bottom-right corner!
 
-## Uninstall
+---
+
+## 🔄 Update to Latest Version
+
+To ensure you're always using the latest version:
+
+```bash
+npx antigravity-rtl-patcher@latest patch
+```
+
+Or check for updates manually:
+
+```bash
+npx antigravity-rtl-patcher@latest update
+```
+
+The patcher will automatically notify you when a new version is available.
+
+---
+
+## 🎨 Features
+
+### Smart RTL Detection
+- Automatically detects Persian, Arabic, and Hebrew text
+- Applies proper text direction without breaking layout
+- Preserves LTR for code blocks and English text
+
+### Rich UI Panel
+Hover over the globe icon in the bottom-right corner to access:
+
+- **RTL Toggle** - Enable/disable RTL support on the fly
+- **Force RTL Mode** - Force RTL layout even when text starts with English
+- **Custom Fonts**:
+  - Persian/Arabic font (fallback: Vazirmatn)
+  - English font (fallback: system font)
+  - Code font (fallback: monospace)
+- **Typography Controls**:
+  - Line height slider (1.2 - 2.5)
+  - Font size slider (11px - 22px)
+- **@ Sign Fix** - Type `@` with `Shift+2` on Persian keyboard
+- **Keyboard Shortcut** - `Alt + R` to toggle RTL
+
+### Persistent Configuration
+All your settings are automatically saved to `~/.antigravity-rtl-v3.json` and restored on restart.
+
+---
+
+## 🗑️ Uninstall
+
+Remove the RTL patch and restore original Antigravity:
 
 ```bash
 npx antigravity-rtl-patcher restore
 ```
 
-This restores the original `app.asar` from the backup created during patching.
+Or with sudo if needed:
+
+```bash
+sudo npx antigravity-rtl-patcher restore
+```
+
+---
 
-## Commands
+## 📋 Commands
 
 | Command | Description |
-|---|---|
-| `agy-rtl patch` | Apply RTL patch |
-| `agy-rtl restore` | Remove patch, restore original |
+|---------|-------------|
+| `agy-rtl patch` | Apply RTL patch with advanced UI |
+| `agy-rtl restore` | Remove patch and restore original |
 | `agy-rtl status` | Show current patch status |
-| `agy-rtl patch --path /custom/path` | Patch a custom installation |
+| `agy-rtl update` | Check for patcher updates |
+| `agy-rtl patch --path /custom/path` | Patch custom installation |
+| `agy-rtl patch --skip-update-check` | Skip update check during patching |
+
+---
+
+## 🔧 How It Works
 
-## How it works
+Antigravity is built on Electron. The patcher:
 
-Antigravity is an Electron app. The patcher extracts `app.asar`, appends an RTL engine to the preload script, and repacks the archive. The engine uses a `MutationObserver` to detect Persian, Arabic, and Hebrew text in real-time and applies `direction: rtl` where needed.
+1. **Extracts** `app.asar` (the packaged application)
+2. **Locates** `dist/utils.js` (window creation module)
+3. **Injects** RTL engine at the window lifecycle hook
+4. **Repacks** the modified application
 
-After patching, an RTL icon appears at the bottom of the Antigravity window. Click it to open a settings panel where you can enable or disable RTL support. The setting persists across restarts via `localStorage`.
+The RTL engine uses:
+- `MutationObserver` for real-time DOM monitoring
+- Unicode range analysis for RTL detection
+- Dynamic CSS generation for typography control
+- Electron IPC for config persistence
 
-### What the engine does
+After patching, a hover-activated widget appears in the bottom-right corner with all customization options.
 
-- Detects RTL text using Unicode range analysis with ratio-based scoring
-- Applies directional styling only to elements that contain RTL text
-- Injects the Vazirmatn font for improved Persian/Arabic readability
-- Preserves LTR direction for code blocks inside RTL text
-- Provides a toggle UI to enable/disable at any time
+---
 
-## After Antigravity updates
+## 🔄 After Antigravity Updates
 
-Updates may overwrite the patch. Run the patch command again:
+Antigravity updates may overwrite the patch. Simply run:
 
 ```bash
-npx antigravity-rtl-patcher patch
+npx antigravity-rtl-patcher@latest patch
 ```
 
-## Supported platforms
+**Pro tip:** Always use `@latest` to ensure you're using the newest patcher version.
+
+---
 
-| Platform | Typical install locations |
-|---|---|
-| Linux | `/opt/antigravity`, `~/Downloads/Antigravity-x64` |
-| macOS | `/Applications/Antigravity.app` |
-| Windows | `%LOCALAPPDATA%\Programs\Antigravity` |
+## 💻 Supported Platforms
+
+| Platform | Typical Install Locations |
+|----------|---------------------------|
+| **Linux** | `/opt/Antigravity`<br>`~/Downloads/Antigravity-x64`<br>`~/.local/share/antigravity` |
+| **macOS** | `/Applications/Antigravity.app`<br>`~/Applications/Antigravity.app` |
+| **Windows** | `%LOCALAPPDATA%\Programs\Antigravity`<br>`%PROGRAMFILES%\Antigravity` |
+
+Custom paths are supported via `--path` option.
+
+---
 
-Custom paths are supported via `--path`.
+## ⌨️ Keyboard Shortcuts
+
+- **Alt + R** - Toggle RTL support on/off
+- **Shift + 2** - Type `@` symbol (when @ fix is enabled)
+
+---
+
+## 🎯 Configuration File
+
+Settings are stored in `~/.antigravity-rtl-v3.json`:
+
+```json
+{
+  "faFont": "",
+  "enFont": "",
+  "codeFont": "",
+  "lineHeight": "1.6",
+  "fontSize": "16",
+  "rtlEnabled": true,
+  "forceRTL": false,
+  "fixAtSign": true
+}
+```
+
+You can manually edit this file or use the UI panel.
+
+---
 
-## Contributing
+## 🐛 Troubleshooting
+
+### Patch not working?
+1. Make sure you restarted Antigravity after patching
+2. Check patch status: `agy-rtl status`
+3. Try restoring and re-patching:
+   ```bash
+   npx antigravity-rtl-patcher restore
+   npx antigravity-rtl-patcher@latest patch
+   ```
+
+### Widget not appearing?
+1. Open DevTools (now enabled by default)
+2. Check console for any RTL engine errors
+3. Make sure RTL is enabled in the widget
+
+### Permission denied?
+- **Linux/macOS**: Use `sudo` for system-wide installations
+- **Windows**: Run terminal as Administrator
+
+---
+
+## 🤝 Contributing
 
 Issues and pull requests are welcome at [github.com/VaFa1726/antigravity-rtl-patcher](https://github.com/VaFa1726/antigravity-rtl-patcher).
 
-## License
+---
+
+## 📄 License
+
+MIT © VaFa1726
+
+---
+
+## 🙏 Credits
+
+- Built with ❤️ for the Persian/Arabic developer community
+- Vazirmatn font by [Saber Rastikerdar](https://github.com/rastikerdar/vazirmatn)
+- Powered by Electron ASAR tools
+
+---
+
+## 🔗 Links
 
-MIT
+- [GitHub Repository](https://github.com/VaFa1726/antigravity-rtl-patcher)
+- [NPM Package](https://www.npmjs.com/package/antigravity-rtl-patcher)
+- [Report Issues](https://github.com/VaFa1726/antigravity-rtl-patcher/issues)

package/bin/cli.js

@@ -2,41 +2,105 @@
 
 const { program } = require('commander');
 const chalk = require('chalk');
+const figlet = require('figlet');
 const { patch, restore, status } = require('../src/patcher');
+const { checkForUpdates, showUpdateInstructions, currentVersion } = require('../src/version-checker');
 
-const BANNER = `
-${chalk.cyan('Antigravity Smart RTL Patcher')} ${chalk.gray('v2.3.3')}
-`;
+/**
+ * Display colorful banner with gradient effect
+ */
+function showBanner() {
+  try {
+    const bannerText = figlet.textSync('Antigravity RTL', {
+      font: 'Standard',
+      horizontalLayout: 'default',
+      verticalLayout: 'default'
+    });
 
+    // Gradient colors
+    const colors = [
+      { r: 51, g: 135, b: 255 },   // Blue
+      { r: 242, g: 80, b: 65 },    // Red  
+      { r: 223, g: 172, b: 42 },   // Yellow
+      { r: 145, g: 196, b: 91 }    // Green
+    ];
+
+    const lines = bannerText.split('\n');
+    console.log('');
+    
+    lines.forEach((line, lineIndex) => {
+      if (!line.trim()) return;
+      
+      let coloredLine = '';
+      const chars = line.split('');
+      const totalChars = chars.filter(c => c !== ' ').length;
+      let charIndex = 0;
+      
+      chars.forEach(char => {
+        if (char === ' ') {
+          coloredLine += ' ';
+        } else {
+          const progress = totalChars > 1 ? charIndex / (totalChars - 1) : 0;
+          const segmentCount = colors.length - 1;
+          const segmentFloat = progress * segmentCount;
+          const segmentIndex = Math.min(Math.floor(segmentFloat), segmentCount - 1);
+          const segmentProgress = segmentFloat - segmentIndex;
+          
+          const c1 = colors[segmentIndex];
+          const c2 = colors[segmentIndex + 1];
+          
+          const r = Math.round(c1.r + segmentProgress * (c2.r - c1.r));
+          const g = Math.round(c1.g + segmentProgress * (c2.g - c1.g));
+          const b = Math.round(c1.b + segmentProgress * (c2.b - c1.b));
+          
+          coloredLine += `\x1b[38;2;${r};${g};${b}m${char}\x1b[0m`;
+          charIndex++;
+        }
+      });
+      
+      console.log(coloredLine);
+    });
+    
+    console.log('');
+    console.log(chalk.gray(`  Advanced RTL & Typography Control | v${currentVersion}\n`));
+  } catch (err) {
+    // Fallback banner
+    console.log(chalk.cyan.bold(`\n✨ Antigravity Smart RTL Patcher v${currentVersion}\n`));
+  }
+}
+
+// Show banner
+showBanner();
+
+// CLI setup
 program
   .name('agy-rtl')
-  .description('RTL patcher for Antigravity')
-  .version('2.3.3');
+  .description('Advanced RTL patcher for Antigravity')
+  .version(currentVersion);
 
 program
   .command('patch')
-  .description('Inject RTL support into Antigravity')
+  .description('Inject advanced RTL support into Antigravity')
   .option('-p, --path <path>', 'Custom path to Antigravity installation')
+  .option('--skip-update-check', 'Skip checking for updates')
   .action(async (options) => {
-    console.log(BANNER);
     try {
-      await patch(options.path);
+      await patch(options.path, options.skipUpdateCheck);
     } catch (err) {
-      console.error(chalk.red('\nPatch failed:'), err.message);
+      console.error(chalk.red('\n✖ Patch failed:'), err.message);
       process.exit(1);
     }
   });
 
 program
   .command('restore')
-  .description('Remove RTL patch and restore Antigravity')
+  .description('Remove RTL patch and restore original Antigravity')
   .option('-p, --path <path>', 'Custom path to Antigravity installation')
   .action(async (options) => {
-    console.log(BANNER);
     try {
       await restore(options.path);
     } catch (err) {
-      console.error(chalk.red('\nRestore failed:'), err.message);
+      console.error(chalk.red('\n✖ Restore failed:'), err.message);
       process.exit(1);
     }
   });
@@ -46,13 +110,23 @@ program
   .description('Check current patch status')
   .option('-p, --path <path>', 'Custom path to Antigravity installation')
   .action(async (options) => {
-    console.log(BANNER);
     try {
       await status(options.path);
     } catch (err) {
-      console.error(chalk.red('\nStatus check failed:'), err.message);
+      console.error(chalk.red('\n✖ Status check failed:'), err.message);
       process.exit(1);
     }
   });
 
+program
+  .command('update')
+  .description('Check for updates and show installation instructions')
+  .action(async () => {
+    console.log(chalk.cyan('Checking for updates...\n'));
+    const hasUpdate = await checkForUpdates(false);
+    if (!hasUpdate) {
+      showUpdateInstructions();
+    }
+  });
+
 program.parse(process.argv);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "antigravity-rtl-patcher",
-  "version": "2.3.3",
-  "description": "Smart RTL and Persian/Arabic typography patcher for Antigravity",
+  "version": "3.0.0",
+  "description": "Advanced RTL and Persian/Arabic typography patcher for Antigravity with customizable UI",
   "main": "src/patcher.js",
   "bin": {
     "antigravity-rtl-patcher": "./bin/cli.js",
@@ -23,7 +23,9 @@
     "electron",
     "asar",
     "right-to-left",
-    "bidirectional"
+    "bidirectional",
+    "ui-customization",
+    "font-control"
   ],
   "author": "VaFa1726",
   "license": "MIT",
@@ -42,7 +44,10 @@
     "@electron/asar": "^3.2.14",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
+    "figlet": "^1.7.0",
     "fs-extra": "^11.2.0",
-    "ora": "^5.4.1"
+    "ora": "^5.4.1",
+    "picocolors": "^1.0.0",
+    "prompts": "^2.4.2"
   }
 }