@ai-i18n/eslint-plugin 1.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yliu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# @ai-i18n/eslint-plugin
+
+用于提前报告无法被 Vite/Yuku 静态提取的 `t()` 参数。规则检查解析到
+`virtual:ai-i18n` 的 `t` binding，以及 Vue/React 模式下 `useI18n()` 解构或对象成员得到的
+`t`。其他库或局部同名函数不受影响。
+
+## 按模式配置
+
+显式 import 的 Vanilla 项目可以使用 `recommended`。启用 ai-i18n 按需导入时，选择与
+Vite `framework` 一致的 preset；它会声明对应只读全局并启用同一条静态参数规则：
+
+```js
+import aiI18n from '@ai-i18n/eslint-plugin';
+
+export default [
+  ...aiI18n.configs.vanilla, // 或 .vue / .react
+];
+```
+
+这些 preset 只负责 ai-i18n 的 `t`/`useI18n`。宿主 Auto Import 插件管理的其他 API 仍由
+它自己的 ESLint 集成负责。
+
+## Vue SFC
+
+`.vue` 是可选文件格式。Vue 项目应先通过 `eslint-plugin-vue` 配置
+`vue-eslint-parser`，再展开 `configs.vue`：
+
+```js
+import aiI18n from '@ai-i18n/eslint-plugin';
+import pluginVue from 'eslint-plugin-vue';
+import tseslint from 'typescript-eslint';
+
+export default [
+  ...pluginVue.configs['flat/recommended'],
+  {
+    files: ['**/*.vue'],
+    languageOptions: {
+      parserOptions: { parser: tseslint.parser },
+    },
+  },
+  ...aiI18n.configs.vue,
+];
+```
+
+`configs.vue` 复用宿主的 Vue parser，只启用同一条 `t-static-args` 规则。语义分析使用
+Vue 项目已有的 `@vue/compiler-sfc`，与 Vite 提取器共享编译结果和 source map，覆盖
+`<script>`、`<script setup>`、模板插值和指令表达式。两个 Vue 依赖均为可选 peer，
+不会安装到 React/Vanilla 项目。
+
+Vue preset 同时覆盖 Vue JSX/TSX，但宿主仍需用 `@vitejs/plugin-vue-jsx` 编译这些文件。
+React 项目使用 React preset；同一个 Vite build 不支持两种框架模式混用。
+
+规则与 Vite 共用静态参数语义，包括 `i18n.t()`、`i18n['t']()` 和省略式
+`t('source', undefined)`。未绑定到 ai-i18n 的 template-only `t()` 不参与检查。
+
+需要解析 `tsconfig` 路径别名时，可以显式配置规则：
+
+```js
+import aiI18n from '@ai-i18n/eslint-plugin';
+
+export default [
+  {
+    plugins: { 'ai-i18n': aiI18n },
+    rules: {
+      'ai-i18n/t-static-args': [
+        'error',
+        {
+          tsconfigPath: './tsconfig.json',
+        },
+      ],
+    },
+  },
+];
+```
+
+插件不会自动修改宿主 ESLint 配置。

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { ESLint, Rule } from "eslint";
+//#region src/rules/t-static-args.d.ts
+declare const tStaticArgs: Rule.RuleModule;
+//#endregion
+//#region src/index.d.ts
+declare const plugin: ESLint.Plugin;
+//#endregion
+export { plugin as default, tStaticArgs };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/rules/t-static-args.ts","../src/index.ts"],"mappings":";;cASa,aAAa,KAAK;;;cCDzB,QAAQ,OAAO"}

package/dist/index.js

@@ -0,0 +1,282 @@
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+import { AI_I18N_VIRTUAL_MODULE_ID, Analyzer, extractMessages, findUnboundCalls } from "@ai-i18n/analyzer";
+import { analyzeVueSource } from "@ai-i18n/analyzer/vue";
+//#region src/resolve-import.ts
+const SOURCE_EXTENSIONS = [
+	"",
+	".ts",
+	".tsx",
+	".js",
+	".jsx",
+	".mts",
+	".cts",
+	".mjs",
+	".cjs"
+];
+function createImportResolver(tsconfigPath) {
+	const aliases = [];
+	let baseUrl = process.cwd();
+	if (tsconfigPath) {
+		const absoluteConfig = path.resolve(tsconfigPath);
+		const config = readTsConfig(absoluteConfig);
+		baseUrl = path.resolve(path.dirname(absoluteConfig), config.compilerOptions?.baseUrl ?? ".");
+		for (const [pattern, targets] of Object.entries(config.compilerOptions?.paths ?? {})) {
+			const star = pattern.indexOf("*");
+			aliases.push({
+				prefix: star < 0 ? pattern : pattern.slice(0, star),
+				suffix: star < 0 ? "" : pattern.slice(star + 1),
+				targets
+			});
+		}
+	}
+	return (specifier, importer) => {
+		if (specifier === "virtual:ai-i18n") return specifier;
+		if (specifier.startsWith(".")) return probeSource(path.resolve(path.dirname(importer), specifier));
+		for (const alias of aliases) {
+			if (!specifier.startsWith(alias.prefix) || !specifier.endsWith(alias.suffix)) continue;
+			const value = specifier.slice(alias.prefix.length, specifier.length - alias.suffix.length || void 0);
+			for (const target of alias.targets) {
+				const candidate = target.includes("*") ? target.replace("*", value) : target;
+				const resolved = probeSource(path.resolve(baseUrl, candidate));
+				if (resolved) return resolved;
+			}
+		}
+		return null;
+	};
+}
+function probeSource(candidate) {
+	for (const extension of SOURCE_EXTENSIONS) {
+		const file = `${candidate}${extension}`;
+		if (isFile(file)) return path.normalize(file);
+	}
+	for (const extension of SOURCE_EXTENSIONS.slice(1)) {
+		const file = path.join(candidate, `index${extension}`);
+		if (isFile(file)) return path.normalize(file);
+	}
+	return null;
+}
+function isFile(file) {
+	try {
+		return fs.statSync(file).isFile();
+	} catch {
+		return false;
+	}
+}
+function readTsConfig(filename) {
+	try {
+		return JSON.parse(stripJsonComments(fs.readFileSync(filename, "utf8")));
+	} catch {
+		return {};
+	}
+}
+function stripJsonComments(source) {
+	let result = "";
+	let quote = "";
+	let escaped = false;
+	for (let index = 0; index < source.length; index += 1) {
+		const current = source[index];
+		const next = source[index + 1];
+		if (quote) {
+			result += current;
+			if (escaped) escaped = false;
+			else if (current === "\\") escaped = true;
+			else if (current === quote) quote = "";
+			continue;
+		}
+		if (current === "\"" || current === "'") {
+			quote = current;
+			result += current;
+			continue;
+		}
+		if (current === "/" && next === "/") {
+			while (index < source.length && source[index] !== "\n") index += 1;
+			result += "\n";
+			continue;
+		}
+		if (current === "/" && next === "*") {
+			index += 2;
+			while (index < source.length && !(source[index] === "*" && source[index + 1] === "/")) {
+				if (source[index] === "\n") result += "\n";
+				index += 1;
+			}
+			index += 1;
+			continue;
+		}
+		result += current;
+	}
+	return result.replace(/,\s*([}\]])/g, "$1");
+}
+//#endregion
+//#region src/analyze.ts
+function analyzeStaticArgs(code, filename, tsconfigPath, lang, autoImport = false) {
+	const resolve = createImportResolver(tsconfigPath);
+	const analyzer = new Analyzer({ resolve });
+	analyzer.addFile(AI_I18N_VIRTUAL_MODULE_ID, "export function t(source) { return source }");
+	const entryPath = normalizeFilename(filename);
+	const entry = analyzer.addFile(entryPath, code, lang ? { lang } : void 0);
+	if (!hasTranslationCandidate(entry, autoImport)) return [];
+	loadDependencies(analyzer, entry, resolve);
+	analyzer.link();
+	return extractMessages(entry, AI_I18N_VIRTUAL_MODULE_ID, translationHooks(autoImport), autoImport).warnings.map(({ code: warningCode, line, column, message }) => ({
+		code: warningCode,
+		line,
+		column,
+		message
+	}));
+}
+function hasTranslationCandidate(module, autoImport) {
+	return module.imports.some((item) => !item.typeOnly && (item.name === "t" || item.name === "useI18n")) || autoImport && findUnboundCalls(module, /* @__PURE__ */ new Set(["t", "useI18n"])).length > 0;
+}
+function translationHooks(autoImport) {
+	return [{
+		module: AI_I18N_VIRTUAL_MODULE_ID,
+		hook: "useI18n",
+		property: "t",
+		autoImport
+	}];
+}
+function loadDependencies(analyzer, entry, resolve) {
+	const queue = [entry];
+	const visited = /* @__PURE__ */ new Set();
+	while (queue.length) {
+		const module = queue.shift();
+		if (visited.has(module.path)) continue;
+		visited.add(module.path);
+		for (const item of module.imports) {
+			const resolved = resolve(item.specifier, module.path);
+			if (!resolved || resolved === AI_I18N_VIRTUAL_MODULE_ID) continue;
+			let dependency = analyzer.module(resolved);
+			if (!dependency) try {
+				dependency = analyzer.addFile(resolved, fs.readFileSync(resolved, "utf8"));
+			} catch {
+				continue;
+			}
+			queue.push(dependency);
+		}
+	}
+}
+function normalizeFilename(filename) {
+	return filename.startsWith("<") ? path.resolve("eslint-input.ts") : path.resolve(filename);
+}
+//#endregion
+//#region src/vue-sfc.ts
+const require = createRequire(import.meta.url);
+function createVueAnalysisSource(source, filename, parserServices) {
+	if (!parserServices.getDocumentFragment?.()) throw new Error("检查 .vue 文件需要使用 vue-eslint-parser");
+	try {
+		return analyzeVueSource(source, filename, require("@vue/compiler-sfc"));
+	} catch (error) {
+		if (isMissingVueCompiler(error)) throw new Error("检查 .vue 文件需要安装 @vue/compiler-sfc");
+		throw error;
+	}
+}
+function isMissingVueCompiler(error) {
+	return error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND";
+}
+//#endregion
+//#region src/rules/t-static-args.ts
+const tStaticArgs = {
+	meta: {
+		type: "problem",
+		docs: { description: "要求 virtual:ai-i18n 的 t() 参数可被静态提取" },
+		schema: [{
+			type: "object",
+			properties: {
+				tsconfigPath: { type: "string" },
+				autoImport: { type: "boolean" }
+			},
+			additionalProperties: false
+		}],
+		messages: {
+			analysisFailed: "ai-i18n 静态分析失败：{{reason}}",
+			dynamicArg: "t() 参数无法静态提取，请使用字符串字面量、静态模板、条件表达式或可解析的 const 字符串。"
+		}
+	},
+	create(context) {
+		const options = context.options[0] ?? {};
+		return { "Program:exit"(node) {
+			let warnings;
+			try {
+				const source = context.filename.endsWith(".vue") ? createVueAnalysisSource(context.sourceCode.text, context.filename, context.sourceCode.parserServices) : {
+					code: context.sourceCode.text,
+					lang: void 0,
+					mapLocation: (location) => location
+				};
+				warnings = analyzeStaticArgs(source.code, context.filename, options.tsconfigPath, source.lang, options.autoImport);
+				warnings = warnings.map((warning) => ({
+					...warning,
+					...source.mapLocation(warning)
+				}));
+			} catch (error) {
+				context.report({
+					node,
+					messageId: "analysisFailed",
+					data: { reason: error instanceof Error ? error.message : String(error) }
+				});
+				return;
+			}
+			for (const warning of warnings) {
+				const analysisFailed = warning.code === "parse-error";
+				context.report({
+					node,
+					loc: {
+						start: warning,
+						end: {
+							line: warning.line,
+							column: warning.column + 1
+						}
+					},
+					messageId: analysisFailed ? "analysisFailed" : "dynamicArg",
+					...analysisFailed ? { data: { reason: warning.message } } : {}
+				});
+			}
+		} };
+	}
+};
+//#endregion
+//#region src/index.ts
+const { version } = createRequire(import.meta.url)("../package.json");
+const plugin = {
+	meta: {
+		name: "@ai-i18n/eslint-plugin",
+		version,
+		namespace: "ai-i18n"
+	},
+	rules: { "t-static-args": tStaticArgs },
+	configs: {}
+};
+plugin.configs.recommended = [{
+	ignores: ["**/*.vue"],
+	plugins: { "ai-i18n": plugin },
+	rules: { "ai-i18n/t-static-args": "error" }
+}];
+plugin.configs.vue = [{
+	files: ["**/*.{js,mjs,cjs,ts,mts,cts,jsx,tsx,vue}"],
+	plugins: { "ai-i18n": plugin },
+	languageOptions: { globals: { useI18n: "readonly" } },
+	rules: { "ai-i18n/t-static-args": ["error", { autoImport: true }] }
+}];
+plugin.configs.react = [{
+	files: ["**/*.{js,mjs,cjs,ts,mts,cts,jsx,tsx}"],
+	plugins: { "ai-i18n": plugin },
+	languageOptions: { globals: { useI18n: "readonly" } },
+	rules: { "ai-i18n/t-static-args": ["error", { autoImport: true }] }
+}];
+plugin.configs.vanilla = [{
+	files: ["**/*.{js,mjs,cjs,ts,mts,cts}"],
+	plugins: { "ai-i18n": plugin },
+	languageOptions: { globals: {
+		t: "readonly",
+		setLang: "readonly",
+		getLang: "readonly",
+		getLangs: "readonly",
+		subscribe: "readonly"
+	} },
+	rules: { "ai-i18n/t-static-args": ["error", { autoImport: true }] }
+}];
+//#endregion
+export { plugin as default, tStaticArgs };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/resolve-import.ts","../src/analyze.ts","../src/vue-sfc.ts","../src/rules/t-static-args.ts","../src/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nconst SOURCE_EXTENSIONS = [\n  '',\n  '.ts',\n  '.tsx',\n  '.js',\n  '.jsx',\n  '.mts',\n  '.cts',\n  '.mjs',\n  '.cjs',\n] as const;\n\ninterface TsConfig {\n  compilerOptions?: {\n    baseUrl?: string;\n    paths?: Record<string, string[]>;\n  };\n}\n\ninterface Alias {\n  prefix: string;\n  suffix: string;\n  targets: string[];\n}\n\nexport function createImportResolver(tsconfigPath?: string) {\n  const aliases: Alias[] = [];\n  let baseUrl = process.cwd();\n  if (tsconfigPath) {\n    const absoluteConfig = path.resolve(tsconfigPath);\n    const config = readTsConfig(absoluteConfig);\n    baseUrl = path.resolve(\n      path.dirname(absoluteConfig),\n      config.compilerOptions?.baseUrl ?? '.',\n    );\n    for (const [pattern, targets] of Object.entries(\n      config.compilerOptions?.paths ?? {},\n    )) {\n      const star = pattern.indexOf('*');\n      aliases.push({\n        prefix: star < 0 ? pattern : pattern.slice(0, star),\n        suffix: star < 0 ? '' : pattern.slice(star + 1),\n        targets,\n      });\n    }\n  }\n\n  return (specifier: string, importer: string): string | null => {\n    if (specifier === 'virtual:ai-i18n') return specifier;\n    if (specifier.startsWith('.')) {\n      return probeSource(path.resolve(path.dirname(importer), specifier));\n    }\n    for (const alias of aliases) {\n      if (\n        !specifier.startsWith(alias.prefix) ||\n        !specifier.endsWith(alias.suffix)\n      ) {\n        continue;\n      }\n      const value = specifier.slice(\n        alias.prefix.length,\n        specifier.length - alias.suffix.length || undefined,\n      );\n      for (const target of alias.targets) {\n        const candidate = target.includes('*')\n          ? target.replace('*', value)\n          : target;\n        const resolved = probeSource(path.resolve(baseUrl, candidate));\n        if (resolved) return resolved;\n      }\n    }\n    return null;\n  };\n}\n\nfunction probeSource(candidate: string): string | null {\n  for (const extension of SOURCE_EXTENSIONS) {\n    const file = `${candidate}${extension}`;\n    if (isFile(file)) return path.normalize(file);\n  }\n  for (const extension of SOURCE_EXTENSIONS.slice(1)) {\n    const file = path.join(candidate, `index${extension}`);\n    if (isFile(file)) return path.normalize(file);\n  }\n  return null;\n}\n\nfunction isFile(file: string) {\n  try {\n    return fs.statSync(file).isFile();\n  } catch {\n    return false;\n  }\n}\n\nfunction readTsConfig(filename: string): TsConfig {\n  try {\n    return JSON.parse(stripJsonComments(fs.readFileSync(filename, 'utf8'))) as TsConfig;\n  } catch {\n    return {};\n  }\n}\n\nfunction stripJsonComments(source: string): string {\n  let result = '';\n  let quote = '';\n  let escaped = false;\n  for (let index = 0; index < source.length; index += 1) {\n    const current = source[index]!;\n    const next = source[index + 1];\n    if (quote) {\n      result += current;\n      if (escaped) escaped = false;\n      else if (current === '\\\\') escaped = true;\n      else if (current === quote) quote = '';\n      continue;\n    }\n    if (current === '\"' || current === \"'\") {\n      quote = current;\n      result += current;\n      continue;\n    }\n    if (current === '/' && next === '/') {\n      while (index < source.length && source[index] !== '\\n') index += 1;\n      result += '\\n';\n      continue;\n    }\n    if (current === '/' && next === '*') {\n      index += 2;\n      while (\n        index < source.length &&\n        !(source[index] === '*' && source[index + 1] === '/')\n      ) {\n        if (source[index] === '\\n') result += '\\n';\n        index += 1;\n      }\n      index += 1;\n      continue;\n    }\n    result += current;\n  }\n  return result.replace(/,\\s*([}\\]])/g, '$1');\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport {\n  AI_I18N_VIRTUAL_MODULE_ID,\n  Analyzer,\n  extractMessages,\n  findUnboundCalls,\n  type Module,\n  type ExtractWarningCode,\n  type AnalysisLanguage,\n  type TranslationHookBinding,\n} from '@ai-i18n/analyzer';\nimport { createImportResolver } from './resolve-import.js';\n\nexport interface StaticArgsWarning {\n  code: ExtractWarningCode;\n  line: number;\n  column: number;\n  message: string;\n}\n\nexport function analyzeStaticArgs(\n  code: string,\n  filename: string,\n  tsconfigPath?: string,\n  lang?: AnalysisLanguage,\n  autoImport = false,\n): StaticArgsWarning[] {\n  const resolve = createImportResolver(tsconfigPath);\n  const analyzer = new Analyzer({ resolve });\n  analyzer.addFile(\n    AI_I18N_VIRTUAL_MODULE_ID,\n    'export function t(source) { return source }',\n  );\n  const entryPath = normalizeFilename(filename);\n  const entry = analyzer.addFile(entryPath, code, lang ? { lang } : undefined);\n  if (!hasTranslationCandidate(entry, autoImport)) return [];\n  loadDependencies(analyzer, entry, resolve);\n  analyzer.link();\n  return extractMessages(\n    entry,\n    AI_I18N_VIRTUAL_MODULE_ID,\n    translationHooks(autoImport),\n    autoImport,\n  ).warnings.map(({ code: warningCode, line, column, message }) => ({\n    code: warningCode,\n    line,\n    column,\n    message,\n  }));\n}\n\nfunction hasTranslationCandidate(module: Module, autoImport: boolean): boolean {\n  return (\n    module.imports.some(\n      (item) =>\n        !item.typeOnly && (item.name === 't' || item.name === 'useI18n'),\n    ) ||\n    (autoImport &&\n      findUnboundCalls(module, new Set(['t', 'useI18n'])).length > 0)\n  );\n}\n\nfunction translationHooks(\n  autoImport: boolean,\n): readonly TranslationHookBinding[] {\n  return [\n    {\n      module: AI_I18N_VIRTUAL_MODULE_ID,\n      hook: 'useI18n',\n      property: 't',\n      autoImport,\n    },\n  ];\n}\n\nfunction loadDependencies(\n  analyzer: Analyzer,\n  entry: Module,\n  resolve: (specifier: string, importer: string) => string | null,\n) {\n  const queue = [entry];\n  const visited = new Set<string>();\n  while (queue.length) {\n    const module = queue.shift()!;\n    if (visited.has(module.path)) continue;\n    visited.add(module.path);\n    for (const item of module.imports) {\n      const resolved = resolve(item.specifier, module.path);\n      if (!resolved || resolved === AI_I18N_VIRTUAL_MODULE_ID) continue;\n      let dependency = analyzer.module(resolved);\n      if (!dependency) {\n        try {\n          dependency = analyzer.addFile(\n            resolved,\n            fs.readFileSync(resolved, 'utf8'),\n          );\n        } catch {\n          continue;\n        }\n      }\n      queue.push(dependency);\n    }\n  }\n}\n\nfunction normalizeFilename(filename: string) {\n  return filename.startsWith('<')\n    ? path.resolve('eslint-input.ts')\n    : path.resolve(filename);\n}\n","import { createRequire } from 'node:module';\nimport {\n  analyzeVueSource,\n  type VueAnalysisSource,\n  type VueCompiler,\n} from '@ai-i18n/analyzer/vue';\n\ninterface VueParserServices {\n  getDocumentFragment?: () => unknown;\n}\n\nconst require = createRequire(import.meta.url);\n\nexport function createVueAnalysisSource(\n  source: string,\n  filename: string,\n  parserServices: VueParserServices,\n): VueAnalysisSource {\n  if (!parserServices.getDocumentFragment?.()) {\n    throw new Error('检查 .vue 文件需要使用 vue-eslint-parser');\n  }\n\n  try {\n    // Vue 编译器仅在 configs.vue 真正处理 SFC 时加载，不影响 React/Vanilla 项目。\n    const compiler = require('@vue/compiler-sfc') as VueCompiler;\n    return analyzeVueSource(source, filename, compiler);\n  } catch (error) {\n    if (isMissingVueCompiler(error)) {\n      throw new Error('检查 .vue 文件需要安装 @vue/compiler-sfc');\n    }\n    throw error;\n  }\n}\n\nfunction isMissingVueCompiler(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    'code' in error &&\n    error.code === 'MODULE_NOT_FOUND'\n  );\n}\n","import type { Rule } from 'eslint';\nimport { analyzeStaticArgs } from '../analyze.js';\nimport { createVueAnalysisSource } from '../vue-sfc.js';\n\ninterface RuleOptions {\n  tsconfigPath?: string;\n  autoImport?: boolean;\n}\n\nexport const tStaticArgs: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: '要求 virtual:ai-i18n 的 t() 参数可被静态提取',\n    },\n    schema: [\n      {\n        type: 'object',\n        properties: {\n          tsconfigPath: { type: 'string' },\n          autoImport: { type: 'boolean' },\n        },\n        additionalProperties: false,\n      },\n    ],\n    messages: {\n      analysisFailed: 'ai-i18n 静态分析失败：{{reason}}',\n      dynamicArg:\n        't() 参数无法静态提取，请使用字符串字面量、静态模板、条件表达式或可解析的 const 字符串。',\n    },\n  },\n  create(context) {\n    const options = (context.options[0] ?? {}) as RuleOptions;\n    return {\n      'Program:exit'(node) {\n        let warnings;\n        try {\n          const source = context.filename.endsWith('.vue')\n            ? createVueAnalysisSource(\n                context.sourceCode.text,\n                context.filename,\n                context.sourceCode.parserServices,\n              )\n            : {\n                code: context.sourceCode.text,\n                lang: undefined,\n                mapLocation: (location: { line: number; column: number }) =>\n                  location,\n              };\n          warnings = analyzeStaticArgs(\n            source.code,\n            context.filename,\n            options.tsconfigPath,\n            source.lang,\n            options.autoImport,\n          );\n          warnings = warnings.map((warning) => ({\n            ...warning,\n            ...source.mapLocation(warning),\n          }));\n        } catch (error) {\n          context.report({\n            node,\n            messageId: 'analysisFailed',\n            data: {\n              reason: error instanceof Error ? error.message : String(error),\n            },\n          });\n          return;\n        }\n        for (const warning of warnings) {\n          const analysisFailed = warning.code === 'parse-error';\n          context.report({\n            node,\n            loc: {\n              start: warning,\n              end: { line: warning.line, column: warning.column + 1 },\n            },\n            messageId: analysisFailed ? 'analysisFailed' : 'dynamicArg',\n            ...(analysisFailed ? { data: { reason: warning.message } } : {}),\n          });\n        }\n      },\n    };\n  },\n};\n","import { createRequire } from 'node:module';\nimport type { ESLint } from 'eslint';\nimport { tStaticArgs } from './rules/t-static-args.js';\n\nconst { version } = createRequire(import.meta.url)('../package.json') as {\n  version: string;\n};\n\nconst plugin: ESLint.Plugin = {\n  meta: {\n    name: '@ai-i18n/eslint-plugin',\n    version,\n    namespace: 'ai-i18n',\n  },\n  rules: {\n    't-static-args': tStaticArgs,\n  },\n  configs: {},\n};\n\n// 规则集必须由使用者显式引入，不会修改宿主项目的 ESLint 配置。\nplugin.configs!.recommended = [\n  {\n    ignores: ['**/*.vue'],\n    plugins: { 'ai-i18n': plugin },\n    rules: { 'ai-i18n/t-static-args': 'error' },\n  },\n];\n\nplugin.configs!.vue = [\n  {\n    files: ['**/*.{js,mjs,cjs,ts,mts,cts,jsx,tsx,vue}'],\n    plugins: { 'ai-i18n': plugin },\n    languageOptions: { globals: { useI18n: 'readonly' } },\n    rules: {\n      'ai-i18n/t-static-args': ['error', { autoImport: true }],\n    },\n  },\n];\n\nplugin.configs!.react = [\n  {\n    files: ['**/*.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],\n    plugins: { 'ai-i18n': plugin },\n    languageOptions: { globals: { useI18n: 'readonly' } },\n    rules: {\n      'ai-i18n/t-static-args': ['error', { autoImport: true }],\n    },\n  },\n];\n\nplugin.configs!.vanilla = [\n  {\n    files: ['**/*.{js,mjs,cjs,ts,mts,cts}'],\n    plugins: { 'ai-i18n': plugin },\n    languageOptions: {\n      globals: {\n        t: 'readonly',\n        setLang: 'readonly',\n        getLang: 'readonly',\n        getLangs: 'readonly',\n        subscribe: 'readonly',\n      },\n    },\n    rules: {\n      'ai-i18n/t-static-args': ['error', { autoImport: true }],\n    },\n  },\n];\n\nexport { tStaticArgs };\nexport default plugin;\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@ai-i18n/eslint-plugin",
+  "version": "1.0.0-alpha.0",
+  "description": "ESLint 9 static-argument checks aligned with ai-i18n extraction semantics.",
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "i18n",
+    "translation"
+  ],
+  "license": "MIT",
+  "author": "yliu",
+  "homepage": "https://github.com/bosens-China/ai-i18n#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bosens-China/ai-i18n.git",
+    "directory": "packages/eslint"
+  },
+  "bugs": {
+    "url": "https://github.com/bosens-China/ai-i18n/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@ai-i18n/analyzer": "^1.0.0-alpha.0"
+  },
+  "peerDependencies": {
+    "@vue/compiler-sfc": "^3.5.0",
+    "eslint": "^9.0.0",
+    "vue-eslint-parser": "^10.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@vue/compiler-sfc": {
+      "optional": true
+    },
+    "vue-eslint-parser": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@vue/compiler-sfc": "^3.5.34",
+    "vue-eslint-parser": "^10.4.1"
+  },
+  "scripts": {
+    "lint": "eslint .",
+    "check": "tsc -p tsconfig.json --noEmit && pnpm lint",
+    "test": "pnpm --dir ../.. exec vitest run packages/eslint/test --config vitest.config.ts"
+  }
+}