@spaceflow/core 0.6.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/core",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Spaceflow 核心能力库",
   "license": "MIT",
   "author": "Lydanne",
@@ -81,7 +81,6 @@
     "@rspack/core": "^1.7.4",
     "chalk": "^5.6.2",
     "dotenv": "^16.4.5",
-    "i18next": "^25.8.4",
     "json-stringify-pretty-compact": "^4.0.0",
     "jsonrepair": "^3.13.1",
     "log-update": "^7.1.0",
@@ -109,6 +108,7 @@
     "typescript": "^5.7.3",
     "typescript-eslint": "^8.20.0",
     "@vitest/coverage-v8": "^4.0.18",
+    "i18next": "^25.8.4",
     "unplugin-swc": "^1.5.9",
     "vitest": "^4.0.18"
   },

package/src/config/schema-generator.service.ts

@@ -85,7 +85,6 @@ export class SchemaGeneratorService {
 
     // 写入文件
     fs.writeFileSync(outputPath, JSON.stringify(fullSchema, null, 2), "utf-8");
-    console.log(`✅ JSON Schema 已生成: ${outputPath}`);
 
     // 自动添加到 .gitignore
     this.addToGitignore(dir, path.basename(outputPath));

package/src/locales/en/translation.json

@@ -7,5 +7,7 @@
   "common.options.ci": "Run in CI environment",
   "config.parseWarning": "Warning: unable to parse config file {{path}}",
   "config.validationFailed": "Spaceflow config validation failed:\n{{errors}}",
-  "extensionLoader.loadFailed": "⚠️ Failed to load Extension {{name}}: {{error}}"
+  "extensionLoader.loadFailed": "⚠️ Failed to load Extension {{name}}: {{error}}",
+  "extensionLoader.autoInstalling": "📦 Auto-installing missing extensions: {{packages}}",
+  "extensionLoader.autoInstallFailed": "⚠️ Auto-install failed, please run spaceflow install manually"
 }

package/src/locales/zh-cn/translation.json

@@ -7,5 +7,7 @@
   "common.options.ci": "是否在 CI 环境中运行",
   "config.parseWarning": "警告: 无法解析配置文件 {{path}}",
   "config.validationFailed": "Spaceflow 配置验证失败:\n{{errors}}",
-  "extensionLoader.loadFailed": "⚠️ 加载 Extension {{name}} 失败: {{error}}"
+  "extensionLoader.loadFailed": "⚠️ 加载 Extension {{name}} 失败: {{error}}",
+  "extensionLoader.autoInstalling": "📦 自动安装缺失的扩展: {{packages}}",
+  "extensionLoader.autoInstallFailed": "⚠️ 自动安装扩展失败，请手动执行 spaceflow install"
 }

package/src/shared/i18n/i18n.ts

@@ -1,72 +1,70 @@
-import * as i18nextModule from "i18next";
-import type { TOptions, i18n } from "i18next";
+/** globalThis 上的 key */
+const GLOBAL_T_KEY = "__spaceflow_t__";
+const GLOBAL_ADD_LOCALE_KEY = "__spaceflow_add_locale__";
 
-// 兼容 CJS/ESM 混合环境
-const i18next: i18n =
-  (i18nextModule as unknown as { default: i18n }).default || (i18nextModule as unknown as i18n);
-import { detectLocale } from "./locale-detect";
-import zhCN from "../../locales/zh-cn/translation.json";
-import en from "../../locales/en/translation.json";
+/** 翻译函数类型 */
+export type TranslateFn = (key: string, options?: Record<string, unknown>) => string;
 
-/** 默认命名空间 */
-const DEFAULT_NS = "translation";
+/** 注册翻译资源函数类型 */
+export type AddLocaleResourcesFn = (
+  ns: string,
+  resources: Record<string, Record<string, unknown>>,
+) => void;
 
-/** 是否已初始化 */
-let initialized = false;
+/**
+ * 设置全局翻译函数
+ * 由 CLI 在启动时调用，将 i18next 的 t 函数挂载到 globalThis
+ */
+export function setGlobalT(fn: TranslateFn): void {
+  (globalThis as Record<string, unknown>)[GLOBAL_T_KEY] = fn;
+}
 
 /**
- * 初始化 i18n
- * 当提供 resources 且无后端加载器时，i18next.init() 同步完成
- * @param lang 指定语言，不传则自动检测
+ * 设置全局翻译资源注册函数
+ * 由 CLI 在启动时调用
  */
-export function initI18n(lang?: string): void {
-  if (initialized) return;
-  const lng = lang || detectLocale();
-  // i18next v25+ 移除了 initSync，但提供内联 resources 时 init() 同步完成
-  void i18next.init({
-    lng,
-    fallbackLng: "zh-CN",
-    defaultNS: DEFAULT_NS,
-    ns: [DEFAULT_NS],
-    resources: {
-      "zh-CN": { [DEFAULT_NS]: zhCN },
-      en: { [DEFAULT_NS]: en },
-    },
-    interpolation: {
-      escapeValue: false,
-    },
-    returnNull: false,
-    returnEmptyString: false,
-    // 确保 init 同步完成（默认 initImmediate: true 会将加载推到 setTimeout）
-    initImmediate: false,
-    // i18next v25.8+ 会在 init 时输出 locize.com 推广日志
-    showSupportNotice: false,
-  });
-  initialized = true;
+export function setGlobalAddLocaleResources(fn: AddLocaleResourcesFn): void {
+  (globalThis as Record<string, unknown>)[GLOBAL_ADD_LOCALE_KEY] = fn;
 }
 
 /**
- * 重置 i18n 状态（仅用于测试）
+ * 获取全局翻译函数
  */
-export function resetI18n(): void {
-  initialized = false;
+function getGlobalT(): TranslateFn | undefined {
+  return (globalThis as Record<string, unknown>)[GLOBAL_T_KEY] as TranslateFn | undefined;
+}
+
+/**
+ * 简单的模板插值（fallback 用）
+ * 支持 {{key}} 格式
+ */
+function interpolate(template: string, options?: Record<string, unknown>): string {
+  if (!options) return template;
+  return template.replace(/\{\{(\w+)\}\}/g, (_, k: string) => {
+    const val = options[k];
+    return val !== undefined ? String(val) : `{{${k}}}`;
+  });
 }
 
 /**
  * 翻译函数
- * 装饰器和运行时均可使用
+ * 优先使用 CLI 通过 setGlobalT 挂载的翻译函数
+ * 未挂载时回退到返回 key（带插值）
  * @param key 翻译 key
  * @param options 插值参数
  */
-export function t(key: string, options?: TOptions): string {
-  if (!initialized) {
-    initI18n();
+export function t(key: string, options?: Record<string, unknown>): string {
+  const globalT = getGlobalT();
+  if (globalT) {
+    return globalT(key, options);
   }
-  return i18next.t(key, options) as string;
+  // fallback: 直接返回 key（带插值）
+  return interpolate(key, options);
 }
 
 /**
  * 为外部 Extension 注册语言资源
+ * 委托给 CLI 通过 setGlobalAddLocaleResources 挂载的实际实现
  * @param ns 命名空间（通常为 Extension name）
  * @param resources 语言资源，key 为语言代码，值为翻译对象
  */
@@ -74,15 +72,18 @@ export function addLocaleResources(
   ns: string,
   resources: Record<string, Record<string, unknown>>,
 ): void {
-  if (!initialized) {
-    initI18n();
-  }
-  for (const [lng, translations] of Object.entries(resources)) {
-    i18next.addResourceBundle(lng, ns, translations, true, true);
-  }
-  if (!i18next.options.ns) {
-    i18next.options.ns = [DEFAULT_NS, ns];
-  } else if (Array.isArray(i18next.options.ns) && !i18next.options.ns.includes(ns)) {
-    i18next.options.ns.push(ns);
+  const fn = (globalThis as Record<string, unknown>)[GLOBAL_ADD_LOCALE_KEY] as
+    | AddLocaleResourcesFn
+    | undefined;
+  if (fn) {
+    fn(ns, resources);
   }
 }
+
+/**
+ * 重置全局翻译函数（仅用于测试）
+ */
+export function resetI18n(): void {
+  (globalThis as Record<string, unknown>)[GLOBAL_T_KEY] = undefined;
+  (globalThis as Record<string, unknown>)[GLOBAL_ADD_LOCALE_KEY] = undefined;
+}

package/src/shared/i18n/index.ts

@@ -1 +1,14 @@
-export { initI18n, t, addLocaleResources } from "./i18n";
+export {
+  t,
+  setGlobalT,
+  setGlobalAddLocaleResources,
+  addLocaleResources,
+  resetI18n,
+  type TranslateFn,
+  type AddLocaleResourcesFn,
+} from "./i18n";
+export { detectLocale } from "./locale-detect";
+
+// 导出 core 基础翻译资源，供 CLI 注册
+export { default as coreZhCN } from "../../locales/zh-cn/translation.json";
+export { default as coreEn } from "../../locales/en/translation.json";