@para-ui/core 5.0.0-beta.9 → 5.0.1

package/es/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/es/Pagination/index.js

@@ -1,17 +1,17 @@
 import { j as r } from "../_virtual/jsx-runtime.js";
 import de, { useState as g, useRef as q, useEffect as u, useMemo as w } from "react";
 import xe from "../GlobalContext/index.js";
-import { $prefixCls as z, $rcPrefixCls as he } from "../GlobalContext/constant.js";
-import { TextField as ve } from "../TextField/index.js";
+import { $prefixCls as z, $rcPrefixCls as ve } from "../GlobalContext/constant.js";
+import { TextField as he } from "../TextField/index.js";
 import Pe from "../GlobalContext/useFormatMessage.js";
 import je from "./lang/index.js";
 import be from "../Select/index.js";
 import { Button as G } from "../Button/index.js";
-import { Left as J } from "../node_modules/@para-ui/icons/Left/index.js";
+import { Left as J } from "../para-ui-core/node_modules/@para-ui/icons/Left/index.js";
 import we from "rc-pagination";
-import { Right as H } from "../node_modules/@para-ui/icons/Right/index.js";
-import { DoubleLeft as ye } from "../node_modules/@para-ui/icons/DoubleLeft/index.js";
-import { DoubleRight as Ce } from "../node_modules/@para-ui/icons/DoubleRight/index.js";
+import { Right as H } from "../para-ui-core/node_modules/@para-ui/icons/Right/index.js";
+import { DoubleLeft as ye } from "../para-ui-core/node_modules/@para-ui/icons/DoubleLeft/index.js";
+import { DoubleRight as Ce } from "../para-ui-core/node_modules/@para-ui/icons/DoubleRight/index.js";
 import './index.css';/* empty css           */
 const Oe = (y) => {
   const {
@@ -35,7 +35,7 @@ const Oe = (y) => {
     layoutArr: ["jumper", "pageRow", "pager-btn", "sizes", "pager-num"]
   });
   a.current.type = l, a.current.autoType = M, u(() => () => {
-    window.removeEventListener("resize", h), clearTimeout(a.current.timer), clearTimeout(a.current.changePagination);
+    window.removeEventListener("resize", v), clearTimeout(a.current.timer ?? void 0), clearTimeout(a.current.changePagination ?? void 0);
   }, []), u(() => {
     R(S);
   }, [S]), u(() => {
@@ -57,12 +57,12 @@ const Oe = (y) => {
     const e = Math.ceil(m / c);
     Y(e || y.page || 1);
   }, [c, m]), u(() => {
-    l === "complex" && M ? (h(), window.addEventListener("resize", h)) : window.removeEventListener("resize", h);
+    l === "complex" && M ? (v(), window.addEventListener("resize", v)) : window.removeEventListener("resize", v);
   }, [l, M]), u(() => {
-    a.current.type === "complex" && a.current.autoType && h();
+    a.current.type === "complex" && a.current.autoType && v();
   }, [m, c, n, k, W]);
-  const h = () => {
-    clearTimeout(a.current.timer);
+  const v = () => {
+    clearTimeout(a.current.timer ?? void 0);
     const e = x.current;
     e && (e.classList.add(`${z}-pagination-over`), a.current.timer = setTimeout(() => {
       U(a.current.layoutArr.length), a.current.layoutArr.length > 1 && _();
@@ -87,7 +87,7 @@ const Oe = (y) => {
         U(t), t > 3 ? _(t) : x.current.classList.remove(`${z}-pagination-over`);
       } else
         x.current.classList.remove(`${z}-pagination-over`);
-  }, v = (e) => a.current.type instanceof Array && a.current.type.indexOf(e) === -1, P = (e) => {
+  }, h = (e) => a.current.type instanceof Array && a.current.type.indexOf(e) === -1, P = (e) => {
     if (o === null) return !1;
     switch (e) {
       case "jumper":
@@ -144,11 +144,11 @@ const Oe = (y) => {
     const t = /(?=(\B)(\d{3})+$)/g;
     return e.toString().replace(t, ",");
   }, oe = w(() => {
-    if (l === "simple" || v("sizes") || P("sizes"))
+    if (l === "simple" || h("sizes") || P("sizes"))
       return null;
     const e = ae(m);
     return /* @__PURE__ */ r.jsx("div", { className: "total-num pagination-space", children: p({ id: "total" }, { total: e }) });
-  }, [m, k, f, o]), ie = w(() => v("pageRow") || P("pageRow") ? null : /* @__PURE__ */ r.jsx("div", { className: "page-line-memo pagination-space", children: /* @__PURE__ */ r.jsx(
+  }, [m, k, f, o]), ie = w(() => h("pageRow") || P("pageRow") ? null : /* @__PURE__ */ r.jsx("div", { className: "page-line-memo pagination-space", children: /* @__PURE__ */ r.jsx(
     be,
     {
       className: "page-line-select",
@@ -166,7 +166,7 @@ const Oe = (y) => {
   ] }), le = () => /* @__PURE__ */ r.jsxs("div", { className: "jump-next-icon", children: [
     /* @__PURE__ */ r.jsx("span", { children: "..." }),
     /* @__PURE__ */ r.jsx(Ce, {})
-  ] }), ce = () => C !== "num" || l === "simple" ? !0 : l === "complex" ? P("pager-num") : v("pager"), ue = w(() => ce() ? null : /* @__PURE__ */ r.jsxs("div", { className: "pagination-content pagination-space", children: [
+  ] }), ce = () => C !== "num" || l === "simple" ? !0 : l === "complex" ? P("pager-num") : h("pager"), ue = w(() => ce() ? null : /* @__PURE__ */ r.jsxs("div", { className: "pagination-content pagination-space", children: [
     I.indexOf("prev") !== -1 && /* @__PURE__ */ r.jsx("div", { className: "left-page", children: /* @__PURE__ */ r.jsx(
       "div",
       {
@@ -178,7 +178,7 @@ const Oe = (y) => {
     /* @__PURE__ */ r.jsx(
       we,
       {
-        prefixCls: `${he}-pagination`,
+        prefixCls: `${ve}-pagination`,
         current: n,
         pageSize: c,
         total: m,
@@ -196,7 +196,7 @@ const Oe = (y) => {
         children: /* @__PURE__ */ r.jsx(H, {})
       }
     ) })
-  ] }), [m, n, i, c, y.flippingArrow, C, o]), me = () => C === "btn" || l === "simple" ? !1 : l === "complex" ? P("pager-btn") : v("pager"), pe = w(() => me() ? null : /* @__PURE__ */ r.jsxs("div", { className: "pagination-btn-content pagination-space", children: [
+  ] }), [m, n, i, c, y.flippingArrow, C, o]), me = () => C === "btn" || l === "simple" ? !1 : l === "complex" ? P("pager-btn") : h("pager"), pe = w(() => me() ? null : /* @__PURE__ */ r.jsxs("div", { className: "pagination-btn-content pagination-space", children: [
     /* @__PURE__ */ r.jsx(
       G,
       {
@@ -219,10 +219,10 @@ const Oe = (y) => {
         children: p({ id: "nextPage" })
       }
     )
-  ] }), [n, i, C, f, o]), ge = w(() => v("jumper") || P("jumper") ? null : /* @__PURE__ */ r.jsxs("div", { className: "skip-page-memo pagination-space", children: [
+  ] }), [n, i, C, f, o]), ge = w(() => h("jumper") || P("jumper") ? null : /* @__PURE__ */ r.jsxs("div", { className: "skip-page-memo pagination-space", children: [
     /* @__PURE__ */ r.jsx("span", { children: p({ id: "jumpTo" }) }),
     /* @__PURE__ */ r.jsx(
-      ve,
+      he,
       {
         className: "skip-page-text-field",
         size: "large",

package/es/ParauiProvider/index.js

@@ -1,7 +1,7 @@
 import { j as m } from "../_virtual/jsx-runtime.js";
 import u from "react";
 import f from "../GlobalContext/index.js";
-import { GetLanguage as n } from "@paraview/lib";
+import { GetLanguage as n } from "../Utils/snack-kit-shims.js";
 import { i18nIntl as s } from "../GlobalContext/intl.js";
 import '../Styles/index.css';/* empty css                   */
 import { changeConfirmLocale as d } from "../GlobalContext/confirmLocale.js";

package/es/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/es/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;

package/es/PasswordRules/index.js

@@ -1,8 +1,8 @@
 import { j as o } from "../_virtual/jsx-runtime.js";
 import { useState as $, useEffect as E } from "react";
 import { $prefixCls as p } from "../GlobalContext/constant.js";
-import { CloseCircleF as R } from "../node_modules/@para-ui/icons/CloseCircleF/index.js";
-import { CheckCircleF as F } from "../node_modules/@para-ui/icons/CheckCircleF/index.js";
+import { CloseCircleF as R } from "../para-ui-core/node_modules/@para-ui/icons/CloseCircleF/index.js";
+import { CheckCircleF as F } from "../para-ui-core/node_modules/@para-ui/icons/CheckCircleF/index.js";
 import './index.css';/* empty css           */
 const q = (h) => {
   const { className: m, style: x, boxShadow: C = !1, value: i, config: l, onCheckAll: u } = h, [j, v] = $([]);