@mptool/shared

@mptool 各包共用的基础工具。多数场景下你不需要直接安装它（@mptool/all / @mptool/skyline 已经 re-export 了常用成员），需要单独使用时可以安装：

npm i @mptool/shared

内容

导出	说明
Emitter	类型安全的事件触发器
logger (debug / info / warn / error / filter)	统一日志，按 env 适配小程序与 Node.js
query (parse / stringify / join)	query string 解析与拼接
env	当前运行环境："wx" / "donut" / "js"
MpError	带错误码（code）与 message 的错误类型，网络与文件包统一抛出它
type / isFunction	类型判断工具
wrapFunction	包装函数并保留 this / 返回值
lock / once	防重入锁与只执行一次
Queue / funcQueue / createQueue	串行任务队列
encodeBase64 / decodeBase64	ArrayBuffer 与 base64 互转

使用

import { MpError, logger, query } from "@mptool/shared";

logger.warn("something happened");

const queries = query.parse("a=1&b=2"); // { a: "1", b: "2" }

// 构造函数只接受一个对象参数：{ message?, code? }
throw new MpError({ message: "request failed", code: 1001 });

提示

@mptool/shared 只导出 Emitter 工厂；框架内部使用的全局事件总线 userEmitter 由 @mptool/enhance / @mptool/skyline-enhance 以 emitter 的名称导出，需要跨页面/组件通信时从这两个包引入。

提示

这些工具的实现会随包发布，但稳定的公共 API 以各功能包（api / net / file / parser 等）为准；直接依赖 @mptool/shared 的内部结构（如 Stream、编码表）不在兼容性承诺内。