lingo.dev 0.92.18 → 0.93.0

package/README.md

@@ -1,20 +1,21 @@
+> [!Note] > **Introducing: Lingo.dev Compiler** - Make any React app multilingual at build time without changing your components. [Read the docs](https://lingo.dev/compiler).
+
 <p align="center">
-  <a href="https://lingo.dev">
-    <img src="https://raw.githubusercontent.com/lingodotdev/lingo.dev/main/content/banner.launch.png" width="100%" alt="Lingo.dev" />
+  <a href="https://lingo.dev/compiler">
+    <img src="https://raw.githubusercontent.com/lingodotdev/lingo.dev/main/content/banner.compiler.png" width="100%" alt="Lingo.dev" />
   </a>
 </p>
 
 <p align="center">
-  <strong>⚡️ AI-powered open-source CLI for web & mobile localization.</strong>
+  <strong>⚡️ AI-powered open-source tools for web & mobile localization.</strong>
 </p>
 
 <br />
 
 <p align="center">
-  <a href="https://docs.lingo.dev">Docs</a> •
-  <a href="https://github.com/lingodotdev/lingo.dev/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22">Contribute</a> •
-  <a href="#-github-action">GitHub Action</a> •
-  <a href="#">Star the repo</a>
+  <a href="https://lingo.dev/cli">Lingo.dev CLI</a> •
+  <a href="https://lingo.dev/ci">Lingo.dev CI/CD</a> •
+  <a href="https://lingo.dev/compiler">Lingo.dev Compiler 🆕</a>
 </p>
 
 <p align="center">
@@ -31,125 +32,15 @@
 
 <br />
 
-Lingo.dev is a community-driven, open-source CLI for AI-powered web and mobile app localization.
-
-Lingo.dev is designed to produce authentic translations instantly, eliminating manual work and management overhead. As a result, teams do accurate localization 100x faster, shipping features to more happy users worldwide. It can be used with your own LLM or with Lingo.dev-managed Localization Engine.
-
-> **Little-known fact:** Lingo.dev began as a small project at a student hackathon back in 2023! Many iterations later, we got accepted into Y Combinator in 2024, and we're now hiring! Interested in building the next-gen localization tools? Send your CV to careers@lingo.dev! 🚀
-
-## 📑 In This Guide
-
-- [Quickstart](#-quickstart) - Get started in minutes
-- [Caching](#-caching-with-i18nlock) - Optimize translation updates
-- [GitHub Action](#-github-action) - Automate localization in CI/CD
-- [Features](#-supercharged-features) - What makes Lingo.dev powerful
-- [Documentation](#-documentation) - Detailed guides and references
-- [Contribute](#-contribute) - Join our community
-
-## 💫 Quickstart
-
-Lingo.dev CLI is designed to work with both your own LLM, and Lingo.dev-managed Localization Engine built on top of latest SOTA (state-of-the-art) LLMs.
-
-### Using Your Own LLM (BYOK or Bring Your Own Key)
-
-1. Create an `i18n.json` configuration file:
-
-```json
-{
-  "version": 1.5,
-  "provider": {
-    "id": "anthropic",
-    "model": "claude-3-7-sonnet-latest",
-    "prompt": "You're translating text from {source} to {target}."
-  },
-  "locale": {
-    "source": "en",
-    "targets": ["es", "fr", "de"]
-  }
-}
-```
-
-2. Set your API key as an environment variable:
-
-```bash
-export ANTHROPIC_API_KEY=your_anthropic_api_key
-# or for OpenAI
-export OPENAI_API_KEY=your_openai_api_key
-```
-
-3. Run the localization:
-
-```bash
-npx lingo.dev@latest i18n
-```
-
-### Using Lingo.dev Cloud
-
-Oftentimes, production-grade apps require features like translation memory, glossary support, and localization quality assurance. Also, sometimes, you want an expert to decide for you which LLM provider and model to use, and to update the model automatically when new ones are released. Lingo.dev is a managed Localization Engine that provides these features:
-
-1. Create an `i18n.json` configuration file (without provider node):
+Lingo.dev is an open-source, i18n toolkit designed to help use LLMs for localization and translation of web, mobile apps and markdown content.
 
-```json
-{
-  "version": 1.5,
-  "locale": {
-    "source": "en",
-    "targets": ["es", "fr", "de"]
-  }
-}
-```
+Lingo.dev includes:
 
-2. Authenticate with Lingo.dev:
+- **Lingo.dev CLI** - a CLI tool built to help translate apps and markdown content with lightning speed and accuracy. [Docs](https://lingo.dev/cli)
+- **Lingo.dev CI/CD** - a CI/CD integration for GitHub, GitLab, and Bitbucket built to keep translations up-to-date automatically as soon as new content is added. [Docs](https://lingo.dev/ci)
+- **Lingo.dev Compiler 🆕** - makes React app multilingual at build time without requiring changes to your existing components. [Docs](https://lingo.dev/compiler)
 
-```bash
-npx lingo.dev@latest auth --login
-```
-
-3. Run localization:
-
-```bash
-npx lingo.dev@latest i18n
-```
-
-## 📖 Documentation
-
-For detailed guides and API references, visit the [documentation](https://lingo.dev/go/docs).
-
-## 🔒 Caching with `i18n.lock`
-
-Lingo.dev uses an `i18n.lock` file to track content checksums, ensuring only changed text gets translated. This improves:
-
-- ⚡️ **Speed**: Skip already translated content
-- 🔄 **Consistency**: Prevent unnecessary retranslations
-- 💰 **Cost**: No billing for repeated translations
-
-## 🤖 GitHub Action
-
-Lingo.dev offers a GitHub Action to automate localization in your CI/CD pipeline. Here's a basic setup:
-
-```yaml
-- uses: lingodotdev/lingo.dev@main
-  with:
-    api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
-```
-
-This action runs `lingo.dev i18n` on every push, keeping your translations up-to-date automatically.
-
-For pull request mode and other configuration options, visit our [GitHub Action documentation](https://docs.lingo.dev/ci-action/gha).
-
-## ⚡️ Lingo.dev's Superpowers
-
-- 🔥 **Instant integration**: Works with your codebase in minutes
-- 🔄 **CI/CD Automation**: Set it and forget it
-- 🌍 **Global reach**: Ship to users everywhere
-- 🧠 **AI-powered**: Uses latest language models for natural translations
-- 📊 **Format-agnostic**: JSON, YAML, CSV, Markdown, Android, iOS, and many more
-- 🔍 **Clean diffs**: Preserves your file structure exactly
-- ⚡️ **Lightning-fast**: Translations in seconds, not days
-- 🔄 **Always synced**: Automatically updates when content changes
-- 🌟 **Human quality**: Translations that don't sound robotic
-- 👨‍💻 **Built by devs, for devs**: We use it ourselves daily
-- 📈 **Grows with you**: From side project to enterprise scale
+All tools are designed to help use LLM models for precise translation and localization, and to eliminate manual work.
 
 ## 🤝 Contribute
 
@@ -175,3 +66,7 @@ Want to contribute? Create a pull request!
 - [Bengali](/readme/bn.md)
 
 Don't see your language? Just add a new language code to the [`i18n.json`](./i18n.json) file and open a PR!
+
+## 💬 Talk to us
+
+Have feedback, feature requests, bug reports or other suggestions? [Talk to us on Discord!](https://lingo.dev/go/discord)

package/build/cli.cjs

@@ -2311,10 +2311,11 @@ function createPoDataLoader(params) {
               }
             }
           });
-          return _gettextparser2.default.po.compile(updatedPo, { foldLength: params.multiline ? 76 : false }).toString().replace(
+          const updatedSection = _gettextparser2.default.po.compile(updatedPo, { foldLength: params.multiline ? 76 : false }).toString().replace(
             [`msgid ""`, `msgstr "Content-Type: text/plain\\n"`].join("\n"),
             ""
           ).trim();
+          return preserveCommentOrder(updatedSection, section);
         }
         return section.trim();
       }).filter(Boolean).join("\n\n");
@@ -2354,6 +2355,35 @@ function createPoContentLoader() {
     }
   });
 }
+function preserveCommentOrder(section, originalSection) {
+  const sectionLines = section.split(/\r?\n/);
+  const originalLines = originalSection.split(/\r?\n/);
+  const isComment = (line) => line.trim().startsWith("#");
+  const sectionComments = sectionLines.filter(isComment);
+  const nonCommentLines = sectionLines.filter((line) => !isComment(line));
+  if (sectionComments.length <= 1) {
+    return section;
+  }
+  const originalCommentOrder = originalLines.filter(isComment);
+  const commentMap = /* @__PURE__ */ new Map();
+  for (const line of sectionComments) {
+    commentMap.set(line.trim(), line);
+  }
+  const reorderedComments = [];
+  for (const orig of originalCommentOrder) {
+    const trimmed = orig.trim();
+    if (commentMap.has(trimmed)) {
+      reorderedComments.push(commentMap.get(trimmed));
+      commentMap.delete(trimmed);
+    }
+  }
+  for (const line of sectionComments) {
+    if (!originalCommentOrder.some((orig) => orig.trim() === line.trim())) {
+      reorderedComments.push(line);
+    }
+  }
+  return [...reorderedComments, ...nonCommentLines].join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
 
 // src/cli/loaders/xliff.ts
 var _xliff = require('xliff'); var _xliff2 = _interopRequireDefault(_xliff);
@@ -6550,7 +6580,7 @@ async function renderHero() {
 // package.json
 var package_default = {
   name: "lingo.dev",
-  version: "0.92.18",
+  version: "0.93.0",
   description: "Lingo.dev CLI",
   private: false,
   publishConfig: {
@@ -6573,6 +6603,31 @@ var package_default = {
       types: "./build/spec.d.ts",
       import: "./build/spec.mjs",
       require: "./build/spec.cjs"
+    },
+    "./compiler": {
+      types: "./build/compiler.d.ts",
+      import: "./build/compiler.mjs",
+      require: "./build/compiler.cjs"
+    },
+    "./react": {
+      types: "./build/react.d.ts",
+      import: "./build/react.mjs",
+      require: "./build/react.cjs"
+    },
+    "./react/client": {
+      types: "./build/react/client.d.ts",
+      import: "./build/react/client.mjs",
+      require: "./build/react/client.cjs"
+    },
+    "./react/rsc": {
+      types: "./build/react/rsc.d.ts",
+      import: "./build/react/rsc.mjs",
+      require: "./build/react/rsc.cjs"
+    },
+    "./react/react-router": {
+      types: "./build/react/react-router.d.ts",
+      import: "./build/react/react-router.mjs",
+      require: "./build/react/react-router.cjs"
     }
   },
   typesVersions: {
@@ -6585,6 +6640,21 @@ var package_default = {
       ],
       spec: [
         "./build/spec.d.ts"
+      ],
+      compiler: [
+        "./build/compiler.d.ts"
+      ],
+      react: [
+        "./build/react.d.ts"
+      ],
+      "react/client": [
+        "./build/react/client.d.ts"
+      ],
+      "react/rsc": [
+        "./build/react/rsc.d.ts"
+      ],
+      "react/react-router": [
+        "./build/react/react-router.d.ts"
       ]
     }
   },
@@ -6619,6 +6689,8 @@ var package_default = {
     "@inquirer/prompts": "^7.4.1",
     "@lingo.dev/_sdk": "workspace:*",
     "@lingo.dev/_spec": "workspace:*",
+    "@lingo.dev/_react": "workspace:*",
+    "@lingo.dev/_compiler": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.5.0",
     "@paralleldrive/cuid2": "^2.2.2",
     ai: "^4.3.15",