fix: improve re-export types and jsdoc comment

.vscode/settings.json

@@ -22,6 +22,7 @@
     "esbuild",
     "icss",
     "iife",
+    "importee",
     "jridgewell",
     "jsxdev",
     "kwai",

src/config/design-width.d.ts → src/config/design.d.ts

@@ -18,3 +18,8 @@ export interface DesignWidthInput {
  * @returns 设计稿尺寸
  */
 export type DesignWidth = number | ((input?: number | string | DesignWidthInput) => number)
+
+/**
+ * 设计稿尺寸换算规则
+ */
+export type DesignRatio = Record<string | number, number>

src/config/index.d.ts

@@ -2,7 +2,7 @@ import type { LiteralUnion } from '../utility-types'
 import type { Cache } from './cache'
 import type { Compiler, CompilerTypes, CompilerWebpackTypes } from './compiler'
 import type { Copy } from './copy'
-import type { DesignWidth } from './design-width'
+import type { DesignRatio, DesignWidth } from './design'
 import type { Logger } from './logger'
 import type {
   CSSMinimizer,
@@ -47,7 +47,7 @@ export interface TaroConfig<T extends CompilerTypes = CompilerWebpackTypes> {
   /**
    * 设计稿尺寸换算规则
    */
-  deviceRatio?: Record<number, number>
+  deviceRatio?: DesignRatio
 
   /**
    * 项目源码目录

src/config/packages/postcss-pxtransform.d.ts

@@ -5,16 +5,14 @@
  */
 
 import type { LiteralUnion } from '../../utility-types'
-import type { DesignWidth } from '../design-width'
+import type { DesignRatio, DesignWidth } from '../design'
 
 export type PostcssPxtransformPlatform = LiteralUnion<
   'weapp' | 'h5' | 'rn' | 'quickapp' | 'harmony'
 >
 
 export type PostcssPxtransformTargetUnit = LiteralUnion<'rpx' | 'px' | 'rem' | 'vw'>
 
-export type PostcssPxtransformDeviceRatio = Record<number, number>
-
 export interface PostcssPxtransformOptions {
   /**
    * target platform
@@ -30,7 +28,7 @@ export interface PostcssPxtransformOptions {
    */
   designWidth?: DesignWidth
 
-  deviceRatio?: PostcssPxtransformDeviceRatio
+  deviceRatio?: DesignRatio
 
   /**
    * @default 16

src/config/packages/rollup.d.ts

@@ -2,6 +2,4 @@
  * @file Rollup
  */
 
-import type { OutputOptions } from 'rollup'
-
-export type RollupOutputOptions = OutputOptions
+export type { OutputOptions as RollupOutputOptions, RollupOptions } from 'rollup'

src/config/packages/vite.d.ts

@@ -2,6 +2,4 @@
  * @file Types for `vite`
  */
 
-import type { Plugin } from 'vite'
-
-export type VitePlugin = Plugin
+export type { Plugin as VitePlugin } from 'vite'

src/config/packages/webpack-chain.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @file Types for `webpack-chain`
+ */
+
 import type WebpackChain from 'webpack-chain'
 
 export type ChainableWebpackConfig = WebpackChain

src/config/packages/webpack-dev-server.d.ts

@@ -4,6 +4,4 @@
  * @see https://github.com/webpack/webpack-dev-server
  */
 
-import type { Configuration } from 'webpack-dev-server'
-
-export type DevServerConfiguration = Configuration
+export type { Configuration as DevServerConfiguration } from 'webpack-dev-server'

src/config/platforms/h5.d.ts

@@ -126,13 +126,15 @@ export interface PlatformH5<T extends CompilerTypes = CompilerWebpackTypes>
    * `SourceMap` 类型
    *
    * @see https://nervjs.github.io/taro-docs/docs/config-detail#h5sourcemaptype
+   * @default `cheap-module-eval-source-map`
    */
   sourceMapType?: SourceMapType
 
   /**
    * 用于控制在 H5 端是否使用兼容性组件库
    *
    * @see https://nervjs.github.io/taro-docs/docs/config-detail#h5usehtmlcomponents
+   * @default false
    */
   useHtmlComponents?: boolean