@mptool/all 0.6.4 → 0.7.0

package/lib/index.d.mts

@@ -97,6 +97,7 @@ declare namespace query {
  * @returns 对象的类型
  */
 declare const type: (obj: unknown) => string;
+declare const isFunction: <T extends Function>(obj: unknown) => obj is T;
 
 /**
  * 包装函数，先执行 wrapper ，然后执行原函数
@@ -232,6 +233,7 @@ type PropMethod<Type, TypeConstructor = any> = Type extends (...args: any) => an
 } : never;
 type PropConstructor<Type = any> = (new (...args: any[]) => Type & {}) | (() => Type) | PropMethod<Type>;
 type PropType<T> = PropConstructor<T> | PropConstructor<T>[];
+type InferFromType<Type> = [Type] extends [null] ? any : [Type] extends [ArrayConstructor] ? any[] : [Type] extends [ObjectConstructor] ? WechatMiniprogram.IAnyObject : [Type] extends [BooleanConstructor] ? boolean : [Type] extends [PropConstructor<infer V>] ? unknown extends V ? any : V : Type;
 type RequiredKeys<T> = {
     [K in keyof T]: T[K] extends {
         required: true;
@@ -357,21 +359,22 @@ interface ExtendedComponentMethods extends InstanceEmitterMethods {
      */
     _$attached(parent: TrivialComponentInstance | TrivialPageInstance): void;
 }
-type ComponentInstance<Data extends WechatMiniprogram.Component.DataOption, Property extends PropsOptions, Method extends Partial<WechatMiniprogram.Component.MethodOption>, CustomInstanceProperty extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = WechatMiniprogram.Component.InstanceProperties & WechatMiniprogram.Component.InstanceMethods<Data> & ExtendedComponentMethods & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {}) & CustomInstanceProperty & ExtendedComponentProperty & ExtendedPageMethods<Data & InferPropTypes<Property>, CustomInstanceProperty & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {})> & {
+type ComponentInstance<Data extends WechatMiniprogram.Component.DataOption, Props extends PropsOptions, Method extends Partial<WechatMiniprogram.Component.MethodOption>, InstanceProps extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = WechatMiniprogram.Component.InstanceProperties & WechatMiniprogram.Component.InstanceMethods<Data> & ExtendedComponentMethods & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {}) & InstanceProps & ExtendedComponentProperty & ExtendedPageMethods<Data & InferPropTypes<Props>, InstanceProps & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {})> & {
     /** 组件数据，**包括内部数据和属性值** */
-    data: Data & InferPropTypes<Property>;
+    data: Data & InferPropTypes<Props>;
     /** 组件数据，**包括内部数据和属性值**（与 `data` 一致） */
-    properties: Data & InferPropTypes<Property>;
+    properties: Data & InferPropTypes<Props>;
 };
-type ComponentOptions<Data extends WechatMiniprogram.Component.DataOption, Property extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, CustomInstanceProperty extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = Partial<WechatMiniprogram.Component.Data<Data>> & Partial<{
+type ComponentOptions<Data extends WechatMiniprogram.Component.DataOption, Props extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, InstanceProps extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = Partial<WechatMiniprogram.Component.Data<Data>> & Partial<{
     /** 组件属性 */
-    properties: Property;
-}> & Partial<WechatMiniprogram.Component.Method<Method, IsPage>> & Partial<WechatMiniprogram.Component.OtherOption> & Partial<ComponentLifetimes> & ThisType<ComponentInstance<Data, Property, Method, CustomInstanceProperty, IsPage>>;
-type ComponentConstructor = <Data extends WechatMiniprogram.Component.DataOption, Property extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, CustomInstanceProperty extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false>(options: ComponentOptions<Data, Property, Method, CustomInstanceProperty, IsPage>) => string;
+    props: Props;
+}> & Partial<WechatMiniprogram.Component.Method<Method, IsPage>> & Partial<WechatMiniprogram.Component.OtherOption> & Partial<ComponentLifetimes> & ThisType<ComponentInstance<Data, Props, Method, InstanceProps, IsPage>>;
+type ComponentConstructor = <Data extends WechatMiniprogram.Component.DataOption, Props extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, InstanceProps extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false>(options: ComponentOptions<Data, Props, Method, InstanceProps, IsPage>) => string;
 type TrivialComponentInstance = ComponentInstance<WechatMiniprogram.IAnyObject, Record<string, null>, Record<string, (...args: unknown[]) => any>>;
 type TrivialComponentOptions = ComponentInstance<WechatMiniprogram.IAnyObject, Record<string, null>, Record<string, (...args: any[]) => any>>;
 type RefMap = Record<string, TrivialComponentInstance>;
 
+declare const handleProperties: (oldProps?: PropsOptions) => WechatMiniprogram.Component.PropertyOption;
 /**
  * 组件注册器
  *
@@ -379,6 +382,10 @@ type RefMap = Record<string, TrivialComponentInstance>;
  */
 declare const $Component: ComponentConstructor;
 
+declare const getRef: (id: number) => TrivialComponentInstance;
+declare const setRef: (id: number, value: TrivialComponentInstance) => void;
+declare const removeRef: (id: number) => void;
+
 declare function bind(this: TrivialComponentInstance, touchEvent: WechatMiniprogram.Touch<{
     id: number;
     event: string;
@@ -732,6 +739,14 @@ type AppOptions<Custom> = ExtendsAppOptions & Partial<WechatMiniprogram.App.Opti
 type AppInstance<Custom> = AppOptions<Custom> & Custom & ExtendedAppMethods;
 type AppConstructor = <Custom extends WechatMiniprogram.IAnyObject>(appOptions: AppOptions<Custom>) => void;
 
+declare const appState: {
+    /** 是否已启动 */
+    launch: boolean;
+    /** 启动参数 */
+    lOpt: {};
+    /** 切入后台时的时间戳 */
+    hide: number;
+};
 /**
  * Application wrapper
  *
@@ -739,18 +754,59 @@ type AppConstructor = <Custom extends WechatMiniprogram.IAnyObject>(appOptions:
  */
 declare const $App: AppConstructor;
 
-interface AppConfig {
+interface AppConfigCommonOptions {
     /**
-     * 当你给出的页面路径或简称无法通过 routeMap 解析时，会回退到此路径
+     * 主页页面名称或路径
+     */
+    home?: string;
+    /**
+     * 跳转延迟执行的最长时间，单位 ms
      *
-     * 填入小程序路径模式，小程序路径模式是一个路径字符串，用 `$name` 表示小程序简称的位置
+     * @description 异步 onNavigate 方法用时过久会直接调转
      *
-     * 例子: 你可以填入 `/pages/$name/$name` 来表达:
+     * @default 200
+     */
+    maxDelay?: number;
+    /**
+     * 允许进行跳转据页面首屏渲染后的最小间隔时间，单位 ms
      *
-     * - `main': '/pages/main/main`
-     * - `user': '/pages/user/user`
+     * @default 100
      */
-    defaultRoute: string;
+    minInterval?: number;
+    /**
+     * 自定义扩展组件
+     *
+     * 时机在框架执行扩展之前，可为每个组件挂载实例方法
+     *
+     * @param options 组件选项
+     */
+    extendComponent?(options: TrivialComponentOptions): void;
+    /**
+     * 自定义注入组件
+     *
+     * 时机在框架执行扩展之后，这意味着你可以覆盖框架的方法
+     *
+     * @param options 组件选项
+     */
+    injectComponent?(options: TrivialComponentOptions): void;
+    /**
+     * 自定义扩展页面，在框架执行扩展之前
+     *
+     * @param name 页面名称
+     * @param options 页面选项
+     */
+    extendPage?(name: string, options: TrivialPageOptions): void;
+    /**
+     * 自定义注入页面
+     *
+     * 在框架执行扩展之后，这意味着你可以覆盖框架的方法
+     *
+     * @param name 页面名称
+     * @param options 页面选项
+     */
+    injectPage?(name: string, options: TrivialPageOptions): void;
+}
+interface RoutePathConfig {
     /**
      * 你可以直接以对象形式表示简称到路径的映射。如:
      *
@@ -798,58 +854,47 @@ interface AppConfig {
      */
     routes?: Record<string, string> | [string | string[], string][];
     /**
-     * 主页页面名称或路径
-     */
-    home?: string;
-    /**
-     * 跳转延迟执行的最长时间，单位 ms
+     * 当你给出的页面路径或简称无法通过 routeMap 解析时，会回退到此路径
      *
-     * @description 异步 onNavigate 方法用时过久会直接调转
+     * 填入小程序路径模式，小程序路径模式是一个路径字符串，用 `$name` 表示小程序简称的位置
      *
-     * @default 200
-     */
-    maxDelay?: number;
-    /**
-     * 允许进行跳转据页面首屏渲染后的最小间隔时间，单位 ms
+     * 例子: 你可以填入 `/pages/$name/$name` 来表达:
      *
-     * @default 100
+     * - `main': '/pages/main/main`
+     * - `user': '/pages/user/user`
      */
-    minInterval?: number;
+    defaultRoute: string;
+}
+interface RouteCustomConfig {
     /**
-     * 自定义扩展组件
-     *
-     * 时机在框架执行扩展之前，可为每个组件挂载实例方法
+     * 获得页面简称
      *
-     * @param options 组件选项
+     * @param url 页面路径
+     * @returns 页面名称
      */
-    extendComponent?(options: TrivialComponentOptions): void;
+    getName: (url: string) => string;
     /**
-     * 自定义注入组件
-     *
-     * 时机在框架执行扩展之后，这意味着你可以覆盖框架的方法
+     * 获得页面路径
      *
-     * @param options 组件选项
+     * @param pageName 页面简称
+     * @returns 页面路径
      */
-    injectComponent?(options: TrivialComponentOptions): void;
+    getRoute: (pageName: string) => string;
+}
+type AppConfigOptions = AppConfigCommonOptions & (RoutePathConfig | RouteCustomConfig);
+
+interface Config extends Omit<AppConfigOptions, "defaultRoute" | "routeMap"> {
     /**
-     * 自定义扩展页面，在框架执行扩展之前
-     *
-     * @param name 页面名称
-     * @param options 页面选项
+     * @returns name
      */
-    extendPage?(name: string, options: TrivialPageOptions): void;
+    getName: (url: string) => string;
     /**
-     * 自定义注入页面
-     *
-     * 在框架执行扩展之后，这意味着你可以覆盖框架的方法
-     *
-     * @param name 页面名称
-     * @param options 页面选项
+     * @returns route
      */
-    injectPage?(name: string, options: TrivialPageOptions): void;
+    getRoute: (pageName: string) => string;
 }
-
-declare const $Config: (config: AppConfig) => void;
+declare const $Config: (config: AppConfigOptions) => void;
+declare const getConfig: () => Config;
 
 /** 文件编码 */
 type FileEncoding = "utf-8" | "ascii" | "base64" | "binary" | "hex" | "ucs2" | "ucs-2" | "utf16le" | "utf-16le" | "utf8" | "latin1";
@@ -1062,6 +1107,7 @@ interface CookieType {
     sameSite?: string | undefined;
 }
 
+declare const getCookieScopeDomain: (domain?: string) => string[];
 /**
  * Cookie 类
  */
@@ -1099,7 +1145,6 @@ declare class Cookie {
  * @see RFC 6265
  */
 declare const normalizeDomain: (domain?: string) => string;
-declare const getCookieScopeDomain: (domain?: string) => string[];
 interface UrlInfo {
     domain: string;
     path: string;
@@ -1746,4 +1791,4 @@ declare const getRichTextNodes: (content: string | AnyNode[], { appendClass, tra
 
 declare const getText: (content: string | AnyNode[]) => string;
 
-export { $App, $Component, $Config, $Page, ALLOWED_TAGS, type AllowTag, type AppConfig, type AppConstructor, type AppInstance, type AppOptions, type ComponentConstructor, type ComponentInstance, type ComponentLifetimes, type ComponentOptions, Cookie, type CookieMap, type CookieOptions, CookieStore, type CookieStoreType, type CookieType, type ElementNode, Emitter, type EmitterInstance, type EventHandlerList, type EventHandlerMap, type EventType, type ExtendedAppMethods, type ExtendedComponentMethods, type ExtendedComponentProperty, type ExtendsAppOptions, type Handler, Headers, type HeadersInit, type PageConstructor, type PageInstance, type PageOptions, type PageQuery, type PageState, type PropType, Queue, type RefMap, type RequestBody, type RequestError, type RequestFactory, type RequestInitOptions, type RequestOptions, type RequestResponse, type RequestType, type RichTextNode, type SetCookieOptions, type StorageData, type Task, type TextNode, type TrivialComponentInstance, type TrivialComponentOptions, type TrivialPageInstance, type TrivialPageOptions, URLSearchParams, type UrlInfo, type WildCardEventHandlerList, type WildcardHandler, check, checkAsync, createRequest, decode as decodeBase64, dirname, userEmitter as emitter, encode as encodeBase64, exists, funcQueue, get, getAsync, getCookieOptions, getCookieScopeDomain, getDomain, getRichTextNodes, getText, isDir, isFile, isMp, isQQ, isWx, lock, logger, ls, mkdir, normalizeDomain, once, parseCookieHeader, parseHTML, parseUrl, put, query, readFile, readJSON, remove, removeAsync, request, requestCookieStore, rm, saveFile, saveOnlineFile, set, setAsync, storage, take, type, unzip, wrapFunction, writeFile, writeJSON };
+export { $App, $Component, $Config, $Page, ALLOWED_TAGS, type AllowTag, type AppConfigCommonOptions, type AppConfigOptions, type AppConstructor, type AppInstance, type AppOptions, type ComponentConstructor, type ComponentInstance, type ComponentLifetimes, type ComponentOptions, type Config, Cookie, type CookieMap, type CookieOptions, CookieStore, type CookieStoreType, type CookieType, type ElementNode, Emitter, type EmitterInstance, type EventHandlerList, type EventHandlerMap, type EventType, type ExtendedAppMethods, type ExtendedComponentMethods, type ExtendedComponentProperty, type ExtendedPageLifeCycles, type ExtendedPageMethods, type ExtendedPageProperties, type ExtendsAppOptions, type Handler, Headers, type HeadersInit, type InferFromType, type InferPropType, type InferPropTypes, type PageConstructor, type PageInstance, type PageOptions, type PageQuery, type PageState, type PropItem, type PropOption, type PropType, type Props, type PropsOptions, Queue, type RefMap, type RequestBody, type RequestError, type RequestFactory, type RequestInitOptions, type RequestOptions, type RequestResponse, type RequestType, type RichTextNode, type RouteCustomConfig, type RoutePathConfig, type SetCookieOptions, type StorageData, type Task, type TextNode, type TrivialComponentInstance, type TrivialComponentOptions, type TrivialPageInstance, type TrivialPageOptions, URLSearchParams, type UrlInfo, type WildCardEventHandlerList, type WildcardHandler, appState, check, checkAsync, createRequest, decode as decodeBase64, dirname, userEmitter as emitter, encode as encodeBase64, exists, funcQueue, get, getAsync, getConfig, getCookieOptions, getCookieScopeDomain, getDomain, getRef, getRichTextNodes, getText, handleProperties, isDir, isFile, isFunction, isMp, isQQ, isWx, lock, logger, ls, mkdir, normalizeDomain, once, parseCookieHeader, parseHTML, parseUrl, put, query, readFile, readJSON, remove, removeAsync, removeRef, request, requestCookieStore, rm, saveFile, saveOnlineFile, set, setAsync, setRef, storage, take, type, unzip, wrapFunction, writeFile, writeJSON };

package/lib/index.d.ts

@@ -97,6 +97,7 @@ declare namespace query {
  * @returns 对象的类型
  */
 declare const type: (obj: unknown) => string;
+declare const isFunction: <T extends Function>(obj: unknown) => obj is T;
 
 /**
  * 包装函数，先执行 wrapper ，然后执行原函数
@@ -232,6 +233,7 @@ type PropMethod<Type, TypeConstructor = any> = Type extends (...args: any) => an
 } : never;
 type PropConstructor<Type = any> = (new (...args: any[]) => Type & {}) | (() => Type) | PropMethod<Type>;
 type PropType<T> = PropConstructor<T> | PropConstructor<T>[];
+type InferFromType<Type> = [Type] extends [null] ? any : [Type] extends [ArrayConstructor] ? any[] : [Type] extends [ObjectConstructor] ? WechatMiniprogram.IAnyObject : [Type] extends [BooleanConstructor] ? boolean : [Type] extends [PropConstructor<infer V>] ? unknown extends V ? any : V : Type;
 type RequiredKeys<T> = {
     [K in keyof T]: T[K] extends {
         required: true;
@@ -357,21 +359,22 @@ interface ExtendedComponentMethods extends InstanceEmitterMethods {
      */
     _$attached(parent: TrivialComponentInstance | TrivialPageInstance): void;
 }
-type ComponentInstance<Data extends WechatMiniprogram.Component.DataOption, Property extends PropsOptions, Method extends Partial<WechatMiniprogram.Component.MethodOption>, CustomInstanceProperty extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = WechatMiniprogram.Component.InstanceProperties & WechatMiniprogram.Component.InstanceMethods<Data> & ExtendedComponentMethods & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {}) & CustomInstanceProperty & ExtendedComponentProperty & ExtendedPageMethods<Data & InferPropTypes<Property>, CustomInstanceProperty & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {})> & {
+type ComponentInstance<Data extends WechatMiniprogram.Component.DataOption, Props extends PropsOptions, Method extends Partial<WechatMiniprogram.Component.MethodOption>, InstanceProps extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = WechatMiniprogram.Component.InstanceProperties & WechatMiniprogram.Component.InstanceMethods<Data> & ExtendedComponentMethods & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {}) & InstanceProps & ExtendedComponentProperty & ExtendedPageMethods<Data & InferPropTypes<Props>, InstanceProps & Method & (IsPage extends true ? WechatMiniprogram.Page.ILifetime : {})> & {
     /** 组件数据，**包括内部数据和属性值** */
-    data: Data & InferPropTypes<Property>;
+    data: Data & InferPropTypes<Props>;
     /** 组件数据，**包括内部数据和属性值**（与 `data` 一致） */
-    properties: Data & InferPropTypes<Property>;
+    properties: Data & InferPropTypes<Props>;
 };
-type ComponentOptions<Data extends WechatMiniprogram.Component.DataOption, Property extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, CustomInstanceProperty extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = Partial<WechatMiniprogram.Component.Data<Data>> & Partial<{
+type ComponentOptions<Data extends WechatMiniprogram.Component.DataOption, Props extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, InstanceProps extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false> = Partial<WechatMiniprogram.Component.Data<Data>> & Partial<{
     /** 组件属性 */
-    properties: Property;
-}> & Partial<WechatMiniprogram.Component.Method<Method, IsPage>> & Partial<WechatMiniprogram.Component.OtherOption> & Partial<ComponentLifetimes> & ThisType<ComponentInstance<Data, Property, Method, CustomInstanceProperty, IsPage>>;
-type ComponentConstructor = <Data extends WechatMiniprogram.Component.DataOption, Property extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, CustomInstanceProperty extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false>(options: ComponentOptions<Data, Property, Method, CustomInstanceProperty, IsPage>) => string;
+    props: Props;
+}> & Partial<WechatMiniprogram.Component.Method<Method, IsPage>> & Partial<WechatMiniprogram.Component.OtherOption> & Partial<ComponentLifetimes> & ThisType<ComponentInstance<Data, Props, Method, InstanceProps, IsPage>>;
+type ComponentConstructor = <Data extends WechatMiniprogram.Component.DataOption, Props extends PropsOptions, Method extends WechatMiniprogram.Component.MethodOption, InstanceProps extends WechatMiniprogram.IAnyObject = {}, IsPage extends boolean = false>(options: ComponentOptions<Data, Props, Method, InstanceProps, IsPage>) => string;
 type TrivialComponentInstance = ComponentInstance<WechatMiniprogram.IAnyObject, Record<string, null>, Record<string, (...args: unknown[]) => any>>;
 type TrivialComponentOptions = ComponentInstance<WechatMiniprogram.IAnyObject, Record<string, null>, Record<string, (...args: any[]) => any>>;
 type RefMap = Record<string, TrivialComponentInstance>;
 
+declare const handleProperties: (oldProps?: PropsOptions) => WechatMiniprogram.Component.PropertyOption;
 /**
  * 组件注册器
  *
@@ -379,6 +382,10 @@ type RefMap = Record<string, TrivialComponentInstance>;
  */
 declare const $Component: ComponentConstructor;
 
+declare const getRef: (id: number) => TrivialComponentInstance;
+declare const setRef: (id: number, value: TrivialComponentInstance) => void;
+declare const removeRef: (id: number) => void;
+
 declare function bind(this: TrivialComponentInstance, touchEvent: WechatMiniprogram.Touch<{
     id: number;
     event: string;
@@ -732,6 +739,14 @@ type AppOptions<Custom> = ExtendsAppOptions & Partial<WechatMiniprogram.App.Opti
 type AppInstance<Custom> = AppOptions<Custom> & Custom & ExtendedAppMethods;
 type AppConstructor = <Custom extends WechatMiniprogram.IAnyObject>(appOptions: AppOptions<Custom>) => void;
 
+declare const appState: {
+    /** 是否已启动 */
+    launch: boolean;
+    /** 启动参数 */
+    lOpt: {};
+    /** 切入后台时的时间戳 */
+    hide: number;
+};
 /**
  * Application wrapper
  *
@@ -739,18 +754,59 @@ type AppConstructor = <Custom extends WechatMiniprogram.IAnyObject>(appOptions:
  */
 declare const $App: AppConstructor;
 
-interface AppConfig {
+interface AppConfigCommonOptions {
     /**
-     * 当你给出的页面路径或简称无法通过 routeMap 解析时，会回退到此路径
+     * 主页页面名称或路径
+     */
+    home?: string;
+    /**
+     * 跳转延迟执行的最长时间，单位 ms
      *
-     * 填入小程序路径模式，小程序路径模式是一个路径字符串，用 `$name` 表示小程序简称的位置
+     * @description 异步 onNavigate 方法用时过久会直接调转
      *
-     * 例子: 你可以填入 `/pages/$name/$name` 来表达:
+     * @default 200
+     */
+    maxDelay?: number;
+    /**
+     * 允许进行跳转据页面首屏渲染后的最小间隔时间，单位 ms
      *
-     * - `main': '/pages/main/main`
-     * - `user': '/pages/user/user`
+     * @default 100
      */
-    defaultRoute: string;
+    minInterval?: number;
+    /**
+     * 自定义扩展组件
+     *
+     * 时机在框架执行扩展之前，可为每个组件挂载实例方法
+     *
+     * @param options 组件选项
+     */
+    extendComponent?(options: TrivialComponentOptions): void;
+    /**
+     * 自定义注入组件
+     *
+     * 时机在框架执行扩展之后，这意味着你可以覆盖框架的方法
+     *
+     * @param options 组件选项
+     */
+    injectComponent?(options: TrivialComponentOptions): void;
+    /**
+     * 自定义扩展页面，在框架执行扩展之前
+     *
+     * @param name 页面名称
+     * @param options 页面选项
+     */
+    extendPage?(name: string, options: TrivialPageOptions): void;
+    /**
+     * 自定义注入页面
+     *
+     * 在框架执行扩展之后，这意味着你可以覆盖框架的方法
+     *
+     * @param name 页面名称
+     * @param options 页面选项
+     */
+    injectPage?(name: string, options: TrivialPageOptions): void;
+}
+interface RoutePathConfig {
     /**
      * 你可以直接以对象形式表示简称到路径的映射。如:
      *
@@ -798,58 +854,47 @@ interface AppConfig {
      */
     routes?: Record<string, string> | [string | string[], string][];
     /**
-     * 主页页面名称或路径
-     */
-    home?: string;
-    /**
-     * 跳转延迟执行的最长时间，单位 ms
+     * 当你给出的页面路径或简称无法通过 routeMap 解析时，会回退到此路径
      *
-     * @description 异步 onNavigate 方法用时过久会直接调转
+     * 填入小程序路径模式，小程序路径模式是一个路径字符串，用 `$name` 表示小程序简称的位置
      *
-     * @default 200
-     */
-    maxDelay?: number;
-    /**
-     * 允许进行跳转据页面首屏渲染后的最小间隔时间，单位 ms
+     * 例子: 你可以填入 `/pages/$name/$name` 来表达:
      *
-     * @default 100
+     * - `main': '/pages/main/main`
+     * - `user': '/pages/user/user`
      */
-    minInterval?: number;
+    defaultRoute: string;
+}
+interface RouteCustomConfig {
     /**
-     * 自定义扩展组件
-     *
-     * 时机在框架执行扩展之前，可为每个组件挂载实例方法
+     * 获得页面简称
      *
-     * @param options 组件选项
+     * @param url 页面路径
+     * @returns 页面名称
      */
-    extendComponent?(options: TrivialComponentOptions): void;
+    getName: (url: string) => string;
     /**
-     * 自定义注入组件
-     *
-     * 时机在框架执行扩展之后，这意味着你可以覆盖框架的方法
+     * 获得页面路径
      *
-     * @param options 组件选项
+     * @param pageName 页面简称
+     * @returns 页面路径
      */
-    injectComponent?(options: TrivialComponentOptions): void;
+    getRoute: (pageName: string) => string;
+}
+type AppConfigOptions = AppConfigCommonOptions & (RoutePathConfig | RouteCustomConfig);
+
+interface Config extends Omit<AppConfigOptions, "defaultRoute" | "routeMap"> {
     /**
-     * 自定义扩展页面，在框架执行扩展之前
-     *
-     * @param name 页面名称
-     * @param options 页面选项
+     * @returns name
      */
-    extendPage?(name: string, options: TrivialPageOptions): void;
+    getName: (url: string) => string;
     /**
-     * 自定义注入页面
-     *
-     * 在框架执行扩展之后，这意味着你可以覆盖框架的方法
-     *
-     * @param name 页面名称
-     * @param options 页面选项
+     * @returns route
      */
-    injectPage?(name: string, options: TrivialPageOptions): void;
+    getRoute: (pageName: string) => string;
 }
-
-declare const $Config: (config: AppConfig) => void;
+declare const $Config: (config: AppConfigOptions) => void;
+declare const getConfig: () => Config;
 
 /** 文件编码 */
 type FileEncoding = "utf-8" | "ascii" | "base64" | "binary" | "hex" | "ucs2" | "ucs-2" | "utf16le" | "utf-16le" | "utf8" | "latin1";
@@ -1062,6 +1107,7 @@ interface CookieType {
     sameSite?: string | undefined;
 }
 
+declare const getCookieScopeDomain: (domain?: string) => string[];
 /**
  * Cookie 类
  */
@@ -1099,7 +1145,6 @@ declare class Cookie {
  * @see RFC 6265
  */
 declare const normalizeDomain: (domain?: string) => string;
-declare const getCookieScopeDomain: (domain?: string) => string[];
 interface UrlInfo {
     domain: string;
     path: string;
@@ -1746,4 +1791,4 @@ declare const getRichTextNodes: (content: string | AnyNode[], { appendClass, tra
 
 declare const getText: (content: string | AnyNode[]) => string;
 
-export { $App, $Component, $Config, $Page, ALLOWED_TAGS, type AllowTag, type AppConfig, type AppConstructor, type AppInstance, type AppOptions, type ComponentConstructor, type ComponentInstance, type ComponentLifetimes, type ComponentOptions, Cookie, type CookieMap, type CookieOptions, CookieStore, type CookieStoreType, type CookieType, type ElementNode, Emitter, type EmitterInstance, type EventHandlerList, type EventHandlerMap, type EventType, type ExtendedAppMethods, type ExtendedComponentMethods, type ExtendedComponentProperty, type ExtendsAppOptions, type Handler, Headers, type HeadersInit, type PageConstructor, type PageInstance, type PageOptions, type PageQuery, type PageState, type PropType, Queue, type RefMap, type RequestBody, type RequestError, type RequestFactory, type RequestInitOptions, type RequestOptions, type RequestResponse, type RequestType, type RichTextNode, type SetCookieOptions, type StorageData, type Task, type TextNode, type TrivialComponentInstance, type TrivialComponentOptions, type TrivialPageInstance, type TrivialPageOptions, URLSearchParams, type UrlInfo, type WildCardEventHandlerList, type WildcardHandler, check, checkAsync, createRequest, decode as decodeBase64, dirname, userEmitter as emitter, encode as encodeBase64, exists, funcQueue, get, getAsync, getCookieOptions, getCookieScopeDomain, getDomain, getRichTextNodes, getText, isDir, isFile, isMp, isQQ, isWx, lock, logger, ls, mkdir, normalizeDomain, once, parseCookieHeader, parseHTML, parseUrl, put, query, readFile, readJSON, remove, removeAsync, request, requestCookieStore, rm, saveFile, saveOnlineFile, set, setAsync, storage, take, type, unzip, wrapFunction, writeFile, writeJSON };
+export { $App, $Component, $Config, $Page, ALLOWED_TAGS, type AllowTag, type AppConfigCommonOptions, type AppConfigOptions, type AppConstructor, type AppInstance, type AppOptions, type ComponentConstructor, type ComponentInstance, type ComponentLifetimes, type ComponentOptions, type Config, Cookie, type CookieMap, type CookieOptions, CookieStore, type CookieStoreType, type CookieType, type ElementNode, Emitter, type EmitterInstance, type EventHandlerList, type EventHandlerMap, type EventType, type ExtendedAppMethods, type ExtendedComponentMethods, type ExtendedComponentProperty, type ExtendedPageLifeCycles, type ExtendedPageMethods, type ExtendedPageProperties, type ExtendsAppOptions, type Handler, Headers, type HeadersInit, type InferFromType, type InferPropType, type InferPropTypes, type PageConstructor, type PageInstance, type PageOptions, type PageQuery, type PageState, type PropItem, type PropOption, type PropType, type Props, type PropsOptions, Queue, type RefMap, type RequestBody, type RequestError, type RequestFactory, type RequestInitOptions, type RequestOptions, type RequestResponse, type RequestType, type RichTextNode, type RouteCustomConfig, type RoutePathConfig, type SetCookieOptions, type StorageData, type Task, type TextNode, type TrivialComponentInstance, type TrivialComponentOptions, type TrivialPageInstance, type TrivialPageOptions, URLSearchParams, type UrlInfo, type WildCardEventHandlerList, type WildcardHandler, appState, check, checkAsync, createRequest, decode as decodeBase64, dirname, userEmitter as emitter, encode as encodeBase64, exists, funcQueue, get, getAsync, getConfig, getCookieOptions, getCookieScopeDomain, getDomain, getRef, getRichTextNodes, getText, handleProperties, isDir, isFile, isFunction, isMp, isQQ, isWx, lock, logger, ls, mkdir, normalizeDomain, once, parseCookieHeader, parseHTML, parseUrl, put, query, readFile, readJSON, remove, removeAsync, removeRef, request, requestCookieStore, rm, saveFile, saveOnlineFile, set, setAsync, setRef, storage, take, type, unzip, wrapFunction, writeFile, writeJSON };