mm_lang 3.0.0 → 3.0.1

package/lib/langs_admin.js

@@ -1,4 +1,4 @@
-const Admin = require('mm_corejs').Admin;
+const { reg } = require('mm_admin');
 const Langs = require('./langs.js');
 
 /**
@@ -7,7 +7,7 @@ const Langs = require('./langs.js');
  * Lang 配置 file 时以文件路径为作用域键从管理器取实例，相同文件的 Lang 复用同一存储
  * @type {Admin}
  */
-const langs_admin = new Admin();
+const langs_admin = reg('lang.langs');
 langs_admin.setClass(Langs);
 
 module.exports = langs_admin;

package/lib/tools/index.js

@@ -0,0 +1,16 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+/** 模块能力层：懒加载工具实现，避免模块入口被 require 时加载全部实现 */
+module.exports = new Proxy({}, {
+  get(_t, key) {
+    if (typeof key !== 'string') return undefined;
+    if (!fs.existsSync(path.join(__dirname, key, 'index.js'))) return undefined;
+    return require('./' + key);
+  },
+  has(_t, key) {
+    return typeof key === 'string' && fs.existsSync(path.join(__dirname, key, 'index.js'));
+  },
+  ownKeys() { return fs.readdirSync(__dirname, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name); },
+  getOwnPropertyDescriptor(_t, key) { return this.has(_t, key) ? { enumerable: true, configurable: true } : undefined; }
+});

package/lib/tools/lang/index.js

@@ -0,0 +1,59 @@
+'use strict';
+/**
+ * lang —— 多语言词条工具
+ * 复用模块 Lang 实例：层级键解析、回退链与格式化都由模块维护。
+ */
+const { langAdmin } = require('../../../index.js');
+
+async function main(params, ctx, options) {
+  void options;
+  const p = params || {};
+  const action = p.action || 't';
+  const done = (data) => { ctx.output = data; return data; };
+
+  try {
+    const lang = langAdmin(p.scope || 'os');
+
+    if (action === 't') {
+      if (!p.key) throw new TypeError('key 不能为空');
+      const text = lang.t(p.key, p.params || {}, p.lang);
+      return done({ code: 0, msg: '成功', key: p.key, text: String(text) });
+    }
+
+    if (action === 'get') {
+      return done({ code: 0, msg: '成功', lang: p.lang || '', value: lang.get(p.lang || undefined) });
+    }
+
+    if (action === 'set') {
+      if (!p.key) throw new TypeError('key 不能为空');
+      if (typeof p.value !== 'string') throw new TypeError('value 必须是字符串');
+      lang.set(p.key, p.value, p.lang);
+      if (typeof lang.save === 'function') lang.save();
+      return done({ code: 0, msg: '写入成功', key: p.key });
+    }
+
+    if (action === 'del') {
+      if (!p.key) throw new TypeError('key 不能为空');
+      const deleted = lang.del(p.key, p.lang);
+      if (typeof lang.save === 'function') lang.save();
+      return done({ code: 0, msg: deleted ? '删除成功' : '词条不存在', key: p.key, deleted: !!deleted });
+    }
+
+    if (action === 'langs') {
+      const langs = lang.getLangs();
+      const list = Array.isArray(langs) ? langs : Object.keys(langs || {});
+      return done({ code: 0, msg: '成功', count: list.length, langs: list });
+    }
+
+    if (action === 'save') {
+      lang.save();
+      return done({ code: 0, msg: '已落盘', ok: true });
+    }
+
+    return done({ code: 10001, msg: '不支持的操作: ' + action });
+  } catch (error) {
+    return done({ code: 10000, msg: '执行失败：' + error.message, error: { name: error.name, message: error.message } });
+  }
+}
+
+module.exports = { main };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mm_lang",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "超级美眉多语言模块：融合 i18n 行为（Lang）与语言存储持久化（Langs），支持层级键、回退链、复数、格式化与 JSON 文件落盘",
   "main": "index.js",
   "repository": {
@@ -18,8 +18,8 @@
     "多语言",
     "语言包"
   ],
-  "layer": "infra",
-  "group": "data",
+  "layer": "infrastructure",
+  "group": "state",
   "author": "邱文武",
   "license": "ISC",
   "scripts": {
@@ -27,7 +27,7 @@
     "example": "node example/index.js"
   },
   "dependencies": {
-    "mm_corejs": "^1.1.6",
+    "mm_admin": "^1.1.0",
     "mm_kv_store": "^1.0.1"
   },
   "files": [
@@ -35,6 +35,7 @@
     "lib",
     "example",
     "README.md",
-    "package.json"
+    "package.json",
+    "tool"
   ]
 }

package/tool/lang/index.js

@@ -0,0 +1,7 @@
+'use strict';
+/**
+ * lang —— 工具契约适配层
+ * 业务实现归位于模块 lib/tools/lang/，本文件只把模块能力暴露给加载器。
+ * 其它模块可直接 require('mm_lang').tools.lang 复用。
+ */
+module.exports = require('../../lib/tools/lang');

package/tool/lang/tool.json

@@ -0,0 +1,84 @@
+{
+  "name": "lang",
+  "title": "多语言词条",
+  "description": "基于 mm_lang 的多语言能力：按语言取词条（支持层级键与格式化）、写入/删除词条、列出支持语言、落盘。适用场景：生成多语言文案、补词条、核对某语言是否支持。工作流提示：t 按 key 取词，key 用层级点号（如 common.save）；params 用于 {name} 之类占位。",
+  "category": "多语言",
+  "group": "i18n",
+  "type": "function",
+  "main": "./index.js",
+  "params": {
+    "type": "object",
+    "properties": {
+      "action": {
+        "type": "string",
+        "description": "操作类型: t(取词条)/get(读整表)/set(写词条)/del(删词条)/langs(支持语言)/save(落盘)",
+        "enum": [
+          "t",
+          "get",
+          "set",
+          "del",
+          "langs",
+          "save"
+        ],
+        "default": "t"
+      },
+      "key": {
+        "type": "string",
+        "description": "词条键(get/del/t 必填，支持 a.b.c 层级)"
+      },
+      "value": {
+        "type": "string",
+        "description": "词条文案(set 必填)"
+      },
+      "lang": {
+        "type": "string",
+        "description": "语言标识，缺省取实例默认语言"
+      },
+      "params": {
+        "type": "object",
+        "description": "占位参数(t 可选)"
+      },
+      "scope": {
+        "type": "string",
+        "description": "实例作用域，缺省 os",
+        "default": "os"
+      }
+    },
+    "required": [
+      "action"
+    ]
+  },
+  "returns": {
+    "type": "object",
+    "properties": {
+      "code": {
+        "type": "number",
+        "description": "0 表示成功，1xxxx 表示业务/执行异常"
+      },
+      "msg": {
+        "type": "string",
+        "description": "结果描述"
+      },
+      "text": {
+        "type": "string",
+        "description": "词条文案(t)"
+      },
+      "value": {
+        "description": "整表或单条值(get)"
+      },
+      "langs": {
+        "type": "array",
+        "description": "支持语言列表(langs)"
+      },
+      "count": {
+        "type": "number",
+        "description": "数量"
+      },
+      "error": {
+        "type": "object",
+        "description": "异常对象 { name, message }"
+      }
+    }
+  },
+  "handler": "manager"
+}