@fjyueke/arco-mcp 1.0.0 → 1.0.2

package/metaData/components/popup/api.md

@@ -0,0 +1,93 @@
+> 属性/Props
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|direction|菜单滑出方向|"left" \| "right" \| "top" \| "bottom"|"bottom"|
+|needBottomOffset|从底部滑出的菜单内容是否适配ipx底部|boolean|false|
+|translateZ|\[即将废弃\] 开启translateZ强制提升|boolean|false|
+|maskTransitionTimeout|菜单蒙层动画时长|number \| \{ appear?: number; enter?: number; exit?: number; \}|{ enter: 450, exit: 240 }|
+|contentTransitionTimeout|菜单内容动画时长|number \| \{ appear?: number; enter?: number; exit?: number; \}|{ enter: 450, exit: 240 }|
+|contentTransitionType|内容过渡动画类名|string|\`slide-from-${props.direction}\`|
+|className|自定义类名|string|-|
+|maskClass|自定义蒙层类名|string|-|
+|maskStyle|自定义蒙层样式|CSSProperties|-|
+|contentClass|自定义内容类名|string|-|
+|contentStyle|自定义内容样式|CSSProperties|-|
+|visible|是否展示菜单（受控）|boolean|必填|
+|close|关闭菜单方法|(e: MouseEvent\<HTMLElement, MouseEvent\>) =\> void|必填|
+|maskTransitionType|蒙层过渡动画类名|string|"fade"|
+|contentTransitionVarType|内容过渡动画类名变量标识|string|-|
+|children|菜单内部内容|ReactNode|-|
+|maskClosable|点击蒙层是否关闭菜单|boolean|true|
+|animatingClosable|执行进场动画时点击蒙层是否可关闭菜单|boolean|false|
+|mountOnEnter|是否在打开菜单时再加载内容|boolean|true|
+|unmountOnExit|是否在退出时卸载内容|boolean|true|
+|orientationDirection|transform方向，用于通过transform模拟横屏的情况|"left" \| "right" \| "top" \| "bottom"|"top"|
+|preventBodyScroll|弹窗打开时是否禁止body的滚动|boolean|true|
+|initialBodyOverflow|页面初始 overflow 状态，即关闭弹窗时 overflow 应该还原的状态|string|第一个全屏组件（弹窗、toast等）打开时页面overflow值|
+|gestureOutOfControl|是否禁用滚动容器手势判断，禁用后交给业务方自己判断|boolean|false|
+|onClose|关闭后回调（动画执行完毕）|(scene?: string) =\> void|-|
+|onOpen|打开后回调（动画执行完毕）|() =\> void|-|
+|onMaskClick|点击蒙层回调，maskClosable=false时也会触发|() =\> void|-|
+|onTouchMove|弹窗的touchmove回调|(e: TouchEvent, prevented: boolean, direction: "x" \| "y") =\> void|-|
+|onPreventTouchMove|非滚动区域或滚动到顶部及底部时的触摸事件回调|(e: TouchEvent, direction: "x" \| "y") =\> void|-|
+|getContainer|获取挂载容器|() =\> HTMLElement|-|
+|getScrollContainer|内容内部滚动区域容器，在该容器中未滚动到顶部或底部时会释放滚动|() =\> HTMLElement \| HTMLElement\[\]|-|
+
+> 引用/Refs
+
+|参数|描述|类型|
+|----------|-------------|------|
+|dom|最外层元素 DOM|HTMLDivElement|
+|mask|蒙层 DOM|HTMLDivElement|
+|content|内容 DOM|HTMLDivElement|
+|setCloseScene|在关闭弹窗前修改 onClose 的 scene 参数值|(scene: string) =\> void|
+
+> 方法/Methods
+
+|方法名|描述|类型|
+|----------|-------------|------|
+|open|打开弹出层|(config: PopupProps) =\> \{ close: () =\> void; update: (newConfig: PopupProps) =\> void; \}|
+
+> DirectionType
+
+```
+"left" | "right" | "top" | "bottom"
+```
+
+> GlobalContextParams
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|prefixCls|组件类名前缀|string|"arco"|
+|system|手动控制当前所在系统，传入后将直接使用传入的值，ssr场景需指定系统初始值时适用|"" \| "pc" \| "android" \| "ios"|""|
+|useDarkMode|是否监听系统原生的暗黑模式变化(prefers\-color\-scheme: dark)以判断是否切为暗黑模式|boolean|false|
+|isDarkMode|是否处于暗黑模式，指定后以指定的值为准|boolean|false|
+|darkModeSelector|当处于暗黑模式时，body上挂载的类名，为空值时不挂载类名|string|"arco-theme-dark"|
+|theme|主题变量，传入后将在线替换css变量，需设置less变量 @use\-css\-vars: 1|Record\<string, string\>|-|
+|locale|国际化语言包配置|ILocale|-|
+|useRtl|是否使用Rtl模式|boolean|false|
+|onDarkModeChange|当系统原生暗黑模式发生变化时触发，useDarkMode=true 时有效|(isDark: boolean) =\> void|-|
+|createRoot|React19 修改了 createRoot 的引入路径，导致组件内部无法直接引入（低react版本会找不到模块）。因此使用 react 19 的用户需从外部传入 createRoot 方法|CreateRootFnType|-|
+
+> ILocale
+
+|参数|描述|类型|
+|----------|-------------|------|
+|locale|语言类型|string|
+|LoadMore|-|\{ loadMoreText: string; loadingText: string; noDataText: string; failLoadText: string; prepareScrollText: string; prepareClickText: string; \}|
+|Picker|-|\{ okText: string; cancelText: string; \}|
+|Tag|-|\{ addTag: string; \}|
+|Dialog|-|\{ okText: string; cancelText: string; \}|
+|SwipeLoad|-|\{ normalText: string; activeText: string; \}|
+|PullRefresh|-|\{ loadingText: string; pullingText: string; finishText: string; loosingText: string; \}|
+|DropdownMenu|-|\{ select: string; \}|
+|Pagination|-|\{ previousPage: string; nextPage: string; \}|
+|Image|-|\{ loadError: string; \}|
+|ImagePicker|-|\{ loadError: string; \}|
+|SearchBar|-|\{ placeholder: string; cancelBtn: string; \}|
+|Stepper|-|\{ minusButtonName: string; addButtonName: string; \}|
+|Keyboard|-|\{ confirm: string; \}|
+|Form|-|\{ required: string; type: \{ email: string; url: string; string: string; number: string; array: string; object: string; boolean: string; \}; number: \{ min: string; max: string; equal: string; range: string; positive: string; negative: string; \}; \.\.\. 4 more \.\.\.; pickerDefaultHint: string; \}|
+|NavBar|-|\{ backBtnAriaLabel: string; \}|
+|Uploader|-|\{ uploadBtn: string; retryUpload: string; \}|

package/metaData/components/popup/style.md

@@ -0,0 +1,115 @@
+@import '../../../style/mixin.less';
+
+.set-popup-transform(@transform) {
+
+    &-enter,
+    &-exit-active,
+    &-exit-done {
+        transform: @transform;
+
+        &.translateZ {
+            transform: @transform translateZ(2PX);
+        }
+    }
+}
+
+.@{prefix}-popup {
+    .@{prefix}-slide-from {
+        &-left {
+            .set-popup-transform(translate(-100%, 0));
+        }
+
+        &-right {
+            .set-popup-transform(translate(100%, 0));
+        }
+
+        &-top {
+            .set-popup-transform(translate(0, -100%));
+        }
+
+        &-bottom {
+            .set-popup-transform(translate(0, 100%));
+        }
+    }
+
+    &-content,
+    &-mask {
+        &[class*="-enter-active"] {
+            &.translateZ {
+                transform: translateZ(2PX);
+            }
+
+            transform: translate(0, 0);
+            .use-var(transition, popup-enter-transition);
+        }
+    }
+
+    [class*="-exit-active"] {
+        .use-var(transition, popup-exit-transition);
+    }
+
+    &-content {
+        &[class*="-enter-active"] {
+            transition-duration: var(--builtin-transition-popup-slide-enter-duration, 450ms);
+        }
+        &[class*="-exit-active"] {
+            transition-duration: var(--builtin-transition-popup-slide-exit-duration, 240ms);
+        }
+        &.need-bottom-offset {
+            padding-bottom: constant(safe-area-inset-bottom);
+            padding-bottom: env(safe-area-inset-bottom);
+        }
+
+        &.left {
+            left: 0;
+            top: 0;
+            height: 100%;
+        }
+
+        &.top {
+            left: 0;
+            top: 0;
+            width: 100%;
+        }
+
+        &.right {
+            right: 0;
+            top: 0;
+            height: 100%;
+        }
+
+        &.bottom {
+            left: 0;
+            bottom: 0;
+            width: 100%;
+        }
+
+        &.translateZ {
+            transform: translateZ(2PX);
+        }
+
+        .use-var(background, popup-content-background);
+        position: fixed;
+        z-index: @full-screen-z-index+1;
+    }
+
+    &-mask {
+        &[class*="-enter-active"] {
+            transition-duration: var(--builtin-transition-fade-enter-duration, 450ms);
+        }
+        &[class*="-exit-active"] {
+            transition-duration: var(--builtin-transition-fade-exit-duration, 240ms);
+        }
+        &.translateZ {
+            transform: translateZ(1PX);
+        }
+
+        position: fixed;
+        width: 100%;
+        height: 100%;
+        left: 0;
+        top: 0;
+        z-index: @full-screen-z-index;
+        .use-var(background, popup-mask-background);
+    }
+}

package/metaData/components/popup-swiper/api.md

@@ -0,0 +1,100 @@
+> 属性/Props
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|percentToClose|滑动超过内容的百分之多少时关闭弹窗，范围为\[0, 1\]，如果该属性和\`distanceToClose\`属性均设置，则实际计算结果更大的生效|number|0.3|
+|distanceToClose|滑动超过多少px时关闭弹窗，如果该属性和\`percentToClose\`属性均设置，则实际计算结果更大的生效|number|10|
+|speedToClose|手指从按下到抬起之间的滑动速度超过多少时关闭弹窗(单位为px/s)，与滑动关闭距离阈值同时设置时，满足其中一个即生效|number|200|
+|allowSwipeDirections|自定义可手势滑动退出的方向，可指定多个方向|DirectionType\[\]|direction 属性指定的方向性|
+|exitDirection|固定弹窗退出方向，默认跟随手势滑动方向|"left" \| "right" \| "top" \| "bottom"|-|
+|onTouchStart|内容面板 touchstart 事件，返回true时表示阻止本组件内部处理事件|(e: TouchEvent) =\> boolean \| void|-|
+|onTouchMove|内容面板 touchmove 事件，返回true时表示阻止本组件内部处理事件|(e: TouchEvent, prevented: boolean, direction: "x" \| "y") =\> boolean \| void|-|
+|onTouchEnd|内容面板 touchend / touchcancel 事件，返回true时表示阻止本组件内部处理事件|(e: TouchEvent) =\> boolean \| void|-|
+|direction|菜单滑出方向|"left" \| "right" \| "top" \| "bottom"|"bottom"|
+|needBottomOffset|从底部滑出的菜单内容是否适配ipx底部|boolean|false|
+|translateZ|\[即将废弃\] 开启translateZ强制提升|boolean|false|
+|maskTransitionTimeout|菜单蒙层动画时长|number \| \{ appear?: number; enter?: number; exit?: number; \}|{ enter: 450, exit: 240 }|
+|contentTransitionTimeout|菜单内容动画时长|number \| \{ appear?: number; enter?: number; exit?: number; \}|{ enter: 450, exit: 240 }|
+|contentTransitionType|内容过渡动画类名|string|\`slide-from-${props.direction}\`|
+|className|自定义类名|string|-|
+|maskClass|自定义蒙层类名|string|-|
+|maskStyle|自定义蒙层样式|CSSProperties|-|
+|contentClass|自定义内容类名|string|-|
+|contentStyle|自定义内容样式|CSSProperties|-|
+|visible|是否展示菜单（受控）|boolean|必填|
+|close|关闭菜单方法|(e: MouseEvent\<HTMLElement, MouseEvent\>) =\> void|必填|
+|maskTransitionType|蒙层过渡动画类名|string|"fade"|
+|contentTransitionVarType|内容过渡动画类名变量标识|string|-|
+|children|菜单内部内容|ReactNode|-|
+|maskClosable|点击蒙层是否关闭菜单|boolean|true|
+|animatingClosable|执行进场动画时点击蒙层是否可关闭菜单|boolean|false|
+|mountOnEnter|是否在打开菜单时再加载内容|boolean|true|
+|unmountOnExit|是否在退出时卸载内容|boolean|true|
+|orientationDirection|transform方向，用于通过transform模拟横屏的情况|"left" \| "right" \| "top" \| "bottom"|"top"|
+|preventBodyScroll|弹窗打开时是否禁止body的滚动|boolean|true|
+|initialBodyOverflow|页面初始 overflow 状态，即关闭弹窗时 overflow 应该还原的状态|string|第一个全屏组件（弹窗、toast等）打开时页面overflow值|
+|gestureOutOfControl|是否禁用滚动容器手势判断，禁用后交给业务方自己判断|boolean|false|
+|onClose|关闭后回调（动画执行完毕）|(scene?: string) =\> void|-|
+|onOpen|打开后回调（动画执行完毕）|() =\> void|-|
+|onMaskClick|点击蒙层回调，maskClosable=false时也会触发|() =\> void|-|
+|onPreventTouchMove|非滚动区域或滚动到顶部及底部时的触摸事件回调|(e: TouchEvent, direction: "x" \| "y") =\> void|-|
+|getContainer|获取挂载容器|() =\> HTMLElement|-|
+|getScrollContainer|内容内部滚动区域容器，在该容器中未滚动到顶部或底部时会释放滚动|() =\> HTMLElement \| HTMLElement\[\]|-|
+
+> 引用/Refs
+
+|参数|描述|类型|
+|----------|-------------|------|
+|dom|最外层元素 DOM|HTMLDivElement|
+|mask|蒙层 DOM|HTMLDivElement|
+|content|内容 DOM|HTMLDivElement|
+|setCloseScene|在关闭弹窗前修改 onClose 的 scene 参数值|(scene: string) =\> void|
+
+> 方法/Methods
+
+|方法名|描述|类型|
+|----------|-------------|------|
+|open|打开弹出层|(config: string \| PopupSwiperProps) =\> \{ close: () =\> void; update: (newConfig: PopupSwiperProps) =\> void; \}|
+
+> DirectionType
+
+```
+"left" | "right" | "top" | "bottom"
+```
+
+> GlobalContextParams
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|prefixCls|组件类名前缀|string|"arco"|
+|system|手动控制当前所在系统，传入后将直接使用传入的值，ssr场景需指定系统初始值时适用|"" \| "pc" \| "android" \| "ios"|""|
+|useDarkMode|是否监听系统原生的暗黑模式变化(prefers\-color\-scheme: dark)以判断是否切为暗黑模式|boolean|false|
+|isDarkMode|是否处于暗黑模式，指定后以指定的值为准|boolean|false|
+|darkModeSelector|当处于暗黑模式时，body上挂载的类名，为空值时不挂载类名|string|"arco-theme-dark"|
+|theme|主题变量，传入后将在线替换css变量，需设置less变量 @use\-css\-vars: 1|Record\<string, string\>|-|
+|locale|国际化语言包配置|ILocale|-|
+|useRtl|是否使用Rtl模式|boolean|false|
+|onDarkModeChange|当系统原生暗黑模式发生变化时触发，useDarkMode=true 时有效|(isDark: boolean) =\> void|-|
+|createRoot|React19 修改了 createRoot 的引入路径，导致组件内部无法直接引入（低react版本会找不到模块）。因此使用 react 19 的用户需从外部传入 createRoot 方法|CreateRootFnType|-|
+
+> ILocale
+
+|参数|描述|类型|
+|----------|-------------|------|
+|locale|语言类型|string|
+|LoadMore|-|\{ loadMoreText: string; loadingText: string; noDataText: string; failLoadText: string; prepareScrollText: string; prepareClickText: string; \}|
+|Picker|-|\{ okText: string; cancelText: string; \}|
+|Tag|-|\{ addTag: string; \}|
+|Dialog|-|\{ okText: string; cancelText: string; \}|
+|SwipeLoad|-|\{ normalText: string; activeText: string; \}|
+|PullRefresh|-|\{ loadingText: string; pullingText: string; finishText: string; loosingText: string; \}|
+|DropdownMenu|-|\{ select: string; \}|
+|Pagination|-|\{ previousPage: string; nextPage: string; \}|
+|Image|-|\{ loadError: string; \}|
+|ImagePicker|-|\{ loadError: string; \}|
+|SearchBar|-|\{ placeholder: string; cancelBtn: string; \}|
+|Stepper|-|\{ minusButtonName: string; addButtonName: string; \}|
+|Keyboard|-|\{ confirm: string; \}|
+|Form|-|\{ required: string; type: \{ email: string; url: string; string: string; number: string; array: string; object: string; boolean: string; \}; number: \{ min: string; max: string; equal: string; range: string; positive: string; negative: string; \}; \.\.\. 4 more \.\.\.; pickerDefaultHint: string; \}|
+|NavBar|-|\{ backBtnAriaLabel: string; \}|
+|Uploader|-|\{ uploadBtn: string; retryUpload: string; \}|

package/metaData/components/popup-swiper/style.md

@@ -0,0 +1,10 @@
+@import '../../../style/mixin.less';
+
+.@{prefix}-popup-swiper {
+    &.has-trans .@{prefix}-popup {
+        &-mask,
+        &-content {
+            .use-var(transition, popup-exit-transition);
+        }
+    }
+}

package/metaData/components/portal/api.md

@@ -0,0 +1,6 @@
+> 属性/Props
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|children|被挂载的内容|ReactNode|-|
+|getContainer|容器获取函数|() =\> HTMLElement|() => document.body|

package/metaData/components/portal/style.md

@@ -0,0 +1 @@
+// 这里啥也没有，但是为了兼容 babel-plugin-import的统一引用，还是需要创建下文件

package/metaData/components/progress/api.md

@@ -0,0 +1,34 @@
+> 属性/Props
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|className|自定义类名|string|-|
+|style|自定义样式|CSSProperties|-|
+|percentPosition|文字显示位置|"left" \| "innerLeft" \| "right" \| "follow"|"center"|
+|showPercent|是否显示进度条内部文字|boolean|true|
+|percentage|进度环百分比|number|必填|
+|renderPercent|进度条内部文字显示（一个函数，返回ReactNode类型，回调参数为当前进度百分比）|(percentage: number) =\> ReactNode|-|
+|trackColor|轨道颜色|string|-|
+|progressColor|进度条颜色|string|-|
+|disabled|是否置灰|boolean|false|
+|trackStroke|轨道粗细|number|一般默认为4，percentPosition=innerLeft 时为18，mode=nav时为2|
+|progressStroke|进度条粗细|number|继承 trackStroke 值|
+|duration|每增加step步长所需的毫秒数|number|300|
+|step|步长（增加步长，以step增长）|number|1|
+|filleted|进度条是否两端圆角|boolean|true|
+|mountedTransition|初始化percentage时是否以动画形式过渡到目的值|boolean|true|
+|mountedBezier|初始化时动画的贝塞尔曲线|BezierType|[0.34, 0.69, 0.1, 1]|
+|mode|模式可选为nav或者base模式|"nav" \| "base"|"base"|
+|top|距离屏幕顶部的距离（只有当mode为"nav"才有效）|number|0|
+
+> 引用/Refs
+
+|参数|描述|类型|
+|----------|-------------|------|
+|dom|最外层元素 DOM|HTMLDivElement|
+
+> PercentPosition
+
+```
+"left" | "innerLeft" | "right" | "follow"
+```

package/metaData/components/progress/style.md

@@ -0,0 +1,114 @@
+@import "../../../style/mixin.less";
+
+.@{prefix}-progress {
+
+    &.progress-fixed {
+        position: fixed;
+        width: 100%;
+        .set-prop-with-rtl(left, 0);
+        z-index: @full-screen-z-index + 1;;
+    }
+
+    .progress-wrapper {
+        position: relative;
+        width: 100%;
+        display: flex;
+        align-items: center;
+
+        .progress-track {
+            width: 100%;
+            display: flex;
+            align-items: center;
+            .use-var(background-color, progress-track-color);
+            .use-var(height, progress-track-height);
+
+            &.position-innerLeft {
+                .use-var(height, progress-inner-track-height);
+            }
+
+            &.nav-mode {
+                .use-var(background-color, progress-nav-track-color);
+                .use-var(height, progress-nav-track-height);
+            }
+        }
+
+        .progress-bar {
+            height: 100%;
+            position: relative;
+            .use-var(background-color, progress-primary-color);
+
+            .wrapper {
+                position: absolute;
+                .set-prop-with-rtl(right, 0);
+                top: 50%;
+                transform: translateY(-50%);
+            }
+        }
+
+        .filleted {
+            border-radius: 100PX;
+        }
+
+        .text {
+            .use-var(font-size, progress-text-font-size);
+            .use-var-with-rtl(margin-left, progress-text-gutter);
+            .use-var(color, progress-primary-color);
+        }
+
+        .text-left {
+            .set-prop-with-rtl(margin-left, 0);
+            .use-var-with-rtl(margin-right, progress-text-gutter);
+        }
+
+        .text-innerLeft {
+            position: absolute;
+            z-index: 1;
+            .use-var(color, progress-text-inner-color);
+        }
+
+        .text-center {
+            position: absolute;
+            left: 50%;
+            top: 50%;
+            z-index: 1;
+            transform: translate(-50%, -50%);
+            .use-var(color, progress-text-inner-color);
+        }
+
+        .text-follow {
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            .use-var(width, progress-text-follow-width);
+            .use-var(height, progress-text-follow-height);
+            .use-var(border-radius, progress-text-follow-border-radius);
+            .use-var(font-size, progress-text-follow-font-size);
+            .use-var(color, progress-text-inner-color);
+            .use-var(background-color, progress-primary-color);
+        }
+
+        .track-color {
+            .use-var(background-color, progress-track-color); }
+
+        .color {
+            .use-var(stroke, progress-primary-color);
+            .use-var(color, progress-primary-color);
+        }
+
+        .bar-disabled {
+            .use-var(background-color, progress-disabled-color);
+        }
+
+        .text-disabled {
+            .use-var(color, progress-disabled-text-color);
+        }
+
+        .inner-disabled {
+            .use-var(color, progress-text-inner-color);
+
+            &.inner-block-disabled {
+                .use-var(background-color, progress-disabled-color);
+            }
+        }
+    }
+}

package/metaData/components/pull-refresh/api.md

@@ -0,0 +1,29 @@
+> 属性/Props
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|type|下拉刷新组件不同的实现方式，android \- 常规的外层容器 transform，ios \- 利用 ios scrollTop 负值实现下拉及回弹(性能优于transform)，仅ios可用。指定该属性值后优先级高于 useIosOptimize|"ios" \| "android"|跟随系统|
+|useIosOptimize|在 ios 上是否使用 scrollTop 负值实现下拉及回弹，而不是 transform，关闭后所有机型都使用 transform 的方式|boolean|false|
+|children|子元素|ReactNode|必填|
+|className|样式类名|string|-|
+|style|自定义样式|CSSProperties|-|
+|disabled|是否禁用|boolean|false|
+|finishDelay|加载完成后，展示加载完成的时间(ms)|number|300|
+|loosingText|下拉到可释放时的展示元素（type 为 ios 失效）|ReactNode|-|
+|loadingText|加载中的展示元素|ReactNode|-|
+|pullingText|下拉时的展示元素|ReactNode|-|
+|finishText|加载完成的展示元素|ReactNode|-|
+|initialText|初始状态还未下拉时的展示元素|ReactNode|pullingText属性值|
+|dampRate|阻尼系数（type 为 ios 失效）|number|4|
+|onRefresh|刷新触发事件|() =\> Promise\<void\>|-|
+|useHideAsNestedScroll|惯性滑动时隐藏展示元素|boolean|true|
+|loosingMinHeight|释放可刷线的最小距离(px)|number|loosingText 的高度|
+|allowPullWhenNotTop|未滚到顶部时向下滑动也允许触发下拉刷新，可能影响ios回弹动画效果|boolean|false|
+
+> 引用/Refs
+
+|参数|描述|类型|
+|----------|-------------|------|
+|dom|最外层元素 DOM|HTMLDivElement|
+|refresh|主动触发刷新，执行完成动画后异步返回|() =\> Promise\<void\>|
+|updateIOSHeight|手动更新 IOS 容器自动高度|() =\> void|

package/metaData/components/pull-refresh/style.md

@@ -0,0 +1,86 @@
+@import "../../../style/mixin.less";
+
+.@{prefix}-pull-refresh {
+    position: relative;
+    width: 100%;
+    height: 100%;
+    overflow-y: auto;
+    -webkit-overflow-scrolling: touch;
+
+    &::-webkit-scrollbar {
+        display: none;
+    }
+
+    &.is-disabled,
+    &-content,
+    &-content-wrapper {
+        .use-var(background, pull-refresh-content-background-color);
+    }
+
+    &-content {
+        min-height: 100%;
+    }
+
+    &.is-ios &-content-wrapper {
+        list-style-type: none;
+        padding: 0;
+        padding-bottom: 1PX;
+        margin: 0;
+        min-height: 100%;
+        box-sizing: content-box;
+        transform: translateZ(0);
+    }
+
+    &-label {
+        position: absolute;
+        display: flex;
+        width: 100%;
+        height: fit-content;
+        justify-content: center;
+        align-items: center;
+        z-index: -1;
+        .use-var(font-size, pull-refresh-label-font-size);
+        .use-var(background, pull-refresh-label-background-color);
+    }
+
+    &-label-wrapper {
+        position: absolute;
+        left: 0;
+        width: 100%;
+        overflow-y: auto;
+    }
+
+    &-place {
+        position: relative;
+        height: 100%;
+    }
+
+    &-label-text {
+        display: flex;
+        .rem(font-size, 14);
+        .rem(line-height, 44);
+        .use-var(color, pull-refresh-label-text-color);
+        .set-loading-color-var(pull-refresh-label-loading-color);
+        align-items: center;
+        .@{prefix}-loading + span {
+            .rem-with-rtl(margin-left, 10);
+        }
+    }
+
+    &.is-android &-label {
+        top: 0;
+        transform: translateY(-100%);
+    }
+
+    &.is-ios &-label {
+        position: absolute;
+        bottom: 0;
+        overflow-y: auto;
+        .rem(font-size, 14);
+
+        &-wrapper {
+            will-change: height;
+            z-index: -1;
+        }
+    }
+}

package/metaData/components/radio/api.md

@@ -0,0 +1,81 @@
+> 属性/Props
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|label|选项的文字说明，传入children时此属性无效|string|""|
+|value|Checkbox的值|ValueType|必填|
+|defaultCheck|默认选中状态|boolean|false|
+|checked|是否选中，传值即为受控模式|boolean|-|
+|onChange|复选框选中状态回调函数|(checked: boolean, value: ValueType, e: MouseEvent\<Element, MouseEvent\>) =\> void|() => {}|
+|shape|图标的形状|"circle" \| "square"|'circle'|
+|layout|排版样式(内联\|块级\|图标靠右两端对齐)|"inline" \| "block" \| "justify"|'inline'|
+|disabled|是否禁用|boolean|false|
+|icons|自定义图标合集，传 null 表示无图标|IconType|Default icon|
+|isRadio|是否为Radio组件，不推荐使用，仅用于支持Radio组件|boolean|false|
+|children|自定义组件内容|ReactNode|null|
+|className|自定义类名|string|""|
+|style|自定义样式|CSSProperties|{}|
+
+> 引用/Refs
+
+|参数|描述|类型|
+|----------|-------------|------|
+|dom|组件外层dom元素|HTMLDivElement|
+
+> Radio.Group
+
+单选项组
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|options|可选项, 传入children后此值无效|(RadioProps\<ValueType\> & RefAttributes\<RadioRef\>)\[\]|-|
+|value|受控模式，选中的选项，传null表示取消选中|ValueType|-|
+|defaultValue|默认选中项|ValueType|-|
+|onChange|单选项组选中状态变化回调函数|(value: ValueType) =\> void|-|
+|shape|图标的形状|"circle" \| "square"|'circle'|
+|layout|排版样式(内联\|块级\|图标靠右两端对齐)|"inline" \| "block" \| "justify"|'inline'|
+|disabled|是否禁用|boolean|false|
+|icons|自定义图标合集，传 null 表示无图标|IconType|Default icon|
+|isRadio|是否为Radio组件，不推荐使用，仅用于支持Radio组件|boolean|false|
+|children|自定义组件内容|ReactNode|null|
+|className|自定义类名|string|""|
+|style|自定义样式|CSSProperties|{}|
+
+> ValueType
+
+```
+string | number
+```
+
+> IconType
+
+|参数|描述|类型|
+|----------|-------------|------|
+|normal|未选中|ReactNode|
+|active|选中态|ReactNode|
+|disabled|禁用态|ReactNode|
+|activeDisabled|禁用选中态|ReactNode|
+
+> RadioProps
+
+|参数|描述|类型|默认值|
+|----------|-------------|------|------|
+|label|选项的文字说明，传入children时此属性无效|string|""|
+|value|Checkbox的值|ValueType|必填|
+|defaultCheck|默认选中状态|boolean|false|
+|checked|是否选中，传值即为受控模式|boolean|-|
+|onChange|复选框选中状态回调函数|(checked: boolean, value: ValueType, e: MouseEvent\<Element, MouseEvent\>) =\> void|() => {}|
+|shape|图标的形状|"circle" \| "square"|'circle'|
+|layout|排版样式(内联\|块级\|图标靠右两端对齐)|"inline" \| "block" \| "justify"|'inline'|
+|disabled|是否禁用|boolean|false|
+|icons|自定义图标合集，传 null 表示无图标|IconType|Default icon|
+|isRadio|是否为Radio组件，不推荐使用，仅用于支持Radio组件|boolean|false|
+|children|自定义组件内容|ReactNode|null|
+|className|自定义类名|string|""|
+|style|自定义样式|CSSProperties|{}|
+
+> RadioGroupRef
+
+|参数|描述|类型|
+|----------|-------------|------|
+|dom|组件外层dom元素|HTMLDivElement|