lingo-guardian 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# 🛡️ Lingo-Guardian CLI
+
+> **Detect i18n layout issues before they reach production**
+
+Powered by [Lingo.dev](https://lingo.dev)
+
+## Installation
+
+```bash
+npm install -g lingo-guardian
+```
+
+## Quick Start
+
+```bash
+# Initialize Lingo.dev in your project
+npx lingo.dev@latest init
+
+# Run the audit
+lingo-guardian lint http://localhost:3000
+```
+
+## Features
+
+- 🔍 CSS overflow detection (`scrollWidth > offsetWidth`)
+- 🌍 Pseudo-locale text expansion testing
+- ↔️ RTL layout validation
+- 📊 Table, JSON, and HTML reports
+- 🖥️ Cross-platform (Mac, Windows, Linux)
+
+## Usage
+
+```bash
+lingo-guardian lint <url> [options]
+
+Options:
+  -l, --locale <locales...>   Locales to test (default: ["en", "pseudo"])
+  -f, --format <format>       Output format: table, json, html
+  --fail-on-error             Exit with error code if issues found
+  -v, --verbose               Enable verbose logging
+```
+
+## License
+
+MIT

package/dist/bin/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Lingo-Guardian CLI
+ * The Automated DevSecOps Firewall for Internationalization
+ *
+ * Detects UI overflows, RTL layout breaks, and missing i18n keys
+ * before they reach production.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/bin/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * Lingo-Guardian CLI
+ * The Automated DevSecOps Firewall for Internationalization
+ *
+ * Detects UI overflows, RTL layout breaks, and missing i18n keys
+ * before they reach production.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { lintCommand } from '../commands/lint.js';
+import { VERSION, BANNER } from '../constants.js';
+const program = new Command();
+// Display banner
+console.log(chalk.cyan(BANNER));
+program
+    .name('lingo-guardian')
+    .description('The Automated DevSecOps Firewall for Internationalization')
+    .version(VERSION, '-v, --version', 'Display version number');
+// Register commands
+program.addCommand(lintCommand);
+// Error handling
+program.exitOverride((err) => {
+    if (err.code === 'commander.helpDisplayed' || err.code === 'commander.version') {
+        process.exit(0);
+    }
+    console.error(chalk.red(`\n❌ Error: ${err.message}`));
+    process.exit(1);
+});
+// Parse arguments
+program.parse(process.argv);
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +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"}

package/dist/commands/lint.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lint Command
+ *
+ * Main command for auditing i18n layout issues.
+ *
+ * NEW: Now integrates with Lingo.dev CLI to generate translations!
+ *
+ * Usage: lingo-guardian lint <url> [options]
+ */
+import { Command } from 'commander';
+import { LintOptions } from '../constants.js';
+export interface ExtendedLintOptions extends LintOptions {
+    /** Project directory containing i18n.json */
+    project: string;
+    /** Run Lingo.dev CLI to generate translations before audit */
+    useLingo: boolean;
+}
+export declare const lintCommand: Command;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EAAwB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACpD,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,WAAW,SA0ClB,CAAC"}

package/dist/commands/lint.js

@@ -0,0 +1,166 @@
+/**
+ * Lint Command
+ *
+ * Main command for auditing i18n layout issues.
+ *
+ * NEW: Now integrates with Lingo.dev CLI to generate translations!
+ *
+ * Usage: lingo-guardian lint <url> [options]
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import path from 'path';
+import { Auditor } from '../core/auditor.js';
+import { LingoIntegration } from '../core/lingo-integration.js';
+import { Reporter } from '../reporters/reporter.js';
+import { DEFAULTS, EXIT_CODES } from '../constants.js';
+export const lintCommand = new Command('lint')
+    .description('Audit a URL for i18n layout issues using Lingo.dev for translations')
+    .argument('<url>', 'URL to audit (e.g., http://localhost:3000)')
+    .option('-p, --project <path>', 'Path to project directory containing i18n.json', process.cwd())
+    .option('--use-lingo', 'Run Lingo.dev CLI to generate translations before audit', true)
+    .option('-l, --locale <locales...>', 'Locales to test (e.g., en pseudo ar de)', ['en', 'pseudo'])
+    .option('-f, --format <format>', 'Output format: table, json, html', 'table')
+    .option('-s, --screenshot', 'Capture screenshots of issues', false)
+    .option('-o, --output <dir>', 'Output directory for reports', './lingo-guardian-reports')
+    .option('--fail-on-error', 'Exit with error code if issues found', false)
+    .option('-w, --width <pixels>', 'Viewport width', String(DEFAULTS.VIEWPORT_WIDTH))
+    .option('--height <pixels>', 'Viewport height', String(DEFAULTS.VIEWPORT_HEIGHT))
+    .option('-t, --timeout <ms>', 'Page load timeout in milliseconds', String(DEFAULTS.TIMEOUT))
+    .option('-v, --verbose', 'Enable verbose logging', false)
+    .action(async (url, options) => {
+    const lintOptions = {
+        project: options.project,
+        useLingo: options.useLingo,
+        locale: options.locale,
+        format: options.format,
+        screenshot: options.screenshot,
+        output: options.output,
+        failOnError: options.failOnError,
+        width: parseInt(options.width, 10),
+        height: parseInt(options.height, 10),
+        timeout: parseInt(options.timeout, 10),
+        verbose: options.verbose,
+    };
+    await runLintAudit(url, lintOptions);
+});
+/**
+ * Execute the lint audit with Lingo.dev integration
+ */
+async function runLintAudit(url, options) {
+    const spinner = ora({
+        text: 'Initializing Lingo-Guardian...',
+        color: 'cyan',
+    }).start();
+    const projectPath = path.resolve(options.project);
+    const lingo = new LingoIntegration(projectPath, options.verbose);
+    const auditor = new Auditor({
+        width: options.width,
+        height: options.height,
+        timeout: options.timeout,
+        screenshots: options.screenshot,
+        outputDir: options.output,
+        verbose: options.verbose,
+    });
+    const reporter = new Reporter(options.format);
+    try {
+        // STEP 1: Detect Lingo.dev configuration
+        spinner.text = 'Detecting Lingo.dev configuration...';
+        const hasConfig = await lingo.detectConfig();
+        if (options.useLingo) {
+            if (!hasConfig) {
+                spinner.warn('No Lingo.dev config (i18n.json) found. Use --no-use-lingo to skip.');
+                console.log(chalk.yellow('\n💡 To initialize Lingo.dev, run:'));
+                console.log(chalk.cyan(`   cd ${projectPath} && npx lingo.dev@latest init\n`));
+            }
+            else {
+                // Show detected config
+                const config = lingo.getConfig();
+                if (config) {
+                    spinner.info(`Lingo.dev config: source=${config.locale.source}, targets=${config.locale.targets.join(', ')}`);
+                    spinner.start();
+                }
+                // STEP 2: Ensure pseudo-locale is enabled for testing
+                if (options.locale.includes('pseudo')) {
+                    spinner.text = 'Ensuring pseudo-locale is enabled...';
+                    await lingo.enablePseudoLocale();
+                }
+                // STEP 3: Run Lingo.dev CLI to generate translations
+                spinner.text = chalk.magenta('🌍 Running Lingo.dev CLI to generate translations...');
+                const lingoResult = await lingo.runTranslation({ force: false });
+                if (lingoResult.success) {
+                    spinner.succeed(chalk.green(`Lingo.dev generated ${lingoResult.localesGenerated.length} locale(s)`));
+                }
+                else {
+                    spinner.warn('Lingo.dev CLI completed with warnings');
+                    if (options.verbose && lingoResult.error) {
+                        console.log(chalk.yellow(lingoResult.error));
+                    }
+                }
+                spinner.start();
+            }
+        }
+        // STEP 4: Initialize browser for overflow detection
+        spinner.text = 'Launching headless browser...';
+        await auditor.init();
+        const results = [];
+        // STEP 5: Audit each locale
+        for (const locale of options.locale) {
+            // Build URL with locale query param for Lingo SDK integration
+            const localeUrl = buildLocaleUrl(url, locale);
+            spinner.text = `Auditing with locale: ${chalk.cyan(locale.toUpperCase())}...`;
+            if (options.verbose) {
+                console.log(chalk.gray(`  URL: ${localeUrl}`));
+            }
+            const result = await auditor.audit(localeUrl, locale);
+            results.push(result);
+            if (options.verbose) {
+                spinner.info(`${locale}: Found ${result.issueCount} issues (${result.duration}ms)`);
+                spinner.start();
+            }
+        }
+        // Close browser
+        await auditor.close();
+        spinner.succeed('Audit complete!');
+        // Print results
+        reporter.print(results);
+        // Print Lingo.dev integration note
+        console.log(chalk.gray('\n📦 Powered by Lingo.dev - https://lingo.dev\n'));
+        // Save report if output format is json or html
+        if (options.format === 'json' || options.format === 'html') {
+            await reporter.save(results, options.output);
+        }
+        // Exit with error if issues found and failOnError is set
+        const hasErrors = results.some((r) => r.issues.some((i) => i.severity === 'error'));
+        if (options.failOnError && hasErrors) {
+            console.log(chalk.red('\n💥 Exiting with error due to --fail-on-error flag'));
+            process.exit(EXIT_CODES.LINT_ISSUES_FOUND);
+        }
+    }
+    catch (error) {
+        spinner.fail('Audit failed');
+        if (error instanceof Error) {
+            console.error(chalk.red(`\n❌ Error: ${error.message}`));
+            if (options.verbose && error.stack) {
+                console.error(chalk.gray(error.stack));
+            }
+        }
+        await auditor.close();
+        process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+}
+/**
+ * Build URL with locale query parameter for Lingo.dev SDK
+ *
+ * The Lingo.dev SDK can detect locale from URL params:
+ * - ?lang=es
+ * - ?locale=es
+ */
+function buildLocaleUrl(baseUrl, locale) {
+    const url = new URL(baseUrl);
+    // Add locale query param for Lingo SDK
+    url.searchParams.set('lang', locale);
+    return url.toString();
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Constants and configuration for Lingo-Guardian CLI
+ */
+export declare const VERSION = "0.1.0";
+export declare const BANNER = "\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551                                                           \u2551\n\u2551   \uD83D\uDEE1\uFE0F  LINGO-GUARDIAN                                      \u2551\n\u2551   The Automated i18n Firewall for React                   \u2551\n\u2551                                                           \u2551\n\u2551   Powered by Lingo.dev                                    \u2551\n\u2551                                                           \u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n";
+/**
+ * Default configuration values
+ */
+export declare const DEFAULTS: {
+    /** Default timeout for page load in milliseconds */
+    readonly TIMEOUT: 30000;
+    /** Default viewport width */
+    readonly VIEWPORT_WIDTH: 1280;
+    /** Default viewport height */
+    readonly VIEWPORT_HEIGHT: 720;
+    /** Default locales to test */
+    readonly LOCALES: readonly ["en", "pseudo", "ar", "de"];
+    /** Selectors to exclude from scanning */
+    readonly EXCLUDED_SELECTORS: readonly ["script", "style", "noscript", "svg", "path"];
+    /** Text expansion factor for pseudo-locale */
+    readonly PSEUDO_EXPANSION_FACTOR: 0.35;
+};
+/**
+ * Exit codes following standard conventions
+ */
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly LINT_ISSUES_FOUND: 2;
+    readonly INVALID_ARGUMENTS: 3;
+};
+/**
+ * Issue severity levels
+ */
+export type Severity = 'error' | 'warning' | 'info';
+/**
+ * Overflow issue detected by the auditor
+ */
+export interface OverflowIssue {
+    /** CSS selector path to the element */
+    selector: string;
+    /** HTML tag name */
+    tagName: string;
+    /** Text content (truncated) */
+    textContent: string;
+    /** Element's offset width */
+    offsetWidth: number;
+    /** Element's scroll width */
+    scrollWidth: number;
+    /** Element's offset height */
+    offsetHeight: number;
+    /** Element's scroll height */
+    scrollHeight: number;
+    /** Overflow direction */
+    overflowDirection: 'horizontal' | 'vertical' | 'both';
+    /** Severity of the issue */
+    severity: Severity;
+    /** Locale where issue was detected */
+    locale: string;
+    /** Bounding rect for screenshot */
+    boundingRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Audit result for a single page
+ */
+export interface AuditResult {
+    /** URL that was audited */
+    url: string;
+    /** Locale tested */
+    locale: string;
+    /** Timestamp of audit */
+    timestamp: string;
+    /** Total issues found */
+    issueCount: number;
+    /** List of overflow issues */
+    issues: OverflowIssue[];
+    /** Duration of audit in ms */
+    duration: number;
+    /** Screenshot path if captured */
+    screenshotPath?: string;
+}
+/**
+ * CLI options for lint command
+ */
+export interface LintOptions {
+    /** Locales to test */
+    locale: string[];
+    /** Output format */
+    format: 'table' | 'json' | 'html';
+    /** Take screenshots */
+    screenshot: boolean;
+    /** Output directory for reports */
+    output: string;
+    /** Fail on errors */
+    failOnError: boolean;
+    /** Custom viewport width */
+    width: number;
+    /** Custom viewport height */
+    height: number;
+    /** Timeout in ms */
+    timeout: number;
+    /** Verbose logging */
+    verbose: boolean;
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,eAAO,MAAM,MAAM,6qCASlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ;IACjB,oDAAoD;;IAEpD,6BAA6B;;IAE7B,8BAA8B;;IAE9B,8BAA8B;;IAE9B,yCAAyC;;IAEzC,8CAA8C;;CAExC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,iBAAiB,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IACtD,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,YAAY,EAAE;QACV,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAClB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,uBAAuB;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;CACpB"}

package/dist/constants.js

@@ -0,0 +1,41 @@
+/**
+ * Constants and configuration for Lingo-Guardian CLI
+ */
+export const VERSION = '0.1.0';
+export const BANNER = `
+╔═══════════════════════════════════════════════════════════╗
+║                                                           ║
+║   🛡️  LINGO-GUARDIAN                                      ║
+║   The Automated i18n Firewall for React                   ║
+║                                                           ║
+║   Powered by Lingo.dev                                    ║
+║                                                           ║
+╚═══════════════════════════════════════════════════════════╝
+`;
+/**
+ * Default configuration values
+ */
+export const DEFAULTS = {
+    /** Default timeout for page load in milliseconds */
+    TIMEOUT: 30000,
+    /** Default viewport width */
+    VIEWPORT_WIDTH: 1280,
+    /** Default viewport height */
+    VIEWPORT_HEIGHT: 720,
+    /** Default locales to test */
+    LOCALES: ['en', 'pseudo', 'ar', 'de'],
+    /** Selectors to exclude from scanning */
+    EXCLUDED_SELECTORS: ['script', 'style', 'noscript', 'svg', 'path'],
+    /** Text expansion factor for pseudo-locale */
+    PSEUDO_EXPANSION_FACTOR: 0.35,
+};
+/**
+ * Exit codes following standard conventions
+ */
+export const EXIT_CODES = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    LINT_ISSUES_FOUND: 2,
+    INVALID_ARGUMENTS: 3,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;CASrB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACpB,oDAAoD;IACpD,OAAO,EAAE,KAAK;IACd,6BAA6B;IAC7B,cAAc,EAAE,IAAI;IACpB,8BAA8B;IAC9B,eAAe,EAAE,GAAG;IACpB,8BAA8B;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAU;IAC9C,yCAAyC;IACzC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC;IAClE,8CAA8C;IAC9C,uBAAuB,EAAE,IAAI;CACvB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,iBAAiB,EAAE,CAAC;IACpB,iBAAiB,EAAE,CAAC;CACd,CAAC"}

package/dist/core/auditor.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Auditor - Core engine for detecting i18n layout issues
+ *
+ * Uses Playwright (cross-platform: Mac, Windows, Linux) to analyze pages for:
+ * - Text overflow (scrollWidth > offsetWidth)
+ * - Text truncation (text-overflow: ellipsis detection)
+ * - Layout breaks in RTL mode
+ */
+import type { AuditResult } from '../constants.js';
+export interface AuditorOptions {
+    /** Viewport width */
+    width?: number;
+    /** Viewport height */
+    height?: number;
+    /** Page load timeout in ms */
+    timeout?: number;
+    /** Take screenshots of issues */
+    screenshots?: boolean;
+    /** Output directory for screenshots */
+    outputDir?: string;
+    /** Verbose logging */
+    verbose?: boolean;
+}
+/**
+ * Core Auditor class for detecting i18n layout issues
+ *
+ * Uses Playwright for cross-platform browser automation (Mac, Windows, Linux)
+ */
+export declare class Auditor {
+    private browser;
+    private context;
+    private options;
+    constructor(options?: AuditorOptions);
+    /**
+     * Initialize the browser instance
+     * Playwright handles cross-platform browser binaries automatically
+     */
+    init(): Promise<void>;
+    /**
+     * Close the browser instance
+     */
+    close(): Promise<void>;
+    /**
+     * Audit a URL for i18n layout issues
+     */
+    audit(url: string, locale?: string): Promise<AuditResult>;
+    /**
+     * Apply locale-specific transformations to the page
+     * These are fallback transforms when Lingo.dev integration is not used
+     */
+    private applyLocaleTransform;
+    /**
+     * Detect elements with overflow issues
+     * Core detection logic: element.scrollWidth > element.offsetWidth
+     */
+    private detectOverflows;
+    /**
+     * Log message if verbose mode is enabled
+     */
+    private log;
+}
+//# sourceMappingURL=auditor.d.ts.map

package/dist/core/auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["../../src/core/auditor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKlE,MAAM,WAAW,cAAc;IAC3B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAkBD;;;;GAIG;AACH,qBAAa,OAAO;IAChB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,OAAO,CAA2B;gBAE9B,OAAO,GAAE,cAAmB;IAWxC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAyCrE;;;OAGG;YACW,oBAAoB;IAmClC;;;OAGG;YACW,eAAe;IAkI7B;;OAEG;IACH,OAAO,CAAC,GAAG;CAKd"}