lingo-guardian 0.1.2 → 0.1.3

package/dist/bin/cli.js

@@ -9,6 +9,7 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
 import { lintCommand } from '../commands/lint.js';
+import { visualCommand } from '../commands/visual.js';
 import { VERSION, BANNER } from '../constants.js';
 const program = new Command();
 // Display banner
@@ -19,6 +20,7 @@ program
     .version(VERSION, '-v, --version', 'Display version number');
 // Register commands
 program.addCommand(lintCommand);
+program.addCommand(visualCommand);
 // Error handling
 program.exitOverride((err) => {
     if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version') {

package/dist/bin/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,iBAAiB;AACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhC,OAAO;KACF,IAAI,CAAC,gBAAgB,CAAC;KACtB,WAAW,CAAC,2DAA2D,CAAC;KACxE,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,wBAAwB,CAAC,CAAC;AAEjE,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAEhC,iBAAiB;AACjB,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE;IACzB,IAAI,GAAG,CAAC,IAAI,KAAK,yBAAyB,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,mCAAmC;AACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,UAAU,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,iBAAiB;AACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhC,OAAO;KACF,IAAI,CAAC,gBAAgB,CAAC;KACtB,WAAW,CAAC,2DAA2D,CAAC;KACxE,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,wBAAwB,CAAC,CAAC;AAEjE,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,iBAAiB;AACjB,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE;IACzB,IAAI,GAAG,CAAC,IAAI,KAAK,yBAAyB,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,mCAAmC;AACnC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAChC,OAAO,CAAC,UAAU,EAAE,CAAC;AACzB,CAAC"}

package/dist/commands/visual.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Visual Command - Generates 4-locale comparison grid
+ */
+import { Command } from 'commander';
+export declare const visualCommand: Command;
+//# sourceMappingURL=visual.d.ts.map

package/dist/commands/visual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual.d.ts","sourceRoot":"","sources":["../../src/commands/visual.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,eAAO,MAAM,aAAa,SAWpB,CAAC"}

package/dist/commands/visual.js

@@ -0,0 +1,108 @@
+/**
+ * Visual Command - Generates 4-locale comparison grid
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import fs from 'fs';
+import { chromium } from 'playwright';
+import sharp from 'sharp';
+import { LingoIntegration } from '../core/lingo-integration.js';
+export const visualCommand = new Command('visual')
+    .description('Generate a visual comparison grid of 4 locales')
+    .argument('<url>', 'URL to audit (e.g., http://localhost:3000)')
+    .option('-o, --output <file>', 'Output file path', 'visual-report.png')
+    .option('-p, --project <path>', 'Path to project directory containing i18n.json', process.cwd())
+    .action(async (url, options) => {
+    await runVisualAudit(url, options);
+});
+async function runVisualAudit(url, options) {
+    const spinner = ora('Starting Visual Audit...').start();
+    const projectPath = path.resolve(options.project);
+    const lingo = new LingoIntegration(projectPath, true);
+    // 1. Generate Lingo Translations
+    try {
+        spinner.text = 'Generating translations (pseudo-locale)...';
+        // We ensure pseudo is enabled and generated
+        await lingo.enablePseudoLocale();
+        await lingo.runTranslation({ force: false });
+        spinner.succeed('Translations ready');
+    }
+    catch (e) {
+        spinner.warn('Could not generate translations (continuing anyway)');
+    }
+    spinner.start('Launching browser for screenshots...');
+    let browser = null;
+    try {
+        browser = await chromium.launch({
+            headless: true,
+            args: ['--no-sandbox', '--disable-dev-shm-usage'],
+        });
+        const context = await browser.newContext({
+            viewport: { width: 1200, height: 800 }, // Standard viewport
+        });
+        const page = await context.newPage();
+        const locales = [
+            { code: 'en', name: 'Original (English)' },
+            { code: 'pseudo', name: 'Stress Test (German/Expansion)' },
+            { code: 'ar', name: 'RTL (Arabic)' },
+            { code: 'ja', name: 'Characters (Japanese)' } // Ensure user has 'ja' in lingo config or it defaults to English? 
+            // Actually lingo SDK handles fallback.
+        ];
+        const screenshots = [];
+        for (const locale of locales) {
+            spinner.text = `Snapping ${locale.name}...`;
+            // Build URL: append ?lang=code (common Lingo SDK pattern)
+            // If already has params, append &lang=code
+            const localeUrl = new URL(url);
+            localeUrl.searchParams.set('lang', locale.code);
+            await page.goto(localeUrl.toString(), { waitUntil: 'networkidle' });
+            // Inject a label overlay on the screenshot? 
+            // The user didn't ask for it, but it helps. 
+            // For now, raw screenshots.
+            const buffer = await page.screenshot({ fullPage: false }); // User used fullPage: true but grid needs fixed size usually.
+            // User script: await page.screenshot({ fullPage: true });
+            // But then stitching logic: top: 0, left: width.
+            // If pages are different heights, grid is messy.
+            // I'll stick to viewport screenshot for clean grid.
+            screenshots.push({ buffer, label: locale.name });
+        }
+        await browser.close();
+        browser = null;
+        // 2. Stitch Images
+        spinner.text = 'Creating Composite Grid...';
+        const width = 1200;
+        const height = 800;
+        // 2x2 Grid configuration
+        // Top-Left: En, Top-Right: Pseudo
+        // Bot-Left: Ar, Bot-Right: Ja
+        const composite = await sharp({
+            create: {
+                width: width * 2,
+                height: height * 2,
+                channels: 4,
+                background: { r: 255, g: 255, b: 255, alpha: 1 }
+            }
+        })
+            .composite([
+            { input: screenshots[0].buffer, top: 0, left: 0 },
+            { input: screenshots[1].buffer, top: 0, left: width },
+            { input: screenshots[2].buffer, top: height, left: 0 },
+            { input: screenshots[3].buffer, top: height, left: width },
+        ])
+            .png()
+            .toBuffer();
+        const outputPath = path.resolve(options.output);
+        fs.writeFileSync(outputPath, composite);
+        spinner.succeed(chalk.green(`Generated visual report: ${outputPath}`));
+    }
+    catch (error) {
+        spinner.fail('Visual audit failed');
+        console.error(error);
+        if (browser)
+            await browser.close();
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=visual.js.map

package/dist/commands/visual.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lingo-guardian",
-    "version": "0.1.2",
+    "version": "0.1.3",
     "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",
@@ -33,10 +33,12 @@
         "postinstall": "npx playwright install chromium --with-deps 2>/dev/null || true"
     },
     "dependencies": {
+        "@types/sharp": "^0.31.1",
         "chalk": "^5.3.0",
         "commander": "^11.1.0",
         "ora": "^8.0.1",
         "playwright": "^1.40.0",
+        "sharp": "^0.34.5",
         "table": "^6.8.1"
     },
     "devDependencies": {