@better-intl/compiler 0.1.0

package/dist/index.cjs

@@ -0,0 +1,374 @@
+'use strict';
+
+var parser = require('@babel/parser');
+var _traverse = require('@babel/traverse');
+var core = require('@better-intl/core');
+var _generate = require('@babel/generator');
+var t = require('@babel/types');
+var path = require('path');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var _traverse__default = /*#__PURE__*/_interopDefault(_traverse);
+var _generate__default = /*#__PURE__*/_interopDefault(_generate);
+var t__namespace = /*#__PURE__*/_interopNamespace(t);
+
+// src/catalog-generator.ts
+function generateDefaultCatalog(messages) {
+  const catalog = {};
+  for (const msg of messages) {
+    catalog[msg.id] = msg.defaultMessage;
+  }
+  return { locale: "en", messages: catalog };
+}
+function mergeCatalog(existing, extracted) {
+  const newIds = new Set(extracted.map((m) => m.id));
+  const existingIds = new Set(Object.keys(existing));
+  const added = [];
+  const removed = [];
+  const unchanged = [];
+  const messages = {};
+  for (const msg of extracted) {
+    if (existingIds.has(msg.id)) {
+      messages[msg.id] = existing[msg.id];
+      unchanged.push(msg.id);
+    } else {
+      messages[msg.id] = msg.defaultMessage;
+      added.push(msg.id);
+    }
+  }
+  for (const id of existingIds) {
+    if (!newIds.has(id)) {
+      removed.push(id);
+    }
+  }
+  return { messages, added, removed, unchanged };
+}
+function findMissingKeys(defaultCatalog, targetCatalog) {
+  return Object.keys(defaultCatalog).filter((id) => !(id in targetCatalog));
+}
+function findDeadKeys(catalog, extracted) {
+  const extractedIds = new Set(extracted.map((m) => m.id));
+  return Object.keys(catalog).filter((id) => !extractedIds.has(id));
+}
+var traverse = typeof _traverse__default.default === "function" ? _traverse__default.default : _traverse__default.default.default;
+var IGNORED_ELEMENTS = /* @__PURE__ */ new Set(["script", "style", "code", "pre", "Helmet"]);
+var IGNORED_FILE_PATTERNS = [
+  /\.test\.[tj]sx?$/,
+  /\.spec\.[tj]sx?$/,
+  /\.stories\.[tj]sx?$/,
+  /\/__tests__\//
+];
+function extract(source, options) {
+  const { filePath, mode = "auto" } = options;
+  if (IGNORED_FILE_PATTERNS.some((p) => p.test(filePath))) {
+    return [];
+  }
+  const ast = parser.parse(source, {
+    sourceType: "module",
+    plugins: ["jsx", "typescript"]
+  });
+  const ctx = {
+    componentName: void 0,
+    messages: [],
+    ignoredLines: collectIgnoreComments(source),
+    filePath,
+    mode
+  };
+  traverse(ast, {
+    // Track component name for context
+    FunctionDeclaration(path) {
+      if (path.node.id) {
+        ctx.componentName = path.node.id.name;
+      }
+    },
+    VariableDeclarator(path) {
+      if (path.node.id.type === "Identifier" && (path.node.init?.type === "ArrowFunctionExpression" || path.node.init?.type === "FunctionExpression")) {
+        ctx.componentName = path.node.id.name;
+      }
+    },
+    // Extract text from JSX
+    JSXText(path) {
+      const text = path.node.value.trim();
+      if (!text) return;
+      const line = path.node.loc?.start.line ?? 0;
+      if (ctx.ignoredLines.has(line) || ctx.ignoredLines.has(line - 1)) return;
+      const parentElement = findParentElement(path);
+      if (!parentElement) return;
+      const elementName = getElementName(parentElement);
+      if (IGNORED_ELEMENTS.has(elementName)) return;
+      if (ctx.mode === "explicit") {
+        const hasI18nProp = hasAttribute(parentElement, "i18n");
+        if (elementName !== "T" && !hasI18nProp) return;
+      }
+      addMessage(ctx, text, elementName, path.node.loc);
+    },
+    // Also handle string literals in JSX expressions like {"Hello"}
+    JSXExpressionContainer(path) {
+      const expr = path.node.expression;
+      if (expr.type !== "StringLiteral") return;
+      const text = expr.value.trim();
+      if (!text) return;
+      const line = expr.loc?.start.line ?? 0;
+      if (ctx.ignoredLines.has(line) || ctx.ignoredLines.has(line - 1)) return;
+      const parentElement = findParentElement(path);
+      if (!parentElement) return;
+      const elementName = getElementName(parentElement);
+      if (IGNORED_ELEMENTS.has(elementName)) return;
+      if (ctx.mode === "explicit") {
+        const hasI18nProp = hasAttribute(parentElement, "i18n");
+        if (elementName !== "T" && !hasI18nProp) return;
+      }
+      addMessage(ctx, text, elementName, expr.loc);
+    }
+  });
+  return ctx.messages;
+}
+function addMessage(ctx, text, elementType, loc) {
+  const id = core.generateId({
+    text,
+    filePath: ctx.filePath,
+    context: ctx.componentName
+  });
+  if (ctx.messages.some((m) => m.id === id)) return;
+  ctx.messages.push({
+    id,
+    defaultMessage: text,
+    description: `${ctx.filePath}:${elementType}`,
+    filePath: ctx.filePath,
+    componentName: ctx.componentName,
+    elementType,
+    line: loc?.start.line ?? 0,
+    column: loc?.start.column ?? 0
+  });
+}
+function findParentElement(path) {
+  let current = path.parentPath;
+  while (current) {
+    if (current.isJSXElement()) {
+      return current.node.openingElement;
+    }
+    current = current.parentPath;
+  }
+  return null;
+}
+function getElementName(opening) {
+  if (opening.name.type === "JSXIdentifier") {
+    return opening.name.name;
+  }
+  if (opening.name.type === "JSXMemberExpression") {
+    return `${getMemberName(opening.name)}`;
+  }
+  return "unknown";
+}
+function getMemberName(node) {
+  const object = node.object.type === "JSXIdentifier" ? node.object.name : getMemberName(node.object);
+  return `${object}.${node.property.name}`;
+}
+function hasAttribute(opening, name) {
+  return opening.attributes.some(
+    (attr) => attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier" && attr.name.name === name
+  );
+}
+function collectIgnoreComments(source) {
+  const ignored = /* @__PURE__ */ new Set();
+  const lines = source.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].includes("i18n-ignore")) {
+      ignored.add(i + 1);
+    }
+  }
+  return ignored;
+}
+var traverse2 = typeof _traverse__default.default === "function" ? _traverse__default.default : _traverse__default.default.default;
+var generate = typeof _generate__default.default === "function" ? _generate__default.default : _generate__default.default.default;
+var IGNORED_ELEMENTS2 = /* @__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 = parser.parse(source, {
+    sourceType: "module",
+    plugins: ["jsx", "typescript"]
+  });
+  let hasTranslations = false;
+  let componentName;
+  let needsImport = false;
+  const functionsNeedingHook = /* @__PURE__ */ new Set();
+  traverse2(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_ELEMENTS2.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 = core.generateId({ text, filePath, context: componentName });
+      hasTranslations = true;
+      if (locale && messages?.[id]) {
+        const newNode = t__namespace.jsxText(messages[id]);
+        path.replaceWith(newNode);
+        path.skip();
+      } else {
+        needsImport = true;
+        path.replaceWith(
+          t__namespace.jsxExpressionContainer(
+            t__namespace.callExpression(t__namespace.identifier(tFunctionName), [
+              t__namespace.stringLiteral(id),
+              t__namespace.identifier("undefined"),
+              t__namespace.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__namespace.variableDeclaration("const", [
+        t__namespace.variableDeclarator(
+          t__namespace.objectPattern([
+            t__namespace.objectProperty(
+              t__namespace.identifier("t"),
+              t__namespace.identifier(tFunctionName),
+              false,
+              false
+            )
+          ]),
+          t__namespace.callExpression(t__namespace.identifier("useTranslation"), [])
+        )
+      ]);
+      const body = path.node.body;
+      if (t__namespace.isBlockStatement(body)) {
+        body.body.unshift(hookCall);
+      } else {
+        path.node.body = t__namespace.blockStatement([hookCall, t__namespace.returnStatement(body)]);
+      }
+    };
+    traverse2(ast, {
+      FunctionDeclaration(path) {
+        injectHook2(path);
+      },
+      FunctionExpression(path) {
+        injectHook2(path);
+      },
+      ArrowFunctionExpression(path) {
+        injectHook2(path);
+      }
+    });
+    const hasImport = ast.program.body.some(
+      (node) => t__namespace.isImportDeclaration(node) && node.source.value === runtimeImport && node.specifiers.some(
+        (s) => t__namespace.isImportSpecifier(s) && t__namespace.isIdentifier(s.imported) && s.imported.name === "useTranslation"
+      )
+    );
+    if (!hasImport) {
+      const importDecl = t__namespace.importDeclaration(
+        [
+          t__namespace.importSpecifier(
+            t__namespace.identifier("useTranslation"),
+            t__namespace.identifier("useTranslation")
+          )
+        ],
+        t__namespace.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;
+}
+function betterIntlLoader(source) {
+  const options = this.getOptions?.() ?? {};
+  const absolutePath = this.resourcePath;
+  const filePath = path.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;
+  }
+}
+
+exports.extract = extract;
+exports.findDeadKeys = findDeadKeys;
+exports.findMissingKeys = findMissingKeys;
+exports.generateDefaultCatalog = generateDefaultCatalog;
+exports.mergeCatalog = mergeCatalog;
+exports.transform = transform;
+exports.webpackLoader = betterIntlLoader;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog-generator.ts","../src/extractor.ts","../src/transformer.ts","../src/webpack-loader.ts"],"names":["_traverse","parse","generateId","traverse","_generate","IGNORED_ELEMENTS","t","injectHook","relative"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Catalog generator — writes extracted messages to locale JSON files.\n */\n\nimport type { ExtractedMessage, Messages } from \"@better-intl/core\";\n\nexport interface CatalogFile {\n  locale: string;\n  messages: Messages;\n}\n\n/**\n * Generate a catalog for the default locale from extracted messages.\n */\nexport function generateDefaultCatalog(\n  messages: ExtractedMessage[],\n): CatalogFile {\n  const catalog: Messages = {};\n  for (const msg of messages) {\n    catalog[msg.id] = msg.defaultMessage;\n  }\n  return { locale: \"en\", messages: catalog };\n}\n\n/**\n * Merge new messages into an existing catalog, preserving existing translations.\n * Returns the merged catalog and lists of added/removed keys.\n */\nexport function mergeCatalog(\n  existing: Messages,\n  extracted: ExtractedMessage[],\n): {\n  messages: Messages;\n  added: string[];\n  removed: string[];\n  unchanged: string[];\n} {\n  const newIds = new Set(extracted.map((m) => m.id));\n  const existingIds = new Set(Object.keys(existing));\n\n  const added: string[] = [];\n  const removed: string[] = [];\n  const unchanged: string[] = [];\n  const messages: Messages = {};\n\n  // Keep existing translations, mark new ones\n  for (const msg of extracted) {\n    if (existingIds.has(msg.id)) {\n      messages[msg.id] = existing[msg.id];\n      unchanged.push(msg.id);\n    } else {\n      messages[msg.id] = msg.defaultMessage;\n      added.push(msg.id);\n    }\n  }\n\n  // Track removed keys\n  for (const id of existingIds) {\n    if (!newIds.has(id)) {\n      removed.push(id);\n    }\n  }\n\n  return { messages, added, removed, unchanged };\n}\n\n/**\n * Find missing translations (keys present in default but not in target locale).\n */\nexport function findMissingKeys(\n  defaultCatalog: Messages,\n  targetCatalog: Messages,\n): string[] {\n  return Object.keys(defaultCatalog).filter((id) => !(id in targetCatalog));\n}\n\n/**\n * Find dead keys (keys in catalog but not in extracted messages).\n */\nexport function findDeadKeys(\n  catalog: Messages,\n  extracted: ExtractedMessage[],\n): string[] {\n  const extractedIds = new Set(extracted.map((m) => m.id));\n  return Object.keys(catalog).filter((id) => !extractedIds.has(id));\n}\n","/**\n * AST-based extractor for JSX text nodes.\n *\n * Walks the Babel AST to find translatable text, respecting ignore rules,\n * and emits `ExtractedMessage` descriptors with stable IDs.\n */\n\nimport { parse } from \"@babel/parser\";\nimport type { NodePath } from \"@babel/traverse\";\nimport _traverse from \"@babel/traverse\";\nimport type * as t from \"@babel/types\";\nimport type { ExtractedMessage } from \"@better-intl/core\";\nimport { generateId } from \"@better-intl/core\";\n\n// Handle CJS/ESM interop for @babel/traverse\nconst traverse =\n  typeof _traverse === \"function\"\n    ? _traverse\n    : (_traverse as { default: typeof _traverse }).default;\n\n/** Elements whose text content should never be extracted. */\nconst IGNORED_ELEMENTS = new Set([\"script\", \"style\", \"code\", \"pre\", \"Helmet\"]);\n\n/** File patterns that should be skipped entirely. */\nconst IGNORED_FILE_PATTERNS = [\n  /\\.test\\.[tj]sx?$/,\n  /\\.spec\\.[tj]sx?$/,\n  /\\.stories\\.[tj]sx?$/,\n  /\\/__tests__\\//,\n];\n\nexport interface ExtractorOptions {\n  filePath: string;\n  /** Extraction mode: \"auto\" extracts all text, \"explicit\" only <T> and i18n prop */\n  mode?: \"auto\" | \"explicit\";\n}\n\ninterface ExtractionContext {\n  componentName: string | undefined;\n  messages: ExtractedMessage[];\n  ignoredLines: Set<number>;\n  filePath: string;\n  mode: \"auto\" | \"explicit\";\n}\n\n/**\n * Extract translatable messages from a source file.\n */\nexport function extract(\n  source: string,\n  options: ExtractorOptions,\n): ExtractedMessage[] {\n  const { filePath, mode = \"auto\" } = options;\n\n  // Skip ignored file patterns\n  if (IGNORED_FILE_PATTERNS.some((p) => p.test(filePath))) {\n    return [];\n  }\n\n  const ast = parse(source, {\n    sourceType: \"module\",\n    plugins: [\"jsx\", \"typescript\"],\n  });\n\n  const ctx: ExtractionContext = {\n    componentName: undefined,\n    messages: [],\n    ignoredLines: collectIgnoreComments(source),\n    filePath,\n    mode,\n  };\n\n  traverse(ast, {\n    // Track component name for context\n    FunctionDeclaration(path: NodePath<t.FunctionDeclaration>) {\n      if (path.node.id) {\n        ctx.componentName = path.node.id.name;\n      }\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        ctx.componentName = path.node.id.name;\n      }\n    },\n\n    // Extract text from JSX\n    JSXText(path: NodePath<t.JSXText>) {\n      const text = path.node.value.trim();\n      if (!text) return;\n\n      const line = path.node.loc?.start.line ?? 0;\n      if (ctx.ignoredLines.has(line) || ctx.ignoredLines.has(line - 1)) return;\n\n      const parentElement = findParentElement(path);\n      if (!parentElement) return;\n\n      const elementName = getElementName(parentElement);\n      if (IGNORED_ELEMENTS.has(elementName)) return;\n\n      // In explicit mode, only extract from <T> or elements with i18n prop\n      if (ctx.mode === \"explicit\") {\n        const hasI18nProp = hasAttribute(parentElement, \"i18n\");\n        if (elementName !== \"T\" && !hasI18nProp) return;\n      }\n\n      addMessage(ctx, text, elementName, path.node.loc);\n    },\n\n    // Also handle string literals in JSX expressions like {\"Hello\"}\n    JSXExpressionContainer(path: NodePath<t.JSXExpressionContainer>) {\n      const expr = path.node.expression;\n      if (expr.type !== \"StringLiteral\") return;\n\n      const text = expr.value.trim();\n      if (!text) return;\n\n      const line = expr.loc?.start.line ?? 0;\n      if (ctx.ignoredLines.has(line) || ctx.ignoredLines.has(line - 1)) return;\n\n      const parentElement = findParentElement(path);\n      if (!parentElement) return;\n\n      const elementName = getElementName(parentElement);\n      if (IGNORED_ELEMENTS.has(elementName)) return;\n\n      if (ctx.mode === \"explicit\") {\n        const hasI18nProp = hasAttribute(parentElement, \"i18n\");\n        if (elementName !== \"T\" && !hasI18nProp) return;\n      }\n\n      addMessage(ctx, text, elementName, expr.loc);\n    },\n  });\n\n  return ctx.messages;\n}\n\nfunction addMessage(\n  ctx: ExtractionContext,\n  text: string,\n  elementType: string,\n  loc: t.SourceLocation | null | undefined,\n): void {\n  const id = generateId({\n    text,\n    filePath: ctx.filePath,\n    context: ctx.componentName,\n  });\n\n  // Avoid duplicate IDs within the same file\n  if (ctx.messages.some((m) => m.id === id)) return;\n\n  ctx.messages.push({\n    id,\n    defaultMessage: text,\n    description: `${ctx.filePath}:${elementType}`,\n    filePath: ctx.filePath,\n    componentName: ctx.componentName,\n    elementType,\n    line: loc?.start.line ?? 0,\n    column: loc?.start.column ?? 0,\n  });\n}\n\nfunction findParentElement(path: NodePath): t.JSXOpeningElement | null {\n  let current = path.parentPath;\n  while (current) {\n    if (current.isJSXElement()) {\n      return current.node.openingElement;\n    }\n    current = current.parentPath;\n  }\n  return null;\n}\n\nfunction getElementName(opening: t.JSXOpeningElement): string {\n  if (opening.name.type === \"JSXIdentifier\") {\n    return opening.name.name;\n  }\n  if (opening.name.type === \"JSXMemberExpression\") {\n    return `${getMemberName(opening.name)}`;\n  }\n  return \"unknown\";\n}\n\nfunction getMemberName(node: t.JSXMemberExpression): string {\n  const object =\n    node.object.type === \"JSXIdentifier\"\n      ? node.object.name\n      : getMemberName(node.object);\n  return `${object}.${node.property.name}`;\n}\n\nfunction hasAttribute(opening: t.JSXOpeningElement, name: string): boolean {\n  return opening.attributes.some(\n    (attr) =>\n      attr.type === \"JSXAttribute\" &&\n      attr.name.type === \"JSXIdentifier\" &&\n      attr.name.name === name,\n  );\n}\n\n/**\n * Collect line numbers that have `i18n-ignore` comments.\n */\nfunction collectIgnoreComments(source: string): Set<number> {\n  const ignored = new Set<number>();\n  const lines = source.split(\"\\n\");\n  for (let i = 0; i < lines.length; i++) {\n    if (lines[i].includes(\"i18n-ignore\")) {\n      ignored.add(i + 1); // 1-indexed\n    }\n  }\n  return ignored;\n}\n","/**\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"]}

package/dist/index.d.cts

@@ -0,0 +1,82 @@
+import { Messages, ExtractedMessage } from '@better-intl/core';
+import _generate from '@babel/generator';
+export { BetterIntlLoaderOptions, default as webpackLoader } from './webpack-loader.cjs';
+
+/**
+ * Catalog generator — writes extracted messages to locale JSON files.
+ */
+
+interface CatalogFile {
+    locale: string;
+    messages: Messages;
+}
+/**
+ * Generate a catalog for the default locale from extracted messages.
+ */
+declare function generateDefaultCatalog(messages: ExtractedMessage[]): CatalogFile;
+/**
+ * Merge new messages into an existing catalog, preserving existing translations.
+ * Returns the merged catalog and lists of added/removed keys.
+ */
+declare function mergeCatalog(existing: Messages, extracted: ExtractedMessage[]): {
+    messages: Messages;
+    added: string[];
+    removed: string[];
+    unchanged: string[];
+};
+/**
+ * Find missing translations (keys present in default but not in target locale).
+ */
+declare function findMissingKeys(defaultCatalog: Messages, targetCatalog: Messages): string[];
+/**
+ * Find dead keys (keys in catalog but not in extracted messages).
+ */
+declare function findDeadKeys(catalog: Messages, extracted: ExtractedMessage[]): string[];
+
+/**
+ * AST-based extractor for JSX text nodes.
+ *
+ * Walks the Babel AST to find translatable text, respecting ignore rules,
+ * and emits `ExtractedMessage` descriptors with stable IDs.
+ */
+
+interface ExtractorOptions {
+    filePath: string;
+    /** Extraction mode: "auto" extracts all text, "explicit" only <T> and i18n prop */
+    mode?: "auto" | "explicit";
+}
+/**
+ * Extract translatable messages from a source file.
+ */
+declare function extract(source: string, options: ExtractorOptions): ExtractedMessage[];
+
+/**
+ * Babel AST transformer.
+ *
+ * Replaces static JSX text with `__t("id")` calls,
+ * or with static text when the locale is known at build time.
+ *
+ * For runtime mode, injects `const { t: __t } = useTranslation();`
+ * at the top of each component function that has translatable text.
+ */
+
+declare const generate: typeof _generate;
+interface TransformOptions {
+    filePath: string;
+    /** When set, inline the translated text directly (zero-runtime). */
+    locale?: string;
+    messages?: Messages;
+    /** The identifier for the `t` function (default: `__t`) */
+    tFunctionName?: string;
+    /** Import path for the runtime (default: `@better-intl/react`) */
+    runtimeImport?: string;
+    mode?: "auto" | "explicit";
+}
+interface TransformResult {
+    code: string;
+    map: ReturnType<typeof generate>["map"];
+    hasTranslations: boolean;
+}
+declare function transform(source: string, options: TransformOptions): TransformResult;
+
+export { type CatalogFile, type ExtractorOptions, type TransformOptions, type TransformResult, extract, findDeadKeys, findMissingKeys, generateDefaultCatalog, mergeCatalog, transform };

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+import { Messages, ExtractedMessage } from '@better-intl/core';
+import _generate from '@babel/generator';
+export { BetterIntlLoaderOptions, default as webpackLoader } from './webpack-loader.js';
+
+/**
+ * Catalog generator — writes extracted messages to locale JSON files.
+ */
+
+interface CatalogFile {
+    locale: string;
+    messages: Messages;
+}
+/**
+ * Generate a catalog for the default locale from extracted messages.
+ */
+declare function generateDefaultCatalog(messages: ExtractedMessage[]): CatalogFile;
+/**
+ * Merge new messages into an existing catalog, preserving existing translations.
+ * Returns the merged catalog and lists of added/removed keys.
+ */
+declare function mergeCatalog(existing: Messages, extracted: ExtractedMessage[]): {
+    messages: Messages;
+    added: string[];
+    removed: string[];
+    unchanged: string[];
+};
+/**
+ * Find missing translations (keys present in default but not in target locale).
+ */
+declare function findMissingKeys(defaultCatalog: Messages, targetCatalog: Messages): string[];
+/**
+ * Find dead keys (keys in catalog but not in extracted messages).
+ */
+declare function findDeadKeys(catalog: Messages, extracted: ExtractedMessage[]): string[];
+
+/**
+ * AST-based extractor for JSX text nodes.
+ *
+ * Walks the Babel AST to find translatable text, respecting ignore rules,
+ * and emits `ExtractedMessage` descriptors with stable IDs.
+ */
+
+interface ExtractorOptions {
+    filePath: string;
+    /** Extraction mode: "auto" extracts all text, "explicit" only <T> and i18n prop */
+    mode?: "auto" | "explicit";
+}
+/**
+ * Extract translatable messages from a source file.
+ */
+declare function extract(source: string, options: ExtractorOptions): ExtractedMessage[];
+
+/**
+ * Babel AST transformer.
+ *
+ * Replaces static JSX text with `__t("id")` calls,
+ * or with static text when the locale is known at build time.
+ *
+ * For runtime mode, injects `const { t: __t } = useTranslation();`
+ * at the top of each component function that has translatable text.
+ */
+
+declare const generate: typeof _generate;
+interface TransformOptions {
+    filePath: string;
+    /** When set, inline the translated text directly (zero-runtime). */
+    locale?: string;
+    messages?: Messages;
+    /** The identifier for the `t` function (default: `__t`) */
+    tFunctionName?: string;
+    /** Import path for the runtime (default: `@better-intl/react`) */
+    runtimeImport?: string;
+    mode?: "auto" | "explicit";
+}
+interface TransformResult {
+    code: string;
+    map: ReturnType<typeof generate>["map"];
+    hasTranslations: boolean;
+}
+declare function transform(source: string, options: TransformOptions): TransformResult;
+
+export { type CatalogFile, type ExtractorOptions, type TransformOptions, type TransformResult, extract, findDeadKeys, findMissingKeys, generateDefaultCatalog, mergeCatalog, transform };