@intlayer/ai 8.11.1 → 8.11.2

package/dist/assets/translateJSON/PROMPT_JSON.md

@@ -1,4 +1,4 @@
-You are an expert AI localization engine specialized in software internationalization (i18n). Your task is to translate and adapt JSON content from a source locale to a specific target locale.
+You are an expert AI localization engine powered by Intlayer specialized in software internationalization (i18n). Your task is to translate and adapt JSON content from a source locale to a specific target locale.
 
 **CRITICAL INSTRUCTION:**
 

package/dist/assets/translateJSON/PROMPT_TOON.md

@@ -1,4 +1,4 @@
-You are an expert AI localization engine specialized in software internationalization (i18n). Your task is to translate and adapt content from a source locale to a specific target locale.
+You are an expert AI localization engine powered by Intlayer specialized in software internationalization (i18n). Your task is to translate and adapt content from a source locale to a specific target locale.
 
 **CRITICAL INSTRUCTION:**
 

package/dist/cjs/_virtual/_utils_asset.cjs

@@ -1,4 +1,3 @@
-const require_runtime = require('./_rolldown/runtime.cjs');
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_url = require("node:url");

package/dist/cjs/auditDictionaryMetadata/index.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require__utils_asset = require('../_virtual/_utils_asset.cjs');
 let ai = require("ai");
 let zod = require("zod");

package/dist/cjs/auditDictionaryMetadata/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["readAsset","Output","z"],"sources":["../../../src/auditDictionaryMetadata/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { generateText, Output } from 'ai';\nimport { z } from 'zod';\nimport type { AIConfig, AIOptions } from '../aiSdk';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type AuditDictionaryMetadataOptions = {\n  fileContent: string;\n  tags?: Tag[];\n  aiConfig: AIConfig;\n  applicationContext?: string;\n};\n\nexport type AuditFileResultData = {\n  fileContent: {\n    title: string;\n    description: string;\n    tags: string[];\n  };\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  // Keep default options\n};\n\n/**\n * Audits a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const auditDictionaryMetadata = async ({\n  fileContent,\n  tags,\n  aiConfig,\n  applicationContext,\n}: AuditDictionaryMetadataOptions): Promise<\n  AuditFileResultData | undefined\n> => {\n  const CHAT_GPT_PROMPT = readAsset('./PROMPT.md');\n  const EXAMPLE_REQUEST = readAsset('./EXAMPLE_REQUEST.md');\n  const EXAMPLE_RESPONSE = readAsset('./EXAMPLE_RESPONSE.md');\n\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = CHAT_GPT_PROMPT.replace(\n    '{{applicationContext}}',\n    applicationContext ?? ''\n  ).replace(\n    '{{tags}}',\n    tags\n      ? JSON.stringify(\n          tags\n            .map(({ key, description }) => `- ${key}: ${description}`)\n            .join('\\n\\n'),\n          null,\n          2\n        )\n      : ''\n  );\n\n  const { dataSerialization, ...restAiConfig } = aiConfig;\n  const { output: _unusedOutput, ...validAiConfig } = restAiConfig;\n\n  // Use the AI SDK to generate the completion\n  const { output, usage } = await generateText({\n    ...validAiConfig,\n    output: Output.object({\n      schema: z.object({\n        title: z.string(),\n        description: z.string(),\n        tags: z.array(z.string()),\n      }),\n    }),\n    system: prompt,\n    messages: [\n      { role: 'user', content: EXAMPLE_REQUEST },\n      { role: 'assistant', content: EXAMPLE_RESPONSE },\n      {\n        role: 'user',\n        content: fileContent,\n      },\n    ],\n  });\n\n  return {\n    fileContent: output,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;;;AA0BA,MAAa,mBAA8B,CAE3C;;;;;;AAOA,MAAa,0BAA0B,OAAO,EAC5C,aACA,MACA,UACA,yBAGG;CACH,MAAM,kBAAkBA,+BAAU,aAAa;CAC/C,MAAM,kBAAkBA,+BAAU,sBAAsB;CACxD,MAAM,mBAAmBA,+BAAU,uBAAuB;CAG1D,MAAM,SAAS,gBAAgB,QAC7B,0BACA,sBAAsB,EACxB,EAAE,QACA,YACA,OACI,KAAK,UACH,KACG,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,aAAa,EACxD,KAAK,MAAM,GACd,MACA,CACF,IACA,EACN;CAEA,MAAM,EAAE,mBAAmB,GAAG,iBAAiB;CAC/C,MAAM,EAAE,QAAQ,eAAe,GAAG,kBAAkB;CAGpD,MAAM,EAAE,QAAQ,UAAU,2BAAmB;EAC3C,GAAG;EACH,QAAQC,UAAO,OAAO,EACpB,QAAQC,MAAE,OAAO;GACf,OAAOA,MAAE,OAAO;GAChB,aAAaA,MAAE,OAAO;GACtB,MAAMA,MAAE,MAAMA,MAAE,OAAO,CAAC;EAC1B,CAAC,EACH,CAAC;EACD,QAAQ;EACR,UAAU;GACR;IAAE,MAAM;IAAQ,SAAS;GAAgB;GACzC;IAAE,MAAM;IAAa,SAAS;GAAiB;GAC/C;IACE,MAAM;IACN,SAAS;GACX;EACF;CACF,CAAC;CAED,OAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;CACnC;AACF"}
+{"version":3,"file":"index.cjs","names":["readAsset","Output","z"],"sources":["../../../src/auditDictionaryMetadata/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { generateText, Output } from 'ai';\nimport { z } from 'zod';\nimport type { AIConfig, AIOptions } from '../aiSdk';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type AuditDictionaryMetadataOptions = {\n  fileContent: string;\n  tags?: Tag[];\n  aiConfig: AIConfig;\n  applicationContext?: string;\n};\n\nexport type AuditFileResultData = {\n  fileContent: {\n    title: string;\n    description: string;\n    tags: string[];\n  };\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  // Keep default options\n};\n\n/**\n * Audits a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const auditDictionaryMetadata = async ({\n  fileContent,\n  tags,\n  aiConfig,\n  applicationContext,\n}: AuditDictionaryMetadataOptions): Promise<\n  AuditFileResultData | undefined\n> => {\n  const CHAT_GPT_PROMPT = readAsset('./PROMPT.md');\n  const EXAMPLE_REQUEST = readAsset('./EXAMPLE_REQUEST.md');\n  const EXAMPLE_RESPONSE = readAsset('./EXAMPLE_RESPONSE.md');\n\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = CHAT_GPT_PROMPT.replace(\n    '{{applicationContext}}',\n    applicationContext ?? ''\n  ).replace(\n    '{{tags}}',\n    tags\n      ? JSON.stringify(\n          tags\n            .map(({ key, description }) => `- ${key}: ${description}`)\n            .join('\\n\\n'),\n          null,\n          2\n        )\n      : ''\n  );\n\n  const { dataSerialization, ...restAiConfig } = aiConfig;\n  const { output: _unusedOutput, ...validAiConfig } = restAiConfig;\n\n  // Use the AI SDK to generate the completion\n  const { output, usage } = await generateText({\n    ...validAiConfig,\n    output: Output.object({\n      schema: z.object({\n        title: z.string(),\n        description: z.string(),\n        tags: z.array(z.string()),\n      }),\n    }),\n    system: prompt,\n    messages: [\n      { role: 'user', content: EXAMPLE_REQUEST },\n      { role: 'assistant', content: EXAMPLE_RESPONSE },\n      {\n        role: 'user',\n        content: fileContent,\n      },\n    ],\n  });\n\n  return {\n    fileContent: output,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;;AA0BA,MAAa,mBAA8B,CAE3C;;;;;;AAOA,MAAa,0BAA0B,OAAO,EAC5C,aACA,MACA,UACA,yBAGG;CACH,MAAM,kBAAkBA,+BAAU,aAAa;CAC/C,MAAM,kBAAkBA,+BAAU,sBAAsB;CACxD,MAAM,mBAAmBA,+BAAU,uBAAuB;CAG1D,MAAM,SAAS,gBAAgB,QAC7B,0BACA,sBAAsB,EACxB,EAAE,QACA,YACA,OACI,KAAK,UACH,KACG,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,aAAa,EACxD,KAAK,MAAM,GACd,MACA,CACF,IACA,EACN;CAEA,MAAM,EAAE,mBAAmB,GAAG,iBAAiB;CAC/C,MAAM,EAAE,QAAQ,eAAe,GAAG,kBAAkB;CAGpD,MAAM,EAAE,QAAQ,UAAU,2BAAmB;EAC3C,GAAG;EACH,QAAQC,UAAO,OAAO,EACpB,QAAQC,MAAE,OAAO;GACf,OAAOA,MAAE,OAAO;GAChB,aAAaA,MAAE,OAAO;GACtB,MAAMA,MAAE,MAAMA,MAAE,OAAO,CAAC;EAC1B,CAAC,EACH,CAAC;EACD,QAAQ;EACR,UAAU;GACR;IAAE,MAAM;IAAQ,SAAS;GAAgB;GACzC;IAAE,MAAM;IAAa,SAAS;GAAiB;GAC/C;IACE,MAAM;IACN,SAAS;GACX;EACF;CACF,CAAC;CAED,OAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;CACnC;AACF"}

package/dist/cjs/customQuery.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 let ai = require("ai");
 
 //#region src/customQuery.ts

package/dist/cjs/customQuery.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"customQuery.cjs","names":[],"sources":["../../src/customQuery.ts"],"sourcesContent":["import { generateText, type SystemModelMessage } from 'ai';\nimport type { AIConfig, AIOptions, Messages } from './aiSdk';\n\nexport type CustomQueryOptions = {\n  messages: Messages;\n  system?: string | SystemModelMessage | SystemModelMessage[];\n  aiConfig: AIConfig;\n};\n\nexport type CustomQueryResultData = {\n  fileContent: string;\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  model: 'gpt-4o-mini',\n  // Keep default options\n};\n\n/**\n * CustomQuery a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const customQuery = async ({\n  messages,\n  system,\n  aiConfig,\n}: CustomQueryOptions): Promise<CustomQueryResultData | undefined> => {\n  // Use the AI SDK to generate the completion\n  const { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    system,\n    messages,\n  });\n\n  return {\n    fileContent: newContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;AAcA,MAAa,mBAA8B,EACzC,OAAO,cAET;;;;;;AAOA,MAAa,cAAc,OAAO,EAChC,UACA,QACA,eACoE;CAEpE,MAAM,EAAE,MAAM,YAAY,UAAU,2BAAmB;EACrD,GAAG;EACH;EACA;CACF,CAAC;CAED,OAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;CACnC;AACF"}
+{"version":3,"file":"customQuery.cjs","names":[],"sources":["../../src/customQuery.ts"],"sourcesContent":["import { generateText, type SystemModelMessage } from 'ai';\nimport type { AIConfig, AIOptions, Messages } from './aiSdk';\n\nexport type CustomQueryOptions = {\n  messages: Messages;\n  system?: string | SystemModelMessage | SystemModelMessage[];\n  aiConfig: AIConfig;\n};\n\nexport type CustomQueryResultData = {\n  fileContent: string;\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  model: 'gpt-4o-mini',\n  // Keep default options\n};\n\n/**\n * CustomQuery a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const customQuery = async ({\n  messages,\n  system,\n  aiConfig,\n}: CustomQueryOptions): Promise<CustomQueryResultData | undefined> => {\n  // Use the AI SDK to generate the completion\n  const { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    system,\n    messages,\n  });\n\n  return {\n    fileContent: newContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;AAcA,MAAa,mBAA8B,EACzC,OAAO,cAET;;;;;;AAOA,MAAa,cAAc,OAAO,EAChC,UACA,QACA,eACoE;CAEpE,MAAM,EAAE,MAAM,YAAY,UAAU,2BAAmB;EACrD,GAAG;EACH;EACA;CACF,CAAC;CAED,OAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;CACnC;AACF"}

package/dist/cjs/index.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_customQuery = require('./customQuery.cjs');
 const require_aiSdk = require('./aiSdk.cjs');
 const require_auditDictionaryMetadata_index = require('./auditDictionaryMetadata/index.cjs');

package/dist/cjs/translateJSON/index.cjs

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require__utils_asset = require('../_virtual/_utils_asset.cjs');
 const require_utils_extractJSON = require('../utils/extractJSON.cjs');
 let ai = require("ai");

package/dist/cjs/translateJSON/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["AIProvider","DEFAULT_LOCALE","z","readAsset","Output","extractJson"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { DEFAULT_LOCALE } from '@intlayer/config/defaultValues';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { decode, encode } from '@toon-format/toon';\nimport { generateText, Output } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\nimport { extractJson } from '../utils/extractJSON';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type TranslateJSONOptions<T = JSON> = {\n  entryFileContent: T;\n  presetOutputContent: Partial<T>;\n  dictionaryDescription?: string;\n  entryLocale: Locale;\n  outputLocale: Locale;\n  tags?: Tag[];\n  aiConfig: AIConfig;\n  mode: 'complete' | 'review';\n  applicationContext?: string;\n};\n\nexport type TranslateJSONResultData<T = JSON> = {\n  fileContent: T;\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  provider: AIProvider.OPENAI,\n  model: 'gpt-5-mini',\n};\n\n/**\n * Format a locale with its name.\n *\n * @param locale - The locale to format.\n * @returns A string in the format \"locale: name\", e.g. \"en: English\".\n */\nconst formatLocaleWithName = (locale: Locale): string =>\n  `${locale}: ${getLocaleName(locale, DEFAULT_LOCALE)}`;\n\n/**\n * Formats tag instructions for the AI prompt.\n * Creates a string with all available tags and their descriptions.\n *\n * @param tags - The list of tags to format.\n * @returns A formatted string with tag instructions.\n */\nconst formatTagInstructions = (tags: Tag[]): string => {\n  if (!tags || tags.length === 0) {\n    return '';\n  }\n\n  // Prepare the tag instructions.\n  return `Based on the dictionary content, identify specific tags from the list below that would be relevant:\n  \n${tags.map(({ key, description }) => `- ${key}: ${description}`).join('\\n\\n')}`;\n};\n\nconst getModeInstructions = (mode: 'complete' | 'review'): string => {\n  if (mode === 'complete') {\n    return 'Mode: \"Complete\" - Enrich the preset content with the missing keys and values in the output locale. Do not update existing keys. Everything should be returned in the output.';\n  }\n\n  return 'Mode: \"Review\" - Fill missing content and review existing keys from the preset content. If a key from the entry is missing in the output, it must be translated to the target language and added. If you detect misspelled content, or content that should be reformulated, correct it. If a translation is not coherent with the desired language, translate it.';\n};\n\nconst jsonToZod = (content: any): z.ZodTypeAny => {\n  // Base case: content is a string (the translation target)\n  if (typeof content === 'string') {\n    return z.string();\n  }\n\n  // Base cases: primitives often preserved in i18n files (e.g. strict numbers/booleans)\n  if (typeof content === 'number') {\n    return z.number();\n  }\n  if (typeof content === 'boolean') {\n    return z.boolean();\n  }\n\n  // Recursive case: Array\n  if (Array.isArray(content)) {\n    // If array is empty, we assume array of strings as default for i18n\n    if (content.length === 0) {\n      return z.array(z.string());\n    }\n    // We assume all items in the array share the structure of the first item\n    return z.array(jsonToZod(content[0]));\n  }\n\n  // Recursive case: Object\n  if (typeof content === 'object' && content !== null) {\n    const shape: Record<string, z.ZodTypeAny> = {};\n    for (const key in content) {\n      shape[key] = jsonToZod(content[key]);\n    }\n    return z.object(shape);\n  }\n\n  // Fallback\n  return z.string();\n};\n\nconst countKeys = (obj: any): number => {\n  if (typeof obj !== 'object' || obj === null) return 0;\n  let count = 0;\n  for (const key in obj) {\n    count += 1 + countKeys(obj[key]);\n  }\n  return count;\n};\n\n/**\n * TranslateJSONs a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const translateJSON = async <T>({\n  entryFileContent,\n  presetOutputContent,\n  dictionaryDescription,\n  aiConfig,\n  entryLocale,\n  outputLocale,\n  tags,\n  mode,\n  applicationContext,\n}: TranslateJSONOptions<T>): Promise<\n  TranslateJSONResultData<T> | undefined\n> => {\n  const { dataSerialization, ...restAiConfig } = aiConfig;\n  const { output: _unusedOutput, ...validAiConfig } = restAiConfig;\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\n\n  const isToon = dataSerialization === 'toon';\n  const promptFile = readAsset(\n    isToon ? './PROMPT_TOON.md' : './PROMPT_JSON.md'\n  );\n  const entryContentStr = isToon\n    ? encode(entryFileContent)\n    : JSON.stringify(entryFileContent);\n  const presetContentStr = isToon\n    ? encode(presetOutputContent)\n    : JSON.stringify(presetOutputContent);\n\n  const schema = jsonToZod(entryFileContent);\n\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = promptFile\n    .replace('{{entryLocale}}', formattedEntryLocale)\n    .replace('{{outputLocale}}', formattedOutputLocale)\n    .replace('{{presetOutputContent}}', presetContentStr)\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  if (isToon) {\n    const { text, usage } = await generateText({\n      ...aiConfig,\n      system: prompt,\n      messages: [\n        {\n          role: 'user',\n          content: [\n            `# Translation Request`,\n            `Please translate the following TOON content.`,\n            `- **From:** ${formattedEntryLocale}`,\n            `- **To:** ${formattedOutputLocale}`,\n            ``,\n            `## Entry Content:`,\n            entryContentStr,\n          ].join('\\n'),\n        },\n      ],\n    });\n\n    // Strip markdown code blocks if present\n    const cleanedText = text\n      .replace(/^```(?:toon)?\\n([\\s\\S]*?)\\n```$/gm, '$1')\n      .trim();\n\n    const decodedJson = decode(cleanedText) as T;\n\n    // schema.parse(decodedJson);\n\n    return {\n      fileContent: decodedJson,\n      tokenUsed: usage?.totalTokens ?? 0,\n    };\n  }\n\n  const totalKeys = countKeys(entryFileContent);\n\n  const MAX_SAFE_KEYS = 70; // You will need to tune this threshold based on testing\n\n  const useStrictOutput = totalKeys <= MAX_SAFE_KEYS;\n\n  // Use the AI SDK to generate the completion\n  const { text, usage } = await generateText({\n    ...validAiConfig,\n\n    // Disable schema if Schema is too complex (Block with Anthropic)\n    output: useStrictOutput ? Output.object({ schema }) : undefined,\n    system: prompt,\n    messages: [\n      {\n        role: 'user',\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `CRITICAL INSTRUCTIONS:`,\n          `- You MUST return ONLY raw, valid JSON.`,\n          `- DO NOT wrap the response in Markdown code blocks (e.g., no \\`\\`\\`json).`,\n          `- DO NOT include any conversational text before or after the JSON object.`,\n          ``,\n          `## Entry Content:`,\n          entryContentStr,\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  // Extract and re-validate deeply\n  const extractedJSON = extractJson(text);\n  const validatedContent = schema.parse(extractedJSON) as T;\n\n  return {\n    fileContent: validatedContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["AIProvider","DEFAULT_LOCALE","z","readAsset","Output","extractJson"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { DEFAULT_LOCALE } from '@intlayer/config/defaultValues';\nimport { getLocaleName } from '@intlayer/core/localization';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { decode, encode } from '@toon-format/toon';\nimport { generateText, Output } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\nimport { extractJson } from '../utils/extractJSON';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type TranslateJSONOptions<T = JSON> = {\n  entryFileContent: T;\n  presetOutputContent: Partial<T>;\n  dictionaryDescription?: string;\n  entryLocale: Locale;\n  outputLocale: Locale;\n  tags?: Tag[];\n  aiConfig: AIConfig;\n  mode: 'complete' | 'review';\n  applicationContext?: string;\n};\n\nexport type TranslateJSONResultData<T = JSON> = {\n  fileContent: T;\n  tokenUsed: number;\n};\n\nexport const aiDefaultOptions: AIOptions = {\n  provider: AIProvider.OPENAI,\n  model: 'gpt-5-mini',\n};\n\n/**\n * Format a locale with its name.\n *\n * @param locale - The locale to format.\n * @returns A string in the format \"locale: name\", e.g. \"en: English\".\n */\nconst formatLocaleWithName = (locale: Locale): string =>\n  `${locale}: ${getLocaleName(locale, DEFAULT_LOCALE)}`;\n\n/**\n * Formats tag instructions for the AI prompt.\n * Creates a string with all available tags and their descriptions.\n *\n * @param tags - The list of tags to format.\n * @returns A formatted string with tag instructions.\n */\nconst formatTagInstructions = (tags: Tag[]): string => {\n  if (!tags || tags.length === 0) {\n    return '';\n  }\n\n  // Prepare the tag instructions.\n  return `Based on the dictionary content, identify specific tags from the list below that would be relevant:\n  \n${tags.map(({ key, description }) => `- ${key}: ${description}`).join('\\n\\n')}`;\n};\n\nconst getModeInstructions = (mode: 'complete' | 'review'): string => {\n  if (mode === 'complete') {\n    return 'Mode: \"Complete\" - Enrich the preset content with the missing keys and values in the output locale. Do not update existing keys. Everything should be returned in the output.';\n  }\n\n  return 'Mode: \"Review\" - Fill missing content and review existing keys from the preset content. If a key from the entry is missing in the output, it must be translated to the target language and added. If you detect misspelled content, or content that should be reformulated, correct it. If a translation is not coherent with the desired language, translate it.';\n};\n\nconst jsonToZod = (content: any): z.ZodTypeAny => {\n  // Base case: content is a string (the translation target)\n  if (typeof content === 'string') {\n    return z.string();\n  }\n\n  // Base cases: primitives often preserved in i18n files (e.g. strict numbers/booleans)\n  if (typeof content === 'number') {\n    return z.number();\n  }\n  if (typeof content === 'boolean') {\n    return z.boolean();\n  }\n\n  // Recursive case: Array\n  if (Array.isArray(content)) {\n    // If array is empty, we assume array of strings as default for i18n\n    if (content.length === 0) {\n      return z.array(z.string());\n    }\n    // We assume all items in the array share the structure of the first item\n    return z.array(jsonToZod(content[0]));\n  }\n\n  // Recursive case: Object\n  if (typeof content === 'object' && content !== null) {\n    const shape: Record<string, z.ZodTypeAny> = {};\n    for (const key in content) {\n      shape[key] = jsonToZod(content[key]);\n    }\n    return z.object(shape);\n  }\n\n  // Fallback\n  return z.string();\n};\n\nconst countKeys = (obj: any): number => {\n  if (typeof obj !== 'object' || obj === null) return 0;\n  let count = 0;\n  for (const key in obj) {\n    count += 1 + countKeys(obj[key]);\n  }\n  return count;\n};\n\n/**\n * TranslateJSONs a content declaration file by constructing a prompt for AI models.\n * The prompt includes details about the project's locales, file paths of content declarations,\n * and requests for identifying issues or inconsistencies.\n */\nexport const translateJSON = async <T>({\n  entryFileContent,\n  presetOutputContent,\n  dictionaryDescription,\n  aiConfig,\n  entryLocale,\n  outputLocale,\n  tags,\n  mode,\n  applicationContext,\n}: TranslateJSONOptions<T>): Promise<\n  TranslateJSONResultData<T> | undefined\n> => {\n  const { dataSerialization, ...restAiConfig } = aiConfig;\n  const { output: _unusedOutput, ...validAiConfig } = restAiConfig;\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\n\n  const isToon = dataSerialization === 'toon';\n  const promptFile = readAsset(\n    isToon ? './PROMPT_TOON.md' : './PROMPT_JSON.md'\n  );\n  const entryContentStr = isToon\n    ? encode(entryFileContent)\n    : JSON.stringify(entryFileContent);\n  const presetContentStr = isToon\n    ? encode(presetOutputContent)\n    : JSON.stringify(presetOutputContent);\n\n  const schema = jsonToZod(entryFileContent);\n\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = promptFile\n    .replace('{{entryLocale}}', formattedEntryLocale)\n    .replace('{{outputLocale}}', formattedOutputLocale)\n    .replace('{{presetOutputContent}}', presetContentStr)\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  if (isToon) {\n    const { text, usage } = await generateText({\n      ...aiConfig,\n      system: prompt,\n      messages: [\n        {\n          role: 'user',\n          content: [\n            `# Translation Request`,\n            `Please translate the following TOON content.`,\n            `- **From:** ${formattedEntryLocale}`,\n            `- **To:** ${formattedOutputLocale}`,\n            ``,\n            `## Entry Content:`,\n            entryContentStr,\n          ].join('\\n'),\n        },\n      ],\n    });\n\n    // Strip markdown code blocks if present\n    const cleanedText = text\n      .replace(/^```(?:toon)?\\n([\\s\\S]*?)\\n```$/gm, '$1')\n      .trim();\n\n    const decodedJson = decode(cleanedText) as T;\n\n    // schema.parse(decodedJson);\n\n    return {\n      fileContent: decodedJson,\n      tokenUsed: usage?.totalTokens ?? 0,\n    };\n  }\n\n  const totalKeys = countKeys(entryFileContent);\n\n  const MAX_SAFE_KEYS = 70; // You will need to tune this threshold based on testing\n\n  const useStrictOutput = totalKeys <= MAX_SAFE_KEYS;\n\n  // Use the AI SDK to generate the completion\n  const { text, usage } = await generateText({\n    ...validAiConfig,\n\n    // Disable schema if Schema is too complex (Block with Anthropic)\n    output: useStrictOutput ? Output.object({ schema }) : undefined,\n    system: prompt,\n    messages: [\n      {\n        role: 'user',\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `CRITICAL INSTRUCTIONS:`,\n          `- You MUST return ONLY raw, valid JSON.`,\n          `- DO NOT wrap the response in Markdown code blocks (e.g., no \\`\\`\\`json).`,\n          `- DO NOT include any conversational text before or after the JSON object.`,\n          ``,\n          `## Entry Content:`,\n          entryContentStr,\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  // Extract and re-validate deeply\n  const extractedJSON = extractJson(text);\n  const validatedContent = schema.parse(extractedJSON) as T;\n\n  return {\n    fileContent: validatedContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/ai",
-  "version": "8.11.1",
+  "version": "8.11.2",
   "private": false,
   "description": "SDK that provides AI capabilities for Intlayer applications",
   "keywords": [
@@ -72,23 +72,23 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "3.0.79",
-    "@ai-sdk/google": "3.0.79",
-    "@ai-sdk/openai": "3.0.65",
-    "@intlayer/api": "8.11.1",
-    "@intlayer/config": "8.11.1",
-    "@intlayer/core": "8.11.1",
-    "@intlayer/types": "8.11.1",
+    "@ai-sdk/anthropic": "3.0.81",
+    "@ai-sdk/google": "3.0.80",
+    "@ai-sdk/openai": "3.0.67",
+    "@intlayer/api": "8.11.2",
+    "@intlayer/config": "8.11.2",
+    "@intlayer/core": "8.11.2",
+    "@intlayer/types": "8.11.2",
     "@toon-format/toon": "2.3.0",
-    "ai": "6.0.191",
+    "ai": "6.0.193",
     "zod": "4.4.3"
   },
   "devDependencies": {
     "@ai-sdk/alibaba": "1.0.25",
-    "@ai-sdk/amazon-bedrock": "4.0.108",
+    "@ai-sdk/amazon-bedrock": "4.0.111",
     "@ai-sdk/deepseek": "2.0.35",
     "@ai-sdk/fireworks": "2.0.53",
-    "@ai-sdk/google": "3.0.79",
+    "@ai-sdk/google": "3.0.80",
     "@ai-sdk/google-vertex": "^4.0.137",
     "@ai-sdk/groq": "3.0.39",
     "@ai-sdk/huggingface": "1.0.50",
@@ -101,7 +101,7 @@
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
     "rimraf": "6.1.3",
-    "tsdown": "0.22.00",
+    "tsdown": "0.22.1",
     "typescript": "6.0.3",
     "vitest": "4.1.7"
   },