@pisell/materials 1.8.41 → 1.8.43

package/es/components/pisellEntityCard/docs/pisellEntityCard.$tab-design.md

@@ -1,209 +0,0 @@
----
-title: 设计文档
-order: 2
-category: pro
----
-
-# 资源链接
-
-## 任务链接
-
- 
-
-## Figma链接
-
-Implement this design from Figma.
-@https://www.figma.com/design/pM8Ho6d7kCMv9vIBvFHUlj/Pisell-2.0-Component-Library?node-id=13355-110579&m=dev
-Implement this design from Figma.
-@https://www.figma.com/design/pM8Ho6d7kCMv9vIBvFHUlj/Pisell-2.0-Component-Library?node-id=13355-110786&m=dev
-
-# 1. 组件概述
-
-| **组件名称（英文）**                                                                                 | Entity Card                                                                                                                          |
-|----------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
-| **组件编号**                                                                                     | pcp\_dd\_entityCard\_V1.0                                                                                                            |
-| **组件类型**                                                                                     | Pro Components                                                                                                                       |
-| **组件分类**                                                                                     | Data Display                                                                                                                         |
-| **<span style="color: rgb(216,57,49); background-color: rgba(254,212,164,0.8)">依赖组件</span>** | 基于[ Base Card](https://m1ed09stz4r.feishu.cn/wiki/A0MHwnavCi3CSek3nX6c3Uw2nCb)封装，在Base Card的基础上确定了内容以及展示的样式                          |
-| **简介**                                                                                       | **Entity Card** 是一个基于 **Base Card** 的中间层组件，用于在界面中**统一展示、识别和理解一个稳定存在的实体（Entity）**。<br />它并不承载具体业务流程，而是为上层 Plus 组件提供**一致、可复用的实体展示骨架**。 |
-
-# 2. 版本
-
-| **版本**   | 1.0  |
-|----------|------|
-| **更新简介** | 首次发布 |
-
-# 3. 组件设计目的
-
-* 建立统一的 **实体信息展示范式**
-
-* 解耦实体展示与具体业务逻辑
-
-* 为多个领域 Plus 组件提供稳定的中间层依赖
-
-* 支持不同信息密度下的实体识别需求
-
-# 4. 适用场景
-
-* 人员 / 联系人 / 用户列表
-
-* 实体搜索结果
-
-* 实体选择器、引用卡片
-
-* 轻量级实体信息预览
-
-# 5. UI 设计
-
-## 5.1 组件结构
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=NmM4YTlmZTBjMTVhOWZmOGJhZTAwMzUxYmI5ODIxY2VfN0NxU1BDNUNveVhJTFBPSjdGcEpwWkFzZllxdGZKZ3FfVG9rZW46UDczemI0T1plbzBzeE94Zms5U2N2b08ybnpmXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* Entity Card
-
-  * Object Summary（实体识别区）
-
-    * Avatar / Thumbnail / Icon
-
-    * &#x20;Primary Text（Name / Title）
-
-    * Secondary Text（Meta / Description）
-
-    * Tags / Badges
-
-  * Optional Footer / Actions
-
-    * View Detail
-
-    * Select / Link
-
-    * Contextual Action
-
-  **Object Summary 是 Entity Card 的核心结构，不可缺省。**
-
-## 5.2 信息密度等级
-
-Entity Card 通过信息密度等级，控制实体在不同场景下的**展示深度**。
-
-> 密度等级仅影响**信息量与布局**，不改变实体语义与职责。
-
-## 5.3 展示样式
-
-组件展示样式分为Horizontal和Vertical
-
-### 5.3.1 B1-Line
-
-* 展示的最小单位，可以为一个标题文本或者图片、头像、缩略图
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=YjFmMzdmZmI4N2QxNjM3NDU0NTVkNzNjZjBjMjJlZWNfY1NRS08zMzF2QnlmbnVJNGRUcThHM0JRNldENElWTEdfVG9rZW46TTNZRmJKTzRjb0VJUnh4OUhIT2NYVnB2bmFlXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* 一行展示，字段可以并列，但也是最多展示一行信息
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=ZmUwMmQxMDg5MDE4ODM2N2ExNGUyOWNjNzM4OGIwN2VfUjVQT01FVmJLdFoxcXpvVDRkM01ldGNkSVhiWnljQjhfVG9rZW46VHB4cmJVa3BOb0ZkRTd4Nm1PZ2NkRUQ4blBrXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-### 5.3.2 B2-Mini
-
-* 文本信息两行展示，第二行文本字数显示可以为多行
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=NmRlMTljMDMyYzEwN2ZiM2RmY2E0NTI4MDQ5NTA2OWNfWWZaWFBPTkpwaTZpTXJwZW5sdjYyTlhpR05lTUdmNGZfVG9rZW46WXdVRWI5d2Fjb0NkTFF4Z3M3M2NlM0Z3bjFjXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* 当缺少其他信息时，默认不展示
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=NmQ1YjlkYjQwMTRkODBmNDY0OGMxMDBjMTk3NzFkMmJfWjNYVEVRbExqM1Z6U3RaT1hiNmprOEVwWEdmMUZiY0lfVG9rZW46S21McmJjUlhDb01hOGR4a1pqT2NmUElEbkpmXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* 竖向展示
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=ZTlkOTVjYTc1Y2NjODk1ZTg4N2ZhMDg2NDE2NWIzYWFfM1J0cmtLalZybzVERlpZcHhGR1BIZFhUZEhCeDBVUWRfVG9rZW46T2xMZ2JjU1ZXbzBZMkp4YzBnM2NVU3JPbktmXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=OTMxYTE1NWYxM2UwYWZkMWQwOGUzODUxOTllYjM5ZGVfV0JkUjNYblJ2eWVBWm5WVnU1SE1zTU9sbU1FWmh2ZWlfVG9rZW46VlFJbGJnVkplbzZuc2t4T3o2QmN6Vm1ybldiXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-### 5.3.3 B5-Standard
-
-* 文本信息展示最多为5行，超出不显示
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=MzExMTBhMjI0NzY2M2RlYjY2MDE3ZGJkMTQ1Zjc0NWVfSmZZdEE1b1VXTWJSY3ZidWhwUGJaQjJRbGFadHRzTGlfVG9rZW46VTRwWGJ6bXNWbzM2d2Z4VzZoTGN4RHVsbm9jXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* 竖向展示
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=NzM2Mjc5NGU5NzA1ZGY3YzljY2VjOWRjNWIyZDgyMGFfWHdZWkxTZHNycWVjM1BWdERLY3RFTVl1ZjZmNGY3VlBfVG9rZW46S24yZmJjVGJ3bzNPa1V4MnJlRmNzaHBSbkNjXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-### 5.3.4 B9-Extended
-
-* 所有字段全部显示
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=MGI3NzAzNzBiNGQwZWU5ZmNlYjhiN2QwMDQ3OTVlOTJfSVM5cTNmZUlVTk5TTlNDTlFIVFBFaEJEVGZ4dU9idnVfVG9rZW46TU8xbWJmRzVEb1pVVXp4RzJZZGNHeVMwbktjXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-## 5.4 自适应规则
-
-* 宽度默认为跟随内容撑满，内容文本区域超出时显示省略
-
-* 当字段处于同一行时，优先省略后面的信息，当省略到最后一个字母还不能满足时，全部省略此字段，以此类推
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=OWRhNTc2NWQ5N2JjZWM2Y2M0NGVmODhkNWFmMDQxNmVfc3pjVU5FdWxUckR2ZmhWaHdhNkJLRHJFYWpPckxqblFfVG9rZW46SXpPb2JKY3JKb2FaWUl4OFR6SWNNRVFjbmhDXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=MDE2NmEyODU2NGI4ZTc3MzYwZDA3MDJhY2IzMWM2OGVfb244ZUY2T2ZSQnoyOEtIY25QbkQ5ZnQ0UXZ1Tm9MUHZfVG9rZW46V0VGd2J1aUFCbzJJS0Z4aTZoUGM2aW5XbjFlXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=ZWIxNGVhMmYwOTFhMTYzNTU1NmYyOWNjY2NmYTY0NzdfTzI2RzNwZWVHY1RlandVZFdadzlKNmN2Wlg2aThmVWRfVG9rZW46RjZhQ2J4Sk11b0JpUWJ4WEdRU2NwN1lIbk1nXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* 竖向放置时内容的排列方式默认为左右居中对齐
-
-## 5.5 **视觉设计规范（需要主题模块完成）**
-
-### 5.5.1 颜色规范
-
-### 5.5.2 尺寸规范
-
-### 5.5.3 间距规范
-
-# 6. 交互准则
-
-* 当信息字段缺少时，不显示，例如选择了B5，但字段只有两个，那跟B2长得一样
-
-* 当字段超出规范时，不展示，例如选择了B2，但是字段有5个，默认只展示排列在前面的两个
-
-# 7. 配置项
-
-## 7.1 样式自定义
-
-* 可以切换选择Horizontal和Vertical
-
-* Card 的背景、圆角、边框、阴影、padding、gap都可以在默认的基础上去的自定义
-
-* 内容的文本，包括标题文本和次级文本信息，可以自定义大小、粗细、颜色、显示行数、宽度
-
-* card的宽度默认为内容撑满也可更改为固定宽度、撑满父容器
-
-* 内容区域的icon可以更改大小、颜色
-
-* 图片、头像、缩略图可以更改大小和圆角
-
-* 可控制自定义标签的展示位置
-
-## 7.2 功能配置
-
-* 可以自定义字段信息的数据源
-
-* 可以对字段进行显隐和排序，默认展示规则为从上往下展示
-
-* 是否显示图片、头像、缩略图，默认显示
-
-* 是否显示主标题文本，默认显示
-
-* 是否显示次级文本信息，默认显示
-
-* 可以手动添加次级文本信息，并可开启提示icon
-
-* 可以控制显隐tag标签，并能添加和自定义样式
-
-* 可以控制是否开启左滑删除，默认关闭
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=YzEzMjNhMzU2Nzc0MmQxMzA3MzgzMDZkNzc3YTViNzhfWFoySWVDVXcxU1NkdTY2OWs2OVZtSEN5QmZSZ2p1ZGdfVG9rZW46RzlXb2JLYWNOb05ndUh4ZkFyMGNyOFFabkNjXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* 可以控制是否开启Action区域，默认关闭
-
-* 可以控制Action内的操作为文本、按钮、icon，并能各自更改样式
-
-![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=YjdlOTUxZjM4OTU1ZTc4NTNkNzlkZjUxOWIxMzNhZTVfRmZ6Q2xyYU1IY2drTFA0VElwRFNid0VwQVYzdnF0TkVfVG9rZW46VEVObWJjd2xWb2VadXl4Y29KVWNERWhlbldmXzE3NzI2OTAzOTc6MTc3MjY5Mzk5N19WNA)
-
-* 可开启插槽
-

package/es/components/pisellEntityCard/docs/pisellEntityCard.$tab-dev.md

@@ -1,82 +0,0 @@
----
-title: 开发文档
-order: 3
-category: pro
----
-
-# PisellEntityCard 开发文档
-
-## 1. 基础信息
-
-- **组件名称**：PisellEntityCard
-- **组件版本**：1.0
-- **组件分类**：Data Display / Pro Components
-- **依赖**：基于 PisellBaseCard 封装，不依赖 PisellBasicCardProps。
-
-## 2. 需求点罗列
-
-1. **Object Summary 必选结构**：媒体区（Avatar/Thumbnail/Icon）+ 主文案 + 次级文案 + 标签，均可配置显隐与数据源。
-2. **信息密度**：B1-Line / B2-Mini / B5-Standard / B9-Extended，控制展示行数与字段数量。
-3. **布局**：Horizontal / Vertical，可配置。
-4. **数据源**：结构化配置（media、primaryText、secondaryTexts、tags、actions），支持字段显隐与排序（通过数组顺序）。
-5. **可选 Footer/Actions**：支持文本/按钮/icon，可控制显隐与样式。
-6. **左滑删除**：本次直接实现，可配置开关与删除回调。
-7. **样式**：Card 背景、圆角、边框、阴影、padding、gap；文本字号/字重/颜色/行数；媒体尺寸与圆角；标签位置等，透传或扩展 BaseCard。
-8. **宽度**：内容撑满 / 固定宽度 / 撑满父容器。
-9. **插槽**：renderMedia、renderPrimary、renderSecondary、renderTags、renderActions，用于完全自定义某一块。
-
-## 3. 组件描述
-
-PisellEntityCard 是基于 PisellBaseCard 的实体展示卡片，用于统一展示“一个实体”的识别信息（头像/缩略图、主标题、次级信息、标签）及可选的底部操作，支持多种信息密度与横/竖布局，支持左滑删除与插槽扩展。
-
-## 4. 组件 API 罗列
-
-- **继承自 PisellBaseCard**：className, style, hoverStyle, activeStyle, disabledStyle, clickable, disabled, onClick。
-- **数据与显隐**：media, primaryText, secondaryTexts, tags, actions；showMedia, showPrimaryText, showSecondaryText,
-  showTags, showActions（默认见 types）。
-- **密度与布局**：density（B1/B2/B5/B9）, layout（horizontal/vertical）。
-- **宽度**：width（'content' | 'full' | number）。
-- **左滑删除**：swipeToDelete（默认 false）, onDelete。
-- **样式扩展**：mediaSize, mediaShape, tagPosition 等（见 types.ts）。
-- **插槽**：renderMedia, renderPrimary, renderSecondary, renderTags, renderActions。
-
-## 5. 模块拆解与实现方案
-
-### 5.1 组成与引用
-
-- **PisellBaseCard**：根容器，承载四态与点击。
-- **Object Summary 区**：媒体 + 主文案 + 次级文案 + 标签，由密度与 layout 决定排版与行数。
-- **Actions 区**：可选底部，根据 actions 配置渲染文本/按钮/icon。
-- **左滑删除**：使用 touch/mouse 事件或现有滑动组件（若 utils/materials 有则复用）实现滑动露出删除按钮并触发 onDelete。
-
-### 5.2 结构图
-
-```
-PisellEntityCard（根：PisellBaseCard）
-├── [左滑层] 滑动容器
-│   ├── 内容层（Object Summary + 可选 Actions）
-│   │   ├── Object Summary（Horizontal：媒体 | 文案区；Vertical：媒体 在上，文案区 在下）
-│   │   │   ├── 媒体区（Avatar/Thumbnail/Icon，可由 renderMedia 覆盖）
-│   │   │   ├── 文案区
-│   │   │   │   ├── 主文案（可由 renderPrimary 覆盖）
-│   │   │   │   ├── 次级文案列表（可由 renderSecondary 覆盖）
-│   │   │   │   └── 标签区（可由 renderTags 覆盖）
-│   │   │   └── 标签位置可为 inline 或 below
-│   │   └── Footer / Actions（可选，可由 renderActions 覆盖）
-│   └── 删除层（左滑露出，swipeToDelete 时存在）
-└── 宽度由 width 控制（content | full | number）
-```
-
-### 5.3 实现要点
-
-- **密度**：B1 仅一行（主文案或媒体+主文案等）；B2 主+次级最多 2 行；B5 次级最多 5 行；B9 全部展示。缺字段则不渲染对应块；超出密度限制的
-  secondaryTexts/tags 按数组顺序截断。
-- **省略**：同一行优先省略后面字段；文本使用 CSS line-clamp 或单行省略。
-- **左滑删除**：手势识别滑动距离，超过阈值露出删除按钮，点击触发 onDelete；支持 touch 与 mouse。
-- **样式**：类名带 `pisell-entity-card-` 前缀，不设置 font-family；覆盖 antd 时使用 `pisell-lowcode-xxx`。
-
-## 6. 组件通用性与扩展
-
-- 通过结构化配置适配不同实体类型（人、联系人、搜索结果等）。
-- 通过 density/layout 适配列表、选择器、预览等场景。
-- 通过插槽支持完全自定义某一块，同时保留默认展示能力。

package/es/components/pisellEntityCard/docs/pisellEntityCard.$tab-test.md

@@ -1,122 +0,0 @@
----
-title: 测试文档
-order: 4
-category: pro
----
-
-# PisellEntityCard 组件测试用例文档
-
-## 测试概览
-
-本文档列出 PisellEntityCard 组件的测试用例点，基于 types.ts 与组件实现。
-
----
-
-## 一、基础渲染测试
-
-| 测试项          | 测试步骤                                                 | 预期结果                                                       | 测试类型 |
-|--------------|------------------------------------------------------|------------------------------------------------------------|------|
-| 根节点渲染        | 不传数据源，仅传 primaryText                                 | 存在 `.pisell-entity-card-wrap` 且内含 `.pisell-base-card-root` | 自动化  |
-| 主文案渲染        | 传入 `primaryText="实体名称"`                              | 页面显示「实体名称」                                                 | 自动化  |
-| 次级文案渲染       | 传入 `secondaryTexts=[{ text: '描述' }]`                 | 页面显示「描述」                                                   | 自动化  |
-| 媒体区-头像       | 传入 `media={{ type: 'avatar', src: 'x', alt: '头像' }}` | 存在头像元素（.pisell-entity-card-media 或 antd Avatar）            | 自动化  |
-| 标签渲染         | 传入 `tags=[{ text: '标签1' }]`                          | 页面显示「标签1」                                                  | 自动化  |
-| 无媒体无主文案      | 不传 media、primaryText，传 secondaryTexts                | 不报错，可渲染次级或空内容                                              | 自动化  |
-| className 合并 | 传入 `className="custom"`                              | 根卡片节点 class 包含 custom                                      | 自动化  |
-| style 透传     | 传入 `style={{ padding: 20 }}`                         | BaseCard 根节点应用对应样式                                         | 自动化  |
-
----
-
-## 二、显隐与默认值测试
-
-| 测试项                     | 测试步骤                                        | 预期结果     | 测试类型 |
-|-------------------------|---------------------------------------------|----------|------|
-| showMedia 默认 true       | 传入 media，不传 showMedia                       | 显示媒体区    | 自动化  |
-| showMedia=false         | 传入 media 且 showMedia=false                  | 不显示媒体区   | 自动化  |
-| showPrimaryText 默认 true | 传入 primaryText，不传 showPrimaryText           | 显示主文案    | 自动化  |
-| showPrimaryText=false   | 传入 primaryText 且 showPrimaryText=false      | 不显示主文案   | 自动化  |
-| showSecondaryText=false | 传入 secondaryTexts 且 showSecondaryText=false | 不显示次级文案  | 自动化  |
-| showTags=false          | 传入 tags 且 showTags=false                    | 不显示标签    | 自动化  |
-| showActions 默认 false    | 传入 actions，不传 showActions                   | 不显示底部操作区 | 自动化  |
-| showActions=true        | 传入 actions 且 showActions=true               | 显示底部操作区  | 自动化  |
-
----
-
-## 三、密度与布局测试
-
-| 测试项                  | 测试步骤                               | 预期结果                                     | 测试类型 |
-|----------------------|------------------------------------|------------------------------------------|------|
-| density 默认 B2        | 不传 density，传 secondaryTexts        | 次级按 B2 规则展示（最多 2 条/行数）                   | 自动化  |
-| density=B1           | 传入 density="B1" 与 secondaryTexts   | 不显示次级文案                                  | 自动化  |
-| density=B5           | 传入 density="B5" 与多条 secondaryTexts | 次级最多展示 5 条                               | 自动化  |
-| layout 默认 horizontal | 不传 layout                          | Summary 区为横向排布（data-layout="horizontal"） | 自动化  |
-| layout=vertical      | 传入 layout="vertical"               | Summary 区为竖向排布（data-layout="vertical"）   | 自动化  |
-| width=content        | 不传 width 或 width="content"         | 外层宽度为 fit-content                        | 自动化  |
-| width=full           | 传入 width="full"                    | 外层宽度 100%                                | 自动化  |
-| width 数字             | 传入 width={300}                     | 外层宽度 300px                               | 自动化  |
-| tagPosition=inline   | 传入 tagPosition="inline" 与 tags     | 标签与主文案同行                                 | 自动化  |
-| tagPosition=below    | 传入 tagPosition="below" 与 tags      | 标签在次级下方                                  | 自动化  |
-
----
-
-## 四、左滑删除测试
-
-| 测试项             | 测试步骤                                                | 预期结果                                        | 测试类型 |
-|-----------------|-----------------------------------------------------|---------------------------------------------|------|
-| 未开启左滑           | 不传 swipeToDelete 或 swipeToDelete=false              | 无滑动容器，无删除按钮                                 | 自动化  |
-| 开启左滑需 onDelete  | 传入 swipeToDelete=true 且 onDelete                    | 存在 .pisell-entity-card-swipe-container 与删除区 | 自动化  |
-| 点击删除触发 onDelete | swipeToDelete=true、onDelete 为 jest.fn()，滑动露出删除后点击删除 | onDelete 被调用一次                              | 自动化  |
-
----
-
-## 五、Actions 与插槽测试
-
-| 测试项                  | 测试步骤                                                     | 预期结果                     | 测试类型 |
-|----------------------|----------------------------------------------------------|--------------------------|------|
-| actions 文本型          | showActions=true，actions=[{ type: 'text', label: '查看' }] | 显示「查看」                   | 自动化  |
-| actions 按钮型          | actions=[{ type: 'button', label: '选择' }]                | 显示按钮样式操作                 | 自动化  |
-| 点击 action 触发 onClick | action 配置 onClick 为 jest.fn()，点击该操作                      | 对应 onClick 被调用，且事件不冒泡到卡片 | 自动化  |
-| renderPrimary 插槽     | 传入 renderPrimary={() => <span>自定义主文案</span>}             | 显示「自定义主文案」而非 primaryText | 自动化  |
-| renderTags 插槽        | 传入 renderTags={() => <span>自定义标签</span>}                 | 显示「自定义标签」而非 tags 列表      | 自动化  |
-
----
-
-## 六、BaseCard 透传与事件测试
-
-| 测试项          | 测试步骤                          | 预期结果                    | 测试类型 |
-|--------------|-------------------------------|-------------------------|------|
-| clickable 透传 | 传入 clickable=false            | 卡片无 role="button"，不响应点击 | 自动化  |
-| disabled 透传  | 传入 disabled=true              | 卡片有 aria-disabled，不响应点击 | 自动化  |
-| onClick 触发   | 传入 onClick（jest.fn()），点击卡片内容区 | onClick 被调用一次           | 自动化  |
-| children 渲染  | 传入 children={<div>额外内容</div>} | 卡片内显示「额外内容」             | 自动化  |
-
----
-
-## 七、人工测试点
-
-| 测试项           | 测试步骤                                              | 预期结果             |
-|---------------|---------------------------------------------------|------------------|
-| 横向布局视觉        | layout=horizontal，媒体+主+次级+标签                      | 媒体在左，文案在右，间距合理   |
-| 竖向布局视觉        | layout=vertical                                   | 媒体在上、文案在下，居中对齐   |
-| B2 次级行数       | density=B2，两条次级                                   | 次级区域最多约 2 行，超出省略 |
-| B5 次级行数       | density=B5，多条次级                                   | 次级最多约 5 行        |
-| 左滑手势          | 移动端或模拟 touch，左滑卡片                                 | 露出删除按钮，松手可回弹或保持  |
-| 删除按钮样式        | 左滑露出删除                                            | 删除区红色背景、白色文字、可点击 |
-| 主/次级省略        | 主文案或次级过长                                          | 单行/多行省略，不撑破布局    |
-| 带 tooltip 的次级 | secondaryTexts=[{ text: 'x', showTooltip: true }] | 该行前有 info 图标     |
-
----
-
-## Bug 汇总
-
-### 待修复的 Bug
-
-| Bug ID | 描述 | 优先级 | 状态 | 发现时间 |
-|--------|----|-----|----|------|
-| -      | -  | -   | -  | -    |
-
-### 已修复的 Bug
-
-| Bug ID | 描述 | 优先级 | 修复时间 | 修复方案 |
-|--------|----|-----|------|------|
-| -      | -  | -   | -    | -    |

package/es/components/pisellEntityCard/docs/pisellEntityCard.md

@@ -1,176 +0,0 @@
----
-nav:
-  title: 组件
-  order: 1
-group:
-  title: Data Display
-  order: 1
-title: PisellEntityCard
-order: 1
-category: pro
----
-
-# PisellEntityCard 实体卡片
-
-基于 **PisellBaseCard**
-的实体展示卡片，用于统一展示「一个实体」的识别信息：媒体区（头像/缩略图/图标）、主文案、副标题、次级信息、标签，以及可选的右侧操作区。支持多种信息密度（B1/B2/B5/B9）、横/竖布局、左滑删除与插槽扩展。
-
-## 设计文档
-
-详见 [设计文档](./pisellEntityCard.$tab-design.md)。
-
-## 何时使用
-
-- 列表项、搜索结果中的实体摘要（人、联系人、客户、商品等）
-- 选择器中的选项展示
-- 详情页关联实体引用
-- 需要左滑删除的列表项
-
-## 代码示例
-
-### 基础用法（横向 B2）
-
-```tsx
-import {PisellEntityCard} from '@pisell/materials';
-
-export default function Demo() {
-    return (
-        <PisellEntityCard
-            primaryText="张三"
-            subtitleText="+86 138 0000 0000"
-            secondaryTexts={[
-                {text: '产品经理 · 杭州'},
-                {text: '钉钉事业部'},
-            ]}
-            media={{
-                type: 'avatar',
-                src: 'https://ui-avatars.com/api/?name=Zhang+San&size=48',
-                alt: '头像',
-                size: 48,
-            }}
-            density="B2"
-            layout="horizontal"
-        />
-    );
-}
-```
-
-### 带操作区与标签
-
-```tsx
-import {PisellEntityCard} from '@pisell/materials';
-import {EditOutlined} from '@ant-design/icons';
-
-export default function Demo() {
-    return (
-        <PisellEntityCard
-            primaryText="张三"
-            secondaryTexts={[{text: '产品经理'}]}
-            tags={[{text: '在职'}, {text: '正式'}]}
-            media={{type: 'avatar', src: '', alt: '头像', size: 40}}
-            showActions
-            actions={[
-                {type: 'icon', icon: <EditOutlined/>, onClick: () => console.log('编辑')},
-                {type: 'text', label: '查看详情', onClick: () => console.log('详情')},
-            ]}
-        />
-    );
-}
-```
-
-### 竖向布局
-
-```tsx
-import {PisellEntityCard} from '@pisell/materials';
-
-export default function Demo() {
-    return (
-        <PisellEntityCard
-            primaryText="实体名称"
-            secondaryTexts={[{text: '描述信息'}]}
-            media={{
-                type: 'avatar',
-                src: 'https://ui-avatars.com/api/?name=Entity&size=64',
-                alt: '头像',
-                size: 64,
-            }}
-            density="B2"
-            layout="vertical"
-        />
-    );
-}
-```
-
-### 左滑删除
-
-```tsx
-import {PisellEntityCard} from '@pisell/materials';
-
-export default function Demo() {
-    return (
-        <PisellEntityCard
-            primaryText="可删除项"
-            secondaryTexts={[{text: '左滑显示删除'}]}
-            media={{type: 'avatar', src: '', alt: ''}}
-            swipeToDelete
-            onDelete={() => console.log('已删除')}
-        />
-    );
-}
-```
-
-### 密度 B5 / B9
-
-```tsx
-import {PisellEntityCard} from '@pisell/materials';
-
-export default function Demo() {
-    return (
-        <PisellEntityCard
-            primaryText="多行次级"
-            secondaryTexts={[
-                {text: '第一行'},
-                {text: '第二行'},
-                {text: '第三行'},
-                {text: '第四行'},
-                {text: '第五行'},
-            ]}
-            tags={[{text: '标签1'}, {text: '标签2'}]}
-            density="B5"
-            layout="horizontal"
-        />
-    );
-}
-```
-
-## API
-
-| 属性                 | 说明                 | 类型                            | 默认值          |
-|--------------------|--------------------|-------------------------------|--------------|
-| media              | 媒体区（头像/缩略图/图标）     | EntityCardMediaConfig         | -            |
-| primaryText        | 主文案                | string                        | -            |
-| subtitleText       | 副标题（与主标题同行）        | string                        | -            |
-| secondaryTexts     | 次级文案列表             | EntityCardSecondaryItem[]     | []           |
-| tags               | 标签列表               | EntityCardTagItem[]           | []           |
-| actions            | 操作项（需 showActions） | EntityCardActionItem[]        | []           |
-| showMedia          | 显示媒体区              | boolean                       | true         |
-| showPrimaryText    | 显示主文案              | boolean                       | true         |
-| showSubtitle       | 显示副标题              | boolean                       | true         |
-| showSecondaryText  | 显示次级文案             | boolean                       | true         |
-| showTags           | 显示标签               | boolean                       | true         |
-| showActions        | 显示操作区              | boolean                       | false        |
-| density            | 信息密度               | 'B1' \| 'B2' \| 'B5' \| 'B9'  | 'B2'         |
-| layout             | 布局方向               | 'horizontal' \| 'vertical'    | 'horizontal' |
-| width              | 卡片宽度               | 'content' \| 'full' \| number | 'content'    |
-| swipeToDelete      | 开启左滑删除             | boolean                       | false        |
-| onDelete           | 左滑删除回调             | () => void                    | -            |
-| tagPosition        | 标签位置               | 'inline' \| 'below'           | 'below'      |
-| contentGap         | 内容间距               | number \| string              | -            |
-| primaryLineClamp   | 主文案行数限制            | number                        | -            |
-| secondaryLineClamp | 次级文案行数限制           | number                        | -            |
-
-继承自 PisellBaseCard：`className`、`style`、`hoverStyle`、`activeStyle`、`disabledStyle`、`clickable`、`disabled`、`onClick`。
-
-插槽：`renderMedia`、`renderPrimary`、`renderSubtitle`、`renderSecondary`、`renderTags`、`renderActions`。
-
-更多见 [types.ts](../types.ts)。

package/es/components/pisellEntityCard/index.d.ts

@@ -1,2 +0,0 @@
-import { EntityCardActionItem, EntityCardDensity, EntityCardLayout, EntityCardMediaConfig, EntityCardMediaType, EntityCardSecondaryItem, EntityCardTagItem, EntityCardTagPosition, EntityCardWidth, PisellEntityCardProps } from "./types.js";
-import { PisellEntityCard } from "./PisellEntityCard.js";