chore: address standardization review comments

Author: afc163

.github/workflows/surge-preview.yml

@@ -18,13 +18,23 @@ jobs:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0
         with:
           persist-credentials: false
+      - name: Check Surge token
+        id: surge-token
+        env:
+          SURGE_TOKEN: ${{ secrets.SURGE_TOKEN }}
+        run: |
+          if [ -n "$SURGE_TOKEN" ]; then
+            echo "enabled=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "enabled=false" >> "$GITHUB_OUTPUT"
+          fi
       - name: Build preview
-        if: ${{ secrets.SURGE_TOKEN != '' }}
+        if: ${{ steps.surge-token.outputs.enabled == 'true' }}
         run: |
           npm install
           npm run build
       - uses: afc163/surge-preview@bf90a5a86111f6311ca42f0a5a0f80fb0fb03cec
-        if: ${{ secrets.SURGE_TOKEN != '' }}
+        if: ${{ steps.surge-token.outputs.enabled == 'true' }}
         env:
           SURGE_TOKEN: ${{ secrets.SURGE_TOKEN }}
         with:
@@ -34,5 +44,5 @@ jobs:
           failOnError: false
           setCommitStatus: false
       - name: Skip Surge preview
-        if: ${{ secrets.SURGE_TOKEN == '' }}
+        if: ${{ steps.surge-token.outputs.enabled != 'true' }}
         run: echo "SURGE_TOKEN is not configured; skip Surge preview."

README.md

@@ -104,6 +104,7 @@ Then open `http://localhost:8000`.
 | --- | --- | --- | --- |
 | key | Panel key | `React.Key` | - |
 | label | Panel header content | `React.ReactNode` | - |
+| ref | Panel DOM ref | `React.RefObject<HTMLDivElement>` | - |
 | children | Panel body content | `React.ReactNode` | - |
 | className | Additional panel class name | string | - |
 | classNames | Semantic class names | `Partial<Record<SemanticName, string>>` | - |

README.zh-CN.md

@@ -31,7 +31,7 @@
 - 支持手风琴和多面板折叠模式。
 - 推荐使用 `items` API 声明式配置面板。
 - 保留 `Collapse.Panel` 以实现兼容性。它已被弃用，并将在 v4 中删除。
-- 支持自定义展开图标、语义className称、语义样式和动作。
+- 支持自定义展开图标、语义化类名、语义样式和动画。
 
 ## 安装
 
@@ -85,35 +85,36 @@ npm start
 | --- | --- | --- | --- |
 | accordion | 一次只能打开一个面板 | boolean | false |
 | activeKey | 当前活动面板键 | `React.Key \| React.Key[]` | - |
-| className | 附加className | string | - |
-| classNames | 语义className | `Partial<Record<SemanticName, string>>` | - |
+| className | 附加 className | string | - |
+| classNames | 语义化类名 | `Partial<Record<SemanticName, string>>` | - |
 | collapsible | 指定面板触发区域是否可折叠 | `header` \| `icon` \| `disabled` | - |
 | defaultActiveKey | 初始活动面板键 | `React.Key \| React.Key[]` | - |
 | destroyOnHidden | 销毁非活动面板内容 | boolean | false |
 | expandIcon | 自定义展开图标 | `(props: object) => React.ReactNode` | - |
-| 项目 | 折叠项目内容 | `ItemType[]` | - |
-| openMotion | 自定义打开动作 | `CSSMotionProps` | - |
-| prefixCls | 组件className前缀 | string | `rc-collapse` |
-| 风格 | 内联样式 | object | - |
-| styles | Semantic styles | `Partial<Record<SemanticName, React.CSSProperties>>` | - |
+| items | 折叠条目内容 | `ItemType[]` | - |
+| openMotion | 自定义展开动画 | `CSSMotionProps` | - |
+| prefixCls | 组件 className 前缀 | string | `rc-collapse` |
+| style | 内联样式 | object | - |
+| styles | 语义化样式 | `Partial<Record<SemanticName, React.CSSProperties>>` | - |
 | onChange | 活动面板更改时的回调 | `(key: React.Key[]) => void` | - |
 
 ### ItemType
 
 | 参数 | 说明 | 类型 | 默认值 |
 | --- | --- | --- | --- |
-| key | 面板按键 | `React.Key` | - |
+| key | 面板键值 | `React.Key` | - |
 | label | 面板标题内容 | `React.ReactNode` | - |
-| 孩子们 | 面板主体内容 | `React.ReactNode` | - |
-| className | 附加面板className | string | - |
-| classNames | 语义className | `Partial<Record<SemanticName, string>>` | - |
+| ref | 面板 DOM 引用 | `React.RefObject<HTMLDivElement>` | - |
+| children | 面板主体内容 | `React.ReactNode` | - |
+| className | 附加面板 className | string | - |
+| classNames | 语义化类名 | `Partial<Record<SemanticName, string>>` | - |
 | collapsible | 指定面板是否可折叠 | `header` \| `icon` \| `disabled` | - |
 | destroyOnHidden | 销毁非活动面板内容 | boolean | false |
-| 额外的 | 面板标题中的额外内容 | `React.ReactNode` | - |
+| extra | 面板标题中的额外内容 | `React.ReactNode` | - |
 | forceRender | 在打开面板之前渲染面板内容 | boolean | false |
 | showArrow | 在标题旁边显示箭头 | boolean | true |
-| 风格 | 内联面板样式 | object | - |
-| styles | Semantic styles | `Partial<Record<SemanticName, React.CSSProperties>>` | - |
+| style | 内联面板样式 | object | - |
+| styles | 语义化样式 | `Partial<Record<SemanticName, React.CSSProperties>>` | - |
 | onItemClick | 点击该面板时的回调 | `(panelKey: React.Key) => void` | - |
 
 ### 折叠面板

package.json

@@ -32,15 +32,16 @@
     "compile": "father build && lessc assets/index.less assets/index.css",
     "coverage": "rc-test --coverage",
     "docs:build": "dumi build",
-    "docs:deploy": "npm run docs:build && gh-pages -d docs-dist",
+    "docs:deploy": "gh-pages -d docs-dist",
     "lint": "eslint src/ --ext .ts,.tsx,.jsx,.js,.md",
     "prepare": "husky",
     "prepublishOnly": "npm run compile && rc-np",
     "prettier": "prettier --write --ignore-unknown .",
-    "postpublish": "npm run docs:deploy",
+    "postpublish": "npm run docs:build:gh-pages && npm run docs:deploy",
     "start": "dumi dev",
     "test": "rc-test",
-    "tsc": "tsc --noEmit"
+    "tsc": "tsc --noEmit",
+    "docs:build:gh-pages": "GH_PAGES=1 npm run docs:build"
   },
   "lint-staged": {
     "**/*.{ts,tsx,js,jsx,json,md}": "prettier --write --ignore-unknown"