@pisell/materials 1.0.1057 → 1.0.1059

package/lib/components/PisellContactBrief/PisellContactBrief.stories.js

@@ -0,0 +1,188 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellContactBrief/PisellContactBrief.stories.tsx
+var PisellContactBrief_stories_exports = {};
+__export(PisellContactBrief_stories_exports, {
+  CreateButtonOnly: () => CreateButtonOnly,
+  Default: () => Default,
+  Disabled: () => Disabled,
+  ListWithCreateButton: () => ListWithCreateButton,
+  NoAvatar: () => NoAvatar,
+  NoEmail: () => NoEmail,
+  NoPhone: () => NoPhone,
+  PrimaryLineClamp: () => PrimaryLineClamp,
+  SwipeToDelete: () => SwipeToDelete,
+  Vertical: () => Vertical,
+  WithAvatar: () => WithAvatar,
+  WithEditSubmit: () => WithEditSubmit,
+  WithExtraFields: () => WithExtraFields,
+  default: () => PisellContactBrief_stories_default
+});
+module.exports = __toCommonJS(PisellContactBrief_stories_exports);
+var import_PisellContactBrief = require("./PisellContactBrief");
+var meta = {
+  title: "Data Display/PisellContactBrief",
+  component: import_PisellContactBrief.PisellContactBrief,
+  tags: ["autodocs"],
+  decorators: [
+    (Story) => /* @__PURE__ */ React.createElement("div", { style: { width: 340 } }, /* @__PURE__ */ React.createElement(Story, null))
+  ],
+  argTypes: {
+    layout: {
+      description: "布局方向",
+      control: "radio",
+      options: ["horizontal", "vertical"]
+    },
+    showAvatar: { description: "显示头像", control: "boolean" },
+    showPhone: { description: "显示电话", control: "boolean" },
+    showEmail: { description: "显示邮箱", control: "boolean" },
+    swipeToDelete: { description: "开启左滑删除", control: "boolean" }
+  }
+};
+var PisellContactBrief_stories_default = meta;
+var Default = {
+  args: {
+    name: "Allen King",
+    phone: "+61 412 345 1656",
+    email: "Allenking@pisell.com",
+    layout: "horizontal"
+  }
+};
+var NoAvatar = {
+  args: {
+    name: "Bill Camp",
+    phone: "+86 151 0548 2457",
+    email: "Billcamp@pisell.com",
+    showAvatar: true,
+    avatar: void 0
+  }
+};
+var WithAvatar = {
+  args: {
+    name: "张三",
+    phone: "+86 138 0000 0000",
+    email: "zhangsan@example.com",
+    avatar: "https://ui-avatars.com/api/?name=Zhang+San&background=4a90d9&color=fff&size=32"
+  }
+};
+var Vertical = {
+  args: {
+    name: "Allen King",
+    phone: "+61 412 345 1656",
+    email: "Allenking@pisell.com",
+    layout: "vertical"
+  }
+};
+var NoEmail = {
+  args: {
+    name: "Bill Camp",
+    phone: "(+86 151 0548 2457)",
+    showEmail: false
+  }
+};
+var NoPhone = {
+  args: {
+    name: "Bill Camp",
+    email: "Billcamp@pisell.com",
+    showPhone: false
+  }
+};
+var WithExtraFields = {
+  args: {
+    name: "Bill Camp",
+    phone: "+86 151 0548 2457",
+    email: "Billcamp@pisell.com",
+    extraFields: [
+      { key: "birthday", label: "生日" },
+      { key: "address", label: "地址" }
+    ],
+    extraData: {
+      birthday: "30 July 1990",
+      address: "30 Jersey Parade, suburban, VIC, 3000"
+    }
+  }
+};
+var SwipeToDelete = {
+  args: {
+    name: "Bill Camp",
+    phone: "+86 151 0548 2457",
+    email: "Billcamp@pisell.com",
+    swipeToDelete: true,
+    onDelete: () => console.log("onDelete")
+  }
+};
+var WithEditSubmit = {
+  args: {
+    name: "张三",
+    phone: "138 0000 0000",
+    email: "zhangsan@example.com",
+    onSubmit: (values) => console.log("onSubmit", values)
+  }
+};
+var Disabled = {
+  args: {
+    name: "张三",
+    phone: "138 0000 0000",
+    email: "a@b.com",
+    disabled: true
+  }
+};
+var PrimaryLineClamp = {
+  args: {
+    name: "非常长的联系人姓名用于测试单行省略效果",
+    phone: "138 0000 0000",
+    email: "a@b.com",
+    primaryLineClamp: 1
+  }
+};
+var CreateButtonOnly = {
+  render: () => /* @__PURE__ */ React.createElement(
+    import_PisellContactBrief.PisellContactBrief.CreateButton,
+    {
+      onCreate: (values) => console.log("onCreate", values)
+    }
+  )
+};
+var ListWithCreateButton = {
+  render: () => /* @__PURE__ */ React.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 8, width: 340 } }, /* @__PURE__ */ React.createElement(
+    import_PisellContactBrief.PisellContactBrief,
+    {
+      name: "Allen King",
+      phone: "+61 412 345 1656",
+      email: "Allenking@pisell.com",
+      onSubmit: (v) => console.log("onSubmit", v)
+    }
+  ), /* @__PURE__ */ React.createElement(import_PisellContactBrief.PisellContactBrief.CreateButton, { onCreate: (v) => console.log("onCreate", v) }))
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CreateButtonOnly,
+  Default,
+  Disabled,
+  ListWithCreateButton,
+  NoAvatar,
+  NoEmail,
+  NoPhone,
+  PrimaryLineClamp,
+  SwipeToDelete,
+  Vertical,
+  WithAvatar,
+  WithEditSubmit,
+  WithExtraFields
+});

package/lib/components/PisellContactBrief/components/ContactFormModal.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="react" />
+import type { ContactFormValues } from '../types';
+import type { ContactBriefExtraField } from '../types';
+export declare type ContactFormModalMode = 'create' | 'edit';
+export interface ContactFormModalProps {
+    /** 显隐 */
+    visible: boolean;
+    /** 关闭回调 */
+    onCancel: () => void;
+    /** 提交回调（新建时即 onCreate，编辑时即 onSubmit） */
+    onSubmit: (values: ContactFormValues) => void;
+    /** 新建 / 编辑 */
+    mode: ContactFormModalMode;
+    /** 初始值（编辑时传入） */
+    initialValues?: Partial<ContactFormValues>;
+    /** 可增加字段配置，顺序即表单项顺序 */
+    extraFields?: ContactBriefExtraField[];
+}
+/**
+ * 联系人新建/编辑弹窗
+ * 表单含 Firstname、Lastname、Phone、Email + extraFields，与 Figma 新建/编辑弹窗一致
+ */
+export declare function ContactFormModal({ visible, onCancel, onSubmit, mode, initialValues, extraFields, }: ContactFormModalProps): JSX.Element;

package/lib/components/PisellContactBrief/components/ContactFormModal.js

@@ -0,0 +1,154 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellContactBrief/components/ContactFormModal.tsx
+var ContactFormModal_exports = {};
+__export(ContactFormModal_exports, {
+  ContactFormModal: () => ContactFormModal
+});
+module.exports = __toCommonJS(ContactFormModal_exports);
+var import_react = __toESM(require("react"));
+var import_antd = require("antd");
+var import_utils = require("@pisell/utils");
+var import_pisellSingleLineText = require("../../pisellSingleLineText");
+var import_pisellPhone = require("../../pisellPhone");
+var import_pisellEmail = require("../../pisellEmail");
+var FIRSTNAME_FIELD = "firstname";
+var LASTNAME_FIELD = "lastname";
+var PHONE_FIELD = "phone";
+var EMAIL_FIELD = "email";
+function splitName(name) {
+  if (!name || !name.trim()) return ["", ""];
+  const idx = name.trim().indexOf(" ");
+  if (idx <= 0) return [name.trim(), ""];
+  return [name.trim().slice(0, idx), name.trim().slice(idx + 1)];
+}
+function joinName(first, last) {
+  return [first, last].map((s) => s == null ? void 0 : s.trim()).filter(Boolean).join(" ");
+}
+function ContactFormModal({
+  visible,
+  onCancel,
+  onSubmit,
+  mode,
+  initialValues,
+  extraFields = []
+}) {
+  const [form] = import_antd.Form.useForm();
+  (0, import_react.useEffect)(() => {
+    if (visible) {
+      const [firstname, lastname] = splitName(initialValues == null ? void 0 : initialValues.name);
+      const values = {
+        firstname,
+        lastname,
+        name: (initialValues == null ? void 0 : initialValues.name) ?? "",
+        phone: (initialValues == null ? void 0 : initialValues.phone) ?? "",
+        email: (initialValues == null ? void 0 : initialValues.email) ?? ""
+      };
+      if (initialValues && extraFields.length > 0) {
+        extraFields.forEach((f) => {
+          values[f.key] = initialValues[f.key] ?? "";
+        });
+      }
+      form.setFieldsValue(values);
+    }
+  }, [visible, initialValues, extraFields, form]);
+  const handleOk = async () => {
+    try {
+      const raw = await form.validateFields();
+      const name = joinName(raw.firstname ?? "", raw.lastname ?? "");
+      const values = {
+        name,
+        phone: raw.phone,
+        email: raw.email
+      };
+      extraFields.forEach((f) => {
+        values[f.key] = raw[f.key];
+      });
+      onSubmit(values);
+      form.resetFields();
+      onCancel();
+    } catch {
+    }
+  };
+  const handleCancel = () => {
+    form.resetFields();
+    onCancel();
+  };
+  const title = mode === "create" ? import_utils.locales.getText("pisell.contact.brief.modal.title.create") : import_utils.locales.getText("pisell.contact.brief.modal.title.edit");
+  const okText = import_utils.locales.getText("pisell.contact.brief.modal.save");
+  const cancelText = import_utils.locales.getText("pisell.contact.brief.modal.cancel");
+  return /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Modal,
+    {
+      title,
+      open: visible,
+      onOk: handleOk,
+      onCancel: handleCancel,
+      okText,
+      cancelText,
+      destroyOnClose: true,
+      width: 480,
+      className: "pisell-contact-brief-modal"
+    },
+    /* @__PURE__ */ import_react.default.createElement(import_antd.Form, { form, layout: "vertical", preserve: false, className: "pisell-contact-brief-modal-form" }, /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-contact-brief-modal-form-row" }, /* @__PURE__ */ import_react.default.createElement(
+      import_antd.Form.Item,
+      {
+        name: FIRSTNAME_FIELD,
+        label: import_utils.locales.getText("pisell.contact.brief.modal.field.firstname"),
+        rules: [{ required: true, message: import_utils.locales.getText("pisell.contact.brief.modal.field.required") }],
+        className: "pisell-contact-brief-modal-form-item-half"
+      },
+      /* @__PURE__ */ import_react.default.createElement(import_pisellSingleLineText.PisellSingleLineText, { placeholder: "", mode: "edit" })
+    ), /* @__PURE__ */ import_react.default.createElement(
+      import_antd.Form.Item,
+      {
+        name: LASTNAME_FIELD,
+        label: import_utils.locales.getText("pisell.contact.brief.modal.field.lastname"),
+        className: "pisell-contact-brief-modal-form-item-half"
+      },
+      /* @__PURE__ */ import_react.default.createElement(import_pisellSingleLineText.PisellSingleLineText, { placeholder: "", mode: "edit" })
+    )), /* @__PURE__ */ import_react.default.createElement(import_antd.Form.Item, { name: PHONE_FIELD, label: import_utils.locales.getText("pisell.contact.brief.modal.field.phone") }, /* @__PURE__ */ import_react.default.createElement(
+      import_pisellPhone.PisellPhone,
+      {
+        placeholder: import_utils.locales.getText("pisell.contact.brief.modal.field.phone.placeholder"),
+        mode: "edit"
+      }
+    )), /* @__PURE__ */ import_react.default.createElement(import_antd.Form.Item, { name: EMAIL_FIELD, label: import_utils.locales.getText("pisell.contact.brief.modal.field.email") }, /* @__PURE__ */ import_react.default.createElement(
+      import_pisellEmail.PisellEmail,
+      {
+        placeholder: import_utils.locales.getText("pisell.contact.brief.modal.field.email.placeholder"),
+        mode: "edit"
+      }
+    )), extraFields.map((f) => /* @__PURE__ */ import_react.default.createElement(import_antd.Form.Item, { key: f.key, name: f.key, label: f.label }, /* @__PURE__ */ import_react.default.createElement(import_pisellSingleLineText.PisellSingleLineText, { placeholder: "", mode: "edit" }))))
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContactFormModal
+});

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

@@ -0,0 +1,5 @@
+/**
+ * PisellContactBrief 子组件导出
+ */
+export { ContactFormModal } from './ContactFormModal';
+export type { ContactFormModalProps, ContactFormModalMode } from './ContactFormModal';

package/lib/components/PisellContactBrief/components/index.js

@@ -0,0 +1,29 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellContactBrief/components/index.tsx
+var components_exports = {};
+__export(components_exports, {
+  ContactFormModal: () => import_ContactFormModal.ContactFormModal
+});
+module.exports = __toCommonJS(components_exports);
+var import_ContactFormModal = require("./ContactFormModal");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContactFormModal
+});

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

@@ -0,0 +1,6 @@
+/**
+ * PisellContactBrief 组件导出
+ * 联系人简要卡片 + CreateButton（PisellContactBrief.CreateButton）
+ */
+export { PisellContactBrief } from './PisellContactBrief';
+export type { PisellContactBriefProps, PisellContactBriefCreateButtonProps, PisellContactBriefComponent, ContactFormValues, ContactBriefExtraField, } from './types';

package/lib/components/PisellContactBrief/index.js

@@ -0,0 +1,29 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellContactBrief/index.tsx
+var PisellContactBrief_exports = {};
+__export(PisellContactBrief_exports, {
+  PisellContactBrief: () => import_PisellContactBrief.PisellContactBrief
+});
+module.exports = __toCommonJS(PisellContactBrief_exports);
+var import_PisellContactBrief = require("./PisellContactBrief");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PisellContactBrief
+});

package/lib/components/PisellContactBrief/locales.d.ts

@@ -0,0 +1,55 @@
+/**
+ * PisellContactBrief 多语言文案
+ * 中、英、繁；由业务 locales.init 合并或组件内 init 后使用 locales.getText(key)
+ */
+declare const _default: {
+    en: {
+        'pisell.contact.brief.addContact': string;
+        'pisell.contact.brief.edit': string;
+        'pisell.contact.brief.delete': string;
+        'pisell.contact.brief.modal.title.create': string;
+        'pisell.contact.brief.modal.title.edit': string;
+        'pisell.contact.brief.modal.cancel': string;
+        'pisell.contact.brief.modal.save': string;
+        'pisell.contact.brief.modal.field.firstname': string;
+        'pisell.contact.brief.modal.field.lastname': string;
+        'pisell.contact.brief.modal.field.phone': string;
+        'pisell.contact.brief.modal.field.email': string;
+        'pisell.contact.brief.modal.field.phone.placeholder': string;
+        'pisell.contact.brief.modal.field.email.placeholder': string;
+        'pisell.contact.brief.modal.field.required': string;
+    };
+    'zh-CN': {
+        'pisell.contact.brief.addContact': string;
+        'pisell.contact.brief.edit': string;
+        'pisell.contact.brief.delete': string;
+        'pisell.contact.brief.modal.title.create': string;
+        'pisell.contact.brief.modal.title.edit': string;
+        'pisell.contact.brief.modal.cancel': string;
+        'pisell.contact.brief.modal.save': string;
+        'pisell.contact.brief.modal.field.firstname': string;
+        'pisell.contact.brief.modal.field.lastname': string;
+        'pisell.contact.brief.modal.field.phone': string;
+        'pisell.contact.brief.modal.field.email': string;
+        'pisell.contact.brief.modal.field.phone.placeholder': string;
+        'pisell.contact.brief.modal.field.email.placeholder': string;
+        'pisell.contact.brief.modal.field.required': string;
+    };
+    'zh-HK': {
+        'pisell.contact.brief.addContact': string;
+        'pisell.contact.brief.edit': string;
+        'pisell.contact.brief.delete': string;
+        'pisell.contact.brief.modal.title.create': string;
+        'pisell.contact.brief.modal.title.edit': string;
+        'pisell.contact.brief.modal.cancel': string;
+        'pisell.contact.brief.modal.save': string;
+        'pisell.contact.brief.modal.field.firstname': string;
+        'pisell.contact.brief.modal.field.lastname': string;
+        'pisell.contact.brief.modal.field.phone': string;
+        'pisell.contact.brief.modal.field.email': string;
+        'pisell.contact.brief.modal.field.phone.placeholder': string;
+        'pisell.contact.brief.modal.field.email.placeholder': string;
+        'pisell.contact.brief.modal.field.required': string;
+    };
+};
+export default _default;

package/lib/components/PisellContactBrief/locales.js

@@ -0,0 +1,74 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellContactBrief/locales.ts
+var locales_exports = {};
+__export(locales_exports, {
+  default: () => locales_default
+});
+module.exports = __toCommonJS(locales_exports);
+var locales_default = {
+  en: {
+    "pisell.contact.brief.addContact": "Add Contact",
+    "pisell.contact.brief.edit": "Edit",
+    "pisell.contact.brief.delete": "Delete",
+    "pisell.contact.brief.modal.title.create": "Add Contact",
+    "pisell.contact.brief.modal.title.edit": "Edit Contact",
+    "pisell.contact.brief.modal.cancel": "Cancel",
+    "pisell.contact.brief.modal.save": "Save",
+    "pisell.contact.brief.modal.field.firstname": "Firstname",
+    "pisell.contact.brief.modal.field.lastname": "Lastname",
+    "pisell.contact.brief.modal.field.phone": "Phone number",
+    "pisell.contact.brief.modal.field.email": "Email address",
+    "pisell.contact.brief.modal.field.phone.placeholder": "+1 (555) 000-0000",
+    "pisell.contact.brief.modal.field.email.placeholder": "Enter your email",
+    "pisell.contact.brief.modal.field.required": "Required"
+  },
+  "zh-CN": {
+    "pisell.contact.brief.addContact": "添加联系人",
+    "pisell.contact.brief.edit": "编辑",
+    "pisell.contact.brief.delete": "删除",
+    "pisell.contact.brief.modal.title.create": "新建联系人",
+    "pisell.contact.brief.modal.title.edit": "编辑联系人",
+    "pisell.contact.brief.modal.cancel": "取消",
+    "pisell.contact.brief.modal.save": "保存",
+    "pisell.contact.brief.modal.field.firstname": "名",
+    "pisell.contact.brief.modal.field.lastname": "姓",
+    "pisell.contact.brief.modal.field.phone": "电话",
+    "pisell.contact.brief.modal.field.email": "邮箱",
+    "pisell.contact.brief.modal.field.phone.placeholder": "请输入电话",
+    "pisell.contact.brief.modal.field.email.placeholder": "请输入邮箱",
+    "pisell.contact.brief.modal.field.required": "必填"
+  },
+  "zh-HK": {
+    "pisell.contact.brief.addContact": "添加聯繫人",
+    "pisell.contact.brief.edit": "編輯",
+    "pisell.contact.brief.delete": "刪除",
+    "pisell.contact.brief.modal.title.create": "新建聯繫人",
+    "pisell.contact.brief.modal.title.edit": "編輯聯繫人",
+    "pisell.contact.brief.modal.cancel": "取消",
+    "pisell.contact.brief.modal.save": "保存",
+    "pisell.contact.brief.modal.field.firstname": "名",
+    "pisell.contact.brief.modal.field.lastname": "姓",
+    "pisell.contact.brief.modal.field.phone": "電話",
+    "pisell.contact.brief.modal.field.email": "郵箱",
+    "pisell.contact.brief.modal.field.phone.placeholder": "請輸入電話",
+    "pisell.contact.brief.modal.field.email.placeholder": "請輸入郵箱",
+    "pisell.contact.brief.modal.field.required": "必填"
+  }
+};

package/lib/components/PisellContactBrief/types.d.ts

@@ -0,0 +1,82 @@
+import type React from 'react';
+import type { PisellBaseCardProps } from '../pisellBaseCard/types';
+import type { EntityCardLayout } from '../pisellEntityCard/types';
+/**
+ * 联系人表单值（新建/编辑弹窗提交结构）
+ * 基础字段 name、phone、email + 扩展字段（与 extraFields[].key 对应）扁平在同一对象
+ */
+export interface ContactFormValues {
+    /** 姓名 */
+    name: string;
+    /** 电话 */
+    phone?: string;
+    /** 邮箱 */
+    email?: string;
+    /** 扩展字段及任意表单项，key 与 extraFields 配置对应 */
+    [key: string]: string | undefined;
+}
+/**
+ * 可增加字段配置项
+ * 顺序即卡片展示与弹窗表单项顺序
+ */
+export interface ContactBriefExtraField {
+    /** 字段 key，与 extraData / ContactFormValues 对应 */
+    key: string;
+    /** 展示与表单项 label（可配合多语言） */
+    label: string;
+}
+/**
+ * PisellContactBrief 组件 Props
+ * 基于 PisellEntityCard 展示联系人简要信息，内置编辑弹窗
+ */
+export interface PisellContactBriefProps extends Pick<PisellBaseCardProps, 'className' | 'style' | 'hoverStyle' | 'activeStyle' | 'disabledStyle' | 'clickable' | 'disabled' | 'onClick'> {
+    /** 联系人姓名（主文案） */
+    name: string;
+    /** 电话（副标题，与姓名同行） */
+    phone?: string;
+    /** 邮箱（次级文案） */
+    email?: string;
+    /** 头像图片地址，不传则显示默认占位 */
+    avatar?: string;
+    /** 扩展字段值，key 与 extraFields 配置对应 */
+    extraData?: Record<string, string>;
+    /** 可增加字段配置，顺序即展示与表单顺序 */
+    extraFields?: ContactBriefExtraField[];
+    /** 编辑弹窗提交回调 */
+    onSubmit?: (values: ContactFormValues) => void;
+    /** 左滑删除回调（透传 Entity Card） */
+    onDelete?: () => void;
+    /** 是否开启左滑删除 @default false */
+    swipeToDelete?: boolean;
+    /** 布局方向 @default 'horizontal' */
+    layout?: EntityCardLayout;
+    /** 是否显示头像 @default true */
+    showAvatar?: boolean;
+    /** 是否显示电话 @default true */
+    showPhone?: boolean;
+    /** 是否显示邮箱 @default true */
+    showEmail?: boolean;
+    /** 主文案行数限制 */
+    primaryLineClamp?: number;
+    /** 次级文案行数限制 */
+    secondaryLineClamp?: number;
+}
+/**
+ * PisellContactBrief.CreateButton 组件 Props
+ * 点击后打开新建联系人弹窗
+ */
+export interface PisellContactBriefCreateButtonProps extends Pick<PisellBaseCardProps, 'className' | 'style'> {
+    /** 可增加字段配置，与卡片一致，弹窗内表单项与之对应 */
+    extraFields?: ContactBriefExtraField[];
+    /** 新建弹窗提交回调，调用方保存数据后可更新列表 */
+    onCreate?: (values: ContactFormValues) => void;
+    /** 自定义点击行为；不传则使用内置打开新建弹窗 */
+    onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
+}
+/**
+ * 复合组件类型：PisellContactBrief + CreateButton
+ */
+export interface PisellContactBriefComponent {
+    (props: PisellContactBriefProps): React.ReactElement;
+    CreateButton: React.ComponentType<PisellContactBriefCreateButtonProps>;
+}

package/lib/components/PisellContactBrief/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/PisellContactBrief/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);