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

package/es/Anchor/anchorMenu/index.js

@@ -1,54 +1,57 @@
 import { j as e } from "../../_virtual/jsx-runtime.js";
-import { useEffect as k, useMemo as p, createElement as A } from "react";
+import { useEffect as k, useMemo as u, createElement as A } from "react";
 import C from "clsx";
 import { Down as E } from "../../node_modules/@para-ui/icons/Down/index.js";
 import './index.css';/* empty css           */
 import w from "../../AutoTips/index.js";
-const P = (a) => {
+const y = (l) => {
   const {
-    data: c,
-    currentAnchorId: u,
-    handleClick: l,
-    level: o = 0,
-    isTree: m = !1,
-    anchorMap: i = {},
-    setAnchorMap: j,
-    customPrefixIcon: r,
-    onlyOneLevel: v
-  } = a, { id: d } = c, f = String(d) === String(u);
+    data: s,
+    currentAnchorId: j,
+    handleClick: m,
+    level: r = 0,
+    isTree: x = !1,
+    anchorMap: c = {},
+    setAnchorMap: v,
+    customPrefixIcon: i,
+    onlyOneLevel: f
+  } = l, { id: d } = s, a = String(d) === String(j);
   k(() => {
   }, []);
-  const N = p(() => {
+  const N = u(() => {
     const n = [];
-    for (let s = 0; s < o; s++)
+    for (let t = 0; t < r; t++)
       n.push(
         /* @__PURE__ */ e.jsx(
           "div",
           {
             className: "indent"
           },
-          s
+          t
         )
       );
     return n;
-  }, [o]), x = (n, s) => {
+  }, [r]), h = (n, t) => {
     n.stopPropagation();
-    const t = i[s];
-    t.expanded = !t.expanded, j?.({ ...i });
-  }, M = p(() => {
-    const { name: n, id: s } = c, t = c.children && c.children.length > 0, g = m ? t ? /* @__PURE__ */ e.jsx(
+    const o = c[t];
+    o.expanded = !o.expanded, v?.({ ...c });
+  }, M = u(() => {
+    const { name: n, id: t } = s, o = s.children && s.children.length > 0, g = x ? o ? /* @__PURE__ */ e.jsx(
       "div",
       {
         className: "btn-down",
-        onClick: (h) => x(h, s),
+        onClick: (p) => h(p, t),
         children: /* @__PURE__ */ e.jsx("div", { className: "icon icon-down", children: /* @__PURE__ */ e.jsx(E, {}) })
       }
-    ) : /* @__PURE__ */ e.jsx("div", { className: "icon mr-6" }) : r || /* @__PURE__ */ e.jsx(y, {});
+    ) : /* @__PURE__ */ e.jsx("div", { className: "icon mr-6" }) : i ? (
+      // R6 §6 类型放宽:函数形式按 isActive 返回不同 ReactNode(墨水点指示器等激活态联动);静态 ReactNode 直接渲染
+      typeof i == "function" ? i(s, a) : i
+    ) : /* @__PURE__ */ e.jsx(P, {});
     return /* @__PURE__ */ e.jsxs(
       "div",
       {
         className: "item-content",
-        onClick: (h) => {
+        onClick: (p) => {
         },
         children: [
           g,
@@ -56,21 +59,21 @@ const P = (a) => {
             "div",
             {
               className: "title",
-              onClick: () => l?.(s),
+              onClick: () => m?.(t),
               children: /* @__PURE__ */ e.jsx(w, { children: n || "" })
             }
           )
         ]
       }
     );
-  }, [c, i, x, l, r, m]);
+  }, [s, c, h, m, i, x, a]);
   return /* @__PURE__ */ e.jsxs(e.Fragment, { children: [
     /* @__PURE__ */ e.jsxs(
       "div",
       {
         className: C("anchor-menu-item", {
-          active: f,
-          expanded: i?.[d]?.expanded
+          active: a,
+          expanded: c?.[d]?.expanded
         }),
         children: [
           N,
@@ -78,18 +81,18 @@ const P = (a) => {
         ]
       }
     ),
-    c.children && i?.[d]?.expanded && !v && c.children.map((n) => /* @__PURE__ */ A(
-      P,
+    s.children && c?.[d]?.expanded && !f && s.children.map((n) => /* @__PURE__ */ A(
+      y,
       {
-        ...a,
+        ...l,
         data: n,
         key: n?.id,
-        level: o + 1
+        level: r + 1
       }
     ))
   ] });
-}, y = () => /* @__PURE__ */ e.jsx("div", { className: "icon mr-6", children: /* @__PURE__ */ e.jsx("div", { className: "icon-point" }) });
+}, P = () => /* @__PURE__ */ e.jsx("div", { className: "icon mr-6", children: /* @__PURE__ */ e.jsx("div", { className: "icon-point" }) });
 export {
-  P as default
+  y as default
 };
 //# sourceMappingURL=index.js.map

package/es/Anchor/component.json

@@ -0,0 +1,130 @@
+{
+    "name": "Anchor",
+    "category": "Navigation",
+    "description": "页面内锚点导航——自动生成目录侧栏并监听内容区滚动高亮目录项，点击目录项内置滚动定位行为。高度约束写在 Anchor 直接父 div 上，无限高度时内部不产生滚动。",
+    "semantic": {
+        "intent": [
+            "快速定位",
+            "内容索引"
+        ],
+        "useCases": [
+            "长文档",
+            "API 文档",
+            "单页应用"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "default": {
+            "meaning": "标准锚点"
+        }
+    },
+    "states": [
+        "active",
+        "default"
+    ],
+    "idealProps": {
+        "children": {
+            "type": "ReactNode",
+            "description": "内容区，放置带 `id` 属性的各章节 div；Anchor 通过监听滚动位置高亮左侧目录。⚠️ children 是必需的，缺少会导致锚点无法定位",
+            "required": true
+        },
+        "list": {
+            "type": "AnchorItem[]",
+            "typeDefinition": "interface AnchorItem { name: string; id: string; children?: AnchorItem[]; expanded?: boolean }",
+            "description": "目录数据源。**AnchorItem 字段一览（仅 name + id 必填）**：① name: string — 侧栏显示文案；② id: string — 对应 children 内章节 `<div id={item.id}>` 的 DOM id（Anchor 内部用 id 定位高亮，大小写必须精确一致；建议仅用字母/数字/-/_，避免 CSS 选择器特殊字符；若业务数据字段是 href='#intro'，映射时去掉 # 前缀：`id: s.href.replace(/^#/, '')`）；③ children?: AnchorItem[] — 多级嵌套（自动渲染为缩进树，建议 ≤3 级；递归时复用同一映射函数）；④ expanded?: boolean — 该项初始展开态（default false；⚠️ 与 allExpanded prop 完全独立：allExpanded 控制顶部「全部展开」按钮可见性，不等于初始全展开；初始全展开需对每个含 children 的 AnchorItem 设 expanded:true）。完整 TS 定义：interface AnchorItem { name: string; id: string; children?: AnchorItem[]; expanded?: boolean }（parentId 是 Anchor 内部字段，业务传 list 时无需提供）。"
+        },
+        "scrollId": {
+            "type": "string",
+            "default": "\"paraui-v4-anchor-scroll-id\"",
+            "description": "**Anchor 内部自动创建的滚动容器 DOM id**——业务方只需传一个全局唯一字符串，Anchor 会在渲染时自动创建 `<div id={scrollId}>` 并把 children 放入其中；**不需要在 children 外部或内部手动创建该 div**。Anchor 对此 div 监听 scroll 事件 + 用 `[id]` 选择器定位高亮目录项。单页只有一个 Anchor 时可省略（默认 'paraui-v4-anchor-scroll-id'）；同页多个 Anchor 实例必须各自传不同的 scrollId 以隔离滚动监听。scrollId 查找：Anchor 内部用 `document.getElementById(scrollId)` 获取滚动容器——正常渲染后此 div 必然存在，无需业务方手动创建。"
+        },
+        "title": {
+            "type": "ReactNode",
+            "description": "目录标题；只有传 title 才显示折叠按钮 / 全部展开按钮 / search 搜索框。**(R6 §6 类型放宽:从 string → ReactNode)**——支持嵌入徽标 / 计数 / 动态状态文本(如 `<span>目录<Tag>当前: intro</Tag></span>`)。string 是 ReactNode 子集,完全向后兼容旧 string 用法。详见 BREAKING-CHANGES §维护规则边界(类型 widening 不入档)+ discussions/Anchor-title-reactnode.md"
+        },
+        "placement": {
+            "type": "'left' | 'right'",
+            "values": ["left", "right"],
+            "default": "'right'",
+            "description": "目录位于内容的左侧还是右侧。⚠️ 默认 'right'（目录在右侧）；要实现左侧目录须显式传 placement='left'"
+        },
+        "search": {
+            "type": "boolean",
+            "default": false,
+            "description": "目录是否带搜索框（按 name 模糊匹配）。需配合 title 使用。"
+        },
+        "allExpanded": {
+            "type": "boolean",
+            "default": true,
+            "description": "顶部『全部展开』按钮是否启用（控制按钮可见性，不影响 `list[].expanded` 的初始值）。仅在 list 含 children 且传了 title 时生效。\n\n**⚠️ 命名歧义警告（R15+R16 双轮再现 · 3/6 sub-agent 混淆）**：allExpanded 命名容易被理解为「初始全展开」（类似 defaultExpandAll），但实际含义是「全部展开」**按钮**的可见性控制开关：\n- `allExpanded=true`（默认）→ 顶部出现「全部展开」按钮，用户**点击按钮后**才展开全部目录项\n- `allExpanded=false` → 隐藏「全部展开」按钮\n- **若要初始全展开（组件挂载即全展开）**：对 list[] 中每个含 children 的 AnchorItem 设置 `expanded: true`，与 allExpanded prop 无关\n\n**R17 路线图**：正在评审 src rename `allExpanded → expandedAll`（BREAKING，更准确地表达「控制展开按钮」含义），详见 `discussions/Anchor-allExpanded-naming-epic.md`；R17 拍板前 allExpanded 继续有效，0 BREAKING。"
+        },
+        "listWidth": {
+            "type": "number",
+            "description": "目录列表宽度（px）；不传时默认 140px。"
+        },
+        "customPrefixIcon": {
+            "type": "ReactNode | ((item: AnchorItem, isActive: boolean) => ReactNode)",
+            "description": "自定义目录每项的前缀图标。**(R6 §6 类型放宽:从 ReactNode → ReactNode | function)**:<br>- **静态 ReactNode** — 所有目录项共用同一前缀图标(原行为,完全向后兼容)<br>- **函数形式 `(item, isActive) => ReactNode`** — 按当前激活态返回不同 ReactNode(墨水点指示器 / 激活态指示符 / 复选框联动等);函数版每次激活变化触发 list 重渲染,内部 AnchorListMemo 已优化。<br>**初始激活态说明**：页面 mount 时 Anchor 不主动激活任何目录项——需要用户滚动（或点击）触发第一次 scroll 事件后才会激活；初始激活项由滚动位置决定（内部算法：找第一个 offsetTop >= scrollTop 的 [id] 元素）。若需要初始激活特定项，可在 mount 后手动调用 `document.getElementById(SCROLL_ID)?.dispatchEvent(new Event('scroll'))` 触发一次。<br>**业务方仍可走激活态 CSS 联动**(向后兼容):Anchor 内部对激活目录项加 className `.anchor-menu-item.active`(无 prefixCls 前缀,见 src/Anchor/anchorMenu/index.scss:14);可在外层 style 选择器 `:global(.anchor-menu-item.active) [data-ink-dot] { visibility: visible }` 联动。但函数形式更直接、类型安全。详见 discussions/Anchor-customPrefixIcon-function.md(R6 实施选项 B 类型 widening)"
+        }
+    },
+    "do": [
+        "在长页面（如文档）右侧提供 Anchor",
+        "Anchor 标题应简洁",
+        "把章节 DOM 作为 children 直接传入：`<Anchor list={list} scrollId='xxx'>{sections.map(s => <div id={s.id}>...</div>)}</Anchor>`",
+        "list[].id 必须与 children 中对应章节 div 的 id 完全一致（含大小写）；建议仅使用 CSS selector 安全字符",
+        "业务侧 `{ href, title }` 数据派生 list 时使用 `sections.map(s => ({ name: s.title, id: s.href.replace(/^#/, '') }))` 映射；多级数据写递归映射函数（参见 docs/view/anchor/codeString.ts hrefMappingDemo / nestedMappingDemo）",
+        "Anchor 内部滚动容器需要由父级提供有限高度（如 `style={{ height: 400 }}` 或外层 wrapper 设 `height: 100vh`）才能产生滚动；外层高度无限时内容不会滚动，stickyDemo 也无法体现『内容滚动而目录吸顶』效果",
+        "需要把激活 id 还原成业务 href 时：用 useEffect 监听 activeId 变化 + 业务侧维护 id->href 反向 map（参见 codeString.ts notifyParentDemo）",
+        "需要『吸顶 / 滚动偏移头部 / 激活回调』时：用外层 div 包 `position: sticky; top: 0` 实现吸顶（**前置条件：外层必须有滚动祖先——body 高度 > 视口、或某 wrapper 设了 `overflow:auto/scroll`；⚠️ `overflow:auto/scroll` 是合法滚动祖先，不会导致 sticky 失效——仅 `overflow:hidden` 的祖先会使 sticky 退化为 relative；flex 容器中配合 `alignSelf: flex-start` 避免 stretch 拉满高度**；缺少任一条件则 sticky 退化为 relative）；用 `<section style={{ scrollMarginTop: headerOffset }}>` **写在每个章节元素自身** 实现偏移；用容器自定义 `addEventListener('scroll', ...)` 计算激活章节并 onChange 通知父组件——这些不是 Anchor 内置能力"
+    ],
+    "dont": [
+        "Anchor 嵌套层级过深 (>3级) —— 设计/视觉建议；src 实现层 formatList 递归无硬限制，违反仅触发缩进过深视觉异常",
+        "内容过少的页面使用 Anchor",
+        "不要传 `targetOffset` / `affix` / `showInkInFixed` / `onChange` / `items` / `onClick` 等 prop——这些 prop 在 AnchorProps 中不存在，传入会被 React 忽略且能力不会生效",
+        "不要在 children 内再包一层 `<div id={scrollId}>` 自管理滚动——Anchor 已内部包了 `<div id={scrollId}>`",
+        "不要把 `scrollPaddingTop` 写在 children 内的 wrapper 上——`scrollPaddingTop` 仅对滚动容器生效（即 Anchor 内部 `<div id={scrollId}>`，外部无法直接访问）；偏移请用 `scrollMarginTop` 写在**每个章节元素自身**上"
+    ],
+    "events": {
+        "onClickItem (via AnchorMenu internal)": {
+            "signature": "内部点击目录项时调用 handleClick(id: string)，无外部事件 prop",
+            "asyncSupported": false,
+            "examples": [
+                "点击目录项时 Anchor 内部调用 scrollTo 滚动到对应章节，无需业务方处理",
+                "需要监听激活变化时，用外层 wrapper 的 addEventListener('scroll', ...) 计算当前 id",
+                "需要把 activeId 回传父组件：用 useEffect 监听 scrollId 容器的 scroll 事件 + 业务侧 id→href 反向 map"
+            ],
+            "commonMistakes": [
+                "传 onChange prop 期望激活目录项变化时被回调——Anchor 不存在 onChange prop",
+                "传 onClick prop 期望拦截目录项点击——AnchorProps 无此 prop，传入会被 React 忽略",
+                "期望 customPrefixIcon 在点击瞬间触发回调——它只是渲染函数，激活态变化驱动重渲染"
+            ]
+        }
+    },
+    "typescriptPitfalls": [
+        {
+            "issue": "AnchorItem 无法从 @para-ui/core/Anchor 直接命名导出——Anchor/index.tsx 只有默认导出，AnchorItem 定义在 Anchor/type.ts",
+            "wrong": "import type { AnchorItem } from '@para-ui/core/Anchor';  // TS2614: 无此命名导出",
+            "right": "import type { AnchorItem } from '@para-ui/core/Anchor/type';  // 从 type.ts 子路径导入"
+        },
+        {
+            "issue": "AnchorItem 的 id 必须与 children 内章节 div 的 DOM id 完全一致（大小写敏感）",
+            "wrong": "// list: [{ name: '介绍', id: 'Introduction' }]\n// children: <div id='introduction'>  // 大小写不同，无法高亮",
+            "right": "// 保持一致且使用 CSS selector 安全字符\n// list: [{ name: '介绍', id: 'introduction' }]\n// children: <div id='introduction'>..."
+        },
+        {
+            "issue": "title prop 从 string 扩宽到 ReactNode，但 allExpanded 是控制按钮可见性，不是初始全展开",
+            "wrong": "// 以为 allExpanded=true 会初始展开所有目录项\n<Anchor allExpanded={true} list={tree} />  // 实际只是显示'全部展开'按钮",
+            "right": "// 初始全展开需要对每个含 children 的 AnchorItem 设 expanded: true\nconst tree = data.map(item => ({ ...item, expanded: true, children: item.children?.map(c => ({ ...c, expanded: true })) }))"
+        },
+        {
+            "issue": "customPrefixIcon 函数形式的参数类型必须显式标注，避免 noImplicitAny 报错",
+            "wrong": "// 内联函数不标注类型\n<Anchor customPrefixIcon={(item, isActive) => <span />} />  // TS7006: item 隐式 any",
+            "right": "import type { AnchorItem } from '@para-ui/core/Anchor';\n<Anchor customPrefixIcon={(item: AnchorItem, isActive: boolean) => <span style={{ color: isActive ? 'blue' : 'gray' }}>•</span>} />"
+        }
+    ],
+    "mapping": {
+        "realComponent": "Anchor",
+        "adapter": null
+    }
+}

package/es/Anchor/index.js

@@ -1,59 +1,62 @@
 import { j as r } from "../_virtual/jsx-runtime.js";
-import { useState as f, useRef as X, useEffect as q, useMemo as E } from "react";
+import { useState as f, useRef as Y, useEffect as D, useMemo as E } from "react";
 import L from "clsx";
 import { $prefixCls as C } from "../GlobalContext/constant.js";
-import Y from "./anchorMenu/index.js";
-import { ToRight as D } from "../node_modules/@para-ui/icons/ToRight/index.js";
-import { ToLeft as W } from "../node_modules/@para-ui/icons/ToLeft/index.js";
-import { PreviewOpen as Z } from "../node_modules/@para-ui/icons/PreviewOpen/index.js";
-import { Search as _ } from "../Search/index.js";
-import ee from "../GlobalContext/useFormatMessage.js";
-import re from "./lang/index.js";
-import { Throttle as ne, Debounce as se } from "@snack-kit/lib";
+import Z from "./anchorMenu/index.js";
+import { ToRight as W } from "../node_modules/@para-ui/icons/ToRight/index.js";
+import { ToLeft as z } from "../node_modules/@para-ui/icons/ToLeft/index.js";
+import { PreviewOpen as _ } from "../node_modules/@para-ui/icons/PreviewOpen/index.js";
+import { Search as ee } from "../Search/index.js";
+import re from "../GlobalContext/useFormatMessage.js";
+import ne from "./lang/index.js";
+import { Throttle as se, Debounce as oe } from "@snack-kit/lib";
 import './index.css';/* empty css           */
-const ge = (N) => {
+const Te = (N) => {
   const {
-    style: z,
-    className: J,
+    style: J,
+    className: G,
     title: T = "",
     scrollId: j = `${C}-anchor-scroll-id`,
     list: d = [],
     listClassName: M,
-    scrollClassName: G,
+    scrollClassName: H,
     placement: a = "right",
-    allExpanded: H = !0,
-    search: K = !1,
+    allExpanded: K = !0,
+    search: Q = !1,
     customPrefixIcon: S,
     listWidth: m
-  } = N, Q = ee("Anchor", re), [V, O] = f(""), [x, U] = f(!1), [u, A] = f({}), [v, R] = f(!1), [$, k] = f(""), [p, y] = f(null), o = X({
+  } = N, U = re("Anchor", ne), [V, O] = f(""), [x, X] = f(!1), [u, A] = f({}), [v, R] = f(!1), [$, k] = f(""), [p, y] = f(null), o = Y({
     currentAnchorId: "",
     anchorList: d,
     anchorMap: {},
     searchValue: "",
     scrolling: !1
   }), w = v ? "50px" : m ? `${m + 20}px` : "160px";
-  q(() => {
+  D(() => {
     o.current.anchorList = d;
     const e = {};
     let n = !1;
-    const t = (h, l = "") => {
+    const t = (h, c = "") => {
       h.forEach((s) => {
-        (s?.expanded === void 0 || s?.expanded === null) && (s.expanded = !1), l && (s.parentId = l), e[s.id] = s, s.children && (n = !0, t(s.children, s.id));
+        (s?.expanded === void 0 || s?.expanded === null) && (s.expanded = !1), c && (s.parentId = c), e[s.id] = s, s.children && (n = !0, t(s.children, s.id));
       });
     };
-    t(d), U(n), o.current.anchorMap = e, A(e);
-  }, [d]), q(() => {
-    const e = document.getElementById(j), n = ne(async () => {
+    t(d), X(n), o.current.anchorMap = e, A(e);
+  }, [d]), D(() => {
+    const e = document.getElementById(j), n = se(async () => {
       if (o.current.scrolling) return;
-      const t = e?.querySelectorAll("[id]") || [], l = Array.from(t).map((c) => ({
-        id: c.id,
-        offsetTop: c.offsetTop - (e?.offsetTop || 0)
-      }));
+      const t = e?.querySelectorAll("[id]") || [], c = Array.from(t).map((l) => {
+        const q = l;
+        return {
+          id: q.id,
+          offsetTop: q.offsetTop - (e?.offsetTop || 0)
+        };
+      });
       let s = 0, i = "";
-      const I = l.find((c) => (s < c.offsetTop && (s = c.offsetTop, i = c.id), c.offsetTop >= (e?.scrollTop || 0)));
+      const I = c.find((l) => (s < l.offsetTop && (s = l.offsetTop, i = l.id), l.offsetTop >= (e?.scrollTop || 0)));
       if (I?.id !== o.current.currentAnchorId) {
-        let c = I?.id || "";
-        e?.scrollTop && !I?.id && (c = i), O(c);
+        let l = I?.id || "";
+        e?.scrollTop && !I?.id && (l = i), O(l);
       }
     }, 300);
     return n(), e?.addEventListener("scroll", n, { passive: !0 }), () => {
@@ -61,11 +64,11 @@ const ge = (N) => {
     };
   }, []);
   const b = (e) => {
-    const n = document.getElementById(j), t = n?.querySelectorAll("[id]") || [], h = Array.from(t).findIndex((s) => String(s.id) === String(e)), l = t[h];
-    l && (O(e), o.current.currentAnchorId = e, o.current.scrolling = !0, setTimeout(() => {
+    const n = document.getElementById(j), t = n?.querySelectorAll("[id]") || [], h = Array.from(t).findIndex((s) => String(s.id) === String(e)), c = t[h];
+    c && (O(e), o.current.currentAnchorId = e, o.current.scrolling = !0, setTimeout(() => {
       o.current.scrolling = !1;
     }, 1e3), n?.scrollTo({
-      top: l?.offsetTop || 0 - (n?.offsetTop || 0),
+      top: c?.offsetTop || 0 - (n?.offsetTop || 0),
       behavior: "smooth"
     }));
   }, B = () => {
@@ -73,14 +76,14 @@ const ge = (N) => {
       u[e].expanded = !0;
     }), A({ ...u });
   }, g = E(
-    () => se(async () => {
+    () => oe(async () => {
       const e = o.current.searchValue;
       if (!e) {
         y(null);
         return;
       }
-      const n = o.current.anchorList || [], t = [], h = (l, s = "") => {
-        l.forEach((i) => {
+      const n = o.current.anchorList || [], t = [], h = (c, s = "") => {
+        c.forEach((i) => {
           i?.name?.indexOf(e) > -1 && t.push(i), i.children && h(i.children, i.id);
         });
       };
@@ -91,15 +94,15 @@ const ge = (N) => {
     /* @__PURE__ */ r.jsxs("div", { className: "anchor-menu-title", children: [
       /* @__PURE__ */ r.jsx("div", { className: "title", children: T }),
       /* @__PURE__ */ r.jsxs("div", { className: "opera-area", children: [
-        x && H && /* @__PURE__ */ r.jsxs(r.Fragment, { children: [
-          /* @__PURE__ */ r.jsx(Z, { onClick: B }),
+        x && K && /* @__PURE__ */ r.jsxs(r.Fragment, { children: [
+          /* @__PURE__ */ r.jsx(_, { onClick: B }),
           /* @__PURE__ */ r.jsx("div", { className: "split-line" })
         ] }),
-        /* @__PURE__ */ r.jsx("div", { onClick: () => R(!0), children: a === "left" ? /* @__PURE__ */ r.jsx(W, {}) : /* @__PURE__ */ r.jsx(D, {}) })
+        /* @__PURE__ */ r.jsx("div", { onClick: () => R(!0), children: a === "left" ? /* @__PURE__ */ r.jsx(z, {}) : /* @__PURE__ */ r.jsx(W, {}) })
       ] })
     ] }),
-    K && /* @__PURE__ */ r.jsx(
-      _,
+    Q && /* @__PURE__ */ r.jsx(
+      ee,
       {
         size: "small",
         value: $,
@@ -111,7 +114,7 @@ const ge = (N) => {
         onClear: () => {
           k(""), o.current.searchValue = "", y(null);
         },
-        placeholder: Q("pleaseEnter"),
+        placeholder: U("pleaseEnter"),
         style: { padding: "0 4px", marginBottom: "6px" }
       }
     )
@@ -123,7 +126,7 @@ const ge = (N) => {
         {
           className: "collapse-icon-area",
           onClick: () => R(!1),
-          children: a === "left" ? /* @__PURE__ */ r.jsx(D, {}) : /* @__PURE__ */ r.jsx(W, {})
+          children: a === "left" ? /* @__PURE__ */ r.jsx(W, {}) : /* @__PURE__ */ r.jsx(z, {})
         }
       );
     const e = p || d;
@@ -137,7 +140,7 @@ const ge = (N) => {
         children: [
           F,
           e.map((n, t) => /* @__PURE__ */ r.jsx(
-            Y,
+            Z,
             {
               data: n,
               currentAnchorId: V,
@@ -168,17 +171,17 @@ const ge = (N) => {
   return /* @__PURE__ */ r.jsxs(
     "div",
     {
-      className: L(`${C}-anchor`, J, {
+      className: L(`${C}-anchor`, G, {
         [`${C}-anchor-${a}`]: a
       }),
-      style: z,
+      style: J,
       children: [
         a === "left" && P,
         /* @__PURE__ */ r.jsx(
           "div",
           {
             id: j,
-            className: L("anchor-scroll", G),
+            className: L("anchor-scroll", H),
             style: {
               paddingLeft: a === "left" ? w : "0",
               paddingRight: a === "right" ? w : "0"
@@ -192,6 +195,6 @@ const ge = (N) => {
   );
 };
 export {
-  ge as default
+  Te as default
 };
 //# sourceMappingURL=index.js.map

package/es/Anchor/type.d.ts

@@ -18,8 +18,8 @@ export interface AnchorProps {
     style?: React.CSSProperties;
     /** 类名 */
     className?: string;
-    /** 标题 */
-    title?: string;
+    /** 标题(R6 §6 类型放宽:string → ReactNode,支持嵌入徽标/计数/动态状态文本;string 是 ReactNode 子集,完全向后兼容) */
+    title?: ReactNode;
     /** 滚动盒子Id */
     scrollId?: string;
     /** 子元素 */
@@ -31,8 +31,12 @@ export interface AnchorProps {
     /** 位置 */
     placement?: 'left' | 'right';
     /** 默认展示的锚点 */
-    /** 自定义前缀符号 */
-    customPrefixIcon?: ReactNode;
+    /**
+     * 自定义前缀符号(R6 §6 类型放宽):
+     * - 静态 ReactNode — 所有目录项共用同一前缀图标(原行为)
+     * - 函数形式 `(item, isActive) => ReactNode` — 按当前激活态返回不同 ReactNode(墨水点指示器等激活态联动场景);函数版本每次激活变化触发 list 重渲染,内部 AnchorListMemo 已优化
+     */
+    customPrefixIcon?: ReactNode | ((item: AnchorItem, isActive: boolean) => ReactNode);
     /** 全部展开功能是否开启 */
     allExpanded?: boolean;
     /** 是否带目录搜索 */