better-translation 0.1.0

package/dist/message-id-7Mx7G9xT.mjs

@@ -0,0 +1,32 @@
+//#region src/message-id.ts
+function normalizeMeta(meta) {
+	if (!meta) return {};
+	return Object.fromEntries(Object.entries(meta).filter(([key, value]) => key !== "id" && value !== void 0).sort(([a], [b]) => a.localeCompare(b)));
+}
+function serializeMeta(meta) {
+	if (!meta) return "";
+	const normalized = normalizeMeta(meta);
+	return Object.keys(normalized).length > 0 ? JSON.stringify(normalized) : "";
+}
+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. */
+function getMessageId(message, meta) {
+	const value = getMessageIdentity(message, meta);
+	let hash = 2166136261;
+	for (let i = 0; i < value.length; i++) {
+		hash ^= value.charCodeAt(i);
+		hash = Math.imul(hash, 16777619);
+	}
+	return `m_${(hash >>> 0).toString(36)}`;
+}
+/** Resolves the lookup id for function-style `t()` calls, preferring an explicit `options.id`. */
+function getCallMessageId(message, options) {
+	return options?.id ?? getMessageId(message, options);
+}
+//#endregion
+export { getMessageId as n, serializeMeta as r, getCallMessageId as t };
+
+//# sourceMappingURL=message-id-7Mx7G9xT.mjs.map

package/dist/message-id-7Mx7G9xT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-id-7Mx7G9xT.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 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;AACvE,KAAI,CAAC,KAAM,QAAO,EAAE;AAEpB,QAAO,OAAO,YACZ,OAAO,QAAQ,KAAK,CACjB,QAAQ,CAAC,KAAK,WAAW,QAAQ,QAAQ,UAAU,KAAA,EAAU,CAC7D,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CAC1C;;AAGH,SAAgB,cAAc,MAAyB;AACrD,KAAI,CAAC,KAAM,QAAO;CAElB,MAAM,aAAa,cAAc,KAAK;AACtC,QAAO,OAAO,KAAK,WAAW,CAAC,SAAS,IAAI,KAAK,UAAU,WAAW,GAAG;;AAG3E,SAAgB,mBAAmB,SAAiB,MAAyB;CAC3E,MAAM,iBAAiB,cAAc,KAAK;AAC1C,QAAO,iBAAiB,GAAG,QAAQ,IAAI,mBAAmB;;;AAI5D,SAAgB,aAAa,SAAiB,MAAyB;CACrE,MAAM,QAAQ,mBAAmB,SAAS,KAAK;CAC/C,IAAI,OAAO;AAEX,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAQ,MAAM,WAAW,EAAE;AAC3B,SAAO,KAAK,KAAK,MAAM,SAAS;;AAGlC,QAAO,MAAM,SAAS,GAAG,SAAS,GAAG;;;AAIvC,SAAgB,iBAAiB,SAAiB,SAA4B;AAC5E,QAAO,SAAS,MAAM,aAAa,SAAS,QAAQ"}

package/dist/react.d.mts

@@ -0,0 +1,45 @@
+import { u as TranslateOptions } from "./types-Di93oTw4.mjs";
+import { ReactNode } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/react.d.ts
+/** Props for `TranslateProvider`. */
+interface TranslateProviderProps {
+  /** Flattened locale message map keyed by stable message id. */
+  messages: Record<string, string>;
+  /** React subtree that should have access to translations. */
+  children: ReactNode;
+}
+/** Provides translated messages to React components below it. */
+declare function TranslateProvider({
+  messages,
+  children
+}: TranslateProviderProps): _$react_jsx_runtime0.JSX.Element;
+/** Returns the raw locale message map from the current provider. */
+declare function useMessages(): Record<string, string>;
+/** Returns a translator function for text used in props, labels, and other non-JSX positions. */
+declare function useT(): (message: string, options?: TranslateOptions) => string;
+/** Props for `Var`. */
+type VarProps = {
+  /** Optional shorthand child form, normalized at build time for simple identifiers. */children?: ReactNode;
+} & Record<string, ReactNode | undefined>;
+/** Marks a runtime value for placeholder interpolation inside `<T>` content. */
+declare function Var(props: VarProps): _$react_jsx_runtime0.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. */
+  id?: string;
+  /** Extra disambiguating context for translators and custom grouping. */
+  context?: string;
+  /** Source-language JSX content to translate. */
+  children?: ReactNode;
+}
+/** Renders translated JSX content and supports placeholders through `<Var>`. */
+declare function T({
+  id,
+  context,
+  children
+}: TProps): _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { T, TProps, TranslateProvider, TranslateProviderProps, Var, VarProps, useMessages, useT };
+//# sourceMappingURL=react.d.mts.map

package/dist/react.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.mts","names":[],"sources":["../src/react.tsx"],"mappings":";;;;;;UAaiB,sBAAA;;EAEf,QAAA,EAAU,MAAA;EAF2B;EAIrC,QAAA,EAAU,SAAA;AAAA;;iBAII,iBAAA,CAAA;EAAoB,QAAA;EAAU;AAAA,GAAY,sBAAA,GAAsB,oBAAA,CAAA,GAAA,CAAA,OAAA;;iBAMhE,WAAA,CAAA,GAAW,MAAA;;iBAOX,IAAA,CAAA,IAAS,OAAA,UAAiB,OAAA,GAAU,gBAAA;AAbpD;AAAA,KAmBY,QAAA;wFAEV,QAAA,GAAW,SAAA;AAAA,IACT,MAAA,SAAe,SAAA;;iBAGH,GAAA,CAAI,KAAA,EAAO,QAAA,GAAQ,oBAAA,CAAA,GAAA,CAAA,OAAA;;UAKlB,MAAA;EA9BmB;EAgClC,EAAA;EAhC4C;EAkC5C,OAAA;EAlCwD;EAoCxD,QAAA,GAAW,SAAA;AAAA;;iBAIG,CAAA,CAAA;EAAI,EAAA;EAAI,OAAA;EAAS;AAAA,GAAY,MAAA,GAAM,oBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/react.mjs

@@ -0,0 +1,91 @@
+import { n as getMessageId, t as getCallMessageId } from "./message-id-7Mx7G9xT.mjs";
+import { Children, createContext, isValidElement, useContext, useMemo } from "react";
+import { Fragment, jsx } from "react/jsx-runtime";
+//#region src/react.tsx
+const TranslateContext = createContext({ messages: {} });
+/** Provides translated messages to React components below it. */
+function TranslateProvider({ messages, children }) {
+	const value = useMemo(() => ({ messages }), [messages]);
+	return /* @__PURE__ */ jsx(TranslateContext.Provider, {
+		value,
+		children
+	});
+}
+/** Returns the raw locale message map from the current provider. */
+function useMessages() {
+	return useContext(TranslateContext).messages;
+}
+/** Returns a translator function for text used in props, labels, and other non-JSX positions. */
+function useT() {
+	const { messages } = useContext(TranslateContext);
+	return useMemo(() => (message, options) => messages[getCallMessageId(message, options)] ?? message, [messages]);
+}
+/** Marks a runtime value for placeholder interpolation inside `<T>` content. */
+function Var(props) {
+	return /* @__PURE__ */ jsx(Fragment, { children: getRuntimeVarEntry(props)?.value ?? props.children });
+}
+/** Renders translated JSX content and supports placeholders through `<Var>`. */
+function T({ id, context, children }) {
+	const { messages } = useContext(TranslateContext);
+	const resolvedMeta = context ? { context } : void 0;
+	const runtimeContent = useMemo(() => extractRuntimeContent(children), [children]);
+	const template = messages[id ?? (runtimeContent.message ? getMessageId(runtimeContent.message, resolvedMeta) : "")];
+	const vars = template?.includes("{") ? runtimeContent.vars : void 0;
+	const interpolated = useMemo(() => interpolate(template, vars), [template, vars]);
+	if (!template) return /* @__PURE__ */ jsx(Fragment, { children });
+	if (!vars) return /* @__PURE__ */ jsx(Fragment, { children: template });
+	if (!interpolated.length) return /* @__PURE__ */ jsx(Fragment, { children });
+	return /* @__PURE__ */ jsx(Fragment, { children: interpolated });
+}
+function interpolate(template, vars) {
+	if (!template || !vars) return [];
+	const result = [];
+	const re = /\{(\w+)\}/g;
+	let lastIndex = 0;
+	let match;
+	while ((match = re.exec(template)) !== null) {
+		if (match.index > lastIndex) result.push(template.slice(lastIndex, match.index));
+		result.push(vars[match[1]] ?? `{${match[1]}}`);
+		lastIndex = re.lastIndex;
+	}
+	if (lastIndex < template.length) result.push(template.slice(lastIndex));
+	return result;
+}
+function extractRuntimeContent(children) {
+	const parts = [];
+	const vars = {};
+	Children.forEach(children, (child) => {
+		if (typeof child === "string" || typeof child === "number") {
+			parts.push(String(child));
+			return;
+		}
+		if (isValidElement(child) && child.type === Var) {
+			const entry = getRuntimeVarEntry(child.props);
+			if (entry) {
+				parts.push(`{${entry.name}}`);
+				vars[entry.name] = entry.value;
+			}
+		}
+	});
+	return {
+		message: parts.join("").replace(/\s+/g, " ").trim(),
+		vars: Object.keys(vars).length > 0 ? vars : void 0
+	};
+}
+function getRuntimeVarEntry(props) {
+	if (typeof props.name === "string" && props.children !== void 0) return {
+		name: props.name,
+		value: props.children
+	};
+	const entries = Object.entries(props).filter(([key]) => key !== "children");
+	if (entries.length !== 1) return void 0;
+	const [name, value] = entries[0];
+	return {
+		name,
+		value
+	};
+}
+//#endregion
+export { T, TranslateProvider, Var, useMessages, useT };
+
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react.tsx"],"sourcesContent":["import { Children, createContext, isValidElement, useContext, 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 useContext(TranslateContext).messages\n}\n\ntype TranslateFn = (id: string, options?: TranslateOptions) => string\n\n/** Returns a translator function for text used in props, labels, and other non-JSX positions. */\nexport function useT(): (message: string, options?: TranslateOptions) => string {\n  const { messages } = useContext(TranslateContext)\n  return useMemo<TranslateFn>(() => (message, options) => messages[getCallMessageId(message, options)] ?? message, [messages])\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 } = useContext(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"],"mappings":"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"}

package/dist/server.d.mts

@@ -0,0 +1,26 @@
+import { u as TranslateOptions } from "./types-Di93oTw4.mjs";
+
+//#region src/server.d.ts
+/** A server-side placeholder value used by `msg()` template interpolation. */
+interface VarResult {
+  /** Internal marker used to identify placeholder values. */
+  __i18n: true;
+  /** Placeholder name used inside the translated template. */
+  name: string;
+  /** Runtime value that should replace the placeholder. */
+  value: unknown;
+}
+/** Marks a value for replacement into a translated server-side template message. */
+declare function v(name: string, value: unknown): VarResult;
+/** The server-side translation helpers returned by `createTranslator()`. */
+interface ServerTranslator {
+  /** Translates a plain string in non-JSX contexts such as errors or email helpers. */
+  t: (id: string, options?: TranslateOptions) => string;
+  /** Translates a template message with runtime placeholders. */
+  msg: (id: string) => (strings: TemplateStringsArray, ...expressions: VarResult[]) => string;
+}
+/** Creates lightweight server-side translation helpers from a loaded message map. */
+declare function createTranslator(messages: Record<string, string>): ServerTranslator;
+//#endregion
+export { ServerTranslator, VarResult, createTranslator, v };
+//# sourceMappingURL=server.d.mts.map

package/dist/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../src/server.ts"],"mappings":";;;;UAKiB,SAAA;EAAA;EAEf,MAAA;;EAEA,IAAA;EAFA;EAIA,KAAA;AAAA;;iBAIc,CAAA,CAAE,IAAA,UAAc,KAAA,YAAiB,SAAA;AAAjD;AAAA,UAKiB,gBAAA;;EAEf,CAAA,GAAI,EAAA,UAAY,OAAA,GAAU,gBAAA;EAPV;EAShB,GAAA,GAAM,EAAA,cAAgB,OAAA,EAAS,oBAAA,KAAyB,WAAA,EAAa,SAAA;AAAA;;iBAIvD,gBAAA,CAAiB,QAAA,EAAU,MAAA,mBAAyB,gBAAA"}

package/dist/server.mjs

@@ -0,0 +1,35 @@
+import { t as getCallMessageId } from "./message-id-7Mx7G9xT.mjs";
+//#region src/server.ts
+/** Marks a value for replacement into a translated server-side template message. */
+function v(name, value) {
+	return {
+		__i18n: true,
+		name,
+		value
+	};
+}
+/** Creates lightweight server-side translation helpers from a loaded message map. */
+function createTranslator(messages) {
+	function t(id, options) {
+		return messages[getCallMessageId(id, options)] ?? id;
+	}
+	function msg(id) {
+		return (strings, ...expressions) => {
+			const template = messages[id];
+			if (!template) return strings.reduce((acc, str, i) => {
+				const expr = expressions[i];
+				return acc + str + (expr ? String(expr.value) : "");
+			}, "");
+			const values = Object.fromEntries(expressions.filter((expr) => Boolean(expr?.__i18n)).map((expr) => [expr.name, String(expr.value)]));
+			return template.replace(/\{(\w+)\}/g, (_, name) => values[name] ?? `{${name}}`);
+		};
+	}
+	return {
+		t,
+		msg
+	};
+}
+//#endregion
+export { createTranslator, v };
+
+//# sourceMappingURL=server.mjs.map

package/dist/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":[],"sources":["../src/server.ts"],"sourcesContent":["import type { TranslateOptions } from \"./types.js\"\n\nimport { getCallMessageId } from \"./message-id.js\"\n\n/** A server-side placeholder value used by `msg()` template interpolation. */\nexport interface VarResult {\n  /** Internal marker used to identify placeholder values. */\n  __i18n: true\n  /** Placeholder name used inside the translated template. */\n  name: string\n  /** Runtime value that should replace the placeholder. */\n  value: unknown\n}\n\n/** Marks a value for replacement into a translated server-side template message. */\nexport function v(name: string, value: unknown): VarResult {\n  return { __i18n: true, name, value }\n}\n\n/** The server-side translation helpers returned by `createTranslator()`. */\nexport interface ServerTranslator {\n  /** Translates a plain string in non-JSX contexts such as errors or email helpers. */\n  t: (id: string, options?: TranslateOptions) => string\n  /** Translates a template message with runtime placeholders. */\n  msg: (id: string) => (strings: TemplateStringsArray, ...expressions: VarResult[]) => string\n}\n\n/** Creates lightweight server-side translation helpers from a loaded message map. */\nexport function createTranslator(messages: Record<string, string>): ServerTranslator {\n  function t(id: string, options?: TranslateOptions) {\n    return messages[getCallMessageId(id, options)] ?? id\n  }\n\n  function msg(id: string) {\n    return (strings: TemplateStringsArray, ...expressions: VarResult[]) => {\n      const template = messages[id]\n\n      if (!template) {\n        return strings.reduce((acc, str, i) => {\n          const expr = expressions[i]\n          return acc + str + (expr ? String(expr.value) : \"\")\n        }, \"\")\n      }\n\n      const values = Object.fromEntries(\n        expressions.filter((expr): expr is VarResult => Boolean(expr?.__i18n)).map((expr) => [expr.name, String(expr.value)]),\n      )\n      return template.replace(/\\{(\\w+)\\}/g, (_, name: string) => values[name] ?? `{${name}}`)\n    }\n  }\n\n  return { t, msg }\n}\n"],"mappings":";;;AAeA,SAAgB,EAAE,MAAc,OAA2B;AACzD,QAAO;EAAE,QAAQ;EAAM;EAAM;EAAO;;;AAYtC,SAAgB,iBAAiB,UAAoD;CACnF,SAAS,EAAE,IAAY,SAA4B;AACjD,SAAO,SAAS,iBAAiB,IAAI,QAAQ,KAAK;;CAGpD,SAAS,IAAI,IAAY;AACvB,UAAQ,SAA+B,GAAG,gBAA6B;GACrE,MAAM,WAAW,SAAS;AAE1B,OAAI,CAAC,SACH,QAAO,QAAQ,QAAQ,KAAK,KAAK,MAAM;IACrC,MAAM,OAAO,YAAY;AACzB,WAAO,MAAM,OAAO,OAAO,OAAO,KAAK,MAAM,GAAG;MAC/C,GAAG;GAGR,MAAM,SAAS,OAAO,YACpB,YAAY,QAAQ,SAA4B,QAAQ,MAAM,OAAO,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,MAAM,OAAO,KAAK,MAAM,CAAC,CAAC,CACtH;AACD,UAAO,SAAS,QAAQ,eAAe,GAAG,SAAiB,OAAO,SAAS,IAAI,KAAK,GAAG;;;AAI3F,QAAO;EAAE;EAAG;EAAK"}

package/dist/types-Di93oTw4.d.mts

@@ -0,0 +1,106 @@
+//#region src/types.d.ts
+/** Source metadata for a single extracted message occurrence. */
+interface MessageSource {
+  /** File path relative to the Vite root where the message came from. */
+  file: string;
+  /** Extraction marker that produced the message. */
+  kind: "call" | "component" | "tagged-template";
+  /** Concrete marker name encountered in source, such as `t` or `T`. */
+  marker: string;
+  /** 1-based starting line number of the extracted node. */
+  line: number;
+  /** 1-based starting column number of the extracted node. */
+  column: number;
+  /** 1-based ending line number of the extracted node. */
+  endLine: number;
+  /** 1-based ending column number of the extracted node. */
+  endColumn: number;
+  /** Zero-based starting byte offset in the source file. */
+  start: number;
+  /** Zero-based ending byte offset in the source file. */
+  end: number;
+}
+/** Internal manifest entry used while aggregating extracted messages. */
+interface ManifestEntry {
+  /** Source-language text that should be translated. */
+  defaultMessage: string;
+  /** Optional metadata that affects translation or message grouping. */
+  meta: TranslateOptions;
+  /** Placeholder names discovered in the message text. */
+  placeholders: string[];
+  /** Source locations that contributed to this manifest entry. */
+  sources: MessageSource[];
+}
+/** In-memory manifest keyed by stable message id. */
+type MessageManifest = Record<string, ManifestEntry>;
+/** Private on-disk manifest keyed by stable message id. */
+type MessageManifestFile = MessageManifest;
+/** Flat runtime message map keyed by stable message 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. */
+  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. */
+  id: string;
+  /** Source-language text that should be translated. */
+  text: string;
+  /** Optional metadata that affects translation or message grouping. */
+  meta: TranslateOptions;
+  /** Placeholder names discovered in the message text. */
+  placeholders: string[];
+  /** Source locations that produced this message. */
+  sources: MessageSource[];
+}
+/** 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. */
+interface BetterTranslateRemoteStorageOptions {
+  /** Selects remote storage. */
+  type: "remote";
+  /** Optional remote backend URL. */
+  url?: string;
+}
+/** Bundles locale JSON files into the app source tree or deployed artifact. */
+interface BetterTranslateBundleStorageOptions {
+  /** Selects bundled storage. */
+  type: "bundle";
+  /** Output directory where locale JSON files are written. */
+  output?: string;
+}
+/** Controls where translated locale artifacts are written or synced. */
+type BetterTranslateStorageOptions = BetterTranslateRemoteStorageOptions | BetterTranslateBundleStorageOptions;
+/** Runtime metadata emitted by the plugin for server-side loaders. */
+interface BetterTranslateRuntimeConfig {
+  /** Storage backend configured for emitted locale artifacts. */
+  storage: BetterTranslateStorageOptions;
+  /** 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. */
+  locales: string[];
+  /** Locale code treated as the source language. */
+  defaultLocale?: string;
+  /** Source directory or directories, relative to the Vite root. Defaults to `"src"`. */
+  rootDir?: string | string[];
+  /** Cache file path, relative to the Vite root. */
+  cacheFile?: string;
+  /** Enables or disables plugin logging. */
+  logging?: boolean;
+  /** Storage backend configuration. */
+  storage?: BetterTranslateStorageOptions;
+  /** Custom translation function used for messages missing from non-default locales. */
+  translate?: TranslateFn;
+}
+//#endregion
+export { BetterTranslateStorageOptions as a, TranslateFn as c, BetterTranslateRuntimeConfig as i, TranslateMessage as l, BetterTranslatePluginOptions as n, MessageManifestFile as o, BetterTranslateRemoteStorageOptions as r, RuntimeMessages as s, BetterTranslateBundleStorageOptions as t, TranslateOptions as u };
+//# sourceMappingURL=types-Di93oTw4.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-Di93oTw4.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;EAeiB;EAbhC,cAAA;EAgBU;EAdV,IAAA,EAAM,gBAAA;;EAEN,YAAA;EAYkC;EAVlC,OAAA,EAAS,aAAA;AAAA;;KAIC,eAAA,GAAkB,MAAA,SAAe,aAAA;;KAGjC,mBAAA,GAAsB,eAAA;;KAGtB,eAAA,GAAkB,MAAA;AA6F9B;AAAA,UA5CiB,gBAAA;;EAEf,EAAA;EA4CA;EA1CA,OAAA;AAAA;;UAIe,gBAAA;EA0CR;EAxCP,EAAA;EA4C2C;EA1C3C,IAAA;EAwDuB;EAtDvB,IAAA,EAAM,gBAAA;EA4CN;EA1CA,YAAA;EA8CA;EA5CA,OAAA,EAAS,aAAA;AAAA;;KAIC,WAAA,IAAe,QAAA,EAAU,gBAAA,IAAoB,MAAA,aAAmB,OAAA,CAAQ,MAAA;;UAGnE,mCAAA;EA2CQ;EAzCvB,IAAA;;EAEA,GAAA;AAAA;;UAIe,mCAAA;;EAEf,IAAA;;EAEA,MAAA;AAAA;;KAIU,6BAAA,GAAgC,mCAAA,GAAsC,mCAAA;;UAGjE,4BAAA;;EAEf,OAAA,EAAS,6BAAA;;EAET,aAAA;;EAEA,OAAA;AAAA;;UAIe,4BAAA;;EAEf,OAAA;;EAEA,aAAA;;EAEA,OAAA;;EAEA,SAAA;;EAEA,OAAA;;EAEA,OAAA,GAAU,6BAAA;;EAEV,SAAA,GAAY,WAAA;AAAA"}

package/dist/vite.d.mts

@@ -0,0 +1,9 @@
+import { a as BetterTranslateStorageOptions, c as TranslateFn, i as BetterTranslateRuntimeConfig, l as TranslateMessage, n as BetterTranslatePluginOptions, o as MessageManifestFile, r as BetterTranslateRemoteStorageOptions, s as RuntimeMessages, t as BetterTranslateBundleStorageOptions, u as TranslateOptions } from "./types-Di93oTw4.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 betterTranslate(options: BetterTranslatePluginOptions): Plugin;
+//#endregion
+export { type BetterTranslateBundleStorageOptions, type BetterTranslatePluginOptions, type BetterTranslateRemoteStorageOptions, type BetterTranslateRuntimeConfig, type BetterTranslateStorageOptions, type MessageManifestFile, type RuntimeMessages, type TranslateFn, type TranslateMessage, type TranslateOptions, betterTranslate };
+//# sourceMappingURL=vite.d.mts.map

package/dist/vite.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.mts","names":[],"sources":["../src/plugin.ts"],"mappings":";;;;;iBAuDgB,eAAA,CAAgB,OAAA,EAAS,4BAAA,GAA+B,MAAA"}