@intlayer/ai 7.5.2-canary.2 → 7.5.3

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

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["aiDefaultOptions: AIOptions","AIProvider","Locales","z","shape: Record<string, z.ZodTypeAny>","readAsset"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core';\nimport { type Locale, Locales } from '@intlayer/types';\nimport { generateObject } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type TranslateJSONOptions<T> = {\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> = {\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, Locales.ENGLISH)}`;\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.any();\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 promptFile = readAsset('./PROMPT.md');\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\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}}', JSON.stringify(presetOutputContent))\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  // Use the AI SDK to generate the completion\n  const { object, usage } = await generateObject({\n    ...aiConfig,\n    schema: jsonToZod(entryFileContent),\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        // KEY CHANGE: Explicitly repeating instructions in the user message\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `## Entry Content:`,\n          JSON.stringify(entryFileContent),\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: object as T,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;;;;AA6BA,MAAaA,mBAA8B;CACzC,UAAUC,yBAAW;CACrB,OAAO;CACR;;;;;;;AAQD,MAAM,wBAAwB,WAC5B,GAAG,OAAO,sCAAkB,QAAQC,wBAAQ,QAAQ;;;;;;;;AAStD,MAAM,yBAAyB,SAAwB;AACrD,KAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B,QAAO;AAIT,QAAO;;EAEP,KAAK,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,cAAc,CAAC,KAAK,OAAO;;AAG7E,MAAM,uBAAuB,SAAwC;AACnE,KAAI,SAAS,WACX,QAAO;AAGT,QAAO;;AAGT,MAAM,aAAa,YAA+B;AAEhD,KAAI,OAAO,YAAY,SACrB,QAAOC,MAAE,QAAQ;AAInB,KAAI,OAAO,YAAY,SACrB,QAAOA,MAAE,QAAQ;AAEnB,KAAI,OAAO,YAAY,UACrB,QAAOA,MAAE,SAAS;AAIpB,KAAI,MAAM,QAAQ,QAAQ,EAAE;AAE1B,MAAI,QAAQ,WAAW,EACrB,QAAOA,MAAE,MAAMA,MAAE,QAAQ,CAAC;AAG5B,SAAOA,MAAE,MAAM,UAAU,QAAQ,GAAG,CAAC;;AAIvC,KAAI,OAAO,YAAY,YAAY,YAAY,MAAM;EACnD,MAAMC,QAAsC,EAAE;AAC9C,OAAK,MAAM,OAAO,QAChB,OAAM,OAAO,UAAU,QAAQ,KAAK;AAEtC,SAAOD,MAAE,OAAO,MAAM;;AAIxB,QAAOA,MAAE,KAAK;;;;;;;AAQhB,MAAa,gBAAgB,OAAU,EACrC,kBACA,qBACA,uBACA,UACA,aACA,cACA,MACA,MACA,yBAGG;CACH,MAAM,aAAaE,+BAAU,cAAc;CAE3C,MAAM,uBAAuB,qBAAqB,YAAY;CAC9D,MAAM,wBAAwB,qBAAqB,aAAa;CAGhE,MAAM,SAAS,WACZ,QAAQ,mBAAmB,qBAAqB,CAChD,QAAQ,oBAAoB,sBAAsB,CAClD,QAAQ,2BAA2B,KAAK,UAAU,oBAAoB,CAAC,CACvE,QAAQ,6BAA6B,yBAAyB,GAAG,CACjE,QAAQ,0BAA0B,sBAAsB,GAAG,CAC3D,QAAQ,wBAAwB,sBAAsB,QAAQ,EAAE,CAAC,CAAC,CAClE,QAAQ,wBAAwB,oBAAoB,KAAK,CAAC;CAG7D,MAAM,EAAE,QAAQ,UAAU,6BAAqB;EAC7C,GAAG;EACH,QAAQ,UAAU,iBAAiB;EACnC,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GAEN,SAAS;IACP;IACA;IACA,eAAe;IACf,aAAa;IACb;IACA;IACA,KAAK,UAAU,iBAAiB;IACjC,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;EAClC"}
+{"version":3,"file":"index.cjs","names":["aiDefaultOptions: AIOptions","AIProvider","Locales","z","shape: Record<string, z.ZodTypeAny>","readAsset"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core';\nimport { type Locale, Locales } from '@intlayer/types';\nimport { generateObject } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\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, Locales.ENGLISH)}`;\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.any();\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 promptFile = readAsset('./PROMPT.md');\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\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}}', JSON.stringify(presetOutputContent))\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  // Use the AI SDK to generate the completion\n  const { object, usage } = await generateObject({\n    ...aiConfig,\n    schema: jsonToZod(entryFileContent),\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        // KEY CHANGE: Explicitly repeating instructions in the user message\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `## Entry Content:`,\n          JSON.stringify(entryFileContent),\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: object as T,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;;;;AA6BA,MAAaA,mBAA8B;CACzC,UAAUC,yBAAW;CACrB,OAAO;CACR;;;;;;;AAQD,MAAM,wBAAwB,WAC5B,GAAG,OAAO,sCAAkB,QAAQC,wBAAQ,QAAQ;;;;;;;;AAStD,MAAM,yBAAyB,SAAwB;AACrD,KAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B,QAAO;AAIT,QAAO;;EAEP,KAAK,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,cAAc,CAAC,KAAK,OAAO;;AAG7E,MAAM,uBAAuB,SAAwC;AACnE,KAAI,SAAS,WACX,QAAO;AAGT,QAAO;;AAGT,MAAM,aAAa,YAA+B;AAEhD,KAAI,OAAO,YAAY,SACrB,QAAOC,MAAE,QAAQ;AAInB,KAAI,OAAO,YAAY,SACrB,QAAOA,MAAE,QAAQ;AAEnB,KAAI,OAAO,YAAY,UACrB,QAAOA,MAAE,SAAS;AAIpB,KAAI,MAAM,QAAQ,QAAQ,EAAE;AAE1B,MAAI,QAAQ,WAAW,EACrB,QAAOA,MAAE,MAAMA,MAAE,QAAQ,CAAC;AAG5B,SAAOA,MAAE,MAAM,UAAU,QAAQ,GAAG,CAAC;;AAIvC,KAAI,OAAO,YAAY,YAAY,YAAY,MAAM;EACnD,MAAMC,QAAsC,EAAE;AAC9C,OAAK,MAAM,OAAO,QAChB,OAAM,OAAO,UAAU,QAAQ,KAAK;AAEtC,SAAOD,MAAE,OAAO,MAAM;;AAIxB,QAAOA,MAAE,KAAK;;;;;;;AAQhB,MAAa,gBAAgB,OAAU,EACrC,kBACA,qBACA,uBACA,UACA,aACA,cACA,MACA,MACA,yBAGG;CACH,MAAM,aAAaE,+BAAU,cAAc;CAE3C,MAAM,uBAAuB,qBAAqB,YAAY;CAC9D,MAAM,wBAAwB,qBAAqB,aAAa;CAGhE,MAAM,SAAS,WACZ,QAAQ,mBAAmB,qBAAqB,CAChD,QAAQ,oBAAoB,sBAAsB,CAClD,QAAQ,2BAA2B,KAAK,UAAU,oBAAoB,CAAC,CACvE,QAAQ,6BAA6B,yBAAyB,GAAG,CACjE,QAAQ,0BAA0B,sBAAsB,GAAG,CAC3D,QAAQ,wBAAwB,sBAAsB,QAAQ,EAAE,CAAC,CAAC,CAClE,QAAQ,wBAAwB,oBAAoB,KAAK,CAAC;CAG7D,MAAM,EAAE,QAAQ,UAAU,6BAAqB;EAC7C,GAAG;EACH,QAAQ,UAAU,iBAAiB;EACnC,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GAEN,SAAS;IACP;IACA;IACA,eAAe;IACf,aAAa;IACb;IACA;IACA,KAAK,UAAU,iBAAiB;IACjC,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;EAClC"}

package/dist/esm/translateJSON/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["aiDefaultOptions: AIOptions","shape: Record<string, z.ZodTypeAny>"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core';\nimport { type Locale, Locales } from '@intlayer/types';\nimport { generateObject } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\n\ntype Tag = {\n  key: string;\n  description?: string;\n};\n\nexport type TranslateJSONOptions<T> = {\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> = {\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, Locales.ENGLISH)}`;\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.any();\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 promptFile = readAsset('./PROMPT.md');\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\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}}', JSON.stringify(presetOutputContent))\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  // Use the AI SDK to generate the completion\n  const { object, usage } = await generateObject({\n    ...aiConfig,\n    schema: jsonToZod(entryFileContent),\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        // KEY CHANGE: Explicitly repeating instructions in the user message\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `## Entry Content:`,\n          JSON.stringify(entryFileContent),\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: object as T,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;;;;AA6BA,MAAaA,mBAA8B;CACzC,UAAU,WAAW;CACrB,OAAO;CACR;;;;;;;AAQD,MAAM,wBAAwB,WAC5B,GAAG,OAAO,IAAI,cAAc,QAAQ,QAAQ,QAAQ;;;;;;;;AAStD,MAAM,yBAAyB,SAAwB;AACrD,KAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B,QAAO;AAIT,QAAO;;EAEP,KAAK,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,cAAc,CAAC,KAAK,OAAO;;AAG7E,MAAM,uBAAuB,SAAwC;AACnE,KAAI,SAAS,WACX,QAAO;AAGT,QAAO;;AAGT,MAAM,aAAa,YAA+B;AAEhD,KAAI,OAAO,YAAY,SACrB,QAAO,EAAE,QAAQ;AAInB,KAAI,OAAO,YAAY,SACrB,QAAO,EAAE,QAAQ;AAEnB,KAAI,OAAO,YAAY,UACrB,QAAO,EAAE,SAAS;AAIpB,KAAI,MAAM,QAAQ,QAAQ,EAAE;AAE1B,MAAI,QAAQ,WAAW,EACrB,QAAO,EAAE,MAAM,EAAE,QAAQ,CAAC;AAG5B,SAAO,EAAE,MAAM,UAAU,QAAQ,GAAG,CAAC;;AAIvC,KAAI,OAAO,YAAY,YAAY,YAAY,MAAM;EACnD,MAAMC,QAAsC,EAAE;AAC9C,OAAK,MAAM,OAAO,QAChB,OAAM,OAAO,UAAU,QAAQ,KAAK;AAEtC,SAAO,EAAE,OAAO,MAAM;;AAIxB,QAAO,EAAE,KAAK;;;;;;;AAQhB,MAAa,gBAAgB,OAAU,EACrC,kBACA,qBACA,uBACA,UACA,aACA,cACA,MACA,MACA,yBAGG;CACH,MAAM,aAAa,UAAU,cAAc;CAE3C,MAAM,uBAAuB,qBAAqB,YAAY;CAC9D,MAAM,wBAAwB,qBAAqB,aAAa;CAGhE,MAAM,SAAS,WACZ,QAAQ,mBAAmB,qBAAqB,CAChD,QAAQ,oBAAoB,sBAAsB,CAClD,QAAQ,2BAA2B,KAAK,UAAU,oBAAoB,CAAC,CACvE,QAAQ,6BAA6B,yBAAyB,GAAG,CACjE,QAAQ,0BAA0B,sBAAsB,GAAG,CAC3D,QAAQ,wBAAwB,sBAAsB,QAAQ,EAAE,CAAC,CAAC,CAClE,QAAQ,wBAAwB,oBAAoB,KAAK,CAAC;CAG7D,MAAM,EAAE,QAAQ,UAAU,MAAM,eAAe;EAC7C,GAAG;EACH,QAAQ,UAAU,iBAAiB;EACnC,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GAEN,SAAS;IACP;IACA;IACA,eAAe;IACf,aAAa;IACb;IACA;IACA,KAAK,UAAU,iBAAiB;IACjC,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;EAClC"}
+{"version":3,"file":"index.mjs","names":["aiDefaultOptions: AIOptions","shape: Record<string, z.ZodTypeAny>"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core';\nimport { type Locale, Locales } from '@intlayer/types';\nimport { generateObject } from 'ai';\nimport { z } from 'zod';\nimport { type AIConfig, type AIOptions, AIProvider } from '../aiSdk';\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, Locales.ENGLISH)}`;\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.any();\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 promptFile = readAsset('./PROMPT.md');\n\n  const formattedEntryLocale = formatLocaleWithName(entryLocale);\n  const formattedOutputLocale = formatLocaleWithName(outputLocale);\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}}', JSON.stringify(presetOutputContent))\n    .replace('{{dictionaryDescription}}', dictionaryDescription ?? '')\n    .replace('{{applicationContext}}', applicationContext ?? '')\n    .replace('{{tagsInstructions}}', formatTagInstructions(tags ?? []))\n    .replace('{{modeInstructions}}', getModeInstructions(mode));\n\n  // Use the AI SDK to generate the completion\n  const { object, usage } = await generateObject({\n    ...aiConfig,\n    schema: jsonToZod(entryFileContent),\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        // KEY CHANGE: Explicitly repeating instructions in the user message\n        content: [\n          `# Translation Request`,\n          `Please translate the following JSON content.`,\n          `- **From:** ${formattedEntryLocale}`,\n          `- **To:** ${formattedOutputLocale}`,\n          ``,\n          `## Entry Content:`,\n          JSON.stringify(entryFileContent),\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: object as T,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;;;;AA6BA,MAAaA,mBAA8B;CACzC,UAAU,WAAW;CACrB,OAAO;CACR;;;;;;;AAQD,MAAM,wBAAwB,WAC5B,GAAG,OAAO,IAAI,cAAc,QAAQ,QAAQ,QAAQ;;;;;;;;AAStD,MAAM,yBAAyB,SAAwB;AACrD,KAAI,CAAC,QAAQ,KAAK,WAAW,EAC3B,QAAO;AAIT,QAAO;;EAEP,KAAK,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,cAAc,CAAC,KAAK,OAAO;;AAG7E,MAAM,uBAAuB,SAAwC;AACnE,KAAI,SAAS,WACX,QAAO;AAGT,QAAO;;AAGT,MAAM,aAAa,YAA+B;AAEhD,KAAI,OAAO,YAAY,SACrB,QAAO,EAAE,QAAQ;AAInB,KAAI,OAAO,YAAY,SACrB,QAAO,EAAE,QAAQ;AAEnB,KAAI,OAAO,YAAY,UACrB,QAAO,EAAE,SAAS;AAIpB,KAAI,MAAM,QAAQ,QAAQ,EAAE;AAE1B,MAAI,QAAQ,WAAW,EACrB,QAAO,EAAE,MAAM,EAAE,QAAQ,CAAC;AAG5B,SAAO,EAAE,MAAM,UAAU,QAAQ,GAAG,CAAC;;AAIvC,KAAI,OAAO,YAAY,YAAY,YAAY,MAAM;EACnD,MAAMC,QAAsC,EAAE;AAC9C,OAAK,MAAM,OAAO,QAChB,OAAM,OAAO,UAAU,QAAQ,KAAK;AAEtC,SAAO,EAAE,OAAO,MAAM;;AAIxB,QAAO,EAAE,KAAK;;;;;;;AAQhB,MAAa,gBAAgB,OAAU,EACrC,kBACA,qBACA,uBACA,UACA,aACA,cACA,MACA,MACA,yBAGG;CACH,MAAM,aAAa,UAAU,cAAc;CAE3C,MAAM,uBAAuB,qBAAqB,YAAY;CAC9D,MAAM,wBAAwB,qBAAqB,aAAa;CAGhE,MAAM,SAAS,WACZ,QAAQ,mBAAmB,qBAAqB,CAChD,QAAQ,oBAAoB,sBAAsB,CAClD,QAAQ,2BAA2B,KAAK,UAAU,oBAAoB,CAAC,CACvE,QAAQ,6BAA6B,yBAAyB,GAAG,CACjE,QAAQ,0BAA0B,sBAAsB,GAAG,CAC3D,QAAQ,wBAAwB,sBAAsB,QAAQ,EAAE,CAAC,CAAC,CAClE,QAAQ,wBAAwB,oBAAoB,KAAK,CAAC;CAG7D,MAAM,EAAE,QAAQ,UAAU,MAAM,eAAe;EAC7C,GAAG;EACH,QAAQ,UAAU,iBAAiB;EACnC,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GAEN,SAAS;IACP;IACA;IACA,eAAe;IACf,aAAa;IACb;IACA;IACA,KAAK,UAAU,iBAAiB;IACjC,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;EAClC"}

package/dist/types/translateJSON/index.d.ts

@@ -6,7 +6,7 @@ type Tag = {
   key: string;
   description?: string;
 };
-type TranslateJSONOptions<T> = {
+type TranslateJSONOptions<T = JSON> = {
   entryFileContent: T;
   presetOutputContent: Partial<T>;
   dictionaryDescription?: string;
@@ -17,7 +17,7 @@ type TranslateJSONOptions<T> = {
   mode: 'complete' | 'review';
   applicationContext?: string;
 };
-type TranslateJSONResultData<T> = {
+type TranslateJSONResultData<T = JSON> = {
   fileContent: T;
   tokenUsed: number;
 };

package/dist/types/translateJSON/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":[],"mappings":";;;;KAOK,GAAA;;EAAA,WAAG,CAAA,EAAA,MAAA;AAKR,CAAA;AACoB,KADR,oBACQ,CAAA,CAAA,CAAA,GAAA;EACW,gBAAA,EADX,CACW;EAAR,mBAAA,EAAA,OAAA,CAAQ,CAAR,CAAA;EAER,qBAAA,CAAA,EAAA,MAAA;EACC,WAAA,EADD,MACC;EACP,YAAA,EADO,MACP;EACG,IAAA,CAAA,EADH,GACG,EAAA;EAAQ,QAAA,EAAR,QAAQ;EAKR,IAAA,EAAA,UAAA,GAAA,QAAuB;EAKtB,kBAAA,CAGZ,EAAA,MAAA;AA+ED,CAAA;AAAuC,KAvF3B,uBAuF2B,CAAA,CAAA,CAAA,GAAA;EAAA,WAAA,EAtFxB,CAsFwB;EAAA,SAAA,EAAA,MAAA;CAAA;AAAA,cAlF1B,gBAkF0B,EAlFR,SAkFQ;;;;;;AAUpC,cAVU,aAUV,EAAA,CAAA,CAAA,CAAA,CAAA;EAAA,gBAAA;EAAA,mBAAA;EAAA,qBAAA;EAAA,QAAA;EAAA,WAAA;EAAA,YAAA;EAAA,IAAA;EAAA,IAAA;EAAA;AAAA,CAAA,EAAA,oBAAA,CAAqB,CAArB,CAAA,EAAA,GAA0B,OAA1B,CACD,uBADC,CACuB,CADvB,CAAA,GAAA,SAAA,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":[],"mappings":";;;;KAOK,GAAA;;EAAA,WAAG,CAAA,EAAA,MAAA;AAKR,CAAA;AAAqC,KAAzB,oBAAyB,CAAA,IAAA,IAAA,CAAA,GAAA;EACjB,gBAAA,EAAA,CAAA;EACW,mBAAA,EAAR,OAAQ,CAAA,CAAA,CAAA;EAAR,qBAAA,CAAA,EAAA,MAAA;EAER,WAAA,EAAA,MAAA;EACC,YAAA,EAAA,MAAA;EACP,IAAA,CAAA,EAAA,GAAA,EAAA;EACG,QAAA,EAAA,QAAA;EAAQ,IAAA,EAAA,UAAA,GAAA,QAAA;EAKR,kBAAA,CAAA,EAAA,MAAuB;AAKnC,CAAA;AAkFa,KAvFD,uBA6IX,CAAA,IA7IuC,IA6IvC,CAAA,GAAA;EAtDsC,WAAA,EAtFxB,CAsFwB;EAAA,SAAA,EAAA,MAAA;CAAA;AAAA,cAlF1B,gBAkF0B,EAlFR,SAkFQ;;;;;;AAUf,cAVX,aAUW,EAAA,CAAA,CAAA,CAAA,CAAA;EAAA,gBAAA;EAAA,mBAAA;EAAA,qBAAA;EAAA,QAAA;EAAA,WAAA;EAAA,YAAA;EAAA,IAAA;EAAA,IAAA;EAAA;AAAA,CAAA,EAArB,oBAAqB,CAAA,CAAA,CAAA,EAAA,GAAK,OAAL,CACtB,uBADsB,CACE,CADF,CAAA,GAAA,SAAA,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/ai",
-  "version": "7.5.2-canary.2",
+  "version": "7.5.3",
   "private": false,
   "description": "SDK that provides AI capabilities for Intlayer applications",
   "keywords": [
@@ -78,12 +78,12 @@
     "@ai-sdk/google": "2.0.51",
     "@ai-sdk/mistral": "2.0.26",
     "@ai-sdk/openai": "2.0.88",
-    "@intlayer/api": "7.5.2-canary.0",
-    "@intlayer/config": "7.5.2-canary.0",
-    "@intlayer/core": "7.5.2-canary.0",
-    "@intlayer/types": "7.5.2-canary.0",
+    "@intlayer/api": "7.5.3",
+    "@intlayer/config": "7.5.3",
+    "@intlayer/core": "7.5.3",
+    "@intlayer/types": "7.5.3",
     "ai": "5.0.116",
-    "zod": "^4.2.1"
+    "zod": "4.2.1"
   },
   "devDependencies": {
     "@types/node": "25.0.3",

package/dist/assets/auditDictionaryMetadata/PROMPT copy 2.md

@@ -1,73 +0,0 @@
-Your role is to describe a content declaration.
-
-1. **Terminology:**
-
-- **Dictionary:** A content declaration is a is a file (.ts, .js or .json) that contains the multilingual declaration related to a specific content. A content declaration file is usually related to a specific component, or page or section of a website.
-- **Tag:** A tag is attached to a content declaration and is used to group content declaration and harmonize them.
-
-2. **Audit Requirements:**
-   - **Do Not Alter Structure:** If the file structure is correct, do not modify it. Only add, update, or remove content declarations as necessary.
-   - **Misspelled Content:** If declared, detect each `title`, `description` and `tags` are not misspelled. If some content is misspelled, correct it.
-
-3. **Fields functions:**
-
-- **Title:** The title of the content declaration allows to easily identify it. It should be considered as a readable way to represent the `key` (example: `page-metadata` -> `Page metadata`). It should be a short and descriptive title that accurately reflects the dictionary.
-- **Description:** The description of the content declaration provides a brief summary of the content declaration. It should be a concise and informative description that explains the purpose and content of the dictionary.
-- **Tags:** The tags is an array of strings that represent the key of the tags associated with the content declaration.
-
-**Expected Response:**
-
-After completion, provide only the final title, description and tags fields in a JSON without any Markdown, code block formatting or any additional comments or explanations.
-
-Correct this fields if they are misspelled or do not match the expected content, and / or complete missing title / description / tags.
-
-**Example of expected response:**
-
-The following case is just an example of expected behavior:
-
-- Example of entry:
-
-```ts
-import { t, type Dictionary } from "intlayer";
-import { Metadata } from "next";
-
-const metadataContent = {
-  key: "pricing-metadata",
-  title: "",
-  description:
-    "here a description that doesn't make any sense and should be replaced",
-  content: {
-    title: t({
-      en: "Pricing | Intlayer",
-    }),
-    description: t({
-      en: "Discover our pricing plans and get access to premium features with Intlayer. Choose the plan that suits you best.",
-    }),
-    keywords: t<string[]>({
-      en: ["Pricing", "Subscription"],
-    }),
-  },
-} satisfies Dictionary<Metadata>;
-
-export default metadataContent;
-```
-
-- Example of response:
-
-```json
-{
-  "title": "Pricing page metadata",
-  "description": "Metadata related to the pricing page, includes title, description, keywords, metadata for SEO purpose. It will help search engines understand the content of the page.",
-  "tags": ["page metadata", "pricing page"]
-}
-```
-
-**Application Context**
-
-{{applicationContext}}
-
-**List of existing Tags:**
-
-Here the list of existing tags as a context to help you to pick related ones.
-
-{{tags}}

package/dist/assets/auditDictionaryMetadata/PROMPT copy.md

@@ -1,73 +0,0 @@
-Your role is to describe a content declaration.
-
-1. **Terminology:**
-
-- **Dictionary:** A content declaration is a is a file (.ts, .js or .json) that contains the multilingual declaration related to a specific content. A content declaration file is usually related to a specific component, or page or section of a website.
-- **Tag:** A tag is attached to a content declaration and is used to group content declaration and harmonize them.
-
-2. **Audit Requirements:**
-   - **Do Not Alter Structure:** If the file structure is correct, do not modify it. Only add, update, or remove content declarations as necessary.
-   - **Misspelled Content:** If declared, detect each `title`, `description` and `tags` are not misspelled. If some content is misspelled, correct it.
-
-3. **Fields functions:**
-
-- **Title:** The title of the content declaration allows to easily identify it. It should be considered as a readable way to represent the `key` (example: `page-metadata` -> `Page metadata`). It should be a short and descriptive title that accurately reflects the dictionary.
-- **Description:** The description of the content declaration provides a brief summary of the content declaration. It should be a concise and informative description that explains the purpose and content of the dictionary.
-- **Tags:** The tags is an array of strings that represent the key of the tags associated with the content declaration.
-
-**Expected Response:**
-
-After completion, provide only the final title, description and tags fields in a JSON without any Markdown, code block formatting or any additional comments or explanations.
-
-Correct this fields if they are misspelled or do not match the expected content, and / or complete missing title / description / tags.
-
-**Example of expected response:**
-
-The following case is just an example of expected behavior:
-
-- Example of entry:
-
-```ts
-import { t, type Dictionary } from "intlayer";
-import { Metadata } from "next";
-
-const metadataContent = {
-  key: "pricing-metadata",
-  title: "",
-  description:
-    "here a description that doesn't make any sense and should be replaced",
-  content: {
-    title: t({
-      en: "Pricing | Intlayer",
-    }),
-    description: t({
-      en: "Discover our pricing plans and get access to premium features with Intlayer. Choose the plan that suits you best.",
-    }),
-    keywords: t<string[]>({
-      en: ["Pricing", "Subscription"],
-    }),
-  },
-} satisfies Dictionary<Metadata>;
-
-export default metadataContent;
-```
-
-- Example of response:
-
-```json
-{
-  "title": "Pricing page metadata",
-  "description": "Metadata related to the pricing page, includes title, description, keywords, metadata for SEO purpose. It will help search engines understand the content of the page.",
-  "tags": ["page metadata", "pricing page"]
-}
-```
-
-**Application Context**
-
-{{applicationContext}}
-
-**List of existing Tags:**
-
-Here the list of existing tags as a context to help you to pick related ones.
-
-{{tags}}