@open-feishu-card/adapter 0.2.1 → 0.3.1

package/dist/index.cjs

@@ -642,6 +642,10 @@ function convertHeader(header) {
   const property = {};
   for (const [k, v] of Object.entries(header)) {
     if (k === "tag") continue;
+    if (k === "title" || k === "subtitle") {
+      property[k] = wrapHeaderText(v);
+      continue;
+    }
     if (TEXT_LEAF_KEYS.has(k)) {
       property[k] = wrapTextLeaf(v);
       continue;
@@ -806,6 +810,22 @@ function wrapTextLeaf(v) {
   }
   return { tag: "plain_text", property: { content: "" } };
 }
+function wrapHeaderText(v) {
+  if (typeof v === "string") return { tag: "plain_text", property: { content: v } };
+  if (!isRecord(v)) return { tag: "plain_text", property: { content: "" } };
+  const tag = typeof v.tag === "string" ? v.tag : "plain_text";
+  const content = typeof v.content === "string" ? v.content : "";
+  if (tag === "lark_md" || tag === "markdown") {
+    return {
+      tag: "markdown",
+      property: {
+        elements: parseMarkdown(content),
+        originTag: "lark_md"
+      }
+    };
+  }
+  return wrapTextLeaf(v);
+}
 function behaviorsToActions(behaviors) {
   const out = [];
   for (const b of behaviors) {
@@ -849,203 +869,1000 @@ function isRecord(v) {
 }
 
 // src/raw-to-dsl.ts
-var CAMEL_RENAME = {
-  textAlign: "text_align",
-  textStyle: "text_style",
-  backgroundStyle: "background_style",
-  backgroundColor: "background_color",
-  userID: "user_id",
-  showAvatar: "show_avatar",
-  showName: "show_name",
-  hasBorder: "has_border",
-  hoverTips: "hover_tips",
-  pillShaped: "pill_shaped",
-  tagStyle: "tag_style",
-  scaleType: "scale_type",
-  dropInvalidUserID: "drop_invalid_user_id",
-  udIcon: "ud_icon",
-  // video / audio
-  fileID: "file_key",
-  coverImageID: "image_key",
-  showTime: "show_time",
-  enableDownload: "enable_download",
-  audioID: "audio_id",
-  showProgressBar: "show_progress_bar",
-  fillColor: "fill_color"
-};
-var KNOWN_TAGS = /* @__PURE__ */ new Set([
-  "markdown",
-  "lark_md",
-  "div",
-  "column_set",
-  "column",
-  "hr",
-  "image",
-  "img",
-  "button",
-  "overflow",
-  "select_static",
-  "select_multi",
-  "input",
-  "date_picker",
-  "picker_time",
-  "picker_date",
-  "checker",
-  "chart",
-  "table",
-  "iframe",
-  "person",
-  "person_list",
-  "interactive_container",
-  "tag",
-  "text_tag",
-  "multi_image",
-  "plain_text",
-  "lark_md_inline",
-  "image_text",
-  "carousel",
-  "grid",
-  "speaking",
-  "vote",
-  "lottery",
-  "calender",
-  "schedule",
-  "share_chat",
-  "share_user",
-  "add_on",
-  "whole_text",
-  "cropper_image",
-  "highlight",
-  "local_file",
-  "file_preview",
-  "input_select",
-  "picker_datetime",
-  "picker_multi",
-  "rule",
-  "statistic",
-  "task",
-  "card_header",
-  "body",
-  "audio",
-  "video",
-  "markdown_audio",
-  "unknown"
-]);
-function isRecord2(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-function degradeUnknown(el) {
-  const rawTag = typeof el.tag === "string" ? el.tag : "undefined";
-  return { tag: "unknown", raw_tag: rawTag, fallback: el };
+function isRawCardEnvelope(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return typeof v.json_card === "string" && typeof v.card_schema === "number";
 }
-function rawToDsl(raw) {
-  let card = {};
-  if (isRecord2(raw)) {
-    const env = isRecord2(raw.json_card) ? raw.json_card : isRecord2(raw.card) ? raw.card : raw;
-    if (isRecord2(env)) card = env;
+function rawCardToDsl(envelope) {
+  if (!isRawCardEnvelope(envelope)) return envelope;
+  const env = envelope;
+  let inner;
+  try {
+    inner = JSON.parse(env.json_card ?? "");
+  } catch {
+    return envelope;
   }
-  const out = {
-    schema: typeof card.schema === "string" ? card.schema : "2.0"
+  const ctx = {
+    images: env.json_attachment?.images ?? {},
+    atUsers: env.json_attachment?.at_users ?? {}
   };
-  if (isRecord2(card.config)) out.config = card.config;
-  if (isRecord2(card.header)) out.header = convertHeaderToDsl(card.header);
-  if (isRecord2(card.body)) out.body = convertBodyToDsl(card.body);
-  else if (Array.isArray(card.elements)) {
-    out.body = { elements: card.elements.map(convertElToDsl).filter(Boolean) };
+  return convertRoot(inner, ctx);
+}
+var RAW_ONLY_FIELDS = /* @__PURE__ */ new Set([
+  "new_body",
+  "source",
+  // Editor line-count mirror on markdown/plain_text. Schema 2.0 has no `lines`
+  // field; Feishu rejects it with code 200621 ("unknown property, property:
+  // lines"). Raw emits it on every text node (lines:0), so drop it everywhere.
+  "lines"
+]);
+function isI18nMirror(key) {
+  return key.startsWith("i18n");
+}
+var IMG_RAW_ONLY_FIELDS = /* @__PURE__ */ new Set([
+  "compact_width",
+  "custom_width",
+  "mode"
+]);
+var VIDEO_RAW_ONLY_FIELDS = /* @__PURE__ */ new Set([
+  // duration lives on im.file.create upload, not on the video component.
+  "duration",
+  "duration_ms",
+  // editor instance id — public audio has audio_id, video does NOT have video_id.
+  "video_id"
+]);
+var VIDEO_PUBLIC_FIELDS = /* @__PURE__ */ new Set([
+  "element_id",
+  "margin",
+  "file_key",
+  "i18n_file_key",
+  "enable_download",
+  "show_time",
+  "cover",
+  "hover_tips",
+  "fallback"
+]);
+var AUDIO_PUBLIC_FIELDS = /* @__PURE__ */ new Set([
+  "element_id",
+  "margin",
+  "file_key",
+  "i18n_file_key",
+  "audio_id",
+  "disabled",
+  "disabled_tips",
+  "show_progress_bar",
+  "show_time",
+  "time_display",
+  "time_position",
+  "border",
+  "style",
+  "padding",
+  "background_style",
+  "fill_color",
+  "width",
+  "fallback"
+]);
+var TAG_DEFAULT_DROPS = {
+  column: {
+    disabled: false
+  },
+  column_set: {
+    disabled: false,
+    horizontal_spacing: "default"
+  },
+  button: {
+    disabled: false
+  },
+  interactive_container: {
+    disabled: false,
+    required: false,
+    has_border: false,
+    height: "auto"
   }
+};
+var VALUE_ECHO_TARGETS = {
+  horizontal_spacing_value: "horizontal_spacing",
+  vertical_spacing_value: "vertical_spacing",
+  width_value: "width",
+  height_value: "height",
+  corner_radius_value: "corner_radius",
+  size_value: "size"
+};
+function convertRoot(root, ctx) {
+  if (!isRecord2(root)) return root;
+  const out = {};
+  out.schema = typeof root.schema === "string" ? root.schema : "2.0";
+  out.config = convertConfig(isRecord2(root.config) ? root.config : {});
+  if (isRecord2(root.body)) out.body = convertBody2(root.body, ctx);
+  if (isRecord2(root.header)) out.header = convertHeader2(root.header, ctx);
   return out;
 }
-function convertHeaderToDsl(header) {
-  const property = isRecord2(header.property) ? header.property : header;
-  const out = {};
-  for (const [k, v] of Object.entries(property)) {
-    if (k === "ud_icon" || k === "udIcon") {
-      if (isRecord2(v) && typeof v.tag === "string") {
-        out.ud_icon = convertElToDsl(v);
-        continue;
+function convertConfig(_node) {
+  return { update_multi: true };
+}
+function convertHeader2(node, ctx) {
+  const property = isRecord2(node.property) ? node.property : node;
+  const out = convertProperty(property, "header", ctx);
+  delete out.tag;
+  return out;
+}
+function convertHeaderText(rawValue, ctx) {
+  const tag = typeof rawValue.tag === "string" ? rawValue.tag : "";
+  const wrapped = isRecord2(rawValue.property);
+  const property = wrapped ? rawValue.property : rawValue;
+  if (tag === "plain_text") {
+    const content = typeof property.content === "string" ? property.content : "";
+    return { tag: "plain_text", content };
+  }
+  if (tag === "markdown" || tag === "lark_md") {
+    if (wrapped && Array.isArray(property.elements)) {
+      const rebuilt = rebuildMarkdown(property, ctx);
+      return { tag: "lark_md", content: typeof rebuilt.content === "string" ? rebuilt.content : "" };
+    }
+    const content = typeof property.content === "string" ? property.content : "";
+    return { tag: "lark_md", content };
+  }
+  if (!wrapped && typeof rawValue.content === "string" && !tag) {
+    return { tag: "plain_text", content: rawValue.content };
+  }
+  return void 0;
+}
+function convertBody2(node, ctx) {
+  const property = isRecord2(node.property) ? node.property : node;
+  return convertProperty(property, "body", ctx);
+}
+function unwrap(node, ctx) {
+  const tag = typeof node.tag === "string" ? node.tag : void 0;
+  const property = isRecord2(node.property) ? node.property : {};
+  if (tag === "markdown") return rebuildMarkdown(property, ctx);
+  if (tag === "plain_text") {
+    const content = typeof property.content === "string" ? property.content : "";
+    return { tag: "plain_text", content };
+  }
+  if (tag === "standard_icon") {
+    const out = { tag: "standard_icon" };
+    if (typeof property.token === "string") out.token = property.token;
+    if (typeof property.color === "string") out.color = property.color;
+    const widthPx = isPixelScalar(property.widthValue) ? pixelOf(property.widthValue) : void 0;
+    const heightPx = isPixelScalar(property.heightValue) ? pixelOf(property.heightValue) : void 0;
+    if (widthPx !== void 0 && heightPx !== void 0) {
+      out.size = `${widthPx}px ${heightPx}px`;
+    } else if (isRecord2(property.size) && hasSide(property.size)) out.size = formatBox(property.size);
+    else if (isPixelScalar(property.size)) out.size = `${pixelOf(property.size)}px`;
+    else if (typeof property.size === "string") out.size = property.size;
+    return out;
+  }
+  if (tag === "ud_icon") {
+    const token = typeof property.token === "string" ? property.token : void 0;
+    const out = { tag: "standard_icon" };
+    if (token) out.token = token;
+    return out;
+  }
+  if (tag === "chart") {
+    const out = { tag: "chart" };
+    if (typeof property.colorTheme === "string") out.color_theme = property.colorTheme;
+    if (typeof property.preview === "boolean") out.preview = property.preview;
+    if (property.chartSpec !== void 0) out.chart_spec = property.chartSpec;
+    return out;
+  }
+  if (tag === "table") {
+    const out = { tag: "table" };
+    const rawColumns = Array.isArray(property.columns) ? property.columns : [];
+    out.columns = rawColumns.map((col) => {
+      if (!isRecord2(col)) return {};
+      const c = {};
+      if (typeof col.name === "string") c.name = col.name;
+      const displayName = typeof col.displayName === "string" ? col.displayName : typeof col.display_name === "string" ? col.display_name : void 0;
+      if (displayName !== void 0) c.display_name = displayName;
+      const dataType = typeof col.dataType === "string" ? col.dataType : typeof col.data_type === "string" ? col.data_type : void 0;
+      if (dataType !== void 0) c.data_type = dataType;
+      const hAlign = typeof col.horizontalAlign === "string" ? col.horizontalAlign : typeof col.horizontal_align === "string" ? col.horizontal_align : void 0;
+      if (hAlign !== void 0) c.horizontal_align = hAlign;
+      const wv = col.widthValue;
+      if (isRecord2(wv)) {
+        if (wv.type === "pixels" && typeof wv.value === "number") c.width = `${wv.value}px`;
+        else if (typeof wv.value === "string") c.width = wv.value;
+      } else if (typeof col.width === "string" || typeof col.width === "number") {
+        c.width = col.width;
+      }
+      if (isRecord2(col.format)) c.format = col.format;
+      return c;
+    });
+    const rawRows = Array.isArray(property.rows) ? property.rows : [];
+    out.rows = rawRows.map((row) => {
+      if (!isRecord2(row)) return {};
+      const r = {};
+      for (const [k, cell] of Object.entries(row)) {
+        let value = isRecord2(cell) && "data" in cell ? cell.data : cell;
+        if (isRecord2(value) && value.tag === "markdown" && isRecord2(value.property)) {
+          const elements = Array.isArray(value.property.elements) ? value.property.elements : [];
+          value = renderChildren(elements, ctx);
+        }
+        r[k] = value;
       }
+      return r;
+    });
+    if (isRecord2(property.headerStyle)) {
+      const hs = {};
+      for (const [k, v] of Object.entries(property.headerStyle)) {
+        const sk = snake(k);
+        if (sk === "platform_text_size") continue;
+        if (sk === "lines_value") {
+          if (isRecord2(v) && typeof v.value === "number") hs.lines = v.value;
+          continue;
+        }
+        hs[sk] = v;
+      }
+      out.header_style = hs;
     }
-    out[CAMEL_RENAME[k] ?? k] = unwrapTextLeaf(v);
+    const rhv = property.rowHeightValue;
+    if (isRecord2(rhv) && typeof rhv.value === "string") out.row_height = rhv.value;
+    else if (typeof property.rowHeight === "string") out.row_height = property.rowHeight;
+    if (typeof property.pageSize === "number") out.page_size = property.pageSize;
+    if (typeof property.freezeFirstColumn === "boolean") out.freeze_first_column = property.freezeFirstColumn;
+    return out;
   }
-  return out;
+  if (tag === "input") {
+    const allow = /* @__PURE__ */ new Set([
+      "name",
+      "placeholder",
+      "default_value",
+      "value",
+      "label",
+      "label_position",
+      "margin",
+      "max_length",
+      "input_type",
+      "width"
+    ]);
+    const out = { tag: "input" };
+    const converted2 = convertProperty(property, "input", ctx);
+    for (const [k, v] of Object.entries(converted2)) {
+      if (allow.has(k)) out[k] = v;
+    }
+    if (converted2.required === true) out.required = true;
+    return out;
+  }
+  if (tag === "person" || tag === "person_v1") {
+    const out = { tag: "person" };
+    if (typeof property.userID === "string") out.user_id = property.userID;
+    else if (typeof property.user_id === "string") out.user_id = property.user_id;
+    if (typeof property.size === "string") out.size = property.size;
+    if (typeof property.showAvatar === "boolean") out.show_avatar = property.showAvatar;
+    if (typeof property.showName === "boolean") out.show_name = property.showName;
+    if (typeof property.style === "string") out.style = property.style;
+    if (isRecord2(property.margin) && hasSide(property.margin)) out.margin = formatBox(property.margin);
+    else if (typeof property.margin === "string") out.margin = property.margin;
+    return out;
+  }
+  if (tag === "person_list") {
+    const out = { tag: "person_list" };
+    if (typeof property.size === "string") out.size = property.size;
+    if (typeof property.showAvatar === "boolean") out.show_avatar = property.showAvatar;
+    if (typeof property.showName === "boolean") out.show_name = property.showName;
+    if (typeof property.lines === "number") out.lines = property.lines;
+    if (typeof property.dropInvalidUserID === "boolean") out.drop_invalid_user_id = property.dropInvalidUserID;
+    else if (typeof property.drop_invalid_user_id === "boolean") out.drop_invalid_user_id = property.drop_invalid_user_id;
+    if (isRecord2(property.margin) && hasSide(property.margin)) out.margin = formatBox(property.margin);
+    else if (typeof property.margin === "string") out.margin = property.margin;
+    const rawPersons = Array.isArray(property.persons) ? property.persons : [];
+    out.persons = rawPersons.map((p) => {
+      if (!isRecord2(p)) return void 0;
+      const id = typeof p.id === "string" ? p.id : typeof p.userID === "string" ? p.userID : void 0;
+      return id ? { id } : void 0;
+    }).filter((p) => p !== void 0);
+    const iconSrc = isRecord2(property.icon) ? property.icon : isRecord2(property.udIcon) ? property.udIcon : void 0;
+    if (iconSrc) {
+      const ip = isRecord2(iconSrc.property) ? iconSrc.property : iconSrc;
+      const icon = {};
+      const iconTag = typeof iconSrc.tag === "string" ? iconSrc.tag : typeof ip.tag === "string" ? ip.tag : "standard_icon";
+      icon.tag = iconTag === "ud_icon" ? "standard_icon" : iconTag;
+      if (typeof ip.token === "string") icon.token = ip.token;
+      if (typeof ip.color === "string") icon.color = ip.color;
+      if (typeof ip.imageID === "string") icon.img_key = ip.imageID;
+      else if (typeof ip.img_key === "string") icon.img_key = ip.img_key;
+      if (icon.token !== void 0 || icon.img_key !== void 0) out.icon = icon;
+    }
+    return out;
+  }
+  if (tag === "div" && isRecord2(property.text) && property.fields === void 0) {
+    const text = property.text;
+    const textTag = typeof text.tag === "string" ? text.tag : "";
+    if ((textTag === "markdown" || textTag === "lark_md") && isRecord2(text.property)) {
+      return unwrap(text, ctx);
+    }
+    if (textTag === "plain_text") {
+      const out = { tag: "div" };
+      const widthVal = property.widthValue;
+      if (isRecord2(widthVal) && typeof widthVal.value === "string" && typeof widthVal.type === "string" && widthVal.type.startsWith("builtin_")) {
+        out.width = widthVal.value;
+      } else if (typeof property.width === "string") {
+        out.width = property.width;
+      }
+      const tp = isRecord2(text.property) ? text.property : {};
+      const content = typeof tp.content === "string" ? tp.content : "";
+      const textAlign = typeof tp.textAlign === "string" ? tp.textAlign : "left";
+      out.text = { tag: "plain_text", content, text_align: textAlign };
+      if (isRecord2(property.icon)) {
+        out.icon = unwrap(property.icon, ctx);
+      }
+      return out;
+    }
+  }
+  const converted = convertProperty(property, tag, ctx);
+  return tag ? { tag, ...converted } : converted;
 }
-function convertBodyToDsl(body) {
-  const property = isRecord2(body.property) ? body.property : body;
+var DROP = /* @__PURE__ */ Symbol("drop");
+function convertProperty(property, ownerTag, ctx) {
   const out = {};
-  for (const [k, v] of Object.entries(property)) {
-    if (k === "elements" && Array.isArray(v)) {
-      out.elements = v.map(convertElToDsl).filter(Boolean);
+  const siblings = {
+    buttonActionType: ownerTag === "button" && typeof property.actionType === "string" ? property.actionType : void 0
+  };
+  for (const [rawKey, rawValue] of Object.entries(property)) {
+    const result = convertField(rawKey, rawValue, ownerTag, ctx, siblings);
+    if (result === DROP) continue;
+    const [outKey, outValue] = result;
+    if (outValue === DROP) continue;
+    out[outKey] = outValue;
+  }
+  for (const [echoKey, enumKey] of Object.entries(VALUE_ECHO_TARGETS)) {
+    if (!(echoKey in out)) continue;
+    const echoVal = out[echoKey];
+    const enumVal = out[enumKey];
+    delete out[echoKey];
+    if (!isRecord2(echoVal)) continue;
+    const echoType = typeof echoVal.type === "string" ? echoVal.type : "";
+    const echoValue = echoVal.value;
+    if (echoType.includes("pixels") && typeof echoValue === "number") {
+      if (enumVal === void 0 || enumVal === "default" || enumVal === "auto" || enumVal === "weighted") {
+        out[enumKey] = `${echoValue}px`;
+      }
+      continue;
+    }
+    if (echoType === "aspect_ratio" && isRecord2(echoValue)) {
+      const w = echoValue.width;
+      const h = echoValue.height;
+      if (typeof w === "number" && typeof h === "number") {
+        out["size"] = `${w}:${h}`;
+      }
       continue;
     }
-    if (isRecord2(v) && typeof v.tag === "string") {
-      out[CAMEL_RENAME[k] ?? k] = convertElToDsl(v);
+    if (echoType === "width_height_pixels" && isRecord2(echoValue)) {
+      const w = echoValue.width;
+      const h = echoValue.height;
+      if (typeof w === "number" && typeof h === "number") {
+        out["size"] = `${w}px ${h}px`;
+      }
       continue;
     }
-    if (Array.isArray(v)) {
-      out[CAMEL_RENAME[k] ?? k] = v.map((item) => isRecord2(item) && typeof item.tag === "string" ? convertElToDsl(item) : item);
+    if (echoType === "builtin_image_size") continue;
+    if (echoType.startsWith("builtin_") && typeof echoValue === "string") {
+      if (enumVal === void 0) out[enumKey] = echoValue;
       continue;
     }
-    out[CAMEL_RENAME[k] ?? k] = unwrapBox(v);
+  }
+  if (ownerTag && TAG_DEFAULT_DROPS[ownerTag]) {
+    const defaults = TAG_DEFAULT_DROPS[ownerTag];
+    for (const [k, defVal] of Object.entries(defaults)) {
+      if (out[k] === defVal) delete out[k];
+    }
+  }
+  if (ownerTag === "video") {
+    for (const k of Object.keys(out)) {
+      if (!VIDEO_PUBLIC_FIELDS.has(k)) delete out[k];
+    }
+  }
+  if (ownerTag === "audio") {
+    for (const k of Object.keys(out)) {
+      if (!AUDIO_PUBLIC_FIELDS.has(k)) delete out[k];
+    }
   }
   return out;
 }
-function convertElToDsl(el) {
-  if (!isRecord2(el)) return void 0;
-  const tag = typeof el.tag === "string" ? el.tag : "";
-  if (!tag) return void 0;
-  if (!KNOWN_TAGS.has(tag)) return degradeUnknown(el);
-  if ("fallback" in el && isRecord2(el.fallback)) return el;
-  const property = isRecord2(el.property) ? el.property : {};
-  const out = {};
-  if (tag !== "plain_text") out.tag = tag === "img" ? "image" : tag;
-  for (const [k, v] of Object.entries(property)) {
-    const key = CAMEL_RENAME[k] ?? k;
-    if (k === "elements" && Array.isArray(v)) {
-      if (tag === "markdown") {
-        out.content = elementsToMarkdown(v);
-        continue;
+function convertField(rawKey, rawValue, ownerTag, ctx, siblings = {}) {
+  if (rawKey === "originTag" || rawKey === "markdownElements") return DROP;
+  const key = snake(rawKey);
+  if (RAW_ONLY_FIELDS.has(key)) return DROP;
+  if (isI18nMirror(key)) return DROP;
+  if (key === "actions" && Array.isArray(rawValue) && rawValue.length === 0) {
+    return DROP;
+  }
+  if ((key === "padding" || key === "margin") && isRecord2(rawValue) && hasSide(rawValue)) {
+    return [key, formatBox(rawValue)];
+  }
+  if (key in VALUE_ECHO_TARGETS) {
+    return [key, rawValue];
+  }
+  if (isPixelScalar(rawValue)) {
+    return [key, `${pixelOf(rawValue)}px`];
+  }
+  if (ownerTag === "img" && key === "image_id") {
+    const id = typeof rawValue === "string" || typeof rawValue === "number" ? String(rawValue) : void 0;
+    const origin = id !== void 0 ? ctx.images[id]?.origin_key : void 0;
+    if (origin) return ["img_key", origin];
+    return [key, rawValue];
+  }
+  if (ownerTag === "img" && IMG_RAW_ONLY_FIELDS.has(key)) return DROP;
+  if (ownerTag === "video" && key === "cover_image_id") {
+    const imgKey = resolveAttachmentImgKey(rawValue, ctx);
+    if (!imgKey) return DROP;
+    return ["cover", { img_key: imgKey }];
+  }
+  if (ownerTag === "video" && key === "cover") {
+    const cover = normalizeVideoCover(rawValue, ctx);
+    return cover ? ["cover", cover] : DROP;
+  }
+  if ((ownerTag === "video" || ownerTag === "audio") && key === "file_id") {
+    if (typeof rawValue === "string" && rawValue) return ["file_key", rawValue];
+    return DROP;
+  }
+  if (ownerTag === "video" && VIDEO_RAW_ONLY_FIELDS.has(key)) return DROP;
+  if ((key === "alt" || key === "hover_tips") && isRecord2(rawValue) && rawValue.tag === "plain_text") {
+    const p = isRecord2(rawValue.property) ? rawValue.property : {};
+    return [key, { tag: "plain_text", content: typeof p.content === "string" ? p.content : "" }];
+  }
+  if (key === "text" && isRecord2(rawValue) && rawValue.tag === "plain_text") {
+    const p = isRecord2(rawValue.property) ? rawValue.property : {};
+    return [key, { tag: "plain_text", content: typeof p.content === "string" ? p.content : "" }];
+  }
+  if (ownerTag === "header" && (key === "title" || key === "subtitle") && isRecord2(rawValue)) {
+    const headerText = convertHeaderText(rawValue, ctx);
+    if (headerText) return [key, headerText];
+  }
+  if (ownerTag === "header" && key === "ud_icon" && isRecord2(rawValue) && rawValue.tag === "ud_icon") {
+    const p = isRecord2(rawValue.property) ? rawValue.property : {};
+    const token = typeof p.token === "string" ? p.token : void 0;
+    if (!token) return DROP;
+    return ["icon", { tag: "standard_icon", token }];
+  }
+  if (ownerTag === "collapsible_panel" && key === "header" && isRecord2(rawValue)) {
+    const cleaned = {};
+    for (const [k, v] of Object.entries(rawValue)) {
+      const sk = snake(k);
+      if (sk === "position" || sk === "width" || sk === "vertical_align") continue;
+      const sub = convertField(k, v, "collapsible_panel_header", ctx, siblings);
+      if (sub === DROP) continue;
+      const [subKey, subVal] = sub;
+      if (subVal === DROP) continue;
+      cleaned[subKey] = subVal;
+    }
+    return [key, cleaned];
+  }
+  if (ownerTag === "button" && key === "action_type") return DROP;
+  if (ownerTag === "button" && key === "actions" && Array.isArray(rawValue)) {
+    const openUrls = [];
+    for (const a of rawValue) {
+      if (!isRecord2(a)) continue;
+      const inner = isRecord2(a.action) ? a.action : {};
+      const t = typeof a.type === "string" ? a.type : void 0;
+      if (t === "open_url" && typeof inner.url === "string") openUrls.push(inner.url);
+    }
+    if (openUrls.length === 0) return DROP;
+    if (siblings.buttonActionType === "link") {
+      return ["multi_url", { url: openUrls[0] }];
+    }
+    return [
+      "behaviors",
+      openUrls.map((url) => ({ type: "open_url", default_url: url }))
+    ];
+  }
+  if (ownerTag === "interactive_container" && key === "actions" && Array.isArray(rawValue)) {
+    const behaviors = rawValue.map((a) => {
+      if (!isRecord2(a)) return void 0;
+      const inner = isRecord2(a.action) ? a.action : {};
+      const t = typeof a.type === "string" ? a.type : void 0;
+      if (t === "open_url" && typeof inner.url === "string") {
+        return { type: "open_url", default_url: inner.url };
       }
-      out.elements = v.map(convertElToDsl).filter(Boolean);
-      continue;
+      if (t === "callback") {
+        return { type: "callback", value: inner.value ?? {} };
+      }
+      return void 0;
+    }).filter((b) => b !== void 0);
+    if (behaviors.length === 0) return DROP;
+    return ["behaviors", behaviors];
+  }
+  if (key === "border" && isRecord2(rawValue)) {
+    const b = rawValue;
+    const out = {};
+    if (typeof b.borderColor === "string") out.color = b.borderColor;
+    else if (typeof b.color === "string") out.color = b.color;
+    if (isPixelScalar(b.cornerRadius)) out.corner_radius = `${pixelOf(b.cornerRadius)}px`;
+    else if (typeof b.cornerRadius === "string") out.corner_radius = b.cornerRadius;
+    else if (b.cornerRadius !== void 0) out.corner_radius = b.cornerRadius;
+    for (const [bk, bv] of Object.entries(b)) {
+      if (bk === "borderColor" || bk === "cornerRadius" || bk === "color") continue;
+      out[snake(bk)] = convertGeneric(bv, ctx);
     }
-    if (k === "columns" && Array.isArray(v)) {
-      out.columns = v.map(convertElToDsl).filter(Boolean);
+    return [key, out];
+  }
+  if (key === "url" && isRecord2(rawValue)) {
+    const v = rawValue;
+    const main = typeof v.url === "string" ? v.url : "";
+    const others = ["androidURL", "iosURL", "pcURL", "harmonyURL"].map((k) => v[k]).filter((x) => typeof x === "string" && x.length > 0);
+    if (others.length === 0) return [key, main];
+    return [
+      key,
+      {
+        url: main,
+        android_url: typeof v.androidURL === "string" ? v.androidURL : "",
+        ios_url: typeof v.iosURL === "string" ? v.iosURL : "",
+        pc_url: typeof v.pcURL === "string" ? v.pcURL : ""
+      }
+    ];
+  }
+  return [key, convertGeneric(rawValue, ctx)];
+}
+function renderInlinePerson(prop) {
+  const id = typeof prop.userID === "string" ? prop.userID : typeof prop.user_id === "string" ? prop.user_id : typeof prop.id === "string" ? prop.id : "";
+  if (!id) return "";
+  const parts = [`id='${id}'`];
+  if (typeof prop.showName === "boolean") parts.push(`show_name=${prop.showName}`);
+  else if (typeof prop.show_name === "boolean") parts.push(`show_name=${prop.show_name}`);
+  if (typeof prop.showAvatar === "boolean") parts.push(`show_avatar=${prop.showAvatar}`);
+  else if (typeof prop.show_avatar === "boolean") parts.push(`show_avatar=${prop.show_avatar}`);
+  if (typeof prop.style === "string") parts.push(`style='${prop.style}'`);
+  return `<person ${parts.join(" ")}></person>`;
+}
+function renderInlineAudio(prop) {
+  const fileKey = typeof prop.fileID === "string" ? prop.fileID : typeof prop.file_key === "string" ? prop.file_key : typeof prop.file_id === "string" ? prop.file_id : "";
+  if (!fileKey) return "";
+  const attrs = [`file_key='${fileKey}'`];
+  const audioId = typeof prop.audioID === "string" ? prop.audioID : typeof prop.audio_id === "string" ? prop.audio_id : void 0;
+  if (audioId) attrs.push(`audio_id='${audioId}'`);
+  if (prop.showTime === true || prop.show_time === true) attrs.push("show_time=true");
+  const style = typeof prop.style === "string" ? prop.style : void 0;
+  if (style) attrs.push(`style='${style}'`);
+  const bg = typeof prop.backgroundColor === "string" ? prop.backgroundColor : typeof prop.background_color === "string" ? prop.background_color : void 0;
+  if (bg) attrs.push(`background_color='${bg}'`);
+  const fill = typeof prop.fillColor === "string" ? prop.fillColor : typeof prop.fill_color === "string" ? prop.fill_color : void 0;
+  if (fill) attrs.push(`fill_color='${fill}'`);
+  const urlObj = isRecord2(prop.url) ? prop.url : void 0;
+  if (urlObj) {
+    if (typeof urlObj.url === "string" && urlObj.url) attrs.push(`fallback_url='${urlObj.url}'`);
+    if (typeof urlObj.pcURL === "string" && urlObj.pcURL) attrs.push(`fallback_pc_url='${urlObj.pcURL}'`);
+    else if (typeof urlObj.pc_url === "string" && urlObj.pc_url) attrs.push(`fallback_pc_url='${urlObj.pc_url}'`);
+    if (typeof urlObj.iosURL === "string" && urlObj.iosURL) attrs.push(`fallback_ios_url='${urlObj.iosURL}'`);
+    else if (typeof urlObj.ios_url === "string" && urlObj.ios_url) attrs.push(`fallback_ios_url='${urlObj.ios_url}'`);
+    if (typeof urlObj.androidURL === "string" && urlObj.androidURL) attrs.push(`fallback_android_url='${urlObj.androidURL}'`);
+    else if (typeof urlObj.android_url === "string" && urlObj.android_url) attrs.push(`fallback_android_url='${urlObj.android_url}'`);
+    if (typeof urlObj.harmonyURL === "string" && urlObj.harmonyURL) attrs.push(`fallback_harmony_url='${urlObj.harmonyURL}'`);
+    else if (typeof urlObj.harmony_url === "string" && urlObj.harmony_url) attrs.push(`fallback_harmony_url='${urlObj.harmony_url}'`);
+  } else if (typeof prop.fallback_url === "string" && prop.fallback_url) {
+    attrs.push(`fallback_url='${prop.fallback_url}'`);
+  }
+  const fb = isRecord2(prop.fallbackText) ? prop.fallbackText : isRecord2(prop.fallback_text) ? prop.fallback_text : void 0;
+  if (fb) {
+    const fbProp = isRecord2(fb.property) ? fb.property : fb;
+    const fbContent = typeof fbProp.content === "string" ? fbProp.content : typeof fb.content === "string" ? fb.content : "";
+    if (fbContent) attrs.push(`fallback_text='${fbContent}'`);
+  }
+  return `<audio ${attrs.join(" ")}></audio>`;
+}
+function resolveAtUserId(prop, ctx) {
+  if (typeof prop.userID === "string" && prop.userID) return prop.userID;
+  if (typeof prop.userId === "string" && prop.userId) return prop.userId;
+  if (typeof prop.user_id === "string" && prop.user_id) return prop.user_id;
+  const key = typeof prop.atUserKey === "string" ? prop.atUserKey : typeof prop.at_user_key === "string" ? prop.at_user_key : void 0;
+  if (!key || !ctx.atUsers[key]) return void 0;
+  if (/^(ou_|on_)/.test(key)) return key;
+  return ctx.atUsers[key].user_id;
+}
+function rebuildMarkdown(property, ctx) {
+  const out = { tag: "markdown" };
+  const elements = Array.isArray(property.elements) ? property.elements : [];
+  const content = renderChildren(elements, ctx);
+  if (content) out.content = content;
+  for (const [rawKey, rawValue] of Object.entries(property)) {
+    if (rawKey === "elements" || rawKey === "markdownElements" || rawKey === "originTag") continue;
+    if (rawKey === "udIcon") continue;
+    if (rawKey === "textStyle") {
+      const ts = isRecord2(rawValue) ? rawValue : {};
+      const size = typeof ts.size === "string" ? ts.size : void 0;
+      if (size) out.text_size = size;
       continue;
     }
-    if (isRecord2(v) && typeof v.tag === "string") {
-      out[key] = convertElToDsl(v);
-      continue;
+    const result = convertField(rawKey, rawValue, "markdown", ctx);
+    if (result === DROP) continue;
+    const [outKey, outValue] = result;
+    if (outValue === DROP) continue;
+    out[outKey] = outValue;
+  }
+  return out;
+}
+function wrapEmphasis(text, bold, color) {
+  if (!bold && !color) return text;
+  const lead = text.match(/^\s*/)[0];
+  const trail = text.match(/\s*$/)[0];
+  const core = text.slice(lead.length, text.length - trail.length);
+  if (core.length === 0) return text;
+  let wrapped = core;
+  if (bold) wrapped = `**${wrapped}**`;
+  if (color) wrapped = `<font color='${color}'>${wrapped}</font>`;
+  return lead + wrapped + trail;
+}
+function renderChildren(children, ctx) {
+  let out = "";
+  let buffer = [];
+  function flushBuffer() {
+    if (buffer.length === 0) return;
+    let group = [];
+    function emitGroup() {
+      if (group.length === 0) return;
+      const inner = group.map((s) => s.content).join("");
+      const { bold, color } = group[0];
+      out += wrapEmphasis(inner, bold, color);
+      group = [];
     }
-    if (Array.isArray(v)) {
-      out[key] = v.map((item) => isRecord2(item) && typeof item.tag === "string" ? convertElToDsl(item) : item);
+    for (const seg of buffer) {
+      if (group.length === 0) {
+        group.push(seg);
+        continue;
+      }
+      const head = group[0];
+      if (head.bold === seg.bold && head.color === seg.color) group.push(seg);
+      else {
+        emitGroup();
+        group.push(seg);
+      }
+    }
+    emitGroup();
+    buffer = [];
+  }
+  for (const child of children) {
+    if (!isRecord2(child)) continue;
+    const inline = childToInlineSegment(child, ctx);
+    if (inline) {
+      buffer.push(inline);
       continue;
     }
-    out[key] = unwrapBox(unwrapTextLeaf(v));
+    flushBuffer();
+    out += childToMarkdown(child, ctx);
   }
+  flushBuffer();
   return out;
 }
-function unwrapTextLeaf(v) {
-  if (isRecord2(v) && v.tag === "plain_text") {
-    const p = isRecord2(v.property) ? v.property : {};
-    return typeof p.content === "string" ? p.content : "";
+function childToInlineSegment(child, ctx) {
+  const tag = child.tag;
+  const prop = isRecord2(child.property) ? child.property : {};
+  const ts = isRecord2(prop.textStyle) ? prop.textStyle : void 0;
+  const bold = !!(ts && Array.isArray(ts.attributes) && ts.attributes.includes("bold"));
+  const rawColor = ts && typeof ts.color === "string" ? ts.color : void 0;
+  const color = rawColor === "default" ? void 0 : rawColor;
+  switch (tag) {
+    case "plain_text":
+      return {
+        content: typeof prop.content === "string" ? prop.content : "",
+        bold,
+        color
+      };
+    case "code_span":
+      return {
+        content: `\`${typeof prop.content === "string" ? prop.content : ""}\``,
+        bold,
+        color
+      };
+    case "link": {
+      const text = typeof prop.content === "string" ? prop.content : "";
+      const urlObj = isRecord2(prop.url) ? prop.url : void 0;
+      const url = urlObj && typeof urlObj.url === "string" ? urlObj.url : "";
+      return { content: `[${text}](${url})`, bold, color };
+    }
+    case "at_all":
+      return { content: "<at id=all></at>", bold, color };
+    case "at": {
+      const userId = resolveAtUserId(prop, ctx);
+      return { content: userId ? `<at id=${userId}></at>` : "<at></at>", bold, color };
+    }
+    case "text_tag": {
+      const tagColor = typeof prop.color === "string" ? prop.color : void 0;
+      const inner = isRecord2(prop.text) ? prop.text : void 0;
+      const innerProp = inner && isRecord2(inner.property) ? inner.property : void 0;
+      const innerContent = innerProp && typeof innerProp.content === "string" ? innerProp.content : "";
+      const rendered = tagColor ? `<text_tag color='${tagColor}'>${innerContent}</text_tag>` : `<text_tag>${innerContent}</text_tag>`;
+      return { content: rendered, bold: false };
+    }
+    case "emoji": {
+      const key = typeof prop.key === "string" ? prop.key : typeof prop.emojiKey === "string" ? prop.emojiKey : "";
+      return key ? { content: `:${key}:`, bold: false } : void 0;
+    }
+    case "person":
+    case "person_v1": {
+      const rendered = renderInlinePerson(prop);
+      return rendered ? { content: rendered, bold: false } : void 0;
+    }
+    case "markdown_audio": {
+      const rendered = renderInlineAudio(prop);
+      return rendered ? { content: rendered, bold: false } : void 0;
+    }
+    default:
+      return void 0;
   }
-  return v;
 }
-function unwrapBox(v) {
-  if (!isRecord2(v) || !isRecord2(v.top) || !isRecord2(v.right)) return v;
-  const side = (s) => isRecord2(s) && typeof s.value === "number" ? `${s.value}px` : "0px";
-  return `${side(v.top)} ${side(v.right)} ${side(v.bottom ?? v.top)} ${side(v.left ?? v.right)}`;
+function childToMarkdown(child, ctx) {
+  const tag = child.tag;
+  const prop = isRecord2(child.property) ? child.property : {};
+  switch (tag) {
+    case "plain_text": {
+      const content = typeof prop.content === "string" ? prop.content : "";
+      const ts = isRecord2(prop.textStyle) ? prop.textStyle : void 0;
+      const color = ts && typeof ts.color === "string" ? ts.color : void 0;
+      const attrs = ts && Array.isArray(ts.attributes) ? ts.attributes : [];
+      return wrapEmphasis(content, attrs.includes("bold"), color);
+    }
+    case "br":
+      return "\n";
+    case "emoji": {
+      const key = typeof prop.key === "string" ? prop.key : typeof prop.emojiKey === "string" ? prop.emojiKey : "";
+      return key ? `:${key}:` : "";
+    }
+    case "at_all":
+      return "<at id=all></at>";
+    case "at": {
+      const userId = resolveAtUserId(prop, ctx);
+      return userId ? `<at id=${userId}></at>` : "<at></at>";
+    }
+    case "person":
+    case "person_v1":
+      return renderInlinePerson(prop);
+    case "markdown_audio":
+      return renderInlineAudio(prop);
+    case "link": {
+      const text = typeof prop.content === "string" ? prop.content : "";
+      const urlObj = isRecord2(prop.url) ? prop.url : void 0;
+      const url = urlObj && typeof urlObj.url === "string" ? urlObj.url : "";
+      return `[${text}](${url})`;
+    }
+    case "code_span": {
+      const text = typeof prop.content === "string" ? prop.content : "";
+      return `\`${text}\``;
+    }
+    case "text_tag": {
+      const color = typeof prop.color === "string" ? prop.color : void 0;
+      const inner = isRecord2(prop.text) ? prop.text : void 0;
+      const innerProp = inner && isRecord2(inner.property) ? inner.property : void 0;
+      const innerContent = innerProp && typeof innerProp.content === "string" ? innerProp.content : "";
+      if (color) return `<text_tag color='${color}'>${innerContent}</text_tag>`;
+      return `<text_tag>${innerContent}</text_tag>`;
+    }
+    case "code_block": {
+      const lang = typeof prop.language === "string" ? prop.language : "";
+      const blocks = Array.isArray(prop.contents) ? prop.contents : [];
+      const lines = blocks.map((blk) => {
+        if (!isRecord2(blk)) return "";
+        const inner = Array.isArray(blk.contents) ? blk.contents : [];
+        let line = "";
+        for (const seg of inner) {
+          if (isRecord2(seg) && typeof seg.content === "string") line += seg.content;
+        }
+        return line;
+      });
+      const body = lines.join("\n").replace(/\n+$/, "");
+      return `
+\`\`\`${lang}
+${body}
+\`\`\`
+`;
+    }
+    case "list": {
+      const items = Array.isArray(prop.items) ? prop.items : [];
+      const lines = [];
+      const levelCounters = [];
+      for (const item of items) {
+        if (!isRecord2(item)) continue;
+        const level = typeof item.level === "number" ? item.level : 0;
+        const type = typeof item.type === "string" ? item.type : "ul";
+        const indent = "    ".repeat(level);
+        const inner = Array.isArray(item.elements) ? item.elements : [];
+        let text = "";
+        for (const seg of inner) {
+          if (!isRecord2(seg)) continue;
+          text += childToMarkdown(seg, ctx);
+        }
+        if (type === "ol") {
+          let n;
+          if (typeof item.order === "number" && Number.isFinite(item.order) && item.order > 0) {
+            n = Math.floor(item.order);
+            levelCounters.length = level + 1;
+            levelCounters[level] = n;
+          } else {
+            levelCounters.length = level + 1;
+            levelCounters[level] = (levelCounters[level] ?? 0) + 1;
+            n = levelCounters[level];
+          }
+          lines.push(`${indent}${n}. ${text}`);
+        } else {
+          lines.push(`${indent}- ${text}`);
+        }
+      }
+      return `
+${lines.join("\n")}
+
+`;
+    }
+    case "heading": {
+      const level = typeof prop.level === "number" ? prop.level : 1;
+      const inner = Array.isArray(prop.elements) ? prop.elements : [];
+      let body = "";
+      for (const seg of inner) {
+        if (isRecord2(seg)) body += childToMarkdown(seg, ctx);
+      }
+      return `
+
+${"#".repeat(level)} ${body}
+
+`;
+    }
+    case "hr": {
+      return "\n\n---\n\n";
+    }
+    case "table": {
+      const columns = Array.isArray(prop.columns) ? prop.columns : [];
+      const rows = Array.isArray(prop.rows) ? prop.rows : [];
+      if (columns.length === 0) return "";
+      const headers = columns.map(
+        (col) => isRecord2(col) && typeof col.displayName === "string" ? col.displayName : ""
+      );
+      const headerLine = `| ${headers.join(" | ")} |`;
+      const separator = `| ${columns.map(() => "--------").join(" | ")} |`;
+      const bodyLines = rows.map((row) => {
+        if (!isRecord2(row)) return `| ${columns.map(() => "").join(" | ")} |`;
+        const cells = columns.map((col) => {
+          const name = isRecord2(col) && typeof col.name === "string" ? col.name : "";
+          const cell = isRecord2(row[name]) ? row[name] : void 0;
+          const data = cell && isRecord2(cell.data) ? cell.data : void 0;
+          if (!data || data.tag !== "markdown") return "";
+          const cellProp = isRecord2(data.property) ? data.property : {};
+          const inner = Array.isArray(cellProp.elements) ? cellProp.elements : [];
+          const text = renderChildren(inner, ctx);
+          return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+        });
+        return `| ${cells.join(" | ")} |`;
+      });
+      return `
+
+${headerLine}
+${separator}
+${bodyLines.join("\n")}
+
+`;
+    }
+    case "blockquote": {
+      const inner = Array.isArray(prop.elements) ? prop.elements : [];
+      let body = "";
+      for (const seg of inner) {
+        if (isRecord2(seg)) body += childToMarkdown(seg, ctx);
+      }
+      return `
+
+> ${body.replace(/\n/g, "\n> ")}
+
+`;
+    }
+    default:
+      return typeof prop.content === "string" ? prop.content : "";
+  }
+}
+function convertGeneric(value, ctx) {
+  if (Array.isArray(value)) {
+    return value.map((item) => {
+      if (isRecord2(item) && typeof item.tag === "string" && isRecord2(item.property)) {
+        return unwrap(item, ctx);
+      }
+      return convertGeneric(item, ctx);
+    });
+  }
+  if (isRecord2(value)) {
+    if (typeof value.tag === "string" && isRecord2(value.property)) {
+      return unwrap(value, ctx);
+    }
+    if (hasSide(value)) {
+      return formatBox(value);
+    }
+    if (isPixelScalar(value)) {
+      return `${pixelOf(value)}px`;
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[snake(k)] = convertGeneric(v, ctx);
+    }
+    return out;
+  }
+  return value;
+}
+function isRecord2(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
 }
-function elementsToMarkdown(els) {
-  const parts = [];
-  for (const el of els) {
-    const p = isRecord2(el?.property) ? el.property : {};
-    if (typeof p.content === "string") parts.push(p.content);
-    else if (Array.isArray(p.elements)) parts.push(elementsToMarkdown(p.elements));
-  }
-  return parts.join("");
+function resolveAttachmentImgKey(rawValue, ctx) {
+  if (typeof rawValue !== "string" && typeof rawValue !== "number") return void 0;
+  const id = String(rawValue);
+  const origin = ctx.images[id]?.origin_key;
+  if (typeof origin === "string" && origin) return origin;
+  if (id.startsWith("img_")) return id;
+  return void 0;
+}
+function normalizeVideoCover(rawValue, ctx) {
+  if (typeof rawValue === "string" || typeof rawValue === "number") {
+    const imgKey2 = resolveAttachmentImgKey(rawValue, ctx);
+    return imgKey2 ? { img_key: imgKey2 } : void 0;
+  }
+  if (!isRecord2(rawValue)) return void 0;
+  if (typeof rawValue.img_key === "string" && rawValue.img_key) {
+    return { img_key: rawValue.img_key };
+  }
+  const candidate = rawValue.imageID ?? rawValue.image_id ?? rawValue.cover_image_id ?? rawValue.coverImageId;
+  const imgKey = resolveAttachmentImgKey(candidate, ctx);
+  return imgKey ? { img_key: imgKey } : void 0;
+}
+function hasSide(v) {
+  return ("top" in v || "bottom" in v || "left" in v || "right" in v) && Object.values(v).some((side) => isRecord2(side) && "type" in side && "value" in side);
+}
+function formatBox(v) {
+  return `${pixelOf(v.top)}px ${pixelOf(v.right)}px ${pixelOf(v.bottom)}px ${pixelOf(v.left)}px`;
+}
+function isPixelScalar(v) {
+  if (!isRecord2(v)) return false;
+  return typeof v.type === "string" && v.type.includes("pixels") && typeof v.value === "number";
+}
+function pixelOf(side) {
+  if (!isRecord2(side)) return 0;
+  const v = side.value;
+  if (typeof v === "number") return v;
+  if (typeof v === "string") {
+    const n = Number(v);
+    return Number.isFinite(n) ? n : 0;
+  }
+  return 0;
+}
+function snake(key) {
+  return key.replace(/ID$/g, "_id").replace(/URL$/g, "_url").replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/([a-z\d])([A-Z])/g, "$1_$2").toLowerCase();
+}
+function rawToDsl(raw) {
+  if (isRawCardEnvelope(raw)) return rawCardToDsl(raw);
+  if (typeof raw === "string") {
+    try {
+      return rawToDsl(JSON.parse(raw));
+    } catch {
+      return raw;
+    }
+  }
+  if (!isRecord2(raw)) return raw;
+  if (typeof raw.json_card === "string" || isRecord2(raw.json_card)) {
+    let inner = raw.json_card;
+    if (typeof inner === "string") {
+      try {
+        inner = JSON.parse(inner);
+      } catch {
+        return raw;
+      }
+    }
+    const attachment = isRecord2(raw.json_attachment) ? raw.json_attachment : {};
+    const ctx = {
+      images: isRecord2(attachment.images) ? attachment.images : {},
+      atUsers: isRecord2(attachment.at_users) ? attachment.at_users : {}
+    };
+    return convertRoot(inner, ctx);
+  }
+  if (isRecord2(raw.card)) {
+    const card = raw.card;
+    if (typeof card.json_card === "string" || isRecord2(card.json_card)) {
+      return rawToDsl(card);
+    }
+    return convertRoot(card, { images: {}, atUsers: {} });
+  }
+  if ("body" in raw || "header" in raw || "schema" in raw) {
+    return convertRoot(raw, { images: {}, atUsers: {} });
+  }
+  return raw;
+}
+function degradeUnknown(el) {
+  const rawTag = typeof el.tag === "string" ? el.tag : "undefined";
+  return { tag: "unknown", raw_tag: rawTag, fallback: el };
 }
 
 exports.degradeUnknown = degradeUnknown;
 exports.dslToRaw = dslToRaw;
+exports.isRawCardEnvelope = isRawCardEnvelope;
+exports.rawCardToDsl = rawCardToDsl;
 exports.rawToDsl = rawToDsl;