@tarojs/taro 4.0.0-beta.9 → 4.0.0-beta.91

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tarojs/taro",
-  "version": "4.0.0-beta.9",
+  "version": "4.0.0-beta.91",
   "description": "Taro framework",
   "homepage": "https://github.com/nervjs/taro/tree/master/packages/taro#readme",
   "main": "index.js",
@@ -21,17 +21,17 @@
   "author": "O2Team",
   "license": "MIT",
   "dependencies": {
-    "@tarojs/api": "4.0.0-beta.9"
+    "@tarojs/api": "4.0.0-beta.91"
   },
   "devDependencies": {
-    "@tarojs/helper": "4.0.0-beta.9",
-    "@tarojs/shared": "4.0.0-beta.9",
-    "@tarojs/runtime": "4.0.0-beta.9"
+    "@tarojs/helper": "4.0.0-beta.91",
+    "@tarojs/runtime": "4.0.0-beta.91",
+    "@tarojs/shared": "4.0.0-beta.91"
   },
   "peerDependencies": {
-    "@tarojs/shared": "~4.0.0-beta.9",
-    "@tarojs/helper": "~4.0.0-beta.9",
-    "@tarojs/runtime": "~4.0.0-beta.9"
+    "@tarojs/shared": "~4.0.0-beta.91",
+    "@tarojs/helper": "~4.0.0-beta.91",
+    "@tarojs/runtime": "~4.0.0-beta.91"
   },
   "peerDependenciesMeta": {
     "@types/react": {

package/types/api/base/env.d.ts

@@ -9,7 +9,7 @@ declare module '../../index' {
     env: {
       [key: string]: string | undefined
       /** 框架 */
-      FRAMEWORK: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
+      FRAMEWORK: 'react' | 'preact' | 'solid' | 'nerv' | 'vue' | 'vue3'
       /** Taro 环境变量 */
       TARO_ENV: 'weapp' | 'h5' | 'rn' | 'swan' | 'alipay' | 'tt' | 'qq' | 'jd' | 'quickapp'
       /** 文件系统中的用户目录路径 (本地路径) */

package/types/api/base/performance.d.ts

@@ -191,7 +191,7 @@ declare module '../../index' {
       src: string
     }
     interface Option {
-      data: AssetsObjectType[]
+      data: AssetsObject[]
       /** 接口调用结束的回调函数（调用成功、失败都会执行） */
       complete?: (res: TaroGeneral.CallbackResult) => void
       /** 接口调用失败的回调函数 */

package/types/api/media/image.d.ts

@@ -315,10 +315,10 @@ declare module '../../index' {
       '4:5'
       /** 宽高比为5比4 */
       '5:4'
-      /** 宽高比为6比19 */
-      '6:19'
-      /** 宽高比为19比6 */
-      '19:6'
+      /** 宽高比为9比16 */
+      '9:16'
+      /** 宽高比为16比9 */
+      '16:9'
     }
   }
 

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

@@ -256,7 +256,7 @@ declare module '../../index' {
     ): T
 
     /** Taro.getStorageInfo 的同步版本
-     * @supported weapp, alipay, swan, jd, qq, tt, h5, rn, harmony_hybrid
+     * @supported weapp, alipay, swan, jd, qq, tt, h5, harmony_hybrid
      * @example
      * ```tsx
      * try {

package/types/api/ui/interaction.d.ts

@@ -238,7 +238,7 @@ declare module '../../index' {
     showActionSheet(option: showActionSheet.Option): Promise<showActionSheet.SuccessCallbackResult>
 
     /** 隐藏消息提示框
-     * @supported weapp, h5, rn, tt, harmony, harmony_hybrid
+     * @supported weapp, h5, rn, tt, harmony_hybrid
      * @see https://developers.weixin.qq.com/miniprogram/dev/api/ui/interaction/wx.hideToast.html
      */
     hideToast(option?: hideToast.Option): void

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

@@ -66,19 +66,25 @@ declare module '../../index' {
   }
 
   namespace IntersectionObserver {
-    /** 监听相交状态变化的回调函数 */
+    /** 监听相交状态变化的回调函数
+     * @description Harmony 找不到对应元素时，回调会返回一个 Error 对象
+     */
     type ObserveCallback = (result: ObserveCallbackResult) => void
-    interface ObserveCallbackResult {
+    interface ObserveCallbackResult extends TaroGeneral.CallbackResult {
+      /** 错误信息，会在找不到对应元素时返回
+       * @supported harmony
+       */
+      errMsg?: string
       /** 目标边界 */
-      boundingClientRect: BoundingClientRectResult
+      boundingClientRect?: BoundingClientRectResult
       /** 相交比例 */
-      intersectionRatio: number
+      intersectionRatio?: number
       /** 相交区域的边界 */
-      intersectionRect: IntersectionRectResult
+      intersectionRect?: IntersectionRectResult
       /** 参照区域的边界 */
-      relativeRect: RelativeRectResult
+      relativeRect?: RelativeRectResult
       /** 相交检测时的时间戳 */
-      time: number
+      time?: number
     }
     /** 参照区域的边界 */
     interface RelativeRectResult {

package/types/compile/config/h5.d.ts

@@ -5,6 +5,7 @@ import type HtmlWebpackPlugin from 'html-webpack-plugin'
 import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
 import type { OutputOptions as RollupOutputOptions } from 'rollup'
 import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { OutputExt } from './project'
 
 export interface IH5RouterConfig {
   /** 配置路由模式 */
@@ -40,7 +41,9 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   /** webpack 编译模式下，可用于修改、拓展 Webpack 的 output 选项，配置项参考[官方文档](https://webpack.js.org/configuration/output/)
   * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/)
   */
-  output?: T extends 'vite' ? Pick<RollupOutputOptions, 'chunkFileNames' | 'assetFileNames' > : Webpack.Configuration['output']
+  output?: T extends 'vite'
+    ? Pick<RollupOutputOptions, 'chunkFileNames' | 'assetFileNames'>  & OutputExt
+    : Webpack.Configuration['output']
 
   /** 路由相关的配置 */
   router?: IH5RouterConfig
@@ -100,7 +103,7 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   /** 配置需要额外的经由 Taro 预设的 postcss 编译的模块 */
   esnextModules?: string[]
 
-  /** 用于控制在 H5 端是否使用兼容性组件库，详情请看 [React 兼容性组件库](https://taro-docs.jd.com/docs/next/h5#react-兼容性组件库)。(默认值：false) */
+  /** 用于控制在 H5 端是否使用兼容性组件库，详情请看 [React 兼容性组件库](https://taro-docs.jd.com/docs/h5#react-兼容性组件库)。(默认值：false) */
   useHtmlComponents?: boolean
 
   /** 用于控制在 H5 端是否使用旧版本适配器，旧版本采用全局注册组件，懒加载组件相关依赖；新版本适配器会自动注册相关组件，不再需要引入 @tarojs/components/loader 中的全局 defineCustomElements 方法。(默认值：false) */
@@ -120,7 +123,7 @@ export interface IH5Config <T extends CompilerTypes = CompilerWebpackTypes> {
   }
   /** 生成的代码是否要兼容旧版浏览器，值为 true 时，会去读取 package.json 的 browserslist 字段。只在 vite 编译模式下有效 */
   legacy?: T extends 'vite' ? boolean : undefined
-  
+
   /** 使用的编译工具。可选值：webpack4、webpack5、vite */
   compiler?: Compiler<T>
 }

package/types/compile/config/harmony.d.ts

@@ -1,12 +1,17 @@
+import type { OutputOptions as RollupOutputOptions } from 'rollup'
+import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
 
 import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
-import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { OutputExt } from './project'
 
-export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>  {
-  /** Harmony 编译方式 */
-  compiler?: Compiler
+export interface IHarmonyRouterConfig {
+  /** 配置自定义路由 */
+  customRoutes?: IOption
+}
 
+export interface IHarmonyConfig<T extends CompilerTypes = 'vite'> {
   /** Harmony 项目地址 */
   projectPath: string
 
@@ -20,6 +25,24 @@ export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>
    */
   name?: string
 
+  /** oh-package.json 配置 */
+  ohPackage?: {
+    dependencies?: { [name: string]: string }
+    devDependencies?: { [name: string]: string }
+    main?: string
+    [k: string]: any
+  }
+
+  /** ohpm-cli
+   * @default "~/Library/Huawei/ohpm/bin/ohpm"
+   */
+  ohpm?: string
+
+  /** 核心依赖前缀
+   * @description 用于告诉编译内容如何解析核心依赖，传入时将直接使用依赖前缀，同时不会为工程导入核心依赖
+   */
+  chorePackagePrefix?: string
+
   /** 用于告诉 Taro 编译器需要抽取的公共文件 */
   commonChunks?: string[] | ((commonChunks: string[]) => string[])
 
@@ -30,6 +53,16 @@ export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>
     filter?: (filename: string) => boolean
   }
 
+  /** 用于配置半编译模式下的选项 */
+  compileModeSetting?: {
+    componentReplace?: {
+      [key: string]: {
+        current_init: string
+        dependency_define: string
+      }
+    }
+  }
+
   /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
   enableSourceMap?: boolean
 
@@ -47,12 +80,15 @@ export interface IHarmonyConfig<T extends CompilerTypes = CompilerWebpackTypes>
   webpackChain?: (chain: Chain, webpack: typeof Webpack) => void
 
   /** webpack 编译模式下，可用于修改、拓展 Webpack 的 output 选项，配置项参考[官方文档](https://webpack.js.org/configuration/output/)
-  * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/)
-  */
+   * vite 编译模式下，用于修改、扩展 rollup 的 output，目前仅适配 chunkFileNames 和 assetFileNames 两个配置，修改其他配置请使用 vite 插件进行修改。配置想参考[官方文档](https://rollupjs.org/configuration-options/)
+   */
   output?: T extends 'vite'
-    ? Pick<RollupOutputOptions, 'chunkFileNames'>  & OutputExt
+    ? Pick<RollupOutputOptions, 'chunkFileNames'> & OutputExt
     : Webpack.Configuration['output'] & OutputExt
 
+  /** 路由相关的配置 */
+  router?: IHarmonyRouterConfig
+
   /** 配置 postcss 相关插件 */
   postcss?: IPostcssOption<'harmony'>
 

package/types/compile/config/mini.d.ts

@@ -3,6 +3,7 @@ import type Chain from 'webpack-chain'
 import type { IOption, IPostcssOption, IUrlLoaderOption } from './util'
 import type { OutputOptions as RollupOutputOptions } from 'rollup'
 import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
+import type { OutputExt } from './project'
 
 interface Runtime {
   enableInnerHTML?: boolean
@@ -14,21 +15,6 @@ interface Runtime {
   enableMutationObserver?: boolean
 }
 
-interface OutputExt {
-  /**
-   * 编译前清空输出目录
-   * @since Taro v3.6.9
-   * @description
-   * - 默认清空输出目录，可设置 clean: false 不清空
-   * - 可设置 clean: { keep: ['project.config.json'] } 保留指定文件
-   * - 注意 clean.keep 不支持函数
-   */
-  clean?: boolean | {
-    /** 保留指定文件不删除 */
-    keep?: Array<string | RegExp> | string | RegExp
-  }
-}
-
 export interface IMiniAppConfig<T extends CompilerTypes = CompilerWebpackTypes> {
   /** 用于控制是否生成 js、css 对应的 sourceMap (默认值：watch 模式下为 true，否则为 false) */
   enableSourceMap?: boolean

package/types/compile/config/project.d.ts

@@ -1,6 +1,7 @@
 import type Webpack from 'webpack'
 import type Chain from 'webpack-chain'
 import type { Input } from 'postcss'
+import type { AppConfig } from '../../index'
 import type { Compiler, CompilerTypes, CompilerWebpackTypes } from '../compiler'
 import type { IModifyChainData } from '../hooks'
 import type { ICopyOptions, IOption, ISassOptions, TogglableOptions } from './util'
@@ -140,7 +141,7 @@ export interface IProjectBaseConfig {
   baseLevel?: number
 
   /** 使用的开发框架。可选值：react、preact、nerv、vue、vue3 */
-  framework?: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
+  framework?: 'react' | 'preact' | 'solid' | 'nerv' | 'vue' | 'vue3'
   frameworkExts?: string[]
 
   /** 使用的编译工具。可选值：webpack4、webpack5 */
@@ -177,6 +178,8 @@ export interface IProjectBaseConfig {
 
   onWebpackChainReady?: (webpackChain: Chain) => Promise<any>
 
+  modifyAppConfig?: (appConfig: AppConfig) => Promise<any>
+
   /**
    * 编译中修改 webpack 配置，在这个钩子中，你可以对 webpackChain 作出想要的调整，等同于配置 [`webpackChain`](./config-detail#miniwebpackchain)
    */
@@ -294,7 +297,7 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
   presets?: PluginItem[]
 
   /** 使用的开发框架。可选值：react、preact、nerv、vue、vue3 */
-  framework?: 'react' | 'preact' | 'nerv' | 'vue' | 'vue3'
+  framework?: 'react' | 'preact' | 'solid' | 'nerv' | 'vue' | 'vue3'
 
   /** Webpack5 持久化缓存配置。具体配置请参考 [WebpackConfig.cache](https://webpack.js.org/configuration/cache/#cache) */
   cache?: ICache
@@ -318,3 +321,18 @@ export interface IProjectConfig<T extends CompilerTypes = CompilerWebpackTypes>
 
   [key: string]: any
 }
+
+export interface OutputExt {
+  /**
+   * 编译前清空输出目录
+   * @since Taro v3.6.9
+   * @description
+   * - 默认清空输出目录，可设置 clean: false 不清空
+   * - 可设置 clean: { keep: ['project.config.json'] } 保留指定文件
+   * - 注意 clean.keep 不支持函数
+   */
+  clean?: boolean | {
+    /** 保留指定文件不删除 */
+    keep?: Array<string | RegExp> | string | RegExp
+  }
+}

package/types/compile/config/rn.d.ts

@@ -20,7 +20,7 @@ export interface IRNConfig {
   /** [less](https://lesscss.org/usage/#less-options) 相关配置 */
   less?: IOption
 
-  /** [stylus](https://github.com/NervJS/taro/blob/next/packages/taro-rn-style-transformer/README.md#rnstylus) 相关配置 */
+  /** [stylus](https://github.com/NervJS/taro/blob/main/packages/taro-rn-style-transformer/README.md#rnstylus) 相关配置 */
   stylus?: IOption
 
   /** 配置 postcss 相关插件 */

package/types/compile/index.d.ts

@@ -1,3 +1,11 @@
 export { Current } from '@tarojs/runtime'
 
+export interface IFileType {
+  style: string
+  script: string
+  templ: string
+  config: string
+  xs?: string
+}
+
 export * from './config'

package/types/compile/viteCompilerContext.d.ts

@@ -1,9 +1,10 @@
 import type { RecursiveTemplate, UnRecursiveTemplate } from '@tarojs/shared/dist/template'
+import type { AppConfig, PageConfig } from '@tarojs/taro'
 import type { PluginContext } from 'rollup'
-import type { AppConfig, PageConfig } from '../index'
 import type { IMiniFilesConfig, IH5Config, IHarmonyConfig, IMiniAppConfig } from './config'
 import type { IProjectConfig } from './config/project'
 import type { IComponentConfig } from './hooks'
+import type { IFileType } from './index'
 
 export interface ViteNativeCompMeta {
   name: string
@@ -13,6 +14,7 @@ export interface ViteNativeCompMeta {
   isNative: true
   templatePath: string
   cssPath?: string
+  isPackage?: boolean
 }
 
 export interface ViteFileType {
@@ -41,7 +43,6 @@ export interface VitePageMeta {
   cssPath?: string
 }
 
-
 export interface ViteH5BuildConfig extends CommonBuildConfig, IH5Config<'vite'> {
   entryFileName?: string
   runtimePath?: string | string[]
@@ -53,6 +54,7 @@ export interface ViteHarmonyBuildConfig extends CommonBuildConfig, IHarmonyConfi
   useJSON5?: boolean
   blended?: boolean
   runtimePath?: string | string[]
+  isPure?: boolean
   taroComponentsPath: string
 }
 
@@ -132,10 +134,11 @@ export interface ViteHarmonyCompilerContext extends ViteCompilerContext<ViteHarm
   nativeExt: string[]
   fileType: ViteFileType
   commonChunks: string[]
+  extraComponents: string[]
   nativeComponents : Map<string, ViteNativeCompMeta>
   getCommonChunks: () => string[]
   modifyHarmonyConfig: (config: Partial<AppConfig>) => void
-  modifyHostPackageDep: (outDir: string, deps?: Record<string, string>, devDeps?: Record<string, string>) => void
+  modifyHostPackage: (deps?: Record<string, string>, devDeps?: Record<string, string>) => Exclude<IHarmonyConfig['ohPackage'], void>
   collectNativeComponents: (meta: ViteAppMeta | VitePageMeta | ViteNativeCompMeta) => void
   getScriptPath: (filePath: string) => string
   getStylePath: (filePath: string) => string

package/types/taro.component.d.ts

@@ -19,6 +19,7 @@ declare module './index' {
     shareTicket: string | undefined
     scene: number | undefined
     exitState?: any
+    $taroPath?: string
   }
 
   interface Show {
@@ -139,5 +140,7 @@ declare module './index' {
     path?: string
     /** 页面的组件选项 */
     options?: Record<string, unknown>
+    /** 获得一个 EventChannel 对象，用于页面间通讯 */
+    getOpenerEventChannel?(): Record<string, any>
   }
 }

package/types/taro.config.d.ts

@@ -32,6 +32,11 @@ declare module './index' {
      * @default: "#ffffff"
      */
     backgroundColor?: string
+    /** 页面容器背景色， HexColor
+     * @see: https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/custom-route.html#%E8%AE%BE%E7%BD%AE%E9%A1%B5%E9%9D%A2%E9%80%8F%E6%98%8E
+     * @default: "#ffffff"
+     */
+    backgroundColorContent?: string
     /** 下拉背景字体、loading 图的样式，仅支持 dark/light
      * 当 app.json 中配置 darkmode 为 true 时可通过变量的形式配置
      * @see: https://developers.weixin.qq.com/miniprogram/dev/framework/ability/darkmode.html
@@ -424,7 +429,7 @@ declare module './index' {
     decodeQuery?: 'disable'
   }
 
-  interface AppConfig {
+  export interface AppConfig {
     /** 小程序默认启动首页，未指定 entryPagePath 时，数组的第一项代表小程序的初始页面（首页）。 */
     entryPagePath?: string
     /** 接受一个数组，每一项都是字符串，来指定小程序由哪些页面组成，数组的第一项代表小程序的初始页面 */
@@ -561,7 +566,7 @@ declare module './index' {
      */
     themeLocation?: string
     /** 配置自定义组件代码按需注入 */
-    lazyCodeLoading?: string
+    lazyCodeLoading?: 'requiredComponents' | string
     /** 单页模式相关配置 */
     singlePage?: SinglePage
     /** 聊天素材小程序打开相关配置