// 开发者的代码
<div>{I18N.app.title}</div>

// ⬇️ Babel 编译后自动注入 data-i18n-key
<div data-i18n-key="app.title">{String(I18N.app.title)}</div>

// 开发环境：I18N.app.title 返回带标记的 React 元素
I18N.app.title;
// → <span data-i18n-key="app.title">应用标题</span>

// 生产环境：直接返回字符串
I18N.app.title;
// → "应用标题"

// 编译时核心接口
interface ITransformAdapter {
  name: string;
  // 检测是否是 i18n 调用
  isI18nExpression(node: ASTNode): boolean;
  // 提取 i18n key
  extractI18nKey(node: ASTNode): string | null;
  // 转换表达式（注入标记）
  transformExpression(node: ASTNode, key: string): ASTNode;
  // 获取配置（翻译文件路径、语言等）
  getConfig(): AdapterConfig;
}

// 运行时核心接口（支持两种标记策略）
interface IRuntimeAdapter {
  name: string;

  // 策略 1: Proxy 包装策略（推荐，用于自定义 i18n 对象）
  // 返回值自带 data-i18n-key 标记，无需编译时处理
  enableProxyWrapper?: boolean;
  wrapI18nObject?: (target: any) => any;

  // 策略 2: 纯编译时策略（用于第三方库）
  // 依赖编译时注入标记，运行时只负责读写
  readTranslation(key: string, locale: string): Promise<string>;
  updateTranslation(key: string, locale: string, value: string): Promise<boolean>;

  // 通用方法
  getSupportedLocales(): string[];
  getCurrentLocale(): string;
}

// 文件操作接口
interface IFileAdapter {
  name: string; // 'typescript' | 'json' | 'yaml' | 'po'
  // 读取文件
  read(filePath: string, key: string): Promise<Record<string, string>>;
  // 更新文件
  update(filePath: string, key: string, values: Record<string, string>): Promise<boolean>;
  // 支持的文件扩展名
  getSupportedExtensions(): string[];
}

// rspack.config.js
import { KiwiRspackPlugin } from '@i18nflow/kiwi/plugin-rspack';

export default {
  plugins: [
    new KiwiRspackPlugin({
      enabled: process.env.NODE_ENV === 'development',
      i18nIdentifier: 'I18N', // I18N 对象名称
      localeDir: 'src/locales', // 语言文件目录
      locales: ['zh-CN', 'en-US'], // 支持的语言
      autoProxy: true, // 自动 Proxy 包装
    }),
  ],
};