feat(mp): 完善注释

src/mp/ensureInMiniProgram.ts

@@ -2,6 +2,12 @@ import { inMiniProgram } from '../utils'
 
 let $mp: ReturnType<typeof inMiniProgram> | undefined
 
+/**
+ * 确保当前在小程序环境并执行回调。
+ *
+ * @param cb 要执行的回调，第一个参数为小程序 API 挂载的全局变量
+ * @returns 返回回调的执行结果
+ */
 export function ensureInMiniProgram<T>(
   cb: (mp: Exclude<typeof $mp, false | undefined>) => T,
 ): T {

src/mp/navigatePageBack.ts

@@ -1,5 +1,10 @@
 import { ensureInMiniProgram } from './ensureInMiniProgram'
 
+/**
+ * 关闭当前页面，返回上一页面或多级页面。
+ *
+ * @param delta 返回的页面数，如果 delta 大于现有页面数，则返回到首页
+ */
 export function navigatePageBack(delta = 1): Promise<any> {
   return ensureInMiniProgram(
     mp =>

src/mp/navigatePageTo.ts

@@ -3,6 +3,13 @@ import { createUrlQueryString, isUrl } from '../utils'
 import { ensureInMiniProgram } from './ensureInMiniProgram'
 import { getMiniProgramConfig } from './miniProgramConfig'
 
+/**
+ * 跳转至某个页面。
+ *
+ * @param url 要跳转去的页面地址
+ * @param query 查询参数
+ * @param redirect 是否关闭当前页面后跳转
+ */
 export function navigatePageTo(
   url: string,
   query?: AnyObject,

src/mp/redirectPageTo.ts

@@ -1,5 +1,11 @@
 import { navigatePageTo } from './navigatePageTo'
 
+/**
+ * 关闭当前页面，跳转至某个页面。
+ *
+ * @param url 要跳转去的页面地址
+ * @param query 查询参数
+ */
 export function redirectPageTo(url: string, query?: AnyObject): Promise<any> {
   return navigatePageTo(url, query, true)
 }

src/mp/submit.ts

@@ -1,6 +1,9 @@
 import { createSubmit } from '../utils'
 import { ensureInMiniProgram } from './ensureInMiniProgram'
 
+/**
+ * 对提交类行为的封装。
+ */
 export const submit = createSubmit({
   start(message) {
     ensureInMiniProgram(mp => {