@intlayer/ai 7.3.0-canary.0

package/dist/cjs/auditDictionaryMetadata/index.cjs

@@ -0,0 +1,37 @@
+const require__utils_asset = require('../_virtual/_utils_asset.cjs');
+const require_utils_extractJSON = require('../utils/extractJSON.cjs');
+let ai = require("ai");
+
+//#region src/auditDictionaryMetadata/index.ts
+const aiDefaultOptions = {};
+/**
+* Audits a content declaration file by constructing a prompt for AI models.
+* The prompt includes details about the project's locales, file paths of content declarations,
+* and requests for identifying issues or inconsistencies.
+*/
+const auditDictionaryMetadata = async ({ fileContent, tags, aiConfig, applicationContext }) => {
+	const prompt = require__utils_asset.readAsset("./PROMPT.md").replace("{{applicationContext}}", applicationContext ?? "").replace("{{tags}}", tags ? JSON.stringify(tags.map(({ key, description }) => `- ${key}: ${description}`).join("\n\n"), null, 2) : "");
+	const { text: newContent, usage } = await (0, ai.generateText)({
+		...aiConfig,
+		messages: [{
+			role: "system",
+			content: prompt
+		}, {
+			role: "user",
+			content: [
+				"**Content declaration to describe:**",
+				"This is the content declaration that you should consider to describe:",
+				fileContent
+			].join("\n")
+		}]
+	});
+	return {
+		fileContent: require_utils_extractJSON.extractJson(newContent),
+		tokenUsed: usage?.totalTokens ?? 0
+	};
+};
+
+//#endregion
+exports.aiDefaultOptions = aiDefaultOptions;
+exports.auditDictionaryMetadata = auditDictionaryMetadata;
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["aiDefaultOptions: AIOptions","readAsset","extractJson"],"sources":["../../../src/auditDictionaryMetadata/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { generateText } from 'ai';\nimport type { AIConfig, AIOptions } from '../aiSdk';\nimport { extractJson } from '../utils/extractJSON';\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\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  // Use the AI SDK to generate the completion\n  const { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        content: [\n          '**Content declaration to describe:**',\n          'This is the content declaration that you should consider to describe:',\n          fileContent,\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: extractJson(newContent),\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;AA0BA,MAAaA,mBAA8B,EAE1C;;;;;;AAOD,MAAa,0BAA0B,OAAO,EAC5C,aACA,MACA,UACA,yBAGG;CAIH,MAAM,SAHkBC,+BAAU,cAAc,CAGjB,QAC7B,0BACA,sBAAsB,GACvB,CAAC,QACA,YACA,OACI,KAAK,UACH,KACG,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,cAAc,CACzD,KAAK,OAAO,EACf,MACA,EACD,GACD,GACL;CAGD,MAAM,EAAE,MAAM,YAAY,UAAU,2BAAmB;EACrD,GAAG;EACH,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GACN,SAAS;IACP;IACA;IACA;IACD,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAaC,sCAAY,WAAW;EACpC,WAAW,OAAO,eAAe;EAClC"}

package/dist/cjs/customQuery.cjs

@@ -0,0 +1,24 @@
+let ai = require("ai");
+
+//#region src/customQuery.ts
+const aiDefaultOptions = { model: "gpt-4o-mini" };
+/**
+* CustomQuery a content declaration file by constructing a prompt for AI models.
+* The prompt includes details about the project's locales, file paths of content declarations,
+* and requests for identifying issues or inconsistencies.
+*/
+const customQuery = async ({ messages, aiConfig }) => {
+	const { text: newContent, usage } = await (0, ai.generateText)({
+		...aiConfig,
+		messages
+	});
+	return {
+		fileContent: newContent,
+		tokenUsed: usage?.totalTokens ?? 0
+	};
+};
+
+//#endregion
+exports.aiDefaultOptions = aiDefaultOptions;
+exports.customQuery = customQuery;
+//# sourceMappingURL=customQuery.cjs.map

package/dist/cjs/customQuery.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"customQuery.cjs","names":["aiDefaultOptions: AIOptions"],"sources":["../../src/customQuery.ts"],"sourcesContent":["import { generateText } from 'ai';\nimport type { AIConfig, AIOptions, Messages } from './aiSdk';\n\nexport type CustomQueryOptions = {\n  messages: Messages;\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  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    messages,\n  });\n\n  return {\n    fileContent: newContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;AAaA,MAAaA,mBAA8B,EACzC,OAAO,eAER;;;;;;AAOD,MAAa,cAAc,OAAO,EAChC,UACA,eACoE;CAEpE,MAAM,EAAE,MAAM,YAAY,UAAU,2BAAmB;EACrD,GAAG;EACH;EACD,CAAC;AAEF,QAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;EAClC"}

package/dist/cjs/index.cjs

@@ -0,0 +1,25 @@
+const require_aiSdk = require('./aiSdk.cjs');
+const require_customQuery = require('./customQuery.cjs');
+const require_utils_extractJSON = require('./utils/extractJSON.cjs');
+const require_auditDictionaryMetadata_index = require('./auditDictionaryMetadata/index.cjs');
+const require_translateJSON_index = require('./translateJSON/index.cjs');
+let ai = require("ai");
+
+exports.AIProvider = require_aiSdk.AIProvider;
+exports.auditDictionaryMetadata = require_auditDictionaryMetadata_index.auditDictionaryMetadata;
+exports.customQuery = require_customQuery.customQuery;
+exports.extractJson = require_utils_extractJSON.extractJson;
+Object.defineProperty(exports, 'generateText', {
+  enumerable: true,
+  get: function () {
+    return ai.generateText;
+  }
+});
+exports.getAIConfig = require_aiSdk.getAIConfig;
+Object.defineProperty(exports, 'streamText', {
+  enumerable: true,
+  get: function () {
+    return ai.streamText;
+  }
+});
+exports.translateJSON = require_translateJSON_index.translateJSON;

package/dist/cjs/translateJSON/index.cjs

@@ -0,0 +1,67 @@
+const require_aiSdk = require('../aiSdk.cjs');
+const require__utils_asset = require('../_virtual/_utils_asset.cjs');
+const require_utils_extractJSON = require('../utils/extractJSON.cjs');
+let ai = require("ai");
+let __intlayer_core = require("@intlayer/core");
+let __intlayer_types = require("@intlayer/types");
+
+//#region src/translateJSON/index.ts
+const aiDefaultOptions = {
+	provider: require_aiSdk.AIProvider.OPENAI,
+	model: "gpt-5-mini"
+};
+/**
+* Format a locale with its name.
+*
+* @param locale - The locale to format.
+* @returns A string in the format "locale: name", e.g. "en: English".
+*/
+const formatLocaleWithName = (locale) => `${locale}: ${(0, __intlayer_core.getLocaleName)(locale, __intlayer_types.Locales.ENGLISH)}`;
+/**
+* Formats tag instructions for the AI prompt.
+* Creates a string with all available tags and their descriptions.
+*
+* @param tags - The list of tags to format.
+* @returns A formatted string with tag instructions.
+*/
+const formatTagInstructions = (tags) => {
+	if (!tags || tags.length === 0) return "";
+	return `Based on the dictionary content, identify specific tags from the list below that would be relevant:
+  
+${tags.map(({ key, description }) => `- ${key}: ${description}`).join("\n\n")}`;
+};
+const getModeInstructions = (mode) => {
+	if (mode === "complete") 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.";
+	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.";
+};
+/**
+* TranslateJSONs a content declaration file by constructing a prompt for AI models.
+* The prompt includes details about the project's locales, file paths of content declarations,
+* and requests for identifying issues or inconsistencies.
+*/
+const translateJSON = async ({ entryFileContent, presetOutputContent, dictionaryDescription, aiConfig, entryLocale, outputLocale, tags, mode, applicationContext }) => {
+	const prompt = require__utils_asset.readAsset("./PROMPT.md").replace("{{entryLocale}}", formatLocaleWithName(entryLocale)).replace("{{outputLocale}}", formatLocaleWithName(outputLocale)).replace("{{presetOutputContent}}", JSON.stringify(presetOutputContent)).replace("{{dictionaryDescription}}", dictionaryDescription ?? "").replace("{{applicationContext}}", applicationContext ?? "").replace("{{tagsInstructions}}", formatTagInstructions(tags ?? [])).replace("{{modeInstructions}}", getModeInstructions(mode));
+	const { text: newContent, usage } = await (0, ai.generateText)({
+		...aiConfig,
+		messages: [{
+			role: "system",
+			content: prompt
+		}, {
+			role: "user",
+			content: [
+				"**Entry Content to Translate:**",
+				"- Given Language: {{entryLocale}}",
+				JSON.stringify(entryFileContent)
+			].join("\n")
+		}]
+	});
+	return {
+		fileContent: require_utils_extractJSON.extractJson(newContent),
+		tokenUsed: usage?.totalTokens ?? 0
+	};
+};
+
+//#endregion
+exports.aiDefaultOptions = aiDefaultOptions;
+exports.translateJSON = translateJSON;
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["aiDefaultOptions: AIOptions","AIProvider","Locales","readAsset","extractJson"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core';\nimport { type Locale, Locales } from '@intlayer/types';\nimport { generateText } from 'ai';\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 = {\n  entryFileContent: JSON;\n  presetOutputContent: JSON;\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 = {\n  fileContent: string;\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\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 ({\n  entryFileContent,\n  presetOutputContent,\n  dictionaryDescription,\n  aiConfig,\n  entryLocale,\n  outputLocale,\n  tags,\n  mode,\n  applicationContext,\n}: TranslateJSONOptions): Promise<TranslateJSONResultData | undefined> => {\n  const promptFile = readAsset('./PROMPT.md');\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = promptFile\n    .replace('{{entryLocale}}', formatLocaleWithName(entryLocale))\n    .replace('{{outputLocale}}', formatLocaleWithName(outputLocale))\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 { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        content: [\n          '**Entry Content to Translate:**',\n          '- Given Language: {{entryLocale}}',\n          JSON.stringify(entryFileContent),\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: extractJson(newContent),\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;;;;AA6BA,MAAaA,mBAA8B;CACzC,UAAUC,yBAAW;CACrB,OAAO;CACR;;;;;;;AAQD,MAAM,wBAAwB,WAC5B,GAAG,OAAO,uCAAkB,QAAQC,yBAAQ,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;;;;;;;AAQT,MAAa,gBAAgB,OAAO,EAClC,kBACA,qBACA,uBACA,UACA,aACA,cACA,MACA,MACA,yBACwE;CAGxE,MAAM,SAFaC,+BAAU,cAAc,CAGxC,QAAQ,mBAAmB,qBAAqB,YAAY,CAAC,CAC7D,QAAQ,oBAAoB,qBAAqB,aAAa,CAAC,CAC/D,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,MAAM,YAAY,UAAU,2BAAmB;EACrD,GAAG;EACH,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GACN,SAAS;IACP;IACA;IACA,KAAK,UAAU,iBAAiB;IACjC,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAaC,sCAAY,WAAW;EACpC,WAAW,OAAO,eAAe;EAClC"}

package/dist/cjs/utils/extractJSON.cjs

@@ -0,0 +1,61 @@
+
+//#region src/utils/extractJSON.ts
+/**
+* Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.
+* This is used to safely extract JSON from LLM responses that may contain additional text or markdown.
+*
+* @example
+* // Extracts JSON object from markdown response:
+* ```json
+* {
+*   "title": "Test content declarations",
+*   "description": "A comprehensive test dictionary...",
+*   "tags": ["test tag"]
+* }
+* ```
+*
+* @example
+* // Extracts JSON array:
+* ```json
+* ["item1", "item2", "item3"]
+* ```
+*
+* @example
+* // Extracts JSON from markdown:
+* Here is the response:
+* ```json
+* {"key": "value"}
+* ```
+* End of response.
+*
+* @throws {Error} If no valid JSON object/array is found or if parsing fails
+* @returns {T} The parsed JSON value cast to type T
+*/
+const extractJson = (input) => {
+	const opening = input.match(/[{[]/);
+	if (!opening) throw new Error("No JSON start character ({ or [) found.");
+	const startIdx = opening.index;
+	const openChar = input[startIdx];
+	const closeChar = openChar === "{" ? "}" : "]";
+	let depth = 0;
+	for (let i = startIdx; i < input.length; i++) {
+		const char = input[i];
+		if (char === openChar) depth++;
+		else if (char === closeChar) {
+			depth--;
+			if (depth === 0) {
+				const jsonSubstring = input.slice(startIdx, i + 1);
+				try {
+					return JSON.parse(jsonSubstring);
+				} catch (err) {
+					throw new Error(`Failed to parse JSON: ${err.message}`);
+				}
+			}
+		}
+	}
+	throw new Error("Reached end of input without closing JSON bracket.");
+};
+
+//#endregion
+exports.extractJson = extractJson;
+//# sourceMappingURL=extractJSON.cjs.map

package/dist/cjs/utils/extractJSON.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractJSON.cjs","names":[],"sources":["../../../src/utils/extractJSON.ts"],"sourcesContent":["/**\n * Extracts and parses the first valid JSON value (object or array) from a string containing arbitrary text.\n * This is used to safely extract JSON from LLM responses that may contain additional text or markdown.\n *\n * @example\n * // Extracts JSON object from markdown response:\n * ```json\n * {\n *   \"title\": \"Test content declarations\",\n *   \"description\": \"A comprehensive test dictionary...\",\n *   \"tags\": [\"test tag\"]\n * }\n * ```\n *\n * @example\n * // Extracts JSON array:\n * ```json\n * [\"item1\", \"item2\", \"item3\"]\n * ```\n *\n * @example\n * // Extracts JSON from markdown:\n * Here is the response:\n * ```json\n * {\"key\": \"value\"}\n * ```\n * End of response.\n *\n * @throws {Error} If no valid JSON object/array is found or if parsing fails\n * @returns {T} The parsed JSON value cast to type T\n */\nexport const extractJson = <T = any>(input: string): T => {\n  const opening = input.match(/[{[]/);\n  if (!opening) throw new Error('No JSON start character ({ or [) found.');\n\n  const startIdx = opening.index!;\n  const openChar = input[startIdx];\n  const closeChar = openChar === '{' ? '}' : ']';\n  let depth = 0;\n\n  for (let i = startIdx; i < input.length; i++) {\n    const char = input[i];\n    if (char === openChar) depth++;\n    else if (char === closeChar) {\n      depth--;\n      if (depth === 0) {\n        const jsonSubstring = input.slice(startIdx, i + 1);\n        try {\n          return JSON.parse(jsonSubstring) as T;\n        } catch (err) {\n          throw new Error(`Failed to parse JSON: ${(err as Error).message}`);\n        }\n      }\n    }\n  }\n\n  throw new Error('Reached end of input without closing JSON bracket.');\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,eAAwB,UAAqB;CACxD,MAAM,UAAU,MAAM,MAAM,OAAO;AACnC,KAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0CAA0C;CAExE,MAAM,WAAW,QAAQ;CACzB,MAAM,WAAW,MAAM;CACvB,MAAM,YAAY,aAAa,MAAM,MAAM;CAC3C,IAAI,QAAQ;AAEZ,MAAK,IAAI,IAAI,UAAU,IAAI,MAAM,QAAQ,KAAK;EAC5C,MAAM,OAAO,MAAM;AACnB,MAAI,SAAS,SAAU;WACd,SAAS,WAAW;AAC3B;AACA,OAAI,UAAU,GAAG;IACf,MAAM,gBAAgB,MAAM,MAAM,UAAU,IAAI,EAAE;AAClD,QAAI;AACF,YAAO,KAAK,MAAM,cAAc;aACzB,KAAK;AACZ,WAAM,IAAI,MAAM,yBAA0B,IAAc,UAAU;;;;;AAM1E,OAAM,IAAI,MAAM,qDAAqD"}

package/dist/esm/_virtual/_utils_asset.mjs

@@ -0,0 +1,97 @@
+import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region \0utils:asset
+const hereDirname = () => {
+	try {
+		return dirname(fileURLToPath(import.meta.url));
+	} catch {
+		return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+	}
+};
+const findDistRoot = (startDir) => {
+	let dir = startDir;
+	for (let i = 0; i < 12; i++) {
+		if (basename(dir) === "dist") return dir;
+		const parent = resolve(dir, "..");
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+};
+const normalizeFrameFile = (file) => {
+	if (!file) return null;
+	try {
+		if (file.startsWith("file://")) return fileURLToPath(file);
+	} catch {}
+	return file;
+};
+/**
+* Returns the directory of the *caller* module that invoked readAsset.
+* Prefers non-virtual frames; falls back to the first real frame.
+*/
+const getCallerDir = () => {
+	const prev = Error.prepareStackTrace;
+	try {
+		Error.prepareStackTrace = (_, structured) => structured;
+		const err = /* @__PURE__ */ new Error();
+		Error.captureStackTrace(err, getCallerDir);
+		/** @type {import('node:vm').CallSite[]} */
+		const frames = err.stack || [];
+		const isVirtualPath = (p) => p.includes(`${sep}_virtual${sep}`) || p.includes("/_virtual/");
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (!file) continue;
+			if (file.includes("node:internal") || file.includes(`${sep}internal${sep}modules${sep}`)) continue;
+			if (!isVirtualPath(file)) return dirname(file);
+		}
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (file) return dirname(file);
+		}
+	} catch {} finally {
+		Error.prepareStackTrace = prev;
+	}
+	return hereDirname();
+};
+/**
+* Read an asset copied from src/** to dist/assets/**.
+* - './' or '../' is resolved relative to the *caller module's* emitted directory.
+* - otherwise, treat as src-relative.
+*
+* @param {string} relPath - e.g. './PROMPT.md' or 'utils/AI/askDocQuestion/embeddings/<fileKey>.json'
+* @param {BufferEncoding} [encoding='utf8']
+*/
+const readAsset = (relPath, encoding = "utf8") => {
+	const here = hereDirname();
+	const distRoot = findDistRoot(here) ?? resolve(here, "..", "..", "dist");
+	const assetsRoot = join(distRoot, "assets");
+	const tried = [];
+	/**
+	* Transform dist/(esm|cjs)/... and _virtual/ prefix to clean subpath (Windows-safe)
+	*/
+	const callerSubpath = relative(distRoot, getCallerDir()).split("\\").join("/").replace(/^(?:dist\/)?(?:esm|cjs)\//, "").replace(/^_virtual\//, "");
+	if (relPath.startsWith("./") || relPath.startsWith("../")) {
+		const fromCallerAbs = resolve(assetsRoot, callerSubpath, relPath);
+		tried.push(fromCallerAbs);
+		if (existsSync(fromCallerAbs)) return readFileSync(fromCallerAbs, encoding);
+	}
+	const directPath = join(assetsRoot, relPath);
+	tried.push(directPath);
+	if (existsSync(directPath)) return readFileSync(directPath, encoding);
+	if (callerSubpath) {
+		const nested = join(assetsRoot, callerSubpath, relPath);
+		tried.push(nested);
+		if (existsSync(nested)) return readFileSync(nested, encoding);
+	}
+	const msg = [
+		"readAsset: file not found.",
+		"Searched:",
+		...tried.map((p) => `- ${p}`)
+	].join("\n");
+	throw new Error(msg);
+};
+
+//#endregion
+export { readAsset };

package/dist/esm/aiSdk.mjs

@@ -0,0 +1,92 @@
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createDeepSeek } from "@ai-sdk/deepseek";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createMistral } from "@ai-sdk/mistral";
+import { createOpenAI } from "@ai-sdk/openai";
+
+//#region src/aiSdk.ts
+/**
+* Supported AI SDK providers
+*/
+let AIProvider = /* @__PURE__ */ function(AIProvider$1) {
+	AIProvider$1["OPENAI"] = "openai";
+	AIProvider$1["ANTHROPIC"] = "anthropic";
+	AIProvider$1["MISTRAL"] = "mistral";
+	AIProvider$1["DEEPSEEK"] = "deepseek";
+	AIProvider$1["GEMINI"] = "gemini";
+	return AIProvider$1;
+}({});
+const getAPIKey = (accessType, aiOptions, isAuthenticated = false) => {
+	const defaultApiKey = process.env.OPENAI_API_KEY;
+	if (accessType.includes("public")) return aiOptions?.apiKey ?? defaultApiKey;
+	if (accessType.includes("apiKey") && aiOptions?.apiKey) return aiOptions?.apiKey;
+	if (accessType.includes("registered_user") && isAuthenticated) return aiOptions?.apiKey ?? defaultApiKey;
+	if (accessType.includes("premium_user") && isAuthenticated) return aiOptions?.apiKey ?? defaultApiKey;
+};
+const getModel = (provider, userApiKey, userModel, defaultModel = "gpt-5-mini") => {
+	if (userApiKey) {
+		if (provider && provider === AIProvider.OPENAI) return userModel ?? defaultModel;
+		switch (provider) {
+			case AIProvider.ANTHROPIC: return "claude-sonnet-4-5-20250929";
+			case AIProvider.MISTRAL: return "mistral-large-latest";
+			case AIProvider.DEEPSEEK: return "deepseek-coder";
+			case AIProvider.GEMINI: return "gemini-2.5-flash";
+			default: return defaultModel;
+		}
+	}
+	if (userModel || provider) throw new Error("The user should use his own API key to use a custom model");
+	return defaultModel;
+};
+const DEFAULT_PROVIDER = AIProvider.OPENAI;
+const DEFAULT_TEMPERATURE = 1;
+/**
+* Get AI model configuration based on the selected provider and options
+* This function handles the configuration for different AI providers
+*
+* @param options Configuration options including provider, API keys, models and temperature
+* @returns Configured AI model ready to use with generateText
+*/
+const getAIConfig = async (options, isAuthenticated = false) => {
+	const { userOptions, defaultOptions, accessType = ["registered_user"] } = options;
+	const aiOptions = {
+		provider: DEFAULT_PROVIDER,
+		temperature: DEFAULT_TEMPERATURE,
+		...defaultOptions,
+		...userOptions
+	};
+	const apiKey = getAPIKey(accessType, aiOptions, isAuthenticated);
+	if (!apiKey) throw new Error(`API key for ${aiOptions.provider} is missing`);
+	const selectedModel = getModel(aiOptions.provider, apiKey, aiOptions.model, defaultOptions?.model);
+	const protectedOptions = {
+		...aiOptions,
+		apiKey,
+		model: selectedModel
+	};
+	let languageModel;
+	switch (protectedOptions.provider) {
+		case AIProvider.OPENAI:
+			languageModel = createOpenAI({ apiKey })(selectedModel);
+			break;
+		case AIProvider.ANTHROPIC:
+			languageModel = createAnthropic({ apiKey })(selectedModel);
+			break;
+		case AIProvider.MISTRAL:
+			languageModel = createMistral({ apiKey })(selectedModel);
+			break;
+		case AIProvider.DEEPSEEK:
+			languageModel = createDeepSeek({ apiKey })(selectedModel);
+			break;
+		case AIProvider.GEMINI:
+			languageModel = createGoogleGenerativeAI({ apiKey })(selectedModel);
+			break;
+		default: throw new Error(`Provider ${protectedOptions.provider} not supported`);
+	}
+	return {
+		model: languageModel,
+		temperature: protectedOptions.temperature
+	};
+};
+
+//#endregion
+export { AIProvider, getAIConfig };
+//# sourceMappingURL=aiSdk.mjs.map

package/dist/esm/aiSdk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSdk.mjs","names":["DEFAULT_PROVIDER: AIProvider","DEFAULT_TEMPERATURE: number","languageModel: AIConfig['model']"],"sources":["../../src/aiSdk.ts"],"sourcesContent":["import { type anthropic, createAnthropic } from '@ai-sdk/anthropic';\nimport { createDeepSeek, type deepseek } from '@ai-sdk/deepseek';\nimport { createGoogleGenerativeAI, type google } from '@ai-sdk/google';\nimport { createMistral, type mistral } from '@ai-sdk/mistral';\nimport { createOpenAI, type openai } from '@ai-sdk/openai';\nimport type {\n  AssistantModelMessage,\n  generateText,\n  SystemModelMessage,\n  ToolModelMessage,\n  UserModelMessage,\n} from 'ai';\n\ntype AnthropicModel = Parameters<typeof anthropic>[0];\ntype DeepSeekModel = Parameters<typeof deepseek>[0];\ntype MistralModel = Parameters<typeof mistral>[0];\ntype OpenAIModel = Parameters<typeof openai>[0];\ntype GoogleModel = Parameters<typeof google>[0];\n\nexport type Messages = (\n  | SystemModelMessage\n  | UserModelMessage\n  | AssistantModelMessage\n  | ToolModelMessage\n)[];\n\n/**\n * Supported AI models\n */\nexport type Model =\n  | AnthropicModel\n  | DeepSeekModel\n  | MistralModel\n  | OpenAIModel\n  | GoogleModel\n  | (string & {});\n\n/**\n * Supported AI SDK providers\n */\nexport enum AIProvider {\n  OPENAI = 'openai',\n  ANTHROPIC = 'anthropic',\n  MISTRAL = 'mistral',\n  DEEPSEEK = 'deepseek',\n  GEMINI = 'gemini',\n}\n\n/**\n * Common options for all AI providers\n */\nexport type AIOptions = {\n  provider?: AIProvider;\n  model?: Model;\n  temperature?: number;\n  apiKey?: string;\n  applicationContext?: string;\n};\n\n// Define the structure of messages used in chat completions\nexport type ChatCompletionRequestMessage = {\n  role: 'system' | 'user' | 'assistant'; // The role of the message sender\n  content: string; // The text content of the message\n  timestamp?: Date; // The timestamp of the message\n};\n\ntype AccessType = 'apiKey' | 'registered_user' | 'premium_user' | 'public';\n\nconst getAPIKey = (\n  accessType: AccessType[],\n  aiOptions?: AIOptions,\n  isAuthenticated: boolean = false\n) => {\n  const defaultApiKey = process.env.OPENAI_API_KEY;\n\n  if (accessType.includes('public')) {\n    return aiOptions?.apiKey ?? defaultApiKey;\n  }\n\n  if (accessType.includes('apiKey') && aiOptions?.apiKey) {\n    return aiOptions?.apiKey;\n  }\n\n  if (accessType.includes('registered_user') && isAuthenticated) {\n    return aiOptions?.apiKey ?? defaultApiKey;\n  }\n\n  // TODO: Implement premium user access\n  if (accessType.includes('premium_user') && isAuthenticated) {\n    return aiOptions?.apiKey ?? defaultApiKey;\n  }\n\n  return undefined;\n};\n\nconst getModel = (\n  provider: AIProvider,\n  userApiKey: string,\n  userModel?: Model,\n  defaultModel: Model = 'gpt-5-mini'\n): Model => {\n  // If the user uses their own API key, allow custom model selection\n  if (userApiKey) {\n    if (provider && provider === AIProvider.OPENAI) {\n      return userModel ?? defaultModel;\n    }\n\n    switch (provider) {\n      case AIProvider.ANTHROPIC:\n        return 'claude-sonnet-4-5-20250929';\n      case AIProvider.MISTRAL:\n        return 'mistral-large-latest';\n      case AIProvider.DEEPSEEK:\n        return 'deepseek-coder';\n      case AIProvider.GEMINI:\n        return 'gemini-2.5-flash';\n      default:\n        return defaultModel;\n    }\n  }\n\n  // Guard: Prevent custom model usage without a user API key\n  if (userModel || provider) {\n    throw new Error(\n      'The user should use his own API key to use a custom model'\n    );\n  }\n\n  return defaultModel;\n};\n\nexport type AIConfig = Omit<Parameters<typeof generateText>[0], 'prompt'>;\n\nconst DEFAULT_PROVIDER: AIProvider = AIProvider.OPENAI as AIProvider;\nconst DEFAULT_TEMPERATURE: number = 1; // ChatGPT 5 accept only temperature 1\n\nexport type AIConfigOptions = {\n  userOptions?: AIOptions;\n  defaultOptions?: AIOptions;\n  accessType?: AccessType[];\n};\n\n/**\n * Get AI model configuration based on the selected provider and options\n * This function handles the configuration for different AI providers\n *\n * @param options Configuration options including provider, API keys, models and temperature\n * @returns Configured AI model ready to use with generateText\n */\nexport const getAIConfig = async (\n  options: AIConfigOptions,\n  isAuthenticated: boolean = false\n): Promise<AIConfig> => {\n  const {\n    userOptions,\n    defaultOptions,\n    accessType = ['registered_user'],\n  } = options;\n\n  const aiOptions = {\n    provider: DEFAULT_PROVIDER,\n    temperature: DEFAULT_TEMPERATURE,\n    ...defaultOptions,\n    ...userOptions,\n  } satisfies AIOptions;\n\n  const apiKey = getAPIKey(accessType, aiOptions, isAuthenticated);\n\n  // Check if API key is provided\n  if (!apiKey) {\n    throw new Error(`API key for ${aiOptions.provider} is missing`);\n  }\n\n  const selectedModel = getModel(\n    aiOptions.provider,\n    apiKey,\n    aiOptions.model,\n    defaultOptions?.model\n  );\n\n  const protectedOptions = {\n    ...aiOptions,\n    apiKey,\n    model: selectedModel,\n  } satisfies AIOptions;\n\n  let languageModel: AIConfig['model'];\n\n  switch (protectedOptions.provider) {\n    case AIProvider.OPENAI: {\n      languageModel = createOpenAI({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.ANTHROPIC: {\n      languageModel = createAnthropic({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.MISTRAL: {\n      languageModel = createMistral({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.DEEPSEEK: {\n      languageModel = createDeepSeek({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.GEMINI: {\n      languageModel = createGoogleGenerativeAI({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    default: {\n      throw new Error(`Provider ${protectedOptions.provider} not supported`);\n    }\n  }\n\n  return {\n    model: languageModel,\n    temperature: protectedOptions.temperature,\n  };\n};\n"],"mappings":";;;;;;;;;;AAwCA,IAAY,oDAAL;AACL;AACA;AACA;AACA;AACA;;;AAuBF,MAAM,aACJ,YACA,WACA,kBAA2B,UACxB;CACH,MAAM,gBAAgB,QAAQ,IAAI;AAElC,KAAI,WAAW,SAAS,SAAS,CAC/B,QAAO,WAAW,UAAU;AAG9B,KAAI,WAAW,SAAS,SAAS,IAAI,WAAW,OAC9C,QAAO,WAAW;AAGpB,KAAI,WAAW,SAAS,kBAAkB,IAAI,gBAC5C,QAAO,WAAW,UAAU;AAI9B,KAAI,WAAW,SAAS,eAAe,IAAI,gBACzC,QAAO,WAAW,UAAU;;AAMhC,MAAM,YACJ,UACA,YACA,WACA,eAAsB,iBACZ;AAEV,KAAI,YAAY;AACd,MAAI,YAAY,aAAa,WAAW,OACtC,QAAO,aAAa;AAGtB,UAAQ,UAAR;GACE,KAAK,WAAW,UACd,QAAO;GACT,KAAK,WAAW,QACd,QAAO;GACT,KAAK,WAAW,SACd,QAAO;GACT,KAAK,WAAW,OACd,QAAO;GACT,QACE,QAAO;;;AAKb,KAAI,aAAa,SACf,OAAM,IAAI,MACR,4DACD;AAGH,QAAO;;AAKT,MAAMA,mBAA+B,WAAW;AAChD,MAAMC,sBAA8B;;;;;;;;AAepC,MAAa,cAAc,OACzB,SACA,kBAA2B,UACL;CACtB,MAAM,EACJ,aACA,gBACA,aAAa,CAAC,kBAAkB,KAC9B;CAEJ,MAAM,YAAY;EAChB,UAAU;EACV,aAAa;EACb,GAAG;EACH,GAAG;EACJ;CAED,MAAM,SAAS,UAAU,YAAY,WAAW,gBAAgB;AAGhE,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,eAAe,UAAU,SAAS,aAAa;CAGjE,MAAM,gBAAgB,SACpB,UAAU,UACV,QACA,UAAU,OACV,gBAAgB,MACjB;CAED,MAAM,mBAAmB;EACvB,GAAG;EACH;EACA,OAAO;EACR;CAED,IAAIC;AAEJ,SAAQ,iBAAiB,UAAzB;EACE,KAAK,WAAW;AACd,mBAAgB,aAAa,EAC3B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,mBAAgB,gBAAgB,EAC9B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,mBAAgB,cAAc,EAC5B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,mBAAgB,eAAe,EAC7B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,mBAAgB,yBAAyB,EACvC,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,QACE,OAAM,IAAI,MAAM,YAAY,iBAAiB,SAAS,gBAAgB;;AAI1E,QAAO;EACL,OAAO;EACP,aAAa,iBAAiB;EAC/B"}

package/dist/esm/auditDictionaryMetadata/index.mjs

@@ -0,0 +1,36 @@
+import { readAsset } from "../_virtual/_utils_asset.mjs";
+import { extractJson } from "../utils/extractJSON.mjs";
+import { generateText } from "ai";
+
+//#region src/auditDictionaryMetadata/index.ts
+const aiDefaultOptions = {};
+/**
+* Audits a content declaration file by constructing a prompt for AI models.
+* The prompt includes details about the project's locales, file paths of content declarations,
+* and requests for identifying issues or inconsistencies.
+*/
+const auditDictionaryMetadata = async ({ fileContent, tags, aiConfig, applicationContext }) => {
+	const prompt = readAsset("./PROMPT.md").replace("{{applicationContext}}", applicationContext ?? "").replace("{{tags}}", tags ? JSON.stringify(tags.map(({ key, description }) => `- ${key}: ${description}`).join("\n\n"), null, 2) : "");
+	const { text: newContent, usage } = await generateText({
+		...aiConfig,
+		messages: [{
+			role: "system",
+			content: prompt
+		}, {
+			role: "user",
+			content: [
+				"**Content declaration to describe:**",
+				"This is the content declaration that you should consider to describe:",
+				fileContent
+			].join("\n")
+		}]
+	});
+	return {
+		fileContent: extractJson(newContent),
+		tokenUsed: usage?.totalTokens ?? 0
+	};
+};
+
+//#endregion
+export { aiDefaultOptions, auditDictionaryMetadata };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["aiDefaultOptions: AIOptions"],"sources":["../../../src/auditDictionaryMetadata/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { generateText } from 'ai';\nimport type { AIConfig, AIOptions } from '../aiSdk';\nimport { extractJson } from '../utils/extractJSON';\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\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  // Use the AI SDK to generate the completion\n  const { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        content: [\n          '**Content declaration to describe:**',\n          'This is the content declaration that you should consider to describe:',\n          fileContent,\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: extractJson(newContent),\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;;;AA0BA,MAAaA,mBAA8B,EAE1C;;;;;;AAOD,MAAa,0BAA0B,OAAO,EAC5C,aACA,MACA,UACA,yBAGG;CAIH,MAAM,SAHkB,UAAU,cAAc,CAGjB,QAC7B,0BACA,sBAAsB,GACvB,CAAC,QACA,YACA,OACI,KAAK,UACH,KACG,KAAK,EAAE,KAAK,kBAAkB,KAAK,IAAI,IAAI,cAAc,CACzD,KAAK,OAAO,EACf,MACA,EACD,GACD,GACL;CAGD,MAAM,EAAE,MAAM,YAAY,UAAU,MAAM,aAAa;EACrD,GAAG;EACH,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GACN,SAAS;IACP;IACA;IACA;IACD,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAa,YAAY,WAAW;EACpC,WAAW,OAAO,eAAe;EAClC"}

package/dist/esm/customQuery.mjs

@@ -0,0 +1,23 @@
+import { generateText } from "ai";
+
+//#region src/customQuery.ts
+const aiDefaultOptions = { model: "gpt-4o-mini" };
+/**
+* CustomQuery a content declaration file by constructing a prompt for AI models.
+* The prompt includes details about the project's locales, file paths of content declarations,
+* and requests for identifying issues or inconsistencies.
+*/
+const customQuery = async ({ messages, aiConfig }) => {
+	const { text: newContent, usage } = await generateText({
+		...aiConfig,
+		messages
+	});
+	return {
+		fileContent: newContent,
+		tokenUsed: usage?.totalTokens ?? 0
+	};
+};
+
+//#endregion
+export { aiDefaultOptions, customQuery };
+//# sourceMappingURL=customQuery.mjs.map

package/dist/esm/customQuery.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"customQuery.mjs","names":["aiDefaultOptions: AIOptions"],"sources":["../../src/customQuery.ts"],"sourcesContent":["import { generateText } from 'ai';\nimport type { AIConfig, AIOptions, Messages } from './aiSdk';\n\nexport type CustomQueryOptions = {\n  messages: Messages;\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  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    messages,\n  });\n\n  return {\n    fileContent: newContent,\n    tokenUsed: usage?.totalTokens ?? 0,\n  };\n};\n"],"mappings":";;;AAaA,MAAaA,mBAA8B,EACzC,OAAO,eAER;;;;;;AAOD,MAAa,cAAc,OAAO,EAChC,UACA,eACoE;CAEpE,MAAM,EAAE,MAAM,YAAY,UAAU,MAAM,aAAa;EACrD,GAAG;EACH;EACD,CAAC;AAEF,QAAO;EACL,aAAa;EACb,WAAW,OAAO,eAAe;EAClC"}

package/dist/esm/index.mjs

@@ -0,0 +1,8 @@
+import { AIProvider, getAIConfig } from "./aiSdk.mjs";
+import { customQuery } from "./customQuery.mjs";
+import { extractJson } from "./utils/extractJSON.mjs";
+import { auditDictionaryMetadata } from "./auditDictionaryMetadata/index.mjs";
+import { translateJSON } from "./translateJSON/index.mjs";
+import { generateText, streamText } from "ai";
+
+export { AIProvider, auditDictionaryMetadata, customQuery, extractJson, generateText, getAIConfig, streamText, translateJSON };

package/dist/esm/translateJSON/index.mjs

@@ -0,0 +1,66 @@
+import { AIProvider } from "../aiSdk.mjs";
+import { readAsset } from "../_virtual/_utils_asset.mjs";
+import { extractJson } from "../utils/extractJSON.mjs";
+import { generateText } from "ai";
+import { getLocaleName } from "@intlayer/core";
+import { Locales } from "@intlayer/types";
+
+//#region src/translateJSON/index.ts
+const aiDefaultOptions = {
+	provider: AIProvider.OPENAI,
+	model: "gpt-5-mini"
+};
+/**
+* Format a locale with its name.
+*
+* @param locale - The locale to format.
+* @returns A string in the format "locale: name", e.g. "en: English".
+*/
+const formatLocaleWithName = (locale) => `${locale}: ${getLocaleName(locale, Locales.ENGLISH)}`;
+/**
+* Formats tag instructions for the AI prompt.
+* Creates a string with all available tags and their descriptions.
+*
+* @param tags - The list of tags to format.
+* @returns A formatted string with tag instructions.
+*/
+const formatTagInstructions = (tags) => {
+	if (!tags || tags.length === 0) return "";
+	return `Based on the dictionary content, identify specific tags from the list below that would be relevant:
+  
+${tags.map(({ key, description }) => `- ${key}: ${description}`).join("\n\n")}`;
+};
+const getModeInstructions = (mode) => {
+	if (mode === "complete") 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.";
+	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.";
+};
+/**
+* TranslateJSONs a content declaration file by constructing a prompt for AI models.
+* The prompt includes details about the project's locales, file paths of content declarations,
+* and requests for identifying issues or inconsistencies.
+*/
+const translateJSON = async ({ entryFileContent, presetOutputContent, dictionaryDescription, aiConfig, entryLocale, outputLocale, tags, mode, applicationContext }) => {
+	const prompt = readAsset("./PROMPT.md").replace("{{entryLocale}}", formatLocaleWithName(entryLocale)).replace("{{outputLocale}}", formatLocaleWithName(outputLocale)).replace("{{presetOutputContent}}", JSON.stringify(presetOutputContent)).replace("{{dictionaryDescription}}", dictionaryDescription ?? "").replace("{{applicationContext}}", applicationContext ?? "").replace("{{tagsInstructions}}", formatTagInstructions(tags ?? [])).replace("{{modeInstructions}}", getModeInstructions(mode));
+	const { text: newContent, usage } = await generateText({
+		...aiConfig,
+		messages: [{
+			role: "system",
+			content: prompt
+		}, {
+			role: "user",
+			content: [
+				"**Entry Content to Translate:**",
+				"- Given Language: {{entryLocale}}",
+				JSON.stringify(entryFileContent)
+			].join("\n")
+		}]
+	});
+	return {
+		fileContent: extractJson(newContent),
+		tokenUsed: usage?.totalTokens ?? 0
+	};
+};
+
+//#endregion
+export { aiDefaultOptions, translateJSON };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["aiDefaultOptions: AIOptions"],"sources":["../../../src/translateJSON/index.ts"],"sourcesContent":["import { readAsset } from 'utils:asset';\nimport { getLocaleName } from '@intlayer/core';\nimport { type Locale, Locales } from '@intlayer/types';\nimport { generateText } from 'ai';\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 = {\n  entryFileContent: JSON;\n  presetOutputContent: JSON;\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 = {\n  fileContent: string;\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\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 ({\n  entryFileContent,\n  presetOutputContent,\n  dictionaryDescription,\n  aiConfig,\n  entryLocale,\n  outputLocale,\n  tags,\n  mode,\n  applicationContext,\n}: TranslateJSONOptions): Promise<TranslateJSONResultData | undefined> => {\n  const promptFile = readAsset('./PROMPT.md');\n  // Prepare the prompt for AI by replacing placeholders with actual values.\n  const prompt = promptFile\n    .replace('{{entryLocale}}', formatLocaleWithName(entryLocale))\n    .replace('{{outputLocale}}', formatLocaleWithName(outputLocale))\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 { text: newContent, usage } = await generateText({\n    ...aiConfig,\n    messages: [\n      { role: 'system', content: prompt },\n      {\n        role: 'user',\n        content: [\n          '**Entry Content to Translate:**',\n          '- Given Language: {{entryLocale}}',\n          JSON.stringify(entryFileContent),\n        ].join('\\n'),\n      },\n    ],\n  });\n\n  return {\n    fileContent: extractJson(newContent),\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;;;;;;;AAQT,MAAa,gBAAgB,OAAO,EAClC,kBACA,qBACA,uBACA,UACA,aACA,cACA,MACA,MACA,yBACwE;CAGxE,MAAM,SAFa,UAAU,cAAc,CAGxC,QAAQ,mBAAmB,qBAAqB,YAAY,CAAC,CAC7D,QAAQ,oBAAoB,qBAAqB,aAAa,CAAC,CAC/D,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,MAAM,YAAY,UAAU,MAAM,aAAa;EACrD,GAAG;EACH,UAAU,CACR;GAAE,MAAM;GAAU,SAAS;GAAQ,EACnC;GACE,MAAM;GACN,SAAS;IACP;IACA;IACA,KAAK,UAAU,iBAAiB;IACjC,CAAC,KAAK,KAAK;GACb,CACF;EACF,CAAC;AAEF,QAAO;EACL,aAAa,YAAY,WAAW;EACpC,WAAW,OAAO,eAAe;EAClC"}