lingo-guardian 0.1.0

package/dist/transforms/rtl.js

@@ -0,0 +1,120 @@
+/**
+ * RTL (Right-to-Left) Transformation
+ *
+ * Applies RTL layout transformation for testing Arabic, Hebrew,
+ * Farsi, and other RTL languages.
+ *
+ * Detects layout breaks from improper CSS that doesn't support
+ * bidirectional text properly.
+ */
+/**
+ * RTL locale codes
+ */
+const RTL_LOCALES = ['ar', 'he', 'fa', 'ur', 'yi', 'ps', 'sd', 'ug'];
+export class RTLTransform {
+    /**
+     * Check if a locale is RTL
+     */
+    static isRTL(locale) {
+        return RTL_LOCALES.includes(locale.toLowerCase().split('-')[0]);
+    }
+    /**
+     * Apply RTL transformation using Playwright
+     * Cross-platform compatible (Mac, Windows, Linux)
+     */
+    static async applyPlaywright(page, locale = 'ar') {
+        await page.evaluate((localeCode) => {
+            // Set document direction
+            document.documentElement.dir = 'rtl';
+            document.documentElement.lang = localeCode;
+            // Add RTL styles
+            const rtlStyles = document.createElement('style');
+            rtlStyles.id = 'lingo-guardian-rtl-styles';
+            rtlStyles.textContent = `
+        /* Base RTL direction */
+        html[dir="rtl"] body {
+          direction: rtl;
+          text-align: right;
+        }
+
+        /* Fix common RTL issues */
+        html[dir="rtl"] [style*="text-align: left"] {
+          text-align: right !important;
+        }
+
+        /* Flip flexbox alignment */
+        html[dir="rtl"] .flex-row,
+        html[dir="rtl"] [style*="flex-direction: row"] {
+          flex-direction: row-reverse;
+        }
+
+        /* Highlight potential RTL issues */
+        html[dir="rtl"] [style*="margin-left"]:not([style*="margin-right"]),
+        html[dir="rtl"] [style*="padding-left"]:not([style*="padding-right"]),
+        html[dir="rtl"] [style*="left:"]:not([style*="right:"]) {
+          outline: 2px dashed #FF6B6B !important;
+          outline-offset: 2px;
+        }
+
+        /* Indicator */
+        #lingo-guardian-rtl-indicator {
+          position: fixed;
+          top: 4px;
+          left: 4px;
+          background: #10B981;
+          color: white;
+          padding: 4px 8px;
+          border-radius: 4px;
+          font-size: 10px;
+          font-family: monospace;
+          z-index: 99999;
+          opacity: 0.9;
+          direction: ltr;
+        }
+      `;
+            document.head.appendChild(rtlStyles);
+            // Process inline styles that might cause RTL issues
+            const elementsWithInlineStyles = document.querySelectorAll('[style]');
+            elementsWithInlineStyles.forEach((el) => {
+                const htmlEl = el;
+                const style = htmlEl.style;
+                const marginLeft = style.marginLeft;
+                const marginRight = style.marginRight;
+                if (marginLeft && !marginRight) {
+                    style.marginRight = marginLeft;
+                    style.marginLeft = '';
+                }
+                const paddingLeft = style.paddingLeft;
+                const paddingRight = style.paddingRight;
+                if (paddingLeft && !paddingRight) {
+                    style.paddingRight = paddingLeft;
+                    style.paddingLeft = '';
+                }
+                if (style.textAlign === 'left') {
+                    style.textAlign = 'right';
+                }
+                else if (style.textAlign === 'right') {
+                    style.textAlign = 'left';
+                }
+            });
+            // Add visual indicator
+            const indicator = document.createElement('div');
+            indicator.id = 'lingo-guardian-rtl-indicator';
+            indicator.innerHTML = `⬅️ RTL (${localeCode.toUpperCase()})`;
+            document.body.appendChild(indicator);
+        }, locale);
+    }
+    /**
+     * Get sample RTL text for testing
+     */
+    static getSampleText(locale = 'ar') {
+        const samples = {
+            ar: 'مرحبا بالعالم',
+            he: 'שלום עולם',
+            fa: 'سلام دنیا',
+            ur: 'ہیلو ورلڈ',
+        };
+        return samples[locale] || samples.ar;
+    }
+}
+//# sourceMappingURL=rtl.js.map

package/dist/transforms/rtl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl.js","sourceRoot":"","sources":["../../src/transforms/rtl.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+    "name": "lingo-guardian",
+    "version": "0.1.0",
+    "description": "CLI tool to detect i18n layout issues - CSS overflows, RTL breaks, and text expansion problems. Powered by Lingo.dev",
+    "author": "Lingo-Guardian Team",
+    "license": "MIT",
+    "type": "module",
+    "bin": {
+        "lingo-guardian": "./dist/bin/cli.js"
+    },
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/ashpreetsinghanand/lingo-guardian.git"
+    },
+    "homepage": "https://github.com/ashpreetsinghanand/lingo-guardian#readme",
+    "bugs": {
+        "url": "https://github.com/ashpreetsinghanand/lingo-guardian/issues"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "start": "node ./dist/bin/cli.js",
+        "lint": "eslint src --ext .ts",
+        "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+        "clean": "rm -rf dist",
+        "prepublishOnly": "npm run build",
+        "postinstall": "npx playwright install chromium --with-deps 2>/dev/null || true"
+    },
+    "dependencies": {
+        "chalk": "^5.3.0",
+        "commander": "^11.1.0",
+        "ora": "^8.0.1",
+        "playwright": "^1.40.0",
+        "table": "^6.8.1"
+    },
+    "devDependencies": {
+        "@types/node": "^20.10.0",
+        "@typescript-eslint/eslint-plugin": "^6.14.0",
+        "@typescript-eslint/parser": "^6.14.0",
+        "typescript": "^5.3.3"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "keywords": [
+        "i18n",
+        "internationalization",
+        "localization",
+        "lingo.dev",
+        "lingo",
+        "overflow",
+        "rtl",
+        "ltr",
+        "css",
+        "lint",
+        "devtools",
+        "react",
+        "testing",
+        "accessibility"
+    ],
+    "publishConfig": {
+        "access": "public"
+    }
+}