@wevu/api 0.1.0 → 0.1.1

package/README.md

@@ -11,6 +11,51 @@
 - Promise 风格优先，回调风格可用
 - 支持显式注入平台适配器
 
+## 类型对齐与平台支持
+
+`@wevu/api` 的默认导出 `wpi` 会同时对齐：
+
+- 微信类型：`miniprogram-api-typings`
+- 支付宝类型：`@mini-types/alipay`
+- 抖音类型：`@douyin-microapp/typings`
+
+<!-- prettier-ignore-start -->
+<!-- @generated weapi-support-matrix:start -->
+### 平台类型对齐矩阵
+
+| 平台 | 全局对象 | 类型来源 | 支持度 |
+| --- | --- | --- | --- |
+| 微信小程序 | `wx` | `miniprogram-api-typings` | ✅ 全量 |
+| 支付宝小程序 | `my` | `@mini-types/alipay` | ✅ 全量 |
+| 抖音小程序 | `tt` | `@douyin-microapp/typings` | ✅ 全量 |
+| 其他平台（swan/jd/xhs 等） | 运行时宿主对象 | 运行时透传 | ⚠️ 按宿主能力支持 |
+
+### API 支持覆盖率报告
+
+| 平台 | 已支持 API 数 | API 总数 | 覆盖率 |
+| --- | --- | --- | --- |
+| 微信小程序 (`wx`) | 8 | 8 | 100.00% |
+| 支付宝小程序 (`my`) | 8 | 8 | 100.00% |
+| 抖音小程序 (`tt`) | 8 | 8 | 100.00% |
+| 三端完全对齐 (wx/my/tt) | 8 | 8 | 100.00% |
+
+> 该报告由 `WEAPI_METHOD_SUPPORT_MATRIX` 与映射规则自动计算生成。
+
+### 核心跨端映射矩阵
+
+| API | 说明 | 微信策略 | 支付宝策略 | 抖音策略 | 支持度 |
+| --- | --- | --- | --- | --- | --- |
+| `showToast` | 显示消息提示框。 | 直连 `wx.showToast` | `title/icon` 映射到 `content/type` 后调用 `my.showToast` | `icon=error` 映射为 `fail` 后调用 `tt.showToast` | ✅ |
+| `showLoading` | 显示 loading 提示框。 | 直连 `wx.showLoading` | `title` 映射到 `content` 后调用 `my.showLoading` | 直连 `tt.showLoading` | ✅ |
+| `showActionSheet` | 显示操作菜单。 | 直连 `wx.showActionSheet` | `itemList` ↔ `items`、`index` ↔ `tapIndex` 双向对齐 | 直连 `tt.showActionSheet`，并兼容 `index` → `tapIndex` | ✅ |
+| `showModal` | 显示模态弹窗。 | 直连 `wx.showModal` | 调用 `my.confirm` 并对齐按钮字段与 `cancel` 结果 | 直连 `tt.showModal` | ✅ |
+| `chooseImage` | 选择图片。 | 直连 `wx.chooseImage` | 返回值 `apFilePaths` 映射到 `tempFilePaths` | `tempFilePaths` 字符串转数组，缺失时从 `tempFiles.path` 兜底 | ✅ |
+| `saveFile` | 保存文件。 | 直连 `wx.saveFile` | 请求参数 `tempFilePath` ↔ `apFilePath`、结果映射为 `savedFilePath` | 直连 `tt.saveFile`，并在缺失时用 `filePath` 兜底 `savedFilePath` | ✅ |
+| `setClipboardData` | 设置剪贴板内容。 | 直连 `wx.setClipboardData` | 转调 `my.setClipboard` 并映射 `data` → `text` | 直连 `tt.setClipboardData` | ✅ |
+| `getClipboardData` | 获取剪贴板内容。 | 直连 `wx.getClipboardData` | 转调 `my.getClipboard` 并映射 `text` → `data` | 直连 `tt.getClipboardData` | ✅ |
+<!-- @generated weapi-support-matrix:end -->
+<!-- prettier-ignore-end -->
+
 ## 安装
 
 ```bash

package/dist/index.cjs

@@ -96,6 +96,243 @@ function createNotSupportedError(methodName, platform) {
 	return { errMsg: `${platform ? `${platform}.${methodName}` : methodName}:fail method not supported` };
 }
 
+//#endregion
+//#region src/core/methodMapping.ts
+const PLATFORM_ALIASES$1 = {
+	alipay: "my",
+	douyin: "tt"
+};
+function mapToastType(type) {
+	if (type === "error") return "fail";
+	if (type === "loading") return "none";
+	return type;
+}
+function mapToastArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "content") && Object.prototype.hasOwnProperty.call(nextOptions, "title")) nextOptions.content = nextOptions.title;
+	if (Object.prototype.hasOwnProperty.call(nextOptions, "icon")) nextOptions.type = mapToastType(nextOptions.icon);
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapDouyinToastArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (nextOptions.icon === "error") nextOptions.icon = "fail";
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapLoadingArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "content") && Object.prototype.hasOwnProperty.call(nextOptions, "title")) nextOptions.content = nextOptions.title;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapActionSheetArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "items") && Array.isArray(nextOptions.itemList)) nextOptions.items = nextOptions.itemList;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapActionSheetResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "tapIndex") && Object.prototype.hasOwnProperty.call(result, "index")) return {
+		...result,
+		tapIndex: result.index
+	};
+	return result;
+}
+function mapModalArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "confirmButtonText") && Object.prototype.hasOwnProperty.call(nextOptions, "confirmText")) nextOptions.confirmButtonText = nextOptions.confirmText;
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "cancelButtonText") && Object.prototype.hasOwnProperty.call(nextOptions, "cancelText")) nextOptions.cancelButtonText = nextOptions.cancelText;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapModalResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "cancel") && Object.prototype.hasOwnProperty.call(result, "confirm")) return {
+		...result,
+		cancel: !result.confirm
+	};
+	return result;
+}
+function mapChooseImageResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "tempFilePaths") && Array.isArray(result.apFilePaths)) return {
+		...result,
+		tempFilePaths: result.apFilePaths
+	};
+	return result;
+}
+function mapDouyinChooseImageResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (typeof result.tempFilePaths === "string") return {
+		...result,
+		tempFilePaths: [result.tempFilePaths]
+	};
+	if (!Array.isArray(result.tempFilePaths) && Array.isArray(result.tempFiles)) {
+		const fallbackPaths = result.tempFiles.map((item) => {
+			if (!isPlainObject(item)) return;
+			const path = item.path;
+			if (typeof path === "string" && path) return path;
+			const filePath = item.filePath;
+			if (typeof filePath === "string" && filePath) return filePath;
+		}).filter((item) => typeof item === "string");
+		if (fallbackPaths.length > 0) return {
+			...result,
+			tempFilePaths: fallbackPaths
+		};
+	}
+	return result;
+}
+function mapSaveFileArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "apFilePath") && Object.prototype.hasOwnProperty.call(nextOptions, "tempFilePath")) nextOptions.apFilePath = nextOptions.tempFilePath;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapSaveFileResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "savedFilePath") && Object.prototype.hasOwnProperty.call(result, "apFilePath")) return {
+		...result,
+		savedFilePath: result.apFilePath
+	};
+	return result;
+}
+function mapDouyinSaveFileResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "savedFilePath") && Object.prototype.hasOwnProperty.call(result, "filePath")) return {
+		...result,
+		savedFilePath: result.filePath
+	};
+	return result;
+}
+function normalizePlatformName$1(value) {
+	if (!value) return;
+	const normalized = value.trim().toLowerCase();
+	if (!normalized) return;
+	return PLATFORM_ALIASES$1[normalized] ?? normalized;
+}
+function mapSetClipboardArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "text") && Object.prototype.hasOwnProperty.call(nextOptions, "data")) nextOptions.text = nextOptions.data;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapClipboardResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "data") && Object.prototype.hasOwnProperty.call(result, "text")) return {
+		...result,
+		data: result.text
+	};
+	return result;
+}
+const METHOD_MAPPINGS = {
+	my: {
+		showToast: {
+			target: "showToast",
+			mapArgs: mapToastArgs
+		},
+		showLoading: {
+			target: "showLoading",
+			mapArgs: mapLoadingArgs
+		},
+		showActionSheet: {
+			target: "showActionSheet",
+			mapArgs: mapActionSheetArgs,
+			mapResult: mapActionSheetResult
+		},
+		showModal: {
+			target: "confirm",
+			mapArgs: mapModalArgs,
+			mapResult: mapModalResult
+		},
+		chooseImage: {
+			target: "chooseImage",
+			mapResult: mapChooseImageResult
+		},
+		saveFile: {
+			target: "saveFile",
+			mapArgs: mapSaveFileArgs,
+			mapResult: mapSaveFileResult
+		},
+		setClipboardData: {
+			target: "setClipboard",
+			mapArgs: mapSetClipboardArgs
+		},
+		getClipboardData: {
+			target: "getClipboard",
+			mapResult: mapClipboardResult
+		}
+	},
+	tt: {
+		showToast: {
+			target: "showToast",
+			mapArgs: mapDouyinToastArgs
+		},
+		showLoading: { target: "showLoading" },
+		showActionSheet: {
+			target: "showActionSheet",
+			mapResult: mapActionSheetResult
+		},
+		showModal: { target: "showModal" },
+		chooseImage: {
+			target: "chooseImage",
+			mapResult: mapDouyinChooseImageResult
+		},
+		saveFile: {
+			target: "saveFile",
+			mapResult: mapDouyinSaveFileResult
+		},
+		setClipboardData: { target: "setClipboardData" },
+		getClipboardData: { target: "getClipboardData" }
+	}
+};
+/**
+* @description 解析平台 API 映射规则
+*/
+function resolveMethodMapping(platform, methodName) {
+	const normalizedPlatform = normalizePlatformName$1(platform);
+	if (!normalizedPlatform) return;
+	const platformMappings = METHOD_MAPPINGS[normalizedPlatform];
+	if (!platformMappings) return;
+	return platformMappings[methodName];
+}
+
 //#endregion
 //#region src/core/createWeapi.ts
 const INTERNAL_KEYS = new Set([
@@ -104,8 +341,15 @@ const INTERNAL_KEYS = new Set([
 	"platform",
 	"raw"
 ]);
+const PLATFORM_ALIASES = {
+	alipay: "my",
+	douyin: "tt"
+};
 function normalizePlatformName(value) {
-	return value || void 0;
+	if (!value) return;
+	const normalized = value.trim().toLowerCase();
+	if (!normalized) return;
+	return PLATFORM_ALIASES[normalized] ?? normalized;
 }
 function resolveOptionsArg(args) {
 	const nextArgs = args.slice();
@@ -125,20 +369,20 @@ function resolveOptionsArg(args) {
 		options
 	};
 }
-function callWithPromise(context, method, args) {
+function callWithPromise(context, method, args, mapResult) {
 	return new Promise((resolve, reject) => {
 		const { args: nextArgs, options } = resolveOptionsArg(args);
 		let settled = false;
 		options.success = (res) => {
 			settled = true;
-			resolve(res);
+			resolve(mapResult ? mapResult(res) : res);
 		};
 		options.fail = (err) => {
 			settled = true;
 			reject(err);
 		};
 		options.complete = (res) => {
-			if (!settled) resolve(res);
+			if (!settled) resolve(mapResult ? mapResult(res) : res);
 		};
 		try {
 			method.apply(context, nextArgs);
@@ -201,7 +445,8 @@ function createWeapi(options = {}) {
 			if (typeof prop !== "string") return;
 			return (...args) => callMissingApi(prop, getPlatform(), args);
 		}
-		const value = currentAdapter[prop];
+		const platform = getPlatform();
+		const value = currentAdapter[(typeof prop === "string" ? resolveMethodMapping(platform, prop) : void 0)?.target ?? prop];
 		if (typeof value !== "function") {
 			if (value === void 0 && typeof prop === "string") {
 				const missing = (...args) => callMissingApi(prop, getPlatform(), args);
@@ -213,11 +458,32 @@ function createWeapi(options = {}) {
 		}
 		const wrapped = (...args) => {
 			const runtimeAdapter = resolveAdapter();
-			const runtimeMethod = runtimeAdapter ? runtimeAdapter[prop] : void 0;
+			const mappingRule = resolveMethodMapping(getPlatform(), prop);
+			const methodName = mappingRule?.target ?? prop;
+			const runtimeMethod = runtimeAdapter ? runtimeAdapter[methodName] : void 0;
+			const runtimeArgs = mappingRule?.mapArgs ? mappingRule.mapArgs(args) : args;
 			if (typeof runtimeMethod !== "function") return callMissingApi(prop, getPlatform(), args);
-			if (shouldSkipPromise(prop)) return runtimeMethod.apply(runtimeAdapter, args);
-			if (hasCallbacks(args.length > 0 ? args[args.length - 1] : void 0)) return runtimeMethod.apply(runtimeAdapter, args);
-			return callWithPromise(runtimeAdapter, runtimeMethod, args);
+			if (shouldSkipPromise(prop)) {
+				const result = runtimeMethod.apply(runtimeAdapter, runtimeArgs);
+				return mappingRule?.mapResult ? mappingRule.mapResult(result) : result;
+			}
+			const lastArg = runtimeArgs.length > 0 ? runtimeArgs[runtimeArgs.length - 1] : void 0;
+			if (hasCallbacks(lastArg)) {
+				if (mappingRule?.mapResult && isPlainObject(lastArg)) {
+					const options = lastArg;
+					const originalSuccess = options.success;
+					const originalComplete = options.complete;
+					options.success = (res) => {
+						originalSuccess?.(mappingRule.mapResult(res));
+					};
+					options.complete = (res) => {
+						originalComplete?.(mappingRule.mapResult(res));
+					};
+				}
+				const result = runtimeMethod.apply(runtimeAdapter, runtimeArgs);
+				return mappingRule?.mapResult ? mappingRule.mapResult(result) : result;
+			}
+			return callWithPromise(runtimeAdapter, runtimeMethod, runtimeArgs, mappingRule?.mapResult);
 		};
 		cache.set(prop, wrapped);
 		return wrapped;
@@ -228,6 +494,15 @@ function createWeapi(options = {}) {
 //#region src/index.ts
 /**
 * @description 默认跨平台 API 实例（推荐使用）
+*
+* @generated weapi-platform-matrix:start
+* | 平台 | 类型来源 | 支持度 |
+* | --- | --- | --- |
+* | 微信小程序 (`wx`) | `miniprogram-api-typings` | ✅ 全量 |
+* | 支付宝小程序 (`my`) | `@mini-types/alipay` | ✅ 全量 |
+* | 抖音小程序 (`tt`) | `@douyin-microapp/typings` | ✅ 全量 |
+* | 其他平台对象 (`swan/jd/xhs/...`) | 运行时对象透传 | ⚠️ 按宿主能力支持 |
+* @generated weapi-platform-matrix:end
 */
 const wpi = createWeapi();
 

package/dist/index.d.cts

@@ -4,6 +4,28 @@ type WeapiAdapter = Record<string, any>;
  * @description 微信小程序 API 原始适配器类型
  */
 type WeapiWxRawAdapter = WechatMiniprogram.Wx;
+/**
+ * @description 支付宝小程序 API 原始适配器类型
+ */
+type WeapiAlipayRawAdapter = typeof my;
+/**
+ * @description 抖音小程序 API 原始适配器类型
+ */
+type WeapiDouyinRawAdapter = typeof tt;
+type MergeAdapters<Primary extends WeapiAdapter, Secondary extends WeapiAdapter> = Primary & Omit<Secondary, keyof Primary>;
+/**
+ * @description weapi 对齐后的跨平台原始 API 类型
+ *
+ * @generated weapi-platform-matrix:start
+ * | 平台 | 全局对象 | 类型来源 | 对齐状态 |
+ * | --- | --- | --- | --- |
+ * | 微信小程序 | `wx` | `miniprogram-api-typings` | ✅ 全量 |
+ * | 支付宝小程序 | `my` | `@mini-types/alipay` | ✅ 全量 |
+ * | 抖音小程序 | `tt` | `@douyin-microapp/typings` | ✅ 全量 |
+ * | 其他平台（swan/jd/xhs 等） | 运行时宿主对象 | 运行时透传 | ⚠️ 按宿主能力支持 |
+ * @generated weapi-platform-matrix:end
+ */
+type WeapiCrossPlatformRawAdapter = MergeAdapters<MergeAdapters<WeapiWxRawAdapter, WeapiAlipayRawAdapter>, WeapiDouyinRawAdapter>;
 type HasCallbackKey<T> = T extends object ? 'success' extends keyof T ? true : 'fail' extends keyof T ? true : 'complete' extends keyof T ? true : false : false;
 type HasCallbackOption<T> = T extends {
   success: unknown;
@@ -21,13 +43,112 @@ type PromisifyOptionMethod<Prefix extends any[], Option extends object, Result,
 } : {
   <TOption extends Option>(...args: [...Prefix, TOption]): HasCallbackOption<TOption> extends true ? Result : Promise<ExtractSuccessResult<Option>>;
 };
-type PromisifyMethod<TMethod> = TMethod extends ((...args: infer Args) => infer Result) ? Args extends [] ? (...args: Args) => Promise<Result> : Args extends [...infer Prefix, infer Last] ? true extends HasCallbackKey<NonNullable<Last>> ? PromisifyOptionMethod<Prefix, NonNullable<Last>, Result, undefined extends Last ? true : false> : (...args: Args) => Promise<Result> : (...args: Args) => Promise<Result> : TMethod;
+type NormalizePromisifyReturn<T> = T extends Promise<any> ? T : Promise<T>;
+type PromisifyMethod<TMethod> = TMethod extends ((...args: infer Args) => infer Result) ? Args extends [] ? (...args: Args) => NormalizePromisifyReturn<Result> : Args extends [...infer Prefix, infer Last] ? true extends HasCallbackKey<NonNullable<Last>> ? PromisifyOptionMethod<Prefix, NonNullable<Last>, Result, undefined extends Last ? true : false> : (...args: Args) => NormalizePromisifyReturn<Result> : (...args: Args) => NormalizePromisifyReturn<Result> : TMethod;
 type WeapiPromisify<TAdapter extends WeapiAdapter> = { [Key in keyof TAdapter]: Key extends string ? Key extends `${string}Sync` ? TAdapter[Key] : Key extends `on${Capitalize<string>}` | `off${Capitalize<string>}` ? TAdapter[Key] : PromisifyMethod<TAdapter[Key]> : TAdapter[Key] };
 /**
  * @description 微信小程序 API 适配器类型
  */
 type WeapiWxAdapter = WeapiPromisify<WeapiWxRawAdapter>;
-interface CreateWeapiOptions<TAdapter extends WeapiAdapter = WeapiWxRawAdapter> {
+/**
+ * @description 支付宝小程序 API 适配器类型
+ */
+type WeapiAlipayAdapter = WeapiPromisify<WeapiAlipayRawAdapter>;
+/**
+ * @description 抖音小程序 API 适配器类型
+ */
+type WeapiDouyinAdapter = WeapiPromisify<WeapiDouyinRawAdapter>;
+/**
+ * @description weapi 默认导出的跨平台 API 适配器类型
+ */
+type WeapiCrossPlatformAdapter = WeapiPromisify<WeapiCrossPlatformRawAdapter>;
+/**
+ * @description weapi 核心映射 API 的平台支持度说明
+ */
+interface WeapiCrossPlatformMethodDocs {
+  /**
+   * 显示消息提示框。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showToast` | ✅ |
+   * | 支付宝 | `title/icon` 映射到 `content/type` 后调用 `my.showToast` | ✅ |
+   * | 抖音 | `icon=error` 映射为 `fail` 后调用 `tt.showToast` | ✅ |
+   */
+  showToast: WeapiCrossPlatformAdapter['showToast'];
+  /**
+   * 显示 loading 提示框。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showLoading` | ✅ |
+   * | 支付宝 | `title` 映射到 `content` 后调用 `my.showLoading` | ✅ |
+   * | 抖音 | 直连 `tt.showLoading` | ✅ |
+   */
+  showLoading: WeapiCrossPlatformAdapter['showLoading'];
+  /**
+   * 显示操作菜单。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showActionSheet` | ✅ |
+   * | 支付宝 | `itemList` ↔ `items`、`index` ↔ `tapIndex` 双向对齐 | ✅ |
+   * | 抖音 | 直连 `tt.showActionSheet`，并兼容 `index` → `tapIndex` | ✅ |
+   */
+  showActionSheet: WeapiCrossPlatformAdapter['showActionSheet'];
+  /**
+   * 显示模态弹窗。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showModal` | ✅ |
+   * | 支付宝 | 调用 `my.confirm` 并对齐按钮字段与 `cancel` 结果 | ✅ |
+   * | 抖音 | 直连 `tt.showModal` | ✅ |
+   */
+  showModal: WeapiCrossPlatformAdapter['showModal'];
+  /**
+   * 选择图片。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.chooseImage` | ✅ |
+   * | 支付宝 | 返回值 `apFilePaths` 映射到 `tempFilePaths` | ✅ |
+   * | 抖音 | `tempFilePaths` 字符串转数组，缺失时从 `tempFiles.path` 兜底 | ✅ |
+   */
+  chooseImage: WeapiCrossPlatformAdapter['chooseImage'];
+  /**
+   * 保存文件。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.saveFile` | ✅ |
+   * | 支付宝 | 请求参数 `tempFilePath` ↔ `apFilePath`、结果映射为 `savedFilePath` | ✅ |
+   * | 抖音 | 直连 `tt.saveFile`，并在缺失时用 `filePath` 兜底 `savedFilePath` | ✅ |
+   */
+  saveFile: WeapiCrossPlatformAdapter['saveFile'];
+  /**
+   * 设置剪贴板内容。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.setClipboardData` | ✅ |
+   * | 支付宝 | 转调 `my.setClipboard` 并映射 `data` → `text` | ✅ |
+   * | 抖音 | 直连 `tt.setClipboardData` | ✅ |
+   */
+  setClipboardData: WeapiCrossPlatformAdapter['setClipboardData'];
+  /**
+   * 获取剪贴板内容。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.getClipboardData` | ✅ |
+   * | 支付宝 | 转调 `my.getClipboard` 并映射 `text` → `data` | ✅ |
+   * | 抖音 | 直连 `tt.getClipboardData` | ✅ |
+   */
+  getClipboardData: WeapiCrossPlatformAdapter['getClipboardData'];
+}
+type WeapiMethodDocOverlay<TAdapter extends WeapiAdapter> = TAdapter extends WeapiCrossPlatformRawAdapter ? WeapiCrossPlatformMethodDocs : object;
+interface CreateWeapiOptions<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter> {
   /**
    * @description 手动指定平台适配器（优先级高于自动探测）
    */
@@ -37,7 +158,7 @@ interface CreateWeapiOptions<TAdapter extends WeapiAdapter = WeapiWxRawAdapter>
    */
   platform?: string;
 }
-type WeapiInstance<TAdapter extends WeapiAdapter = WeapiWxRawAdapter> = WeapiPromisify<TAdapter> & {
+type WeapiInstance<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter> = WeapiPromisify<TAdapter> & TAdapter & WeapiMethodDocOverlay<TAdapter> & {
   /**
    * @description 当前平台标识
    */
@@ -60,12 +181,21 @@ type WeapiInstance<TAdapter extends WeapiAdapter = WeapiWxRawAdapter> = WeapiPro
 /**
  * @description 创建跨平台 API 实例
  */
-declare function createWeapi<TAdapter extends WeapiAdapter = WeapiWxRawAdapter>(options?: CreateWeapiOptions<TAdapter>): WeapiInstance<TAdapter>;
+declare function createWeapi<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter>(options?: CreateWeapiOptions<TAdapter>): WeapiInstance<TAdapter>;
 //#endregion
 //#region src/index.d.ts
 /**
  * @description 默认跨平台 API 实例（推荐使用）
+ *
+ * @generated weapi-platform-matrix:start
+ * | 平台 | 类型来源 | 支持度 |
+ * | --- | --- | --- |
+ * | 微信小程序 (`wx`) | `miniprogram-api-typings` | ✅ 全量 |
+ * | 支付宝小程序 (`my`) | `@mini-types/alipay` | ✅ 全量 |
+ * | 抖音小程序 (`tt`) | `@douyin-microapp/typings` | ✅ 全量 |
+ * | 其他平台对象 (`swan/jd/xhs/...`) | 运行时对象透传 | ⚠️ 按宿主能力支持 |
+ * @generated weapi-platform-matrix:end
  */
-declare const wpi: WeapiInstance<WechatMiniprogram.Wx>;
+declare const wpi: WeapiInstance<WeapiCrossPlatformRawAdapter>;
 //#endregion
-export { type CreateWeapiOptions, type WeapiAdapter, type WeapiInstance, type WeapiPromisify, type WeapiWxAdapter, type WeapiWxRawAdapter, createWeapi, wpi };
+export { type CreateWeapiOptions, type WeapiAdapter, type WeapiAlipayAdapter, type WeapiAlipayRawAdapter, type WeapiCrossPlatformAdapter, type WeapiCrossPlatformRawAdapter, type WeapiDouyinAdapter, type WeapiDouyinRawAdapter, type WeapiInstance, type WeapiPromisify, type WeapiWxAdapter, type WeapiWxRawAdapter, createWeapi, wpi };

package/dist/index.d.mts

@@ -4,6 +4,28 @@ type WeapiAdapter = Record<string, any>;
  * @description 微信小程序 API 原始适配器类型
  */
 type WeapiWxRawAdapter = WechatMiniprogram.Wx;
+/**
+ * @description 支付宝小程序 API 原始适配器类型
+ */
+type WeapiAlipayRawAdapter = typeof my;
+/**
+ * @description 抖音小程序 API 原始适配器类型
+ */
+type WeapiDouyinRawAdapter = typeof tt;
+type MergeAdapters<Primary extends WeapiAdapter, Secondary extends WeapiAdapter> = Primary & Omit<Secondary, keyof Primary>;
+/**
+ * @description weapi 对齐后的跨平台原始 API 类型
+ *
+ * @generated weapi-platform-matrix:start
+ * | 平台 | 全局对象 | 类型来源 | 对齐状态 |
+ * | --- | --- | --- | --- |
+ * | 微信小程序 | `wx` | `miniprogram-api-typings` | ✅ 全量 |
+ * | 支付宝小程序 | `my` | `@mini-types/alipay` | ✅ 全量 |
+ * | 抖音小程序 | `tt` | `@douyin-microapp/typings` | ✅ 全量 |
+ * | 其他平台（swan/jd/xhs 等） | 运行时宿主对象 | 运行时透传 | ⚠️ 按宿主能力支持 |
+ * @generated weapi-platform-matrix:end
+ */
+type WeapiCrossPlatformRawAdapter = MergeAdapters<MergeAdapters<WeapiWxRawAdapter, WeapiAlipayRawAdapter>, WeapiDouyinRawAdapter>;
 type HasCallbackKey<T> = T extends object ? 'success' extends keyof T ? true : 'fail' extends keyof T ? true : 'complete' extends keyof T ? true : false : false;
 type HasCallbackOption<T> = T extends {
   success: unknown;
@@ -21,13 +43,112 @@ type PromisifyOptionMethod<Prefix extends any[], Option extends object, Result,
 } : {
   <TOption extends Option>(...args: [...Prefix, TOption]): HasCallbackOption<TOption> extends true ? Result : Promise<ExtractSuccessResult<Option>>;
 };
-type PromisifyMethod<TMethod> = TMethod extends ((...args: infer Args) => infer Result) ? Args extends [] ? (...args: Args) => Promise<Result> : Args extends [...infer Prefix, infer Last] ? true extends HasCallbackKey<NonNullable<Last>> ? PromisifyOptionMethod<Prefix, NonNullable<Last>, Result, undefined extends Last ? true : false> : (...args: Args) => Promise<Result> : (...args: Args) => Promise<Result> : TMethod;
+type NormalizePromisifyReturn<T> = T extends Promise<any> ? T : Promise<T>;
+type PromisifyMethod<TMethod> = TMethod extends ((...args: infer Args) => infer Result) ? Args extends [] ? (...args: Args) => NormalizePromisifyReturn<Result> : Args extends [...infer Prefix, infer Last] ? true extends HasCallbackKey<NonNullable<Last>> ? PromisifyOptionMethod<Prefix, NonNullable<Last>, Result, undefined extends Last ? true : false> : (...args: Args) => NormalizePromisifyReturn<Result> : (...args: Args) => NormalizePromisifyReturn<Result> : TMethod;
 type WeapiPromisify<TAdapter extends WeapiAdapter> = { [Key in keyof TAdapter]: Key extends string ? Key extends `${string}Sync` ? TAdapter[Key] : Key extends `on${Capitalize<string>}` | `off${Capitalize<string>}` ? TAdapter[Key] : PromisifyMethod<TAdapter[Key]> : TAdapter[Key] };
 /**
  * @description 微信小程序 API 适配器类型
  */
 type WeapiWxAdapter = WeapiPromisify<WeapiWxRawAdapter>;
-interface CreateWeapiOptions<TAdapter extends WeapiAdapter = WeapiWxRawAdapter> {
+/**
+ * @description 支付宝小程序 API 适配器类型
+ */
+type WeapiAlipayAdapter = WeapiPromisify<WeapiAlipayRawAdapter>;
+/**
+ * @description 抖音小程序 API 适配器类型
+ */
+type WeapiDouyinAdapter = WeapiPromisify<WeapiDouyinRawAdapter>;
+/**
+ * @description weapi 默认导出的跨平台 API 适配器类型
+ */
+type WeapiCrossPlatformAdapter = WeapiPromisify<WeapiCrossPlatformRawAdapter>;
+/**
+ * @description weapi 核心映射 API 的平台支持度说明
+ */
+interface WeapiCrossPlatformMethodDocs {
+  /**
+   * 显示消息提示框。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showToast` | ✅ |
+   * | 支付宝 | `title/icon` 映射到 `content/type` 后调用 `my.showToast` | ✅ |
+   * | 抖音 | `icon=error` 映射为 `fail` 后调用 `tt.showToast` | ✅ |
+   */
+  showToast: WeapiCrossPlatformAdapter['showToast'];
+  /**
+   * 显示 loading 提示框。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showLoading` | ✅ |
+   * | 支付宝 | `title` 映射到 `content` 后调用 `my.showLoading` | ✅ |
+   * | 抖音 | 直连 `tt.showLoading` | ✅ |
+   */
+  showLoading: WeapiCrossPlatformAdapter['showLoading'];
+  /**
+   * 显示操作菜单。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showActionSheet` | ✅ |
+   * | 支付宝 | `itemList` ↔ `items`、`index` ↔ `tapIndex` 双向对齐 | ✅ |
+   * | 抖音 | 直连 `tt.showActionSheet`，并兼容 `index` → `tapIndex` | ✅ |
+   */
+  showActionSheet: WeapiCrossPlatformAdapter['showActionSheet'];
+  /**
+   * 显示模态弹窗。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.showModal` | ✅ |
+   * | 支付宝 | 调用 `my.confirm` 并对齐按钮字段与 `cancel` 结果 | ✅ |
+   * | 抖音 | 直连 `tt.showModal` | ✅ |
+   */
+  showModal: WeapiCrossPlatformAdapter['showModal'];
+  /**
+   * 选择图片。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.chooseImage` | ✅ |
+   * | 支付宝 | 返回值 `apFilePaths` 映射到 `tempFilePaths` | ✅ |
+   * | 抖音 | `tempFilePaths` 字符串转数组，缺失时从 `tempFiles.path` 兜底 | ✅ |
+   */
+  chooseImage: WeapiCrossPlatformAdapter['chooseImage'];
+  /**
+   * 保存文件。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.saveFile` | ✅ |
+   * | 支付宝 | 请求参数 `tempFilePath` ↔ `apFilePath`、结果映射为 `savedFilePath` | ✅ |
+   * | 抖音 | 直连 `tt.saveFile`，并在缺失时用 `filePath` 兜底 `savedFilePath` | ✅ |
+   */
+  saveFile: WeapiCrossPlatformAdapter['saveFile'];
+  /**
+   * 设置剪贴板内容。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.setClipboardData` | ✅ |
+   * | 支付宝 | 转调 `my.setClipboard` 并映射 `data` → `text` | ✅ |
+   * | 抖音 | 直连 `tt.setClipboardData` | ✅ |
+   */
+  setClipboardData: WeapiCrossPlatformAdapter['setClipboardData'];
+  /**
+   * 获取剪贴板内容。
+   *
+   * | 平台 | 对齐策略 | 支持度 |
+   * | --- | --- | --- |
+   * | 微信 | 直连 `wx.getClipboardData` | ✅ |
+   * | 支付宝 | 转调 `my.getClipboard` 并映射 `text` → `data` | ✅ |
+   * | 抖音 | 直连 `tt.getClipboardData` | ✅ |
+   */
+  getClipboardData: WeapiCrossPlatformAdapter['getClipboardData'];
+}
+type WeapiMethodDocOverlay<TAdapter extends WeapiAdapter> = TAdapter extends WeapiCrossPlatformRawAdapter ? WeapiCrossPlatformMethodDocs : object;
+interface CreateWeapiOptions<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter> {
   /**
    * @description 手动指定平台适配器（优先级高于自动探测）
    */
@@ -37,7 +158,7 @@ interface CreateWeapiOptions<TAdapter extends WeapiAdapter = WeapiWxRawAdapter>
    */
   platform?: string;
 }
-type WeapiInstance<TAdapter extends WeapiAdapter = WeapiWxRawAdapter> = WeapiPromisify<TAdapter> & {
+type WeapiInstance<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter> = WeapiPromisify<TAdapter> & TAdapter & WeapiMethodDocOverlay<TAdapter> & {
   /**
    * @description 当前平台标识
    */
@@ -60,12 +181,21 @@ type WeapiInstance<TAdapter extends WeapiAdapter = WeapiWxRawAdapter> = WeapiPro
 /**
  * @description 创建跨平台 API 实例
  */
-declare function createWeapi<TAdapter extends WeapiAdapter = WeapiWxRawAdapter>(options?: CreateWeapiOptions<TAdapter>): WeapiInstance<TAdapter>;
+declare function createWeapi<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter>(options?: CreateWeapiOptions<TAdapter>): WeapiInstance<TAdapter>;
 //#endregion
 //#region src/index.d.ts
 /**
  * @description 默认跨平台 API 实例（推荐使用）
+ *
+ * @generated weapi-platform-matrix:start
+ * | 平台 | 类型来源 | 支持度 |
+ * | --- | --- | --- |
+ * | 微信小程序 (`wx`) | `miniprogram-api-typings` | ✅ 全量 |
+ * | 支付宝小程序 (`my`) | `@mini-types/alipay` | ✅ 全量 |
+ * | 抖音小程序 (`tt`) | `@douyin-microapp/typings` | ✅ 全量 |
+ * | 其他平台对象 (`swan/jd/xhs/...`) | 运行时对象透传 | ⚠️ 按宿主能力支持 |
+ * @generated weapi-platform-matrix:end
  */
-declare const wpi: WeapiInstance<WechatMiniprogram.Wx>;
+declare const wpi: WeapiInstance<WeapiCrossPlatformRawAdapter>;
 //#endregion
-export { type CreateWeapiOptions, type WeapiAdapter, type WeapiInstance, type WeapiPromisify, type WeapiWxAdapter, type WeapiWxRawAdapter, createWeapi, wpi };
+export { type CreateWeapiOptions, type WeapiAdapter, type WeapiAlipayAdapter, type WeapiAlipayRawAdapter, type WeapiCrossPlatformAdapter, type WeapiCrossPlatformRawAdapter, type WeapiDouyinAdapter, type WeapiDouyinRawAdapter, type WeapiInstance, type WeapiPromisify, type WeapiWxAdapter, type WeapiWxRawAdapter, createWeapi, wpi };

package/dist/index.mjs

@@ -94,6 +94,243 @@ function createNotSupportedError(methodName, platform) {
 	return { errMsg: `${platform ? `${platform}.${methodName}` : methodName}:fail method not supported` };
 }
 
+//#endregion
+//#region src/core/methodMapping.ts
+const PLATFORM_ALIASES$1 = {
+	alipay: "my",
+	douyin: "tt"
+};
+function mapToastType(type) {
+	if (type === "error") return "fail";
+	if (type === "loading") return "none";
+	return type;
+}
+function mapToastArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "content") && Object.prototype.hasOwnProperty.call(nextOptions, "title")) nextOptions.content = nextOptions.title;
+	if (Object.prototype.hasOwnProperty.call(nextOptions, "icon")) nextOptions.type = mapToastType(nextOptions.icon);
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapDouyinToastArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (nextOptions.icon === "error") nextOptions.icon = "fail";
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapLoadingArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "content") && Object.prototype.hasOwnProperty.call(nextOptions, "title")) nextOptions.content = nextOptions.title;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapActionSheetArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "items") && Array.isArray(nextOptions.itemList)) nextOptions.items = nextOptions.itemList;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapActionSheetResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "tapIndex") && Object.prototype.hasOwnProperty.call(result, "index")) return {
+		...result,
+		tapIndex: result.index
+	};
+	return result;
+}
+function mapModalArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "confirmButtonText") && Object.prototype.hasOwnProperty.call(nextOptions, "confirmText")) nextOptions.confirmButtonText = nextOptions.confirmText;
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "cancelButtonText") && Object.prototype.hasOwnProperty.call(nextOptions, "cancelText")) nextOptions.cancelButtonText = nextOptions.cancelText;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapModalResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "cancel") && Object.prototype.hasOwnProperty.call(result, "confirm")) return {
+		...result,
+		cancel: !result.confirm
+	};
+	return result;
+}
+function mapChooseImageResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "tempFilePaths") && Array.isArray(result.apFilePaths)) return {
+		...result,
+		tempFilePaths: result.apFilePaths
+	};
+	return result;
+}
+function mapDouyinChooseImageResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (typeof result.tempFilePaths === "string") return {
+		...result,
+		tempFilePaths: [result.tempFilePaths]
+	};
+	if (!Array.isArray(result.tempFilePaths) && Array.isArray(result.tempFiles)) {
+		const fallbackPaths = result.tempFiles.map((item) => {
+			if (!isPlainObject(item)) return;
+			const path = item.path;
+			if (typeof path === "string" && path) return path;
+			const filePath = item.filePath;
+			if (typeof filePath === "string" && filePath) return filePath;
+		}).filter((item) => typeof item === "string");
+		if (fallbackPaths.length > 0) return {
+			...result,
+			tempFilePaths: fallbackPaths
+		};
+	}
+	return result;
+}
+function mapSaveFileArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "apFilePath") && Object.prototype.hasOwnProperty.call(nextOptions, "tempFilePath")) nextOptions.apFilePath = nextOptions.tempFilePath;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapSaveFileResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "savedFilePath") && Object.prototype.hasOwnProperty.call(result, "apFilePath")) return {
+		...result,
+		savedFilePath: result.apFilePath
+	};
+	return result;
+}
+function mapDouyinSaveFileResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "savedFilePath") && Object.prototype.hasOwnProperty.call(result, "filePath")) return {
+		...result,
+		savedFilePath: result.filePath
+	};
+	return result;
+}
+function normalizePlatformName$1(value) {
+	if (!value) return;
+	const normalized = value.trim().toLowerCase();
+	if (!normalized) return;
+	return PLATFORM_ALIASES$1[normalized] ?? normalized;
+}
+function mapSetClipboardArgs(args) {
+	if (args.length === 0) return args;
+	const nextArgs = [...args];
+	const lastIndex = nextArgs.length - 1;
+	const lastArg = nextArgs[lastIndex];
+	if (!isPlainObject(lastArg)) return nextArgs;
+	const nextOptions = { ...lastArg };
+	if (!Object.prototype.hasOwnProperty.call(nextOptions, "text") && Object.prototype.hasOwnProperty.call(nextOptions, "data")) nextOptions.text = nextOptions.data;
+	nextArgs[lastIndex] = nextOptions;
+	return nextArgs;
+}
+function mapClipboardResult(result) {
+	if (!isPlainObject(result)) return result;
+	if (!Object.prototype.hasOwnProperty.call(result, "data") && Object.prototype.hasOwnProperty.call(result, "text")) return {
+		...result,
+		data: result.text
+	};
+	return result;
+}
+const METHOD_MAPPINGS = {
+	my: {
+		showToast: {
+			target: "showToast",
+			mapArgs: mapToastArgs
+		},
+		showLoading: {
+			target: "showLoading",
+			mapArgs: mapLoadingArgs
+		},
+		showActionSheet: {
+			target: "showActionSheet",
+			mapArgs: mapActionSheetArgs,
+			mapResult: mapActionSheetResult
+		},
+		showModal: {
+			target: "confirm",
+			mapArgs: mapModalArgs,
+			mapResult: mapModalResult
+		},
+		chooseImage: {
+			target: "chooseImage",
+			mapResult: mapChooseImageResult
+		},
+		saveFile: {
+			target: "saveFile",
+			mapArgs: mapSaveFileArgs,
+			mapResult: mapSaveFileResult
+		},
+		setClipboardData: {
+			target: "setClipboard",
+			mapArgs: mapSetClipboardArgs
+		},
+		getClipboardData: {
+			target: "getClipboard",
+			mapResult: mapClipboardResult
+		}
+	},
+	tt: {
+		showToast: {
+			target: "showToast",
+			mapArgs: mapDouyinToastArgs
+		},
+		showLoading: { target: "showLoading" },
+		showActionSheet: {
+			target: "showActionSheet",
+			mapResult: mapActionSheetResult
+		},
+		showModal: { target: "showModal" },
+		chooseImage: {
+			target: "chooseImage",
+			mapResult: mapDouyinChooseImageResult
+		},
+		saveFile: {
+			target: "saveFile",
+			mapResult: mapDouyinSaveFileResult
+		},
+		setClipboardData: { target: "setClipboardData" },
+		getClipboardData: { target: "getClipboardData" }
+	}
+};
+/**
+* @description 解析平台 API 映射规则
+*/
+function resolveMethodMapping(platform, methodName) {
+	const normalizedPlatform = normalizePlatformName$1(platform);
+	if (!normalizedPlatform) return;
+	const platformMappings = METHOD_MAPPINGS[normalizedPlatform];
+	if (!platformMappings) return;
+	return platformMappings[methodName];
+}
+
 //#endregion
 //#region src/core/createWeapi.ts
 const INTERNAL_KEYS = new Set([
@@ -102,8 +339,15 @@ const INTERNAL_KEYS = new Set([
 	"platform",
 	"raw"
 ]);
+const PLATFORM_ALIASES = {
+	alipay: "my",
+	douyin: "tt"
+};
 function normalizePlatformName(value) {
-	return value || void 0;
+	if (!value) return;
+	const normalized = value.trim().toLowerCase();
+	if (!normalized) return;
+	return PLATFORM_ALIASES[normalized] ?? normalized;
 }
 function resolveOptionsArg(args) {
 	const nextArgs = args.slice();
@@ -123,20 +367,20 @@ function resolveOptionsArg(args) {
 		options
 	};
 }
-function callWithPromise(context, method, args) {
+function callWithPromise(context, method, args, mapResult) {
 	return new Promise((resolve, reject) => {
 		const { args: nextArgs, options } = resolveOptionsArg(args);
 		let settled = false;
 		options.success = (res) => {
 			settled = true;
-			resolve(res);
+			resolve(mapResult ? mapResult(res) : res);
 		};
 		options.fail = (err) => {
 			settled = true;
 			reject(err);
 		};
 		options.complete = (res) => {
-			if (!settled) resolve(res);
+			if (!settled) resolve(mapResult ? mapResult(res) : res);
 		};
 		try {
 			method.apply(context, nextArgs);
@@ -199,7 +443,8 @@ function createWeapi(options = {}) {
 			if (typeof prop !== "string") return;
 			return (...args) => callMissingApi(prop, getPlatform(), args);
 		}
-		const value = currentAdapter[prop];
+		const platform = getPlatform();
+		const value = currentAdapter[(typeof prop === "string" ? resolveMethodMapping(platform, prop) : void 0)?.target ?? prop];
 		if (typeof value !== "function") {
 			if (value === void 0 && typeof prop === "string") {
 				const missing = (...args) => callMissingApi(prop, getPlatform(), args);
@@ -211,11 +456,32 @@ function createWeapi(options = {}) {
 		}
 		const wrapped = (...args) => {
 			const runtimeAdapter = resolveAdapter();
-			const runtimeMethod = runtimeAdapter ? runtimeAdapter[prop] : void 0;
+			const mappingRule = resolveMethodMapping(getPlatform(), prop);
+			const methodName = mappingRule?.target ?? prop;
+			const runtimeMethod = runtimeAdapter ? runtimeAdapter[methodName] : void 0;
+			const runtimeArgs = mappingRule?.mapArgs ? mappingRule.mapArgs(args) : args;
 			if (typeof runtimeMethod !== "function") return callMissingApi(prop, getPlatform(), args);
-			if (shouldSkipPromise(prop)) return runtimeMethod.apply(runtimeAdapter, args);
-			if (hasCallbacks(args.length > 0 ? args[args.length - 1] : void 0)) return runtimeMethod.apply(runtimeAdapter, args);
-			return callWithPromise(runtimeAdapter, runtimeMethod, args);
+			if (shouldSkipPromise(prop)) {
+				const result = runtimeMethod.apply(runtimeAdapter, runtimeArgs);
+				return mappingRule?.mapResult ? mappingRule.mapResult(result) : result;
+			}
+			const lastArg = runtimeArgs.length > 0 ? runtimeArgs[runtimeArgs.length - 1] : void 0;
+			if (hasCallbacks(lastArg)) {
+				if (mappingRule?.mapResult && isPlainObject(lastArg)) {
+					const options = lastArg;
+					const originalSuccess = options.success;
+					const originalComplete = options.complete;
+					options.success = (res) => {
+						originalSuccess?.(mappingRule.mapResult(res));
+					};
+					options.complete = (res) => {
+						originalComplete?.(mappingRule.mapResult(res));
+					};
+				}
+				const result = runtimeMethod.apply(runtimeAdapter, runtimeArgs);
+				return mappingRule?.mapResult ? mappingRule.mapResult(result) : result;
+			}
+			return callWithPromise(runtimeAdapter, runtimeMethod, runtimeArgs, mappingRule?.mapResult);
 		};
 		cache.set(prop, wrapped);
 		return wrapped;
@@ -226,6 +492,15 @@ function createWeapi(options = {}) {
 //#region src/index.ts
 /**
 * @description 默认跨平台 API 实例（推荐使用）
+*
+* @generated weapi-platform-matrix:start
+* | 平台 | 类型来源 | 支持度 |
+* | --- | --- | --- |
+* | 微信小程序 (`wx`) | `miniprogram-api-typings` | ✅ 全量 |
+* | 支付宝小程序 (`my`) | `@mini-types/alipay` | ✅ 全量 |
+* | 抖音小程序 (`tt`) | `@douyin-microapp/typings` | ✅ 全量 |
+* | 其他平台对象 (`swan/jd/xhs/...`) | 运行时对象透传 | ⚠️ 按宿主能力支持 |
+* @generated weapi-platform-matrix:end
 */
 const wpi = createWeapi();
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wevu/api",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "tsdown bundler template",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -36,6 +36,8 @@
     "types"
   ],
   "dependencies": {
+    "@douyin-microapp/typings": "^1.3.1",
+    "@mini-types/alipay": "^3.0.14",
     "miniprogram-api-typings": "^5.0.0"
   },
   "publishConfig": {
@@ -49,6 +51,9 @@
     "test:types": "tsd",
     "release": "pnpm publish",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "docs:sync": "node --experimental-strip-types ./scripts/sync-support-matrix.ts",
+    "docs:check": "node --experimental-strip-types ./scripts/sync-support-matrix.ts --check",
+    "prebuild": "pnpm run docs:check"
   }
 }

package/types/index.d.ts

@@ -1,9 +1,17 @@
 /// <reference types="miniprogram-api-typings" />
+/// <reference types="@mini-types/alipay" />
+/// <reference types="@douyin-microapp/typings" />
 
 // eslint-disable-next-line antfu/no-import-dist
 import type {
   CreateWeapiOptions,
   WeapiAdapter,
+  WeapiAlipayAdapter,
+  WeapiAlipayRawAdapter,
+  WeapiCrossPlatformAdapter,
+  WeapiCrossPlatformRawAdapter,
+  WeapiDouyinAdapter,
+  WeapiDouyinRawAdapter,
   WeapiInstance,
   WeapiPromisify,
   WeapiWxAdapter,
@@ -13,14 +21,34 @@ import type {
 export type {
   CreateWeapiOptions,
   WeapiAdapter,
+  WeapiAlipayAdapter,
+  WeapiAlipayRawAdapter,
+  WeapiCrossPlatformAdapter,
+  WeapiCrossPlatformRawAdapter,
+  WeapiDouyinAdapter,
+  WeapiDouyinRawAdapter,
   WeapiInstance,
   WeapiPromisify,
   WeapiWxAdapter,
   WeapiWxRawAdapter,
 }
 
-export function createWeapi<TAdapter extends WeapiAdapter = WeapiWxRawAdapter>(
+export function createWeapi<TAdapter extends WeapiAdapter = WeapiCrossPlatformRawAdapter>(
   options?: CreateWeapiOptions<TAdapter>,
 ): WeapiInstance<TAdapter>
 
-export const wpi: WeapiInstance<WechatMiniprogram.Wx>
+export type WeapiDefaultInstance = WeapiInstance<WeapiCrossPlatformRawAdapter>
+
+/**
+ * 默认跨平台 API 实例。
+ *
+ * @generated weapi-platform-matrix:start
+ * | 平台 | 全局对象 | 类型来源 | 对齐状态 |
+ * | --- | --- | --- | --- |
+ * | 微信小程序 | `wx` | `miniprogram-api-typings` | ✅ 全量 |
+ * | 支付宝小程序 | `my` | `@mini-types/alipay` | ✅ 全量 |
+ * | 抖音小程序 | `tt` | `@douyin-microapp/typings` | ✅ 全量 |
+ * | 其他平台（swan/jd/xhs 等） | 运行时宿主对象 | 运行时透传 | ⚠️ 按宿主能力支持 |
+ * @generated weapi-platform-matrix:end
+ */
+export const wpi: WeapiDefaultInstance