@lingo.dev/_compiler 0.5.2 → 0.5.4

package/build/{chunk-42EM6MWM.cjs → chunk-PO4OCL2U.cjs}

@@ -53,7 +53,8 @@ var defaultParams = {
   rsc: false,
   useDirective: false,
   debug: false,
-  models: {}
+  models: {},
+  prompt: null
 };
 
 // src/_const.ts
@@ -1927,7 +1928,7 @@ var shots_default = [
 // src/lib/lcp/api/index.ts
 
 var LCPAPI = class {
-  static async translate(models, sourceDictionary, sourceLocale, targetLocale) {
+  static async translate(models, sourceDictionary, sourceLocale, targetLocale, prompt) {
     const timeLabel = `LCPAPI.translate: ${targetLocale}`;
     console.time(timeLabel);
     const chunks = this._chunkDictionary(sourceDictionary);
@@ -1937,7 +1938,8 @@ var LCPAPI = class {
         models,
         chunk,
         sourceLocale,
-        targetLocale
+        targetLocale,
+        prompt
       );
       translatedChunks.push(translatedChunk);
     }
@@ -2026,7 +2028,7 @@ var LCPAPI = class {
       apiKey
     });
   }
-  static async _translateChunk(models, sourceDictionary, sourceLocale, targetLocale) {
+  static async _translateChunk(models, sourceDictionary, sourceLocale, targetLocale, prompt) {
     if (models === "lingo.dev") {
       try {
         const lingoDotDevEngine = this._createLingoDotDevEngine();
@@ -2087,7 +2089,11 @@ var LCPAPI = class {
           messages: [
             {
               role: "system",
-              content: prompt_default({ sourceLocale, targetLocale })
+              content: prompt_default({
+                sourceLocale,
+                targetLocale,
+                prompt: _nullishCoalesce(prompt, () => ( void 0))
+              })
             },
             ...shots_default.flatMap((shotsTuple) => [
               {
@@ -2390,7 +2396,8 @@ var LCPServer = (_class = class {
         params.models,
         uncachedSourceDictionary,
         params.sourceLocale,
-        params.targetLocale
+        params.targetLocale,
+        params.prompt
       );
       targetDictionary = this._mergeDictionaries(newTranslations, cache);
       targetDictionary = {
@@ -2703,4 +2710,5 @@ function transformComponent(options) {
 
 
 
-exports.__require = __require; exports.defaultParams = defaultParams; exports.LCP_DICTIONARY_FILE_NAME = LCP_DICTIONARY_FILE_NAME; exports.LCPCache = LCPCache; exports.getInvalidLocales = getInvalidLocales; exports.getGroqKeyFromRc = getGroqKeyFromRc; exports.getGroqKeyFromEnv = getGroqKeyFromEnv; exports.getLingoDotDevKeyFromEnv = getLingoDotDevKeyFromEnv; exports.getLingoDotDevKeyFromRc = getLingoDotDevKeyFromRc; exports.getGoogleKeyFromRc = getGoogleKeyFromRc; exports.getGoogleKeyFromEnv = getGoogleKeyFromEnv; exports.getMistralKeyFromRc = getMistralKeyFromRc; exports.getMistralKeyFromEnv = getMistralKeyFromEnv; exports.isRunningInCIOrDocker = isRunningInCIOrDocker; exports.providerDetails = providerDetails; exports.loadDictionary = loadDictionary; exports.transformComponent = transformComponent;
+
+exports.__require = __require; exports.defaultParams = defaultParams; exports.LCP_DICTIONARY_FILE_NAME = LCP_DICTIONARY_FILE_NAME; exports.LCPCache = LCPCache; exports.getInvalidLocales = getInvalidLocales; exports.getRc = getRc; exports.getGroqKeyFromRc = getGroqKeyFromRc; exports.getGroqKeyFromEnv = getGroqKeyFromEnv; exports.getLingoDotDevKeyFromEnv = getLingoDotDevKeyFromEnv; exports.getLingoDotDevKeyFromRc = getLingoDotDevKeyFromRc; exports.getGoogleKeyFromRc = getGoogleKeyFromRc; exports.getGoogleKeyFromEnv = getGoogleKeyFromEnv; exports.getMistralKeyFromRc = getMistralKeyFromRc; exports.getMistralKeyFromEnv = getMistralKeyFromEnv; exports.isRunningInCIOrDocker = isRunningInCIOrDocker; exports.providerDetails = providerDetails; exports.loadDictionary = loadDictionary; exports.transformComponent = transformComponent;

package/build/{chunk-XCIXY6J2.mjs → chunk-ZXNG22MO.mjs}

@@ -53,7 +53,8 @@ var defaultParams = {
   rsc: false,
   useDirective: false,
   debug: false,
-  models: {}
+  models: {},
+  prompt: null
 };
 
 // src/_const.ts
@@ -1927,7 +1928,7 @@ var shots_default = [
 // src/lib/lcp/api/index.ts
 import dedent2 from "dedent";
 var LCPAPI = class {
-  static async translate(models, sourceDictionary, sourceLocale, targetLocale) {
+  static async translate(models, sourceDictionary, sourceLocale, targetLocale, prompt) {
     const timeLabel = `LCPAPI.translate: ${targetLocale}`;
     console.time(timeLabel);
     const chunks = this._chunkDictionary(sourceDictionary);
@@ -1937,7 +1938,8 @@ var LCPAPI = class {
         models,
         chunk,
         sourceLocale,
-        targetLocale
+        targetLocale,
+        prompt
       );
       translatedChunks.push(translatedChunk);
     }
@@ -2026,7 +2028,7 @@ var LCPAPI = class {
       apiKey
     });
   }
-  static async _translateChunk(models, sourceDictionary, sourceLocale, targetLocale) {
+  static async _translateChunk(models, sourceDictionary, sourceLocale, targetLocale, prompt) {
     if (models === "lingo.dev") {
       try {
         const lingoDotDevEngine = this._createLingoDotDevEngine();
@@ -2087,7 +2089,11 @@ var LCPAPI = class {
           messages: [
             {
               role: "system",
-              content: prompt_default({ sourceLocale, targetLocale })
+              content: prompt_default({
+                sourceLocale,
+                targetLocale,
+                prompt: prompt ?? void 0
+              })
             },
             ...shots_default.flatMap((shotsTuple) => [
               {
@@ -2390,7 +2396,8 @@ var LCPServer = class {
         params.models,
         uncachedSourceDictionary,
         params.sourceLocale,
-        params.targetLocale
+        params.targetLocale,
+        params.prompt
       );
       targetDictionary = this._mergeDictionaries(newTranslations, cache);
       targetDictionary = {
@@ -2691,6 +2698,7 @@ export {
   LCP_DICTIONARY_FILE_NAME,
   LCPCache,
   getInvalidLocales,
+  getRc,
   getGroqKeyFromRc,
   getGroqKeyFromEnv,
   getLingoDotDevKeyFromEnv,

package/build/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
 
@@ -16,7 +16,8 @@
 
 
 
-var _chunk42EM6MWMcjs = require('./chunk-42EM6MWM.cjs');
+
+var _chunkPO4OCL2Ucjs = require('./chunk-PO4OCL2U.cjs');
 
 // src/index.ts
 var _unplugin = require('unplugin');
@@ -24,7 +25,7 @@ var _unplugin = require('unplugin');
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.5.2",
+  version: "0.5.4",
   description: "Lingo.dev Compiler",
   private: false,
   publishConfig: {
@@ -81,7 +82,9 @@ var package_default = {
     prettier: "^3.4.2",
     unplugin: "^2.1.2",
     vitest: "^2.1.4",
-    zod: "^3.24.1"
+    zod: "^3.24.1",
+    "posthog-node": "^4.17.0",
+    "node-machine-id": "^1.1.12"
   },
   packageManager: "pnpm@9.12.3"
 };
@@ -89,35 +92,109 @@ var package_default = {
 // src/index.ts
 var _lodash = require('lodash'); var _lodash2 = _interopRequireDefault(_lodash);
 var _dedent = require('dedent'); var _dedent2 = _interopRequireDefault(_dedent);
+
+// src/utils/observability.ts
+var _nodemachineid = require('node-machine-id');
+async function trackEvent(event, properties) {
+  if (process.env.DO_NOT_TRACK) {
+    return;
+  }
+  try {
+    const actualId = await getActualId();
+    const { PostHog } = await Promise.resolve().then(() => _interopRequireWildcard(require("posthog-node")));
+    const posthog = new PostHog(
+      "phc_eR0iSoQufBxNY36k0f0T15UvHJdTfHlh8rJcxsfhfXk",
+      {
+        host: "https://eu.i.posthog.com",
+        flushAt: 1,
+        flushInterval: 0
+      }
+    );
+    await posthog.capture({
+      distinctId: actualId,
+      event,
+      properties: {
+        ...properties,
+        isByokMode: _optionalChain([properties, 'optionalAccess', _2 => _2.models]) !== "lingo.dev",
+        meta: {
+          version: process.env.npm_package_version,
+          isCi: process.env.CI === "true"
+        }
+      }
+    });
+    await posthog.shutdown();
+  } catch (error) {
+    if (process.env.DEBUG) {
+      console.error(error);
+    }
+  }
+}
+async function getActualId() {
+  const rc = _chunkPO4OCL2Ucjs.getRc.call(void 0, );
+  const apiKey = process.env.LINGODOTDEV_API_KEY || _optionalChain([rc, 'optionalAccess', _3 => _3.auth, 'optionalAccess', _4 => _4.apiKey]);
+  const apiUrl = process.env.LINGODOTDEV_API_URL || _optionalChain([rc, 'optionalAccess', _5 => _5.auth, 'optionalAccess', _6 => _6.apiUrl]) || "https://engine.lingo.dev";
+  if (apiKey) {
+    try {
+      const res = await fetch(`${apiUrl}/whoami`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          ContentType: "application/json"
+        }
+      });
+      if (res.ok) {
+        const payload = await res.json();
+        if (_optionalChain([payload, 'optionalAccess', _7 => _7.email])) {
+          return payload.email;
+        }
+      }
+    } catch (err) {
+    }
+  }
+  const id = await _nodemachineid.machineId.call(void 0, );
+  return `device-${id}`;
+}
+
+// src/index.ts
 var keyCheckers = {
   groq: {
-    checkEnv: _chunk42EM6MWMcjs.getGroqKeyFromEnv,
-    checkRc: _chunk42EM6MWMcjs.getGroqKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getGroqKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getGroqKeyFromRc
   },
   google: {
-    checkEnv: _chunk42EM6MWMcjs.getGoogleKeyFromEnv,
-    checkRc: _chunk42EM6MWMcjs.getGoogleKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getGoogleKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getGoogleKeyFromRc
   },
   mistral: {
-    checkEnv: _chunk42EM6MWMcjs.getMistralKeyFromEnv,
-    checkRc: _chunk42EM6MWMcjs.getMistralKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getMistralKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getMistralKeyFromRc
   },
   "lingo.dev": {
-    checkEnv: _chunk42EM6MWMcjs.getLingoDotDevKeyFromEnv,
-    checkRc: _chunk42EM6MWMcjs.getLingoDotDevKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getLingoDotDevKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getLingoDotDevKeyFromRc
   }
 };
+var alreadySentBuildEvent = { value: false };
+function sendBuildEvent(framework, config, isDev) {
+  if (alreadySentBuildEvent.value) return;
+  alreadySentBuildEvent.value = true;
+  trackEvent("compiler.build.start", {
+    framework,
+    configuration: config,
+    isDevMode: isDev
+  });
+}
 var unplugin = _unplugin.createUnplugin.call(void 0, 
   (_params, _meta) => {
     console.log("\u2139\uFE0F  Starting Lingo.dev compiler...");
-    const params = _lodash2.default.defaults(_params, _chunk42EM6MWMcjs.defaultParams);
-    if (!_chunk42EM6MWMcjs.isRunningInCIOrDocker.call(void 0, )) {
+    const params = _lodash2.default.defaults(_params, _chunkPO4OCL2Ucjs.defaultParams);
+    if (!_chunkPO4OCL2Ucjs.isRunningInCIOrDocker.call(void 0, )) {
       if (params.models === "lingo.dev") {
         validateLLMKeyDetails(["lingo.dev"]);
       } else {
         const configuredProviders = getConfiguredProviders(params.models);
         validateLLMKeyDetails(configuredProviders);
-        const invalidLocales = _chunk42EM6MWMcjs.getInvalidLocales.call(void 0, 
+        const invalidLocales = _chunkPO4OCL2Ucjs.getInvalidLocales.call(void 0, 
           params.models,
           params.sourceLocale,
           params.targetLocales
@@ -140,16 +217,17 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
         }
       }
     }
-    _chunk42EM6MWMcjs.LCPCache.ensureDictionaryFile({
+    _chunkPO4OCL2Ucjs.LCPCache.ensureDictionaryFile({
       sourceRoot: params.sourceRoot,
       lingoDir: params.lingoDir
     });
     const isDev = "dev" in _meta ? !!_meta.dev : process.env.NODE_ENV !== "production";
+    sendBuildEvent("unplugin", params, isDev);
     return {
       name: package_default.name,
-      loadInclude: (id) => !!id.match(_chunk42EM6MWMcjs.LCP_DICTIONARY_FILE_NAME),
+      loadInclude: (id) => !!id.match(_chunkPO4OCL2Ucjs.LCP_DICTIONARY_FILE_NAME),
       async load(id) {
-        const dictionary = await _chunk42EM6MWMcjs.loadDictionary.call(void 0, {
+        const dictionary = await _chunkPO4OCL2Ucjs.loadDictionary.call(void 0, {
           resourcePath: id,
           resourceQuery: "",
           params: {
@@ -165,7 +243,6 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
         if (!dictionary) {
           return null;
         }
-        console.log(JSON.stringify(dictionary, null, 2));
         return {
           code: `export default ${JSON.stringify(dictionary, null, 2)}`
         };
@@ -174,7 +251,7 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
       enforce: "pre",
       transform(code, id) {
         try {
-          const result = _chunk42EM6MWMcjs.transformComponent.call(void 0, {
+          const result = _chunkPO4OCL2Ucjs.transformComponent.call(void 0, {
             code,
             params,
             resourcePath: id,
@@ -194,7 +271,7 @@ var src_default = {
   next: (compilerParams) => (nextConfig = {}) => {
     const mergedParams = _lodash2.default.merge(
       {},
-      _chunk42EM6MWMcjs.defaultParams,
+      _chunkPO4OCL2Ucjs.defaultParams,
       {
         rsc: true,
         turbopack: {
@@ -204,13 +281,15 @@ var src_default = {
       },
       compilerParams
     );
+    const isDev = process.env.NODE_ENV !== "production";
+    sendBuildEvent("Next.js", mergedParams, isDev);
     let turbopackEnabled;
-    if (_optionalChain([mergedParams, 'access', _2 => _2.turbopack, 'optionalAccess', _3 => _3.enabled]) === "auto") {
+    if (_optionalChain([mergedParams, 'access', _8 => _8.turbopack, 'optionalAccess', _9 => _9.enabled]) === "auto") {
       turbopackEnabled = process.env.TURBOPACK === "1" || process.env.TURBOPACK === "true";
     } else {
-      turbopackEnabled = _optionalChain([mergedParams, 'access', _4 => _4.turbopack, 'optionalAccess', _5 => _5.enabled]) === true;
+      turbopackEnabled = _optionalChain([mergedParams, 'access', _10 => _10.turbopack, 'optionalAccess', _11 => _11.enabled]) === true;
     }
-    const supportLegacyTurbo = _optionalChain([mergedParams, 'access', _6 => _6.turbopack, 'optionalAccess', _7 => _7.useLegacyTurbo]) === true;
+    const supportLegacyTurbo = _optionalChain([mergedParams, 'access', _12 => _12.turbopack, 'optionalAccess', _13 => _13.useLegacyTurbo]) === true;
     const hasWebpackConfig = typeof nextConfig.webpack === "function";
     const hasTurbopackConfig = typeof nextConfig.turbopack === "function";
     if (hasWebpackConfig && turbopackEnabled) {
@@ -243,7 +322,7 @@ var src_default = {
       turbopackConfigPath.rules ??= {};
       const rules = turbopackConfigPath.rules;
       const lingoGlob = `**/*.{ts,tsx,js,jsx}`;
-      const lingoLoaderPath = _chunk42EM6MWMcjs.__require.resolve("./lingo-turbopack-loader");
+      const lingoLoaderPath = _chunkPO4OCL2Ucjs.__require.resolve("./lingo-turbopack-loader");
       rules[lingoGlob] = {
         loaders: [
           {
@@ -256,15 +335,23 @@ var src_default = {
     return nextConfig;
   },
   vite: (compilerParams) => (config) => {
-    config.plugins.unshift(
-      unplugin.vite(_lodash2.default.merge({}, _chunk42EM6MWMcjs.defaultParams, { rsc: false }, compilerParams))
+    const mergedParams = _lodash2.default.merge(
+      {},
+      _chunkPO4OCL2Ucjs.defaultParams,
+      { rsc: false },
+      compilerParams
     );
+    const isDev = process.env.NODE_ENV !== "production";
+    const isReactRouter = _optionalChain([config, 'access', _14 => _14.plugins, 'optionalAccess', _15 => _15.flat, 'call', _16 => _16(), 'optionalAccess', _17 => _17.some, 'call', _18 => _18((plugin) => plugin.name === "react-router")]);
+    const framework = isReactRouter ? "React Router" : "Vite";
+    sendBuildEvent(framework, mergedParams, isDev);
+    config.plugins.unshift(unplugin.vite(mergedParams));
     return config;
   }
 };
 function getConfiguredProviders(models) {
   return _lodash2.default.chain(Object.values(models)).map((modelString) => modelString.split(":")[0]).filter(Boolean).uniq().filter(
-    (providerId) => _chunk42EM6MWMcjs.providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
+    (providerId) => _chunkPO4OCL2Ucjs.providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
   ).value();
 }
 function validateLLMKeyDetails(configuredProviders) {
@@ -275,7 +362,7 @@ function validateLLMKeyDetails(configuredProviders) {
   const missingProviders = [];
   const foundProviders = [];
   for (const providerId of configuredProviders) {
-    const details = _chunk42EM6MWMcjs.providerDetails[providerId];
+    const details = _chunkPO4OCL2Ucjs.providerDetails[providerId];
     const checkers = keyCheckers[providerId];
     if (!details || !checkers) continue;
     const foundInEnv = !!checkers.checkEnv();

package/build/index.d.cts

@@ -1,14 +1,91 @@
 import { NextConfig } from 'next';
 
+/**
+ * Options for configuring Lingo.dev Compiler.
+ */
 type CompilerParams = {
+    /**
+     * The locale to translate from.
+     *
+     * This must match one of the following formats:
+     *
+     * - [ISO 639-1 language code](https://en.wikipedia.org/wiki/ISO_639-1) (e.g., `"en"`)
+     * - [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (e.g., `"en-US"`)
+     *
+     * @default "en"
+     */
     sourceLocale: string;
+    /**
+     * The locale(s) to translate to.
+     *
+     * Each locale must match one of the following formats:
+     *
+     * - [ISO 639-1 language code](https://en.wikipedia.org/wiki/ISO_639-1) (e.g., `"en"`)
+     * - [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (e.g., `"en-US"`)
+     *
+     * @default ["es"]
+     */
     targetLocales: string[];
+    /**
+     * The name of the directory where translation files will be stored, relative to `sourceRoot`.
+     *
+     * @default "lingo"
+     */
     lingoDir: string;
+    /**
+     * The directory of the source code that will be translated, relative to the current working directory.
+     *
+     * @default "src"
+     */
     sourceRoot: string;
+    /**
+     * If `true`, the compiler will generate code for React Server Components (RSC).
+     *
+     * When using Vite, this value is always `false`.
+     *
+     * When using Next.js, this value is always `true`.
+     *
+     * @default false
+     */
     rsc: boolean;
+    /**
+     * If `true`, the compiler will only localize files that use the `"use i18n";` directive.
+     *
+     * @default false
+     */
     useDirective: boolean;
+    /**
+     * If `true`, the compiler will log additional information to the console.
+     *
+     * @default false
+     */
     debug: boolean;
+    /**
+     * The model(s) to use for translation.
+     *
+     * If set to `"lingo.dev"`, the compiler will use Lingo.dev Engine.
+     *
+     * If set to an object, the compiler will use the model(s) specified in the object:
+     *
+     * - The key is a string that represents the source and target locales, separated by a colon (e.g., `"en:es"`).
+     * - The value is a string that represents the LLM provider and model, separated by a colon (e.g., `"google:gemini-2.0-flash"`).
+     *
+     * You can use `*` as a wildcard to match any locale.
+     *
+     * If a model is not specified, an error will be thrown.
+     *
+     * @default {}
+     */
     models: "lingo.dev" | Record<string, string>;
+    /**
+     * Custom system prompt for the translation engine. If set, this prompt will override the default system prompt defined in Compiler.
+     * Only works with custom models, not with Lingo.dev Engine.
+     *
+     * Example: "You are a helpful assistant that translates {SOURCE_LOCALE} to {TARGET_LOCALE}."
+     *
+     * @default null
+     */
+    prompt?: string | null;
 };
 declare const defaultParams: CompilerParams;
 

package/build/index.d.ts

@@ -1,14 +1,91 @@
 import { NextConfig } from 'next';
 
+/**
+ * Options for configuring Lingo.dev Compiler.
+ */
 type CompilerParams = {
+    /**
+     * The locale to translate from.
+     *
+     * This must match one of the following formats:
+     *
+     * - [ISO 639-1 language code](https://en.wikipedia.org/wiki/ISO_639-1) (e.g., `"en"`)
+     * - [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (e.g., `"en-US"`)
+     *
+     * @default "en"
+     */
     sourceLocale: string;
+    /**
+     * The locale(s) to translate to.
+     *
+     * Each locale must match one of the following formats:
+     *
+     * - [ISO 639-1 language code](https://en.wikipedia.org/wiki/ISO_639-1) (e.g., `"en"`)
+     * - [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) (e.g., `"en-US"`)
+     *
+     * @default ["es"]
+     */
     targetLocales: string[];
+    /**
+     * The name of the directory where translation files will be stored, relative to `sourceRoot`.
+     *
+     * @default "lingo"
+     */
     lingoDir: string;
+    /**
+     * The directory of the source code that will be translated, relative to the current working directory.
+     *
+     * @default "src"
+     */
     sourceRoot: string;
+    /**
+     * If `true`, the compiler will generate code for React Server Components (RSC).
+     *
+     * When using Vite, this value is always `false`.
+     *
+     * When using Next.js, this value is always `true`.
+     *
+     * @default false
+     */
     rsc: boolean;
+    /**
+     * If `true`, the compiler will only localize files that use the `"use i18n";` directive.
+     *
+     * @default false
+     */
     useDirective: boolean;
+    /**
+     * If `true`, the compiler will log additional information to the console.
+     *
+     * @default false
+     */
     debug: boolean;
+    /**
+     * The model(s) to use for translation.
+     *
+     * If set to `"lingo.dev"`, the compiler will use Lingo.dev Engine.
+     *
+     * If set to an object, the compiler will use the model(s) specified in the object:
+     *
+     * - The key is a string that represents the source and target locales, separated by a colon (e.g., `"en:es"`).
+     * - The value is a string that represents the LLM provider and model, separated by a colon (e.g., `"google:gemini-2.0-flash"`).
+     *
+     * You can use `*` as a wildcard to match any locale.
+     *
+     * If a model is not specified, an error will be thrown.
+     *
+     * @default {}
+     */
     models: "lingo.dev" | Record<string, string>;
+    /**
+     * Custom system prompt for the translation engine. If set, this prompt will override the default system prompt defined in Compiler.
+     * Only works with custom models, not with Lingo.dev Engine.
+     *
+     * Example: "You are a helpful assistant that translates {SOURCE_LOCALE} to {TARGET_LOCALE}."
+     *
+     * @default null
+     */
+    prompt?: string | null;
 };
 declare const defaultParams: CompilerParams;
 

package/build/index.mjs

@@ -12,11 +12,12 @@ import {
   getLingoDotDevKeyFromRc,
   getMistralKeyFromEnv,
   getMistralKeyFromRc,
+  getRc,
   isRunningInCIOrDocker,
   loadDictionary,
   providerDetails,
   transformComponent
-} from "./chunk-XCIXY6J2.mjs";
+} from "./chunk-ZXNG22MO.mjs";
 
 // src/index.ts
 import { createUnplugin } from "unplugin";
@@ -24,7 +25,7 @@ import { createUnplugin } from "unplugin";
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.5.2",
+  version: "0.5.4",
   description: "Lingo.dev Compiler",
   private: false,
   publishConfig: {
@@ -81,7 +82,9 @@ var package_default = {
     prettier: "^3.4.2",
     unplugin: "^2.1.2",
     vitest: "^2.1.4",
-    zod: "^3.24.1"
+    zod: "^3.24.1",
+    "posthog-node": "^4.17.0",
+    "node-machine-id": "^1.1.12"
   },
   packageManager: "pnpm@9.12.3"
 };
@@ -89,6 +92,70 @@ var package_default = {
 // src/index.ts
 import _ from "lodash";
 import dedent from "dedent";
+
+// src/utils/observability.ts
+import { machineId } from "node-machine-id";
+async function trackEvent(event, properties) {
+  if (process.env.DO_NOT_TRACK) {
+    return;
+  }
+  try {
+    const actualId = await getActualId();
+    const { PostHog } = await import("posthog-node");
+    const posthog = new PostHog(
+      "phc_eR0iSoQufBxNY36k0f0T15UvHJdTfHlh8rJcxsfhfXk",
+      {
+        host: "https://eu.i.posthog.com",
+        flushAt: 1,
+        flushInterval: 0
+      }
+    );
+    await posthog.capture({
+      distinctId: actualId,
+      event,
+      properties: {
+        ...properties,
+        isByokMode: properties?.models !== "lingo.dev",
+        meta: {
+          version: process.env.npm_package_version,
+          isCi: process.env.CI === "true"
+        }
+      }
+    });
+    await posthog.shutdown();
+  } catch (error) {
+    if (process.env.DEBUG) {
+      console.error(error);
+    }
+  }
+}
+async function getActualId() {
+  const rc = getRc();
+  const apiKey = process.env.LINGODOTDEV_API_KEY || rc?.auth?.apiKey;
+  const apiUrl = process.env.LINGODOTDEV_API_URL || rc?.auth?.apiUrl || "https://engine.lingo.dev";
+  if (apiKey) {
+    try {
+      const res = await fetch(`${apiUrl}/whoami`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          ContentType: "application/json"
+        }
+      });
+      if (res.ok) {
+        const payload = await res.json();
+        if (payload?.email) {
+          return payload.email;
+        }
+      }
+    } catch (err) {
+    }
+  }
+  const id = await machineId();
+  return `device-${id}`;
+}
+
+// src/index.ts
 var keyCheckers = {
   groq: {
     checkEnv: getGroqKeyFromEnv,
@@ -107,6 +174,16 @@ var keyCheckers = {
     checkRc: getLingoDotDevKeyFromRc
   }
 };
+var alreadySentBuildEvent = { value: false };
+function sendBuildEvent(framework, config, isDev) {
+  if (alreadySentBuildEvent.value) return;
+  alreadySentBuildEvent.value = true;
+  trackEvent("compiler.build.start", {
+    framework,
+    configuration: config,
+    isDevMode: isDev
+  });
+}
 var unplugin = createUnplugin(
   (_params, _meta) => {
     console.log("\u2139\uFE0F  Starting Lingo.dev compiler...");
@@ -145,6 +222,7 @@ var unplugin = createUnplugin(
       lingoDir: params.lingoDir
     });
     const isDev = "dev" in _meta ? !!_meta.dev : process.env.NODE_ENV !== "production";
+    sendBuildEvent("unplugin", params, isDev);
     return {
       name: package_default.name,
       loadInclude: (id) => !!id.match(LCP_DICTIONARY_FILE_NAME),
@@ -165,7 +243,6 @@ var unplugin = createUnplugin(
         if (!dictionary) {
           return null;
         }
-        console.log(JSON.stringify(dictionary, null, 2));
         return {
           code: `export default ${JSON.stringify(dictionary, null, 2)}`
         };
@@ -204,6 +281,8 @@ var src_default = {
       },
       compilerParams
     );
+    const isDev = process.env.NODE_ENV !== "production";
+    sendBuildEvent("Next.js", mergedParams, isDev);
     let turbopackEnabled;
     if (mergedParams.turbopack?.enabled === "auto") {
       turbopackEnabled = process.env.TURBOPACK === "1" || process.env.TURBOPACK === "true";
@@ -256,9 +335,17 @@ var src_default = {
     return nextConfig;
   },
   vite: (compilerParams) => (config) => {
-    config.plugins.unshift(
-      unplugin.vite(_.merge({}, defaultParams, { rsc: false }, compilerParams))
+    const mergedParams = _.merge(
+      {},
+      defaultParams,
+      { rsc: false },
+      compilerParams
     );
+    const isDev = process.env.NODE_ENV !== "production";
+    const isReactRouter = config.plugins?.flat()?.some((plugin) => plugin.name === "react-router");
+    const framework = isReactRouter ? "React Router" : "Vite";
+    sendBuildEvent(framework, mergedParams, isDev);
+    config.plugins.unshift(unplugin.vite(mergedParams));
     return config;
   }
 };

package/build/lingo-turbopack-loader.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunk42EM6MWMcjs = require('./chunk-42EM6MWM.cjs');
+var _chunkPO4OCL2Ucjs = require('./chunk-PO4OCL2U.cjs');
 
 // src/lingo-turbopack-loader.ts
 async function lingo_turbopack_loader_default(source) {
@@ -9,7 +9,7 @@ async function lingo_turbopack_loader_default(source) {
   const params = this.getOptions();
   const isDev = process.env.NODE_ENV !== "production";
   try {
-    const dictionary = await _chunk42EM6MWMcjs.loadDictionary.call(void 0, {
+    const dictionary = await _chunkPO4OCL2Ucjs.loadDictionary.call(void 0, {
       resourcePath: this.resourcePath,
       resourceQuery: this.resourceQuery,
       params,
@@ -21,7 +21,7 @@ async function lingo_turbopack_loader_default(source) {
       const code = `export default ${JSON.stringify(dictionary, null, 2)};`;
       return callback(null, code);
     }
-    const result = _chunk42EM6MWMcjs.transformComponent.call(void 0, {
+    const result = _chunkPO4OCL2Ucjs.transformComponent.call(void 0, {
       code: source,
       params,
       resourcePath: this.resourcePath,

package/build/lingo-turbopack-loader.mjs

@@ -1,7 +1,7 @@
 import {
   loadDictionary,
   transformComponent
-} from "./chunk-XCIXY6J2.mjs";
+} from "./chunk-ZXNG22MO.mjs";
 
 // src/lingo-turbopack-loader.ts
 async function lingo_turbopack_loader_default(source) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/_compiler",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Lingo.dev Compiler",
   "private": false,
   "publishConfig": {
@@ -50,7 +50,9 @@
     "unplugin": "^2.1.2",
     "vitest": "^2.1.4",
     "zod": "^3.24.1",
-    "@lingo.dev/_sdk": "0.9.5"
+    "posthog-node": "^4.17.0",
+    "node-machine-id": "^1.1.12",
+    "@lingo.dev/_sdk": "0.9.6"
   },
   "scripts": {
     "dev": "tsup --watch",