@yuku123/z-frontend-common 1.1.3 → 1.1.4

package/README.md

@@ -15,7 +15,7 @@
 |------|-----|
 | 仓 | `z-opc-foundation/z-frontend-common`（本仓） |
 | npm 包 | `@yuku123/z-frontend-common`（scope 沿用 yuku123，与 0.1.x/0.2.x 旧线连续） |
-| 当前版本 | `1.1.3` —— 1.0 语义：§1-§16 规范化起点；1.1.x 在其上追加扁平 ui 组件桶。0.1.x 是 pre-§16 形态；0.2.x 内嵌 react-dom 已废弃 |
+| 当前版本 | `1.1.4` —— 1.0 语义：§1-§16 规范化起点；1.1.x 在其上追加扁平 ui 组件桶。0.1.x 是 pre-§16 形态；0.2.x 内嵌 react-dom 已废弃 |
 | 技术栈 | React 19 + antd 6 + react-router-dom 7 + Vite 6（lead 005 §3.0 版本线单一尺子） |
 | 产物 | ESM **3 入口**（`formats: ['es']`）：`dist/index.js`（主桶）+ `dist/ui.js`（扁平 ui 桶）+ `dist/ui-echarts.js`（`ui/echarts` 子路径） |
 | 打包策略 | external 精确 **9** 个包 + **1** 条前缀规则（`echarts/*`）：react / react-dom / react-dom/client / react/jsx-runtime / react-router-dom / antd / @ant-design/icons / axios / echarts |
@@ -82,4 +82,5 @@ const MOCK_AUTH = { username: 'admin', password: '123456', user: { name: 'admin'
 - `1.0.0`：独立仓首版 —— 源码自 vendoring 迁入，API 契约兼容 0.1.1，AppLayout/LoginPage 升级 §1-§16 规范版
 - `1.1.1`：在 1.0.0 之上追加扁平 ui 组件桶（13 个 UI 组件 + design token）与 `ui/echarts` 子路径
 - `1.1.2`：ui 桶追加 `ComponentDoc`（§7 组件文档页：240px TOC + 正文两栏、滚动联动、锚点跳转、自带零依赖 markdown 引擎，宿主可注册 react-markdown 三件套升级为 GFM + Prism 高亮）
+- `1.1.4`：ui 桶的 `ListTable` 支持 `cardExtra`（Card 动作按钮）与 `searchKeys`（过滤框）**并排**渲染 —— 原实现二选一，会把其中一个静默吞掉（页面同时有「搜索」和「新增」按钮时按钮消失）。
 - `1.1.3`：ui 桶追加 `useListFilter` / `filterRows`（§2 强制规则 3 的客户端过滤口径统一收在基座：大小写不敏感、多字段「或」匹配、null 字段不参与匹配、空关键字原样返回）与 `ListTable`（§2 规则 2/3/4 的成品件：分页三件套 + Card extra 过滤框 + EmptyState 空态一次到位）

package/dist/{ComponentDoc-CJL2TB6b.js → ComponentDoc-22ujWxLE.js}

@@ -1,7 +1,7 @@
 import { jsxs as m, jsx as t, Fragment as Ce } from "react/jsx-runtime";
-import { useState as z, useRef as H, useEffect as D, useMemo as q, useCallback as be, useLayoutEffect as Re, createElement as ae, Fragment as O } from "react";
+import { useState as B, useRef as N, useEffect as L, useMemo as q, useCallback as be, useLayoutEffect as Re, createElement as ae, Fragment as O } from "react";
 import { Button as V, Skeleton as _, Input as Te, Card as me, Table as ye, Breadcrumb as Ee, Space as se, Tag as ce } from "antd";
-import { InboxOutlined as Ae, ExclamationCircleOutlined as Ie, ReloadOutlined as re, SearchOutlined as ze, ReadOutlined as Be } from "@ant-design/icons";
+import { InboxOutlined as Ie, ExclamationCircleOutlined as Ae, ReloadOutlined as re, SearchOutlined as ze, ReadOutlined as Be } from "@ant-design/icons";
 import { useNavigate as xe, useInRouterContext as De } from "react-router-dom";
 const T = {
   // 主色 (蓝紫) - 顶导/重点按钮/链接
@@ -83,15 +83,15 @@ const T = {
   lg: 16,
   xl: 20,
   pill: 999
-}, B = {
+}, D = {
   sm: "0 1px 2px 0 rgba(15, 23, 42, 0.04), 0 1px 3px 0 rgba(15, 23, 42, 0.06)",
   md: "0 2px 4px -1px rgba(15, 23, 42, 0.04), 0 4px 8px -1px rgba(15, 23, 42, 0.08)",
   lg: "0 4px 6px -2px rgba(15, 23, 42, 0.05), 0 12px 16px -4px rgba(15, 23, 42, 0.10)",
   xl: "0 8px 24px -6px rgba(15, 23, 42, 0.10), 0 24px 48px -12px rgba(15, 23, 42, 0.18)"
 }, at = {
-  rest: B.md,
+  rest: D.md,
   hover: "0 8px 16px -4px rgba(15, 23, 42, 0.08), 0 20px 32px -8px rgba(15, 23, 42, 0.14)"
-}, N = {
+}, P = {
   1: 4,
   2: 8,
   3: 12,
@@ -112,7 +112,7 @@ const T = {
   "2xl": 24,
   "3xl": 30,
   "4xl": 36
-}, M = {
+}, H = {
   token: {
     // 主色
     colorPrimary: T.primary,
@@ -144,8 +144,8 @@ const T = {
     fontSize: de.base,
     fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', Arial, sans-serif",
     // 阴影
-    boxShadow: B.md,
-    boxShadowSecondary: B.lg
+    boxShadow: D.md,
+    boxShadowSecondary: D.lg
   },
   components: {
     // Layout: 顶导白底更现代
@@ -169,7 +169,7 @@ const T = {
     // Card: 更柔和
     Card: {
       borderRadiusLG: C.lg,
-      boxShadowTertiary: B.sm
+      boxShadowTertiary: D.sm
     },
     // Button: 主按钮圆角统一
     Button: {
@@ -200,28 +200,28 @@ function st({
   loading: l = !1,
   precision: i = 0
 }) {
-  const d = E[c] || E.blue, [f, g] = z(0), p = H(0);
-  D(() => {
+  const d = E[c] || E.blue, [f, g] = B(0), p = N(0);
+  L(() => {
     if (l || s == null) return;
     const b = p.current, S = Number(s) || 0;
     if (b === S) {
       g(S);
       return;
     }
-    const w = 600, L = performance.now();
-    let P;
+    const w = 600, A = performance.now();
+    let $;
     const G = (U) => {
-      const j = Math.min(1, (U - L) / w), J = 1 - Math.pow(1 - j, 3), u = b + (S - b) * J;
-      g(u), j < 1 ? P = requestAnimationFrame(G) : p.current = S;
+      const j = Math.min(1, (U - A) / w), J = 1 - Math.pow(1 - j, 3), u = b + (S - b) * J;
+      g(u), j < 1 ? $ = requestAnimationFrame(G) : p.current = S;
     };
-    return P = requestAnimationFrame(G), () => P && cancelAnimationFrame(P);
+    return $ = requestAnimationFrame(G), () => $ && cancelAnimationFrame($);
   }, [s, l]);
   const h = () => {
     r && typeof window < "u" && (window.location.href = r);
   }, k = l ? "--" : Number(f).toLocaleString("zh-CN", {
     minimumFractionDigits: i,
     maximumFractionDigits: i
-  }), v = a != null ? Number(a) : null, A = v != null && v >= 0;
+  }), v = a != null ? Number(a) : null, I = v != null && v >= 0;
   return /* @__PURE__ */ m(
     "div",
     {
@@ -230,10 +230,10 @@ function st({
         position: "relative",
         background: d.gradient,
         borderRadius: C.lg,
-        padding: N[5],
+        padding: P[5],
         color: d.fg,
         cursor: r ? "pointer" : "default",
-        boxShadow: B.md,
+        boxShadow: D.md,
         overflow: "hidden",
         transition: "transform 200ms ease, box-shadow 200ms ease",
         minHeight: 110,
@@ -242,10 +242,10 @@ function st({
         justifyContent: "space-between"
       },
       onMouseEnter: (b) => {
-        b.currentTarget.style.transform = "translateY(-2px)", b.currentTarget.style.boxShadow = B.lg;
+        b.currentTarget.style.transform = "translateY(-2px)", b.currentTarget.style.boxShadow = D.lg;
       },
       onMouseLeave: (b) => {
-        b.currentTarget.style.transform = "translateY(0)", b.currentTarget.style.boxShadow = B.md;
+        b.currentTarget.style.transform = "translateY(0)", b.currentTarget.style.boxShadow = D.md;
       },
       children: [
         /* @__PURE__ */ t(
@@ -266,7 +266,7 @@ function st({
         /* @__PURE__ */ m("div", { style: {
           display: "flex",
           alignItems: "center",
-          gap: N[2],
+          gap: P[2],
           position: "relative"
         }, children: [
           /* @__PURE__ */ t("div", { style: {
@@ -289,9 +289,9 @@ function st({
         /* @__PURE__ */ m("div", { style: {
           display: "flex",
           alignItems: "baseline",
-          gap: N[2],
+          gap: P[2],
           position: "relative",
-          marginTop: N[3]
+          marginTop: P[3]
         }, children: [
           /* @__PURE__ */ t("div", { style: {
             fontSize: 30,
@@ -307,12 +307,12 @@ function st({
             fontWeight: 600,
             padding: "2px 8px",
             borderRadius: 999,
-            background: A ? "rgba(255, 255, 255, 0.22)" : "rgba(0, 0, 0, 0.18)",
+            background: I ? "rgba(255, 255, 255, 0.22)" : "rgba(0, 0, 0, 0.18)",
             display: "flex",
             alignItems: "center",
             gap: 2
           }, children: [
-            /* @__PURE__ */ t("span", { style: { fontSize: 10 }, children: A ? "▲" : "▼" }),
+            /* @__PURE__ */ t("span", { style: { fontSize: 10 }, children: I ? "▲" : "▼" }),
             Math.abs(v).toFixed(1),
             "%"
           ] })
@@ -406,7 +406,7 @@ function dt({
   href: l,
   extra: i
 }) {
-  const d = E[c] || E.violet, [f, g] = z(!1);
+  const d = E[c] || E.violet, [f, g] = B(!1);
   return /* @__PURE__ */ m(
     "div",
     {
@@ -420,7 +420,7 @@ function dt({
         borderRadius: C.lg,
         overflow: "hidden",
         cursor: l ? "pointer" : "default",
-        boxShadow: f ? B.lg : B.sm,
+        boxShadow: f ? D.lg : D.sm,
         transform: f ? "translateY(-2px)" : "translateY(0)",
         transition: "transform 200ms ease, box-shadow 200ms ease",
         border: "1px solid #f1f5f9",
@@ -469,10 +469,10 @@ function dt({
           }, children: i })
         ] }),
         /* @__PURE__ */ m("div", { style: {
-          padding: N[4],
+          padding: P[4],
           display: "flex",
           flexDirection: "column",
-          gap: N[2],
+          gap: P[2],
           flex: 1
         }, children: [
           a.length > 0 && /* @__PURE__ */ t("div", { style: {
@@ -523,7 +523,7 @@ function dt({
             fontSize: 11,
             color: "#9ca3af",
             marginTop: "auto",
-            paddingTop: N[2],
+            paddingTop: P[2],
             borderTop: "1px dashed #f1f5f9"
           }, children: r })
         ] })
@@ -546,7 +546,7 @@ function ft({
     background: "linear-gradient(135deg, #0f172a 0%, #1e293b 50%, #312e81 100%)",
     color: "#ffffff",
     overflow: "hidden",
-    boxShadow: B.lg
+    boxShadow: D.lg
   }, children: [
     /* @__PURE__ */ t("div", { style: {
       position: "absolute",
@@ -670,7 +670,7 @@ function ne({
           marginBottom: 16,
           fontSize: 28,
           color: "#9ca3af"
-        }, children: e || /* @__PURE__ */ t(Ae, {}) }),
+        }, children: e || /* @__PURE__ */ t(Ie, {}) }),
         /* @__PURE__ */ t("div", { style: {
           fontSize: i[a],
           fontWeight: 600,
@@ -741,7 +741,7 @@ function $e({
           color: "#dc2626",
           fontSize: l ? 28 : 18,
           flexShrink: 0
-        }, children: /* @__PURE__ */ t(Ie, {}) }),
+        }, children: /* @__PURE__ */ t(Ae, {}) }),
         /* @__PURE__ */ m("div", { style: { flex: 1, minWidth: 0 }, children: [
           /* @__PURE__ */ t("div", { style: {
             fontSize: l ? 16 : 14,
@@ -872,10 +872,10 @@ function We({
   enterButton: l,
   ...i
 }) {
-  const [d, f] = z(e || ""), g = H(null), p = H(e || "");
-  D(() => {
+  const [d, f] = B(e || ""), g = N(null), p = N(e || "");
+  L(() => {
     e !== void 0 && e !== d && (f(e || ""), p.current = e || "");
-  }, [e]), D(() => () => {
+  }, [e]), L(() => () => {
     g.current && clearTimeout(g.current);
   }, []);
   const h = (S) => {
@@ -923,7 +923,7 @@ function Me(e, n, s) {
   })) : o;
 }
 function He(e, n) {
-  const [s, o] = z(""), c = (Array.isArray(n) ? n.join(",") : String(n || "")).trim(), a = q(
+  const [s, o] = B(""), c = (Array.isArray(n) ? n.join(",") : String(n || "")).trim(), a = q(
     () => Me(e, c, s),
     [e, c, s]
   ), r = be(() => o(""), []);
@@ -952,10 +952,9 @@ function ut({
   pagination: h = Ne,
   cardProps: k = {},
   tableProps: v = {},
-  ...A
+  ...I
 }) {
-  const { keyword: b, setKeyword: S, filtered: w } = He(e, c);
-  return /* @__PURE__ */ t(me, { title: l, extra: (c ? /* @__PURE__ */ t(
+  const { keyword: b, setKeyword: S, filtered: w } = He(e, c), A = c ? /* @__PURE__ */ t(
     We,
     {
       allowClear: !0,
@@ -964,7 +963,11 @@ function ut({
       value: b,
       onChange: S
     }
-  ) : null) || i, ...k, children: /* @__PURE__ */ t(
+  ) : null;
+  return /* @__PURE__ */ t(me, { title: l, extra: A && i ? /* @__PURE__ */ m("span", { style: { display: "inline-flex", alignItems: "center", gap: 8 }, children: [
+    A,
+    i
+  ] }) : A || i, ...k, children: /* @__PURE__ */ t(
     ye,
     {
       rowKey: s,
@@ -985,7 +988,7 @@ function ut({
         )
       },
       ...v,
-      ...A
+      ...I
     }
   ) });
 }
@@ -1149,15 +1152,15 @@ function bt({ status: e, type: n = "task", mapping: s, ...o }) {
   return a ? /* @__PURE__ */ t(ce, { color: a.color, ...o, children: a.label }) : /* @__PURE__ */ t(ce, { ...o, children: String(e) });
 }
 function mt({ title: e, description: n, load: s, columns: o, rowKey: c = "id", extra: a, expandable: r }) {
-  const [l, i] = z([]), [d, f] = z({ current: 1, size: 10, total: null }), [g, p] = z(!1), [h, k] = z(null), v = be(async (b = d.current, S = d.size) => {
+  const [l, i] = B([]), [d, f] = B({ current: 1, size: 10, total: null }), [g, p] = B(!1), [h, k] = B(null), v = be(async (b = d.current, S = d.size) => {
     p(!0), k(null);
     try {
       const w = await s(b, S);
       if (Array.isArray(w))
         i(w || []), f({ current: b, size: S, total: w.length });
       else {
-        const L = (w == null ? void 0 : w.records) || [];
-        i(L), f({ current: b, size: S, total: (w == null ? void 0 : w.total) == null ? null : Number(w.total) });
+        const A = (w == null ? void 0 : w.records) || [];
+        i(A), f({ current: b, size: S, total: (w == null ? void 0 : w.total) == null ? null : Number(w.total) });
       }
     } catch (w) {
       i([]), k(w);
@@ -1165,10 +1168,10 @@ function mt({ title: e, description: n, load: s, columns: o, rowKey: c = "id", e
       p(!1);
     }
   }, [s, d.current, d.size]);
-  D(() => {
+  L(() => {
     v(1);
   }, []);
-  const A = d.total != null && d.total > 0;
+  const I = d.total != null && d.total > 0;
   return /* @__PURE__ */ m("div", { children: [
     /* @__PURE__ */ t(ve, { title: e, subtitle: n }),
     /* @__PURE__ */ m(
@@ -1196,9 +1199,9 @@ function mt({ title: e, description: n, load: s, columns: o, rowKey: c = "id", e
               pagination: {
                 current: d.current,
                 pageSize: d.size,
-                total: A ? d.total : l.length,
+                total: I ? d.total : l.length,
                 showSizeChanger: !0,
-                showTotal: () => A ? `共 ${d.total} 条` : `本页 ${l.length} 条（接口 total 未返回有效值）`
+                showTotal: () => I ? `共 ${d.total} 条` : `本页 ${l.length} 条（接口 total 未返回有效值）`
               },
               onChange: (b) => v(b.current, b.pageSize),
               expandable: r,
@@ -1357,7 +1360,7 @@ function we(e, n = !1) {
   }
   return s;
 }
-const I = (e, n) => {
+const z = (e, n) => {
   const s = [];
   let o = 0, c = 0;
   const a = (r) => s.push(/* @__PURE__ */ t(O, { children: r }, `i${c++}`));
@@ -1366,10 +1369,10 @@ const I = (e, n) => {
       if (r[0].startsWith("!"))
         a(n.img ? n.img({ src: r[3], alt: r[2] }) : /* @__PURE__ */ t("img", { src: r[3], alt: r[2] || "" }));
       else {
-        const l = I(r[2], n);
+        const l = z(r[2], n);
         a(n.a ? n.a({ href: r[3], children: l }) : /* @__PURE__ */ t("a", { href: r[3], children: l }));
       }
-    else r[4] !== void 0 ? a(n.code ? n.code({ children: r[4] }) : /* @__PURE__ */ t("code", { children: r[4] })) : r[5] !== void 0 ? a(/* @__PURE__ */ t("strong", { children: I(r[5], n) })) : r[6] !== void 0 ? a(/* @__PURE__ */ t("strong", { children: I(r[6], n) })) : r[7] !== void 0 ? a(/* @__PURE__ */ t("del", { children: I(r[7], n) })) : r[8] !== void 0 ? a(/* @__PURE__ */ t("em", { children: I(r[8], n) })) : r[9] !== void 0 && a(n.a ? n.a({ href: r[9], children: r[9] }) : /* @__PURE__ */ t("a", { href: r[9], children: r[9] }));
+    else r[4] !== void 0 ? a(n.code ? n.code({ children: r[4] }) : /* @__PURE__ */ t("code", { children: r[4] })) : r[5] !== void 0 ? a(/* @__PURE__ */ t("strong", { children: z(r[5], n) })) : r[6] !== void 0 ? a(/* @__PURE__ */ t("strong", { children: z(r[6], n) })) : r[7] !== void 0 ? a(/* @__PURE__ */ t("del", { children: z(r[7], n) })) : r[8] !== void 0 ? a(/* @__PURE__ */ t("em", { children: z(r[8], n) })) : r[9] !== void 0 && a(n.a ? n.a({ href: r[9], children: r[9] }) : /* @__PURE__ */ t("a", { href: r[9], children: r[9] }));
     o = r.index + r[0].length;
   }
   return o < e.length && a(e.slice(o)), s;
@@ -1378,10 +1381,10 @@ const I = (e, n) => {
   return e.forEach((c, a) => {
     const r = `b${a}`, l = (i) => o.push(/* @__PURE__ */ t(O, { children: i }, r));
     if (c.type === "heading") {
-      const i = Math.min(c.level, 6), d = `h${i}`, f = n[d], g = I(c.text, n), p = i <= 3 ? s(ie(c.text)) : void 0;
+      const i = Math.min(c.level, 6), d = `h${i}`, f = n[d], g = z(c.text, n), p = i <= 3 ? s(ie(c.text)) : void 0;
       l(f ? f({ children: g, id: p }) : ae(d, { id: p }, g));
     } else if (c.type === "paragraph") {
-      const i = I(c.text, n);
+      const i = z(c.text, n);
       l(n.p ? n.p({ children: i }) : /* @__PURE__ */ t("p", { children: i }));
     } else if (c.type === "code") {
       const i = /* @__PURE__ */ t("code", { className: c.lang ? `language-${c.lang}` : void 0, children: c.text });
@@ -1394,16 +1397,16 @@ const I = (e, n) => {
       l(d ? d({ children: f }) : ae(i, null, f));
     } else if (c.type === "table") {
       const i = /* @__PURE__ */ t("thead", { children: /* @__PURE__ */ t("tr", { children: c.header.map((g, p) => {
-        const h = n.th ? n.th({ children: I(g, n), align: c.aligns[p] }) : /* @__PURE__ */ t("th", { children: g });
+        const h = n.th ? n.th({ children: z(g, n), align: c.aligns[p] }) : /* @__PURE__ */ t("th", { children: g });
         return /* @__PURE__ */ t(O, { children: h }, `th${p}`);
       }) }) }, "thead"), d = /* @__PURE__ */ t("tbody", { children: c.rows.map((g, p) => /* @__PURE__ */ t("tr", { children: g.map((h, k) => {
-        const v = n.td ? n.td({ children: I(h, n), align: c.aligns[k] }) : /* @__PURE__ */ t("td", { children: h });
+        const v = n.td ? n.td({ children: z(h, n), align: c.aligns[k] }) : /* @__PURE__ */ t("td", { children: h });
         return /* @__PURE__ */ t(O, { children: v }, `td${k}`);
       }) }, `tr${p}`)) }, "tbody"), f = n.table ? n.table({ children: [i, d] }) : /* @__PURE__ */ t("table", { children: [i, d] });
       l(f);
     } else if (c.type === "quote") {
       const i = c.lines.filter((d) => d.trim()).map((d, f) => {
-        const g = n.p ? n.p({ children: I(d, n) }) : /* @__PURE__ */ t("p", { children: d });
+        const g = n.p ? n.p({ children: z(d, n) }) : /* @__PURE__ */ t("p", { children: d });
         return /* @__PURE__ */ t(O, { children: g }, `q${f}`);
       });
       l(n.blockquote ? n.blockquote({ children: i }) : /* @__PURE__ */ t("blockquote", { children: i }));
@@ -1451,7 +1454,7 @@ const he = /* @__PURE__ */ new Set(), tt = ({ navigate: e, Prism: n, oneDark: s,
     blockquote: ({ node: a, children: r, ...l }) => /* @__PURE__ */ t("blockquote", { ...l, style: {
       margin: "12px 0",
       padding: "8px 14px",
-      borderLeft: `3px solid ${M.token.colorPrimary}`,
+      borderLeft: `3px solid ${H.token.colorPrimary}`,
       background: T.primarySoft,
       color: "#475569",
       borderRadius: 4
@@ -1500,7 +1503,7 @@ const he = /* @__PURE__ */ new Set(), tt = ({ navigate: e, Prism: n, oneDark: s,
           href: d,
           target: "_blank",
           rel: "noopener noreferrer",
-          style: { color: M.token.colorPrimary },
+          style: { color: H.token.colorPrimary },
           children: l
         }
       ) : d.startsWith("#") ? /* @__PURE__ */ t(
@@ -1508,7 +1511,7 @@ const he = /* @__PURE__ */ new Set(), tt = ({ navigate: e, Prism: n, oneDark: s,
         {
           ...i,
           href: d,
-          style: { color: M.token.colorPrimary },
+          style: { color: H.token.colorPrimary },
           onClick: (g) => o(g, d.slice(1)),
           children: l
         }
@@ -1517,13 +1520,13 @@ const he = /* @__PURE__ */ new Set(), tt = ({ navigate: e, Prism: n, oneDark: s,
         {
           ...i,
           href: d,
-          style: { color: M.token.colorPrimary },
+          style: { color: H.token.colorPrimary },
           onClick: (g) => {
             g.preventDefault(), e ? e(d) : typeof window < "u" && (window.location.href = d);
           },
           children: l
         }
-      ) : /* @__PURE__ */ t("a", { ...i, href: d, style: { color: M.token.colorPrimary }, children: l });
+      ) : /* @__PURE__ */ t("a", { ...i, href: d, style: { color: H.token.colorPrimary }, children: l });
     }
   };
 };
@@ -1536,12 +1539,12 @@ function yt({
   markdownComponents: a,
   renderMarkdown: r
 }) {
-  const i = De() ? xe() : null, d = H(null), f = H(null), g = H(""), p = H(null), [h, k] = z(""), [v, A] = z(0), b = q(() => Ve(e), [e]), S = q(
+  const i = De() ? xe() : null, d = N(null), f = N(null), g = N(""), p = N(null), [h, k] = B(""), [v, I] = B(0), b = q(() => Ve(e), [e]), S = q(
     () => b.filter((u) => o.includes(u.level)),
     [b, o]
   );
-  D(() => {
-    const u = () => A((y) => y + 1);
+  L(() => {
+    const u = () => I((y) => y + 1);
     return he.add(u), () => {
       he.delete(u);
     };
@@ -1551,17 +1554,17 @@ function yt({
       g.current = "";
     }, 700);
   };
-  D(() => () => {
+  L(() => () => {
     p.current && clearTimeout(p.current);
   }, []), Re(() => {
     const u = d.current;
     if (!u) return;
     const y = Array.from(u.querySelectorAll("h1, h2, h3"));
-    b.forEach((R, $) => {
-      const W = y[$];
-      W && (W.id !== R.id && (W.id = R.id), W.setAttribute("data-anchor", R.id));
+    b.forEach((R, W) => {
+      const M = y[W];
+      M && (M.id !== R.id && (M.id = R.id), M.setAttribute("data-anchor", R.id));
     });
-  }, [b, v, r]), D(() => {
+  }, [b, v, r]), L(() => {
     const u = d.current;
     if (!u) return;
     const y = Array.from(u.querySelectorAll("h1, h2, h3"));
@@ -1573,33 +1576,33 @@ function yt({
         if (le.getBoundingClientRect().top - Q <= fe) oe = le;
         else break;
       g.current || k(oe.id);
-    }, $ = new IntersectionObserver(R, {
+    }, W = new IntersectionObserver(R, {
       root: u,
       rootMargin: `-${fe}px 0px 0px 0px`,
       threshold: 0
     });
-    y.forEach((Q) => $.observe(Q)), R();
-    const W = () => {
+    y.forEach((Q) => W.observe(Q)), R();
+    const M = () => {
       g.current = "";
     };
-    return u.addEventListener("scrollend", W), () => {
-      $.disconnect(), u.removeEventListener("scrollend", W);
+    return u.addEventListener("scrollend", M), () => {
+      W.disconnect(), u.removeEventListener("scrollend", M);
     };
-  }, [b, v, r]), D(() => {
+  }, [b, v, r]), L(() => {
     const u = f.current;
     if (!u || !h) return;
     const y = u.querySelector(`[data-toc-id="${ge(h)}"]`);
     if (!y) return;
-    const R = u.getBoundingClientRect(), $ = y.getBoundingClientRect();
-    ($.top < R.top + 24 || $.bottom > R.bottom - 24) && y.scrollIntoView({ block: "nearest", behavior: "smooth" });
+    const R = u.getBoundingClientRect(), W = y.getBoundingClientRect();
+    (W.top < R.top + 24 || W.bottom > R.bottom - 24) && y.scrollIntoView({ block: "nearest", behavior: "smooth" });
   }, [h]);
-  const L = (u) => {
+  const A = (u) => {
     const y = d.current;
     return y && y.querySelector(`[data-anchor="${ge(u)}"]`) || (typeof document < "u" ? document.getElementById(u) : null);
-  }, P = (u, y) => {
-    u.preventDefault(), w(y), ue(L(y)), k(y);
+  }, $ = (u, y) => {
+    u.preventDefault(), w(y), ue(A(y)), k(y);
   }, G = (u, y) => {
-    u.preventDefault(), w(y), ue(L(y)), k(y);
+    u.preventDefault(), w(y), ue(A(y)), k(y);
   }, U = q(
     () => tt({
       navigate: i,
@@ -1659,13 +1662,13 @@ function yt({
                 "a",
                 {
                   href: "#" + u.id,
-                  onClick: (R) => P(R, u.id),
+                  onClick: (R) => $(R, u.id),
                   style: {
                     display: "block",
                     padding: "6px 10px",
-                    borderLeft: `3px solid ${y ? M.token.colorPrimary : "transparent"}`,
+                    borderLeft: `3px solid ${y ? H.token.colorPrimary : "transparent"}`,
                     background: y ? T.primarySoft : "transparent",
-                    color: y ? M.token.colorPrimary : "#475569",
+                    color: y ? H.token.colorPrimary : "#475569",
                     fontWeight: y ? 600 : 400,
                     fontSize: 13,
                     lineHeight: 1.5,
@@ -1723,15 +1726,15 @@ export {
   mt as e,
   ct as f,
   bt as g,
-  M as h,
+  H as h,
   T as i,
   Me as j,
   de as k,
   at as l,
-  N as m,
+  P as m,
   x as n,
   E as p,
   C as r,
-  B as s,
+  D as s,
   He as u
 };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { C as be, a as we, D as Ie, b as ke, E as Ce, c as Re, F as ve, G as Le, L as ze, d as Me, P as Be, e as Oe, R as Te, S as je, f as Ee, g as $e, T as De, h as Ke, i as Fe, j as Pe, k as qe, l as He, n as Ne, p as We, r as Ge, s as Je, m as _e, u as Ae } from "./ComponentDoc-CJL2TB6b.js";
+import { C as be, a as we, D as Ie, b as ke, E as Ce, c as Re, F as ve, G as Le, L as ze, d as Me, P as Be, e as Oe, R as Te, S as je, f as Ee, g as $e, T as De, h as Ke, i as Fe, j as Pe, k as qe, l as He, n as Ne, p as We, r as Ge, s as Je, m as _e, u as Ae } from "./ComponentDoc-22ujWxLE.js";
 import { jsxs as h, jsx as r } from "react/jsx-runtime";
 import { Layout as I, Spin as j, Menu as E, Dropdown as $, Avatar as D, Button as k, Tooltip as K, Card as F, Alert as P, Form as x, Input as L, message as S, Tag as q, Result as H } from "antd";
 import { MenuUnfoldOutlined as N, MenuFoldOutlined as W, DownOutlined as G, LoginOutlined as J, UserOutlined as _, LockOutlined as A } from "@ant-design/icons";

package/dist/ui.js

@@ -1,4 +1,4 @@
-import { C as e, a as t, D as r, b as o, E as n, c as d, F as i, G as l, L as S, d as u, P as T, e as p, R as b, S as f, f as g, g as c, T as h, h as m, i as C, j as D, k as L, l as E, n as F, p as P, r as A, s as B, m as G, u as I } from "./ComponentDoc-CJL2TB6b.js";
+import { C as e, a as t, D as r, b as o, E as n, c as d, F as i, G as l, L as S, d as u, P as T, e as p, R as b, S as f, f as g, g as c, T as h, h as m, i as C, j as D, k as L, l as E, n as F, p as P, r as A, s as B, m as G, u as I } from "./ComponentDoc-22ujWxLE.js";
 export {
   e as CategoryDot,
   t as ComponentDoc,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuku123/z-frontend-common",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "z-opc 全仓共享前端基座 — AppLayout(§1/§11/§12/§15/§16) + LoginPage(mockAuth 双模式) + EmptyState/StatusTag/ErrorBoundary + createRequest 工厂。lead 008 前端开发规范唯一承载仓",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/ui/ListTable.jsx

@@ -21,6 +21,8 @@ import useListFilter from './useListFilter'
  *
  * 透传约定：
  *   - `cardProps` → 传给外层 `<Card>`（如 `style` / `size` / `title`）
+ *   - `cardExtra` → 传给外层 `<Card>` 的 `extra`（动作按钮）。若同时给了 `searchKeys`，
+ *     过滤框与 extra **并排**渲染，不会二选一吞掉另一个。
  *   - `tableProps` → 传给内层 `<Table>`（如 `scroll` / `columns` 之外的表级属性）
  *   - 其余 props → 直接给 `<Table>`（与 antd 一致）
  *   - `pagination={false}` 仍然允许显式传（用于「数据已知 ≤10 行且不变」的豁免场景，
@@ -67,8 +69,19 @@ export default function ListTable({
         )
         : null
 
+    // Card 的 extra 可以同时挂「过滤框」和「动作按钮」（例如「关系」表既有搜索又有「新增」）。
+    // 二选一会把其中一个静默吞掉，所以这里两个都有就并排渲染。
+    const extra = (search && cardExtra)
+        ? (
+            <span style={{display: 'inline-flex', alignItems: 'center', gap: 8}}>
+                {search}
+                {cardExtra}
+            </span>
+        )
+        : (search || cardExtra)
+
     return (
-        <Card title={cardTitle} extra={search || cardExtra} {...cardProps}>
+        <Card title={cardTitle} extra={extra} {...cardProps}>
             <Table
                 rowKey={rowKey}
                 columns={columns}