feat: merge cmp repository with full history

Author: maxprilutskiy

cmp/.editorconfig

@@ -0,0 +1,16 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{js,ts,json,yml,yaml}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

cmp/.github/workflows/ci.yml

@@ -0,0 +1,77 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5.0.1
+        # pnpm version is taken from package.json
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+      - name: Use Node.js 20
+        uses: actions/setup-node@v6.0.0
+        with:
+          node-version: 20
+          cache: "pnpm"
+      - name: Install dependencies
+        run: pnpm install
+      - name: Lint
+        run: pnpm lint:check
+      - name: Check formatting
+        run: pnpm format:check
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5.0.1
+        # pnpm version is taken from package.json
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+      - name: Use Node.js 20
+        uses: actions/setup-node@v6.0.0
+        with:
+          node-version: 20
+          cache: "pnpm"
+      - name: Install dependencies
+        run: pnpm install
+      - name: Build
+        run: pnpm build
+      - name: Test
+        run: pnpm test
+
+  playwright-e2e:
+    timeout-minutes: 60
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5.0.1
+        # pnpm version is taken from package.json
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+      - name: Use Node.js 20
+        uses: actions/setup-node@v6.0.0
+        with:
+          node-version: 20
+          cache: "pnpm"
+      - name: Install dependencies
+        run: pnpm install
+      - name: Install Playwright Browsers
+        working-directory: ./compiler
+        run: pnpm exec playwright install --with-deps
+      - name: Prepare tests
+        working-directory: ./compiler
+        run: pnpm run test:prepare
+      - name: Run tests
+        working-directory: ./compiler
+        run: pnpm run test:e2e
+      - uses: actions/upload-artifact@v4
+        if: ${{ !cancelled() }}
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 30

cmp/.gitignore

@@ -0,0 +1,40 @@
+# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build outputs
+dist/
+build/
+*.tsbuildinfo
+
+# Turbo
+.turbo/
+
+# Environment variables
+.env
+.env*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Testing
+coverage/
+.nyc_output/
+
+# Misc
+*.local

cmp/.husky/pre-commit

@@ -0,0 +1 @@
+./node_modules/.bin/nano-staged

cmp/.npmrc

@@ -0,0 +1,6 @@
+# Use pnpm for package management
+shamefully-hoist=false
+strict-peer-dependencies=false
+
+# Lockfile settings
+lockfile=true

cmp/.prettierignore

@@ -0,0 +1,10 @@
+pnpm-lock.yaml
+.changeset/
+packages/cli/demo/
+build/
+dist/
+.react-router/
+.turbo/
+.next/
+CLAUDE.md
+**/routeTree.gen.ts

cmp/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "trailingComma": "all",
+  "singleQuote": false,
+  "semi": true,
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false
+}

cmp/README.md

@@ -0,0 +1,107 @@
+# Lingo.dev compiler
+
+Lingo.dev compiler with automatic translation support for React applications.
+
+This package provides plugins for multiple bundlers (Vite, Webpack) and Next.js that
+automatically transforms React components to inject translation calls.
+
+## Features
+
+- **Automatic JSX text transformation** - Automatically detects and transforms translatable text in JSX
+- **Opt-in or automatic** - Configure whether to require `'use i18n'` directive or transform all files
+- **Multi-bundler support** - Works with Vite, Webpack and Next.js (both Webpack and Turbopack builds)
+- **Translation server** - On-demand translation generation during development
+- **AI-powered translations** - Support for multiple LLM providers and Lingo.dev Engine
+
+## Getting started
+
+Install the package - `pnpm install @lingo.dev/compiler`
+
+### Vite
+
+- Configure the plugin in your vite config.
+
+  ```ts
+  import { defineConfig } from "vite";
+  import { lingoCompilerPlugin } from "@lingo.dev/compiler/vite";
+
+  export default defineConfig({
+    plugins: [
+      lingoCompilerPlugin({
+        sourceRoot: "src",
+        sourceLocale: "en",
+        targetLocales: ["es", "de", "fr"],
+        models: "lingo.dev",
+        dev: {
+          usePseudotranslator: true,
+        },
+      }), // ...other plugins
+    ],
+  });
+  ```
+
+- Wrap your app with `LingoProvider`. It should be used as early as possible in your app.
+  e.g. in vite example with tanstack-router `LingoProvider` should be above `RouterProvider`, otherwise code-splitting breaks contexts.
+  ```tsx
+  // Imports and other tanstack router setup
+  if (rootElement && !rootElement.innerHTML) {
+    const root = ReactDOM.createRoot(rootElement);
+    root.render(
+      <StrictMode>
+        <LingoProvider>
+          <RouterProvider router={router} />
+        </LingoProvider>
+      </StrictMode>,
+    );
+  }
+  ```
+
+See `demo/vite-react-spa` for the working example
+
+### Next.js
+
+- Use `withLingo` function to wrap your existing next config. You will have to make your config async.
+
+  ```ts
+  import type { NextConfig } from "next";
+  import { withLingo } from "@lingo.dev/compiler/next";
+
+  const nextConfig: NextConfig = {};
+
+  export default async function (): Promise<NextConfig> {
+    return await withLingo(nextConfig, {
+      sourceRoot: "./app",
+      sourceLocale: "en",
+      targetLocales: ["es", "de", "ru"],
+      models: "lingo.dev",
+      dev: {
+        usePseudotranslator: true,
+      },
+      buildMode: "cache-only",
+    });
+  }
+  ```
+
+- Wrap your app with `LingoProvider`. It should be used as early as possible in your app, root `Layout` is a good place.
+  ```tsx
+  export default function RootLayout({
+    children,
+  }: Readonly<{ children: React.ReactNode }>) {
+    return (
+      <LingoProvider>
+        <html>
+          <body className="antialiased">{children}</body>
+        </html>
+      </LingoProvider>
+    );
+  }
+  ```
+
+## Development
+
+`pnpm install` from project root
+`pnpm turbo dev --filter=@lingo.dev/compile` to compile and watch for compiler changes
+
+Choose the demo you want to work with and run it from the corresponding folder.
+`tsdown` in compiler is configured to cleanup the output folder before compilation, which works fine with next, but vite
+seems to be dead every time and has to be restarted.

cmp/compiler/.gitignore

@@ -0,0 +1,11 @@
+
+# Playwright
+node_modules/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+/playwright/.auth/
+
+# Translation server logs
+translation-server.log

cmp/compiler/README.md

@@ -0,0 +1,86 @@
+# @lingo.dev/compiler
+
+See the main [README](../README.md) for general information.
+
+## Structure
+
+The compiler is organized into several key modules:
+
+### Core Directories
+
+#### `src/plugin/` - Build-time transformation
+
+- **`transform/`** - Babel AST transformation logic for JSX text extraction
+- **`unplugin.ts`** - Universal plugin implementation (Vite, Webpack)
+- **`next.ts`** - Next.js-specific plugin with Turbopack and Webpack support
+- **`build-translator.ts`** - Batch translation generation at build time
+- **`virtual-modules-code-generator.ts`** - Generates code for virtual modules, dev config and locale resolvers for client and server
+
+#### `src/metadata/` - Translation metadata management
+
+- **`manager.ts`** - CRUD operations for `.lingo/metadata.json`
+- Thread-safe metadata file operations with file locking
+- Manages translation entries with hash-based identifiers
+
+#### `src/translators/` - Translation provider abstraction
+
+- **`lcp/`** - Lingo.dev Engine integration
+- **`pseudotranslator/`** - Development-mode fake translator
+- **`pluralization/`** - Automatic ICU MessageFormat detection
+- **`translator-factory.ts`** - Provider selection and initialization
+
+#### `src/translation-server/` - Development server
+
+- **`translation-server.ts`** - HTTP server for on-demand translations
+- **`cli.ts`** - Standalone CLI for translation generation
+- WebSocket support for real-time dev widget updates
+- Port management (60000-60099 range)
+
+#### `src/react/` - Runtime translation hooks
+
+- **`client/`** - Client-side Context-based hooks
+- **`server/`** - Server component cache-based hooks (isomorphic)
+- **`server-only/`** - Async server-only API (`getServerTranslations`)
+- **`shared/`** - Shared utilities (RichText rendering, Context)
+- **`next/`** - Next.js-specific middleware and locale switcher
+
+#### `src/utils/` - Shared utilities
+
+- **`hash.ts`** - Stable hash generation for translation keys
+- **`config-factory.ts`** - Configuration defaults and merging
+- **`logger.ts`** - Structured logging utilities
+- **`path-helpers.ts`** - File path resolution
+
+#### `src/widget/` - Development widget
+
+- In-browser translation editor overlay for development mode
+
+### Support Directories
+
+#### `tests/` - End-to-end testing
+
+- **`e2e/`** - Playwright tests for full build workflows
+- **`fixtures/`** - Test applications (Vite, Next.js)
+- **`helpers/`** - Test utilities and assertions
+
+#### `benchmarks/` - Performance benchmarks
+
+- Translation speed benchmarks
+- Metadata I/O performance tests
+
+#### `old-docs/` - Legacy documentation
+
+- Historical design documents and notes
+
+### Entry Points
+
+- **`src/index.ts`** - Main package exports (plugins, types)
+- **`src/types.ts`** - Core TypeScript types
+
+## Contributing
+
+This is a beta package under active development. Feedback and contributions are welcome!
+
+## License
+
+ISC