@open-feishu-card/renderer 0.2.30 → 0.2.31

package/dist/index.cjs

@@ -671,7 +671,8 @@ function resolveImageSrc(p, ctx) {
   if (p.src) return p.src;
   if (p.url) return resolveURL(p.url) || null;
   if (p.img_url) return p.img_url;
-  if (p.imageID && ctx.options.imageBaseURL) return ctx.options.imageBaseURL + p.imageID;
+  const imageId = p.imageID || p.img_key;
+  if (imageId && ctx.options.imageBaseURL) return ctx.options.imageBaseURL + imageId;
   return null;
 }
 function resolveMediaSrc(p, kind, ctx) {
@@ -701,6 +702,7 @@ function personAvatarSrc(person, ctx) {
     const r = ctx.options.resolvePersonAvatar(person);
     if (r) return r;
   }
+  if (person.avatar_url) return person.avatar_url;
   if (!person.avatar_key) return null;
   const base = ctx.options.avatarBaseURL || PERSON_AVATAR_BASE;
   const suffix = ctx.options.avatarURLSuffix ?? PERSON_AVATAR_SUFFIX;

package/dist/index.d.cts

@@ -81,6 +81,8 @@ interface ElementProperty {
     hoverTips?: CardElement;
     hasBorder?: boolean;
     imageID?: string;
+    /** DSL 公开字段；dslToRaw 常原样留在 property（未改名为 imageID） */
+    img_key?: string;
     origin_key?: string;
     src?: string;
     url?: string | LinkURL;
@@ -291,7 +293,7 @@ interface RenderOptions {
     /** 音视频地址前缀：最终 src = mediaBaseURL + fileID */
     mediaBaseURL?: string;
     /**
-     * 人员表（open_id -> { content 姓名, avatar_key 头像 }）。
+     * 人员表（open_id -> { content 姓名, avatar_key / avatar_url 头像 }）。
      * person_v1 / person_list 元素只带 ID，姓名/头像在此反查。
      * 异步渲染（renderCardToStringAsync）会自动从 json_attachment.persons 填入；
      * 同步渲染若想出名字/头像，需手动传入。缺省时人员降级为固定头像 +「赵天雄」。
@@ -326,7 +328,8 @@ interface RenderOptions {
  * 人员信息：person_v1 / person_list / at 元素只带 ID，姓名与头像 key 在这里。
  * 取自飞书消息 content 的 json_attachment.persons（按 open_id「ou_...」索引）；
  * fetchCardMessage 还会把信封 mentions 与 at_users 合并进来（含 @_user_N 别名键）。
- * avatar_key 是公开可访问的头像图 key（无需鉴权，见 PERSON_AVATAR_BASE）。
+ * avatar_key 是公开可访问的头像图 key（无需鉴权，见 PERSON_AVATAR_BASE）；
+ * 本地预览也可用 avatar_url（含 data URI）直接给头像地址。
  */
 interface PersonInfo {
     person_id?: string;
@@ -335,6 +338,11 @@ interface PersonInfo {
     type?: number;
     /** 头像图 key（形如 v3_00te_...），拼 avatarBaseURL 取图 */
     avatar_key?: string;
+    /**
+     * 直接可用的头像 URL（含 data URI）。
+     * 本地预览虚拟用户没有飞书 avatar_key 时用这个；优先级低于 resolvePersonAvatar，高于 avatar_key。
+     */
+    avatar_url?: string;
 }
 /**
  * 消息信封上的 @ 提及（data.items[0].mentions），不在 body.content 内。

package/dist/index.d.ts

@@ -81,6 +81,8 @@ interface ElementProperty {
     hoverTips?: CardElement;
     hasBorder?: boolean;
     imageID?: string;
+    /** DSL 公开字段；dslToRaw 常原样留在 property（未改名为 imageID） */
+    img_key?: string;
     origin_key?: string;
     src?: string;
     url?: string | LinkURL;
@@ -291,7 +293,7 @@ interface RenderOptions {
     /** 音视频地址前缀：最终 src = mediaBaseURL + fileID */
     mediaBaseURL?: string;
     /**
-     * 人员表（open_id -> { content 姓名, avatar_key 头像 }）。
+     * 人员表（open_id -> { content 姓名, avatar_key / avatar_url 头像 }）。
      * person_v1 / person_list 元素只带 ID，姓名/头像在此反查。
      * 异步渲染（renderCardToStringAsync）会自动从 json_attachment.persons 填入；
      * 同步渲染若想出名字/头像，需手动传入。缺省时人员降级为固定头像 +「赵天雄」。
@@ -326,7 +328,8 @@ interface RenderOptions {
  * 人员信息：person_v1 / person_list / at 元素只带 ID，姓名与头像 key 在这里。
  * 取自飞书消息 content 的 json_attachment.persons（按 open_id「ou_...」索引）；
  * fetchCardMessage 还会把信封 mentions 与 at_users 合并进来（含 @_user_N 别名键）。
- * avatar_key 是公开可访问的头像图 key（无需鉴权，见 PERSON_AVATAR_BASE）。
+ * avatar_key 是公开可访问的头像图 key（无需鉴权，见 PERSON_AVATAR_BASE）；
+ * 本地预览也可用 avatar_url（含 data URI）直接给头像地址。
  */
 interface PersonInfo {
     person_id?: string;
@@ -335,6 +338,11 @@ interface PersonInfo {
     type?: number;
     /** 头像图 key（形如 v3_00te_...），拼 avatarBaseURL 取图 */
     avatar_key?: string;
+    /**
+     * 直接可用的头像 URL（含 data URI）。
+     * 本地预览虚拟用户没有飞书 avatar_key 时用这个；优先级低于 resolvePersonAvatar，高于 avatar_key。
+     */
+    avatar_url?: string;
 }
 /**
  * 消息信封上的 @ 提及（data.items[0].mentions），不在 body.content 内。

package/dist/index.js

@@ -670,7 +670,8 @@ function resolveImageSrc(p, ctx) {
   if (p.src) return p.src;
   if (p.url) return resolveURL(p.url) || null;
   if (p.img_url) return p.img_url;
-  if (p.imageID && ctx.options.imageBaseURL) return ctx.options.imageBaseURL + p.imageID;
+  const imageId = p.imageID || p.img_key;
+  if (imageId && ctx.options.imageBaseURL) return ctx.options.imageBaseURL + imageId;
   return null;
 }
 function resolveMediaSrc(p, kind, ctx) {
@@ -700,6 +701,7 @@ function personAvatarSrc(person, ctx) {
     const r = ctx.options.resolvePersonAvatar(person);
     if (r) return r;
   }
+  if (person.avatar_url) return person.avatar_url;
   if (!person.avatar_key) return null;
   const base = ctx.options.avatarBaseURL || PERSON_AVATAR_BASE;
   const suffix = ctx.options.avatarURLSuffix ?? PERSON_AVATAR_SUFFIX;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-feishu-card/renderer",
-  "version": "0.2.30",
+  "version": "0.2.31",
   "description": "零框架依赖的飞书卡片渲染引擎：Web / DOM / SSR，输入 RAW 或公开 DSL，输出真实 DOM 或 HTML 字符串",
   "type": "module",
   "main": "./dist/index.cjs",