better-translation 0.2.2 → 0.2.3-canary.1

package/dist/ai.d.mts

@@ -1,4 +1,4 @@
-import { d as TranslateFn } from "./types-DxcBf0RB.mjs";
+import { s as TranslateFn } from "./types-Ca8X5uZF.mjs";
 import { generateText } from "ai";
 
 //#region src/ai.d.ts
@@ -10,6 +10,8 @@ interface CreateAiTranslateOptions {
   prompt?: string;
   /** Optional temperature forwarded to the selected model provider. */
   temperature?: number;
+  /** Maximum number of per-message translation requests to run at once. */
+  concurrency?: number;
 }
 declare function createAiTranslate(options?: CreateAiTranslateOptions): TranslateFn;
 //#endregion

package/dist/ai.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.mts","names":[],"sources":["../src/ai.ts"],"mappings":";;;;KAKK,OAAA,GAAU,UAAU,QAAQ,YAAA;AAAA,UAEhB,wBAAA;EAFZ;EAIH,KAAA,GAAQ,OAAO;;EAEf,MAAA;EAN2C;EAQ3C,WAAA;AAAA;AAAA,iBAGc,iBAAA,CAAkB,OAAA,GAAS,wBAAA,GAAgC,WAAW"}
+{"version":3,"file":"ai.d.mts","names":[],"sources":["../src/ai.ts"],"mappings":";;;;KAMK,OAAA,GAAU,UAAU,QAAQ,YAAA;AAAA,UAEhB,wBAAA;EAFZ;EAIH,KAAA,GAAQ,OAAO;;EAEf,MAAA;EAN2C;EAQ3C,WAAA;EANuC;EAQvC,WAAA;AAAA;AAAA,iBAGc,iBAAA,CAAkB,OAAA,GAAS,wBAAA,GAAgC,WAAW"}

package/dist/ai.mjs

@@ -1,12 +1,23 @@
 //#region src/ai.ts
 const DEFAULT_GATEWAY_MODEL = "openai/gpt-5.5";
+const DEFAULT_CONCURRENCY = 10;
 function createAiTranslate(options = {}) {
 	return async (messages, locale) => {
 		const result = {};
-		for (const message of messages) result[message.id] = await translateMessage(message, locale, options);
+		const concurrency = normalizeConcurrency(options.concurrency);
+		await Promise.all(Array.from({ length: Math.min(concurrency, messages.length) }, async (_, workerIndex) => {
+			for (let index = workerIndex; index < messages.length; index += concurrency) {
+				const message = messages[index];
+				result[message.id] = await translateMessage(message, locale, options);
+			}
+		}));
 		return result;
 	};
 }
+function normalizeConcurrency(concurrency = DEFAULT_CONCURRENCY) {
+	if (!Number.isFinite(concurrency)) return DEFAULT_CONCURRENCY;
+	return Math.max(1, Math.floor(concurrency));
+}
 async function translateMessage(message, locale, options) {
 	return (await translateWithAi(message, locale, options)).trim() || message.text;
 }
@@ -29,7 +40,7 @@ ${locale}
 
 ## Output Contract
 Return only the translated text for the provided source message.
-Do not include the message id, labels, explanations, markdown, code fences, or surrounding quotes.
+Do not include the lookup id, labels, explanations, markdown, code fences, or surrounding quotes.
 Use the message context when provided.`].join("\n\n");
 }
 function createUserPrompt(message, locale) {

package/dist/ai.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai.mjs","names":[],"sources":["../src/ai.ts"],"sourcesContent":["import type { generateText } from \"ai\"\n\nimport type { TranslateFn, TranslateMessage } from \"./types.js\"\n\nconst DEFAULT_GATEWAY_MODEL = \"openai/gpt-5.5\"\ntype AiModel = Parameters<typeof generateText>[0][\"model\"]\n\nexport interface CreateAiTranslateOptions {\n  /** AI SDK model value. Defaults to a Vercel AI Gateway model string. */\n  model?: AiModel\n  /** Primary translation brief for product, tone, glossary, or domain instructions. */\n  prompt?: string\n  /** Optional temperature forwarded to the selected model provider. */\n  temperature?: number\n}\n\nexport function createAiTranslate(options: CreateAiTranslateOptions = {}): TranslateFn {\n  return async (messages, locale) => {\n    const result: Record<string, string> = {}\n\n    for (const message of messages) {\n      result[message.id] = await translateMessage(message, locale, options)\n    }\n\n    return result\n  }\n}\n\nasync function translateMessage(message: TranslateMessage, locale: string, options: CreateAiTranslateOptions) {\n  const translated = (await translateWithAi(message, locale, options)).trim()\n\n  return translated || message.text\n}\n\nasync function translateWithAi(message: TranslateMessage, locale: string, options: CreateAiTranslateOptions) {\n  const { generateText } = await import(\"ai\")\n  const { text } = await generateText({\n    model: options.model ?? DEFAULT_GATEWAY_MODEL,\n    system: createSystemPrompt(locale, options.prompt),\n    prompt: createUserPrompt(message, locale),\n    ...(options.temperature === undefined ? {} : { temperature: options.temperature }),\n  })\n\n  return text\n}\n\nfunction createSystemPrompt(locale: string, prompt?: string) {\n  const translationBrief = prompt?.trim() || \"Translate the provided UI messages as concise, natural application UI copy.\"\n\n  return [\n    `## Translation Brief\n${translationBrief}\n\n## Target Locale\n${locale}\n\n## Output Contract\nReturn only the translated text for the provided source message.\nDo not include the message id, labels, explanations, markdown, code fences, or surrounding quotes.\nUse the message context when provided.`,\n  ].join(\"\\n\\n\")\n}\n\nfunction createUserPrompt(message: TranslateMessage, locale: string) {\n  return JSON.stringify({\n    targetLocale: locale,\n    message: {\n      id: message.id,\n      text: message.text,\n      context: message.meta.context,\n    },\n  })\n}\n"],"mappings":";AAIA,MAAM,wBAAwB;AAY9B,SAAgB,kBAAkB,UAAoC,CAAC,GAAgB;CACrF,OAAO,OAAO,UAAU,WAAW;EACjC,MAAM,SAAiC,CAAC;EAExC,KAAK,MAAM,WAAW,UACpB,OAAO,QAAQ,MAAM,MAAM,iBAAiB,SAAS,QAAQ,OAAO;EAGtE,OAAO;CACT;AACF;AAEA,eAAe,iBAAiB,SAA2B,QAAgB,SAAmC;CAG5G,QAFoB,MAAM,gBAAgB,SAAS,QAAQ,OAAO,GAAG,KAErD,KAAK,QAAQ;AAC/B;AAEA,eAAe,gBAAgB,SAA2B,QAAgB,SAAmC;CAC3G,MAAM,EAAE,iBAAiB,MAAM,OAAO;CACtC,MAAM,EAAE,SAAS,MAAM,aAAa;EAClC,OAAO,QAAQ,SAAS;EACxB,QAAQ,mBAAmB,QAAQ,QAAQ,MAAM;EACjD,QAAQ,iBAAiB,SAAS,MAAM;EACxC,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAClF,CAAC;CAED,OAAO;AACT;AAEA,SAAS,mBAAmB,QAAgB,QAAiB;CAG3D,OAAO,CACL;EAHuB,QAAQ,KAAK,KAAK,8EAI1B;;;EAGjB,OAAO;;;;;uCAMP,EAAE,KAAK,MAAM;AACf;AAEA,SAAS,iBAAiB,SAA2B,QAAgB;CACnE,OAAO,KAAK,UAAU;EACpB,cAAc;EACd,SAAS;GACP,IAAI,QAAQ;GACZ,MAAM,QAAQ;GACd,SAAS,QAAQ,KAAK;EACxB;CACF,CAAC;AACH"}
+{"version":3,"file":"ai.mjs","names":[],"sources":["../src/ai.ts"],"sourcesContent":["import type { generateText } from \"ai\"\n\nimport type { TranslateFn, TranslateMessage } from \"./types.js\"\n\nconst DEFAULT_GATEWAY_MODEL = \"openai/gpt-5.5\"\nconst DEFAULT_CONCURRENCY = 10\ntype AiModel = Parameters<typeof generateText>[0][\"model\"]\n\nexport interface CreateAiTranslateOptions {\n  /** AI SDK model value. Defaults to a Vercel AI Gateway model string. */\n  model?: AiModel\n  /** Primary translation brief for product, tone, glossary, or domain instructions. */\n  prompt?: string\n  /** Optional temperature forwarded to the selected model provider. */\n  temperature?: number\n  /** Maximum number of per-message translation requests to run at once. */\n  concurrency?: number\n}\n\nexport function createAiTranslate(options: CreateAiTranslateOptions = {}): TranslateFn {\n  return async (messages, locale) => {\n    const result: Record<string, string> = {}\n    const concurrency = normalizeConcurrency(options.concurrency)\n\n    await Promise.all(\n      Array.from({ length: Math.min(concurrency, messages.length) }, async (_, workerIndex) => {\n        for (let index = workerIndex; index < messages.length; index += concurrency) {\n          const message = messages[index]!\n          result[message.id] = await translateMessage(message, locale, options)\n        }\n      }),\n    )\n\n    return result\n  }\n}\n\nfunction normalizeConcurrency(concurrency = DEFAULT_CONCURRENCY) {\n  if (!Number.isFinite(concurrency)) return DEFAULT_CONCURRENCY\n  return Math.max(1, Math.floor(concurrency))\n}\n\nasync function translateMessage(message: TranslateMessage, locale: string, options: CreateAiTranslateOptions) {\n  const translated = (await translateWithAi(message, locale, options)).trim()\n\n  return translated || message.text\n}\n\nasync function translateWithAi(message: TranslateMessage, locale: string, options: CreateAiTranslateOptions) {\n  const { generateText } = await import(\"ai\")\n  const { text } = await generateText({\n    model: options.model ?? DEFAULT_GATEWAY_MODEL,\n    system: createSystemPrompt(locale, options.prompt),\n    prompt: createUserPrompt(message, locale),\n    ...(options.temperature === undefined ? {} : { temperature: options.temperature }),\n  })\n\n  return text\n}\n\nfunction createSystemPrompt(locale: string, prompt?: string) {\n  const translationBrief = prompt?.trim() || \"Translate the provided UI messages as concise, natural application UI copy.\"\n\n  return [\n    `## Translation Brief\n${translationBrief}\n\n## Target Locale\n${locale}\n\n## Output Contract\nReturn only the translated text for the provided source message.\nDo not include the lookup id, labels, explanations, markdown, code fences, or surrounding quotes.\nUse the message context when provided.`,\n  ].join(\"\\n\\n\")\n}\n\nfunction createUserPrompt(message: TranslateMessage, locale: string) {\n  return JSON.stringify({\n    targetLocale: locale,\n    message: {\n      id: message.id,\n      text: message.text,\n      context: message.meta.context,\n    },\n  })\n}\n"],"mappings":";AAIA,MAAM,wBAAwB;AAC9B,MAAM,sBAAsB;AAc5B,SAAgB,kBAAkB,UAAoC,CAAC,GAAgB;CACrF,OAAO,OAAO,UAAU,WAAW;EACjC,MAAM,SAAiC,CAAC;EACxC,MAAM,cAAc,qBAAqB,QAAQ,WAAW;EAE5D,MAAM,QAAQ,IACZ,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,aAAa,SAAS,MAAM,EAAE,GAAG,OAAO,GAAG,gBAAgB;GACvF,KAAK,IAAI,QAAQ,aAAa,QAAQ,SAAS,QAAQ,SAAS,aAAa;IAC3E,MAAM,UAAU,SAAS;IACzB,OAAO,QAAQ,MAAM,MAAM,iBAAiB,SAAS,QAAQ,OAAO;GACtE;EACF,CAAC,CACH;EAEA,OAAO;CACT;AACF;AAEA,SAAS,qBAAqB,cAAc,qBAAqB;CAC/D,IAAI,CAAC,OAAO,SAAS,WAAW,GAAG,OAAO;CAC1C,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,WAAW,CAAC;AAC5C;AAEA,eAAe,iBAAiB,SAA2B,QAAgB,SAAmC;CAG5G,QAFoB,MAAM,gBAAgB,SAAS,QAAQ,OAAO,GAAG,KAErD,KAAK,QAAQ;AAC/B;AAEA,eAAe,gBAAgB,SAA2B,QAAgB,SAAmC;CAC3G,MAAM,EAAE,iBAAiB,MAAM,OAAO;CACtC,MAAM,EAAE,SAAS,MAAM,aAAa;EAClC,OAAO,QAAQ,SAAS;EACxB,QAAQ,mBAAmB,QAAQ,QAAQ,MAAM;EACjD,QAAQ,iBAAiB,SAAS,MAAM;EACxC,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;CAClF,CAAC;CAED,OAAO;AACT;AAEA,SAAS,mBAAmB,QAAgB,QAAiB;CAG3D,OAAO,CACL;EAHuB,QAAQ,KAAK,KAAK,8EAI1B;;;EAGjB,OAAO;;;;;uCAMP,EAAE,KAAK,MAAM;AACf;AAEA,SAAS,iBAAiB,SAA2B,QAAgB;CACnE,OAAO,KAAK,UAAU;EACpB,cAAc;EACd,SAAS;GACP,IAAI,QAAQ;GACZ,MAAM,QAAQ;GACd,SAAS,QAAQ,KAAK;EACxB;CACF,CAAC;AACH"}

package/dist/{message-id-B8zJjADZ.mjs → message-id-DGUI8H5w.mjs}

@@ -12,7 +12,7 @@ function getMessageIdentity(message, meta) {
 	const serializedMeta = serializeMeta(meta);
 	return serializedMeta ? `${message}\0${serializedMeta}` : message;
 }
-/** Generates the stable hashed id used to store and look up a translated message. */
+/** Generates the stable hashed lookup id used to store and look up a translated message. */
 function getMessageId(message, meta) {
 	const value = getMessageIdentity(message, meta);
 	let hash = 2166136261;
@@ -29,4 +29,4 @@ function getCallMessageId(message, options) {
 //#endregion
 export { getMessageId as n, serializeMeta as r, getCallMessageId as t };
 
-//# sourceMappingURL=message-id-B8zJjADZ.mjs.map
+//# sourceMappingURL=message-id-DGUI8H5w.mjs.map

package/dist/message-id-DGUI8H5w.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-id-DGUI8H5w.mjs","names":[],"sources":["../src/message-id.ts"],"sourcesContent":["import type { TranslateOptions } from \"./types.js\"\n\nexport function normalizeMeta(meta?: TranslateOptions): TranslateOptions {\n  if (!meta) return {}\n\n  return Object.fromEntries(\n    Object.entries(meta)\n      .filter(([key, value]) => key !== \"id\" && value !== undefined)\n      .sort(([a], [b]) => a.localeCompare(b)),\n  ) as TranslateOptions\n}\n\nexport function serializeMeta(meta?: TranslateOptions) {\n  if (!meta) return \"\"\n\n  const normalized = normalizeMeta(meta)\n  return Object.keys(normalized).length > 0 ? JSON.stringify(normalized) : \"\"\n}\n\nexport function getMessageIdentity(message: string, meta?: TranslateOptions) {\n  const serializedMeta = serializeMeta(meta)\n  return serializedMeta ? `${message}\\0${serializedMeta}` : message\n}\n\n/** Generates the stable hashed lookup id used to store and look up a translated message. */\nexport function getMessageId(message: string, meta?: TranslateOptions) {\n  const value = getMessageIdentity(message, meta)\n  let hash = 2166136261\n\n  for (let i = 0; i < value.length; i++) {\n    hash ^= value.charCodeAt(i)\n    hash = Math.imul(hash, 16777619)\n  }\n\n  return `m_${(hash >>> 0).toString(36)}`\n}\n\n/** Resolves the lookup id for function-style `t()` calls, preferring an explicit `options.id`. */\nexport function getCallMessageId(message: string, options?: TranslateOptions) {\n  return options?.id ?? getMessageId(message, options)\n}\n"],"mappings":";AAEA,SAAgB,cAAc,MAA2C;CACvE,IAAI,CAAC,MAAM,OAAO,CAAC;CAEnB,OAAO,OAAO,YACZ,OAAO,QAAQ,IAAI,EAChB,QAAQ,CAAC,KAAK,WAAW,QAAQ,QAAQ,UAAU,KAAA,CAAS,EAC5D,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAC1C;AACF;AAEA,SAAgB,cAAc,MAAyB;CACrD,IAAI,CAAC,MAAM,OAAO;CAElB,MAAM,aAAa,cAAc,IAAI;CACrC,OAAO,OAAO,KAAK,UAAU,EAAE,SAAS,IAAI,KAAK,UAAU,UAAU,IAAI;AAC3E;AAEA,SAAgB,mBAAmB,SAAiB,MAAyB;CAC3E,MAAM,iBAAiB,cAAc,IAAI;CACzC,OAAO,iBAAiB,GAAG,QAAQ,IAAI,mBAAmB;AAC5D;;AAGA,SAAgB,aAAa,SAAiB,MAAyB;CACrE,MAAM,QAAQ,mBAAmB,SAAS,IAAI;CAC9C,IAAI,OAAO;CAEX,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,QAAQ,MAAM,WAAW,CAAC;EAC1B,OAAO,KAAK,KAAK,MAAM,QAAQ;CACjC;CAEA,OAAO,MAAM,SAAS,GAAG,SAAS,EAAE;AACtC;;AAGA,SAAgB,iBAAiB,SAAiB,SAA4B;CAC5E,OAAO,SAAS,MAAM,aAAa,SAAS,OAAO;AACrD"}

package/dist/messages.d.mts

@@ -1,4 +1,4 @@
-import { u as RuntimeMessages } from "./types-DxcBf0RB.mjs";
+import { o as RuntimeMessages } from "./types-Ca8X5uZF.mjs";
 
 //#region src/messages.d.ts
 declare const locales: readonly string[];

package/dist/react.d.mts

@@ -1,10 +1,10 @@
-import { p as TranslateOptions } from "./types-DxcBf0RB.mjs";
+import { l as TranslateOptions } from "./types-Ca8X5uZF.mjs";
 import { ReactNode } from "react";
 
 //#region src/react.d.ts
 /** Props for `TranslateProvider`. */
 interface TranslateProviderProps {
-  /** Flattened locale message map keyed by stable message id. */
+  /** Flattened locale message map keyed by stable lookup id. */
   messages: Record<string, string>;
   /** React subtree that should have access to translations. */
   children: ReactNode;
@@ -28,7 +28,7 @@ type VarProps = {
 declare function Var(props: VarProps): import("react/jsx-runtime").JSX.Element;
 /** Props for `T`. */
 interface TProps {
-  /** Explicit stable id to use instead of hashing the rendered source text, whether provided manually or by a transform. */
+  /** Explicit stable lookup id to use instead of hashing the rendered source text, whether provided manually or by a transform. */
   id?: string;
   /** Extra disambiguating context for translators and custom grouping. */
   context?: string;

package/dist/react.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.mts","names":[],"sources":["../src/react.tsx"],"mappings":";;;;;UAaiB,sBAAA;EAAA;EAEf,QAAA,EAAU,MAAA;;EAEV,QAAA,EAAU,SAAS;AAAA;;iBAIL,iBAAA,CAAA;EAAoB,QAAA;EAAU;AAAA,GAAY,sBAAA,+BAAsB,GAAA,CAAA,OAAA;;iBAMhE,WAAA,CAAA,GAAW,MAAA;AAAA,KAItB,aAAA,GAAgB,MAAM;AAAA,KACtB,WAAA,IAAe,OAAA,UAAiB,eAAA,GAAkB,aAAA,GAAgB,gBAAA,EAAkB,OAAA,GAAU,gBAAA;;iBAGnF,IAAA,CAAA,GAAQ,WAAW;;KAevB,QAAA;EA7B8C,sFA+BxD,QAAA,GAAW,SAAA;AAAA,IACT,MAAA,SAAe,SAAA;;iBAGH,GAAA,CAAI,KAAA,EAAO,QAAQ,+BAAA,GAAA,CAAA,OAAA;;UAKlB,MAAA;EAxCyC;EA0CxD,EAAA;EA1C8E;EA4C9E,OAAA;EA5C8E;EA8C9E,QAAA,GAAW,SAAS;AAAA;;iBAIN,CAAA,CAAA;EAAI,EAAA;EAAI,OAAA;EAAS;AAAA,GAAY,MAAA,+BAAM,GAAA,CAAA,OAAA"}
+{"version":3,"file":"react.d.mts","names":[],"sources":["../src/react.tsx"],"mappings":";;;;;UAaiB,sBAAA;EAAA;EAEf,QAAA,EAAU,MAAA;;EAEV,QAAA,EAAU,SAAS;AAAA;;iBAIL,iBAAA;EAAoB,QAAA;EAAU;AAAA,GAAY,sBAAA,+BAAsB,GAAA,CAAA,OAAA;;iBAMhE,WAAA,IAAW,MAAA;AAAA,KAItB,aAAA,GAAgB,MAAM;AAAA,KACtB,WAAA,IAAe,OAAA,UAAiB,eAAA,GAAkB,aAAA,GAAgB,gBAAA,EAAkB,OAAA,GAAU,gBAAA;;iBAGnF,IAAA,IAAQ,WAAW;;KAevB,QAAA;EA7B8C,sFA+BxD,QAAA,GAAW,SAAA;AAAA,IACT,MAAA,SAAe,SAAA;;iBAGH,GAAA,CAAI,KAAA,EAAO,QAAQ,+BAAA,GAAA,CAAA,OAAA;;UAKlB,MAAA;EAxCyC;EA0CxD,EAAA;EA1C8E;EA4C9E,OAAA;EA5C8E;EA8C9E,QAAA,GAAW,SAAS;AAAA;;iBAIN,CAAA;EAAI,EAAA;EAAI,OAAA;EAAS;AAAA,GAAY,MAAA,+BAAM,GAAA,CAAA,OAAA"}

package/dist/react.mjs

@@ -1,4 +1,4 @@
-import { n as getMessageId, t as getCallMessageId } from "./message-id-B8zJjADZ.mjs";
+import { n as getMessageId, t as getCallMessageId } from "./message-id-DGUI8H5w.mjs";
 import { Children, createContext, isValidElement, use, useMemo } from "react";
 import { Fragment, jsx } from "react/jsx-runtime";
 //#region src/react.tsx

package/dist/react.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"react.mjs","names":[],"sources":["../src/react.tsx"],"sourcesContent":["import { Children, createContext, isValidElement, use, useMemo, type ReactNode } from \"react\"\n\nimport type { TranslateOptions } from \"./types.js\"\n\nimport { getCallMessageId, getMessageId } from \"./message-id.js\"\n\ninterface TranslateContextValue {\n  messages: Record<string, string>\n}\n\nconst TranslateContext = createContext<TranslateContextValue>({ messages: {} })\n\n/** Props for `TranslateProvider`. */\nexport interface TranslateProviderProps {\n  /** Flattened locale message map keyed by stable message id. */\n  messages: Record<string, string>\n  /** React subtree that should have access to translations. */\n  children: ReactNode\n}\n\n/** Provides translated messages to React components below it. */\nexport function TranslateProvider({ messages, children }: TranslateProviderProps) {\n  const value = useMemo(() => ({ messages }), [messages])\n  return <TranslateContext.Provider value={value}>{children}</TranslateContext.Provider>\n}\n\n/** Returns the raw locale message map from the current provider. */\nexport function useMessages() {\n  return use(TranslateContext).messages\n}\n\ntype MessageValues = Record<string, unknown>\ntype TranslateFn = (message: string, valuesOrOptions?: MessageValues | TranslateOptions, options?: TranslateOptions) => string\n\n/** Returns a translator function for text used in props, labels, and other non-JSX positions. */\nexport function useT(): TranslateFn {\n  const { messages } = use(TranslateContext)\n  return useMemo<TranslateFn>(\n    () => (message, valuesOrOptions, options) => {\n      const values = isTranslateOptions(valuesOrOptions) ? undefined : normalizeValues(valuesOrOptions)\n      const resolvedOptions = isTranslateOptions(valuesOrOptions) ? valuesOrOptions : options\n      const template = messages[getCallMessageId(message, resolvedOptions)] ?? message\n      if (!values) return template\n      return template.replace(/\\{(\\w+)\\}/g, (_, name: string) => values[name] ?? `{${name}}`)\n    },\n    [messages],\n  )\n}\n\n/** Props for `Var`. */\nexport type VarProps = {\n  /** Optional shorthand child form, normalized at build time for simple identifiers. */\n  children?: ReactNode\n} & Record<string, ReactNode | undefined>\n\n/** Marks a runtime value for placeholder interpolation inside `<T>` content. */\nexport function Var(props: VarProps) {\n  return <>{getRuntimeVarEntry(props)?.value ?? props.children}</>\n}\n\n/** Props for `T`. */\nexport interface TProps {\n  /** Explicit stable id to use instead of hashing the rendered source text, whether provided manually or by a transform. */\n  id?: string\n  /** Extra disambiguating context for translators and custom grouping. */\n  context?: string\n  /** Source-language JSX content to translate. */\n  children?: ReactNode\n}\n\n/** Renders translated JSX content and supports placeholders through `<Var>`. */\nexport function T({ id, context, children }: TProps) {\n  const { messages } = use(TranslateContext)\n  const resolvedMeta = context ? { context } : undefined\n  const runtimeContent = useMemo(() => extractRuntimeContent(children), [children])\n  const template = messages[id ?? (runtimeContent.message ? getMessageId(runtimeContent.message, resolvedMeta) : \"\")]\n  const vars = template?.includes(\"{\") ? runtimeContent.vars : undefined\n  const interpolated = useMemo(() => interpolate(template, vars), [template, vars])\n\n  if (!template) return <>{children}</>\n  if (!vars) return <>{template}</>\n  if (!interpolated.length) return <>{children}</>\n  return <>{interpolated}</>\n}\n\nfunction interpolate(template?: string, vars?: Record<string, ReactNode>): ReactNode[] {\n  if (!template || !vars) return []\n  const result: ReactNode[] = []\n  const re = /\\{(\\w+)\\}/g\n  let lastIndex = 0\n  let match: RegExpExecArray | null\n\n  while ((match = re.exec(template)) !== null) {\n    if (match.index > lastIndex) result.push(template.slice(lastIndex, match.index))\n    result.push(vars[match[1]!] ?? `{${match[1]}}`)\n    lastIndex = re.lastIndex\n  }\n\n  if (lastIndex < template.length) result.push(template.slice(lastIndex))\n  return result\n}\n\nfunction extractRuntimeContent(children: ReactNode) {\n  const parts: string[] = []\n  const vars: Record<string, ReactNode> = {}\n\n  Children.forEach(children, (child) => {\n    if (typeof child === \"string\" || typeof child === \"number\") {\n      parts.push(String(child))\n      return\n    }\n\n    if (isValidElement<VarProps>(child) && child.type === Var) {\n      const entry = getRuntimeVarEntry(child.props)\n      if (entry) {\n        parts.push(`{${entry.name}}`)\n        vars[entry.name] = entry.value\n      }\n    }\n  })\n\n  return {\n    message: parts.join(\"\").replace(/\\s+/g, \" \").trim(),\n    vars: Object.keys(vars).length > 0 ? vars : undefined,\n  }\n}\n\nfunction getRuntimeVarEntry(props: VarProps) {\n  if (typeof props.name === \"string\" && props.children !== undefined) {\n    return { name: props.name, value: props.children }\n  }\n\n  const entries = Object.entries(props).filter(([key]) => key !== \"children\")\n  if (entries.length !== 1) return undefined\n\n  const [name, value] = entries[0]!\n  return { name, value }\n}\n\nfunction isTranslateOptions(value?: MessageValues | TranslateOptions): value is TranslateOptions {\n  if (!value || Array.isArray(value)) return false\n  return Object.keys(value).every((key) => key === \"id\" || key === \"context\")\n}\n\nfunction normalizeValues(values?: MessageValues) {\n  if (!values) return undefined\n  const entries = Object.entries(values).map(([name, value]) => [name, String(value)] as const)\n  return entries.length > 0 ? Object.fromEntries(entries) : undefined\n}\n"],"mappings":"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"}
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react.tsx"],"sourcesContent":["import { Children, createContext, isValidElement, use, useMemo, type ReactNode } from \"react\"\n\nimport type { TranslateOptions } from \"./types.js\"\n\nimport { getCallMessageId, getMessageId } from \"./message-id.js\"\n\ninterface TranslateContextValue {\n  messages: Record<string, string>\n}\n\nconst TranslateContext = createContext<TranslateContextValue>({ messages: {} })\n\n/** Props for `TranslateProvider`. */\nexport interface TranslateProviderProps {\n  /** Flattened locale message map keyed by stable lookup id. */\n  messages: Record<string, string>\n  /** React subtree that should have access to translations. */\n  children: ReactNode\n}\n\n/** Provides translated messages to React components below it. */\nexport function TranslateProvider({ messages, children }: TranslateProviderProps) {\n  const value = useMemo(() => ({ messages }), [messages])\n  return <TranslateContext.Provider value={value}>{children}</TranslateContext.Provider>\n}\n\n/** Returns the raw locale message map from the current provider. */\nexport function useMessages() {\n  return use(TranslateContext).messages\n}\n\ntype MessageValues = Record<string, unknown>\ntype TranslateFn = (message: string, valuesOrOptions?: MessageValues | TranslateOptions, options?: TranslateOptions) => string\n\n/** Returns a translator function for text used in props, labels, and other non-JSX positions. */\nexport function useT(): TranslateFn {\n  const { messages } = use(TranslateContext)\n  return useMemo<TranslateFn>(\n    () => (message, valuesOrOptions, options) => {\n      const values = isTranslateOptions(valuesOrOptions) ? undefined : normalizeValues(valuesOrOptions)\n      const resolvedOptions = isTranslateOptions(valuesOrOptions) ? valuesOrOptions : options\n      const template = messages[getCallMessageId(message, resolvedOptions)] ?? message\n      if (!values) return template\n      return template.replace(/\\{(\\w+)\\}/g, (_, name: string) => values[name] ?? `{${name}}`)\n    },\n    [messages],\n  )\n}\n\n/** Props for `Var`. */\nexport type VarProps = {\n  /** Optional shorthand child form, normalized at build time for simple identifiers. */\n  children?: ReactNode\n} & Record<string, ReactNode | undefined>\n\n/** Marks a runtime value for placeholder interpolation inside `<T>` content. */\nexport function Var(props: VarProps) {\n  return <>{getRuntimeVarEntry(props)?.value ?? props.children}</>\n}\n\n/** Props for `T`. */\nexport interface TProps {\n  /** Explicit stable lookup id to use instead of hashing the rendered source text, whether provided manually or by a transform. */\n  id?: string\n  /** Extra disambiguating context for translators and custom grouping. */\n  context?: string\n  /** Source-language JSX content to translate. */\n  children?: ReactNode\n}\n\n/** Renders translated JSX content and supports placeholders through `<Var>`. */\nexport function T({ id, context, children }: TProps) {\n  const { messages } = use(TranslateContext)\n  const resolvedMeta = context ? { context } : undefined\n  const runtimeContent = useMemo(() => extractRuntimeContent(children), [children])\n  const template = messages[id ?? (runtimeContent.message ? getMessageId(runtimeContent.message, resolvedMeta) : \"\")]\n  const vars = template?.includes(\"{\") ? runtimeContent.vars : undefined\n  const interpolated = useMemo(() => interpolate(template, vars), [template, vars])\n\n  if (!template) return <>{children}</>\n  if (!vars) return <>{template}</>\n  if (!interpolated.length) return <>{children}</>\n  return <>{interpolated}</>\n}\n\nfunction interpolate(template?: string, vars?: Record<string, ReactNode>): ReactNode[] {\n  if (!template || !vars) return []\n  const result: ReactNode[] = []\n  const re = /\\{(\\w+)\\}/g\n  let lastIndex = 0\n  let match: RegExpExecArray | null\n\n  while ((match = re.exec(template)) !== null) {\n    if (match.index > lastIndex) result.push(template.slice(lastIndex, match.index))\n    result.push(vars[match[1]!] ?? `{${match[1]}}`)\n    lastIndex = re.lastIndex\n  }\n\n  if (lastIndex < template.length) result.push(template.slice(lastIndex))\n  return result\n}\n\nfunction extractRuntimeContent(children: ReactNode) {\n  const parts: string[] = []\n  const vars: Record<string, ReactNode> = {}\n\n  Children.forEach(children, (child) => {\n    if (typeof child === \"string\" || typeof child === \"number\") {\n      parts.push(String(child))\n      return\n    }\n\n    if (isValidElement<VarProps>(child) && child.type === Var) {\n      const entry = getRuntimeVarEntry(child.props)\n      if (entry) {\n        parts.push(`{${entry.name}}`)\n        vars[entry.name] = entry.value\n      }\n    }\n  })\n\n  return {\n    message: parts.join(\"\").replace(/\\s+/g, \" \").trim(),\n    vars: Object.keys(vars).length > 0 ? vars : undefined,\n  }\n}\n\nfunction getRuntimeVarEntry(props: VarProps) {\n  if (typeof props.name === \"string\" && props.children !== undefined) {\n    return { name: props.name, value: props.children }\n  }\n\n  const entries = Object.entries(props).filter(([key]) => key !== \"children\")\n  if (entries.length !== 1) return undefined\n\n  const [name, value] = entries[0]!\n  return { name, value }\n}\n\nfunction isTranslateOptions(value?: MessageValues | TranslateOptions): value is TranslateOptions {\n  if (!value || Array.isArray(value)) return false\n  return Object.keys(value).every((key) => key === \"id\" || key === \"context\")\n}\n\nfunction normalizeValues(values?: MessageValues) {\n  if (!values) return undefined\n  const entries = Object.entries(values).map(([name, value]) => [name, String(value)] as const)\n  return entries.length > 0 ? Object.fromEntries(entries) : undefined\n}\n"],"mappings":"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"}

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-import { p as TranslateOptions } from "./types-DxcBf0RB.mjs";
+import { l as TranslateOptions } from "./types-Ca8X5uZF.mjs";
 
 //#region src/server.d.ts
 type MessageValues = Record<string, unknown>;

package/dist/server.mjs

@@ -1,4 +1,4 @@
-import { t as getCallMessageId } from "./message-id-B8zJjADZ.mjs";
+import { t as getCallMessageId } from "./message-id-DGUI8H5w.mjs";
 //#region src/server.ts
 /** Creates a lightweight server-side translator from a loaded message map. */
 function createTranslator(messages) {

package/dist/{types-DxcBf0RB.d.mts → types-Ca8X5uZF.d.mts}

@@ -31,22 +31,22 @@ interface ManifestEntry {
   /** Source locations that contributed to this manifest entry. */
   sources: MessageSource[];
 }
-/** In-memory manifest keyed by stable message id. */
+/** In-memory manifest keyed by stable lookup id. */
 type MessageManifest = Record<string, ManifestEntry>;
-/** Private on-disk manifest keyed by stable message id. */
+/** Private on-disk manifest keyed by stable lookup id. */
 type MessageManifestFile = MessageManifest;
-/** Flat runtime message map keyed by stable message id. */
+/** Flat runtime message map keyed by stable lookup id. */
 type RuntimeMessages = Record<string, string>;
 /** Extra metadata that can influence translation and message grouping. */
 interface TranslateOptions {
-  /** Explicit stable message id for direct runtime lookups, whether provided manually or by a transform. */
+  /** Explicit stable lookup id for direct runtime lookups, whether provided manually or by a transform. */
   id?: string;
   /** Extra disambiguating context for translators and custom ids. */
   context?: string;
 }
 /** A full message payload passed to the translate callback. */
 interface TranslateMessage {
-  /** Stable message id used for locale file keys and translation results. */
+  /** Stable lookup id used for locale file keys and translation results. */
   id: string;
   /** Source-language text that should be translated. */
   text: string;
@@ -59,22 +59,6 @@ interface TranslateMessage {
 }
 /** User-provided translation function used to fill missing locale entries. */
 type TranslateFn = (messages: TranslateMessage[], locale: string) => Promise<Record<string, string>>;
-/** Stores messages in a remote backend. Deprecated: use `runtime.type = "remote"` instead. */
-interface BetterTranslateRemoteStorageOptions {
-  /** Selects remote storage. */
-  type: "remote";
-  /** Optional remote backend URL. */
-  url?: string;
-}
-/** Writes locale JSON files into the app repository or deployed artifact. Deprecated: use `runtime.type = "local"` instead. */
-interface BetterTranslateLocalStorageOptions {
-  /** Selects local file storage. */
-  type: "local";
-  /** Output directory where locale JSON files are written. */
-  output?: string;
-}
-/** Controls where translated locale artifacts are written or synced. */
-type BetterTranslateStorageOptions = BetterTranslateRemoteStorageOptions | BetterTranslateLocalStorageOptions;
 /** Writes locale files into the app and loads them through Vite. */
 interface BetterTranslateLocalRuntimeOptions {
   /** Selects local runtime artifacts. */
@@ -85,6 +69,8 @@ interface BetterTranslateLocalRuntimeOptions {
   output?: string;
   /** Public URL prefix used by the generated loader for `target: "public"`. */
   basePath?: string;
+  /** Custom translation function used for messages missing from non-default locales. */
+  translate?: TranslateFn;
 }
 /** Loads locale files from an external translation service. */
 interface BetterTranslateRemoteRuntimeOptions {
@@ -93,19 +79,18 @@ interface BetterTranslateRemoteRuntimeOptions {
   /** Remote translation service URL. */
   endpoint?: string;
   /** Remote project identifier. */
-  projectId?: string;
+  projectId: string;
+  /** Project API key used by the Vite plugin to sync Manifests. Falls back to `BETTER_TRANSLATION_API_KEY`. */
+  apiKey?: string;
+  /** Branch to read from, or `"auto"` to infer it from the environment. */
+  branch?: "auto" | (string & {});
+  /** Local development behavior for remote runtime mode. */
+  dev?: {
+    /** Avoid platform reads and writes during local development. */offline?: boolean;
+  };
 }
 /** Controls where locale artifacts live and how the virtual runtime loader reads them. */
 type BetterTranslateRuntimeOptions = BetterTranslateLocalRuntimeOptions | BetterTranslateRemoteRuntimeOptions;
-/** Runtime metadata emitted by the plugin for server-side loaders. */
-interface BetterTranslateRuntimeConfig {
-  /** Runtime backend configured for locale artifacts. */
-  runtime: BetterTranslateRuntimeOptions;
-  /** Locale code treated as the source language. */
-  defaultLocale: string;
-  /** All locale codes emitted by the plugin. */
-  locales: string[];
-}
 /** Public configuration for the Better Translation Vite plugin. */
 interface BetterTranslatePluginOptions {
   /** All locale codes that should be emitted. */
@@ -120,11 +105,7 @@ interface BetterTranslatePluginOptions {
   logging?: boolean;
   /** Runtime backend configuration. */
   runtime?: BetterTranslateRuntimeOptions;
-  /** Storage backend configuration. Deprecated: use `runtime` instead. */
-  storage?: BetterTranslateStorageOptions;
-  /** Custom translation function used for messages missing from non-default locales. */
-  translate?: TranslateFn;
 }
 //#endregion
-export { BetterTranslateRemoteStorageOptions as a, BetterTranslateStorageOptions as c, TranslateFn as d, TranslateMessage as f, BetterTranslateRemoteRuntimeOptions as i, MessageManifestFile as l, BetterTranslateLocalStorageOptions as n, BetterTranslateRuntimeConfig as o, TranslateOptions as p, BetterTranslatePluginOptions as r, BetterTranslateRuntimeOptions as s, BetterTranslateLocalRuntimeOptions as t, RuntimeMessages as u };
-//# sourceMappingURL=types-DxcBf0RB.d.mts.map
+export { MessageManifestFile as a, TranslateMessage as c, BetterTranslateRuntimeOptions as i, TranslateOptions as l, BetterTranslatePluginOptions as n, RuntimeMessages as o, BetterTranslateRemoteRuntimeOptions as r, TranslateFn as s, BetterTranslateLocalRuntimeOptions as t };
+//# sourceMappingURL=types-Ca8X5uZF.d.mts.map

package/dist/types-Ca8X5uZF.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Ca8X5uZF.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;UAeiB,aAAA;EAkBZ;EAhBH,IAAA;EAoB4B;EAlB5B,IAAA;EA0BsB;EAxBtB,MAAA;EAoBA;EAlBA,IAAA;EAoBA;EAlBA,MAAA;EAoBS;EAlBT,OAAA;EAkBsB;EAhBtB,SAAA;EAoByB;EAlBzB,KAAA;EAkB4B;EAhB5B,GAAA;AAAA;;UAIe,aAAA;EAegC;EAb/C,cAAA;EAgBU;EAdV,IAAA,EAAM,gBAAA;;EAEN,YAAA;EAYkC;EAVlC,OAAA,EAAS,aAAa;AAAA;;KAIZ,eAAA,GAAkB,MAAM,SAAS,aAAA;AA2DpC;AAAA,KAxDG,mBAAA,GAAsB,eAAe;;KAGrC,eAAA,GAAkB,MAAM;;UAiDnB,gBAAA;EA2Cf;EAzCA,EAAA;EA6CA;EA3CA,OAAO;AAAA;;UAIQ,gBAAA;EA6CN;EA3CT,EAAA;EAgDuC;EA9CvC,IAAA;EA8C0C;EA5C1C,IAAA,EAAM,gBAAA;EA+CS;EA7Cf,YAAA;;EAEA,OAAA,EAAS,aAAa;AAAA;;KAIZ,WAAA,IAAe,QAAA,EAAU,gBAAA,IAAoB,MAAA,aAAmB,OAAA,CAAQ,MAAA;;UAGnE,kCAAA;EAgDf;EA9CA,IAAA;EA8CuC;EA5CvC,MAAA;;EAEA,MAAA;;EAEA,QAAA;;EAEA,SAAA,GAAY,WAAW;AAAA;;UAIR,mCAAA;;EAEf,IAAA;;EAEA,QAAA;;EAEA,SAAA;;EAEA,MAAA;;EAEA,MAAA;;EAEA,GAAA;oEAEE,OAAA;EAAA;AAAA;;KAKQ,6BAAA,GAAgC,kCAAA,GAAqC,mCAAmC;;UAGnG,4BAAA;;EAEf,OAAA;;EAEA,aAAA;;EAEA,OAAA;;EAEA,SAAA;;EAEA,OAAA;;EAEA,OAAA,GAAU,6BAA6B;AAAA"}

package/dist/vite.d.mts

@@ -1,9 +1,9 @@
-import { a as BetterTranslateRemoteStorageOptions, c as BetterTranslateStorageOptions, d as TranslateFn, f as TranslateMessage, i as BetterTranslateRemoteRuntimeOptions, l as MessageManifestFile, n as BetterTranslateLocalStorageOptions, o as BetterTranslateRuntimeConfig, p as TranslateOptions, r as BetterTranslatePluginOptions, s as BetterTranslateRuntimeOptions, t as BetterTranslateLocalRuntimeOptions, u as RuntimeMessages } from "./types-DxcBf0RB.mjs";
+import { a as MessageManifestFile, c as TranslateMessage, i as BetterTranslateRuntimeOptions, l as TranslateOptions, n as BetterTranslatePluginOptions, o as RuntimeMessages, r as BetterTranslateRemoteRuntimeOptions, s as TranslateFn, t as BetterTranslateLocalRuntimeOptions } from "./types-Ca8X5uZF.mjs";
 import { Plugin } from "vite";
 
 //#region src/plugin.d.ts
 /** Scans source files for translatable messages and keeps locale JSON files in sync. */
 declare function betterTranslation(options: BetterTranslatePluginOptions): Plugin;
 //#endregion
-export { type BetterTranslateLocalRuntimeOptions, type BetterTranslateLocalStorageOptions, type BetterTranslatePluginOptions, type BetterTranslateRemoteRuntimeOptions, type BetterTranslateRemoteStorageOptions, type BetterTranslateRuntimeConfig, type BetterTranslateRuntimeOptions, type BetterTranslateStorageOptions, type MessageManifestFile, type RuntimeMessages, type TranslateFn, type TranslateMessage, type TranslateOptions, betterTranslation };
+export { type BetterTranslateLocalRuntimeOptions, type BetterTranslatePluginOptions, type BetterTranslateRemoteRuntimeOptions, type BetterTranslateRuntimeOptions, type MessageManifestFile, type RuntimeMessages, type TranslateFn, type TranslateMessage, type TranslateOptions, betterTranslation };
 //# sourceMappingURL=vite.d.mts.map

package/dist/vite.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;;iBA8DgB,iBAAA,CAAkB,OAAA,EAAS,4BAAA,GAA+B,MAAM"}
+{"version":3,"file":"vite.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;;iBA4DgB,iBAAA,CAAkB,OAAA,EAAS,4BAAA,GAA+B,MAAM"}