@lingo.dev/compiler 0.1.0

package/build/react/shared/render-rich-text.d.mts

@@ -0,0 +1,17 @@
+import { ReactNode } from "react";
+import { FormatXMLElementFn } from "intl-messageformat";
+import { LocaleCode } from "lingo.dev/spec";
+
+//#region src/react/shared/render-rich-text.d.ts
+
+/**
+ * Component renderer function for rich text translation
+ */
+type ComponentRenderer = FormatXMLElementFn<ReactNode>;
+/**
+ * Rich text parameters for translation
+ */
+type RichTextParams = Record<string, ReactNode | ComponentRenderer>;
+//#endregion
+export { RichTextParams };
+//# sourceMappingURL=render-rich-text.d.mts.map

package/build/react/shared/render-rich-text.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-rich-text.d.mts","names":[],"sources":["../../../src/react/shared/render-rich-text.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AAQA;AAKY,KALA,iBAAA,GAAoB,kBAKN,CALyB,SAKzB,CAAA;;;;AAAS,KAAvB,cAAA,GAAiB,MAAM,CAAA,MAAA,EAAS,SAAT,GAAqB,iBAArB,CAAA"}

package/build/react/shared/render-rich-text.mjs

@@ -0,0 +1,54 @@
+import { logger } from "../../utils/logger.mjs";
+import { Fragment } from "react";
+import { jsx } from "react/jsx-runtime";
+import IntlMessageFormat from "intl-messageformat";
+
+//#region src/react/shared/render-rich-text.tsx
+/**
+* Wraps a FormatXMLElementFn to automatically assign keys to parts
+*/
+function assignUniqueKeysToParts(formatXMLElementFn) {
+	return function(parts) {
+		return formatXMLElementFn(parts);
+	};
+}
+/**
+* Wraps all FormatXMLElementFn values in params with key assignment
+*/
+function assignUniqueKeysToParams(params) {
+	const result = {};
+	for (const [key, value] of Object.entries(params)) if (typeof value === "function") result[key] = assignUniqueKeysToParts(value);
+	else result[key] = value;
+	return result;
+}
+/**
+* Parse rich text translation string with placeholders (server-side version)
+*
+* Supports:
+* - ICU MessageFormat: {count, plural, one {# item} other {# items}}
+* - Variable placeholders: {name}
+* - Component placeholders: <tag0>content</tag0>
+*
+* @param text - The translation string with placeholders
+* @param params - Object with variable values and component renderers
+* @param locale
+* @returns React nodes or string
+*/
+function renderRichText(text, params, locale) {
+	try {
+		const formatter = new IntlMessageFormat(text, locale);
+		const keyedParams = assignUniqueKeysToParams(params);
+		const result = formatter.format(keyedParams);
+		if (Array.isArray(result)) return result.map((item, index) => {
+			return /* @__PURE__ */ jsx(Fragment, { children: item }, index);
+		});
+		return result;
+	} catch (error) {
+		logger.warn(`Error rendering rich text (${text}): ${error}`);
+		return text;
+	}
+}
+
+//#endregion
+export { renderRichText };
+//# sourceMappingURL=render-rich-text.mjs.map

package/build/react/shared/render-rich-text.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-rich-text.mjs","names":["result: RichTextParams"],"sources":["../../../src/react/shared/render-rich-text.tsx"],"sourcesContent":["import { Fragment, type ReactNode } from \"react\";\nimport IntlMessageFormat, { type FormatXMLElementFn } from \"intl-messageformat\";\nimport { logger } from \"../../utils/logger\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * Component renderer function for rich text translation\n */\nexport type ComponentRenderer = FormatXMLElementFn<ReactNode>;\n\n/**\n * Rich text parameters for translation\n */\nexport type RichTextParams = Record<string, ReactNode | ComponentRenderer>;\n\n/**\n * Wraps a FormatXMLElementFn to automatically assign keys to parts\n */\nfunction assignUniqueKeysToParts(\n  formatXMLElementFn: FormatXMLElementFn<ReactNode>,\n): FormatXMLElementFn<ReactNode> {\n  return function (parts: Array<ReactNode>) {\n    return formatXMLElementFn(parts);\n  };\n}\n\n/**\n * Wraps all FormatXMLElementFn values in params with key assignment\n */\nfunction assignUniqueKeysToParams(params: RichTextParams): RichTextParams {\n  const result: RichTextParams = {};\n\n  for (const [key, value] of Object.entries(params)) {\n    // Check if value is a FormatXMLElementFn (function that's not a React component)\n    if (typeof value === \"function\") {\n      result[key] = assignUniqueKeysToParts(value);\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n//\n\n/**\n * Parse rich text translation string with placeholders (server-side version)\n *\n * Supports:\n * - ICU MessageFormat: {count, plural, one {# item} other {# items}}\n * - Variable placeholders: {name}\n * - Component placeholders: <tag0>content</tag0>\n *\n * @param text - The translation string with placeholders\n * @param params - Object with variable values and component renderers\n * @param locale\n * @returns React nodes or string\n */\nexport function renderRichText(\n  text: string,\n  params: RichTextParams,\n  locale: LocaleCode,\n): ReactNode {\n  try {\n    const formatter = new IntlMessageFormat(text, locale);\n    const keyedParams = assignUniqueKeysToParams(params);\n    const result = formatter.format<ReactNode>(keyedParams);\n\n    if (Array.isArray(result)) {\n      // Making all elements keyed here somehow fixes all the things. Maybe I also need to key everything in toKeyedReactNodeArray and I just don't get the error because I don't have a corner case for it? Need to investigate\n      return result.map((item, index) => {\n        // Each item gets wrapped in Fragment with unique key\n        // This handles strings, React elements (like <>text</>), everything\n        return <Fragment key={index}>{item}</Fragment>;\n      });\n    }\n\n    return result;\n  } catch (error) {\n    // It's better to render at least something than break the whole app.\n    logger.warn(`Error rendering rich text (${text}): ${error}`);\n    return text;\n  }\n}\n"],"mappings":";;;;;;;;;AAkBA,SAAS,wBACP,oBAC+B;AAC/B,QAAO,SAAU,OAAyB;AACxC,SAAO,mBAAmB,MAAM;;;;;;AAOpC,SAAS,yBAAyB,QAAwC;CACxE,MAAMA,SAAyB,EAAE;AAEjC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAE/C,KAAI,OAAO,UAAU,WACnB,QAAO,OAAO,wBAAwB,MAAM;KAE5C,QAAO,OAAO;AAIlB,QAAO;;;;;;;;;;;;;;;AAiBT,SAAgB,eACd,MACA,QACA,QACW;AACX,KAAI;EACF,MAAM,YAAY,IAAI,kBAAkB,MAAM,OAAO;EACrD,MAAM,cAAc,yBAAyB,OAAO;EACpD,MAAM,SAAS,UAAU,OAAkB,YAAY;AAEvD,MAAI,MAAM,QAAQ,OAAO,CAEvB,QAAO,OAAO,KAAK,MAAM,UAAU;AAGjC,UAAO,oBAAC,sBAAsB,QAAR,MAAwB;IAC9C;AAGJ,SAAO;UACA,OAAO;AAEd,SAAO,KAAK,8BAA8B,KAAK,KAAK,QAAQ;AAC5D,SAAO"}

package/build/react/shared/utils.cjs

@@ -0,0 +1,34 @@
+const require_logger = require('../../utils/logger.cjs');
+
+//#region src/react/shared/utils.ts
+/**
+* Fetch translations from translation server
+* Times out after 30 seconds to prevent indefinite hangs
+*/
+async function fetchTranslations(targetLocale, hashes, serverUrl) {
+	if (!serverUrl) return {};
+	if (!hashes || hashes.length === 0) return {};
+	const url = `${serverUrl}/translations/${targetLocale}`;
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), 3e4);
+	try {
+		let response = await fetch(url, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ hashes }),
+			signal: controller.signal
+		});
+		if (!response.ok) throw new Error(`Translation API error: ${response.statusText}`);
+		const result = await response.json();
+		require_logger.logger.debug(`Fetched translations for ${targetLocale}: ${JSON.stringify(result)}`);
+		return result.translations || {};
+	} catch (error) {
+		if (error instanceof Error && error.name === "AbortError") throw new Error(`Translation request to ${targetLocale} timed out after 30 seconds`);
+		throw error;
+	} finally {
+		clearTimeout(timeoutId);
+	}
+}
+
+//#endregion
+exports.fetchTranslations = fetchTranslations;

package/build/react/shared/utils.mjs

@@ -0,0 +1,35 @@
+import { logger } from "../../utils/logger.mjs";
+
+//#region src/react/shared/utils.ts
+/**
+* Fetch translations from translation server
+* Times out after 30 seconds to prevent indefinite hangs
+*/
+async function fetchTranslations(targetLocale, hashes, serverUrl) {
+	if (!serverUrl) return {};
+	if (!hashes || hashes.length === 0) return {};
+	const url = `${serverUrl}/translations/${targetLocale}`;
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), 3e4);
+	try {
+		let response = await fetch(url, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ hashes }),
+			signal: controller.signal
+		});
+		if (!response.ok) throw new Error(`Translation API error: ${response.statusText}`);
+		const result = await response.json();
+		logger.debug(`Fetched translations for ${targetLocale}: ${JSON.stringify(result)}`);
+		return result.translations || {};
+	} catch (error) {
+		if (error instanceof Error && error.name === "AbortError") throw new Error(`Translation request to ${targetLocale} timed out after 30 seconds`);
+		throw error;
+	} finally {
+		clearTimeout(timeoutId);
+	}
+}
+
+//#endregion
+export { fetchTranslations };
+//# sourceMappingURL=utils.mjs.map

package/build/react/shared/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../../src/react/shared/utils.ts"],"sourcesContent":["import { logger } from \"../../utils/logger\";\n\n/**\n * Fetch translations from translation server\n * Times out after 30 seconds to prevent indefinite hangs\n */\nexport async function fetchTranslations(\n  targetLocale: string,\n  hashes: string[],\n  serverUrl?: string,\n): Promise<Record<string, string>> {\n  if (!serverUrl) {\n    return {};\n  }\n  if (!hashes || hashes.length === 0) {\n    // This function is only called in dev mode and there is no need to fetch all the translations at once in dev mode\n    return {};\n  }\n  const url = `${serverUrl}/translations/${targetLocale}`;\n\n  const controller = new AbortController();\n  const timeoutId = setTimeout(() => controller.abort(), 30000); // 30 second timeout\n\n  try {\n    let response = await fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({ hashes }),\n      signal: controller.signal,\n    });\n\n    if (!response.ok) {\n      throw new Error(`Translation API error: ${response.statusText}`);\n    }\n\n    // TODO (AleksandrSl 02/12/2025): Handle errors in the context.\n    const result = await response.json();\n\n    logger.debug(\n      `Fetched translations for ${targetLocale}: ${JSON.stringify(result)}`,\n    );\n\n    // Server returns { locale, translations, errors }\n    // Extract just the translations dictionary\n    return result.translations || {};\n  } catch (error) {\n    if (error instanceof Error && error.name === \"AbortError\") {\n      throw new Error(\n        `Translation request to ${targetLocale} timed out after 30 seconds`,\n      );\n    }\n    throw error;\n  } finally {\n    clearTimeout(timeoutId);\n  }\n}\n"],"mappings":";;;;;;;AAMA,eAAsB,kBACpB,cACA,QACA,WACiC;AACjC,KAAI,CAAC,UACH,QAAO,EAAE;AAEX,KAAI,CAAC,UAAU,OAAO,WAAW,EAE/B,QAAO,EAAE;CAEX,MAAM,MAAM,GAAG,UAAU,gBAAgB;CAEzC,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,IAAM;AAE7D,KAAI;EACF,IAAI,WAAW,MAAM,MAAM,KAAK;GAC9B,QAAQ;GACR,SAAS,EACP,gBAAgB,oBACjB;GACD,MAAM,KAAK,UAAU,EAAE,QAAQ,CAAC;GAChC,QAAQ,WAAW;GACpB,CAAC;AAEF,MAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,0BAA0B,SAAS,aAAa;EAIlE,MAAM,SAAS,MAAM,SAAS,MAAM;AAEpC,SAAO,MACL,4BAA4B,aAAa,IAAI,KAAK,UAAU,OAAO,GACpE;AAID,SAAO,OAAO,gBAAgB,EAAE;UACzB,OAAO;AACd,MAAI,iBAAiB,SAAS,MAAM,SAAS,aAC3C,OAAM,IAAI,MACR,0BAA0B,aAAa,6BACxC;AAEH,QAAM;WACE;AACR,eAAa,UAAU"}

package/build/react/types.d.cts

@@ -0,0 +1,16 @@
+import { RichTextParams } from "./shared/render-rich-text.cjs";
+import { LocaleCode } from "lingo.dev/spec";
+import { ReactNode } from "react";
+
+//#region src/react/types.d.ts
+type TranslationHook = (hashes: string[]) => {
+  t: TranslationFunction;
+  locale: LocaleCode;
+};
+/**
+ * Translation function type
+ */
+type TranslationFunction = (hash: string, source: string, params?: RichTextParams) => string | ReactNode;
+//#endregion
+export { TranslationHook };
+//# sourceMappingURL=types.d.cts.map

package/build/react/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/react/types.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,eAAA;KACP;EADO,MAAA,EAEF,UAFiB;AAQ3B,CAAA;;;;KAAY,mBAAA,2CAGD,4BACG"}

package/build/react/types.d.mts

@@ -0,0 +1,16 @@
+import { RichTextParams } from "./shared/render-rich-text.mjs";
+import { ReactNode } from "react";
+import { LocaleCode } from "lingo.dev/spec";
+
+//#region src/react/types.d.ts
+type TranslationHook = (hashes: string[]) => {
+  t: TranslationFunction;
+  locale: LocaleCode;
+};
+/**
+ * Translation function type
+ */
+type TranslationFunction = (hash: string, source: string, params?: RichTextParams) => string | ReactNode;
+//#endregion
+export { TranslationHook };
+//# sourceMappingURL=types.d.mts.map

package/build/react/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/react/types.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,eAAA;KACP;EADO,MAAA,EAEF,UAFiB;AAQ3B,CAAA;;;;KAAY,mBAAA,2CAGD,4BACG"}

package/build/translation-server/logger.cjs

@@ -0,0 +1,37 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_logger = require('../utils/logger.cjs');
+let fs_promises = require("fs/promises");
+let path = require("path");
+
+//#region src/translation-server/logger.ts
+/**
+* Such weird separation of file writer from logger
+* is needed to avoid leaking node deps to the client build in next,
+* but still keep the main logger logic in one place.
+*/
+/**
+* Create a file writer function for a specific log file
+*/
+function createFileWriter(filePath, plainPrefix = "[Lingo.dev]") {
+	let writeQueue = Promise.resolve();
+	return (level, message) => {
+		writeQueue = writeQueue.then(async () => {
+			try {
+				const logLine = `${(/* @__PURE__ */ new Date()).toISOString()} [${level.toUpperCase()}] ${plainPrefix} ${message}\n`;
+				await Promise.race([(0, fs_promises.appendFile)(filePath, logLine, "utf-8"), new Promise((_, reject) => setTimeout(() => reject(/* @__PURE__ */ new Error("File write timeout")), 1e3))]);
+			} catch (error) {}
+		}).catch(() => {});
+	};
+}
+let logger = void 0;
+function getLogger(config) {
+	if (!logger) logger = new require_logger.Logger({
+		enableConsole: false,
+		enableDebug: true,
+		writeToFile: createFileWriter((0, path.join)(config.sourceRoot, config.lingoDir, "translation-server.log"))
+	});
+	return logger;
+}
+
+//#endregion
+exports.getLogger = getLogger;

package/build/translation-server/logger.mjs

@@ -0,0 +1,37 @@
+import { Logger } from "../utils/logger.mjs";
+import { appendFile } from "fs/promises";
+import { join } from "path";
+
+//#region src/translation-server/logger.ts
+/**
+* Such weird separation of file writer from logger
+* is needed to avoid leaking node deps to the client build in next,
+* but still keep the main logger logic in one place.
+*/
+/**
+* Create a file writer function for a specific log file
+*/
+function createFileWriter(filePath, plainPrefix = "[Lingo.dev]") {
+	let writeQueue = Promise.resolve();
+	return (level, message) => {
+		writeQueue = writeQueue.then(async () => {
+			try {
+				const logLine = `${(/* @__PURE__ */ new Date()).toISOString()} [${level.toUpperCase()}] ${plainPrefix} ${message}\n`;
+				await Promise.race([appendFile(filePath, logLine, "utf-8"), new Promise((_, reject) => setTimeout(() => reject(/* @__PURE__ */ new Error("File write timeout")), 1e3))]);
+			} catch (error) {}
+		}).catch(() => {});
+	};
+}
+let logger = void 0;
+function getLogger(config) {
+	if (!logger) logger = new Logger({
+		enableConsole: false,
+		enableDebug: true,
+		writeToFile: createFileWriter(join(config.sourceRoot, config.lingoDir, "translation-server.log"))
+	});
+	return logger;
+}
+
+//#endregion
+export { getLogger };
+//# sourceMappingURL=logger.mjs.map

package/build/translation-server/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":["writeQueue: Promise<void>","logger: Logger | undefined"],"sources":["../../src/translation-server/logger.ts"],"sourcesContent":["import { Logger, type LogLevel } from \"../utils/logger\";\nimport { join } from \"path\";\nimport type { TranslationMiddlewareConfig } from \"../types\";\n\n/**\n * Such weird separation of file writer from logger\n * is needed to avoid leaking node deps to the client build in next,\n * but still keep the main logger logic in one place.\n */\nimport { appendFile } from \"fs/promises\";\n\n/**\n * Create a file writer function for a specific log file\n */\nexport function createFileWriter(\n  filePath: string,\n  plainPrefix: string = \"[Lingo.dev]\",\n) {\n  let writeQueue: Promise<void> = Promise.resolve();\n\n  return (level: LogLevel, message: string) => {\n    writeQueue = writeQueue\n      .then(async () => {\n        try {\n          const timestamp = new Date().toISOString();\n          const logLine = `${timestamp} [${level.toUpperCase()}] ${plainPrefix} ${message}\\n`;\n\n          await Promise.race([\n            appendFile(filePath, logLine, \"utf-8\"),\n            new Promise((_, reject) =>\n              setTimeout(() => reject(new Error(\"File write timeout\")), 1000),\n            ),\n          ]);\n        } catch (error) {\n          // Silently fail to avoid breaking the application\n        }\n      })\n      .catch(() => {});\n  };\n}\n\nlet logger: Logger | undefined = undefined;\n\nexport function getLogger(config: TranslationMiddlewareConfig) {\n  if (!logger) {\n    const translationServerLogPath = join(\n      config.sourceRoot,\n      config.lingoDir,\n      \"translation-server.log\",\n    );\n    logger = new Logger({\n      enableConsole: false,\n      enableDebug: true,\n      writeToFile: createFileWriter(translationServerLogPath),\n    });\n  }\n  return logger;\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,iBACd,UACA,cAAsB,eACtB;CACA,IAAIA,aAA4B,QAAQ,SAAS;AAEjD,SAAQ,OAAiB,YAAoB;AAC3C,eAAa,WACV,KAAK,YAAY;AAChB,OAAI;IAEF,MAAM,UAAU,oBADE,IAAI,MAAM,EAAC,aAAa,CACb,IAAI,MAAM,aAAa,CAAC,IAAI,YAAY,GAAG,QAAQ;AAEhF,UAAM,QAAQ,KAAK,CACjB,WAAW,UAAU,SAAS,QAAQ,EACtC,IAAI,SAAS,GAAG,WACd,iBAAiB,uBAAO,IAAI,MAAM,qBAAqB,CAAC,EAAE,IAAK,CAChE,CACF,CAAC;YACK,OAAO;IAGhB,CACD,YAAY,GAAG;;;AAItB,IAAIC,SAA6B;AAEjC,SAAgB,UAAU,QAAqC;AAC7D,KAAI,CAAC,OAMH,UAAS,IAAI,OAAO;EAClB,eAAe;EACf,aAAa;EACb,aAAa,iBARkB,KAC/B,OAAO,YACP,OAAO,UACP,yBACD,CAIwD;EACxD,CAAC;AAEJ,QAAO"}