@para-ui/core 5.0.0-beta.11 → 5.0.0-beta.13

package/lib/PageHeader/component.json

@@ -0,0 +1,112 @@
+{
+    "name": "PageHeader",
+    "category": "Navigation",
+    "description": "页头(应用级顶部导航条):左侧 logo/标题 + 中间横向菜单 + 右侧用户/语言/帮助/按钮区",
+    "semantic": {
+        "intent": [
+            "应用顶部导航",
+            "横向菜单展示",
+            "用户/语言/帮助入口聚合"
+        ],
+        "useCases": [
+            "应用主页头",
+            "管理后台顶栏",
+            "工作台首屏"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "default": {
+            "meaning": "标准页头(横向菜单 + 右侧功能区)"
+        }
+    },
+    "states": [
+        "default"
+    ],
+    "idealProps": {
+        "leftRender": {
+            "type": "ReactNode",
+            "description": "左侧自定义内容(放 logo / 应用标题 / 返回按钮等);**支持纯文本 / 单行 JSX / 多行复合 JSX**(标题+副标题、返回按钮+标题、面包屑+标题、标题+状态彩标);**注意:不是 title / subTitle / backIcon / breadcrumb / onBack prop**(这些 Ant Design PageHeader 命名本组件均不存在,需要时全部组合进 leftRender ReactNode);典型场景见 docs/view/pageHeader/codeString.ts 注释 7a/7b/7c/7d"
+        },
+        "menuListProps": {
+            "type": "MenuListProps",
+            "description": "横向菜单配置对象;MenuListProps = { list?: MenuChildrenProps[]; selectMenu?: string; onClickMenu?: (item: MenuChildrenProps | false) => void; className?: string; moreCustomize?: ReactNode };src/PageHeader/interface.ts:38"
+        },
+        "footerProps": {
+            "type": "FooterProps",
+            "description": "**右侧功能区聚合对象**(放语言切换 / 用户菜单 / 帮助 / 按钮列表 / 自助跳转 / 自定义);FooterProps = { backSelfcareProps?: BackSelfcareProps; languageProps?: LanguageProps; btnListProps?: BtnListProps; userProps?: UserProps; helpProps?: HelpProps; render?: ReactNode; className?: string };**所有右侧功能都在这个对象里嵌套配置,不是顶层独立 prop**;**helpProps 结构同 BackSelfcareProps**(label/icon/render/onClick/className);**render 是「替换」语义**,传入后整个右侧被替换,其他 5 widget 字段都不渲染(无追加模式);src/PageHeader/interface.ts:162"
+        },
+        "selectMenu": {
+            "type": "string",
+            "description": "当前选中菜单(匹配 menuListProps.list[].path);顶层 selectMenu 会下传到 MenuListProps.selectMenu;src/PageHeader/index.tsx:14"
+        },
+        "onClickMenu": {
+            "type": "(item: MenuChildrenProps | false) => void",
+            "description": "菜单点击回调;**回参 item 是 MenuChildrenProps 对象或 false**(false 表示选中态被清空);MenuChildrenProps = { label?, type?, path?, icon?, children?, ... },典型用法 `item.path` 取菜单路径"
+        },
+        "className": {
+            "type": "string",
+            "description": "外层容器样式 class"
+        },
+        "style": {
+            "type": "React.CSSProperties",
+            "description": "外层容器内联样式"
+        }
+    },
+    "do": [
+        "logo / 应用名放 leftRender",
+        "横向菜单走 menuListProps.list(树形结构通过 children 嵌套)",
+        "右侧功能(语言 / 用户 / 帮助 / 按钮)统一在 footerProps 对象里嵌套配置",
+        "selectMenu 受控 — 父维护 string 匹配 list[].path"
+    ],
+    "dont": [
+        "把 title / subTitle / extra / onBack / backIcon / breadcrumb / footer 当作顶层 prop 传(全部 Ant Design 命名,**本组件均不存在**)",
+        "把右侧功能字段(languageProps / userProps / btnListProps / helpProps / backSelfcareProps)拆到顶层(必须嵌套在 footerProps 对象里)",
+        "在 menuListProps.list[].type 上随意填值(仅支持 'redirect' | 'router' | 'iframe' | 'snack' | 'snackPage' 五种)",
+        "传 footerProps.render 同时配其他 widget 字段(render 是**替换语义**,会覆盖整个右侧,languageProps/userProps 等都不渲染;无追加模式)",
+        "期望 PageHeader 顶层有 bottomRender / footerRender / statsRender / extraBottom 下方内容区(**本组件不支持下方扩展插槽**;如需统计条/标签栏在 PageHeader 外层 div 包装)",
+        "把「标题 + 副标题」/「返回按钮 + 标题」/「面包屑 + 标题」拆成多个顶层 prop(本组件这类复合内容**全部塞进 leftRender ReactNode**;见 docs/view/pageHeader/codeString.ts 注释 7a/7b/7c)"
+    ],
+    "events": {
+        "onClickMenu": {
+            "signature": "(item: MenuChildrenProps | false) => void",
+            "asyncSupported": false,
+            "examples": [
+                "获取路由路径：onClickMenu={(item) => { if (item) navigate(item.path); }}",
+                "清空选中：onClickMenu={(item) => { if (!item) setSelectMenu(''); else setSelectMenu(item.path); }}",
+                "嵌套子菜单点击：回参 item.children 可能有子项，item.path 是当前点击项的路径，非父级路径"
+            ],
+            "commonMistakes": [
+                "假设 item 永远是对象——回参可能是 false（表示选中态被清空），使用前需判断 if (item)",
+                "直接用 item.label 作路由——应用 item.path；item.label 是显示文案",
+                "不更新 selectMenu 导致菜单高亮不同步——onClickMenu 触发后需 setState(item.path) 回写 selectMenu"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "footerProps 内字段不能拆到 PageHeader 顶层，TS 会报未知 prop",
+            "wrong": "<PageHeader userProps={{ label: '张三' }} languageProps={{ ... }} />  // 这些不是顶层 prop",
+            "right": "<PageHeader footerProps={{ userProps: { label: '张三' }, languageProps: { ... } }} />"
+        },
+        {
+            "issue": "MenuChildrenProps.type 是菜单行为类型，有严格枚举，传错值 TS 不会报错但菜单不响应",
+            "wrong": "list={[{ label: '首页', type: 'link', path: '/home' }]}  // 'link' 不在联合类型",
+            "right": "list={[{ label: '首页', type: 'router', path: '/home' }]}  // 合法值: 'redirect' | 'router' | 'iframe' | 'snack' | 'snackPage'"
+        },
+        {
+            "issue": "onClickMenu 回参是 MenuChildrenProps | false，直接访问属性前需判空",
+            "wrong": "onClickMenu={(item) => navigate(item.path)}  // item 可能是 false，访问 .path 会 TypeError",
+            "right": "onClickMenu={(item) => { if (item && item.path) navigate(item.path); }}"
+        },
+        {
+            "issue": "不要从 @para-ui/core 导入 MenuChildrenProps 用于 onClickMenu 类型标注——PageHeader/interface.ts 和 Menu/interface.ts 各有一个同名 MenuChildrenProps，两者互不兼容，强行标注会导致 TS2322",
+            "wrong": "import { PageHeader, MenuChildrenProps } from '@para-ui/core';\nonClickMenu={(item: MenuChildrenProps | false) => ...}  // MenuChildrenProps 来自 Menu 不来自 PageHeader，类型冲突",
+            "right": "import { PageHeader } from '@para-ui/core';\n// 不标注类型，让 TS 推断，或使用 Parameters<typeof PageHeader>[0]['onClickMenu']\nonClickMenu={(item) => { if (item && item.path) navigate(item.path); }}"
+        }
+    ],
+    "mapping": {
+        "realComponent": "PageHeader",
+        "adapter": null
+    }
+}

package/lib/PageHeader/horizontalMeun.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const s=require("../_virtual/jsx-runtime.js"),i=require("react"),Q=require("../Popover/index.js"),W=require("../node_modules/@para-ui/icons/Down/index.js"),X=require("../node_modules/@para-ui/icons/index.js"),ue=require("../node_modules/@para-ui/icons/More/index.js"),ae=require("@paraview/lib"),U=require("../GlobalContext/constant.js"),Y=d=>{let l="div";return(!d||d.length===0)&&(l="a"),l},Z=(d=[],l,u)=>!d||d.length===0?{href:u||`#${l}`}:{},ee=d=>{const{idMenuLast:l,selectMenu:u="",onClickMenu:h,list:N=[],onMouseEnter:z,onMouseLeave:x,level:j=1,className:g}=d,[M,T]=i.useState(null),[C,S]=i.useState(null),[R,E]=i.useState([]),[f]=i.useState({});i.useEffect(()=>()=>{clearTimeout(f.leaveTimer)},[]);const b=(n,r)=>m=>{f.leaveTimer&&clearTimeout(f.leaveTimer),f.leaveTimer=setTimeout(()=>{let v=[n];n.children&&n.children.length>0&&(v=n.children);const w=m.target;S(w),E(v),T(r)},50)},D=(n,r)=>()=>{f.leaveTimer&&clearTimeout(f.leaveTimer),f.leaveTimer=setTimeout(()=>{T(null),S(null),E([])})},F=n=>r=>{r.preventDefault(),!(n.children&&n.children.length>0)&&(h&&h(n),x&&x())},y=n=>{const r=n.icon;if(r){if(typeof r=="string"){const m=X[r];if(m)return m()}return r}return null},a=n=>{const r=n.children;return r&&r.length>0?s.jsxRuntimeExports.jsx(W.Down,{}):null},O=n=>{let r="menu-item-popper-content-item";const m=l&&l[u];return m&&m.indexOf(n.path)!==-1&&(r+=" menu-item-popper-content-item-select"),r},p=()=>{let n="menu-item-popper";return j!==1&&(n+=" menu-item-popper-child"),g&&(n+=` ${g}`),n},$=i.useCallback((n,r)=>s.jsxRuntimeExports.jsx(s.jsxRuntimeExports.Fragment,{children:n.children&&n.children.length>0&&M===r&&s.jsxRuntimeExports.jsx(ee,{open:M===r,anchorEl:C,list:R,idMenuLast:l,selectMenu:u,onClickMenu:h,onMouseEnter:z,onMouseLeave:x,level:j+1})}),[M,C,R,l,u,h,z,x,j]),P=i.useMemo(()=>s.jsxRuntimeExports.jsx("div",{className:"menu-item-popper-content",children:N.map((n,r)=>{const m=y(n),v=a(n),w=Y(n.children);return s.jsxRuntimeExports.jsx("div",{className:O(n),onMouseLeave:D(),onMouseEnter:b(n,r),children:s.jsxRuntimeExports.jsxs(w,{className:"menu-item-popper-content-item-content",onClick:F(n),...Z(n.children,n.path,n.href),children:[m&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-icon",children:m}),s.jsxRuntimeExports.jsx("span",{className:"menu-item-label",children:n.label}),v&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-arrow",children:v}),$(n,r)]})},r)})}),[N,h,M,C,R,l,u,h,z,x,j]);return s.jsxRuntimeExports.jsx("div",{className:p(),children:P})},ne=d=>{const{list:l,selectMenu:u="",onClickMenu:h,className:N,moreCustomize:z}=d,[x,j]=i.useState(!1),[g,M]=i.useState(null),[T,C]=i.useState(null),[S,R]=i.useState([]),[E,f]=i.useState(""),[b,D]=i.useState({}),[F,y]=i.useState({}),[a,O]=i.useState(null),[p]=i.useState({}),$=i.useRef(null);i.useEffect(()=>{u!==E&&f(u)},[u]),i.useEffect(()=>(r(l||[]),P(),window.addEventListener("resize",P),()=>{window.removeEventListener("resize",P),p.timerResize&&clearTimeout(p.timerResize)}),[l]);const P=()=>{p.timerResize&&clearTimeout(p.timerResize),p.timerResize=setTimeout(()=>{O((l||[]).length),n()},100)},n=e=>{if(e===null||e===0)return;e===void 0&&(e=(l||[]).length);const t=$.current;if(t)if(t.scrollHeight>t.clientHeight){const o=Number(e)-1;O(o),n(o)}else(l||[]).length<=e},r=e=>{const t={},o={},c={},q=(k,_,B)=>{for(let H=0,ce=k.length;H<ce;H++){const I=k[H],L=I.path||"",G=B===void 0?H:B;if(_&&_.path){const K=ae.DeepClone(t[_.path]||[]);K.push(L),t[L]=[...K]}else t[L]=[L];I.children&&I.children.length>0?q(I.children,I,G):(o[L]=t[L],c[L]=G)}};q(e),y(c),D(o)},m=(e,t)=>o=>{let c=[];if(e.children&&e.children.length>0&&(c=e.children),c.length===0)return v();M(t),C(o.target),R(c),j(!0)},v=()=>{j(!1),C(null),R([]),M(null)},w=()=>{v()},J=e=>{h&&h(e)},te=(e,t)=>{let o="horizontal-menu-list-item";const c=b[E];return c&&c.indexOf(e.path)!==-1&&(o+=" horizontal-menu-list-item-select"),g===t&&(o+=" horizontal-menu-list-item-hover"),o},se=e=>{const t=e.icon;if(t){if(typeof t=="string"){const o=X[t];if(o)return o()}return t}return null},re=e=>{const t=e.children;return t&&t.length>0?s.jsxRuntimeExports.jsx(W.Down,{}):null},A=i.useMemo(()=>s.jsxRuntimeExports.jsx(s.jsxRuntimeExports.Fragment,{children:x&&s.jsxRuntimeExports.jsx(ee,{open:x,anchorEl:T,list:S,idMenuLast:b,selectMenu:E,onClickMenu:J,onMouseLeave:w,level:1})}),[x,T,S,b,E,h,p]),oe=()=>{let e="horizontal-menu-list";return N&&(e+=` ${N}`),e},le=e=>{p.leaveTimer&&clearTimeout(p.leaveTimer);const t=[];for(let o=Number(a),c=(l||[]).length;o<c;o++)t.push((l||[])[o]);M(a),C(e.target),R(t),j(!0)},ie=()=>{let e=" horizontal-menu-list-item";const t=F[E];return a!==null&&a<=t&&(e+=" horizontal-menu-list-item-select"),g===a&&(e+=" horizontal-menu-list-item-hover"),e},V=e=>{e||v()};return s.jsxRuntimeExports.jsxs("div",{className:oe(),ref:$,children:[(l||[]).map((e,t)=>{if(a!==null&&a<=t)return null;const o=se(e),c=re(e),q=Y(e.children);return s.jsxRuntimeExports.jsx(Q.Popover,{visible:g===t,trigger:"hover",placement:"bottom-start",content:A,overlayClassName:`${U.$prefixCls}-horizontal-menu-popper`,onVisibleChange:V,children:s.jsxRuntimeExports.jsxs(q,{onClick:k=>{k.preventDefault(),(!e.children||e.children.length===0)&&J(e)},onMouseEnter:m(e,t),className:te(e,t),...Z(e.children,e.path,e.href),children:[o&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-icon",children:o}),s.jsxRuntimeExports.jsx("span",{className:"menu-item-label",children:e.label}),c&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-arrow",children:c})]})},t)}),(()=>{if(a!==null&&(l||[]).length>a)return s.jsxRuntimeExports.jsx(Q.Popover,{visible:g===a,trigger:"hover",placement:"bottom-start",content:A,overlayClassName:`${U.$prefixCls}-horizontal-menu-popper`,onVisibleChange:V,children:s.jsxRuntimeExports.jsx("div",{onMouseEnter:le,className:ie(),children:z||s.jsxRuntimeExports.jsx("span",{className:"menu-item-icon",children:s.jsxRuntimeExports.jsx(ue.More,{})})})})})()]})};exports.HorizontalMenu=ne;exports.default=ne;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const s=require("../_virtual/jsx-runtime.js"),i=require("react"),Q=require("../Popover/index.js"),W=require("../node_modules/@para-ui/icons/Down/index.js"),X=require("../node_modules/@para-ui/icons/index.js"),ue=require("../node_modules/@para-ui/icons/More/index.js"),ae=require("@snack-kit/lib"),U=require("../GlobalContext/constant.js"),Y=d=>{let l="div";return(!d||d.length===0)&&(l="a"),l},Z=(d=[],l,u)=>!d||d.length===0?{href:u||`#${l}`}:{},ee=d=>{const{idMenuLast:l,selectMenu:u="",onClickMenu:h,list:N=[],onMouseEnter:z,onMouseLeave:x,level:j=1,className:g}=d,[M,T]=i.useState(null),[C,S]=i.useState(null),[R,E]=i.useState([]),[f]=i.useState({});i.useEffect(()=>()=>{clearTimeout(f.leaveTimer)},[]);const b=(n,r)=>m=>{f.leaveTimer&&clearTimeout(f.leaveTimer),f.leaveTimer=setTimeout(()=>{let v=[n];n.children&&n.children.length>0&&(v=n.children);const w=m.target;S(w),E(v),T(r)},50)},D=(n,r)=>()=>{f.leaveTimer&&clearTimeout(f.leaveTimer),f.leaveTimer=setTimeout(()=>{T(null),S(null),E([])})},F=n=>r=>{r.preventDefault(),!(n.children&&n.children.length>0)&&(h&&h(n),x&&x())},y=n=>{const r=n.icon;if(r){if(typeof r=="string"){const m=X[r];if(m)return m()}return r}return null},a=n=>{const r=n.children;return r&&r.length>0?s.jsxRuntimeExports.jsx(W.Down,{}):null},O=n=>{let r="menu-item-popper-content-item";const m=l&&l[u];return m&&m.indexOf(n.path)!==-1&&(r+=" menu-item-popper-content-item-select"),r},p=()=>{let n="menu-item-popper";return j!==1&&(n+=" menu-item-popper-child"),g&&(n+=` ${g}`),n},$=i.useCallback((n,r)=>s.jsxRuntimeExports.jsx(s.jsxRuntimeExports.Fragment,{children:n.children&&n.children.length>0&&M===r&&s.jsxRuntimeExports.jsx(ee,{open:M===r,anchorEl:C,list:R,idMenuLast:l,selectMenu:u,onClickMenu:h,onMouseEnter:z,onMouseLeave:x,level:j+1})}),[M,C,R,l,u,h,z,x,j]),P=i.useMemo(()=>s.jsxRuntimeExports.jsx("div",{className:"menu-item-popper-content",children:N.map((n,r)=>{const m=y(n),v=a(n),w=Y(n.children);return s.jsxRuntimeExports.jsx("div",{className:O(n),onMouseLeave:D(),onMouseEnter:b(n,r),children:s.jsxRuntimeExports.jsxs(w,{className:"menu-item-popper-content-item-content",onClick:F(n),...Z(n.children,n.path,n.href),children:[m&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-icon",children:m}),s.jsxRuntimeExports.jsx("span",{className:"menu-item-label",children:n.label}),v&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-arrow",children:v}),$(n,r)]})},r)})}),[N,h,M,C,R,l,u,h,z,x,j]);return s.jsxRuntimeExports.jsx("div",{className:p(),children:P})},ne=d=>{const{list:l,selectMenu:u="",onClickMenu:h,className:N,moreCustomize:z}=d,[x,j]=i.useState(!1),[g,M]=i.useState(null),[T,C]=i.useState(null),[S,R]=i.useState([]),[E,f]=i.useState(""),[b,D]=i.useState({}),[F,y]=i.useState({}),[a,O]=i.useState(null),[p]=i.useState({}),$=i.useRef(null);i.useEffect(()=>{u!==E&&f(u)},[u]),i.useEffect(()=>(r(l||[]),P(),window.addEventListener("resize",P),()=>{window.removeEventListener("resize",P),p.timerResize&&clearTimeout(p.timerResize)}),[l]);const P=()=>{p.timerResize&&clearTimeout(p.timerResize),p.timerResize=setTimeout(()=>{O((l||[]).length),n()},100)},n=e=>{if(e===null||e===0)return;e===void 0&&(e=(l||[]).length);const t=$.current;if(t)if(t.scrollHeight>t.clientHeight){const o=Number(e)-1;O(o),n(o)}else(l||[]).length<=e},r=e=>{const t={},o={},c={},k=(q,_,B)=>{for(let H=0,ce=q.length;H<ce;H++){const I=q[H],L=I.path||"",G=B===void 0?H:B;if(_&&_.path){const K=ae.DeepClone(t[_.path]||[]);K.push(L),t[L]=[...K]}else t[L]=[L];I.children&&I.children.length>0?k(I.children,I,G):(o[L]=t[L],c[L]=G)}};k(e),y(c),D(o)},m=(e,t)=>o=>{let c=[];if(e.children&&e.children.length>0&&(c=e.children),c.length===0)return v();M(t),C(o.target),R(c),j(!0)},v=()=>{j(!1),C(null),R([]),M(null)},w=()=>{v()},J=e=>{h&&h(e)},te=(e,t)=>{let o="horizontal-menu-list-item";const c=b[E];return c&&c.indexOf(e.path)!==-1&&(o+=" horizontal-menu-list-item-select"),g===t&&(o+=" horizontal-menu-list-item-hover"),o},se=e=>{const t=e.icon;if(t){if(typeof t=="string"){const o=X[t];if(o)return o()}return t}return null},re=e=>{const t=e.children;return t&&t.length>0?s.jsxRuntimeExports.jsx(W.Down,{}):null},A=i.useMemo(()=>s.jsxRuntimeExports.jsx(s.jsxRuntimeExports.Fragment,{children:x&&s.jsxRuntimeExports.jsx(ee,{open:x,anchorEl:T,list:S,idMenuLast:b,selectMenu:E,onClickMenu:J,onMouseLeave:w,level:1})}),[x,T,S,b,E,h,p]),oe=()=>{let e="horizontal-menu-list";return N&&(e+=` ${N}`),e},le=e=>{p.leaveTimer&&clearTimeout(p.leaveTimer);const t=[];for(let o=Number(a),c=(l||[]).length;o<c;o++)t.push((l||[])[o]);M(a),C(e.target),R(t),j(!0)},ie=()=>{let e=" horizontal-menu-list-item";const t=F[E];return a!==null&&a<=t&&(e+=" horizontal-menu-list-item-select"),g===a&&(e+=" horizontal-menu-list-item-hover"),e},V=e=>{e||v()};return s.jsxRuntimeExports.jsxs("div",{className:oe(),ref:$,children:[(l||[]).map((e,t)=>{if(a!==null&&a<=t)return null;const o=se(e),c=re(e),k=Y(e.children);return s.jsxRuntimeExports.jsx(Q.Popover,{visible:g===t,trigger:"hover",placement:"bottom-start",content:A,overlayClassName:`${U.$prefixCls}-horizontal-menu-popper`,onVisibleChange:V,children:s.jsxRuntimeExports.jsxs(k,{onClick:q=>{q.preventDefault(),(!e.children||e.children.length===0)&&J(e)},onMouseEnter:m(e,t),className:te(e,t),...Z(e.children,e.path,e.href),children:[o&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-icon",children:o}),s.jsxRuntimeExports.jsx("span",{className:"menu-item-label",children:e.label}),c&&s.jsxRuntimeExports.jsx("span",{className:"menu-item-arrow",children:c})]})},t)}),(()=>{if(a!==null&&(l||[]).length>a)return s.jsxRuntimeExports.jsx(Q.Popover,{visible:g===a,trigger:"hover",placement:"bottom-start",content:A,overlayClassName:`${U.$prefixCls}-horizontal-menu-popper`,onVisibleChange:V,children:s.jsxRuntimeExports.jsx("div",{onMouseEnter:le,className:ie(),children:z||s.jsxRuntimeExports.jsx("span",{className:"menu-item-icon",children:s.jsxRuntimeExports.jsx(ue.More,{})})})})})()]})};exports.HorizontalMenu=ne;exports.default=ne;
 //# sourceMappingURL=horizontalMeun.js.map

package/lib/PageHeader/horizontalMeunRight.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../_virtual/jsx-runtime.js"),n=require("react"),K=require("../Button/index.js"),y=require("../Popover/index.js"),Q=require("../AutoTips/index.js"),X=require("../node_modules/@para-ui/icons/Down/index.js"),Y=require("../node_modules/@para-ui/icons/Right/index.js"),S=require("../GlobalContext/constant.js"),F=require("@paraview/lib"),Z=g=>{const{icon:s,label:p,render:a,onClick:m,className:l}=g,r=t=>{m&&m(t)},x=()=>e.jsxRuntimeExports.jsx(K.Button,{startIcon:s,variant:"contained",onClick:r,size:"small",children:p}),c=()=>{let t="back-btn";return l&&(t+=` ${l}`),t};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:a||e.jsxRuntimeExports.jsx("div",{className:c(),children:x()})})},ee=g=>{const{icon:s,label:p,render:a,onClick:m,className:l}=g,r=()=>{let x="help-btn";return l&&(x+=` ${l}`),x};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:a||e.jsxRuntimeExports.jsxs("div",{className:r(),onClick:m,children:[s&&e.jsxRuntimeExports.jsx("span",{className:"icon",children:s}),p&&e.jsxRuntimeExports.jsx("span",{className:"label",children:p})]})})},se=g=>{const{language:s=[],selectLang:p="",onClick:a,className:m,render:l}=g,[r,x]=n.useState({}),[c,t]=n.useState({}),[E,R]=n.useState(!1);n.useEffect(()=>{const o=r[p]||{};t(o)},[p,r]),n.useEffect(()=>{const o={};for(let d=0,u=s.length;d<u;d++){const C=s[d];C.value&&(o[C.value]=C)}x(o)},[s]);const v=o=>()=>{a&&a(o.value,o),R(!1)},f=()=>{let o="language";return m&&(o+=` ${m}`),E&&(o+=" language-select"),o},_=o=>{R(o)},b=()=>{const o=d=>{let u="menu-popover-item";return d.value===c.value&&(u+=" menu-popover-item-select"),u};return e.jsxRuntimeExports.jsx("div",{className:"menu-popover-box",children:s.map((d,u)=>e.jsxRuntimeExports.jsxs("div",{className:o(d),onClick:v(d),children:[d.icon&&e.jsxRuntimeExports.jsx("span",{className:"icon",children:d.icon}),d.label&&e.jsxRuntimeExports.jsx("span",{className:"label",style:{marginLeft:"5px"},children:d.label})]},u))})},N=()=>{const o=()=>e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[c.icon&&e.jsxRuntimeExports.jsx("span",{className:"language-item-icon",children:c.icon}),c.label&&e.jsxRuntimeExports.jsx("span",{className:"language-item-label",children:c.label})]});return e.jsxRuntimeExports.jsx(y.Popover,{trigger:"hover",visible:E,placement:"bottom-start",content:b(),overlayClassName:`${S.$prefixCls}-horizontal-meun-right-popover`,onVisibleChange:_,children:e.jsxRuntimeExports.jsx("div",{className:"language-item",children:o()})})};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:l||e.jsxRuntimeExports.jsx("div",{className:f(),children:N()})})},te=g=>{const{list:s=[],render:p,className:a,onClick:m}=g,l=()=>{let c="btn-list";return a&&(c+=` ${a}`),c},r=c=>t=>{m&&m(c,t)},x=n.useMemo(()=>{const c=t=>e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[t.icon&&e.jsxRuntimeExports.jsx("span",{className:"btn-list-item-icon",children:t.icon}),t.label&&e.jsxRuntimeExports.jsx("span",{className:"btn-list-item-label",children:t.label})]});return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:s.map((t,E)=>{let R="btn-list-item";return t.sign&&(R+=" btn-list-item-sign"),e.jsxRuntimeExports.jsx("div",{className:R,onClick:r(t),children:c(t)},E)})})},[s]);return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:p||e.jsxRuntimeExports.jsx("div",{className:l(),children:x})})},q=g=>{const{item:s,selectValue:p,selectId:a,clickUserItem:m,hoverId:l,showDialog:r,idMapLast:x,onMouseEnter:c,onMouseLeave:t}=g,[E,R]=n.useState(!1),[v,f]=n.useState("");n.useEffect(()=>(r===!1&&R(!1),()=>{f("")}),[r]);const _=u=>{f(u._paraui_menu_id||"")},b=()=>{},N=()=>{let u="menu-popover-item";return l===s._paraui_menu_id&&(u+=" menu-popover-item-hover"),s._paraui_menu_id&&x[l]&&x[l].indexOf(s._paraui_menu_id)!==-1&&(u+=" menu-popover-item-hover"),s._paraui_menu_id&&x[a]&&x[a].indexOf(s._paraui_menu_id)!==-1&&(u+=" menu-popover-item-select"),u},o=()=>{if(s.children&&s.children.length>0)return e.jsxRuntimeExports.jsx("div",{className:"menu-popover-box",children:s.children&&s.children.map((u,C)=>e.jsxRuntimeExports.jsx(q,{item:u,selectValue:p,clickUserItem:m,onMouseEnter:()=>_(u),onMouseLeave:b,hoverId:v,showDialog:r,selectId:a,idMapLast:x},C))})},d=u=>{R(u),u||f("")};return e.jsxRuntimeExports.jsx(y.Popover,{visible:E,trigger:"hover",placement:"left-start",content:o(),onVisibleChange:d,overlayClassName:`${S.$prefixCls}-horizontal-meun-right-popover ${S.$prefixCls}-horizontal-meun-right-popover-children`,children:e.jsxRuntimeExports.jsxs("div",{className:N(),onClick:m(s),onMouseEnter:c,onMouseLeave:t,children:[s.icon&&e.jsxRuntimeExports.jsx("span",{className:"icon",style:{marginRight:"5px"},children:s.icon}),s.label&&e.jsxRuntimeExports.jsx("span",{className:"label",children:e.jsxRuntimeExports.jsx(Q.default,{children:s.label})}),s.children&&s.children.length>0&&e.jsxRuntimeExports.jsx("span",{className:"icon icon-right",children:e.jsxRuntimeExports.jsx(Y.Right,{})})]})})},ne=g=>{const{img:s,imgRender:p,label:a,render:m,className:l,list:r,onClick:x,onClickMenu:c,selectValue:t}=g,[E,R]=n.useState([]),[v,f]=n.useState(""),[_,b]=n.useState(!1),[N,o]=n.useState(""),[d,u]=n.useState({}),[C]=n.useState({}),L=n.useRef(null),I=n.useRef({listJson:{}});n.useEffect(()=>()=>{clearTimeout(C.timer)},[]),n.useEffect(()=>{J()},[r]),n.useEffect(()=>{const i=Object.keys(I.current.listJson);for(let h=0,M=i.length;h<M;h++){const k=I.current.listJson[i[h]];if(k.value===t){f(k._paraui_menu_id||"");break}}},[t,r]);const J=()=>{const i={},h={},M={},k=(D,$)=>{for(let P=0,G=D.length;P<G;P++){const j=D[P];if(j._paraui_menu_id=`_paraui_menu_id_${F.UUID()}`,i[j._paraui_menu_id]=j,$&&$._paraui_menu_id){const w=F.DeepClone(h[$._paraui_menu_id]||[]);w.push(j._paraui_menu_id),h[j._paraui_menu_id]=[...w]}else h[j._paraui_menu_id]=[j._paraui_menu_id],j._paraui_menu_first=!0;j.children&&j.children.length>0?k(j.children,j):M[j._paraui_menu_id]=h[j._paraui_menu_id]}};k(r||[]),I.current.listJson=i,R([...r||[]]),u(M)},B=i=>{x&&x(i)},U=i=>()=>{i.children&&i.children.length>0||(c&&c(i.value,i),b(!1),o(""))},H=i=>{o(i._paraui_menu_id||"")},V=()=>{},O=i=>{b(i),i||o("")},T=()=>{if(E.length===0)return null;const i=()=>{const h={};return L&&L.current&&(h.minWidth=`${L.current.getBoundingClientRect().width}px`),h};return e.jsxRuntimeExports.jsx("div",{className:"menu-popover-box",style:i(),children:E&&E.map((h,M)=>e.jsxRuntimeExports.jsx(q,{item:h,selectValue:t,clickUserItem:U,onMouseEnter:()=>H(h),onMouseLeave:V,hoverId:N,showDialog:_,selectId:v,idMapLast:d},M))})},W=()=>e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[p||s&&e.jsxRuntimeExports.jsx("img",{src:s,alt:""}),a&&e.jsxRuntimeExports.jsx("span",{className:"label",style:{marginLeft:"12px"},children:a}),r&&r.length>0&&e.jsxRuntimeExports.jsx("span",{className:"arrow",children:e.jsxRuntimeExports.jsx(X.Down,{})})]}),A=()=>{let i="logo";return l&&(i+=` ${l}`),_&&(i+=" logo-show-dialog"),i};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:m||e.jsxRuntimeExports.jsx(y.Popover,{trigger:"hover",visible:_,placement:"bottom-start",content:T(),overlayClassName:`${S.$prefixCls}-horizontal-meun-right-popover`,onVisibleChange:O,children:e.jsxRuntimeExports.jsx("div",{className:A(),onClick:B,ref:L,children:W()})})})},z=g=>{const{className:s="",backSelfcareProps:p,languageProps:a,btnListProps:m,userProps:l,helpProps:r,render:x}=g,c=()=>{let _="horizontal-meun-right";return s&&(_+=` ${s}`),_},t=n.useMemo(()=>p&&e.jsxRuntimeExports.jsx(Z,{...p}),[p]),E=n.useMemo(()=>r&&e.jsxRuntimeExports.jsx(ee,{...r}),[r]),R=n.useMemo(()=>a&&e.jsxRuntimeExports.jsx(se,{...a}),[a]),v=n.useMemo(()=>m&&e.jsxRuntimeExports.jsx(te,{...m}),[m]),f=n.useMemo(()=>l&&e.jsxRuntimeExports.jsx(ne,{...l}),[l]);return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:x||e.jsxRuntimeExports.jsxs("div",{className:c(),children:[t,E,R,v,f]})})};exports.HorizontalMeunRight=z;exports.default=z;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("../_virtual/jsx-runtime.js"),n=require("react"),K=require("../Button/index.js"),y=require("../Popover/index.js"),Q=require("../AutoTips/index.js"),X=require("../node_modules/@para-ui/icons/Down/index.js"),Y=require("../node_modules/@para-ui/icons/Right/index.js"),S=require("../GlobalContext/constant.js"),F=require("@snack-kit/lib"),Z=g=>{const{icon:s,label:p,render:a,onClick:m,className:l}=g,r=t=>{m&&m(t)},x=()=>e.jsxRuntimeExports.jsx(K.Button,{startIcon:s,variant:"contained",onClick:r,size:"small",children:p}),c=()=>{let t="back-btn";return l&&(t+=` ${l}`),t};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:a||e.jsxRuntimeExports.jsx("div",{className:c(),children:x()})})},ee=g=>{const{icon:s,label:p,render:a,onClick:m,className:l}=g,r=()=>{let x="help-btn";return l&&(x+=` ${l}`),x};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:a||e.jsxRuntimeExports.jsxs("div",{className:r(),onClick:m,children:[s&&e.jsxRuntimeExports.jsx("span",{className:"icon",children:s}),p&&e.jsxRuntimeExports.jsx("span",{className:"label",children:p})]})})},se=g=>{const{language:s=[],selectLang:p="",onClick:a,className:m,render:l}=g,[r,x]=n.useState({}),[c,t]=n.useState({}),[E,R]=n.useState(!1);n.useEffect(()=>{const o=r[p]||{};t(o)},[p,r]),n.useEffect(()=>{const o={};for(let d=0,u=s.length;d<u;d++){const C=s[d];C.value&&(o[C.value]=C)}x(o)},[s]);const v=o=>()=>{a&&a(o.value,o),R(!1)},f=()=>{let o="language";return m&&(o+=` ${m}`),E&&(o+=" language-select"),o},_=o=>{R(o)},b=()=>{const o=d=>{let u="menu-popover-item";return d.value===c.value&&(u+=" menu-popover-item-select"),u};return e.jsxRuntimeExports.jsx("div",{className:"menu-popover-box",children:s.map((d,u)=>e.jsxRuntimeExports.jsxs("div",{className:o(d),onClick:v(d),children:[d.icon&&e.jsxRuntimeExports.jsx("span",{className:"icon",children:d.icon}),d.label&&e.jsxRuntimeExports.jsx("span",{className:"label",style:{marginLeft:"5px"},children:d.label})]},u))})},N=()=>{const o=()=>e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[c.icon&&e.jsxRuntimeExports.jsx("span",{className:"language-item-icon",children:c.icon}),c.label&&e.jsxRuntimeExports.jsx("span",{className:"language-item-label",children:c.label})]});return e.jsxRuntimeExports.jsx(y.Popover,{trigger:"hover",visible:E,placement:"bottom-start",content:b(),overlayClassName:`${S.$prefixCls}-horizontal-meun-right-popover`,onVisibleChange:_,children:e.jsxRuntimeExports.jsx("div",{className:"language-item",children:o()})})};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:l||e.jsxRuntimeExports.jsx("div",{className:f(),children:N()})})},te=g=>{const{list:s=[],render:p,className:a,onClick:m}=g,l=()=>{let c="btn-list";return a&&(c+=` ${a}`),c},r=c=>t=>{m&&m(c,t)},x=n.useMemo(()=>{const c=t=>e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[t.icon&&e.jsxRuntimeExports.jsx("span",{className:"btn-list-item-icon",children:t.icon}),t.label&&e.jsxRuntimeExports.jsx("span",{className:"btn-list-item-label",children:t.label})]});return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:s.map((t,E)=>{let R="btn-list-item";return t.sign&&(R+=" btn-list-item-sign"),e.jsxRuntimeExports.jsx("div",{className:R,onClick:r(t),children:c(t)},E)})})},[s]);return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:p||e.jsxRuntimeExports.jsx("div",{className:l(),children:x})})},q=g=>{const{item:s,selectValue:p,selectId:a,clickUserItem:m,hoverId:l,showDialog:r,idMapLast:x,onMouseEnter:c,onMouseLeave:t}=g,[E,R]=n.useState(!1),[v,f]=n.useState("");n.useEffect(()=>(r===!1&&R(!1),()=>{f("")}),[r]);const _=u=>{f(u._paraui_menu_id||"")},b=()=>{},N=()=>{let u="menu-popover-item";return l===s._paraui_menu_id&&(u+=" menu-popover-item-hover"),s._paraui_menu_id&&x[l]&&x[l].indexOf(s._paraui_menu_id)!==-1&&(u+=" menu-popover-item-hover"),s._paraui_menu_id&&x[a]&&x[a].indexOf(s._paraui_menu_id)!==-1&&(u+=" menu-popover-item-select"),u},o=()=>{if(s.children&&s.children.length>0)return e.jsxRuntimeExports.jsx("div",{className:"menu-popover-box",children:s.children&&s.children.map((u,C)=>e.jsxRuntimeExports.jsx(q,{item:u,selectValue:p,clickUserItem:m,onMouseEnter:()=>_(u),onMouseLeave:b,hoverId:v,showDialog:r,selectId:a,idMapLast:x},C))})},d=u=>{R(u),u||f("")};return e.jsxRuntimeExports.jsx(y.Popover,{visible:E,trigger:"hover",placement:"left-start",content:o(),onVisibleChange:d,overlayClassName:`${S.$prefixCls}-horizontal-meun-right-popover ${S.$prefixCls}-horizontal-meun-right-popover-children`,children:e.jsxRuntimeExports.jsxs("div",{className:N(),onClick:m(s),onMouseEnter:c,onMouseLeave:t,children:[s.icon&&e.jsxRuntimeExports.jsx("span",{className:"icon",style:{marginRight:"5px"},children:s.icon}),s.label&&e.jsxRuntimeExports.jsx("span",{className:"label",children:e.jsxRuntimeExports.jsx(Q.default,{children:s.label})}),s.children&&s.children.length>0&&e.jsxRuntimeExports.jsx("span",{className:"icon icon-right",children:e.jsxRuntimeExports.jsx(Y.Right,{})})]})})},ne=g=>{const{img:s,imgRender:p,label:a,render:m,className:l,list:r,onClick:x,onClickMenu:c,selectValue:t}=g,[E,R]=n.useState([]),[v,f]=n.useState(""),[_,b]=n.useState(!1),[N,o]=n.useState(""),[d,u]=n.useState({}),[C]=n.useState({}),L=n.useRef(null),I=n.useRef({listJson:{}});n.useEffect(()=>()=>{clearTimeout(C.timer)},[]),n.useEffect(()=>{J()},[r]),n.useEffect(()=>{const i=Object.keys(I.current.listJson);for(let h=0,M=i.length;h<M;h++){const k=I.current.listJson[i[h]];if(k.value===t){f(k._paraui_menu_id||"");break}}},[t,r]);const J=()=>{const i={},h={},M={},k=(D,$)=>{for(let P=0,G=D.length;P<G;P++){const j=D[P];if(j._paraui_menu_id=`_paraui_menu_id_${F.UUID()}`,i[j._paraui_menu_id]=j,$&&$._paraui_menu_id){const w=F.DeepClone(h[$._paraui_menu_id]||[]);w.push(j._paraui_menu_id),h[j._paraui_menu_id]=[...w]}else h[j._paraui_menu_id]=[j._paraui_menu_id],j._paraui_menu_first=!0;j.children&&j.children.length>0?k(j.children,j):M[j._paraui_menu_id]=h[j._paraui_menu_id]}};k(r||[]),I.current.listJson=i,R([...r||[]]),u(M)},B=i=>{x&&x(i)},U=i=>()=>{i.children&&i.children.length>0||(c&&c(i.value,i),b(!1),o(""))},H=i=>{o(i._paraui_menu_id||"")},V=()=>{},O=i=>{b(i),i||o("")},T=()=>{if(E.length===0)return null;const i=()=>{const h={};return L&&L.current&&(h.minWidth=`${L.current.getBoundingClientRect().width}px`),h};return e.jsxRuntimeExports.jsx("div",{className:"menu-popover-box",style:i(),children:E&&E.map((h,M)=>e.jsxRuntimeExports.jsx(q,{item:h,selectValue:t,clickUserItem:U,onMouseEnter:()=>H(h),onMouseLeave:V,hoverId:N,showDialog:_,selectId:v,idMapLast:d},M))})},W=()=>e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[p||s&&e.jsxRuntimeExports.jsx("img",{src:s,alt:""}),a&&e.jsxRuntimeExports.jsx("span",{className:"label",style:{marginLeft:"12px"},children:a}),r&&r.length>0&&e.jsxRuntimeExports.jsx("span",{className:"arrow",children:e.jsxRuntimeExports.jsx(X.Down,{})})]}),A=()=>{let i="logo";return l&&(i+=` ${l}`),_&&(i+=" logo-show-dialog"),i};return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:m||e.jsxRuntimeExports.jsx(y.Popover,{trigger:"hover",visible:_,placement:"bottom-start",content:T(),overlayClassName:`${S.$prefixCls}-horizontal-meun-right-popover`,onVisibleChange:O,children:e.jsxRuntimeExports.jsx("div",{className:A(),onClick:B,ref:L,children:W()})})})},z=g=>{const{className:s="",backSelfcareProps:p,languageProps:a,btnListProps:m,userProps:l,helpProps:r,render:x}=g,c=()=>{let _="horizontal-meun-right";return s&&(_+=` ${s}`),_},t=n.useMemo(()=>p&&e.jsxRuntimeExports.jsx(Z,{...p}),[p]),E=n.useMemo(()=>r&&e.jsxRuntimeExports.jsx(ee,{...r}),[r]),R=n.useMemo(()=>a&&e.jsxRuntimeExports.jsx(se,{...a}),[a]),v=n.useMemo(()=>m&&e.jsxRuntimeExports.jsx(te,{...m}),[m]),f=n.useMemo(()=>l&&e.jsxRuntimeExports.jsx(ne,{...l}),[l]);return e.jsxRuntimeExports.jsx(e.jsxRuntimeExports.Fragment,{children:x||e.jsxRuntimeExports.jsxs("div",{className:c(),children:[t,E,R,v,f]})})};exports.HorizontalMeunRight=z;exports.default=z;
 //# sourceMappingURL=horizontalMeunRight.js.map

package/lib/Pagination/component.json

@@ -0,0 +1,181 @@
+{
+    "name": "Pagination",
+    "category": "Navigation",
+    "description": "分页组件，支持 simple / complex 双模式及自定义布局组合",
+    "semantic": {
+        "intent": [
+            "展示数据",
+            "分批加载",
+            "导航"
+        ],
+        "useCases": [
+            "数据列表",
+            "搜索结果",
+            "评论区"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "simple": {
+            "meaning": "简单模式（仅翻页按钮/数字页码）"
+        },
+        "complex": {
+            "meaning": "复杂模式（含总数 + 每页行数 + 页码 + 跳转）"
+        }
+    },
+    "states": [
+        "default",
+        "disabled"
+    ],
+    "idealProps": {
+        "total": {
+            "type": "number",
+            "default": 0,
+            "description": "数据总数"
+        },
+        "page": {
+            "type": "number",
+            "default": 1,
+            "description": "当前页码(受控)"
+        },
+        "rowsPerPage": {
+            "type": "number[]",
+            "default": [10, 20, 50, 100],
+            "description": "每页行数候选项列表(下拉选项)"
+        },
+        "currentRowsPerPage": {
+            "type": "number",
+            "default": 10,
+            "description": "当前选中的每页行数"
+        },
+        "type": {
+            "type": "enum",
+            "values": [
+                "simple",
+                "complex",
+                "PaginationLayout[]"
+            ],
+            "default": "simple",
+            "description": "分页类型;**'simple'** = 仅翻页按钮/数字(sizes/pageRow/jumper 均不显示);**'complex'** = 完整布局(总数+每页行数+页码+跳转,支持 autoType 响应式收叠);**PaginationLayout[]** = 自定义组合，合法值 'sizes'|'pageRow'|'pager'|'jumper'"
+        },
+        "pagerType": {
+            "type": "enum",
+            "values": [
+                "btn",
+                "num"
+            ],
+            "default": "num",
+            "description": "页码显示模式 btn=上下页按钮 / num=数字页码列表"
+        },
+        "flippingArrow": {
+            "type": "PaginationFlippingArrow[]",
+            "values": [
+                "prev",
+                "next"
+            ],
+            "default": ["prev", "next"],
+            "description": "方向键 layout;传空数组隐藏全部箭头"
+        },
+        "autoType": {
+            "type": "boolean",
+            "default": true,
+            "description": "type=complex 自适应模式(响应宽度自动收叠)"
+        },
+        "resizeLine": {
+            "type": "string | number",
+            "description": "type=complex 时重新计算换行(传值变化触发自适应)"
+        },
+        "pageMaxLimit": {
+            "type": "boolean",
+            "default": true,
+            "description": "当前页超过总页数时自动回落到最大页"
+        },
+        "skipFunc": {
+            "type": "function",
+            "signature": "(num?: number, skipValue?: number) => void",
+            "description": "回车跳页回调；num 是校正后目标页（已 clamp 到 1~totalPage），skipValue 是输入框原始值（未校正）"
+        },
+        "changePage": {
+            "type": "function",
+            "signature": "(num?: number) => void",
+            "description": "页码改变回调（点击页码 / prev / next / 回车跳转时均触发）；num 是目标页码"
+        },
+        "changeRowsPerPage": {
+            "type": "function",
+            "signature": "(num: number) => void",
+            "description": "每页行数改变回调；num 是新选中行数（非下标，是实际数值）"
+        },
+        "getPopupContainer": {
+            "type": "function",
+            "description": "rowsPerPage 下拉的渲染父节点 (triggerNode) => HTMLElement"
+        },
+        "className": {
+            "type": "string",
+            "description": "自定义类名（src/Pagination/index.tsx:33 interface 实证，追加到根容器 div）"
+        },
+        "style": {
+            "type": "React.CSSProperties",
+            "description": "自定义样式（src/Pagination/index.tsx:35 interface 实证，透传到根容器 div）"
+        }
+    },
+    "do": [
+        "Table 独立分页时：changePage 里更新父组件 page state 并重新请求数据，将最新 page 回传给 Pagination 维持受控",
+        "展示总记录数 + 每页行数切换：使用 type='complex'，changeRowsPerPage 里同时重置 page=1 再发请求",
+        "在数据量较大时使用服务端分页——本地分页仅适合 <200 条",
+        "保持每页数量适中（10-50）"
+    ],
+    "dont": [
+        "在极少量数据（<20）时使用 Pagination",
+        "隐藏当前页码标识",
+        "changePage/changeRowsPerPage 里不更新父组件 page state——Pagination 是受控组件，不回写 page prop 会导致翻页后页码回弹"
+    ],
+    "events": {
+        "changePage": {
+            "signature": "(num?: number) => void",
+            "asyncSupported": false,
+            "examples": [
+                "受控翻页：changePage={(num) => { setPage(num ?? 1); fetchData(num ?? 1, currentRowsPerPage); }}",
+                "配合 Table：changePage={(num) => { tableRef.current.reload({ page: num }); }}",
+                "防止 undefined：changePage={(num) => setPage(num ?? 1)}  // num 在正常翻页时有值，极端情况下可能 undefined"
+            ],
+            "commonMistakes": [
+                "收到 changePage 后不更新 page prop——Pagination 是受控组件，不回写会导致页码状态不一致",
+                "期望 changePage 在组件内部状态已更新后触发——组件内部先 setPageCom(num) 再触发 changePage，父组件需自行维护独立的 page state",
+                "changeRowsPerPage 里忘记重置 page=1——切换每页条数后通常应回到第一页"
+            ]
+        },
+        "changeRowsPerPage": {
+            "signature": "(num: number) => void",
+            "asyncSupported": false,
+            "examples": [
+                "切换每页行数并重置页码：changeRowsPerPage={(num) => { setCurrentRowsPerPage(num); setPage(1); fetchData(1, num); }}",
+                "受控写法：currentRowsPerPage={currentRowsPerPage} changeRowsPerPage={(num) => setCurrentRowsPerPage(num)}"
+            ],
+            "commonMistakes": [
+                "忘记同步更新 currentRowsPerPage prop——不回写 prop 导致下拉显示旧值",
+                "假设 num 是下标而非实际行数值——num 是 rowsPerPage 数组里选中的那个数字本身"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "type prop 接受 PaginationLayout[] 数组，但内部枚举是 'sizes'|'pageRow'|'pager'|'jumper'，不是 'complex'|'simple'",
+            "wrong": "type={['simple', 'pager']}  // 'simple' 不在 PaginationLayout 联合类型",
+            "right": "type={['pager', 'jumper']}  // 自定义布局组合只能用 PaginationLayout 枚举值"
+        },
+        {
+            "issue": "changeRowsPerPage 回参 num 是 number，不是可选 number | undefined",
+            "wrong": "(num?: number) => setCurrentRowsPerPage(num ?? 10)  // 多余的 ?? 语法噪音",
+            "right": "(num: number) => setCurrentRowsPerPage(num)  // num 保证有值"
+        },
+        {
+            "issue": "skipFunc 与 changePage 在回车跳页时都会触发，不要做重复请求",
+            "wrong": "skipFunc={(num) => fetchData(num)} changePage={(num) => fetchData(num)}  // 回车时两个都触发，重复请求",
+            "right": "// 只需 changePage 处理翻页逻辑；skipFunc 是可选补充，跳页专用（例如记录跳转日志）"
+        }
+    ],
+    "mapping": {
+        "realComponent": "Pagination",
+        "adapter": null
+    }
+}

package/lib/Pagination/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const n=require("../_virtual/jsx-runtime.js"),r=require("react"),xe=require("../GlobalContext/index.js"),R=require("../GlobalContext/constant.js"),ge=require("../TextField/index.js"),fe=require("../GlobalContext/useFormatMessage.js"),de=require("./lang/index.js"),je=require("../Select/index.js"),V=require("../Button/index.js"),K=require("../node_modules/@para-ui/icons/Left/index.js"),he=require("rc-pagination"),U=require("../node_modules/@para-ui/icons/Right/index.js"),ve=require("../node_modules/@para-ui/icons/DoubleLeft/index.js"),Pe=require("../node_modules/@para-ui/icons/DoubleRight/index.js");;/* empty css            */const G=E=>{const{className:q,style:H,type:c="simple",pagerType:b="num",autoType:k=!0,total:p=0,rowsPerPage:$=[10,20,50,100],flippingArrow:z=["prev","next"],currentRowsPerPage:M=10,page:S=1,pageMaxLimit:L=!0,skipFunc:D,changePage:w,changeRowsPerPage:I,getPopupContainer:A,resizeLine:J}=E,m=fe.default("Pagination",de.default),{language:C,locale:x}=r.useContext(xe.default),[l,B]=r.useState(M),[_,Q]=r.useState([]),[s,y]=r.useState(S),[a,W]=r.useState(),[g,T]=r.useState(),[o,F]=r.useState(null),f=r.useRef(null),i=r.useRef({layoutArr:["jumper","pageRow","pager-btn","sizes","pager-num"]});i.current.type=c,i.current.autoType=k,r.useEffect(()=>()=>{window.removeEventListener("resize",d),clearTimeout(i.current.timer),clearTimeout(i.current.changePagination)},[]),r.useEffect(()=>{y(S)},[S]),r.useEffect(()=>{B(M)},[M]),r.useEffect(()=>{const e=[];for(let t=0,u=$.length;t<u;t++){const N=$[t],P={label:N.toString()+m({id:"barPage"}),value:N};e.push(P)}Q(e)},[E.rowsPerPage,x]),r.useEffect(()=>{const e=Number(a);L&&s>e&&e!==s&&y(e)},[s,a,L]),r.useEffect(()=>{const e=Math.ceil(p/l);W(e||E.page||1)},[l,p]),r.useEffect(()=>{c==="complex"&&k?(d(),window.addEventListener("resize",d)):window.removeEventListener("resize",d)},[c,k]),r.useEffect(()=>{i.current.type==="complex"&&i.current.autoType&&d()},[p,l,s,C,J]);const d=()=>{clearTimeout(i.current.timer);const e=f.current;e&&(e.classList.add(`${R.$prefixCls}-pagination-over`),i.current.timer=setTimeout(()=>{F(i.current.layoutArr.length),i.current.layoutArr.length>1&&O()},100))},X=()=>{const e=[".total-num",".component-pagination",".pagination-btn-content",".page-line-memo",".skip-page-memo"];let t,u=!1;return e.forEach(N=>{const P=f.current.querySelector(N);P&&(t===void 0?t=P.offsetTop:P.offsetTop!==t&&(u=!0))}),u},O=e=>{if(!(e===null||e===0))if(e===void 0&&(e=i.current.layoutArr.length),X()){const t=Number(e)-1;F(t),t>3?O(t):f.current.classList.remove(`${R.$prefixCls}-pagination-over`)}else f.current.classList.remove(`${R.$prefixCls}-pagination-over`)},j=e=>i.current.type instanceof Array&&i.current.type.indexOf(e)===-1,h=e=>{if(o===null)return!1;switch(e){case"jumper":return o<=0;case"pageRow":return o<=1;case"pager-btn":return o<=2||o>4;case"sizes":return o<=3;case"pager-num":return o<=4;default:return!1}},v=e=>t=>{let u=s;switch(e){case"prev":if(s===1)return;u--;break;case"next":if(s===a)return;u++;break;case"pagination":u=t;break}u!==void 0&&y(u),w&&w(u)},Y=e=>{if(e===void 0)return;const t=Number(e);e!==l&&(B(t),I&&I(t))},Z=e=>{["E","e",".","-"].indexOf(e.key)!==-1&&e.preventDefault()},ee=e=>{if(e.keyCode===13){let t=parseInt(g&&g.toString()||"0");t<=0&&(t=1,T(t)),t>Number(a)&&(t=Number(a),T(t)),D&&D(t,g),y(t),w&&w(t)}},te=e=>{T(Number(e.target.value))},ne=e=>{const t=/(?=(\B)(\d{3})+$)/g;return e.toString().replace(t,",")},re=r.useMemo(()=>{if(c==="simple"||j("sizes")||h("sizes"))return null;const e=ne(p);return n.jsxRuntimeExports.jsx("div",{className:"total-num pagination-space",children:m({id:"total"},{total:e})})},[p,C,x,o]),se=r.useMemo(()=>j("pageRow")||h("pageRow")?null:n.jsxRuntimeExports.jsx("div",{className:"page-line-memo pagination-space",children:n.jsxRuntimeExports.jsx(je.default,{className:"page-line-select",size:"large",value:l,list:_,hideErrorDom:!0,onChange:Y,allowClear:!1,getPopupContainer:A})}),[_,l,A,C,x,o]),ie=()=>n.jsxRuntimeExports.jsxs("div",{className:"jump-prev-icon",children:[n.jsxRuntimeExports.jsx("span",{children:"..."}),n.jsxRuntimeExports.jsx(ve.DoubleLeft,{})]}),oe=()=>n.jsxRuntimeExports.jsxs("div",{className:"jump-next-icon",children:[n.jsxRuntimeExports.jsx("span",{children:"..."}),n.jsxRuntimeExports.jsx(Pe.DoubleRight,{})]}),ae=()=>b!=="num"||c==="simple"?!0:c==="complex"?h("pager-num"):j("pager"),ue=r.useMemo(()=>ae()?null:n.jsxRuntimeExports.jsxs("div",{className:"pagination-content pagination-space",children:[z.indexOf("prev")!==-1&&n.jsxRuntimeExports.jsx("div",{className:"left-page",children:n.jsxRuntimeExports.jsx("div",{onClick:v("prev"),className:s===1?"disabled-btn":"",children:n.jsxRuntimeExports.jsx(K.Left,{})})}),n.jsxRuntimeExports.jsx(he,{prefixCls:`${R.$rcPrefixCls}-pagination`,current:s,pageSize:l,total:p,jumpPrevIcon:ie(),jumpNextIcon:oe(),onChange:v("pagination"),showTitle:!1}),z.indexOf("next")!==-1&&n.jsxRuntimeExports.jsx("div",{className:"right-page",children:n.jsxRuntimeExports.jsx("div",{onClick:v("next"),className:s===a?"disabled-btn":"",children:n.jsxRuntimeExports.jsx(U.Right,{})})})]}),[p,s,a,l,E.flippingArrow,b,o]),ce=()=>b==="btn"||c==="simple"?!1:c==="complex"?h("pager-btn"):j("pager"),le=r.useMemo(()=>ce()?null:n.jsxRuntimeExports.jsxs("div",{className:"pagination-btn-content pagination-space",children:[n.jsxRuntimeExports.jsx(V.Button,{variant:"outlined",size:"large",startIcon:n.jsxRuntimeExports.jsx(K.Left,{}),onClick:v("prev"),disabled:s===1,children:m({id:"prevPage"})}),n.jsxRuntimeExports.jsx(V.Button,{variant:"outlined",size:"large",endIcon:n.jsxRuntimeExports.jsx(U.Right,{}),onClick:v("next"),disabled:s===a,children:m({id:"nextPage"})})]}),[s,a,b,x,o]),pe=r.useMemo(()=>j("jumper")||h("jumper")?null:n.jsxRuntimeExports.jsxs("div",{className:"skip-page-memo pagination-space",children:[n.jsxRuntimeExports.jsx("span",{children:m({id:"jumpTo"})}),n.jsxRuntimeExports.jsx(ge.TextField,{className:"skip-page-text-field",size:"large",type:"number",value:g||"",onChange:te,hideErrorDom:!0,onKeydown:Z,onKeyUp:ee}),n.jsxRuntimeExports.jsxs("span",{children:["/ ",a,m({id:"page"})]})]}),[g,a,C,x,o]),me=()=>{let e=`${R.$prefixCls}-pagination`;return q&&(e+=` ${q}`),e};return n.jsxRuntimeExports.jsxs("div",{className:me(),style:H,ref:f,children:[re,ue,le,se,pe]})};exports.Pagination=G;exports.default=G;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const n=require("../_virtual/jsx-runtime.js"),r=require("react"),xe=require("../GlobalContext/index.js"),R=require("../GlobalContext/constant.js"),ge=require("../TextField/index.js"),fe=require("../GlobalContext/useFormatMessage.js"),de=require("./lang/index.js"),je=require("../Select/index.js"),V=require("../Button/index.js"),K=require("../node_modules/@para-ui/icons/Left/index.js"),ve=require("rc-pagination"),U=require("../node_modules/@para-ui/icons/Right/index.js"),he=require("../node_modules/@para-ui/icons/DoubleLeft/index.js"),Pe=require("../node_modules/@para-ui/icons/DoubleRight/index.js");;/* empty css            */const G=E=>{const{className:q,style:H,type:c="simple",pagerType:b="num",autoType:k=!0,total:p=0,rowsPerPage:$=[10,20,50,100],flippingArrow:z=["prev","next"],currentRowsPerPage:M=10,page:S=1,pageMaxLimit:L=!0,skipFunc:D,changePage:w,changeRowsPerPage:I,getPopupContainer:A,resizeLine:J}=E,m=fe.default("Pagination",de.default),{language:C,locale:x}=r.useContext(xe.default),[l,B]=r.useState(M),[_,Q]=r.useState([]),[s,y]=r.useState(S),[a,W]=r.useState(),[g,T]=r.useState(),[o,F]=r.useState(null),f=r.useRef(null),i=r.useRef({layoutArr:["jumper","pageRow","pager-btn","sizes","pager-num"]});i.current.type=c,i.current.autoType=k,r.useEffect(()=>()=>{window.removeEventListener("resize",d),clearTimeout(i.current.timer??void 0),clearTimeout(i.current.changePagination??void 0)},[]),r.useEffect(()=>{y(S)},[S]),r.useEffect(()=>{B(M)},[M]),r.useEffect(()=>{const e=[];for(let t=0,u=$.length;t<u;t++){const N=$[t],P={label:N.toString()+m({id:"barPage"}),value:N};e.push(P)}Q(e)},[E.rowsPerPage,x]),r.useEffect(()=>{const e=Number(a);L&&s>e&&e!==s&&y(e)},[s,a,L]),r.useEffect(()=>{const e=Math.ceil(p/l);W(e||E.page||1)},[l,p]),r.useEffect(()=>{c==="complex"&&k?(d(),window.addEventListener("resize",d)):window.removeEventListener("resize",d)},[c,k]),r.useEffect(()=>{i.current.type==="complex"&&i.current.autoType&&d()},[p,l,s,C,J]);const d=()=>{clearTimeout(i.current.timer??void 0);const e=f.current;e&&(e.classList.add(`${R.$prefixCls}-pagination-over`),i.current.timer=setTimeout(()=>{F(i.current.layoutArr.length),i.current.layoutArr.length>1&&O()},100))},X=()=>{const e=[".total-num",".component-pagination",".pagination-btn-content",".page-line-memo",".skip-page-memo"];let t,u=!1;return e.forEach(N=>{const P=f.current.querySelector(N);P&&(t===void 0?t=P.offsetTop:P.offsetTop!==t&&(u=!0))}),u},O=e=>{if(!(e===null||e===0))if(e===void 0&&(e=i.current.layoutArr.length),X()){const t=Number(e)-1;F(t),t>3?O(t):f.current.classList.remove(`${R.$prefixCls}-pagination-over`)}else f.current.classList.remove(`${R.$prefixCls}-pagination-over`)},j=e=>i.current.type instanceof Array&&i.current.type.indexOf(e)===-1,v=e=>{if(o===null)return!1;switch(e){case"jumper":return o<=0;case"pageRow":return o<=1;case"pager-btn":return o<=2||o>4;case"sizes":return o<=3;case"pager-num":return o<=4;default:return!1}},h=e=>t=>{let u=s;switch(e){case"prev":if(s===1)return;u--;break;case"next":if(s===a)return;u++;break;case"pagination":u=t;break}u!==void 0&&y(u),w&&w(u)},Y=e=>{if(e===void 0)return;const t=Number(e);e!==l&&(B(t),I&&I(t))},Z=e=>{["E","e",".","-"].indexOf(e.key)!==-1&&e.preventDefault()},ee=e=>{if(e.keyCode===13){let t=parseInt(g&&g.toString()||"0");t<=0&&(t=1,T(t)),t>Number(a)&&(t=Number(a),T(t)),D&&D(t,g),y(t),w&&w(t)}},te=e=>{T(Number(e.target.value))},ne=e=>{const t=/(?=(\B)(\d{3})+$)/g;return e.toString().replace(t,",")},re=r.useMemo(()=>{if(c==="simple"||j("sizes")||v("sizes"))return null;const e=ne(p);return n.jsxRuntimeExports.jsx("div",{className:"total-num pagination-space",children:m({id:"total"},{total:e})})},[p,C,x,o]),se=r.useMemo(()=>j("pageRow")||v("pageRow")?null:n.jsxRuntimeExports.jsx("div",{className:"page-line-memo pagination-space",children:n.jsxRuntimeExports.jsx(je.default,{className:"page-line-select",size:"large",value:l,list:_,hideErrorDom:!0,onChange:Y,allowClear:!1,getPopupContainer:A})}),[_,l,A,C,x,o]),ie=()=>n.jsxRuntimeExports.jsxs("div",{className:"jump-prev-icon",children:[n.jsxRuntimeExports.jsx("span",{children:"..."}),n.jsxRuntimeExports.jsx(he.DoubleLeft,{})]}),oe=()=>n.jsxRuntimeExports.jsxs("div",{className:"jump-next-icon",children:[n.jsxRuntimeExports.jsx("span",{children:"..."}),n.jsxRuntimeExports.jsx(Pe.DoubleRight,{})]}),ae=()=>b!=="num"||c==="simple"?!0:c==="complex"?v("pager-num"):j("pager"),ue=r.useMemo(()=>ae()?null:n.jsxRuntimeExports.jsxs("div",{className:"pagination-content pagination-space",children:[z.indexOf("prev")!==-1&&n.jsxRuntimeExports.jsx("div",{className:"left-page",children:n.jsxRuntimeExports.jsx("div",{onClick:h("prev"),className:s===1?"disabled-btn":"",children:n.jsxRuntimeExports.jsx(K.Left,{})})}),n.jsxRuntimeExports.jsx(ve,{prefixCls:`${R.$rcPrefixCls}-pagination`,current:s,pageSize:l,total:p,jumpPrevIcon:ie(),jumpNextIcon:oe(),onChange:h("pagination"),showTitle:!1}),z.indexOf("next")!==-1&&n.jsxRuntimeExports.jsx("div",{className:"right-page",children:n.jsxRuntimeExports.jsx("div",{onClick:h("next"),className:s===a?"disabled-btn":"",children:n.jsxRuntimeExports.jsx(U.Right,{})})})]}),[p,s,a,l,E.flippingArrow,b,o]),ce=()=>b==="btn"||c==="simple"?!1:c==="complex"?v("pager-btn"):j("pager"),le=r.useMemo(()=>ce()?null:n.jsxRuntimeExports.jsxs("div",{className:"pagination-btn-content pagination-space",children:[n.jsxRuntimeExports.jsx(V.Button,{variant:"outlined",size:"large",startIcon:n.jsxRuntimeExports.jsx(K.Left,{}),onClick:h("prev"),disabled:s===1,children:m({id:"prevPage"})}),n.jsxRuntimeExports.jsx(V.Button,{variant:"outlined",size:"large",endIcon:n.jsxRuntimeExports.jsx(U.Right,{}),onClick:h("next"),disabled:s===a,children:m({id:"nextPage"})})]}),[s,a,b,x,o]),pe=r.useMemo(()=>j("jumper")||v("jumper")?null:n.jsxRuntimeExports.jsxs("div",{className:"skip-page-memo pagination-space",children:[n.jsxRuntimeExports.jsx("span",{children:m({id:"jumpTo"})}),n.jsxRuntimeExports.jsx(ge.TextField,{className:"skip-page-text-field",size:"large",type:"number",value:g||"",onChange:te,hideErrorDom:!0,onKeydown:Z,onKeyUp:ee}),n.jsxRuntimeExports.jsxs("span",{children:["/ ",a,m({id:"page"})]})]}),[g,a,C,x,o]),me=()=>{let e=`${R.$prefixCls}-pagination`;return q&&(e+=` ${q}`),e};return n.jsxRuntimeExports.jsxs("div",{className:me(),style:H,ref:f,children:[re,ue,le,se,pe]})};exports.Pagination=G;exports.default=G;
 //# sourceMappingURL=index.js.map

package/lib/ParauiProvider/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('../Styles/index.css');const s=require("../_virtual/jsx-runtime.js"),d=require("react"),q=require("../GlobalContext/index.js"),l=require("@paraview/lib"),f=require("../GlobalContext/intl.js");;/* empty css                    */const m=require("../GlobalContext/confirmLocale.js"),u=e=>{const r=(a,c)=>(n,o)=>{const t=e.language||l.GetLanguage(),i=(e.locale||{})[t]||{},g={[t]:i[a]||{}};return f.i18nIntl({ops:n,i18nData:g,lang:t,params:o,defI18nData:c})};return d.useEffect(()=>{const a=e.language||l.GetLanguage(),n=(e.locale||{})[a]||{};m.changeConfirmLocale?.(n,a)},[e.language,e.locale]),s.jsxRuntimeExports.jsx(q.default.Provider,{value:{...e,language:e.language||l.GetLanguage(),intlFormat:r},children:e.children})};exports.ParauiProvider=u;exports.default=u;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('../Styles/index.css');const s=require("../_virtual/jsx-runtime.js"),d=require("react"),f=require("../GlobalContext/index.js"),l=require("../Utils/snack-kit-shims.js"),m=require("../GlobalContext/intl.js");;/* empty css                    */const q=require("../GlobalContext/confirmLocale.js"),u=e=>{const o=(a,c)=>(n,i)=>{const t=e.language||l.GetLanguage(),r=(e.locale||{})[t]||{},g={[t]:r[a]||{}};return m.i18nIntl({ops:n,i18nData:g,lang:t,params:i,defI18nData:c})};return d.useEffect(()=>{const a=e.language||l.GetLanguage(),n=(e.locale||{})[a]||{};q.changeConfirmLocale?.(n,a)},[e.language,e.locale]),s.jsxRuntimeExports.jsx(f.default.Provider,{value:{...e,language:e.language||l.GetLanguage(),intlFormat:o},children:e.children})};exports.ParauiProvider=u;exports.default=u;
 //# sourceMappingURL=index.js.map

package/lib/PasswordRules/component.json

@@ -0,0 +1,105 @@
+{
+    "name": "PasswordRules",
+    "category": "Data Display",
+    "description": "密码规则校验器，实时显示密码强度及各项规则通过/失败状态",
+    "semantic": {
+        "intent": [
+            "密码验证",
+            "规则提示",
+            "安全引导"
+        ],
+        "useCases": [
+            "注册",
+            "修改密码",
+            "安全设置"
+        ],
+        "riskLevel": "high"
+    },
+    "variants": {
+        "icon": {
+            "meaning": "图标模式（✓/✗ 图标指示每条规则）"
+        },
+        "order": {
+            "meaning": "序列模式（1. 2. 3. 数字序号）"
+        }
+    },
+    "states": [
+        "pass",
+        "fail"
+    ],
+    "idealProps": {
+        "value": {
+            "type": "string",
+            "description": "需要校验的密码值；每次 value 变化组件自动重新对所有规则校验并触发 onCheckAll"
+        },
+        "config": {
+            "type": "PasswordRulesConfigProps | PasswordRulesConfigProps[]",
+            "description": "规则配置，单组或多组。**PasswordRulesConfigProps** = { title?: ReactNode; type?: 'icon'|'order'; list?: PasswordRulesConfigItemProps[] }；**PasswordRulesConfigItemProps** = { label?: ReactNode; reg?: RegExp（正则校验）; validator?: (item, value) => boolean | ReactNode（自定义校验，返回 true 表示通过，false 或 ReactNode 表示失败，ReactNode 会替换显示文案）; result?: boolean | ReactNode }；⚠️ validator 优先级高于 reg"
+        },
+        "onCheckAll": {
+            "type": "(bol: boolean | undefined) => void",
+            "description": "全部规则校验结果回调：**true** = 所有规则全部通过；**false** = 所有规则全部未通过；**undefined** = 部分通过（非全通过也非全失败）；value 为 undefined 时也回调 undefined"
+        },
+        "boxShadow": {
+            "type": "boolean",
+            "default": false,
+            "description": "是否带有边框阴影（src/PasswordRules/index.tsx:51 interface 实证）"
+        },
+        "className": {
+            "type": "string",
+            "description": "自定义类名"
+        },
+        "style": {
+            "type": "React.CSSProperties",
+            "description": "自定义样式"
+        }
+    },
+    "do": [
+        "在密码输入旁实时显示校验结果——value 受控绑定 TextField 的 onChange",
+        "列出所有规则及其状态，配合 onCheckAll 控制提交按钮的 disabled 状态（true 时才允许提交）",
+        "使用 validator 函数处理复杂规则（如「密码不能包含用户名」），返回 ReactNode 可自定义失败文案",
+        "多组规则（如「格式要求」+「强度要求」）传 config 数组，每组可设置独立 title"
+    ],
+    "dont": [
+        "规则不明确——每条 label 应简短描述具体要求（如「至少 8 位字符」）",
+        "规则过于复杂导致用户无法满足——不超过 6 条主要规则",
+        "只用 reg 不提供 validator——复杂规则如「必须包含大小写」建议用 validator 加更友好的提示"
+    ],
+    "events": {
+        "onCheckAll": {
+            "signature": "(bol: boolean | undefined) => void",
+            "asyncSupported": false,
+            "examples": [
+                "控制提交按钮：onCheckAll={(bol) => setCanSubmit(bol === true)}",
+                "显示强度文案：onCheckAll={(bol) => setStrengthText(bol === true ? '强' : bol === false ? '弱' : '中')}",
+                "value 为空时 onCheckAll(undefined)：onCheckAll={(bol) => { if (bol === undefined) { clearStrengthUI(); return; } setValid(bol); }}"
+            ],
+            "commonMistakes": [
+                "把 bol === false 当「有错误」——false 是「全部失败」；undefined 才是「部分通过」（最常见的进行时状态）",
+                "用 onCheckAll 直接控制表单 submit——建议只用它更新 UI 状态，表单提交时再做一次完整校验",
+                "假设 value 初始化时不触发 onCheckAll——组件 mount 后 value 变化（包括 undefined→string）每次都触发"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "PasswordRulesConfigItemProps.validator 返回值类型是 boolean | ReactNode，不能返回 string 以外的 falsy",
+            "wrong": "validator: (item, value) => value.length >= 8  // 返回 false 表示失败，符合要求",
+            "right": "validator: (item, value) => value.length >= 8 ? true : false  // 显式返回 boolean；返回 ReactNode 可自定义失败文案"
+        },
+        {
+            "issue": "config 可以是单对象或数组，直接传数组字面量时类型推断正确，动态构建时需显式标注",
+            "wrong": "const cfg = { title: '格式', list: [...] }; <PasswordRules config={cfg} />  // 单对象 ok\nconst cfgs = [cfg1, cfg2]; <PasswordRules config={cfgs} />  // 数组 ok，但动态 push 时注意类型",
+            "right": "const cfgs: PasswordRulesConfigProps[] = [cfg1, cfg2]; <PasswordRules config={cfgs} />"
+        },
+        {
+            "issue": "onCheckAll 回参 bol 是三值逻辑，用 === 严格比较而非 truthy/falsy",
+            "wrong": "onCheckAll={(bol) => setValid(!!bol)}  // undefined 被 coerce 成 false，与「全部失败」混淆",
+            "right": "onCheckAll={(bol) => setValid(bol === true)}  // 只有全部通过才为 true"
+        }
+    ],
+    "mapping": {
+        "realComponent": "PasswordRules",
+        "adapter": null
+    }
+}

package/lib/PasswordRules/index.d.ts

@@ -3,7 +3,7 @@ export interface PasswordRulesConfigItemProps {
     /** 文案 */
     label?: ReactNode;
     /** 正则 正则表达式 */
-    reg?: any;
+    reg?: RegExp;
     /** 自定义校验方法
      *    item: 当前项配置
      *    value: 校验值
@@ -14,7 +14,7 @@ export interface PasswordRulesConfigItemProps {
     validator?: (item: PasswordRulesConfigItemProps, value: string) => boolean | ReactNode;
     /** 校验结果 */
     result?: boolean | ReactNode;
-    [name: string]: any;
+    [name: string]: unknown;
 }
 export interface PasswordRulesConfigProps {
     /** 标题 */
@@ -23,7 +23,7 @@ export interface PasswordRulesConfigProps {
     type?: 'icon' | 'order';
     /** 规则列表 */
     list?: PasswordRulesConfigItemProps[];
-    [name: string]: any;
+    [name: string]: unknown;
 }
 export interface PasswordRulesProps {
     /** 样式class */
@@ -43,7 +43,7 @@ export interface PasswordRulesProps {
      * undefined: 未全部通过
      * */
     onCheckAll?: (bol: boolean | undefined) => void;
-    [name: string]: any;
+    [name: string]: unknown;
 }
 declare const PasswordRules: FunctionComponent<PasswordRulesProps>;
 export default PasswordRules;