antigravity-rtl-patcher 1.0.0

package/README.md

@@ -0,0 +1,77 @@
+# 🌌 Antigravity RTL Patcher
+
+<div align="center">
+  <img src="https://img.shields.io/npm/v/antigravity-rtl-patcher?color=cyan&label=Version&style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/npm/dt/antigravity-rtl-patcher?color=magenta&style=for-the-badge" alt="Downloads">
+  <img src="https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge" alt="License">
+</div>
+
+<br>
+
+<div align="center">
+  <h3>An elegant, intelligent, and seamless RTL & Typography patcher for Antigravity IDE.</h3>
+  <p>Bring native support for Persian, Arabic, and Hebrew to your favorite AI IDE.</p>
+</div>
+
+---
+
+## ⚡ What is this?
+Antigravity IDE (like many modern AI editors) is built on Electron. Out of the box, it lacks proper Right-to-Left (RTL) support. When AI generates Persian or Arabic text, the alignment breaks, fonts look terrible, and mixed English/RTL sentences become unreadable.
+
+This tool is a **CLI Patcher**. It deeply hooks into the core of Antigravity IDE (`app.asar`), injects a smart JavaScript `MutationObserver` engine, and automatically formats text direction dynamically.
+
+## 🚀 Features
+- **🧠 Smart Direction:** Detects RTL languages using Regex and applies alignment only where necessary.
+- **🎨 Beautiful Typography:** Automatically injects the modern **Vazirmatn** font for perfect legibility.
+- **🧩 Mixed Text Support:** Uses `unicode-bidi: plaintext` to ensure English code blocks inside Persian text don't break.
+- **🛡️ Safe & Reversible:** Automatically creates a backup. You can restore the IDE to its original state with a single command.
+- **⚙️ OS Agnostic:** Works on Windows, macOS, and Linux out of the box.
+
+---
+
+## 📦 Installation & Usage
+
+You don't even need to download the repository. Just run it directly via `npx`!
+
+### 1. Patch the IDE
+To inject RTL support, run the following command in your terminal:
+
+```bash
+# macOS & Linux (Requires sudo to modify application files)
+sudo npx antigravity-rtl-patcher patch
+
+# Windows (Run PowerShell as Administrator)
+npx antigravity-rtl-patcher patch
+```
+
+### 2. Restore (Unpatch)
+If you want to remove the patch or an update breaks something, you can easily restore from the backup:
+
+```bash
+# macOS & Linux
+sudo npx antigravity-rtl-patcher restore
+
+# Windows
+npx antigravity-rtl-patcher restore
+```
+
+*(Note: Whenever Antigravity IDE updates, the patch will be overwritten. Just run the `patch` command again!)*
+
+---
+
+## 🛠️ Architecture
+
+This project is divided into two main parts:
+1. **The Patcher (`src/patcher.js`)**: A Node.js CLI that locates the `app.asar` file, extracts it to a temporary directory, injects our payload into the main `index.html`, and repacks it.
+2. **The Payload (`payload/`)**: A combination of smart CSS and Vanilla JavaScript that runs inside the Electron UI. It uses a `MutationObserver` to watch for new chat messages dynamically generated by the AI and styles them on the fly.
+
+## 🤝 Contributing
+Contributions, issues, and feature requests are welcome!
+Feel free to check [issues page](https://github.com/VaFa1726/antigravity-rtl-patcher/issues).
+
+## 📄 License
+This project is [MIT](https://choosealicense.com/licenses/mit/) licensed.
+
+---
+<div align="center">
+</div>

package/bin/cli.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const { patch, restore } = require('../src/patcher');
+
+program
+  .name('agy-rtl')
+  .description('RTL & Typography patcher for Antigravity IDE')
+  .version('1.0.0');
+
+program
+  .command('patch')
+  .description('Inject RTL support into Antigravity IDE')
+  .action(async () => {
+    try {
+      console.log(chalk.cyan.bold('\n🚀 Starting Antigravity RTL Patcher...'));
+      await patch();
+    } catch (err) {
+      console.error(chalk.red('\n❌ Patch failed:'), err.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('restore')
+  .description('Restore Antigravity IDE to its original state')
+  .action(async () => {
+    try {
+      console.log(chalk.yellow.bold('\n🔄 Restoring Antigravity...'));
+      await restore();
+    } catch (err) {
+      console.error(chalk.red('\n❌ Restore failed:'), err.message);
+      process.exit(1);
+    }
+  });
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "antigravity-rtl-patcher",
+  "version": "1.0.0",
+  "description": "An elegant RTL and typography patcher for Antigravity IDE based on Electron",
+  "main": "src/patcher.js",
+  "bin": {
+    "agy-rtl": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node ./bin/cli.js"
+  },
+  "keywords": [
+    "antigravity",
+    "rtl",
+    "farsi",
+    "arabic",
+    "hebrew",
+    "patcher",
+    "electron",
+    "asar"
+  ],
+  "author": "VaFa1726",
+  "license": "MIT",
+  "dependencies": {
+    "@electron/asar": "^3.2.14",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^5.4.1",
+    "sudo-prompt": "^9.2.1"
+  }
+}

package/payload/rtl-engine.js

@@ -0,0 +1,73 @@
+(function() {
+  console.log('🚀 AGY RTL Engine Initialized');
+
+  // Regex to detect RTL characters (Arabic, Persian, Hebrew)
+  const rtlRegex = /[\u0591-\u07FF\uFB1D-\uFDFD\uFE70-\uFEFC]/;
+
+  function isRTL(text) {
+    // Basic heuristic: check if any RTL char exists
+    return rtlRegex.test(text);
+  }
+
+  function applyRTL(element) {
+    // Only process text nodes or direct containers
+    const textContent = element.textContent || element.innerText || '';
+    
+    if (isRTL(textContent)) {
+      element.setAttribute('data-agy-rtl', 'true');
+      element.style.direction = 'rtl';
+      element.style.textAlign = 'start';
+      
+      // Crucial for mixed English/Farsi content (like code snippets in Farsi text)
+      element.style.unicodeBidi = 'plaintext'; 
+      
+      // Mark as processed
+      element.classList.add('agy-rtl-processed');
+    }
+  }
+
+  // Observe DOM mutations for dynamically added chat messages
+  const observer = new MutationObserver((mutations) => {
+    mutations.forEach((mutation) => {
+      if (mutation.addedNodes.length) {
+        mutation.addedNodes.forEach((node) => {
+          if (node.nodeType === Node.ELEMENT_NODE) {
+            // Apply logic to the node itself if it has text
+            if (node.textContent && node.textContent.trim().length > 0) {
+              // We should probably target specific chat bubble selectors here if we knew them.
+              // For a generic approach, we look for paragraphs or divs with raw text.
+              const elementsToScan = node.querySelectorAll('p, span, div.message-content, div.chat-bubble, li, h1, h2, h3');
+              elementsToScan.forEach(el => {
+                if (!el.classList.contains('agy-rtl-processed')) {
+                  applyRTL(el);
+                }
+              });
+              
+              // Also check the root node added
+              if (!node.classList.contains('agy-rtl-processed')) {
+                 applyRTL(node);
+              }
+            }
+          }
+        });
+      }
+    });
+  });
+
+  // Start observing
+  window.addEventListener('load', () => {
+    observer.observe(document.body, { 
+      childList: true, 
+      subtree: true,
+      characterData: true
+    });
+    
+    // Initial scan
+    document.querySelectorAll('p, span, div, li, h1, h2, h3').forEach(el => {
+      if (el.textContent && el.textContent.trim().length > 0 && !el.children.length) {
+         applyRTL(el);
+      }
+    });
+  });
+
+})();

package/payload/styles.css

@@ -0,0 +1,20 @@
+/* Import a modern Persian font from Google Fonts (Vazirmatn) */
+@import url('https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300;400;500;700&display=swap');
+
+/* Apply font to patched elements */
+[data-agy-rtl="true"] {
+  font-family: 'Vazirmatn', system-ui, -apple-system, sans-serif !important;
+  line-height: 1.8 !important;
+  letter-spacing: normal !important;
+}
+
+/* Fix code blocks inside RTL text */
+[data-agy-rtl="true"] code, 
+[data-agy-rtl="true"] pre {
+  direction: ltr !important;
+  text-align: left !important;
+  unicode-bidi: isolate !important;
+  font-family: monospace !important;
+  display: inline-block;
+  margin: 0 4px;
+}

package/src/patcher.js

@@ -0,0 +1,151 @@
+const asar = require('@electron/asar');
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+const ora = require('ora');
+const chalk = require('chalk');
+const { getAsarPath } = require('./paths');
+const { checkPermissions, delay } = require('./utils');
+
+async function patch() {
+  checkPermissions();
+  
+  const spinner = ora('Locating Antigravity IDE...').start();
+  let asarPath;
+  
+  try {
+    asarPath = getAsarPath();
+    spinner.succeed(`Found Antigravity at: ${chalk.gray(asarPath)}`);
+  } catch (err) {
+    spinner.fail(err.message);
+    throw err;
+  }
+
+  const backupPath = `${asarPath}.backup`;
+  const tmpDir = path.join(os.tmpdir(), 'agy-patch-tmp');
+  
+  try {
+    // 1. Backup
+    spinner.start('Creating backup...');
+    if (!fs.existsSync(backupPath)) {
+      await fs.copy(asarPath, backupPath);
+      spinner.succeed('Backup created successfully.');
+    } else {
+      spinner.info('Backup already exists, skipping.');
+    }
+
+    // 2. Extract
+    spinner.start('Extracting core files...');
+    if (fs.existsSync(tmpDir)) {
+      await fs.remove(tmpDir);
+    }
+    await fs.ensureDir(tmpDir);
+    asar.extractAll(asarPath, tmpDir);
+    spinner.succeed('Core files extracted.');
+
+    // 3. Inject Payload
+    spinner.start('Injecting RTL engine & typography...');
+    
+    // Find the main HTML file - usually index.html in the root or a dist folder
+    const possibleHtmlPaths = [
+      path.join(tmpDir, 'index.html'),
+      path.join(tmpDir, 'out', 'index.html'),
+      path.join(tmpDir, 'dist', 'index.html')
+    ];
+    
+    let targetHtml = null;
+    for (const p of possibleHtmlPaths) {
+      if (fs.existsSync(p)) {
+        targetHtml = p;
+        break;
+      }
+    }
+
+    if (!targetHtml) {
+      throw new Error('Could not find the main HTML file to inject.');
+    }
+
+    let htmlContent = await fs.readFile(targetHtml, 'utf-8');
+    
+    // Read payload files
+    const engineCode = await fs.readFile(path.join(__dirname, '..', 'payload', 'rtl-engine.js'), 'utf-8');
+    const stylesCode = await fs.readFile(path.join(__dirname, '..', 'payload', 'styles.css'), 'utf-8');
+
+    // Check if already patched
+    if (htmlContent.includes('agy-rtl-engine')) {
+      spinner.info('IDE is already patched.');
+      await fs.remove(tmpDir);
+      return;
+    }
+
+    const injection = `
+      <!-- AGY RTL PATCH -->
+      <style id="agy-rtl-styles">${stylesCode}</style>
+      <script id="agy-rtl-engine">${engineCode}</script>
+      <!-- END AGY RTL PATCH -->
+    `;
+
+    // Inject just before </body>
+    if (htmlContent.includes('</body>')) {
+      htmlContent = htmlContent.replace('</body>', `${injection}\n</body>`);
+    } else {
+      // Fallback
+      htmlContent += injection;
+    }
+
+    await fs.writeFile(targetHtml, htmlContent);
+    spinner.succeed('Payload injected into UI.');
+
+    // 4. Repack
+    spinner.start('Repacking core files...');
+    await delay(500); // Give file system a moment
+    await asar.createPackage(tmpDir, asarPath);
+    spinner.succeed('Core repacked successfully.');
+
+    // 5. Cleanup
+    spinner.start('Cleaning up...');
+    await fs.remove(tmpDir);
+    spinner.succeed('Cleanup complete.');
+
+    console.log(chalk.green.bold('\n✨ Antigravity IDE successfully patched with RTL support!'));
+    console.log(chalk.cyan('Please restart Antigravity for the changes to take effect.\n'));
+
+  } catch (err) {
+    spinner.fail('An error occurred during patching.');
+    if (fs.existsSync(tmpDir)) {
+      await fs.remove(tmpDir);
+    }
+    throw err;
+  }
+}
+
+async function restore() {
+  checkPermissions();
+  const spinner = ora('Locating Antigravity IDE...').start();
+  
+  let asarPath;
+  try {
+    asarPath = getAsarPath();
+    spinner.succeed(`Found Antigravity at: ${chalk.gray(asarPath)}`);
+  } catch (err) {
+    spinner.fail(err.message);
+    throw err;
+  }
+
+  const backupPath = `${asarPath}.backup`;
+  
+  spinner.start('Restoring from backup...');
+  if (fs.existsSync(backupPath)) {
+    await fs.copy(backupPath, asarPath);
+    await fs.remove(backupPath);
+    spinner.succeed('Restored successfully.');
+    console.log(chalk.green.bold('\n✨ Antigravity IDE restored to original state!'));
+  } else {
+    spinner.fail('No backup found. The IDE might not be patched or backup was removed.');
+  }
+}
+
+module.exports = {
+  patch,
+  restore
+};

package/src/paths.js

@@ -0,0 +1,37 @@
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+
+function getAsarPath() {
+  const platform = os.platform();
+  
+  // Possible paths where the IDE might be installed
+  const paths = {
+    win32: [
+      path.join(process.env.LOCALAPPDATA || '', 'Programs', 'antigravity', 'resources', 'app.asar'),
+      path.join(process.env.PROGRAMFILES || '', 'antigravity', 'resources', 'app.asar')
+    ],
+    darwin: [
+      '/Applications/Antigravity.app/Contents/Resources/app.asar',
+      path.join(os.homedir(), 'Applications', 'Antigravity.app', 'Contents', 'Resources', 'app.asar')
+    ],
+    linux: [
+      '/opt/antigravity/resources/app.asar',
+      '/usr/local/lib/antigravity/resources/app.asar'
+    ]
+  };
+
+  const possiblePaths = paths[platform] || [];
+
+  for (const p of possiblePaths) {
+    if (fs.existsSync(p)) {
+      return p;
+    }
+  }
+
+  throw new Error('Antigravity installation not found. Please ensure it is installed in the default location.');
+}
+
+module.exports = {
+  getAsarPath
+};

package/src/utils.js

@@ -0,0 +1,26 @@
+const chalk = require('chalk');
+
+function checkPermissions() {
+  const isWindows = process.platform === 'win32';
+  
+  if (!isWindows) {
+    // Check if running as root
+    const isRoot = process.getuid && process.getuid() === 0;
+    if (!isRoot) {
+      console.error(chalk.red.bold('\n⚠️  Permission Denied!'));
+      console.error(chalk.white('Modifying system applications requires administrator privileges.'));
+      console.error(chalk.white(`Please run the command with ${chalk.yellow('sudo')}:\n`));
+      console.error(chalk.cyan('  sudo npx agy-rtl patch\n'));
+      process.exit(1);
+    }
+  }
+}
+
+function delay(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+module.exports = {
+  checkPermissions,
+  delay
+};