fuma-translate 0.0.0

package/dist/compiler.d.mts

@@ -0,0 +1,21 @@
+import { Span } from "oxc-parser";
+
+//#region src/compiler.d.ts
+interface CompileOptions {
+  /** glob patterns */
+  input: string[];
+}
+interface CompileOutput {
+  /** All encoded keys */
+  translationKeys: string[];
+}
+declare class StaticAnalysisError extends Error {
+  readonly file: string;
+  readonly span?: Span | undefined;
+  constructor(message: string, file: string, span?: Span | undefined);
+}
+declare function compile(options: CompileOptions): Promise<CompileOutput>;
+declare function typegen(output: CompileOutput): string;
+//#endregion
+export { CompileOptions, CompileOutput, StaticAnalysisError, compile, typegen };
+//# sourceMappingURL=compiler.d.mts.map

package/dist/compiler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.mts","names":[],"sources":["../src/compiler.ts"],"mappings":";;;UAiBiB,cAAA;;EAEf,KAAK;AAAA;AAAA,UAGU,aAAA;EAHV;EAKL,eAAe;AAAA;AAAA,cAGJ,mBAAA,SAA4B,KAAA;EAAA,SAG5B,IAAA;EAAA,SACA,IAAA,GAAO,IAAA;cAFhB,OAAA,UACS,IAAA,UACA,IAAA,GAAO,IAAA;AAAA;AAAA,iBA2TE,OAAA,CAAQ,OAAA,EAAS,cAAA,GAAiB,OAAA,CAAQ,aAAA;AAAA,iBAkBhD,OAAA,CAAQ,MAAqB,EAAb,aAAa"}

package/dist/compiler.mjs

@@ -0,0 +1,200 @@
+import { t as encodeKey } from "./shared-CAhaQI7c.mjs";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { Visitor, parseSync } from "oxc-parser";
+import { glob } from "tinyglobby";
+//#region src/compiler.ts
+var StaticAnalysisError = class extends Error {
+	file;
+	span;
+	constructor(message, file, span) {
+		super(message);
+		this.file = file;
+		this.span = span;
+		this.name = "StaticAnalysisError";
+	}
+};
+function formatLocation(source, offset) {
+	let line = 1;
+	let column = 1;
+	for (let i = 0; i < offset && i < source.length; i++) if (source[i] === "\n") {
+		line++;
+		column = 1;
+	} else column++;
+	return `${line}:${column}`;
+}
+function isUseTranslationsCall(expr) {
+	return expr.type === "CallExpression" && expr.callee.type === "Identifier" && expr.callee.name === "useTranslations" && expr.arguments.length === 0;
+}
+function unwrapExpression(expr) {
+	while (expr.type === "ParenthesizedExpression" || expr.type === "TSAsExpression" || expr.type === "TSSatisfiesExpression" || expr.type === "TSTypeAssertion") expr = expr.expression;
+	return expr;
+}
+function fail(source, file, span, message) {
+	throw new StaticAnalysisError(`${file}:${formatLocation(source, span.start)}: ${message}`, file, span);
+}
+function collectStaticStrings(expr, source, file) {
+	expr = unwrapExpression(expr);
+	if (expr.type === "Literal" && typeof expr.value === "string") return [expr.value];
+	if (expr.type === "TemplateLiteral") {
+		if (expr.expressions.length > 0) fail(source, file, expr, "translation key must be a static string");
+		return [expr.quasis.map((q) => q.value.cooked ?? q.value.raw).join("")];
+	}
+	if (expr.type === "ConditionalExpression") return [...collectStaticStrings(expr.consequent, source, file), ...collectStaticStrings(expr.alternate, source, file)];
+	fail(source, file, expr, "translation key must be a static string");
+}
+function getNoteProperty(properties) {
+	for (const prop of properties) {
+		if (prop.type !== "Property") continue;
+		if (prop.kind !== "init") continue;
+		if (prop.shorthand && prop.key.type === "Identifier") {
+			if (prop.key.name === "note") return prop;
+			continue;
+		}
+		if (prop.key.type === "Identifier" && prop.key.name === "note") return prop;
+		if (prop.key.type === "Literal" && typeof prop.key.value === "string" && prop.key.value === "note") return prop;
+	}
+}
+function collectNotes(expr, source, file) {
+	if (!expr) return [void 0];
+	expr = unwrapExpression(expr);
+	if (expr.type === "ConditionalExpression") return [...collectNotes(expr.consequent, source, file), ...collectNotes(expr.alternate, source, file)];
+	if (expr.type !== "ObjectExpression") fail(source, file, expr, "translation options must be a static object");
+	for (const prop of expr.properties) if (prop.type === "SpreadElement") fail(source, file, prop, "translation options cannot use spread properties");
+	const noteProp = getNoteProperty(expr.properties);
+	if (!noteProp) return [void 0];
+	if (noteProp.shorthand) fail(source, file, noteProp, "translation note must be a static string");
+	return collectStaticStrings(noteProp.value, source, file).map((note) => note);
+}
+function currentScope(scopes) {
+	const scope = scopes.at(-1);
+	if (!scope) throw new Error("scope stack is empty");
+	return scope;
+}
+function registerBinding(pattern, isHook, scopes) {
+	switch (pattern.type) {
+		case "Identifier":
+			currentScope(scopes).set(pattern.name, isHook);
+			return;
+		case "ObjectPattern":
+			for (const prop of pattern.properties) if (prop.type === "RestElement") registerBinding(prop.argument, false, scopes);
+			else registerBinding(prop.value, false, scopes);
+			return;
+		case "ArrayPattern":
+			for (const element of pattern.elements) {
+				if (!element) continue;
+				if (element.type === "RestElement") registerBinding(element.argument, false, scopes);
+				else registerBinding(element, false, scopes);
+			}
+			return;
+		case "AssignmentPattern":
+			registerBinding(pattern.left, isHook, scopes);
+			return;
+	}
+}
+function registerParams(params, scopes) {
+	for (const param of params) if (param.type === "TSParameterProperty") registerBinding(param.parameter, false, scopes);
+	else if (param.type === "RestElement") registerBinding(param.argument, false, scopes);
+	else registerBinding(param, false, scopes);
+}
+function isTranslationHook(name, scopes) {
+	for (let i = scopes.length - 1; i >= 0; i--) {
+		const scope = scopes[i];
+		if (!scope) continue;
+		if (scope.has(name)) return scope.get(name);
+	}
+	return false;
+}
+function analyzeCall(call, source, file, keys, scopes) {
+	const callee = unwrapExpression(call.callee);
+	if (callee.type !== "Identifier") return;
+	if (!isTranslationHook(callee.name, scopes)) return;
+	if (call.arguments.length === 0) fail(source, file, call, "translation call requires a static string argument");
+	const firstArg = call.arguments[0];
+	if (!firstArg || firstArg.type === "SpreadElement") fail(source, file, firstArg ?? call, "translation key must be a static string");
+	const texts = collectStaticStrings(firstArg, source, file);
+	let notes = [void 0];
+	if (call.arguments.length > 1) {
+		const secondArg = call.arguments[1];
+		if (!secondArg || secondArg.type === "SpreadElement") fail(source, file, secondArg ?? call, "translation options must be a static object");
+		notes = collectNotes(secondArg, source, file);
+	}
+	for (const text of texts) for (const note of notes) keys.add(encodeKey(text, note));
+}
+function analyzeSource(file, lang, source) {
+	const result = parseSync(file, source, {
+		lang,
+		sourceType: "module"
+	});
+	if (result.errors.length > 0) throw new StaticAnalysisError(result.errors.map((error) => error.message).join("\n"), file);
+	const keys = /* @__PURE__ */ new Set();
+	const scopes = [/* @__PURE__ */ new Map()];
+	const pushScope = () => {
+		scopes.push(/* @__PURE__ */ new Map());
+	};
+	const popScope = () => {
+		scopes.pop();
+	};
+	new Visitor({
+		BlockStatement: pushScope,
+		"BlockStatement:exit": popScope,
+		CatchClause: pushScope,
+		"CatchClause:exit": popScope,
+		FunctionDeclaration(node) {
+			pushScope();
+			registerParams(node.params, scopes);
+		},
+		"FunctionDeclaration:exit": popScope,
+		FunctionExpression(node) {
+			pushScope();
+			registerParams(node.params, scopes);
+		},
+		"FunctionExpression:exit": popScope,
+		ArrowFunctionExpression(node) {
+			pushScope();
+			registerParams(node.params, scopes);
+		},
+		"ArrowFunctionExpression:exit": popScope,
+		VariableDeclarator(decl) {
+			if (!decl.init) return;
+			const init = unwrapExpression(decl.init);
+			const isHook = init.type === "CallExpression" && isUseTranslationsCall(init);
+			registerBinding(decl.id, isHook, scopes);
+		},
+		CallExpression(call) {
+			analyzeCall(call, source, file, keys, scopes);
+		}
+	}).visit(result.program);
+	return [...keys];
+}
+function getLang(file) {
+	switch (path.extname(file)) {
+		case ".tsx": return "tsx";
+		case ".ts":
+		case ".cts":
+		case ".mts": return "ts";
+		case ".jsx": return "jsx";
+		case ".cjs":
+		case ".mjs":
+		case ".js": return "js";
+	}
+}
+async function compile(options) {
+	const files = await glob(options.input, { absolute: true });
+	const keys = /* @__PURE__ */ new Set();
+	for (const file of files) {
+		const lang = getLang(file);
+		if (!lang) continue;
+		const source = await fs.readFile(file, "utf8");
+		for (const key of analyzeSource(file, lang, source)) keys.add(key);
+	}
+	return { translationKeys: [...keys].sort() };
+}
+function typegen(output) {
+	if (output.translationKeys.length === 0) return "export type Translations = {};\n";
+	return `export type Translations = {\n${output.translationKeys.map((key) => `  ${JSON.stringify(key)}: string;`).join("\n")}\n};\n`;
+}
+//#endregion
+export { StaticAnalysisError, compile, typegen };
+
+//# sourceMappingURL=compiler.mjs.map

package/dist/compiler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.mjs","names":[],"sources":["../src/compiler.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type {\n  BindingPattern,\n  CallExpression,\n  Expression,\n  ObjectProperty,\n  ObjectPropertyKind,\n  ParamPattern,\n  Span,\n} from \"oxc-parser\";\nimport { parseSync, Visitor } from \"oxc-parser\";\nimport { glob } from \"tinyglobby\";\nimport { encodeKey } from \"./shared\";\n\ntype SupportedLang = \"js\" | \"jsx\" | \"ts\" | \"tsx\";\n\nexport interface CompileOptions {\n  /** glob patterns */\n  input: string[];\n}\n\nexport interface CompileOutput {\n  /** All encoded keys */\n  translationKeys: string[];\n}\n\nexport class StaticAnalysisError extends Error {\n  constructor(\n    message: string,\n    readonly file: string,\n    readonly span?: Span,\n  ) {\n    super(message);\n    this.name = \"StaticAnalysisError\";\n  }\n}\n\nfunction formatLocation(source: string, offset: number): string {\n  let line = 1;\n  let column = 1;\n\n  for (let i = 0; i < offset && i < source.length; i++) {\n    if (source[i] === \"\\n\") {\n      line++;\n      column = 1;\n    } else {\n      column++;\n    }\n  }\n\n  return `${line}:${column}`;\n}\n\nfunction isUseTranslationsCall(expr: Expression): boolean {\n  return (\n    expr.type === \"CallExpression\" &&\n    expr.callee.type === \"Identifier\" &&\n    expr.callee.name === \"useTranslations\" &&\n    expr.arguments.length === 0\n  );\n}\n\nfunction unwrapExpression(expr: Expression): Expression {\n  while (\n    expr.type === \"ParenthesizedExpression\" ||\n    expr.type === \"TSAsExpression\" ||\n    expr.type === \"TSSatisfiesExpression\" ||\n    expr.type === \"TSTypeAssertion\"\n  ) {\n    expr = expr.expression;\n  }\n  return expr;\n}\n\nfunction fail(source: string, file: string, span: Span, message: string): never {\n  throw new StaticAnalysisError(\n    `${file}:${formatLocation(source, span.start)}: ${message}`,\n    file,\n    span,\n  );\n}\n\nfunction collectStaticStrings(expr: Expression, source: string, file: string): string[] {\n  expr = unwrapExpression(expr);\n\n  if (expr.type === \"Literal\" && typeof expr.value === \"string\") {\n    return [expr.value];\n  }\n\n  if (expr.type === \"TemplateLiteral\") {\n    if (expr.expressions.length > 0) {\n      fail(source, file, expr, \"translation key must be a static string\");\n    }\n    return [expr.quasis.map((q) => q.value.cooked ?? q.value.raw).join(\"\")];\n  }\n\n  if (expr.type === \"ConditionalExpression\") {\n    return [\n      ...collectStaticStrings(expr.consequent, source, file),\n      ...collectStaticStrings(expr.alternate, source, file),\n    ];\n  }\n\n  fail(source, file, expr, \"translation key must be a static string\");\n}\n\nfunction getNoteProperty(properties: ObjectPropertyKind[]): ObjectProperty | undefined {\n  for (const prop of properties) {\n    if (prop.type !== \"Property\") continue;\n    if (prop.kind !== \"init\") continue;\n\n    if (prop.shorthand && prop.key.type === \"Identifier\") {\n      if (prop.key.name === \"note\") return prop;\n      continue;\n    }\n\n    if (prop.key.type === \"Identifier\" && prop.key.name === \"note\") {\n      return prop;\n    }\n\n    if (\n      prop.key.type === \"Literal\" &&\n      typeof prop.key.value === \"string\" &&\n      prop.key.value === \"note\"\n    ) {\n      return prop;\n    }\n  }\n  return undefined;\n}\n\nfunction collectNotes(\n  expr: Expression | undefined,\n  source: string,\n  file: string,\n): (string | undefined)[] {\n  if (!expr) return [undefined];\n\n  expr = unwrapExpression(expr);\n\n  if (expr.type === \"ConditionalExpression\") {\n    return [\n      ...collectNotes(expr.consequent, source, file),\n      ...collectNotes(expr.alternate, source, file),\n    ];\n  }\n\n  if (expr.type !== \"ObjectExpression\") {\n    fail(source, file, expr, \"translation options must be a static object\");\n  }\n\n  for (const prop of expr.properties) {\n    if (prop.type === \"SpreadElement\") {\n      fail(source, file, prop, \"translation options cannot use spread properties\");\n    }\n  }\n\n  const noteProp = getNoteProperty(expr.properties);\n  if (!noteProp) return [undefined];\n\n  if (noteProp.shorthand) {\n    fail(source, file, noteProp, \"translation note must be a static string\");\n  }\n\n  const noteValues = collectStaticStrings(noteProp.value, source, file);\n  return noteValues.map((note) => note);\n}\n\nfunction currentScope(scopes: Map<string, boolean>[]): Map<string, boolean> {\n  const scope = scopes.at(-1);\n  if (!scope) throw new Error(\"scope stack is empty\");\n  return scope;\n}\n\nfunction registerBinding(\n  pattern: BindingPattern,\n  isHook: boolean,\n  scopes: Map<string, boolean>[],\n): void {\n  switch (pattern.type) {\n    case \"Identifier\":\n      currentScope(scopes).set(pattern.name, isHook);\n      return;\n    case \"ObjectPattern\":\n      for (const prop of pattern.properties) {\n        if (prop.type === \"RestElement\") {\n          registerBinding(prop.argument, false, scopes);\n        } else {\n          registerBinding(prop.value, false, scopes);\n        }\n      }\n      return;\n    case \"ArrayPattern\":\n      for (const element of pattern.elements) {\n        if (!element) continue;\n        if (element.type === \"RestElement\") {\n          registerBinding(element.argument, false, scopes);\n        } else {\n          registerBinding(element, false, scopes);\n        }\n      }\n      return;\n    case \"AssignmentPattern\":\n      registerBinding(pattern.left, isHook, scopes);\n      return;\n  }\n}\n\nfunction registerParams(params: ParamPattern[], scopes: Map<string, boolean>[]): void {\n  for (const param of params) {\n    if (param.type === \"TSParameterProperty\") {\n      registerBinding(param.parameter, false, scopes);\n    } else if (param.type === \"RestElement\") {\n      registerBinding(param.argument, false, scopes);\n    } else {\n      registerBinding(param, false, scopes);\n    }\n  }\n}\n\nfunction isTranslationHook(name: string, scopes: Map<string, boolean>[]): boolean {\n  for (let i = scopes.length - 1; i >= 0; i--) {\n    const scope = scopes[i];\n    if (!scope) continue;\n    if (scope.has(name)) return scope.get(name)!;\n  }\n  return false;\n}\n\nfunction analyzeCall(\n  call: CallExpression,\n  source: string,\n  file: string,\n  keys: Set<string>,\n  scopes: Map<string, boolean>[],\n): void {\n  const callee = unwrapExpression(call.callee);\n  if (callee.type !== \"Identifier\") return;\n  if (!isTranslationHook(callee.name, scopes)) return;\n\n  if (call.arguments.length === 0) {\n    fail(source, file, call, \"translation call requires a static string argument\");\n  }\n\n  const firstArg = call.arguments[0];\n  if (!firstArg || firstArg.type === \"SpreadElement\") {\n    fail(source, file, firstArg ?? call, \"translation key must be a static string\");\n  }\n\n  const texts = collectStaticStrings(firstArg, source, file);\n\n  let notes: (string | undefined)[] = [undefined];\n  if (call.arguments.length > 1) {\n    const secondArg = call.arguments[1];\n    if (!secondArg || secondArg.type === \"SpreadElement\") {\n      fail(source, file, secondArg ?? call, \"translation options must be a static object\");\n    }\n    notes = collectNotes(secondArg, source, file);\n  }\n\n  for (const text of texts) {\n    for (const note of notes) {\n      keys.add(encodeKey(text, note));\n    }\n  }\n}\n\nfunction analyzeSource(file: string, lang: SupportedLang, source: string): string[] {\n  const result = parseSync(file, source, { lang, sourceType: \"module\" });\n\n  if (result.errors.length > 0) {\n    const message = result.errors.map((error) => error.message).join(\"\\n\");\n    throw new StaticAnalysisError(message, file);\n  }\n\n  const keys = new Set<string>();\n  const scopes: Map<string, boolean>[] = [new Map()];\n\n  const pushScope = () => {\n    scopes.push(new Map());\n  };\n\n  const popScope = () => {\n    scopes.pop();\n  };\n\n  const visitor = new Visitor({\n    BlockStatement: pushScope,\n    \"BlockStatement:exit\": popScope,\n\n    CatchClause: pushScope,\n    \"CatchClause:exit\": popScope,\n\n    FunctionDeclaration(node) {\n      pushScope();\n      registerParams(node.params, scopes);\n    },\n    \"FunctionDeclaration:exit\": popScope,\n\n    FunctionExpression(node) {\n      pushScope();\n      registerParams(node.params, scopes);\n    },\n    \"FunctionExpression:exit\": popScope,\n\n    ArrowFunctionExpression(node) {\n      pushScope();\n      registerParams(node.params, scopes);\n    },\n    \"ArrowFunctionExpression:exit\": popScope,\n\n    VariableDeclarator(decl) {\n      if (!decl.init) return;\n\n      const init = unwrapExpression(decl.init);\n      const isHook = init.type === \"CallExpression\" && isUseTranslationsCall(init);\n      registerBinding(decl.id, isHook, scopes);\n    },\n\n    CallExpression(call) {\n      analyzeCall(call, source, file, keys, scopes);\n    },\n  });\n\n  visitor.visit(result.program);\n  return [...keys];\n}\n\nfunction getLang(file: string): SupportedLang | undefined {\n  switch (path.extname(file)) {\n    case \".tsx\":\n      return \"tsx\";\n    case \".ts\":\n    case \".cts\":\n    case \".mts\":\n      return \"ts\";\n    case \".jsx\":\n      return \"jsx\";\n    case \".cjs\":\n    case \".mjs\":\n    case \".js\":\n      return \"js\";\n  }\n}\n\nexport async function compile(options: CompileOptions): Promise<CompileOutput> {\n  const files = await glob(options.input, { absolute: true });\n  const keys = new Set<string>();\n\n  for (const file of files) {\n    const lang = getLang(file);\n    if (!lang) continue;\n\n    const source = await fs.readFile(file, \"utf8\");\n    for (const key of analyzeSource(file, lang, source)) {\n      keys.add(key);\n    }\n  }\n\n  const translationKeys = [...keys].sort();\n  return { translationKeys };\n}\n\nexport function typegen(output: CompileOutput): string {\n  if (output.translationKeys.length === 0) {\n    return \"export type Translations = {};\\n\";\n  }\n\n  const entries = output.translationKeys\n    .map((key) => `  ${JSON.stringify(key)}: string;`)\n    .join(\"\\n\");\n\n  return `export type Translations = {\\n${entries}\\n};\\n`;\n}\n"],"mappings":"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"}

package/dist/react.d.mts

@@ -0,0 +1,27 @@
+import { ReactNode } from "react";
+
+//#region src/react.d.ts
+type Translations = Record<string, string>;
+/** add translations, you can stack multiple <TranslationProvider /> to override/extend translations */
+declare function TranslationProvider({
+  translations,
+  children
+}: {
+  translations: Translations;
+  children: ReactNode;
+}): import("react").JSX.Element;
+type GetVariables<T extends string> = T extends `${string}{${infer K}}${infer After}` ? K | GetVariables<After> : never;
+interface TranslationsHook {
+  <Text extends string>(text: Text, opts?: {
+    /**
+     * add more context to `text`.
+     * @example "The aria-label of close dialog button"
+     */
+    note?: string;
+    variables?: Record<GetVariables<Text>, string>;
+  }): string;
+}
+declare function useTranslations(): TranslationsHook;
+//#endregion
+export { TranslationProvider, TranslationsHook, useTranslations };
+//# 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":";;;KAIK,YAAA,GAAe,MAAM;;iBAKV,mBAAA;EACd,YAAA;EACA;AAAA;EAEA,YAAA,EAAc,YAAA;EACd,QAAA,EAAU,SAAA;AAAA,oBACX,GAAA,CAAA,OAAA;AAAA,KASI,YAAA,qBAAiC,CAAA,iDAClC,CAAA,GAAI,YAAA,CAAa,KAAA;AAAA,UAGJ,gBAAA;EAAA,sBAEb,IAAA,EAAM,IAAA,EACN,IAAA;IAtB+B;;;;IA2B7B,IAAA;IACA,SAAA,GAAY,MAAA,CAAO,YAAA,CAAa,IAAA;EAAA;AAAA;AAAA,iBAKtB,eAAA,IAAmB,gBAAgB"}

package/dist/react.mjs

@@ -0,0 +1,30 @@
+"use client";
+import { t as encodeKey } from "./shared-CAhaQI7c.mjs";
+import { createContext, use, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/react.tsx
+const Context = createContext({});
+/** add translations, you can stack multiple <TranslationProvider /> to override/extend translations */
+function TranslationProvider({ translations, children }) {
+	const parent = use(Context);
+	return /* @__PURE__ */ jsx(Context, {
+		value: useMemo(() => ({
+			...parent,
+			...translations
+		}), [parent, translations]),
+		children
+	});
+}
+function useTranslations() {
+	const translations = use(Context);
+	return (rawText, opts = {}) => {
+		const { note, variables } = opts;
+		let text = translations[encodeKey(rawText, note)] ?? rawText;
+		if (variables) for (const k in variables) text = text.replaceAll(k, variables[k]);
+		return text;
+	};
+}
+//#endregion
+export { TranslationProvider, useTranslations };
+
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/react.tsx"],"sourcesContent":["\"use client\";\nimport { createContext, use, useMemo, type ReactNode } from \"react\";\nimport { encodeKey } from \"./shared\";\n\ntype Translations = Record<string, string>;\n\nconst Context = createContext<Translations>({});\n\n/** add translations, you can stack multiple <TranslationProvider /> to override/extend translations */\nexport function TranslationProvider({\n  translations,\n  children,\n}: {\n  translations: Translations;\n  children: ReactNode;\n}) {\n  const parent = use(Context);\n  return (\n    <Context value={useMemo(() => ({ ...parent, ...translations }), [parent, translations])}>\n      {children}\n    </Context>\n  );\n}\n\ntype GetVariables<T extends string> = T extends `${string}{${infer K}}${infer After}`\n  ? K | GetVariables<After>\n  : never;\n\nexport interface TranslationsHook {\n  <Text extends string>(\n    text: Text,\n    opts?: {\n      /**\n       * add more context to `text`.\n       * @example \"The aria-label of close dialog button\"\n       */\n      note?: string;\n      variables?: Record<GetVariables<Text>, string>;\n    },\n  ): string;\n}\n\nexport function useTranslations(): TranslationsHook {\n  const translations = use(Context);\n\n  return (rawText, opts = {}) => {\n    const { note, variables } = opts;\n    const k = encodeKey(rawText, note);\n    let text = translations[k] ?? rawText;\n\n    if (variables) {\n      for (const k in variables) text = text.replaceAll(k, variables[k as never]);\n    }\n\n    return text;\n  };\n}\n"],"mappings":";;;;;AAMA,MAAM,UAAU,cAA4B,CAAC,CAAC;;AAG9C,SAAgB,oBAAoB,EAClC,cACA,YAIC;CACD,MAAM,SAAS,IAAI,OAAO;CAC1B,OACE,oBAAC,SAAD;EAAS,OAAO,eAAe;GAAE,GAAG;GAAQ,GAAG;EAAa,IAAI,CAAC,QAAQ,YAAY,CAAC;EACnF;CACM,CAAA;AAEb;AAoBA,SAAgB,kBAAoC;CAClD,MAAM,eAAe,IAAI,OAAO;CAEhC,QAAQ,SAAS,OAAO,CAAC,MAAM;EAC7B,MAAM,EAAE,MAAM,cAAc;EAE5B,IAAI,OAAO,aADD,UAAU,SAAS,IACL,MAAM;EAE9B,IAAI,WACF,KAAK,MAAM,KAAK,WAAW,OAAO,KAAK,WAAW,GAAG,UAAU,EAAW;EAG5E,OAAO;CACT;AACF"}

package/dist/shared-CAhaQI7c.mjs

@@ -0,0 +1,8 @@
+//#region src/shared.ts
+function encodeKey(text, note) {
+	return note ? `${text}(${note})` : text;
+}
+//#endregion
+export { encodeKey as t };
+
+//# sourceMappingURL=shared-CAhaQI7c.mjs.map

package/dist/shared-CAhaQI7c.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-CAhaQI7c.mjs","names":[],"sources":["../src/shared.ts"],"sourcesContent":["export function encodeKey(text: string, note?: string): string {\n  return note ? `${text}(${note})` : text;\n}\n"],"mappings":";AAAA,SAAgB,UAAU,MAAc,MAAuB;CAC7D,OAAO,OAAO,GAAG,KAAK,GAAG,KAAK,KAAK;AACrC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "fuma-translate",
+  "version": "0.0.0",
+  "description": "The build-time package to implement multilingual in your JavaScript app",
+  "license": "MIT",
+  "author": "Fuma Nama",
+  "repository": "github:fuma-nama/fuma-translate",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./compiler": "./dist/compiler.mjs",
+    "./react": "./dist/react.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "oxc-parser": "^0.134.0",
+    "tinyglobby": "^0.2.17"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "tsdown": "^0.22.2",
+    "typescript": "6.0.3",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@types/react": "*",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "types:check": "tsc --noEmit",
+    "build": "tsdown",
+    "dev": "tsdown --watch"
+  }
+}