@lingo.dev/_compiler 0.5.3 → 0.5.4

package/build/{chunk-23GDRLDY.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 = {

package/build/{chunk-S326ZU7C.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 = {

package/build/index.cjs

@@ -17,7 +17,7 @@
 
 
 
-var _chunk23GDRLDYcjs = require('./chunk-23GDRLDY.cjs');
+var _chunkPO4OCL2Ucjs = require('./chunk-PO4OCL2U.cjs');
 
 // src/index.ts
 var _unplugin = require('unplugin');
@@ -25,7 +25,7 @@ var _unplugin = require('unplugin');
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.5.3",
+  version: "0.5.4",
   description: "Lingo.dev Compiler",
   private: false,
   publishConfig: {
@@ -130,7 +130,7 @@ async function trackEvent(event, properties) {
   }
 }
 async function getActualId() {
-  const rc = _chunk23GDRLDYcjs.getRc.call(void 0, );
+  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) {
@@ -158,20 +158,20 @@ async function getActualId() {
 // src/index.ts
 var keyCheckers = {
   groq: {
-    checkEnv: _chunk23GDRLDYcjs.getGroqKeyFromEnv,
-    checkRc: _chunk23GDRLDYcjs.getGroqKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getGroqKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getGroqKeyFromRc
   },
   google: {
-    checkEnv: _chunk23GDRLDYcjs.getGoogleKeyFromEnv,
-    checkRc: _chunk23GDRLDYcjs.getGoogleKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getGoogleKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getGoogleKeyFromRc
   },
   mistral: {
-    checkEnv: _chunk23GDRLDYcjs.getMistralKeyFromEnv,
-    checkRc: _chunk23GDRLDYcjs.getMistralKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getMistralKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getMistralKeyFromRc
   },
   "lingo.dev": {
-    checkEnv: _chunk23GDRLDYcjs.getLingoDotDevKeyFromEnv,
-    checkRc: _chunk23GDRLDYcjs.getLingoDotDevKeyFromRc
+    checkEnv: _chunkPO4OCL2Ucjs.getLingoDotDevKeyFromEnv,
+    checkRc: _chunkPO4OCL2Ucjs.getLingoDotDevKeyFromRc
   }
 };
 var alreadySentBuildEvent = { value: false };
@@ -187,14 +187,14 @@ function sendBuildEvent(framework, config, isDev) {
 var unplugin = _unplugin.createUnplugin.call(void 0, 
   (_params, _meta) => {
     console.log("\u2139\uFE0F  Starting Lingo.dev compiler...");
-    const params = _lodash2.default.defaults(_params, _chunk23GDRLDYcjs.defaultParams);
-    if (!_chunk23GDRLDYcjs.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 = _chunk23GDRLDYcjs.getInvalidLocales.call(void 0, 
+        const invalidLocales = _chunkPO4OCL2Ucjs.getInvalidLocales.call(void 0, 
           params.models,
           params.sourceLocale,
           params.targetLocales
@@ -217,7 +217,7 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
         }
       }
     }
-    _chunk23GDRLDYcjs.LCPCache.ensureDictionaryFile({
+    _chunkPO4OCL2Ucjs.LCPCache.ensureDictionaryFile({
       sourceRoot: params.sourceRoot,
       lingoDir: params.lingoDir
     });
@@ -225,9 +225,9 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
     sendBuildEvent("unplugin", params, isDev);
     return {
       name: package_default.name,
-      loadInclude: (id) => !!id.match(_chunk23GDRLDYcjs.LCP_DICTIONARY_FILE_NAME),
+      loadInclude: (id) => !!id.match(_chunkPO4OCL2Ucjs.LCP_DICTIONARY_FILE_NAME),
       async load(id) {
-        const dictionary = await _chunk23GDRLDYcjs.loadDictionary.call(void 0, {
+        const dictionary = await _chunkPO4OCL2Ucjs.loadDictionary.call(void 0, {
           resourcePath: id,
           resourceQuery: "",
           params: {
@@ -251,7 +251,7 @@ var unplugin = _unplugin.createUnplugin.call(void 0,
       enforce: "pre",
       transform(code, id) {
         try {
-          const result = _chunk23GDRLDYcjs.transformComponent.call(void 0, {
+          const result = _chunkPO4OCL2Ucjs.transformComponent.call(void 0, {
             code,
             params,
             resourcePath: id,
@@ -271,7 +271,7 @@ var src_default = {
   next: (compilerParams) => (nextConfig = {}) => {
     const mergedParams = _lodash2.default.merge(
       {},
-      _chunk23GDRLDYcjs.defaultParams,
+      _chunkPO4OCL2Ucjs.defaultParams,
       {
         rsc: true,
         turbopack: {
@@ -322,7 +322,7 @@ var src_default = {
       turbopackConfigPath.rules ??= {};
       const rules = turbopackConfigPath.rules;
       const lingoGlob = `**/*.{ts,tsx,js,jsx}`;
-      const lingoLoaderPath = _chunk23GDRLDYcjs.__require.resolve("./lingo-turbopack-loader");
+      const lingoLoaderPath = _chunkPO4OCL2Ucjs.__require.resolve("./lingo-turbopack-loader");
       rules[lingoGlob] = {
         loaders: [
           {
@@ -337,7 +337,7 @@ var src_default = {
   vite: (compilerParams) => (config) => {
     const mergedParams = _lodash2.default.merge(
       {},
-      _chunk23GDRLDYcjs.defaultParams,
+      _chunkPO4OCL2Ucjs.defaultParams,
       { rsc: false },
       compilerParams
     );
@@ -351,7 +351,7 @@ var src_default = {
 };
 function getConfiguredProviders(models) {
   return _lodash2.default.chain(Object.values(models)).map((modelString) => modelString.split(":")[0]).filter(Boolean).uniq().filter(
-    (providerId) => _chunk23GDRLDYcjs.providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
+    (providerId) => _chunkPO4OCL2Ucjs.providerDetails.hasOwnProperty(providerId) && keyCheckers.hasOwnProperty(providerId)
   ).value();
 }
 function validateLLMKeyDetails(configuredProviders) {
@@ -362,7 +362,7 @@ function validateLLMKeyDetails(configuredProviders) {
   const missingProviders = [];
   const foundProviders = [];
   for (const providerId of configuredProviders) {
-    const details = _chunk23GDRLDYcjs.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

@@ -17,7 +17,7 @@ import {
   loadDictionary,
   providerDetails,
   transformComponent
-} from "./chunk-S326ZU7C.mjs";
+} from "./chunk-ZXNG22MO.mjs";
 
 // src/index.ts
 import { createUnplugin } from "unplugin";
@@ -25,7 +25,7 @@ import { createUnplugin } from "unplugin";
 // package.json
 var package_default = {
   name: "@lingo.dev/_compiler",
-  version: "0.5.3",
+  version: "0.5.4",
   description: "Lingo.dev Compiler",
   private: false,
   publishConfig: {

package/build/lingo-turbopack-loader.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunk23GDRLDYcjs = require('./chunk-23GDRLDY.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 _chunk23GDRLDYcjs.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 = _chunk23GDRLDYcjs.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-S326ZU7C.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.3",
+  "version": "0.5.4",
   "description": "Lingo.dev Compiler",
   "private": false,
   "publishConfig": {