@better-intl/compiler 0.1.0

package/dist/babel.cjs

@@ -0,0 +1,138 @@
+'use strict';
+
+var path = require('path');
+var core = require('@better-intl/core');
+
+// src/babel.ts
+var IGNORED_ELEMENTS = /* @__PURE__ */ new Set(["script", "style", "code", "pre", "Helmet"]);
+function betterIntlBabelPlugin({
+  types
+}) {
+  return {
+    name: "better-intl",
+    visitor: {
+      Program: {
+        enter(_path, state) {
+          state.functionsNeedingHook = /* @__PURE__ */ new Set();
+        },
+        exit(path, state) {
+          if (!state.needsImport) return;
+          const tName = state.opts.tFunctionName ?? "__t";
+          const importSource = state.opts.runtimeImport ?? "@better-intl/react";
+          path.traverse({
+            FunctionDeclaration(fnPath) {
+              if (!state.functionsNeedingHook?.has(fnPath.node)) return;
+              injectHook(types, fnPath, tName);
+            },
+            FunctionExpression(fnPath) {
+              if (!state.functionsNeedingHook?.has(fnPath.node)) return;
+              injectHook(types, fnPath, tName);
+            },
+            ArrowFunctionExpression(fnPath) {
+              if (!state.functionsNeedingHook?.has(fnPath.node)) return;
+              injectHook(types, fnPath, tName);
+            }
+          });
+          const hasImport = path.node.body.some(
+            (node) => types.isImportDeclaration(node) && node.source.value === importSource && node.specifiers.some(
+              (specifier) => types.isImportSpecifier(specifier) && types.isIdentifier(specifier.local) && specifier.local.name === "useTranslation"
+            )
+          );
+          if (!hasImport) {
+            const importDecl = types.importDeclaration(
+              [
+                types.importSpecifier(
+                  types.identifier("useTranslation"),
+                  types.identifier("useTranslation")
+                )
+              ],
+              types.stringLiteral(importSource)
+            );
+            path.unshiftContainer("body", importDecl);
+          }
+        }
+      },
+      FunctionDeclaration(path, state) {
+        if (path.node.id) state.componentName = path.node.id.name;
+      },
+      VariableDeclarator(path, state) {
+        if (types.isIdentifier(path.node.id) && (types.isArrowFunctionExpression(path.node.init) || types.isFunctionExpression(path.node.init))) {
+          state.componentName = path.node.id.name;
+        }
+      },
+      JSXText(path$1, state) {
+        const text = path$1.node.value.trim();
+        if (!text) return;
+        const parent = path$1.parentPath;
+        if (!parent?.isJSXElement()) return;
+        const opening = parent.node.openingElement;
+        const elementName = types.isJSXIdentifier(opening.name) ? opening.name.name : "unknown";
+        if (IGNORED_ELEMENTS.has(elementName)) return;
+        const mode = state.opts.mode ?? "auto";
+        if (mode === "explicit") {
+          const hasI18n = opening.attributes.some(
+            (a) => types.isJSXAttribute(a) && types.isJSXIdentifier(a.name) && a.name.name === "i18n"
+          );
+          if (elementName !== "T" && !hasI18n) return;
+        }
+        const absolutePath = state.filename ?? "unknown";
+        const filePath = absolutePath !== "unknown" ? path.relative(process.cwd(), absolutePath) : absolutePath;
+        const id = core.generateId({
+          text,
+          filePath,
+          context: state.componentName
+        });
+        const { locale, messages, tFunctionName = "__t" } = state.opts;
+        if (locale && messages?.[id]) {
+          path$1.replaceWith(types.jsxText(messages[id]));
+          path$1.skip();
+        } else {
+          state.needsImport = true;
+          path$1.replaceWith(
+            types.jsxExpressionContainer(
+              types.callExpression(types.identifier(tFunctionName), [
+                types.stringLiteral(id),
+                types.identifier("undefined"),
+                types.stringLiteral(text)
+              ])
+            )
+          );
+          const fnPath = path$1.findParent(
+            (parent2) => parent2.isFunctionDeclaration() || parent2.isFunctionExpression() || parent2.isArrowFunctionExpression()
+          );
+          if (fnPath) {
+            state.functionsNeedingHook?.add(fnPath.node);
+          }
+        }
+      }
+    }
+  };
+}
+function injectHook(types, path, tName) {
+  const hookCall = types.variableDeclaration("const", [
+    types.variableDeclarator(
+      types.objectPattern([
+        types.objectProperty(
+          types.identifier("t"),
+          types.identifier(tName),
+          false,
+          false
+        )
+      ]),
+      types.callExpression(types.identifier("useTranslation"), [])
+    )
+  ]);
+  const body = path.node.body;
+  if (types.isBlockStatement(body)) {
+    body.body.unshift(hookCall);
+  } else {
+    path.node.body = types.blockStatement([
+      hookCall,
+      types.returnStatement(body)
+    ]);
+  }
+}
+
+module.exports = betterIntlBabelPlugin;
+//# sourceMappingURL=babel.cjs.map
+//# sourceMappingURL=babel.cjs.map

package/dist/babel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/babel.ts"],"names":["path","relative","generateId","parent"],"mappings":"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","file":"babel.cjs","sourcesContent":["/**\n * Babel plugin for better-intl.\n *\n * Usage in babel config:\n *   plugins: [[\"@better-intl/compiler/babel\", { mode: \"auto\" }]]\n *\n * Transforms `<h1>Hello world</h1>` into:\n *   const { t: __t } = useTranslation();\n *   <h1>{__t(\"id\", undefined, \"Hello world\")}</h1>\n */\n\nimport { relative } from \"node:path\";\nimport type { PluginObj, PluginPass } from \"@babel/core\";\nimport type * as BabelTypes from \"@babel/types\";\nimport type { Messages } from \"@better-intl/core\";\nimport { generateId } from \"@better-intl/core\";\n\nconst IGNORED_ELEMENTS = new Set([\"script\", \"style\", \"code\", \"pre\", \"Helmet\"]);\n\ninterface BetterIntlPluginOptions {\n  locale?: string;\n  messages?: Messages;\n  tFunctionName?: string;\n  runtimeImport?: string;\n  mode?: \"auto\" | \"explicit\";\n}\n\ninterface BetterIntlState extends PluginPass {\n  opts: BetterIntlPluginOptions;\n  componentName?: string;\n  needsImport?: boolean;\n  functionsNeedingHook?: Set<BabelTypes.Node>;\n}\n\nexport default function betterIntlBabelPlugin({\n  types,\n}: {\n  types: typeof BabelTypes;\n}): PluginObj<BetterIntlState> {\n  return {\n    name: \"better-intl\",\n\n    visitor: {\n      Program: {\n        enter(_path, state) {\n          state.functionsNeedingHook = new Set();\n        },\n        exit(path, state) {\n          if (!state.needsImport) return;\n\n          const tName = state.opts.tFunctionName ?? \"__t\";\n          const importSource = state.opts.runtimeImport ?? \"@better-intl/react\";\n\n          // Inject useTranslation hook into functions that need it\n          path.traverse({\n            FunctionDeclaration(fnPath) {\n              if (!state.functionsNeedingHook?.has(fnPath.node)) return;\n              injectHook(types, fnPath, tName);\n            },\n            FunctionExpression(fnPath) {\n              if (!state.functionsNeedingHook?.has(fnPath.node)) return;\n              injectHook(types, fnPath, tName);\n            },\n            ArrowFunctionExpression(fnPath) {\n              if (!state.functionsNeedingHook?.has(fnPath.node)) return;\n              injectHook(types, fnPath, tName);\n            },\n          });\n\n          // Add import { useTranslation } from \"@better-intl/react\" (if not already present)\n          const hasImport = path.node.body.some(\n            (node) =>\n              types.isImportDeclaration(node) &&\n              node.source.value === importSource &&\n              node.specifiers.some(\n                (specifier) =>\n                  types.isImportSpecifier(specifier) &&\n                  types.isIdentifier(specifier.local) &&\n                  specifier.local.name === \"useTranslation\",\n              ),\n          );\n\n          if (!hasImport) {\n            const importDecl = types.importDeclaration(\n              [\n                types.importSpecifier(\n                  types.identifier(\"useTranslation\"),\n                  types.identifier(\"useTranslation\"),\n                ),\n              ],\n              types.stringLiteral(importSource),\n            );\n            path.unshiftContainer(\"body\", importDecl);\n          }\n        },\n      },\n\n      FunctionDeclaration(path, state) {\n        if (path.node.id) state.componentName = path.node.id.name;\n      },\n\n      VariableDeclarator(path, state) {\n        if (\n          types.isIdentifier(path.node.id) &&\n          (types.isArrowFunctionExpression(path.node.init) ||\n            types.isFunctionExpression(path.node.init))\n        ) {\n          state.componentName = path.node.id.name;\n        }\n      },\n\n      JSXText(path, state) {\n        const text = path.node.value.trim();\n        if (!text) return;\n\n        const parent = path.parentPath;\n        if (!parent?.isJSXElement()) return;\n\n        const opening = (parent.node as BabelTypes.JSXElement).openingElement;\n        const elementName = types.isJSXIdentifier(opening.name)\n          ? opening.name.name\n          : \"unknown\";\n\n        if (IGNORED_ELEMENTS.has(elementName)) return;\n\n        const mode = state.opts.mode ?? \"auto\";\n        if (mode === \"explicit\") {\n          const hasI18n = opening.attributes.some(\n            (a: BabelTypes.JSXAttribute | BabelTypes.JSXSpreadAttribute) =>\n              types.isJSXAttribute(a) &&\n              types.isJSXIdentifier(a.name) &&\n              a.name.name === \"i18n\",\n          );\n          if (elementName !== \"T\" && !hasI18n) return;\n        }\n\n        // Use relative path for stable IDs\n        const absolutePath = state.filename ?? \"unknown\";\n        const filePath =\n          absolutePath !== \"unknown\"\n            ? relative(process.cwd(), absolutePath)\n            : absolutePath;\n\n        const id = generateId({\n          text,\n          filePath,\n          context: state.componentName,\n        });\n\n        const { locale, messages, tFunctionName = \"__t\" } = state.opts;\n\n        if (locale && messages?.[id]) {\n          path.replaceWith(types.jsxText(messages[id]));\n          path.skip();\n        } else {\n          state.needsImport = true;\n          path.replaceWith(\n            types.jsxExpressionContainer(\n              types.callExpression(types.identifier(tFunctionName), [\n                types.stringLiteral(id),\n                types.identifier(\"undefined\"),\n                types.stringLiteral(text),\n              ]),\n            ),\n          );\n\n          // Mark enclosing function\n          const fnPath = path.findParent(\n            (parent) =>\n              parent.isFunctionDeclaration() ||\n              parent.isFunctionExpression() ||\n              parent.isArrowFunctionExpression(),\n          );\n          if (fnPath) {\n            state.functionsNeedingHook?.add(fnPath.node);\n          }\n        }\n      },\n    },\n  };\n}\n\nfunction injectHook(\n  types: typeof BabelTypes,\n  path: { node: { body: BabelTypes.BlockStatement | BabelTypes.Expression } },\n  tName: string,\n) {\n  const hookCall = types.variableDeclaration(\"const\", [\n    types.variableDeclarator(\n      types.objectPattern([\n        types.objectProperty(\n          types.identifier(\"t\"),\n          types.identifier(tName),\n          false,\n          false,\n        ),\n      ]),\n      types.callExpression(types.identifier(\"useTranslation\"), []),\n    ),\n  ]);\n\n  const body = path.node.body;\n  if (types.isBlockStatement(body)) {\n    body.body.unshift(hookCall);\n  } else {\n    // Arrow with expression body\n    path.node.body = types.blockStatement([\n      hookCall,\n      types.returnStatement(body),\n    ]);\n  }\n}\n"]}

package/dist/babel.d.cts

@@ -0,0 +1,33 @@
+import { PluginObj, PluginPass } from '@babel/core';
+import * as BabelTypes from '@babel/types';
+import { Messages } from '@better-intl/core';
+
+/**
+ * Babel plugin for better-intl.
+ *
+ * Usage in babel config:
+ *   plugins: [["@better-intl/compiler/babel", { mode: "auto" }]]
+ *
+ * Transforms `<h1>Hello world</h1>` into:
+ *   const { t: __t } = useTranslation();
+ *   <h1>{__t("id", undefined, "Hello world")}</h1>
+ */
+
+interface BetterIntlPluginOptions {
+    locale?: string;
+    messages?: Messages;
+    tFunctionName?: string;
+    runtimeImport?: string;
+    mode?: "auto" | "explicit";
+}
+interface BetterIntlState extends PluginPass {
+    opts: BetterIntlPluginOptions;
+    componentName?: string;
+    needsImport?: boolean;
+    functionsNeedingHook?: Set<BabelTypes.Node>;
+}
+declare function betterIntlBabelPlugin({ types, }: {
+    types: typeof BabelTypes;
+}): PluginObj<BetterIntlState>;
+
+export { betterIntlBabelPlugin as default };

package/dist/babel.d.ts

@@ -0,0 +1,33 @@
+import { PluginObj, PluginPass } from '@babel/core';
+import * as BabelTypes from '@babel/types';
+import { Messages } from '@better-intl/core';
+
+/**
+ * Babel plugin for better-intl.
+ *
+ * Usage in babel config:
+ *   plugins: [["@better-intl/compiler/babel", { mode: "auto" }]]
+ *
+ * Transforms `<h1>Hello world</h1>` into:
+ *   const { t: __t } = useTranslation();
+ *   <h1>{__t("id", undefined, "Hello world")}</h1>
+ */
+
+interface BetterIntlPluginOptions {
+    locale?: string;
+    messages?: Messages;
+    tFunctionName?: string;
+    runtimeImport?: string;
+    mode?: "auto" | "explicit";
+}
+interface BetterIntlState extends PluginPass {
+    opts: BetterIntlPluginOptions;
+    componentName?: string;
+    needsImport?: boolean;
+    functionsNeedingHook?: Set<BabelTypes.Node>;
+}
+declare function betterIntlBabelPlugin({ types, }: {
+    types: typeof BabelTypes;
+}): PluginObj<BetterIntlState>;
+
+export { betterIntlBabelPlugin as default };

package/dist/babel.js

@@ -0,0 +1,136 @@
+import { relative } from 'path';
+import { generateId } from '@better-intl/core';
+
+// src/babel.ts
+var IGNORED_ELEMENTS = /* @__PURE__ */ new Set(["script", "style", "code", "pre", "Helmet"]);
+function betterIntlBabelPlugin({
+  types
+}) {
+  return {
+    name: "better-intl",
+    visitor: {
+      Program: {
+        enter(_path, state) {
+          state.functionsNeedingHook = /* @__PURE__ */ new Set();
+        },
+        exit(path, state) {
+          if (!state.needsImport) return;
+          const tName = state.opts.tFunctionName ?? "__t";
+          const importSource = state.opts.runtimeImport ?? "@better-intl/react";
+          path.traverse({
+            FunctionDeclaration(fnPath) {
+              if (!state.functionsNeedingHook?.has(fnPath.node)) return;
+              injectHook(types, fnPath, tName);
+            },
+            FunctionExpression(fnPath) {
+              if (!state.functionsNeedingHook?.has(fnPath.node)) return;
+              injectHook(types, fnPath, tName);
+            },
+            ArrowFunctionExpression(fnPath) {
+              if (!state.functionsNeedingHook?.has(fnPath.node)) return;
+              injectHook(types, fnPath, tName);
+            }
+          });
+          const hasImport = path.node.body.some(
+            (node) => types.isImportDeclaration(node) && node.source.value === importSource && node.specifiers.some(
+              (specifier) => types.isImportSpecifier(specifier) && types.isIdentifier(specifier.local) && specifier.local.name === "useTranslation"
+            )
+          );
+          if (!hasImport) {
+            const importDecl = types.importDeclaration(
+              [
+                types.importSpecifier(
+                  types.identifier("useTranslation"),
+                  types.identifier("useTranslation")
+                )
+              ],
+              types.stringLiteral(importSource)
+            );
+            path.unshiftContainer("body", importDecl);
+          }
+        }
+      },
+      FunctionDeclaration(path, state) {
+        if (path.node.id) state.componentName = path.node.id.name;
+      },
+      VariableDeclarator(path, state) {
+        if (types.isIdentifier(path.node.id) && (types.isArrowFunctionExpression(path.node.init) || types.isFunctionExpression(path.node.init))) {
+          state.componentName = path.node.id.name;
+        }
+      },
+      JSXText(path, state) {
+        const text = path.node.value.trim();
+        if (!text) return;
+        const parent = path.parentPath;
+        if (!parent?.isJSXElement()) return;
+        const opening = parent.node.openingElement;
+        const elementName = types.isJSXIdentifier(opening.name) ? opening.name.name : "unknown";
+        if (IGNORED_ELEMENTS.has(elementName)) return;
+        const mode = state.opts.mode ?? "auto";
+        if (mode === "explicit") {
+          const hasI18n = opening.attributes.some(
+            (a) => types.isJSXAttribute(a) && types.isJSXIdentifier(a.name) && a.name.name === "i18n"
+          );
+          if (elementName !== "T" && !hasI18n) return;
+        }
+        const absolutePath = state.filename ?? "unknown";
+        const filePath = absolutePath !== "unknown" ? relative(process.cwd(), absolutePath) : absolutePath;
+        const id = generateId({
+          text,
+          filePath,
+          context: state.componentName
+        });
+        const { locale, messages, tFunctionName = "__t" } = state.opts;
+        if (locale && messages?.[id]) {
+          path.replaceWith(types.jsxText(messages[id]));
+          path.skip();
+        } else {
+          state.needsImport = true;
+          path.replaceWith(
+            types.jsxExpressionContainer(
+              types.callExpression(types.identifier(tFunctionName), [
+                types.stringLiteral(id),
+                types.identifier("undefined"),
+                types.stringLiteral(text)
+              ])
+            )
+          );
+          const fnPath = path.findParent(
+            (parent2) => parent2.isFunctionDeclaration() || parent2.isFunctionExpression() || parent2.isArrowFunctionExpression()
+          );
+          if (fnPath) {
+            state.functionsNeedingHook?.add(fnPath.node);
+          }
+        }
+      }
+    }
+  };
+}
+function injectHook(types, path, tName) {
+  const hookCall = types.variableDeclaration("const", [
+    types.variableDeclarator(
+      types.objectPattern([
+        types.objectProperty(
+          types.identifier("t"),
+          types.identifier(tName),
+          false,
+          false
+        )
+      ]),
+      types.callExpression(types.identifier("useTranslation"), [])
+    )
+  ]);
+  const body = path.node.body;
+  if (types.isBlockStatement(body)) {
+    body.body.unshift(hookCall);
+  } else {
+    path.node.body = types.blockStatement([
+      hookCall,
+      types.returnStatement(body)
+    ]);
+  }
+}
+
+export { betterIntlBabelPlugin as default };
+//# sourceMappingURL=babel.js.map
+//# sourceMappingURL=babel.js.map

package/dist/babel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/babel.ts"],"names":["parent"],"mappings":"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","file":"babel.js","sourcesContent":["/**\n * Babel plugin for better-intl.\n *\n * Usage in babel config:\n *   plugins: [[\"@better-intl/compiler/babel\", { mode: \"auto\" }]]\n *\n * Transforms `<h1>Hello world</h1>` into:\n *   const { t: __t } = useTranslation();\n *   <h1>{__t(\"id\", undefined, \"Hello world\")}</h1>\n */\n\nimport { relative } from \"node:path\";\nimport type { PluginObj, PluginPass } from \"@babel/core\";\nimport type * as BabelTypes from \"@babel/types\";\nimport type { Messages } from \"@better-intl/core\";\nimport { generateId } from \"@better-intl/core\";\n\nconst IGNORED_ELEMENTS = new Set([\"script\", \"style\", \"code\", \"pre\", \"Helmet\"]);\n\ninterface BetterIntlPluginOptions {\n  locale?: string;\n  messages?: Messages;\n  tFunctionName?: string;\n  runtimeImport?: string;\n  mode?: \"auto\" | \"explicit\";\n}\n\ninterface BetterIntlState extends PluginPass {\n  opts: BetterIntlPluginOptions;\n  componentName?: string;\n  needsImport?: boolean;\n  functionsNeedingHook?: Set<BabelTypes.Node>;\n}\n\nexport default function betterIntlBabelPlugin({\n  types,\n}: {\n  types: typeof BabelTypes;\n}): PluginObj<BetterIntlState> {\n  return {\n    name: \"better-intl\",\n\n    visitor: {\n      Program: {\n        enter(_path, state) {\n          state.functionsNeedingHook = new Set();\n        },\n        exit(path, state) {\n          if (!state.needsImport) return;\n\n          const tName = state.opts.tFunctionName ?? \"__t\";\n          const importSource = state.opts.runtimeImport ?? \"@better-intl/react\";\n\n          // Inject useTranslation hook into functions that need it\n          path.traverse({\n            FunctionDeclaration(fnPath) {\n              if (!state.functionsNeedingHook?.has(fnPath.node)) return;\n              injectHook(types, fnPath, tName);\n            },\n            FunctionExpression(fnPath) {\n              if (!state.functionsNeedingHook?.has(fnPath.node)) return;\n              injectHook(types, fnPath, tName);\n            },\n            ArrowFunctionExpression(fnPath) {\n              if (!state.functionsNeedingHook?.has(fnPath.node)) return;\n              injectHook(types, fnPath, tName);\n            },\n          });\n\n          // Add import { useTranslation } from \"@better-intl/react\" (if not already present)\n          const hasImport = path.node.body.some(\n            (node) =>\n              types.isImportDeclaration(node) &&\n              node.source.value === importSource &&\n              node.specifiers.some(\n                (specifier) =>\n                  types.isImportSpecifier(specifier) &&\n                  types.isIdentifier(specifier.local) &&\n                  specifier.local.name === \"useTranslation\",\n              ),\n          );\n\n          if (!hasImport) {\n            const importDecl = types.importDeclaration(\n              [\n                types.importSpecifier(\n                  types.identifier(\"useTranslation\"),\n                  types.identifier(\"useTranslation\"),\n                ),\n              ],\n              types.stringLiteral(importSource),\n            );\n            path.unshiftContainer(\"body\", importDecl);\n          }\n        },\n      },\n\n      FunctionDeclaration(path, state) {\n        if (path.node.id) state.componentName = path.node.id.name;\n      },\n\n      VariableDeclarator(path, state) {\n        if (\n          types.isIdentifier(path.node.id) &&\n          (types.isArrowFunctionExpression(path.node.init) ||\n            types.isFunctionExpression(path.node.init))\n        ) {\n          state.componentName = path.node.id.name;\n        }\n      },\n\n      JSXText(path, state) {\n        const text = path.node.value.trim();\n        if (!text) return;\n\n        const parent = path.parentPath;\n        if (!parent?.isJSXElement()) return;\n\n        const opening = (parent.node as BabelTypes.JSXElement).openingElement;\n        const elementName = types.isJSXIdentifier(opening.name)\n          ? opening.name.name\n          : \"unknown\";\n\n        if (IGNORED_ELEMENTS.has(elementName)) return;\n\n        const mode = state.opts.mode ?? \"auto\";\n        if (mode === \"explicit\") {\n          const hasI18n = opening.attributes.some(\n            (a: BabelTypes.JSXAttribute | BabelTypes.JSXSpreadAttribute) =>\n              types.isJSXAttribute(a) &&\n              types.isJSXIdentifier(a.name) &&\n              a.name.name === \"i18n\",\n          );\n          if (elementName !== \"T\" && !hasI18n) return;\n        }\n\n        // Use relative path for stable IDs\n        const absolutePath = state.filename ?? \"unknown\";\n        const filePath =\n          absolutePath !== \"unknown\"\n            ? relative(process.cwd(), absolutePath)\n            : absolutePath;\n\n        const id = generateId({\n          text,\n          filePath,\n          context: state.componentName,\n        });\n\n        const { locale, messages, tFunctionName = \"__t\" } = state.opts;\n\n        if (locale && messages?.[id]) {\n          path.replaceWith(types.jsxText(messages[id]));\n          path.skip();\n        } else {\n          state.needsImport = true;\n          path.replaceWith(\n            types.jsxExpressionContainer(\n              types.callExpression(types.identifier(tFunctionName), [\n                types.stringLiteral(id),\n                types.identifier(\"undefined\"),\n                types.stringLiteral(text),\n              ]),\n            ),\n          );\n\n          // Mark enclosing function\n          const fnPath = path.findParent(\n            (parent) =>\n              parent.isFunctionDeclaration() ||\n              parent.isFunctionExpression() ||\n              parent.isArrowFunctionExpression(),\n          );\n          if (fnPath) {\n            state.functionsNeedingHook?.add(fnPath.node);\n          }\n        }\n      },\n    },\n  };\n}\n\nfunction injectHook(\n  types: typeof BabelTypes,\n  path: { node: { body: BabelTypes.BlockStatement | BabelTypes.Expression } },\n  tName: string,\n) {\n  const hookCall = types.variableDeclaration(\"const\", [\n    types.variableDeclarator(\n      types.objectPattern([\n        types.objectProperty(\n          types.identifier(\"t\"),\n          types.identifier(tName),\n          false,\n          false,\n        ),\n      ]),\n      types.callExpression(types.identifier(\"useTranslation\"), []),\n    ),\n  ]);\n\n  const body = path.node.body;\n  if (types.isBlockStatement(body)) {\n    body.body.unshift(hookCall);\n  } else {\n    // Arrow with expression body\n    path.node.body = types.blockStatement([\n      hookCall,\n      types.returnStatement(body),\n    ]);\n  }\n}\n"]}

package/dist/chunk-RKXQPVVG.js

@@ -0,0 +1,178 @@
+import { relative } from 'path';
+import _generate from '@babel/generator';
+import { parse } from '@babel/parser';
+import _traverse from '@babel/traverse';
+import * as t from '@babel/types';
+import { generateId } from '@better-intl/core';
+
+// src/webpack-loader.ts
+var traverse = typeof _traverse === "function" ? _traverse : _traverse.default;
+var generate = typeof _generate === "function" ? _generate : _generate.default;
+var IGNORED_ELEMENTS = /* @__PURE__ */ new Set(["script", "style", "code", "pre", "Helmet"]);
+function transform(source, options) {
+  const {
+    filePath,
+    locale,
+    messages,
+    tFunctionName = "__t",
+    runtimeImport = "@better-intl/react",
+    mode = "auto"
+  } = options;
+  const ast = parse(source, {
+    sourceType: "module",
+    plugins: ["jsx", "typescript"]
+  });
+  let hasTranslations = false;
+  let componentName;
+  let needsImport = false;
+  const functionsNeedingHook = /* @__PURE__ */ new Set();
+  traverse(ast, {
+    FunctionDeclaration(path) {
+      if (path.node.id) componentName = path.node.id.name;
+    },
+    VariableDeclarator(path) {
+      if (path.node.id.type === "Identifier" && (path.node.init?.type === "ArrowFunctionExpression" || path.node.init?.type === "FunctionExpression")) {
+        componentName = path.node.id.name;
+      }
+    },
+    JSXText(path) {
+      const text = path.node.value.trim();
+      if (!text) return;
+      const parent = path.parentPath;
+      if (!parent?.isJSXElement()) return;
+      const elementName = getJSXName(parent.node.openingElement);
+      if (IGNORED_ELEMENTS.has(elementName)) return;
+      const line = path.node.loc?.start.line ?? 0;
+      if (hasIgnoreComment(source, line)) return;
+      if (mode === "explicit") {
+        const hasI18n = parent.node.openingElement.attributes.some(
+          (a) => a.type === "JSXAttribute" && a.name.type === "JSXIdentifier" && a.name.name === "i18n"
+        );
+        if (elementName !== "T" && !hasI18n) return;
+      }
+      const id = generateId({ text, filePath, context: componentName });
+      hasTranslations = true;
+      if (locale && messages?.[id]) {
+        const newNode = t.jsxText(messages[id]);
+        path.replaceWith(newNode);
+        path.skip();
+      } else {
+        needsImport = true;
+        path.replaceWith(
+          t.jsxExpressionContainer(
+            t.callExpression(t.identifier(tFunctionName), [
+              t.stringLiteral(id),
+              t.identifier("undefined"),
+              t.stringLiteral(text)
+            ])
+          )
+        );
+        const fnPath = path.findParent(
+          (p) => p.isFunctionDeclaration() || p.isFunctionExpression() || p.isArrowFunctionExpression()
+        );
+        if (fnPath) {
+          functionsNeedingHook.add(fnPath.node);
+        }
+      }
+    }
+  });
+  if (needsImport) {
+    let injectHook2 = function(path) {
+      if (!functionsNeedingHook.has(path.node)) return;
+      const hookCall = t.variableDeclaration("const", [
+        t.variableDeclarator(
+          t.objectPattern([
+            t.objectProperty(
+              t.identifier("t"),
+              t.identifier(tFunctionName),
+              false,
+              false
+            )
+          ]),
+          t.callExpression(t.identifier("useTranslation"), [])
+        )
+      ]);
+      const body = path.node.body;
+      if (t.isBlockStatement(body)) {
+        body.body.unshift(hookCall);
+      } else {
+        path.node.body = t.blockStatement([hookCall, t.returnStatement(body)]);
+      }
+    };
+    traverse(ast, {
+      FunctionDeclaration(path) {
+        injectHook2(path);
+      },
+      FunctionExpression(path) {
+        injectHook2(path);
+      },
+      ArrowFunctionExpression(path) {
+        injectHook2(path);
+      }
+    });
+    const hasImport = ast.program.body.some(
+      (node) => t.isImportDeclaration(node) && node.source.value === runtimeImport && node.specifiers.some(
+        (s) => t.isImportSpecifier(s) && t.isIdentifier(s.imported) && s.imported.name === "useTranslation"
+      )
+    );
+    if (!hasImport) {
+      const importDecl = t.importDeclaration(
+        [
+          t.importSpecifier(
+            t.identifier("useTranslation"),
+            t.identifier("useTranslation")
+          )
+        ],
+        t.stringLiteral(runtimeImport)
+      );
+      ast.program.body.unshift(importDecl);
+    }
+  }
+  const output = generate(ast, { sourceMaps: true, sourceFileName: filePath });
+  return {
+    code: output.code,
+    map: output.map,
+    hasTranslations
+  };
+}
+function getJSXName(opening) {
+  if (opening.name.type === "JSXIdentifier") return opening.name.name;
+  return "unknown";
+}
+function hasIgnoreComment(source, line) {
+  const lines = source.split("\n");
+  const prevLine = lines[line - 2];
+  return prevLine ? prevLine.includes("i18n-ignore") : false;
+}
+
+// src/webpack-loader.ts
+function betterIntlLoader(source) {
+  const options = this.getOptions?.() ?? {};
+  const absolutePath = this.resourcePath;
+  const filePath = relative(this.rootContext || process.cwd(), absolutePath);
+  if (absolutePath.includes("node_modules")) return source;
+  if (!/\.[jt]sx$/.test(filePath)) return source;
+  if (/\.(test|spec|stories)\.[jt]sx?$/.test(filePath)) return source;
+  try {
+    const result = transform(source, {
+      filePath,
+      locale: options.locale,
+      messages: options.messages,
+      mode: options.mode ?? "auto"
+    });
+    if (result.hasTranslations) {
+      console.log(
+        `[better-intl] Transformed ${filePath} (${result.hasTranslations})`
+      );
+      return result.code;
+    }
+    return source;
+  } catch (err) {
+    console.error(`[better-intl] Error transforming ${filePath}:`, err);
+    return source;
+  }
+}
+
+export { betterIntlLoader, transform };
+//# sourceMappingURL=chunk-RKXQPVVG.js.map
+//# sourceMappingURL=chunk-RKXQPVVG.js.map

package/dist/chunk-RKXQPVVG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transformer.ts","../src/webpack-loader.ts"],"names":["injectHook"],"mappings":"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","file":"chunk-RKXQPVVG.js","sourcesContent":["/**\n * Babel AST transformer.\n *\n * Replaces static JSX text with `__t(\"id\")` calls,\n * or with static text when the locale is known at build time.\n *\n * For runtime mode, injects `const { t: __t } = useTranslation();`\n * at the top of each component function that has translatable text.\n */\n\nimport _generate from \"@babel/generator\";\nimport { parse } from \"@babel/parser\";\nimport type { NodePath } from \"@babel/traverse\";\nimport _traverse from \"@babel/traverse\";\nimport * as t from \"@babel/types\";\nimport type { Messages } from \"@better-intl/core\";\nimport { generateId } from \"@better-intl/core\";\n\nconst traverse =\n  typeof _traverse === \"function\"\n    ? _traverse\n    : (_traverse as { default: typeof _traverse }).default;\n\nconst generate =\n  typeof _generate === \"function\"\n    ? _generate\n    : (_generate as { default: typeof _generate }).default;\n\nconst IGNORED_ELEMENTS = new Set([\"script\", \"style\", \"code\", \"pre\", \"Helmet\"]);\n\nexport interface TransformOptions {\n  filePath: string;\n  /** When set, inline the translated text directly (zero-runtime). */\n  locale?: string;\n  messages?: Messages;\n  /** The identifier for the `t` function (default: `__t`) */\n  tFunctionName?: string;\n  /** Import path for the runtime (default: `@better-intl/react`) */\n  runtimeImport?: string;\n  mode?: \"auto\" | \"explicit\";\n}\n\nexport interface TransformResult {\n  code: string;\n  map: ReturnType<typeof generate>[\"map\"];\n  hasTranslations: boolean;\n}\n\nexport function transform(\n  source: string,\n  options: TransformOptions,\n): TransformResult {\n  const {\n    filePath,\n    locale,\n    messages,\n    tFunctionName = \"__t\",\n    runtimeImport = \"@better-intl/react\",\n    mode = \"auto\",\n  } = options;\n\n  const ast = parse(source, {\n    sourceType: \"module\",\n    plugins: [\"jsx\", \"typescript\"],\n  });\n\n  let hasTranslations = false;\n  let componentName: string | undefined;\n  let needsImport = false;\n\n  // Track which function bodies need the hook injection\n  const functionsNeedingHook = new Set<t.Node>();\n\n  traverse(ast, {\n    FunctionDeclaration(path: NodePath<t.FunctionDeclaration>) {\n      if (path.node.id) componentName = path.node.id.name;\n    },\n\n    VariableDeclarator(path: NodePath<t.VariableDeclarator>) {\n      if (\n        path.node.id.type === \"Identifier\" &&\n        (path.node.init?.type === \"ArrowFunctionExpression\" ||\n          path.node.init?.type === \"FunctionExpression\")\n      ) {\n        componentName = path.node.id.name;\n      }\n    },\n\n    JSXText(path: NodePath<t.JSXText>) {\n      const text = path.node.value.trim();\n      if (!text) return;\n\n      const parent = path.parentPath;\n      if (!parent?.isJSXElement()) return;\n\n      const elementName = getJSXName(parent.node.openingElement);\n      if (IGNORED_ELEMENTS.has(elementName)) return;\n\n      // Check ignore comment\n      const line = path.node.loc?.start.line ?? 0;\n      if (hasIgnoreComment(source, line)) return;\n\n      // In explicit mode, only transform <T> and i18n prop elements\n      if (mode === \"explicit\") {\n        const hasI18n = parent.node.openingElement.attributes.some(\n          (a) =>\n            a.type === \"JSXAttribute\" &&\n            a.name.type === \"JSXIdentifier\" &&\n            a.name.name === \"i18n\",\n        );\n        if (elementName !== \"T\" && !hasI18n) return;\n      }\n\n      const id = generateId({ text, filePath, context: componentName });\n      hasTranslations = true;\n\n      if (locale && messages?.[id]) {\n        // Zero-runtime: inline the translated text\n        const newNode = t.jsxText(messages[id]);\n        path.replaceWith(newNode);\n        path.skip();\n      } else {\n        // Runtime: replace with __t() call\n        needsImport = true;\n        path.replaceWith(\n          t.jsxExpressionContainer(\n            t.callExpression(t.identifier(tFunctionName), [\n              t.stringLiteral(id),\n              t.identifier(\"undefined\"),\n              t.stringLiteral(text),\n            ]),\n          ),\n        );\n\n        // Mark the enclosing function as needing the hook\n        const fnPath = path.findParent(\n          (p) =>\n            p.isFunctionDeclaration() ||\n            p.isFunctionExpression() ||\n            p.isArrowFunctionExpression(),\n        );\n        if (fnPath) {\n          functionsNeedingHook.add(fnPath.node);\n        }\n      }\n    },\n  });\n\n  // Inject `const { t: __t } = useTranslation();` at the top of each component\n  if (needsImport) {\n    traverse(ast, {\n      FunctionDeclaration(path: NodePath<t.FunctionDeclaration>) {\n        injectHook(path);\n      },\n      FunctionExpression(path: NodePath<t.FunctionExpression>) {\n        injectHook(path);\n      },\n      ArrowFunctionExpression(path: NodePath<t.ArrowFunctionExpression>) {\n        injectHook(path);\n      },\n    });\n\n    function injectHook(\n      path: NodePath<\n        t.FunctionDeclaration | t.FunctionExpression | t.ArrowFunctionExpression\n      >,\n    ) {\n      if (!functionsNeedingHook.has(path.node)) return;\n\n      const hookCall = t.variableDeclaration(\"const\", [\n        t.variableDeclarator(\n          t.objectPattern([\n            t.objectProperty(\n              t.identifier(\"t\"),\n              t.identifier(tFunctionName),\n              false,\n              false,\n            ),\n          ]),\n          t.callExpression(t.identifier(\"useTranslation\"), []),\n        ),\n      ]);\n\n      const body = path.node.body;\n      if (t.isBlockStatement(body)) {\n        body.body.unshift(hookCall);\n      } else {\n        // Arrow function with expression body: convert to block\n        path.node.body = t.blockStatement([hookCall, t.returnStatement(body)]);\n      }\n    }\n\n    // Add import for useTranslation (if not already present)\n    const hasImport = ast.program.body.some(\n      (node) =>\n        t.isImportDeclaration(node) &&\n        node.source.value === runtimeImport &&\n        node.specifiers.some(\n          (s) =>\n            t.isImportSpecifier(s) &&\n            t.isIdentifier(s.imported) &&\n            s.imported.name === \"useTranslation\",\n        ),\n    );\n\n    if (!hasImport) {\n      const importDecl = t.importDeclaration(\n        [\n          t.importSpecifier(\n            t.identifier(\"useTranslation\"),\n            t.identifier(\"useTranslation\"),\n          ),\n        ],\n        t.stringLiteral(runtimeImport),\n      );\n      (ast.program.body as t.Statement[]).unshift(importDecl);\n    }\n  }\n\n  const output = generate(ast, { sourceMaps: true, sourceFileName: filePath });\n\n  return {\n    code: output.code,\n    map: output.map,\n    hasTranslations,\n  };\n}\n\nfunction getJSXName(opening: t.JSXOpeningElement): string {\n  if (opening.name.type === \"JSXIdentifier\") return opening.name.name;\n  return \"unknown\";\n}\n\nfunction hasIgnoreComment(source: string, line: number): boolean {\n  const lines = source.split(\"\\n\");\n  const prevLine = lines[line - 2]; // line is 1-indexed, check line above\n  return prevLine ? prevLine.includes(\"i18n-ignore\") : false;\n}\n","/**\n * Webpack loader for better-intl.\n *\n * Transforms JSX text nodes into t() calls automatically during build.\n * Used by Next.js integration to enable zero-config i18n.\n */\n\nimport { relative } from \"node:path\";\nimport { transform } from \"./transformer.js\";\n\nexport interface BetterIntlLoaderOptions {\n  locale?: string;\n  messages?: Record<string, string>;\n  mode?: \"auto\" | \"explicit\";\n}\n\n// biome-ignore lint/suspicious/noExplicitAny: webpack loader context type\nexport default function betterIntlLoader(this: any, source: string): string {\n  const options: BetterIntlLoaderOptions = this.getOptions?.() ?? {};\n  const absolutePath = this.resourcePath;\n  const filePath = relative(this.rootContext || process.cwd(), absolutePath);\n\n  // Skip node_modules and non-JSX files\n  if (absolutePath.includes(\"node_modules\")) return source;\n  if (!/\\.[jt]sx$/.test(filePath)) return source;\n\n  // Skip test/spec/stories files\n  if (/\\.(test|spec|stories)\\.[jt]sx?$/.test(filePath)) return source;\n\n  try {\n    const result = transform(source, {\n      filePath,\n      locale: options.locale,\n      messages: options.messages,\n      mode: options.mode ?? \"auto\",\n    });\n\n    if (result.hasTranslations) {\n      console.log(\n        `[better-intl] Transformed ${filePath} (${result.hasTranslations})`,\n      );\n      return result.code;\n    }\n\n    return source;\n  } catch (err) {\n    console.error(`[better-intl] Error transforming ${filePath}:`, err);\n    return source;\n  }\n}\n"]}