@pisell/materials 1.8.38 → 1.8.41

package/lib/components/pisellCurrency/PisellCurrency.less

@@ -10,129 +10,6 @@
   &-edit {
     position: relative;
     width: 100%;
-
-    // InputNumber 外层（Figma 设计规范，无边框避免双边框）
-    .pisell-lowcode-input-number {
-      width: 100% !important;
-      font-size: 16px !important;
-      line-height: 24px !important;
-      border-radius: 8px !important;
-      border: none !important;
-      color: #101828 !important; // Gray/900
-      background-color: #ffffff !important;
-
-      // 内层 input
-      .pisell-lowcode-input-number-input {
-        height: 46px !important; // 48 - 2px border
-        padding: 12px 16px !important;
-        font-size: 16px !important;
-        line-height: 24px !important;
-        color: #101828 !important;
-        background: transparent !important;
-        border: none !important;
-
-        &::placeholder {
-          color: #667085 !important; // Gray/500
-        }
-      }
-
-      // 聚焦态
-      &.pisell-lowcode-input-number-focused,
-      &:focus,
-      &:focus-within {
-        border-color: #d6bbfb !important; // Primary/300
-        box-shadow: 0 0 0 4px #f4ebff !important; // Primary/100
-        outline: none !important;
-      }
-
-      // Hover 态
-      &:hover:not(.pisell-lowcode-input-number-disabled):not(.pisell-lowcode-input-number-focused) {
-        border-color: #b692f6 !important; // Primary/400
-      }
-
-      // 禁用态
-      &.pisell-lowcode-input-number-disabled {
-        background-color: #f9fafb !important; // Gray/50
-        border-color: #d0d5dd !important;
-        cursor: not-allowed !important;
-
-        .pisell-lowcode-input-number-input {
-          color: #98a2b3 !important; // Gray/400
-          cursor: not-allowed !important;
-        }
-      }
-
-      // 货币符号：前缀
-      .pisell-lowcode-input-number-prefix {
-        margin-right: 8px;
-        margin-left: 16px;
-        color: #667085; // Gray/500
-        font-size: 16px;
-      }
-
-      // 货币符号：后置（addonAfter）
-      .pisell-lowcode-input-number-suffix {
-        margin-left: 8px;
-        margin-right: 16px;
-        color: #667085;
-        font-size: 16px;
-      }
-
-      // addonBefore / addonAfter 包裹（InputNumber 后置符号可能用 addon 渲染）
-      .pisell-lowcode-input-number-group-addon {
-        background-color: #ffffff !important;
-        border: 1px solid #d0d5dd !important;
-        color: #344054; // Gray/700
-        font-size: 16px !important;
-        padding: 12px 16px !important;
-
-        &:first-child {
-          border-right: none !important;
-          border-radius: 8px 0 0 8px !important;
-        }
-
-        &:last-child {
-          border-left: none !important;
-          border-radius: 0 8px 8px 0 !important;
-        }
-      }
-
-      // 步进器按钮（controls）
-      .pisell-lowcode-input-number-handler-wrap {
-        border-left: 1px solid #d0d5dd !important;
-        background: #ffffff !important;
-
-        .pisell-lowcode-input-number-handler {
-          color: #667085;
-          border-color: #d0d5dd;
-
-          &:hover {
-            color: #344054;
-          }
-
-          &.pisell-lowcode-input-number-handler-up-disabled,
-          &.pisell-lowcode-input-number-handler-down-disabled {
-            color: #98a2b3;
-            cursor: not-allowed;
-          }
-        }
-      }
-
-      // 错误状态
-      &.pisell-lowcode-input-number-status-error {
-        border-color: #fda29b !important; // Error/300
-
-        &.pisell-lowcode-input-number-focused,
-        &:focus-within {
-          border-color: #f97066 !important; // Error/400
-          box-shadow: 0 0 0 4px #fee4e2 !important; // Error/100
-        }
-
-        &:hover:not(:focus-within) {
-          border-color: #f97066 !important;
-        }
-      }
-    }
   }
 
   // 错误提示（与设计体系一致）

package/lib/components/pisellCustomerBrief/PisellCustomerBrief.d.ts

@@ -0,0 +1,57 @@
+import { PisellCustomerBriefProps } from "./types.js";
+import React from "react";
+//#region src/components/pisellCustomerBrief/PisellCustomerBrief.d.ts
+/**
+ * PisellCustomerBrief 客户简要卡片
+ * 基于 PisellEntityCard，用于展示客户（Customer）实体的核心识别信息与客户级属性。
+ * 设计文档：Customer Info (pcl_customerInfon_V1.0)
+ *
+ * - 无头像时显示默认占位 Avatar
+ * - 文本过长按配置省略
+ * - Actions 为空时不占位
+ *
+ * @param props 组件 Props
+ */
+declare function PisellCustomerBrief({
+  name,
+  subtitle,
+  avatar,
+  email,
+  address,
+  company,
+  date,
+  extendedFields,
+  tags,
+  actions,
+  showActions,
+  showAvatar,
+  showPrimaryText,
+  showSubtitle,
+  showExtended,
+  showTags,
+  density,
+  layout,
+  width,
+  swipeToDelete,
+  onDelete,
+  tagPosition,
+  contentGap,
+  primaryLineClamp,
+  secondaryLineClamp,
+  renderMedia,
+  renderPrimary,
+  renderSubtitle,
+  renderSecondary,
+  renderTags,
+  renderActions,
+  className,
+  style,
+  hoverStyle,
+  activeStyle,
+  disabledStyle,
+  clickable,
+  disabled,
+  onClick
+}: PisellCustomerBriefProps): React.JSX.Element;
+//#endregion
+export { PisellCustomerBrief };

package/lib/components/pisellCustomerBrief/PisellCustomerBrief.js

@@ -0,0 +1,94 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.js");
+const require_PisellEntityCard = require("../pisellEntityCard/PisellEntityCard.js");
+let react = require("react");
+react = require_runtime.__toESM(react);
+require("./PisellCustomerBrief.less");
+//#region src/components/pisellCustomerBrief/PisellCustomerBrief.tsx
+/**
+* PisellCustomerBrief 客户简要卡片
+* 基于 PisellEntityCard，用于展示客户（Customer）实体的核心识别信息与客户级属性。
+* 设计文档：Customer Info (pcl_customerInfon_V1.0)
+*
+* - 无头像时显示默认占位 Avatar
+* - 文本过长按配置省略
+* - Actions 为空时不占位
+*
+* @param props 组件 Props
+*/
+function PisellCustomerBrief({ name, subtitle, avatar, email, address, company, date, extendedFields = [], tags = [], actions = [], showActions = false, showAvatar = true, showPrimaryText = true, showSubtitle = true, showExtended = true, showTags = true, density = "B2", layout = "horizontal", width = "content", swipeToDelete = false, onDelete, tagPosition = "below", contentGap, primaryLineClamp, secondaryLineClamp, renderMedia, renderPrimary, renderSubtitle, renderSecondary, renderTags, renderActions, className, style, hoverStyle, activeStyle, disabledStyle, clickable = true, disabled = false, onClick }) {
+	/** 媒体区：头像，无 src 时 EntityCard 会显示默认占位 */
+	const media = (0, react.useMemo)(() => {
+		if (!showAvatar) return void 0;
+		return {
+			type: "avatar",
+			src: avatar,
+			alt: name,
+			size: 40,
+			shape: "circle"
+		};
+	}, [
+		showAvatar,
+		avatar,
+		name
+	]);
+	/** 扩展信息 → 次级文案列表，顺序：email、address、company、date、extendedFields */
+	const secondaryTexts = (0, react.useMemo)(() => {
+		if (!showExtended) return [];
+		const list = [];
+		if (email) list.push({ text: email });
+		if (address) list.push({ text: address });
+		if (company) list.push({ text: company });
+		if (date) list.push({ text: date });
+		extendedFields.forEach((f) => list.push({
+			text: f.text,
+			showTooltip: f.showTooltip
+		}));
+		return list;
+	}, [
+		showExtended,
+		email,
+		address,
+		company,
+		date,
+		extendedFields
+	]);
+	return /* @__PURE__ */ react.default.createElement(require_PisellEntityCard.PisellEntityCard, {
+		className: `pisell-customer-brief-root ${className !== null && className !== void 0 ? className : ""}`.trim(),
+		style,
+		hoverStyle,
+		activeStyle,
+		disabledStyle,
+		clickable,
+		disabled,
+		onClick,
+		media,
+		primaryText: name,
+		subtitleText: subtitle,
+		secondaryTexts,
+		tags,
+		actions,
+		showMedia: showAvatar,
+		showPrimaryText,
+		showSubtitle,
+		showSecondaryText: showExtended,
+		showTags,
+		showActions,
+		density,
+		layout,
+		width,
+		swipeToDelete,
+		onDelete,
+		tagPosition,
+		contentGap,
+		primaryLineClamp,
+		secondaryLineClamp,
+		renderMedia,
+		renderPrimary,
+		renderSubtitle,
+		renderSecondary,
+		renderTags,
+		renderActions
+	});
+}
+//#endregion
+exports.PisellCustomerBrief = PisellCustomerBrief;

package/lib/components/pisellCustomerBrief/PisellCustomerBrief.less

@@ -0,0 +1,8 @@
+/**
+ * PisellCustomerBrief 组件样式
+ * 基于 Entity Card 结构，仅做根类名作用域；具体样式由 PisellEntityCard 提供
+ */
+
+.pisell-customer-brief-root {
+  /* 客户卡片根节点，扩展时可在此追加样式 */
+}

package/lib/components/pisellCustomerBrief/docs/pisellCustomerBrief.$tab-design.md

@@ -0,0 +1,115 @@
+---
+title: 设计文档
+order: 2
+category: pro
+---
+
+# 资源链接
+
+## 任务链接
+
+ 
+
+## Figma链接
+
+Implement this design from Figma.
+@https://www.figma.com/design/pM8Ho6d7kCMv9vIBvFHUlj/Pisell-2.0-Component-Library?node-id=8958-1468&m=dev
+
+# 1. 组件概述
+
+| **组件名称（英文）** | Customer Info                                                                                                                                   |
+|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------|
+| **组件编号**     | pcl\_customerInfon\_V1.0                                                                                                                        |
+| **组件类型**     | Plus Components                                                                                                                                 |
+| **组件分类**     | Plus Components                                                                                                                                 |
+| **依赖组件**     | [ Entity Card](https://m1ed09stz4r.feishu.cn/wiki/ID7qwQrWai0mDFkEIb6c7Ymbnde)                                                                  |
+| **简介**       | **Customer Info** 是一个基于 **Entity Card** 的 Plus 组件，用于在界面中展示**客户（Customer）这一业务实体的核心识别信息与客户级属性**。<br />它在 Entity Card 提供的统一实体结构之上，补充了客户领域特有的字段与语义。 |
+
+# 2. 版本
+
+| **版本**   | 1.0  |
+|----------|------|
+| **更新简介** | 首次发布 |
+
+# 3. 组件设计目的
+
+* 在多个系统中统一客户信息的展示方式
+
+* 明确区分“客户实体”与“联系人实体”
+
+* 支持客户级标签、等级、状态等业务信息
+
+# 4. 适用场景
+
+### 适用场景
+
+* 客户列表 / 客户搜索结果
+
+* 订单、合同、会员等模块中的客户引用
+
+* 客户详情页的概要区域
+
+### 不适用场景
+
+* 单纯联系人展示（应使用 Contact Info）
+
+* 交易流程中的客户行项目
+
+# 5. UI 设计
+
+## 5.1 展示样式
+
+![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=ZTY5YWIxNTQyOTIxMTdhY2UwNzJjOGUzYWU2NWFlMTNfUzBsdER1aXg2WU9VOHk0cHdUUzVFNTYxQ1BXNlZESktfVG9rZW46TjNDd2JndmJmb29SOUJ4dzNkMGM1RWVabjZiXzE3NzI4MTI4Mjk6MTc3MjgxNjQyOV9WNA)
+
+## 5.2 **视觉设计规范（需要主题模块完成）**
+
+### 5.2.1 颜色规范
+
+### 5.2.2 尺寸规范
+
+### 5.2.3 间距规范
+
+# 6. 交互准则
+
+* 无头像：显示默认占位 Avatar
+
+* 文本过长：按配置进行省略
+
+* Actions 为空：不占位
+
+# 7. 内容模型
+
+## 7.1 核心身份信息
+
+## 7.2 扩展信息
+
+用于 B5 / B9 模式，可配置显示多个字段。
+
+示例字段：
+
+* Email
+
+* Address
+
+* Company
+
+* Date
+
+* Custom attributes
+
+## 7.3 操作区
+
+支持：（透传[ Entity Card](https://m1ed09stz4r.feishu.cn/wiki/ID7qwQrWai0mDFkEIb6c7Ymbnde)组件功能）
+
+* 仅图标操作
+
+* 图标 + 文本操作
+
+* button按钮操作
+
+# 8. 配置项
+
+![](https://m1ed09stz4r.feishu.cn/space/api/box/stream/download/asynccode/?code=NTk2YjVhN2YyNzhjMDU0NTBhMjBlZmQwYWRhOGIzOWRfM3NURkRoSUpkOU9LSnBFUXZkcFIxcU5jdHVCRlNKYXlfVG9rZW46VGtvYmJGN0tTb1Nsamp4OXRVeWNJckIxbnJoXzE3NzI4MTI4Mjk6MTc3MjgxNjQyOV9WNA)
+
+# 9. 示例
+

package/lib/components/pisellCustomerBrief/docs/pisellCustomerBrief.$tab-dev.md

@@ -0,0 +1,73 @@
+---
+title: 开发文档
+order: 3
+category: pro
+---
+
+# PisellCustomerBrief 开发文档
+
+## 1. 基础信息
+
+- **组件名称**：PisellCustomerBrief（Customer Info）
+- **组件版本**：1.0
+- **组件分类**：Data Display / Plus Components
+- **依赖**：基于 PisellEntityCard 封装，无额外业务弹窗。
+
+## 2. 需求点罗列
+
+1. **客户身份信息**：客户名称（主文案）、副标题（电话/编号）、头像（无则默认占位）。
+2. **扩展信息**：Email、Address、Company、Date、自定义属性，映射为 Entity Card 的 secondaryTexts，顺序固定为 email → address →
+   company → date → extendedFields。
+3. **标签**：客户级等级、状态等，透传 Entity Card tags。
+4. **操作区**：透传 Entity Card actions（仅图标 / 图标+文本 / 按钮）；Actions 为空时不占位。
+5. **密度与布局**：透传 density（B1/B2/B5/B9）、layout（horizontal/vertical）、width。
+6. **左滑删除**：透传 swipeToDelete、onDelete。
+7. **显隐**：showAvatar、showPrimaryText、showSubtitle、showExtended、showTags、showActions。
+8. **插槽**：透传 renderMedia、renderPrimary、renderSubtitle、renderSecondary、renderTags、renderActions。
+
+## 3. 组件描述
+
+PisellCustomerBrief 是基于 PisellEntityCard
+的客户简要卡片，用于统一展示客户实体的核心识别信息与客户级属性。将客户领域字段（name、subtitle、email、address、company、date、extendedFields、tags）映射为
+Entity Card 的结构化配置，无头像时由 Entity Card 显示默认占位 Avatar。
+
+## 4. 组件 API 罗列
+
+- **继承 BaseCard 能力**：className, style, hoverStyle, activeStyle, disabledStyle, clickable, disabled, onClick。
+- **核心身份**：name, subtitle, avatar。
+- **扩展信息**：email, address, company, date, extendedFields；showExtended。
+- **标签与操作**：tags, actions；showTags, showActions。
+- **显隐**：showAvatar, showPrimaryText, showSubtitle。
+- **密度与布局**：density, layout, width；tagPosition, contentGap, primaryLineClamp, secondaryLineClamp。
+- **左滑删除**：swipeToDelete, onDelete。
+- **插槽**：renderMedia, renderPrimary, renderSubtitle, renderSecondary, renderTags, renderActions。
+
+## 5. 模块拆解与实现方案
+
+### 5.1 组成与引用
+
+- **PisellEntityCard**：唯一子组件，接收映射后的 props。
+- **PisellCustomerBrief**：负责将客户语义 Props 映射为 Entity Card 的
+  media、primaryText、subtitleText、secondaryTexts、tags、actions 及显隐/密度/布局/插槽。
+
+### 5.2 数据映射
+
+- `name` → primaryText
+- `subtitle` → subtitleText
+- `avatar`（或 undefined）→ media: { type: 'avatar', src, alt: name, size: 40, shape: 'circle' }
+- `email`、`address`、`company`、`date`、`extendedFields` 按顺序合并为 secondaryTexts
+- `tags`、`actions` 透传
+- showAvatar → showMedia，showExtended → showSecondaryText，其余 show* 一一对应
+
+### 5.3 结构图
+
+```
+PisellCustomerBrief（根：PisellEntityCard + 类名 pisell-customer-brief-root）
+└── 内部即 PisellEntityCard 结构（媒体区 + 文案区 + 标签 + 操作区）
+```
+
+### 5.4 实现要点
+
+- 无 avatar 时仍传 media（src 为 undefined），由 Entity Card / Avatar 显示默认占位。
+- 扩展信息顺序固定，便于 B5/B9 等多行展示时语义一致。
+- 样式仅增加 .pisell-customer-brief-root 作用域，具体样式由 Entity Card 提供。

package/lib/components/pisellCustomerBrief/docs/pisellCustomerBrief.$tab-test.md

@@ -0,0 +1,66 @@
+---
+title: 测试文档
+order: 4
+category: pro
+---
+
+# PisellCustomerBrief 组件测试用例文档
+
+## 测试概览
+
+本文档列出 PisellCustomerBrief 组件的测试用例点，基于 types.ts 与组件实现（委托 PisellEntityCard）。
+
+---
+
+## 一、基础渲染测试
+
+| 测试项          | 测试步骤                       | 预期结果                                                                                  | 测试类型 |
+|--------------|----------------------------|---------------------------------------------------------------------------------------|------|
+| 根节点渲染        | 仅传 name                    | 存在 .pisell-entity-card-wrap 且内含 .pisell-customer-brief-root（通过 EntityCard 根 class 合并） | 自动化  |
+| 主文案渲染        | 传入 name="客户A"              | 页面显示「客户A」                                                                             | 自动化  |
+| 副标题渲染        | 传入 subtitle="+86 138"      | 页面显示「+86 138」                                                                         | 自动化  |
+| 扩展信息渲染       | 传入 email、company           | 次级区域显示邮箱与公司                                                                           | 自动化  |
+| 标签渲染         | 传入 tags=[{ text: 'VIP' }]  | 页面显示「VIP」                                                                             | 自动化  |
+| 无头像默认占位      | 不传 avatar，showAvatar=true  | 存在媒体区（默认 Avatar 占位）                                                                   | 自动化  |
+| className 合并 | 传入 className="custom"      | 根节点 class 包含 custom 与 pisell-customer-brief-root                                      | 自动化  |
+| style 透传     | 传入 style={{ padding: 16 }} | 卡片应用对应样式                                                                              | 自动化  |
+
+---
+
+## 二、显隐与默认值测试
+
+| 测试项                  | 测试步骤                             | 预期结果    | 测试类型 |
+|----------------------|----------------------------------|---------|------|
+| showAvatar 默认 true   | 不传 showAvatar                    | 显示媒体区   | 自动化  |
+| showAvatar=false     | showAvatar=false                 | 不显示媒体区  | 自动化  |
+| showSubtitle=false   | 传入 subtitle 且 showSubtitle=false | 不显示副标题  | 自动化  |
+| showExtended=false   | 传入 email 且 showExtended=false    | 不显示扩展信息 | 自动化  |
+| showActions 默认 false | 传入 actions，不传 showActions        | 不显示操作区  | 自动化  |
+| showActions=true     | 传入 actions 且 showActions=true    | 显示操作区   | 自动化  |
+
+---
+
+## 三、数据映射测试
+
+| 测试项               | 测试步骤                                             | 预期结果                                                      | 测试类型 |
+|-------------------|--------------------------------------------------|-----------------------------------------------------------|------|
+| extendedFields 顺序 | 传入 extendedFields=[{ text: 'A' }, { text: 'B' }] | 次级区域按 A、B 顺序展示                                            | 自动化  |
+| 扩展信息顺序            | 传入 email、address、company、date、extendedFields     | 次级展示顺序为 email → address → company → date → extendedFields | 自动化  |
+
+---
+
+## 四、左滑删除与交互测试
+
+| 测试项    | 测试步骤                                    | 预期结果                   | 测试类型 |
+|--------|-----------------------------------------|------------------------|------|
+| 透传左滑删除 | swipeToDelete=true、onDelete 为 jest.fn() | 存在滑动容器，点击删除触发 onDelete | 自动化  |
+| 点击卡片   | 传入 onClick 为 jest.fn()，点击卡片             | onClick 被调用            | 自动化  |
+
+---
+
+## 五、密度与布局测试
+
+| 测试项           | 测试步骤              | 预期结果        | 测试类型 |
+|---------------|-------------------|-------------|------|
+| density 默认 B2 | 不传 density        | 按 B2 规则展示次级 | 自动化  |
+| layout 透传     | layout="vertical" | 文案区竖向排布     | 自动化  |

package/lib/components/pisellCustomerBrief/docs/pisellCustomerBrief.md

@@ -0,0 +1,132 @@
+---
+nav:
+  title: 组件
+  order: 1
+group:
+  title: Data Display
+  order: 1
+title: PisellCustomerBrief
+order: 1
+category: pro
+---
+
+# PisellCustomerBrief 客户简要卡片
+
+基于 **PisellEntityCard** 的 Plus 组件，用于在界面中展示**客户（Customer）实体的核心识别信息与客户级属性**。在 Entity Card
+提供的统一实体结构之上，补充客户领域特有的字段与语义。
+
+## 设计文档
+
+详见 [设计文档](./pisellCustomerBrief.$tab-design.md)。
+
+## 何时使用
+
+- 客户列表 / 客户搜索结果
+- 订单、合同、会员等模块中的客户引用
+- 客户详情页的概要区域
+
+## 代码示例
+
+### 基础用法
+
+```tsx
+import {PisellCustomerBrief} from '@pisell/materials';
+
+export default function Demo() {
+    return (
+        <PisellCustomerBrief
+            name="某某公司"
+            subtitle="+86 138 0000 0000"
+            email="contact@company.com"
+            company="某某科技有限公司"
+            tags={[{text: 'VIP'}, {text: '已签约'}]}
+        />
+    );
+}
+```
+
+### 带扩展信息与操作
+
+```tsx
+import {PisellCustomerBrief} from '@pisell/materials';
+import {EditOutlined} from '@ant-design/icons';
+
+export default function Demo() {
+    return (
+        <PisellCustomerBrief
+            name="某某公司"
+            subtitle="客户编号 C001"
+            email="contact@company.com"
+            address="浙江省杭州市余杭区"
+            company="某某科技有限公司"
+            date="2024-01-15 创建"
+            tags={[{text: 'VIP'}, {text: '已签约'}]}
+            showActions
+            actions={[
+                {type: 'icon', icon: <EditOutlined/>, onClick: () => console.log('编辑')},
+                {type: 'text', label: '查看详情', onClick: () => console.log('详情')},
+            ]}
+            density="B5"
+        />
+    );
+}
+```
+
+### 无头像（默认占位）
+
+不传 `avatar` 时显示默认占位 Avatar。
+
+```tsx
+import {PisellCustomerBrief} from '@pisell/materials';
+
+export default function Demo() {
+    return <PisellCustomerBrief name="新客户" subtitle="待完善"/>;
+}
+```
+
+### 密度与布局
+
+- `density`: B1（一行）/ B2（两行）/ B5（五行）/ B9（全部）
+- `layout`: horizontal（横向）/ vertical（竖向）
+
+```tsx
+import {PisellCustomerBrief} from '@pisell/materials';
+
+export default function Demo() {
+    return (
+        <PisellCustomerBrief
+            name="客户名称"
+            email="a@b.com"
+            company="公司名"
+            density="B5"
+            layout="vertical"
+        />
+    );
+}
+```
+
+## API
+
+| 属性             | 说明               | 类型                            | 默认值          |
+|----------------|------------------|-------------------------------|--------------|
+| name           | 客户名称（主文案）        | string                        | -            |
+| subtitle       | 副标题，与主标题同行       | string                        | -            |
+| avatar         | 头像地址，不传则默认占位     | string                        | -            |
+| email          | 邮箱（扩展信息）         | string                        | -            |
+| address        | 地址（扩展信息）         | string                        | -            |
+| company        | 公司（扩展信息）         | string                        | -            |
+| date           | 日期类信息（扩展信息）      | string                        | -            |
+| extendedFields | 自定义扩展字段列表        | CustomerBriefExtendedField[]  | []           |
+| tags           | 标签（如等级、状态）       | EntityCardTagItem[]           | []           |
+| actions        | 操作项              | EntityCardActionItem[]        | []           |
+| showActions    | 是否显示操作区          | boolean                       | false        |
+| showAvatar     | 是否显示头像           | boolean                       | true         |
+| showExtended   | 是否显示扩展信息         | boolean                       | true         |
+| showTags       | 是否显示标签           | boolean                       | true         |
+| density        | 信息密度 B1/B2/B5/B9 | EntityCardDensity             | 'B2'         |
+| layout         | 布局方向             | 'horizontal' \| 'vertical'    | 'horizontal' |
+| width          | 卡片宽度             | 'content' \| 'full' \| number | 'content'    |
+| swipeToDelete  | 是否开启左滑删除         | boolean                       | false        |
+| onDelete       | 左滑删除回调           | () => void                    | -            |
+
+更多样式与插槽见 [types.ts](../types.ts)。

package/lib/components/pisellCustomerBrief/index.d.ts

@@ -0,0 +1,2 @@
+import { CustomerBriefExtendedField, PisellCustomerBriefProps } from "./types.js";
+import { PisellCustomerBrief } from "./PisellCustomerBrief.js";