@spcsn/taro 0.1.0

package/README.md

@@ -0,0 +1,12 @@
+# @spcsn/taro
+
+暴露给应用开发者的 Taro 核心 API。包含以下文件：
+
+## index.js
+
+兼容入口文件，运行时会加载 `dist/index.js`。
+
+## dist/index.js
+
+由 `src/index.js` 通过 Rolldown 构建生成的小程序端入口文件。
+

package/dist/index.js

@@ -0,0 +1,147 @@
+//#region \0rolldown/runtime.js
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+//#endregion
+//#region src/react-hooks-fallback.js
+var require_react_hooks_fallback = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+	const { Current, getPageInstance, injectPageInstance } = require("@spcsn/taro-runtime");
+	const React = require("react");
+	const hooksMap = {
+		useAddToFavorites: "onAddToFavorites",
+		useDidHide: "componentDidHide",
+		useDidShow: "componentDidShow",
+		useError: "onError",
+		useKeyboardHeight: "onKeyboardHeight",
+		useLaunch: "onLaunch",
+		useLoad: "onLoad",
+		useOptionMenuClick: "onOptionMenuClick",
+		usePageNotFound: "onPageNotFound",
+		usePageScroll: "onPageScroll",
+		usePullDownRefresh: "onPullDownRefresh",
+		usePullIntercept: "onPullIntercept",
+		useReachBottom: "onReachBottom",
+		useReady: "onReady",
+		useResize: "onResize",
+		useSaveExitState: "onSaveExitState",
+		useShareAppMessage: "onShareAppMessage",
+		useShareTimeline: "onShareTimeline",
+		useTabItemTap: "onTabItemTap",
+		useTitleClick: "onTitleClick",
+		useUnhandledRejection: "onUnhandledRejection",
+		useUnload: "onUnload"
+	};
+	function createHook(lifecycle) {
+		return (fn) => {
+			const router = Current.router;
+			const id = router?.$taroPath || router?.path || "taro-app";
+			const instRef = React.useRef();
+			const fnRef = React.useRef(fn);
+			if (fnRef.current !== fn) fnRef.current = fn;
+			React.useLayoutEffect(() => {
+				let inst = instRef.current = getPageInstance(id);
+				if (!inst) {
+					inst = instRef.current = Object.create(null);
+					injectPageInstance(inst, id);
+				}
+				const callback = (...args) => fnRef.current(...args);
+				if (typeof inst[lifecycle] === "function") inst[lifecycle] = [inst[lifecycle], callback];
+				else inst[lifecycle] = [...inst[lifecycle] || [], callback];
+				return () => {
+					const inst = instRef.current;
+					if (!inst) return;
+					const list = inst[lifecycle];
+					if (list === callback) inst[lifecycle] = void 0;
+					else if (Array.isArray(list)) inst[lifecycle] = list.filter((item) => item !== callback);
+					instRef.current = void 0;
+				};
+			}, []);
+		};
+	}
+	function initReactHooksFallback(taro) {
+		if (typeof taro.useShareAppMessage === "function") return;
+		Object.keys(hooksMap).forEach((key) => {
+			taro[key] = createHook(hooksMap[key]);
+		});
+		taro.useRouter = function useRouter(dynamic = false) {
+			if (dynamic) return Current.router;
+			return React.useMemo(() => Current.router, []);
+		};
+		taro.useScope = function useScope() {};
+	}
+	module.exports = { initReactHooksFallback };
+}));
+//#endregion
+//#region src/native-api-fallback.js
+var require_native_api_fallback = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+	const needPromiseApis = new Set([
+		"addFileToFavorites",
+		"addVideoToFavorites",
+		"authPrivateMessage",
+		"checkIsAddedToMyMiniProgram",
+		"chooseContact",
+		"cropImage",
+		"disableAlertBeforeUnload",
+		"editImage",
+		"enableAlertBeforeUnload",
+		"getBackgroundFetchData",
+		"getChannelsLiveInfo",
+		"getChannelsLiveNoticeInfo",
+		"getFuzzyLocation",
+		"getGroupEnterInfo",
+		"getLocalIPAddress",
+		"getShareInfo",
+		"getUserProfile",
+		"getWeRunData",
+		"join1v1Chat",
+		"openChannelsActivity",
+		"openChannelsEvent",
+		"openChannelsLive",
+		"openChannelsUserProfile",
+		"openCustomerServiceChat",
+		"openVideoEditor",
+		"saveFileToDisk",
+		"scanItem",
+		"setEnable1v1Chat",
+		"setWindowSize",
+		"sendBizRedPacket",
+		"startFacialRecognitionVerify"
+	]);
+	function initWeappNativeApiFallback$1(taro) {
+		if (typeof wx === "undefined" || typeof taro.addInterceptor === "function") return;
+		const { processApis } = require("@spcsn/taro-shared");
+		processApis(taro, wx, {
+			needPromiseApis,
+			modifyApis(apis) {
+				apis.delete("lanDebug");
+			},
+			transformMeta(api, options) {
+				if (api === "showShareMenu") options.menus = options.showShareItems?.map((item) => item === "wechatFriends" ? "shareAppMessage" : item === "wechatMoment" ? "shareTimeline" : item);
+				return {
+					key: api,
+					options
+				};
+			}
+		});
+		taro.cloud = wx.cloud;
+		taro.getTabBar = function(pageCtx) {
+			if (typeof pageCtx?.getTabBar === "function") return pageCtx.getTabBar()?.$taroInstances;
+		};
+		taro.getRenderer = function() {
+			return taro.getCurrentInstance()?.page?.renderer ?? "webview";
+		};
+	}
+	module.exports = { initWeappNativeApiFallback: initWeappNativeApiFallback$1 };
+}));
+//#endregion
+//#region src/index.js
+const { hooks } = require("@spcsn/taro-runtime");
+const taro = require("@spcsn/taro-api").default;
+const { initReactHooksFallback } = require_react_hooks_fallback();
+const { initWeappNativeApiFallback } = require_native_api_fallback();
+if (hooks.isExist("initNativeApi")) hooks.call("initNativeApi", taro);
+initReactHooksFallback(taro);
+initWeappNativeApiFallback(taro);
+module.exports = taro;
+module.exports.default = module.exports;
+//#endregion
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["initWeappNativeApiFallback"],"sources":["../src/react-hooks-fallback.js","../src/native-api-fallback.js","../src/index.js"],"sourcesContent":["const { Current, getPageInstance, injectPageInstance } = require('@spcsn/taro-runtime');\nconst React = require('react');\n\nconst hooksMap = {\n  useAddToFavorites: 'onAddToFavorites',\n  useDidHide: 'componentDidHide',\n  useDidShow: 'componentDidShow',\n  useError: 'onError',\n  useKeyboardHeight: 'onKeyboardHeight',\n  useLaunch: 'onLaunch',\n  useLoad: 'onLoad',\n  useOptionMenuClick: 'onOptionMenuClick',\n  usePageNotFound: 'onPageNotFound',\n  usePageScroll: 'onPageScroll',\n  usePullDownRefresh: 'onPullDownRefresh',\n  usePullIntercept: 'onPullIntercept',\n  useReachBottom: 'onReachBottom',\n  useReady: 'onReady',\n  useResize: 'onResize',\n  useSaveExitState: 'onSaveExitState',\n  useShareAppMessage: 'onShareAppMessage',\n  useShareTimeline: 'onShareTimeline',\n  useTabItemTap: 'onTabItemTap',\n  useTitleClick: 'onTitleClick',\n  useUnhandledRejection: 'onUnhandledRejection',\n  useUnload: 'onUnload',\n};\n\nfunction createHook(lifecycle) {\n  return (fn) => {\n    const router = Current.router;\n    const id = router?.$taroPath || router?.path || 'taro-app';\n    const instRef = React.useRef();\n    const fnRef = React.useRef(fn);\n    if (fnRef.current !== fn) fnRef.current = fn;\n\n    React.useLayoutEffect(() => {\n      let inst = (instRef.current = getPageInstance(id));\n      if (!inst) {\n        inst = instRef.current = Object.create(null);\n        injectPageInstance(inst, id);\n      }\n\n      const callback = (...args) => fnRef.current(...args);\n      if (typeof inst[lifecycle] === 'function') {\n        inst[lifecycle] = [inst[lifecycle], callback];\n      } else {\n        inst[lifecycle] = [...(inst[lifecycle] || []), callback];\n      }\n\n      return () => {\n        const inst = instRef.current;\n        if (!inst) return;\n\n        const list = inst[lifecycle];\n        if (list === callback) {\n          inst[lifecycle] = undefined;\n        } else if (Array.isArray(list)) {\n          inst[lifecycle] = list.filter((item) => item !== callback);\n        }\n        instRef.current = undefined;\n      };\n    }, []);\n  };\n}\n\nfunction initReactHooksFallback(taro) {\n  if (typeof taro.useShareAppMessage === 'function') return;\n\n  Object.keys(hooksMap).forEach((key) => {\n    taro[key] = createHook(hooksMap[key]);\n  });\n\n  taro.useRouter = function useRouter(dynamic = false) {\n    if (dynamic) return Current.router;\n    return React.useMemo(() => Current.router, []);\n  };\n\n  taro.useScope = function useScope() {\n    return undefined;\n  };\n}\n\nmodule.exports = {\n  initReactHooksFallback,\n};\n","const needPromiseApis = new Set([\n  'addFileToFavorites',\n  'addVideoToFavorites',\n  'authPrivateMessage',\n  'checkIsAddedToMyMiniProgram',\n  'chooseContact',\n  'cropImage',\n  'disableAlertBeforeUnload',\n  'editImage',\n  'enableAlertBeforeUnload',\n  'getBackgroundFetchData',\n  'getChannelsLiveInfo',\n  'getChannelsLiveNoticeInfo',\n  'getFuzzyLocation',\n  'getGroupEnterInfo',\n  'getLocalIPAddress',\n  'getShareInfo',\n  'getUserProfile',\n  'getWeRunData',\n  'join1v1Chat',\n  'openChannelsActivity',\n  'openChannelsEvent',\n  'openChannelsLive',\n  'openChannelsUserProfile',\n  'openCustomerServiceChat',\n  'openVideoEditor',\n  'saveFileToDisk',\n  'scanItem',\n  'setEnable1v1Chat',\n  'setWindowSize',\n  'sendBizRedPacket',\n  'startFacialRecognitionVerify',\n]);\n\nfunction initWeappNativeApiFallback(taro) {\n  if (typeof wx === 'undefined' || typeof taro.addInterceptor === 'function') return;\n\n  const { processApis } = require('@spcsn/taro-shared');\n\n  processApis(taro, wx, {\n    needPromiseApis,\n    modifyApis(apis) {\n      apis.delete('lanDebug');\n    },\n    transformMeta(api, options) {\n      if (api === 'showShareMenu') {\n        options.menus = options.showShareItems?.map((item) =>\n          item === 'wechatFriends' ? 'shareAppMessage' : item === 'wechatMoment' ? 'shareTimeline' : item,\n        );\n      }\n\n      return {\n        key: api,\n        options,\n      };\n    },\n  });\n\n  taro.cloud = wx.cloud;\n  taro.getTabBar = function (pageCtx) {\n    if (typeof pageCtx?.getTabBar === 'function') {\n      return pageCtx.getTabBar()?.$taroInstances;\n    }\n  };\n  taro.getRenderer = function () {\n    return taro.getCurrentInstance()?.page?.renderer ?? 'webview';\n  };\n}\n\nmodule.exports = {\n  initWeappNativeApiFallback,\n};\n","const { hooks } = require('@spcsn/taro-runtime');\nconst taro = require('@spcsn/taro-api').default;\n\nconst { initReactHooksFallback } = require('./react-hooks-fallback');\nconst { initWeappNativeApiFallback } = require('./native-api-fallback');\n\nif (hooks.isExist('initNativeApi')) {\n  hooks.call('initNativeApi', taro);\n}\n\ninitReactHooksFallback(taro);\ninitWeappNativeApiFallback(taro);\n\nmodule.exports = taro;\nmodule.exports.default = module.exports;\n"],"mappings":"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"}

package/index.js

@@ -0,0 +1,9 @@
+try {
+  module.exports = require('./dist/index.js');
+} catch (error) {
+  if (error?.code !== 'MODULE_NOT_FOUND' || !/[\\/]dist[\\/]index\.js/.test(error.message)) {
+    throw error;
+  }
+
+  module.exports = require('./src/index.js');
+}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@spcsn/taro",
+  "version": "0.1.0",
+  "description": "Taro framework",
+  "author": "O2Team",
+  "license": "MIT",
+  "main": "index.js",
+  "types": "types/index.d.ts",
+  "typings": "types/index.d.ts",
+  "files": [
+    "index.js",
+    "dist",
+    "types"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NervJS/taro.git"
+  },
+  "keywords": [
+    "taro"
+  ],
+  "engines": {
+    "node": ">= 22"
+  },
+  "dependencies": {
+    "@types/postcss-url": "^10.0.4",
+    "@spcsn/taro-api": "0.1.0",
+    "@spcsn/taro-runtime": "0.1.0",
+    "@spcsn/taro-shared": "0.1.0",
+    "@spcsn/taro-react": "0.1.0"
+  },
+  "devDependencies": {
+    "html-webpack-plugin": "^5.6.0",
+    "webpack": "5.91.0",
+    "webpack-chain": "^6.5.1",
+    "webpack-dev-server": "^4.15.2",
+    "rollup": "^3.29.4",
+    "@spcsn/taro-helper": "0.1.0",
+    "@spcsn/taro-components": "0.1.0",
+    "@spcsn/taro-shared": "0.1.0"
+  },
+  "peerDependencies": {
+    "@types/react": "^19",
+    "html-webpack-plugin": "^5",
+    "rollup": "^3",
+    "postcss": "^8",
+    "vue": "^3",
+    "webpack": "^5",
+    "webpack-chain": "^6",
+    "webpack-dev-server": "^4",
+    "@spcsn/taro-components": "0.1.0",
+    "@spcsn/taro-helper": "0.1.0",
+    "@spcsn/taro-shared": "0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    },
+    "html-webpack-plugin": {
+      "optional": true
+    },
+    "rollup": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    },
+    "webpack-chain": {
+      "optional": true
+    },
+    "webpack-dev-server": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "prod": "pnpm run build",
+    "prebuild": "pnpm run clean",
+    "build": "pnpm run rolldown --environment NODE_ENV:production",
+    "clean": "rimraf ./dist",
+    "dev": "pnpm run rolldown --environment NODE_ENV:development -w",
+    "rolldown": "rolldown --config rolldown.config.mjs"
+  }
+}

package/types/api/ad/index.d.ts

@@ -0,0 +1,197 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace createRewardedVideoAd {
+    interface Option {
+      /** 小程序广告位 ID
+       * @supported weapp, tt, swan
+       */
+      adUnitId: string
+      /** 是否启用多例模式
+       * @default false
+       * @supported weapp
+       */
+      multiton?: boolean
+      /** 小程序应用 ID
+       * @supported swan
+       * @swan 必填
+       */
+      appSid?: string
+    }
+  }
+
+  namespace createInterstitialAd {
+    interface Option {
+      /** 广告单元 id */
+      adUnitId: string
+    }
+  }
+
+  /**
+   * 插屏广告组件。插屏广告组件是一个原生组件，层级比普通组件高。插屏广告组件每次创建都会返回一个全新的实例（小程序端的插屏广告实例不允许跨页面使用），默认是隐藏的，需要调用 InterstitialAd.show() 将其显示。
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.html
+   */
+  interface InterstitialAd {
+    /** 销毁插屏广告实例。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.destroy.html
+     */
+    destroy(): void
+    /** 取消监听插屏广告关闭事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.offClose.html
+     */
+    offClose(callback: InterstitialAd.OnCloseCallback): void
+    /** 取消监听插屏错误事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.offError.html
+     */
+    offError(callback: InterstitialAd.OnErrorCallback): void
+    /** 取消监听插屏广告加载事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.offLoad.html
+     */
+    offLoad(callback: InterstitialAd.OnLoadCallback): void
+    /** 监听插屏广告关闭事件。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.onClose.html
+     */
+    onClose(callback: InterstitialAd.OnCloseCallback): void
+    /** 监听插屏错误事件。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.onError.html
+     */
+    onError(callback: InterstitialAd.OnErrorCallback): void
+    /** 监听插屏广告加载事件。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.onLoad.html
+     */
+    onLoad(callback: InterstitialAd.OnLoadCallback): void
+    /** 加载插屏广告。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.load.html
+     */
+    load(): Promise<any>
+    /** 显示插屏广告。
+     *
+     * **错误码信息表**
+     *
+     *  如果插屏广告显示失败，InterstitialAd.show() 方法会返回一个rejected Promise，开发者可以获取到错误码及对应的错误信息。
+     *
+     * | 代码 | 异常情况 | 理由 |
+     * | ------ | -------------- | -------------------------- |
+     * | 2001  | 触发频率限制  | 小程序启动一定时间内不允许展示插屏广告 |
+     * | 2002  | 触发频率限制  | 距离小程序插屏广告或者激励视频广告上次播放时间间隔不足，不允许展示插屏广告 |
+     * | 2003  | 触发频率限制  | 当前正在播放激励视频广告或者插屏广告，不允许再次展示插屏广告 |
+     * | 2004  | 广告渲染失败  | 该项错误不是开发者的异常情况，或因小程序页面切换导致广告渲染失败 |
+     * | 2005  | 广告调用异常  | 插屏广告实例不允许跨页面调用 |
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/InterstitialAd.show.html
+     */
+    show(): Promise<any>
+  }
+  namespace InterstitialAd {
+    /** 插屏广告关闭事件的回调函数 */
+    type OnCloseCallback = (res: TaroGeneral.CallbackResult) => void
+    /** 插屏错误事件的回调函数 */
+    type OnErrorCallback = (result: OnErrorCallbackResult) => void
+    /** 插屏广告加载事件的回调函数 */
+    type OnLoadCallback = (res: TaroGeneral.CallbackResult) => void
+    interface OnErrorCallbackResult extends TaroGeneral.CallbackResult {
+      /** 错误码
+       * @see /docs/apis/General#aderrcode
+       */
+      errCode: keyof TaroGeneral.AdErrCode
+      /** 错误信息 */
+      errMsg: string
+    }
+  }
+
+  /**
+   * 激励视频广告组件。激励视频广告组件是一个原生组件，层级比普通组件高。激励视频广告是一个单例（小游戏端是全局单例，小程序端是页面内单例，在小程序端的单例对象不允许跨页面使用），默认是隐藏的，需要调用 RewardedVideoAd.show() 将其显示。
+   * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.html
+   */
+  interface RewardedVideoAd {
+    /** 加载激励视频广告。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.load.html
+     */
+    load(): Promise<any>
+    /** 显示激励视频广告。激励视频广告将从屏幕下方推入。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.show.html
+     */
+    show(): Promise<any>
+    /** 销毁激励视频广告实例。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.destroy.html
+     */
+    destroy(): void
+    /** 取消监听用户点击 `关闭广告` 按钮的事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.offClose.html
+     */
+    offClose(callback: RewardedVideoAd.OnCloseCallback): void
+    /** 取消监听激励视频错误事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.offError.html
+     */
+    offError(callback: RewardedVideoAd.OnErrorCallback): void
+    /** 取消监听激励视频广告加载事件
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.offLoad.html
+     */
+    offLoad(callback: RewardedVideoAd.OnLoadCallback): void
+    /** 监听用户点击 `关闭广告` 按钮的事件。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.onClose.html
+     */
+    onClose(callback: RewardedVideoAd.OnCloseCallback): void
+    /**
+     * 监听激励视频错误事件。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.onError.html
+     */
+    onError(callback: RewardedVideoAd.OnErrorCallback): void
+    /** 监听激励视频广告加载事件。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/RewardedVideoAd.onLoad.html
+     */
+    onLoad(callback: RewardedVideoAd.OnLoadCallback): void
+  }
+  namespace RewardedVideoAd {
+    interface OnErrorCallbackResult extends TaroGeneral.CallbackResult {
+      /** 错误码
+       * @see /docs/apis/General#aderrcode
+       */
+      errCode: keyof TaroGeneral.AdErrCode
+      /** 错误信息 */
+      errMsg: string
+    }
+    interface OnCloseCallbackResult {
+      /** 视频是否是在用户完整观看的情况下被关闭的 */
+      isEnded: boolean
+    }
+    /** 用户点击 `关闭广告` 按钮的事件的回调函数 */
+    type OnCloseCallback = (result: OnCloseCallbackResult) => void
+    /** 激励视频错误事件的回调函数 */
+    type OnErrorCallback = (result: OnErrorCallbackResult) => void
+    /** 激励视频广告加载事件的回调函数 */
+    type OnLoadCallback = (res: TaroGeneral.CallbackResult) => void
+  }
+
+  interface TaroStatic {
+    /** 创建激励视频广告组件。
+     * @supported weapp, tt, swan
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/wx.createRewardedVideoAd.html
+     */
+    createRewardedVideoAd (option: createRewardedVideoAd.Option): RewardedVideoAd
+
+    /** 创建插屏广告组件。
+     * 请通过 getSystemInfoSync 返回对象的 SDKVersion 判断基础库版本号后再使用该 API。每次调用该方法创建插屏广告都会返回一个全新的实例（小程序端的插屏广告实例不允许跨页面使用）。
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ad/wx.createInterstitialAd.html
+     */
+    createInterstitialAd (option: createInterstitialAd.Option): InterstitialAd
+  }
+}

package/types/api/ai/face.d.ts

@@ -0,0 +1,133 @@
+import Taro from '../../index'
+
+declare module '../../index' {
+  namespace stopFaceDetect {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace initFaceDetect {
+    interface Option {
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: TaroGeneral.CallbackResult) => void
+    }
+  }
+
+  namespace faceDetect {
+    interface Option {
+      /** 图像像素点数据，每四项表示一个像素点的 RGBA */
+      frameBuffer: ArrayBuffer
+      /** 图像宽度 */
+      width: number
+      /** 图像高度 */
+      height: number
+      /** 是否返回当前图像的人脸（106 个点）
+       * @default false
+       */
+      enablePoint?: boolean
+      /** 是否返回当前图像的人脸的置信度（可表示器官遮挡情况）
+       * @default false
+       */
+      enableConf?: boolean
+      /** 是否返回当前图像的人脸角度信息
+       * @default false
+       */
+      enableAngle?: boolean
+      /** 是否返回多张人脸的信息
+       * @default false
+       */
+      enableMultiFace?: boolean
+      /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+      complete?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用失败的回调函数 */
+      fail?: (res: TaroGeneral.CallbackResult) => void
+      /** 接口调用成功的回调函数 */
+      success?: (res: SuccessCallbackOption) => void
+    }
+
+    interface SuccessCallbackOption extends face {
+      /** 多人模式（enableMultiFace）下的人脸信息，每个对象包含上述其它属性 */
+      faceInfo?: face
+    }
+
+    interface face {
+      /** 脸部正方框数值，对象包含 height, weight, originX, originY 四个属性 */
+      detectRect: detectRect
+      /** 脸部中心点横坐标，检测不到人脸则为 -1 */
+      x: number
+      /** 脸部中心点纵坐标，检测不到人脸则为 -1 */
+      y: number
+      /** 人脸 106 个点位置数组，数组每个对象包含 x 和 y */
+      pointArray: point[]
+      /** 人脸置信度，取值范围 [0, 1]，数值越大置信度越高（遮挡越少） */
+      confArray: conf[]
+      /** 人脸角度信息，取值范围 [-1, 1]，数值越接近 0 表示越正对摄像头 */
+      angleArray: angle[]
+    }
+
+    /** 脸部正方框数值 */
+    interface detectRect {
+      height: number
+      weight: number
+      originX: number
+      originY: number
+    }
+
+    interface point {
+      x: number
+      y: number
+    }
+
+    interface conf {
+      /** 整体可信度 */
+      global: number
+      /** 左眼可信度 */
+      leftEye: number
+      /** 右眼可信度 */
+      rightEye: number
+      /** 嘴巴可信度 */
+      mouth: number
+      /** 鼻子可信度 */
+      nose: number
+    }
+
+    interface angle {
+      /** 仰俯角（点头） */
+      pitch: number
+      /** 偏航角（摇头） */
+      yaw: number
+      /** 翻滚角（左右倾） */
+      roll: number
+    }
+  }
+
+  interface TaroStatic {
+    /** 停止人脸识别
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/face/wx.stopFaceDetect.html
+     */
+    stopFaceDetect (option: stopFaceDetect.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 初始化人脸识别
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/face/wx.initFaceDetect.html
+     */
+    initFaceDetect (option: initFaceDetect.Option): Promise<TaroGeneral.CallbackResult>
+
+    /** 人脸识别，使用前需要通过 Taro.initFaceDetect 进行一次初始化，推荐使用相机接口返回的帧数据
+     * @supported weapp
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/ai/face/wx.faceDetect.html
+     */
+    faceDetect (option: faceDetect.Option): Promise<TaroGeneral.CallbackResult>
+  }
+}