mbler 0.1.1 → 0.1.3-alpha

package/lib/modules/gameLib/src/ui.js

@@ -1 +1,209 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.regLayout=exports.createForm=exports.UI=void 0;const server_ui_1=require("@minecraft/server-ui"),config_js_1=__importDefault(require("./config.js")),utils_1=require("./utils"),uiConfig=config_js_1.default.ui,regs=new Map;class show{form;callback=new Map;running;key=[Symbol("mcbe.gamelib.ui.onCancel"),Symbol("mcbe.gamelib.ui.onCommit")];constructor(t,e){this.form=t,this.running=t.show(e).then(t=>{const{callback:e}=this;t.canceled&&e.has(this.key[0])?e.get(this.key[0])(t):e.has(this.key[1])&&e.get(this.key[1])(t),this.isSuccess=!0}),this.isSuccess=!1}onCancel(t){"function"==typeof t&&this.callback.set(this.key[0],t)}onCommit(t){"function"==typeof t&&this.callback.set(this.key[1],t)}async waitSuccess(){this.isSuccess||await this.running}}class UI{form;formType;logger;layoutGroup;constructor(t,e){const r=uiConfig.FormTypes?.[t];if(!r)throw new TypeError(`Invalid form type: "${t}". Allowed: ${uiConfig.FormTypeArr.join(", ")}`);this.form=new r,this.formType=t,this.logger=e,this.layoutGroup=uiConfig.LayoutTypes[t]}set title(t){if("string"!=typeof t)throw new TypeError("Title must be a string.");this.form.title(t)}addLayout(t){const{type:e,param:r}=t,o=this.layoutGroup?.[e];if(!o)throw new TypeError(`Unknown layout type: "${e}".`);const i=this.form[o.source].bind(this.form);if("function"!=typeof i)return void this.logger?.e?.(`Layout source "${o.source}" is not a function.`);if(!o.param)return void i();const s=[];for(let t=0;t<o.param.length;t++){const e=o.param[t];if("string"!=typeof e){this.logger?.w?.(`Layout param name must be string, got ${typeof e} at index ${t}.`);continue}const i=uiConfig.classic[e],n=r[t];if(this.#t(i,n))s.push(n);else{if(t>=o.minPar)continue;this.logger?.w?.(`Param "${e}" failed validation.`)}}try{i(...s)}catch(t){this.logger?.e?.(`Failed to add layout "${e}": ${t}`)}}#t(t,e){if(!t)return!1;if(typeof e!==t.type)return!1;if("function"==typeof t.regexFunc&&!t.regexFunc(e))return!1;switch(t.type){case"string":if(t.regex&&!t.regex.test(e))return!1;break;case"object":if(t.ObjectType&&!utils_1.utils.typeVerify(e,t.ObjectType))return!1;break;case"number":if(t.count&&(e<t.count[0]||e>t.count[1]))return!1}return!0}show(t,e=!1){return e?new show(this.form,t):this.form.show(t)}}exports.UI=UI;const createForm=(t,e,r)=>{let o=r;return"symbol"==typeof r&&regs.has(r)&&(o=regs.get(r)),function(e,r){const o=uiConfig.FormTypeArr,i=new TypeError(`createForm must be called with name in [${o.join(", ")}] and valid 'opt'.`);if(!o.includes(e))throw i;if(!r||!Array.isArray(r.layout))throw i;const s=new UI(e,t);s.title="string"==typeof r.title?r.title:"未设置";for(const t of r.layout)s.addLayout(t);return s}(e,o)};exports.createForm=createForm;const regLayout=t=>{if(Array.isArray(t.regIds))for(let e of t.regIds)"string"==typeof e&&void 0!==t[e]&&regs.set(Symbol(e),t[e]);return Array.from(regs.keys())};exports.regLayout=regLayout;
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.regLayout = exports.createForm = exports.UI = void 0;
+const server_ui_1 = require("@minecraft/server-ui");
+const config_js_1 = __importDefault(require("./config.js"));
+const utils_1 = require("./utils");
+const uiConfig = config_js_1.default.ui;
+const regs = new Map;
+class show {
+    form;
+    callback = new Map;
+    running;
+    key = [
+        Symbol("mcbe.gamelib.ui.onCancel"),
+        Symbol("mcbe.gamelib.ui.onCommit")
+    ];
+    constructor(form, player) {
+        this.form = form;
+        // 调用原生 show 方法
+        this.running = form.show(player).then(event => {
+            const { callback } = this;
+            if (event.canceled && callback.has(this.key[0])) {
+                callback.get(this.key[0])(event);
+            }
+            else {
+                callback.has(this.key[1]) && callback.get(this.key[1])(event);
+            }
+            this.isSuccess = true;
+        });
+        this.isSuccess = false;
+    }
+    onCancel(callback) {
+        if (typeof callback === "function")
+            this.callback.set(this.key[0], callback);
+    }
+    onCommit(callback) {
+        if (typeof callback === "function")
+            this.callback.set(this.key[1], callback);
+    }
+    async waitSuccess() {
+        if (this.isSuccess)
+            return;
+        await this.running;
+    }
+}
+/**
+ * UI 表单封装类，用于根据配置动态创建、配置和显示 Minecraft 表单（如 Action、Modal、Message）。
+ */
+class UI {
+    form; // 表单实例，如 ActionFormData 的实例
+    formType; // 表单类型，如 "Action"
+    logger; // 日志记录器，需有 e() 和 w() 方法
+    layoutGroup; // 当前表单类型支持的布局配置，如 { button: { source: 'button', param: [...] } }
+    /**
+     * 构造函数
+     * @param {string} name - 表单类型，如 "Action"、"Modal"、"Message"
+     * @param {Object} logger - 日志对象，需实现 e() 和 w() 方法
+     */
+    constructor(name, logger) {
+        const item = uiConfig.FormTypes?.[name];
+        if (!item)
+            throw new TypeError(`Invalid form type: "${name}". Allowed: ${uiConfig.FormTypeArr.join(", ")}`);
+        this.form = new item; // 实例化表单类
+        this.formType = name;
+        this.logger = logger;
+        this.layoutGroup = uiConfig.LayoutTypes[name]; // 如 { button: { source: 'button', param: [...] } }
+    }
+    /**
+     * 设置表单标题
+     * @param {string} newValue - 标题文本
+     */
+    set title(newValue) {
+        if (typeof newValue !== "string") {
+            throw new TypeError('Title must be a string.');
+        }
+        this.form.title(newValue); // 所有表单类都有 .title(string) 方法，文档写的很清楚
+    }
+    /**
+     * 动态添加一个表单布局组件（如按钮、文本等）
+     * @param {Object} opt - 配置项
+     * @param {string} opt.type - 布局类型，如 "button"
+     * @param {Array<any>} opt.param - 对应该布局的参数列表
+     */
+    addLayout(opt) {
+        const { type, param } = opt;
+        const layout = this.layoutGroup?.[type];
+        if (!layout) {
+            throw new TypeError(`Unknown layout type: "${type}".`);
+        }
+        const layoutRun = this.form[layout.source].bind(this.form);
+        if (typeof layoutRun !== "function") {
+            this.logger?.e?.(`Layout source "${layout.source}" is not a function.`);
+            return;
+        }
+        if (!layout.param) {
+            layoutRun(); // 无参数，直接调用
+            return;
+        }
+        const args = [];
+        for (let i = 0; i < layout.param.length; i++) {
+            const paramName = layout.param[i]; // 如 "text"
+            if (typeof paramName !== "string") {
+                this.logger?.w?.(`Layout param name must be string, got ${typeof paramName} at index ${i}.`);
+                continue;
+            }
+            const fieldDef = uiConfig.classic[paramName];
+            const value = param[i];
+            if (!this.#matchCondition(fieldDef, value)) {
+                // 在达到最小参数数时直接退出
+                if (i >= layout.minPar)
+                    continue;
+                this.logger?.w?.(`Param "${paramName}" failed validation.`);
+                continue;
+            }
+            args.push(value);
+        }
+        try {
+            layoutRun(...args); // 调用表单方法并传入校验后的参数
+        }
+        catch (err) {
+            this.logger?.e?.(`Failed to add layout "${type}": ${err}`);
+        }
+    }
+    /**
+     * 校验参数是否符合定义的类型和约束
+     * @private
+     * @param {Object} source - 字段定义，如 { type: "string", regex?: RegExp, count?: [min: number, max: number], ObjectType?: any }
+     * @param {any} msg - 待校验的值
+     * @returns {boolean}
+     */
+    #matchCondition(source, msg) {
+        if (!source)
+            return false;
+        if (typeof msg !== source.type)
+            return false;
+        if (typeof source.regexFunc === "function" &&
+            /* 这里，应该验证函数返回false再拒绝*/
+            !source.regexFunc(msg))
+            return false;
+        switch (source.type) {
+            case "string":
+                if (source.regex && !source.regex.test(msg))
+                    return false;
+                break;
+            case "object":
+                if (source.ObjectType && !utils_1.utils.typeVerify(msg, source.ObjectType))
+                    return false;
+                break;
+            case "number":
+                if (source.count &&
+                    (msg < source.count[0] || msg > source.count[1])) {
+                    return false;
+                }
+                break;
+        }
+        return true;
+    }
+    /**
+     * 显示表单给玩家
+     * @param {@minecraft/server.Player} player - Minecraft 玩家对象
+     * @param {boolean = false} UseBeta - 使用新版 UI 库特性吗，兼容旧版
+     */
+    show(player, UseBeta = false) {
+        return UseBeta ? new show(this.form, player) : this.form.show(player);
+    }
+}
+exports.UI = UI;
+/**
+ * 工厂函数：快速创建 UI 表单实例并初始化标题与布局
+ * @param {Object} logger - 日志对象
+ * @param {string} name - 表单类型，如 "Action"
+ * @param {Object} opt - 配置，含 title 和 layout 数组
+ * @returns {UI} 表单实例
+ */
+const createForm = (logger, name, opt) => {
+    let r_opt = opt;
+    if (typeof opt === "symbol" && regs.has(opt))
+        r_opt = regs.get(opt);
+    function _createForm(name, opt) {
+        const validTypes = uiConfig.FormTypeArr;
+        const err = new TypeError(`createForm must be called with name in [${validTypes.join(", ")}] and valid 'opt'.`);
+        if (!validTypes.includes(name))
+            throw err;
+        if (!opt || !Array.isArray(opt.layout))
+            throw err;
+        const uiForm = new UI(name, logger);
+        uiForm.title = typeof opt.title === "string" ? opt.title : "未设置";
+        for (const item of opt.layout) {
+            uiForm.addLayout(item);
+        }
+        return uiForm;
+    }
+    return _createForm(name, r_opt);
+};
+exports.createForm = createForm;
+const regLayout = (layout) => {
+    if (Array.isArray(layout.regIds)) {
+        for (let item of layout.regIds) {
+            if (typeof item === "string" && layout[item] !== void 0) {
+                regs.set(Symbol(item), layout[item]);
+            }
+        }
+    }
+    return Array.from(regs.keys());
+};
+exports.regLayout = regLayout;

package/lib/modules/gameLib/src/utils.js

@@ -1 +1,122 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.utils=exports.Vector3=void 0;const server_1=require("@minecraft/server"),data_js_1=require("./data.js"),gutils_1=require("gutils");Object.defineProperty(exports,"Vector3",{enumerable:!0,get:function(){return gutils_1.Vector3}});const utils=new class{DataToplayer({dimension:e,id:t,name:r,all:i}={}){let n,o=[];if(!0===i)return server_1.world.getAllPlayers();"string"==typeof r&&(o[0]=r),"number"==typeof t&&(o[1]=t),n=this.dimensionList.includes(e)?server_1.world.getDimension(e).getPlayers():server_1.world.getPlayers();for(let e of n){let t=!0;if(o[0]&&o[0]===e.name&&(t=!1),o[1]&&o[1]===e.id&&(t=!1),t)return e}return n[0]}DateToblock({dimension:e,Location:t}={}){return server_1.world.getDimension(this.dimensionList.includes(e)?e:this.dimensionList[0]).getBlock(t)}playerToData(e){if(!this.isEntityObject(e))throw new TypeError("ERR_NOT_A_Player");return{id:e.id,all:!1}}isEntityObject(e){return!(!typeVerify({id:e.id,name:e.name,dimension:e.dimension,location:e.location},{id:"number",name:"string",dimension:"object",location:"object"})||!e.isValid)}constructor(){this.dimensionList=["overworld","nether","the_end"]}typeVerify(e,t){const r=[];for(let[i,n]of e.entries(e)){const e=t[i];if("string"!=typeof e)throw new TypeError("ERR_INPUT");if(typeof n!==e)r.push(!1);else{if("object"==typeof n&&this.isObject(n)){r.push(!0);continue}r.push(!0)}}return!r.includes(!1)}isObject(e){return"object"==typeof e&&!Array.isArray(e)}isIterator(e){return"function"==typeof e[Symbol.iterator]}getEffect(e){let t=null;const r=Object.keys(data_js_1.EffectList);if("number"==typeof e&&r[e]&&(t=r[e]),"string"==typeof e&&r.includes(e)&&(t=e),null===t)throw new TypeError("ERR no match the EffectName");return t}in(e,t,r){return e>=t&&e<=r}};exports.utils=utils;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.utils = exports.Vector3 = void 0;
+const server_1 = require("@minecraft/server");
+const data_js_1 = require("./data.js");
+const gutils_1 = require("gutils");
+Object.defineProperty(exports, "Vector3", { enumerable: true, get: function () { return gutils_1.Vector3; } });
+const utils = new class {
+    DataToplayer({ dimension, id, name, all } = {}) {
+        let condition = [];
+        let playerList;
+        if (all === true) {
+            return server_1.world.getAllPlayers();
+        }
+        if (typeof name === 'string') {
+            condition[0] = name;
+        }
+        if (typeof id === "number") {
+            condition[1] = id;
+        }
+        if (this.dimensionList.includes(dimension)) {
+            playerList = server_1.world.getDimension(dimension).getPlayers();
+        }
+        else {
+            playerList = server_1.world.getPlayers();
+        }
+        for (let player of playerList) {
+            let isReturn = true;
+            if (condition[0]) {
+                if (condition[0] === player.name) {
+                    isReturn = false;
+                }
+            }
+            if (condition[1]) {
+                if (condition[1] === player.id) {
+                    isReturn = false;
+                }
+            }
+            if (isReturn)
+                return player;
+        }
+        return playerList[0];
+    }
+    DateToblock({ dimension, Location } = {}) {
+        return server_1.world
+            .getDimension(this.dimensionList.includes(dimension) ?
+            dimension :
+            this.dimensionList[0]).getBlock(Location);
+    }
+    playerToData(player) {
+        if (!this.isEntityObject(player)) {
+            throw new TypeError("ERR_NOT_A_Player");
+        }
+        return {
+            id: player.id,
+            all: false
+        };
+    }
+    isEntityObject(player) {
+        if (typeVerify({
+            id: player.id,
+            name: player.name,
+            dimension: player.dimension,
+            location: player.location
+        }, {
+            id: "number",
+            name: "string",
+            dimension: "object",
+            location: "object"
+        }) && player.isValid)
+            return true;
+        return false;
+    }
+    constructor() {
+        this.dimensionList = [
+            'overworld',
+            'nether',
+            'the_end'
+        ];
+    }
+    typeVerify(Object, ObjectSet) {
+        const result = [];
+        for (let [key, data] of Object.entries(Object)) {
+            const type = ObjectSet[key];
+            if (typeof type !== 'string')
+                throw new TypeError('ERR_INPUT');
+            if (typeof data === type) {
+                if (typeof data === 'object') {
+                    if (this.isObject(data)) {
+                        result.push(true);
+                        continue;
+                    }
+                }
+                result.push(true);
+                continue;
+            }
+            result.push(false);
+        }
+        return !result.includes(false);
+    }
+    isObject(Obj) {
+        return (typeof Obj === "object" && !Array.isArray(Obj));
+    }
+    isIterator(obj) {
+        return typeof obj[Symbol.iterator] === "function" ? true : false;
+    }
+    getEffect(name) {
+        let Use_name = null;
+        const Effect = Object.keys(data_js_1.EffectList);
+        if (typeof name === "number" && Effect[name])
+            Use_name = Effect[name];
+        if (typeof name === "string" && Effect.includes(name))
+            Use_name = name;
+        if (Use_name === null)
+            throw new TypeError("ERR no match the EffectName");
+        return Use_name;
+    }
+    in(num, min, max) {
+        return (num >= min && num <= max);
+    }
+};
+exports.utils = utils;

package/lib/modules/gutils/src/index.js

@@ -1 +1,22 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.Vector3=void 0;class Vector3{constructor(e,o,r,t){const c=e||0,s=o||0,d=r||0;return{dis:"object"==typeof t?t.id||"overworld":["overworld","nether","the_end"].includes(t)?t:null,x:c,y:s,z:d}}}exports.Vector3=Vector3;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Vector3 = void 0;
+class Vector3 {
+    constructor(x1, y1, z1, dimension) {
+        const x = x1 || 0;
+        const y = y1 || 0;
+        const z = z1 || 0;
+        const dis = typeof dimension === "object" ? (dimension.id || "overworld") : ([
+            'overworld',
+            'nether',
+            'the_end'
+        ].includes(dimension) ? dimension : null);
+        return {
+            dis,
+            x,
+            y,
+            z
+        };
+    }
+}
+exports.Vector3 = Vector3;

package/lib/runTemp/File.js

@@ -1 +1,54 @@
-"use strict";var __importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const promises_1=__importDefault(require("node:fs/promises")),node_path_1=__importDefault(require("node:path"));class FileMethod{dir="";#e(e){return node_path_1.default.join(this.dir,e)}async mkdir(e){try{return await promises_1.default.mkdir(this.#e(e),{recursive:!0}),!0}catch{return!1}}async rm(e){try{return await promises_1.default.rm(this.#e(e),{recursive:!0,force:!0}),!0}catch(e){return!1}}async writeFile(e,r){try{return await promises_1.default.writeFile(this.#e(e),r),!0}catch(e){return!1}}readFile(e){return promises_1.default.readFile(this.#e(e))}async readdir(e){return await promises_1.default.readdir(this.#e(e))}}exports.default=FileMethod;
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+// 用于给 Temp 提供不需要导入 fs 的小支持
+// 一些时候直接 Temp.dir 作为目录完事
+class FileMethod {
+    dir = "";
+    #getDir(Dir) {
+        return node_path_1.default.join(this.dir, Dir);
+    }
+    async mkdir(DirName) {
+        try {
+            await promises_1.default.mkdir(this.#getDir(DirName), {
+                recursive: true
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async rm(File) {
+        try {
+            await promises_1.default.rm(this.#getDir(File), {
+                recursive: true,
+                force: true
+            });
+            return true;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    async writeFile(File, content) {
+        try {
+            await promises_1.default.writeFile(this.#getDir(File), content);
+            return true;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    readFile(File) {
+        return promises_1.default.readFile(this.#getDir(File));
+    }
+    async readdir(Dir) {
+        return await promises_1.default.readdir(this.#getDir(Dir));
+    }
+}
+exports.default = FileMethod;

package/lib/runTemp/index.js

@@ -1 +1,137 @@
-"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,i,r){void 0===r&&(r=i);var a=Object.getOwnPropertyDescriptor(t,i);a&&!("get"in a?!t.__esModule:a.writable||a.configurable)||(a={enumerable:!0,get:function(){return t[i]}}),Object.defineProperty(e,r,a)}:function(e,t,i,r){void 0===r&&(r=i),e[r]=t[i]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),__importStar=this&&this.__importStar||function(){var e=function(t){return e=Object.getOwnPropertyNames||function(e){var t=[];for(var i in e)Object.prototype.hasOwnProperty.call(e,i)&&(t[t.length]=i);return t},e(t)};return function(t){if(t&&t.__esModule)return t;var i={};if(null!=t)for(var r=e(t),a=0;a<r.length;a++)"default"!==r[a]&&__createBinding(i,t,r[a]);return __setModuleDefault(i,t),i}}(),__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const promises_1=__importDefault(require("node:fs/promises")),path_1=__importDefault(require("path")),utils=__importStar(require("./../utils/index.js")),index_js_1=__importDefault(require("./../loger/index.js")),index_js_2=__importDefault(require("./../uuid/index.js")),File_js_1=__importDefault(require("./File.js")),{MAX:MAX,CACHE_DESC:CACHE_DESC}=require("./config.json");class Temp extends File_js_1.default{static type="singleton class";dir="";cacheDesc="";timdir;tempId=null;constructor(e){super(),this.timdir=e}async#e(e){await utils.FileExsit(e)||promises_1.default.mkdir(e)}async init(){await this.#e(this.timdir),this.cacheDesc=path_1.default.join(this.timdir,CACHE_DESC),this.tempId=index_js_2.default.uuid(),await utils.FileExsit(this.cacheDesc)||await promises_1.default.writeFile(this.cacheDesc,JSON.stringify({LNnum:1}),"utf-8");const e=this.wait();let t=await e.next();for(;!t.done&&!1===t.value;)index_js_1.default.i("temp","等待中..."),await utils.sleep(1e3),t=await e.next();const i=t.value;if("boolean"==typeof i)throw new TypeError("[read generator]");const r=path_1.default.join(this.timdir,this.tempId);await promises_1.default.writeFile(this.cacheDesc,JSON.stringify({LNnum:("number"==typeof i.LNnum?i.LNnum:1)+1}),"utf-8"),await promises_1.default.mkdir(r,{recursive:!0}),this.dir=r,Object.defineProperty(this,"cacheDesc",{enumerable:!1,writable:!1})}async*wait(){for(;;){const e=JSON.parse((await promises_1.default.readFile(this.cacheDesc)).toString());if("number"!=typeof e.LNnum)throw new Error("[temp error]: cannot load config");if((e?.LNnum??1)<=MAX)return e;index_js_1.default.i("TEMP","INFO: CONCURRENCY >= MAX_CONCURRENCY",{MAX_CONCURRENCY:MAX}),yield!1,await utils.sleep(1e3)}}async remove(){if(null===this.tempId||""===this.dir)throw new Error("Please call init() first before calling remove().");try{await promises_1.default.rm(this.dir,{recursive:!0,force:!0});const e=JSON.parse(await promises_1.default.readFile(this.cacheDesc,"utf-8")),t=Math.max((e?.LNnum||1)-1,0);await promises_1.default.writeFile(this.cacheDesc,JSON.stringify({LNnum:t}),"utf-8")}catch(e){index_js_1.default.e("TEMP","Error during temp dir removal:",e)}finally{this.dir="",this.tempId=null}}}exports.default=Temp;
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = __importDefault(require("node:fs/promises"));
+const path_1 = __importDefault(require("path"));
+const utils = __importStar(require("./../utils/index.js"));
+const index_js_1 = __importDefault(require("./../loger/index.js"));
+const index_js_2 = __importDefault(require("./../uuid/index.js"));
+const File_js_1 = __importDefault(require("./File.js"));
+// 使用 require 导入 JSON 配置（兼容 CommonJS）
+const { MAX, CACHE_DESC } = require('./config.json');
+// 临时存储类（单例模式）
+class Temp extends File_js_1.default {
+    static type = 'singleton class';
+    // 当前临时目录路径
+    dir = '';
+    // 缓存描述文件路径
+    cacheDesc = "";
+    // 私有：临时目录路径
+    timdir;
+    // 私有：当前临时实例 ID
+    tempId = null;
+    constructor(tempDir) {
+        super();
+        this.timdir = tempDir;
+    }
+    // 私有方法：检查目录是否存在
+    async #checkDir(dirPath) {
+        const exists = await utils.FileExsit(dirPath);
+        if (!exists) {
+            promises_1.default.mkdir(dirPath);
+        }
+    }
+    // 初始化临时目录
+    async init() {
+        await this.#checkDir(this.timdir);
+        this.cacheDesc = path_1.default.join(this.timdir, CACHE_DESC);
+        this.tempId = index_js_2.default.uuid(); // 生成唯一 ID，假设 uuid.uuid() 返回 string
+        // 如果缓存文件不存在，则初始化
+        if (!(await utils.FileExsit(this.cacheDesc))) {
+            await promises_1.default.writeFile(this.cacheDesc, JSON.stringify({ LNnum: 1 }), 'utf-8');
+        }
+        const waitGen = this.wait(); // AsyncGenerator<boolean, any, unknown>
+        let result = await waitGen.next();
+        while (!result.done && result.value === false) {
+            index_js_1.default.i('temp', '等待中...');
+            await utils.sleep(1000);
+            result = await waitGen.next();
+        }
+        const data = result.value;
+        if (typeof data == "boolean")
+            throw new TypeError("[read generator]");
+        const instanceDir = path_1.default.join(this.timdir, this.tempId);
+        await promises_1.default.writeFile(this.cacheDesc, JSON.stringify({ LNnum: (typeof data.LNnum == "number" ? data.LNnum : 1) + 1 }), 'utf-8');
+        await promises_1.default.mkdir(instanceDir, { recursive: true });
+        this.dir = instanceDir;
+        // 设为不可枚举 & 不可写
+        Object.defineProperty(this, 'cacheDesc', {
+            enumerable: false,
+            writable: false,
+        });
+    }
+    // 等待并发数低于最大值，返回一个异步生成器
+    async *wait() {
+        while (true) {
+            const data = JSON.parse((await promises_1.default.readFile(this.cacheDesc)).toString());
+            if (typeof data.LNnum !== "number")
+                throw new Error("[temp error]: cannot load config");
+            const currentLnNum = data?.LNnum ?? 1;
+            if (currentLnNum <= MAX) {
+                return data;
+            }
+            index_js_1.default.i('TEMP', 'INFO: CONCURRENCY >= MAX_CONCURRENCY', {
+                MAX_CONCURRENCY: MAX,
+            });
+            yield false;
+            await utils.sleep(1000);
+        }
+    }
+    // 清理临时目录
+    async remove() {
+        if (this.tempId === null || this.dir === '') {
+            throw new Error(`Please call init() first before calling remove().`);
+        }
+        try {
+            await promises_1.default.rm(this.dir, { recursive: true, force: true });
+            const data = JSON.parse(await promises_1.default.readFile(this.cacheDesc, "utf-8"));
+            const newCount = Math.max((data?.LNnum || 1) - 1, 0);
+            await promises_1.default.writeFile(this.cacheDesc, JSON.stringify({ LNnum: newCount }), 'utf-8');
+        }
+        catch (err) {
+            index_js_1.default.e('TEMP', 'Error during temp dir removal:', err);
+        }
+        finally {
+            // 重置状态
+            this.dir = '';
+            this.tempId = null;
+        }
+    }
+}
+// 导出默认类
+exports.default = Temp;

package/lib/runTemp/securityFile.js

@@ -1 +1,93 @@
-"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(t,e,r,i){void 0===i&&(i=r);var n=Object.getOwnPropertyDescriptor(e,r);n&&!("get"in n?!e.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return e[r]}}),Object.defineProperty(t,i,n)}:function(t,e,r,i){void 0===i&&(i=r),t[i]=e[r]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}:function(t,e){t.default=e}),__importStar=this&&this.__importStar||function(){var t=function(e){return t=Object.getOwnPropertyNames||function(t){var e=[];for(var r in t)Object.prototype.hasOwnProperty.call(t,r)&&(e[e.length]=r);return e},t(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(null!=e)for(var i=t(e),n=0;n<i.length;n++)"default"!==i[n]&&__createBinding(r,e,i[n]);return __setModuleDefault(r,e),r}}(),__importDefault=this&&this.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0});const promises_1=__importDefault(require("fs/promises")),utils=__importStar(require("../utils/index.js"));class SecurityFile{#t=null;constructor(t){this.#t=t}#e(t){const e=utils.join(this.#t,t);if(!e.startsWith(this.#t))throw new Error("[Mbler security] Don't into Parent Directory");return e}async mkdir(t){try{return await promises_1.default.mkdir(this.#e(t),{recursive:!0}),!0}catch{return!1}}async rm(t){try{return await promises_1.default.rm(this.#e(t),{recursive:!0,force:!0}),!0}catch(t){return!1}}async writeFile(t,e){try{return await promises_1.default.writeFile(this.#e(t),e,{encoding:"utf-8"}),!0}catch(t){return!1}}async readFile(t,e){return await utils.readFile(this.#e(t),e)}async readdir(t){return await promises_1.default.readdir(this.#e(t))}}exports.default=SecurityFile;
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = __importDefault(require("fs/promises"));
+const utils = __importStar(require("../utils/index.js"));
+class SecurityFile {
+    #dir = null;
+    constructor(dir) {
+        this.#dir = dir;
+    }
+    #getDir(d) {
+        const dir = utils.join(this.#dir, d);
+        if (!dir.startsWith(this.#dir))
+            throw new Error("[Mbler security] Don't into Parent Directory");
+        return dir;
+    }
+    async mkdir(DirName) {
+        try {
+            await promises_1.default.mkdir(this.#getDir(DirName), {
+                recursive: true
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async rm(File) {
+        try {
+            await promises_1.default.rm(this.#getDir(File), {
+                recursive: true,
+                force: true
+            });
+            return true;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    async writeFile(File, content) {
+        try {
+            await promises_1.default.writeFile(this.#getDir(File), content, {
+                encoding: 'utf-8'
+            });
+            return true;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    async readFile(File, opt) {
+        return await utils.readFile(this.#getDir(File), opt);
+    }
+    async readdir(Dir) {
+        return await promises_1.default.readdir(this.#getDir(Dir));
+    }
+}
+exports.default = SecurityFile;

package/lib/start/addPack.js

@@ -1 +1,3 @@
-"use strict";const index_js_1=require("./../module-handler/index.js");module.exports=index_js_1.addPack;
+"use strict";
+const index_js_1 = require("./../module-handler/index.js");
+module.exports = index_js_1.addPack;