@para-ui/core 5.0.0-beta.8 → 5.0.0

package/es/locale/zh_CN.js

@@ -0,0 +1,364 @@
+const e = {
+  Anchor: {
+    pleaseEnter: "请输入"
+  },
+  Argv: {
+    environmentVariable: "环境变量",
+    pleaseEnterKey: "请输入key",
+    pleaseEnterValue: "请输入value",
+    add: "新增",
+    batchEdit: "批量编辑",
+    ok: "确定",
+    formatErrorJson: "格式有误，请输入正确的JSON",
+    formatErrorArrayJson: "格式有误，请输入正确的JSON数组",
+    pleaseEnter: "请输入",
+    pleaseSelect: "请选择",
+    formatError: "格式错误",
+    required: "必填项，不能为空"
+  },
+  AutoButton: {
+    more: "更多"
+  },
+  Breadcrumbs: {
+    back: "返回"
+  },
+  Button: {
+    moreActions: "更多操作"
+  },
+  Card: {
+    more: "鼠标滚动，加载更多数据",
+    loadingMore: "数据正在加载中…"
+  },
+  Cascader: {
+    placeholder: "请选择",
+    disableTilte: "禁用"
+  },
+  CodeEditor: {
+    format: "格式化",
+    pleaseEnter: "请输入",
+    codeSnippet: "代码片段",
+    help: "帮助"
+  },
+  ComboSelect: {
+    searchPlaceholder: "请输入",
+    cancel: "取消",
+    ok: "确定",
+    fullPath: "完整路径",
+    pleaseSelect: "请选择",
+    selected: "已选中",
+    searching: "搜索中",
+    more: "更多"
+  },
+  CycleSelector: {
+    placeholder: "请输入",
+    pleaseSelect: "请选择",
+    week1: "星期一",
+    week2: "星期二",
+    week3: "星期三",
+    week4: "星期四",
+    week5: "星期五",
+    week6: "星期六",
+    week7: "星期日",
+    every: "每",
+    day: "天",
+    week: "周",
+    month: "月",
+    year: "年",
+    one: "一",
+    two: "二",
+    three: "三",
+    four: "四",
+    five: "五",
+    six: "六",
+    seven: "日",
+    day1: "第一天",
+    day2: "第二天",
+    day3: "第三天",
+    day4: "第四天",
+    day5: "第五天",
+    day6: "第六天",
+    day7: "第七天",
+    day8: "第八天",
+    day9: "第九天",
+    day10: "第十天",
+    day11: "第十一天",
+    day12: "第十二天",
+    day13: "第十三天",
+    day14: "第十四天",
+    day15: "第十五天",
+    day16: "第十六天",
+    day17: "第十七天",
+    day18: "第十八天",
+    day19: "第十九天",
+    day20: "第二十天",
+    day21: "第二十一天",
+    day22: "第二十二天",
+    day23: "第二十三天",
+    day24: "第二十四天",
+    day25: "第二十五天",
+    day26: "第二十六天",
+    day27: "第二十七天",
+    day28: "第二十八天",
+    day29: "第二十九天",
+    day30: "第三十天",
+    day31: "第三十一天",
+    the1: "第一个",
+    the2: "第二个",
+    the3: "第三个",
+    the4: "第四个",
+    the5: "第五个",
+    infiniteRepetition: "无限重复",
+    deadline: "截止时间",
+    limitNum: "限定次数",
+    noRepetition: "不重复",
+    repeatEveryDay: "每天重复",
+    repeatEveryWeek: "每周重复",
+    repeatEveryMonth: "每月重复",
+    repeatEveryYear: "每年重复",
+    customRepetition: "自定义重复",
+    th: "号",
+    repetitionFrequency: "重复频率",
+    update: "更改",
+    text1: "{every}的{time}",
+    text2: "，检测{limitNum}次后终止重复",
+    text3: "，结束时间：{date}",
+    weekTip: "当前日程时间为{week}，无法取消勾选",
+    endRepetition: "结束重复",
+    customCycle: "自定义周期",
+    cancel: "取 消",
+    confirm: "确 定",
+    next: "次后",
+    monthDay: "`{month}月{day}日`"
+  },
+  DatePicker: {
+    lang: {
+      placeholder: "请选择日期",
+      yearPlaceholder: "请选择年份",
+      quarterPlaceholder: "请选择季度",
+      monthPlaceholder: "请选择月份",
+      weekPlaceholder: "请选择周",
+      rangePlaceholder: "[开始日期, 结束日期]",
+      rangeYearPlaceholder: "[开始年份, 结束年份]",
+      rangeMonthPlaceholder: "[开始月份, 结束月份]",
+      rangeWeekPlaceholder: "[开始周, 结束周]",
+      today: "选择今天",
+      now: "此刻",
+      ok: "确 定"
+    },
+    timePickerLocale: {},
+    placeholder: "请选择日期",
+    yearPlaceholder: "请选择年份",
+    quarterPlaceholder: "请选择季度",
+    monthPlaceholder: "请选择月份",
+    weekPlaceholder: "请选择周",
+    rangePlaceholder: "[开始日期, 结束日期]",
+    rangeYearPlaceholder: "[开始年份, 结束年份]",
+    rangeMonthPlaceholder: "[开始月份, 结束月份]",
+    rangeWeekPlaceholder: "[开始周, 结束周]",
+    today: "选择今天",
+    now: "此刻",
+    ok: "确 定"
+  },
+  Descriptions: {
+    expandAll: "全部展开",
+    retractAll: "全部收起"
+  },
+  Desktop: {
+    createDir: "新建文件夹",
+    save: "保 存",
+    outDir: "移出文件夹"
+  },
+  DragVerify: {
+    tryAgain: "再试一次",
+    swipe: "向右滑动填充拼图"
+  },
+  Drawer: {
+    cancel: "取 消",
+    ok: "确 定"
+  },
+  DynamicMultiBox: {
+    add: "添 加",
+    titleForm: "表单配置 (非必填项)",
+    default: "恢复默认",
+    noData: "暂无其他属性"
+  },
+  Empty: {
+    noData: "暂无内容",
+    click: "，点击",
+    refresh: "刷新"
+  },
+  FieldForm: {
+    default: "字段验证错误${label}",
+    required: "${label}不能为空",
+    enum: "${label}必须是其中一个[${enum}]",
+    whitespace: "${label}不能为空字符",
+    date: "typeTemplate",
+    types: {
+      string: "typeTemplate",
+      method: "typeTemplate",
+      array: "typeTemplate",
+      object: "typeTemplate",
+      number: "typeTemplate",
+      date: "typeTemplate",
+      boolean: "typeTemplate",
+      integer: "typeTemplate",
+      float: "typeTemplate",
+      regexp: "typeTemplate",
+      email: "typeTemplate",
+      url: "typeTemplate",
+      hex: "typeTemplate"
+    },
+    string: "typeTemplate",
+    number: "typeTemplate",
+    array: "typeTemplate",
+    pattern: {
+      mismatch: "${label}与模式不匹配${pattern}"
+    },
+    format: "${label}日期格式无效",
+    parse: "${label}不能转换为日期",
+    invalid: "${label}是一个无效日期",
+    method: "typeTemplate",
+    object: "typeTemplate",
+    boolean: "typeTemplate",
+    integer: "typeTemplate",
+    float: "typeTemplate",
+    regexp: "typeTemplate",
+    email: "typeTemplate",
+    url: "typeTemplate",
+    hex: "typeTemplate",
+    len: "须为${len}个${label}",
+    min: "最少${min}个${label}",
+    max: "最多${max}个${label}",
+    range: "${label}数量须在${min}-${max}之间",
+    mismatch: "${label}与模式不匹配${pattern}",
+    colon: "："
+  },
+  FormItem: {
+    choseFile: "选择文件",
+    unEmpty: "{label}不能为空",
+    maxLength: "最大长度不能超过{len}位",
+    minLength: "最小长度为{len}位",
+    unRule: "参数不符合校验规则{rule}",
+    minValue: "最小值为{val}",
+    maxValue: "最大值为{val}"
+  },
+  InputCode: {
+    retrievedAgain: "{second}秒后可重新获取",
+    reset: "重新发送",
+    getCode: "获取验证码",
+    secondCountdown: "{second}秒"
+  },
+  Modal: {
+    cancel: "取 消",
+    ok: "确 定"
+  },
+  MultiBox: {
+    add: "添 加"
+  },
+  OperateBtn: {
+    more: "更多"
+  },
+  Pagination: {
+    total: "共{total}条",
+    barPage: "条/页",
+    prevPage: "上一页",
+    nextPage: "下一页",
+    jumpTo: "前往",
+    page: "页"
+  },
+  PopConfirm: {
+    cancel: "取 消",
+    ok: "确 认"
+  },
+  Querying: {
+    querying: "数据查询中"
+  },
+  QuickReply: {
+    back: "返回",
+    add: "添加",
+    edit: "编辑",
+    sort: "排序",
+    del: "删除",
+    delTip: "删除后此回复将无法使用，确认要删除吗？",
+    batchDel: "批量删除",
+    quickReply: "快捷回复",
+    confirm: "确 认",
+    cancel: "取 消",
+    pleaseEnter: "请输入"
+  },
+  Select: {
+    searchPlaceholder: "请输入",
+    more: "更多"
+  },
+  Selector: {
+    root: "根",
+    selectAll: "全选",
+    seeMore: "查看更多",
+    selected: "已选",
+    pleaseEnter: "请输入",
+    searchResult: "搜索结果",
+    detail: "详情",
+    child: "下级"
+  },
+  SelectorPicker: {
+    selected: "已选中",
+    select: "请选择",
+    more: "更多"
+  },
+  SingleBox: {
+    add: "新增"
+  },
+  Switch: {
+    ing: "正在进行中"
+  },
+  Table: {
+    empty: "清空",
+    determine: "确定",
+    restoreDefault: "恢复默认",
+    serial: "序号",
+    loadMore: "加载更多",
+    refresh: "刷新",
+    selectNum: "已选{num}项",
+    selectAll: "全选",
+    dragSort: "拖动排序",
+    noHomePageEmpty: "当前页面无数据",
+    returnPrevPage: "返回上一页"
+  },
+  Tabs: {
+    confirmDelete: "确定删除吗？"
+  },
+  TextEditor: {
+    pleaseEnter: "请输入内容"
+  },
+  Transfer: {
+    left: "左侧",
+    right: "右侧",
+    allCheck: "全选",
+    inVertCheck: "反选",
+    searchPlaceholder: "请输入",
+    leftBtnTips: "请先勾选右侧内容",
+    rightBtnTips: "请先勾选左侧内容"
+  },
+  Tree: {
+    loadMore: "加载更多",
+    add: "新增",
+    edit: "编辑",
+    disabled: "禁用",
+    delete: "删除"
+  },
+  Upload: {
+    uploadError: "上传失败",
+    uploading: "正在上传",
+    clickUploadFile: "点击上传文件",
+    dragFileUpload: "下载模板并完善信息后，可直接将文件拖拽到此处进行上传\\n支持格式：XLS、XLSX",
+    add: "新增",
+    edit: "编辑",
+    disabled: "禁用",
+    delete: "删除",
+    editImage: "编辑图片"
+  }
+};
+export {
+  e as default
+};
+//# sourceMappingURL=zh_CN.js.map

package/es/node_modules/classnames/index.js

@@ -1,4 +1,4 @@
-import { __module as s } from "../../_virtual/index4.js";
+import { __module as s } from "../../_virtual/index2.js";
 var u;
 function c() {
   return u ? s.exports : (u = 1, (function(i) {

package/lib/AlignBox/component.json

@@ -0,0 +1,89 @@
+{
+    "name": "AlignBox",
+    "category": "Layout",
+    "description": "方向语义对齐容器：direction='horizontal'(默认)子元素水平排列+垂直居中；direction='vertical'子元素纵向堆叠+水平居中。根元素为 block 级 flex div，style/className 直接作用于该 flex 容器。",
+    "semantic": {
+        "intent": [
+            "方向对齐",
+            "水平排列容器",
+            "纵向堆叠容器"
+        ],
+        "useCases": [
+            "图标 + 文字 + 标签 一行内水平对齐(direction='horizontal')",
+            "字段纵向堆叠每行一个(direction='vertical')",
+            "卡片内简单的横向元素对齐"
+        ],
+        "riskLevel": "low"
+    },
+    "variants": {
+        "horizontal": {
+            "meaning": "**子元素水平排列 + 垂直居中** — `display:flex; align-items:center`;子元素按 row 排列,在交叉轴(垂直)居中。默认值。**主轴对齐默认 flex-start**(DEFECT-006):两端对齐 / 居中等需 className 或 style 追加 justify-content"
+        },
+        "vertical": {
+            "meaning": "**子元素纵向堆叠 + 水平居中** — `display:flex; flex-direction:column; align-items:center`;子元素从上到下堆叠,在交叉轴(水平)居中。**⚠️ DEFECT-007：子元素宽度 = 内容宽度**（align-items:center 收缩，非撑满容器）；修复方案：① 给子元素自身加 `width:100%`（推荐）：`<div style={{ width: '100%' }}>内容</div>`；② 或在 AlignBox 上加 `style={{ alignItems: 'stretch' }}` 覆盖。嵌套场景（vertical 包 horizontal）：内层 AlignBox 必须加 `style={{ width: '100%' }}` 才能撑满父容器"
+        }
+    },
+    "states": [
+        "default"
+    ],
+    "idealProps": {
+        "direction": {
+            "type": "enum",
+            "values": [
+                "horizontal",
+                "vertical"
+            ],
+            "default": "horizontal",
+            "description": "子元素排列方向(字面 = 行为):`horizontal` = 水平排列 + 垂直居中(`display:flex; align-items:center`；主轴对齐默认 flex-start，需要两端对齐用 `style={{ justifyContent: 'space-between' }}`，需要右对齐用 `justifyContent: 'flex-end'`);`vertical` = 纵向堆叠 + 水平居中(`display:flex; flex-direction:column; align-items:center`)。**vertical 模式两个注意点**：① 子元素间**无默认 gap**——需要均匀间距时加 `style={{ gap: '8px' }}`（8px 紧凑 / 12px 标准 / 16px 宽松）；② 子元素**宽度默认收缩至内容宽度**（DEFECT-007，align-items:center 副作用）——若子元素需要撑满父宽度，加 `style={{ alignItems: 'stretch' }}`（整体）或在每个子元素上加 `style={{ width: '100%' }}`（单独控制）。**2026-05-08 跨组件命名 epic §3.3 选项 I 重设计** — 替代旧 `alignType: 'vertical' | 'flex'`(BREAKING-CHANGES §A5)"
+        },
+        "children": {
+            "type": "ReactNode",
+            "description": "子元素;按 direction 控制的轴向排列"
+        },
+        "className": {
+            "type": "string",
+            "description": "外层根 div 的类名(AlignBox-DEFECT-003:src/AlignBox/index.tsx 实证)。常用于追加自定义样式覆盖,如 `flex-wrap: wrap` / `gap` / `justify-content` 等 direction 未提供的属性"
+        },
+        "style": {
+            "type": "React.CSSProperties",
+            "description": "外层根 div 的内联样式(AlignBox-DEFECT-003:src/AlignBox/index.tsx 实证)。**根 div 同时也是 flex 容器**（不存在两层 div 分离），因此 style 可直接传 flexWrap / gap / justifyContent 等 flex 属性，与 className 追加等效。常用示例：`style={{ flexWrap: 'wrap', gap: '8px' }}`（换行 + 间距）；`style={{ justifyContent: 'space-between' }}`（两端对齐）；`style={{ width: '100%' }}`（vertical 模式下覆盖 DEFECT-007 宽度收缩）"
+        }
+    },
+    "do": [
+        "需要『一行内水平排列 + 垂直居中』(图标 + 文字 + 标签)用 direction='horizontal'(默认值,可省略)",
+        "需要『子元素纵向堆叠 + 水平居中』(字段每行一个)用 direction='vertical'",
+        "vertical 模式需要子元素间均匀间距：加 `style={{ gap: '8px' }}`（8px 紧凑 / 12px 标准 / 16px 宽松）——vertical 本身无默认 gap",
+        "vertical 模式需要子元素撑满父宽度（卡片内容、表单字段）：加 `style={{ alignItems: 'stretch' }}`——vertical 子元素默认宽度收缩至内容宽度（DEFECT-007）",
+        "horizontal 需要两端对齐：`style={{ justifyContent: 'space-between', width: '100%' }}`；需要右对齐：`style={{ justifyContent: 'flex-end' }}`——horizontal 默认 flex-start（左对齐）",
+        "需要 wrap / gap / justify-content 等 direction 未提供的 flex 属性，用 **className** 追加 *或* **style 内联**（两种方式等效，因为 style 直接作用于根 flex div）：`style={{ flexWrap: 'wrap', gap: '8px', justifyContent: 'space-between' }}`",
+        "**业务方语义直觉 = direction 字面**:从 v6 开始 horizontal/vertical 即字面对齐 — 不再有命名错位"
+    ],
+    "dont": [
+        "过度嵌套 AlignBox",
+        "替代 CSS Grid/Flexbox 进行复杂布局",
+        "**不要再传旧 prop `alignType`** — 已 BREAKING 移除(BREAKING-CHANGES §A5);从 v5.x 之前升级请按以下映射:旧 `alignType='vertical'`(实为 inline vertical-align middle)→ 新 `direction='horizontal'`(语义最接近);旧 `alignType='flex'`(实为 flex row 居中)→ 新 `direction='horizontal'`(行为完全一致)。要用真正的纵向堆叠请显式传 `direction='vertical'`",
+        "不要假设 `direction='horizontal'` 自动 flex-wrap — src 仅 `display:flex; align-items:center`,无 wrap;要换行请加 className"
+    ],
+    "events": {},
+    "typescriptPitfalls": [
+        {
+            "issue": "direction 只接受 'horizontal' | 'vertical'，不接受 antd flex 方向字符串",
+            "wrong": "<AlignBox direction='row'>...</AlignBox>  // 'row' 不在联合类型中，TS 报错",
+            "right": "<AlignBox direction='horizontal'>...</AlignBox>  // 水平排列用 'horizontal'"
+        },
+        {
+            "issue": "vertical 模式下子元素宽度默认收缩至内容宽度（align-items:center 副作用），需显式覆盖",
+            "wrong": "<AlignBox direction='vertical'><div className='full-row'>...</div></AlignBox>  // 子 div 宽度收缩，不是撑满",
+            "right": "<AlignBox direction='vertical' style={{ alignItems: 'stretch' }}>...</AlignBox>  // 或在子元素加 style={{ width: '100%' }}"
+        },
+        {
+            "issue": "style 和 className 直接作用于根 flex div，不存在两层 div 分离",
+            "wrong": "// 以为有内外两层 div，试图用 className 覆盖内层 flex 容器\n<AlignBox style={{ display: 'block' }}>...</AlignBox>  // 覆盖 display 会破坏 flex 对齐",
+            "right": "// style 直接透传到根 flex div，追加 flex 属性即可\n<AlignBox style={{ gap: '8px', justifyContent: 'space-between' }}>...</AlignBox>"
+        }
+    ],
+    "mapping": {
+        "realComponent": "AlignBox",
+        "adapter": null
+    }
+}

package/lib/AlignBox/index.css

@@ -1 +1 @@
-@charset "UTF-8";.paraui-v4-align-box.paraui-v4-align-box-vertical *{vertical-align:middle}.paraui-v4-align-box.paraui-v4-align-box-flex{display:flex;align-items:center}
+@charset "UTF-8";.paraui-v4-align-box.paraui-v4-align-box-horizontal{display:flex;align-items:center}.paraui-v4-align-box.paraui-v4-align-box-vertical{display:flex;flex-direction:column;align-items:center}

package/lib/AlignBox/index.d.ts

@@ -4,8 +4,12 @@ export interface AlignBoxProps {
     className?: string;
     /** style */
     style?: React.CSSProperties;
-    /** 对齐方式 默认vertical */
-    alignType?: 'vertical' | 'flex';
+    /**
+     * 子元素排列方向（字面 = 行为，2026-05-08 跨组件命名 epic §3.3 选项 I 重设计）
+     * - 'horizontal'(默认): display:flex; align-items:center — 子元素水平排列、垂直居中
+     * - 'vertical': display:flex; flex-direction:column; align-items:center — 子元素纵向堆叠、水平居中
+     */
+    direction?: 'horizontal' | 'vertical';
     children?: ReactNode;
 }
 declare const AlignBox: FunctionComponent<AlignBoxProps>;

package/lib/AlignBox/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const o=require("../_virtual/jsx-runtime.js"),u=require("clsx"),e=require("../GlobalContext/constant.js");;/* empty css            */const a=s=>{const{className:r,style:t,children:i,alignType:l="vertical",...n}=s;return o.jsxRuntimeExports.jsx("div",{className:u(`${e.$prefixCls}-align-box ${e.$prefixCls}-align-box-${l}`,r),style:t,...n,children:i})};exports.default=a;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const l=require("../_virtual/jsx-runtime.js"),u=require("clsx"),e=require("../GlobalContext/constant.js");;/* empty css            */const c=s=>{const{className:r,style:t,children:i,direction:o="horizontal",...n}=s;return l.jsxRuntimeExports.jsx("div",{className:u(`${e.$prefixCls}-align-box ${e.$prefixCls}-align-box-${o}`,r),style:t,...n,children:i})};exports.default=c;
 //# sourceMappingURL=index.js.map

package/lib/AlignBox/style/index.css

@@ -1 +1 @@
-.paraui-v4-align-box.paraui-v4-align-box-vertical *{vertical-align:middle}.paraui-v4-align-box.paraui-v4-align-box-flex{display:flex;align-items:center}
+.paraui-v4-align-box.paraui-v4-align-box-horizontal{display:flex;align-items:center}.paraui-v4-align-box.paraui-v4-align-box-vertical{display:flex;flex-direction:column;align-items:center}

package/lib/Anchor/anchorMenu/index.d.ts

@@ -8,7 +8,8 @@ interface IProps {
     isTree?: boolean;
     anchorMap?: AnchorMap;
     setAnchorMap?: (map: AnchorMap) => void;
-    customPrefixIcon?: React.ReactNode;
+    /** R6 §6 类型放宽:静态 ReactNode 或函数形式 (item, isActive) => ReactNode */
+    customPrefixIcon?: React.ReactNode | ((item: AnchorItem, isActive: boolean) => React.ReactNode);
     onlyOneLevel?: boolean;
 }
 declare const AnchorMenu: (props: IProps) => import("react/jsx-runtime").JSX.Element;

package/lib/Anchor/anchorMenu/index.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const e=require("../../_virtual/jsx-runtime.js"),o=require("react"),g=require("clsx"),q=require("../../node_modules/@para-ui/icons/Down/index.js");;/* empty css            */const k=require("../../AutoTips/index.js"),p=a=>{const{data:t,currentAnchorId:h,handleClick:l,level:c=0,isTree:u=!1,anchorMap:i={},setAnchorMap:E,customPrefixIcon:d,onlyOneLevel:v}=a,{id:x}=t,R=String(x)===String(h);o.useEffect(()=>{},[]);const M=o.useMemo(()=>{const n=[];for(let s=0;s<c;s++)n.push(e.jsxRuntimeExports.jsx("div",{className:"indent"},s));return n},[c]),m=(n,s)=>{n.stopPropagation();const r=i[s];r.expanded=!r.expanded,E?.({...i})},N=o.useMemo(()=>{const{name:n,id:s}=t,r=t.children&&t.children.length>0,f=u?r?e.jsxRuntimeExports.jsx("div",{className:"btn-down",onClick:j=>m(j,s),children:e.jsxRuntimeExports.jsx("div",{className:"icon icon-down",children:e.jsxRuntimeExports.jsx(q.Down,{})})}):e.jsxRuntimeExports.jsx("div",{className:"icon mr-6"}):d||e.jsxRuntimeExports.jsx(A,{});return e.jsxRuntimeExports.jsxs("div",{className:"item-content",onClick:j=>{},children:[f,e.jsxRuntimeExports.jsx("div",{className:"title",onClick:()=>l?.(s),children:e.jsxRuntimeExports.jsx(k.default,{children:n||""})})]})},[t,i,m,l,d,u]);return e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[e.jsxRuntimeExports.jsxs("div",{className:g("anchor-menu-item",{active:R,expanded:i?.[x]?.expanded}),children:[M,N]}),t.children&&i?.[x]?.expanded&&!v&&t.children.map(n=>o.createElement(p,{...a,data:n,key:n?.id,level:c+1}))]})},A=()=>e.jsxRuntimeExports.jsx("div",{className:"icon mr-6",children:e.jsxRuntimeExports.jsx("div",{className:"icon-point"})});exports.default=p;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});require('./index.css');const e=require("../../_virtual/jsx-runtime.js"),c=require("react"),g=require("clsx"),q=require("../../node_modules/@para-ui/icons/Down/index.js");;/* empty css            */const k=require("../../AutoTips/index.js"),h=l=>{const{data:s,currentAnchorId:E,handleClick:u,level:d=0,isTree:m=!1,anchorMap:i={},setAnchorMap:v,customPrefixIcon:o,onlyOneLevel:R}=l,{id:x}=s,a=String(x)===String(E);c.useEffect(()=>{},[]);const f=c.useMemo(()=>{const n=[];for(let t=0;t<d;t++)n.push(e.jsxRuntimeExports.jsx("div",{className:"indent"},t));return n},[d]),j=(n,t)=>{n.stopPropagation();const r=i[t];r.expanded=!r.expanded,v?.({...i})},M=c.useMemo(()=>{const{name:n,id:t}=s,r=s.children&&s.children.length>0,N=m?r?e.jsxRuntimeExports.jsx("div",{className:"btn-down",onClick:p=>j(p,t),children:e.jsxRuntimeExports.jsx("div",{className:"icon icon-down",children:e.jsxRuntimeExports.jsx(q.Down,{})})}):e.jsxRuntimeExports.jsx("div",{className:"icon mr-6"}):o?typeof o=="function"?o(s,a):o:e.jsxRuntimeExports.jsx(A,{});return e.jsxRuntimeExports.jsxs("div",{className:"item-content",onClick:p=>{},children:[N,e.jsxRuntimeExports.jsx("div",{className:"title",onClick:()=>u?.(t),children:e.jsxRuntimeExports.jsx(k.default,{children:n||""})})]})},[s,i,j,u,o,m,a]);return e.jsxRuntimeExports.jsxs(e.jsxRuntimeExports.Fragment,{children:[e.jsxRuntimeExports.jsxs("div",{className:g("anchor-menu-item",{active:a,expanded:i?.[x]?.expanded}),children:[f,M]}),s.children&&i?.[x]?.expanded&&!R&&s.children.map(n=>c.createElement(h,{...l,data:n,key:n?.id,level:d+1}))]})},A=()=>e.jsxRuntimeExports.jsx("div",{className:"icon mr-6",children:e.jsxRuntimeExports.jsx("div",{className:"icon-point"})});exports.default=h;
 //# sourceMappingURL=index.js.map

package/lib/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
+    }
+}