slackmark 0.2.0 → 0.4.0

package/dist/index.js

@@ -1,3 +1,12 @@
+// src/errors.ts
+var ConfigurationError = class extends Error {
+  name;
+  constructor(message, options) {
+    super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
+    this.name = "ConfigurationError";
+  }
+};
+
 // src/capabilities/capabilities.ts
 var CapabilityPresetName = {
   Latest: "latest",
@@ -59,12 +68,13 @@ function resolveCapabilities(input, overrides) {
   if (input === void 0) {
     base = CAPABILITY_PRESETS.latest;
   } else if (typeof input === "string") {
-    const preset = CAPABILITY_PRESETS[input];
+    const preset = isPresetName(input) ? CAPABILITY_PRESETS[input] : void 0;
     if (preset === void 0) {
-      base = CAPABILITY_PRESETS.latest;
-    } else {
-      base = preset;
+      throw new ConfigurationError(
+        `Unknown capability preset ${JSON.stringify(input)}; use one of: ${Object.keys(CAPABILITY_PRESETS).join(", ")}.`
+      );
     }
+    base = preset;
   } else if (isFullFlags(input)) {
     base = input;
   } else {
@@ -75,6 +85,9 @@ function resolveCapabilities(input, overrides) {
   }
   return Object.freeze({ ...base, ...overrides });
 }
+function isPresetName(value) {
+  return Object.hasOwn(CAPABILITY_PRESETS, value);
+}
 function isFullFlags(value) {
   return typeof value.richText === "boolean" && typeof value.markdownBlock === "boolean" && typeof value.tableBlock === "boolean" && typeof value.preformattedLanguage === "boolean" && typeof value.headerLevel === "boolean" && typeof value.dataTable === "boolean" && typeof value.dataVisualization === "boolean" && typeof value.containerBlock === "boolean";
 }
@@ -127,48 +140,6 @@ var StandardBudgetLedger = class {
     this.charts = 0;
     this.totalChars = 0;
   }
-  tryReserveBlocks(count) {
-    if (this.blocks + count > this.maxBlocks) {
-      return false;
-    }
-    this.blocks += count;
-    return true;
-  }
-  tryReserveTableChars(chars) {
-    if (this.tableChars + chars > TABLE_CELL_CHARS_MAX) {
-      return false;
-    }
-    this.tableChars += chars;
-    return true;
-  }
-  tryReserveDataTableChars(chars) {
-    if (this.dataTableChars + chars > DATA_TABLE_CELL_CHARS_MAX) {
-      return false;
-    }
-    this.dataTableChars += chars;
-    return true;
-  }
-  tryReserveMarkdownChars(chars) {
-    if (this.markdownChars + chars > MARKDOWN_CUMULATIVE_MAX_CHARS) {
-      return false;
-    }
-    this.markdownChars += chars;
-    return true;
-  }
-  tryReserveChart() {
-    if (this.enforceChartCap && this.charts + 1 > DATA_VISUALIZATION_MAX_PER_MESSAGE) {
-      return false;
-    }
-    this.charts += 1;
-    return true;
-  }
-  tryReserveTotalChars(chars) {
-    if (this.totalChars + chars > MESSAGE_TEXT_SAFETY_MAX_CHARS) {
-      return false;
-    }
-    this.totalChars += chars;
-    return true;
-  }
   tryReserveClaim(claim) {
     if (claim === void 0) {
       return true;
@@ -193,9 +164,6 @@ var StandardBudgetLedger = class {
     this.totalChars = nextTotal;
     return true;
   }
-  remainingBlocks() {
-    return this.maxBlocks - this.blocks;
-  }
   snapshot() {
     return {
       blocks: this.blocks,
@@ -258,30 +226,6 @@ var ConversionContext = class _ConversionContext {
     this.precedingHeading = deps.precedingHeading;
     this.path = deps.path;
   }
-  withPath(segment) {
-    return new _ConversionContext({
-      config: this.config,
-      budget: this.budget,
-      degradations: this.degradations,
-      definitions: this.definitions,
-      footnotes: this.footnotes,
-      footnoteOrder: this.footnoteOrder,
-      precedingHeading: this.precedingHeading,
-      path: this.path.length === 0 ? segment : `${this.path}/${segment}`
-    });
-  }
-  withPrecedingHeading(heading) {
-    return new _ConversionContext({
-      config: this.config,
-      budget: this.budget,
-      degradations: this.degradations,
-      definitions: this.definitions,
-      footnotes: this.footnotes,
-      footnoteOrder: this.footnoteOrder,
-      precedingHeading: heading,
-      path: this.path
-    });
-  }
   withDegradations(degradations) {
     return new _ConversionContext({
       config: this.config,
@@ -367,6 +311,29 @@ function assertNever(value, message) {
   throw new Error(`${detail}: ${JSON.stringify(value)}`);
 }
 
+// src/utf16.ts
+var HIGH_SURROGATE_MIN = 55296;
+var HIGH_SURROGATE_MAX = 56319;
+var LOW_SURROGATE_MIN = 56320;
+var LOW_SURROGATE_MAX = 57343;
+function surrogateSafeEnd(text, end) {
+  if (end <= 0) {
+    return 0;
+  }
+  if (end >= text.length) {
+    return text.length;
+  }
+  const before = text.charCodeAt(end - 1);
+  const after = text.charCodeAt(end);
+  if (before >= HIGH_SURROGATE_MIN && before <= HIGH_SURROGATE_MAX && after >= LOW_SURROGATE_MIN && after <= LOW_SURROGATE_MAX) {
+    return end - 1;
+  }
+  return end;
+}
+function sliceSurrogateSafe(text, max) {
+  return text.slice(0, surrogateSafeEnd(text, max));
+}
+
 // src/types.ts
 var OverflowMode = {
   Degrade: "degrade",
@@ -467,7 +434,7 @@ var MessageAssembler = class {
       reason: "Notification text truncated to 40k safety limit",
       path: ctx.path
     });
-    return { blocks, text: raw.slice(0, MESSAGE_TEXT_SAFETY_MAX_CHARS) };
+    return { blocks, text: sliceSurrogateSafe(raw, MESSAGE_TEXT_SAFETY_MAX_CHARS) };
   }
 };
 function buildFootnoteBlocks(entries, degradations) {
@@ -486,7 +453,7 @@ function buildFootnoteBlocks(entries, degradations) {
         reason: "Footnote context text truncated to 3000 chars",
         path: "footnote"
       });
-      elements.push({ type: "mrkdwn", text: note.slice(0, SECTION_TEXT_MAX_CHARS) });
+      elements.push({ type: "mrkdwn", text: sliceSurrogateSafe(note, SECTION_TEXT_MAX_CHARS) });
     } else {
       elements.push({ type: "mrkdwn", text: note });
     }
@@ -684,12 +651,116 @@ function inlinesToPlain(elements) {
       case "channel":
         parts.push(`#${el.channel_id}`);
         break;
+      case "usergroup":
+        parts.push(`@${el.usergroup_id}`);
+        break;
+      case "broadcast":
+        parts.push(`@${el.range}`);
+        break;
+      case "date":
+        parts.push(el.fallback ?? formatDateTokensUtc(el.timestamp, el.format));
+        break;
       default:
         break;
     }
   }
   return parts.join("");
 }
+var DATE_TOKEN_RE = /\{([a-z_]+)\}/g;
+var MONTHS = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+var WEEKDAYS = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+function pad2(value) {
+  return String(value).padStart(2, "0");
+}
+function ordinal(value) {
+  const remainder = value % 100;
+  if (remainder >= 11 && remainder <= 13) {
+    return `${String(value)}th`;
+  }
+  switch (value % 10) {
+    case 1:
+      return `${String(value)}st`;
+    case 2:
+      return `${String(value)}nd`;
+    case 3:
+      return `${String(value)}rd`;
+    default:
+      return `${String(value)}th`;
+  }
+}
+function dateToken(token, date) {
+  const day = date.getUTCDate();
+  const month = MONTHS[date.getUTCMonth()] ?? "";
+  const shortMonth = month.slice(0, 3);
+  const weekday = WEEKDAYS[date.getUTCDay()] ?? "";
+  const year = date.getUTCFullYear();
+  switch (token) {
+    case "date_num":
+      return `${String(year)}-${pad2(date.getUTCMonth() + 1)}-${pad2(day)}`;
+    // Slack renders {date_slash} month-first: 02/18/2014 (docs example for
+    // timestamp 1392734382).
+    case "date_slash":
+      return `${pad2(date.getUTCMonth() + 1)}/${pad2(day)}/${String(year)}`;
+    case "date_long":
+    case "date_long_pretty":
+      return `${weekday}, ${month} ${ordinal(day)}, ${String(year)}`;
+    case "date_long_full":
+      return `${month} ${String(day)}, ${String(year)}`;
+    // {date} renders "February 18th, 2014" (ordinal + year), not "February 18".
+    case "date":
+    case "date_pretty":
+      return `${month} ${ordinal(day)}, ${String(year)}`;
+    case "date_short":
+    case "date_short_pretty":
+      return `${shortMonth} ${String(day)}, ${String(year)}`;
+    case "time":
+      return `${pad2(date.getUTCHours())}:${pad2(date.getUTCMinutes())}`;
+    case "time_secs":
+      return `${pad2(date.getUTCHours())}:${pad2(date.getUTCMinutes())}:${pad2(date.getUTCSeconds())}`;
+    default:
+      return void 0;
+  }
+}
+function formatDateTokensUtc(timestamp, format) {
+  const date = new Date(timestamp * 1e3);
+  if (!Number.isFinite(timestamp) || Number.isNaN(date.getTime())) {
+    return String(timestamp);
+  }
+  let unsupported = false;
+  const formatted = format.replace(DATE_TOKEN_RE, (_match, token) => {
+    const replacement = dateToken(token, date);
+    if (replacement === void 0) {
+      unsupported = true;
+      return "";
+    }
+    return replacement;
+  });
+  if (format.length === 0 || unsupported) {
+    return date.toISOString().slice(0, 10);
+  }
+  return formatted;
+}
 function tableToPlain(rows) {
   const lines = [];
   for (const row of rows) {
@@ -737,18 +808,12 @@ var RemarkMarkdownParser = class {
 // src/mermaid/mermaid-pie-parser.ts
 var COMMENT_RE = /%%[^\n]{0,500}/g;
 var TITLE_RE = /^\s*pie\b(?:\s+showData)?(?:\s+title\s+(.+))?\s*$/i;
-var SHOW_DATA_RE = /\bshowData\b/i;
 var ENTRY_RE = /^\s*"([^"]{1,200})"\s*:\s*(-?\d+(?:\.\d+)?)\s*$/;
 var MermaidPieParser = class {
-  diagramType;
-  constructor() {
-    this.diagramType = "pie";
-  }
   parse(source) {
     const cleaned = source.replace(COMMENT_RE, "");
     const lines = cleaned.split(/\r?\n/);
     let title;
-    let showData = false;
     const segments = [];
     let seenHeader = false;
     for (const raw of lines) {
@@ -761,7 +826,6 @@ var MermaidPieParser = class {
           return { ok: false, reason: "Not a pie diagram" };
         }
         seenHeader = true;
-        showData = SHOW_DATA_RE.test(line);
         const tm = TITLE_RE.exec(line);
         const titlePart = tm?.[1]?.trim();
         if (titlePart !== void 0 && titlePart.length > 0) {
@@ -794,7 +858,6 @@ var MermaidPieParser = class {
     const ast = {
       kind: "pie",
       title,
-      showData,
       segments
     };
     return { ok: true, value: ast };
@@ -807,10 +870,6 @@ var NUM = String.raw`-?\d+(?:\.\d+)?`;
 var NUM_LIST_RE = new RegExp(String.raw`\[\s*((?:${NUM}\s*,\s*)*${NUM})\s*\]`);
 var STR_LIST_RE = /\[\s*((?:"[^"]{0,200}"\s*,\s*)*"[^"]{0,200}")\s*\]/;
 var MermaidXyChartParser = class {
-  diagramType;
-  constructor() {
-    this.diagramType = "xychart-beta";
-  }
   parse(source) {
     const cleaned = source.replace(COMMENT_RE2, "");
     const lines = cleaned.split(/\r?\n/);
@@ -818,8 +877,6 @@ var MermaidXyChartParser = class {
     let categories = [];
     let xLabel;
     let yLabel;
-    let yMin;
-    let yMax;
     const bars = [];
     const linesSeries = [];
     let seenHeader = false;
@@ -883,10 +940,6 @@ var MermaidXyChartParser = class {
         ).exec(line);
         if (ym !== null) {
           yLabel = ym[1];
-          if (ym[2] !== void 0 && ym[3] !== void 0) {
-            yMin = Number(ym[2]);
-            yMax = Number(ym[3]);
-          }
           continue;
         }
         return { ok: false, reason: `Invalid y-axis: ${line}` };
@@ -924,8 +977,6 @@ var MermaidXyChartParser = class {
       categories,
       xLabel,
       yLabel,
-      yMin,
-      yMax,
       bars,
       lines: linesSeries
     };
@@ -949,15 +1000,6 @@ function parseNumberList(inner) {
 // src/converter/slackmark-converter.ts
 import { toString } from "mdast-util-to-string";
 
-// src/errors.ts
-var ConfigurationError = class extends Error {
-  name;
-  constructor(message, options) {
-    super(message, options?.cause !== void 0 ? { cause: options.cause } : void 0);
-    this.name = "ConfigurationError";
-  }
-};
-
 // src/converter/resolve-config.ts
 function resolveConfig(defaults, overrides) {
   const merged = {
@@ -1047,7 +1089,7 @@ var SlackMarkConverter = class {
         enableMath: config.enableMath,
         enableFrontmatter: config.enableFrontmatter
       });
-      const { definitions, footnotes, footnoteOrder } = collectRefs(tree);
+      const { definitions, footnotes, footnoteOrder } = collectRefs(tree, degradations);
       let precedingHeading;
       const emitted = [];
       let index = 0;
@@ -1072,11 +1114,13 @@ var SlackMarkConverter = class {
         emitted.push(...blocks);
         index += 1;
       }
+      const footnoteNumbers = /* @__PURE__ */ new Map();
+      footnoteOrder.forEach((id, i) => footnoteNumbers.set(id, i + 1));
       const footnoteEntries = footnoteOrder.map((id, i) => {
         const def = footnotes.get(id);
         return {
           n: i + 1,
-          text: def !== void 0 ? toString(def).trim() : id
+          text: def !== void 0 ? footnoteBodyText(def, footnoteNumbers).trim() : id
         };
       });
       const footnoteBlocks = buildFootnoteBlocks(footnoteEntries, degradations);
@@ -1185,7 +1229,7 @@ function safeNotificationText(plainText, markdown, degradations) {
     reason: "Notification text truncated to 40k safety limit",
     path: "root"
   });
-  return raw.slice(0, MESSAGE_TEXT_SAFETY_MAX_CHARS);
+  return sliceSurrogateSafe(raw, MESSAGE_TEXT_SAFETY_MAX_CHARS);
 }
 function clampSectionFallback(text, degradations) {
   if (text.length <= SECTION_TEXT_MAX_CHARS) {
@@ -1198,17 +1242,38 @@ function clampSectionFallback(text, degradations) {
     reason: "Section text truncated to 3000 chars",
     path: "root"
   });
-  return text.slice(0, SECTION_TEXT_MAX_CHARS);
+  return sliceSurrogateSafe(text, SECTION_TEXT_MAX_CHARS);
 }
-function collectRefs(tree) {
+function collectRefs(tree, degradations) {
   const definitions = /* @__PURE__ */ new Map();
   const footnotes = /* @__PURE__ */ new Map();
   for (const node of tree.children) {
     if (node.type === "definition") {
-      definitions.set(node.identifier.toLowerCase(), node);
+      const key = node.identifier.toLowerCase();
+      if (definitions.has(key)) {
+        degradations.add({
+          nodeType: "definition",
+          from: node.identifier,
+          to: "ignored",
+          reason: "Duplicate link reference definition; first definition wins",
+          path: "root"
+        });
+      } else {
+        definitions.set(key, node);
+      }
     }
     if (node.type === "footnoteDefinition") {
-      footnotes.set(node.identifier, node);
+      if (footnotes.has(node.identifier)) {
+        degradations.add({
+          nodeType: "footnoteDefinition",
+          from: node.identifier,
+          to: "ignored",
+          reason: "Duplicate footnote definition; first definition wins",
+          path: "root"
+        });
+      } else {
+        footnotes.set(node.identifier, node);
+      }
     }
   }
   const footnoteOrder = [];
@@ -1219,8 +1284,46 @@ function collectRefs(tree) {
       footnoteOrder.push(id);
     }
   });
+  for (let i = 0; i < footnoteOrder.length; i += 1) {
+    const def = footnotes.get(footnoteOrder[i] ?? "");
+    if (def === void 0) {
+      continue;
+    }
+    for (const child of def.children) {
+      walkFootnoteReferences(child, (id) => {
+        if (!seen.has(id)) {
+          seen.add(id);
+          footnoteOrder.push(id);
+        }
+      });
+    }
+  }
   return { definitions, footnotes, footnoteOrder };
 }
+function footnoteBodyText(node, numbers) {
+  if (node === null || typeof node !== "object") {
+    return "";
+  }
+  const record = node;
+  if (record.type === "footnoteReference" && typeof record.identifier === "string") {
+    const n = numbers.get(record.identifier);
+    return n !== void 0 ? `[${String(n)}]` : `[^${record.identifier}]`;
+  }
+  if (typeof record.value === "string") {
+    return record.value;
+  }
+  if (typeof record.alt === "string") {
+    return record.alt;
+  }
+  if (record.children !== void 0) {
+    const parts = [];
+    for (const child of record.children) {
+      parts.push(footnoteBodyText(child, numbers));
+    }
+    return parts.join("");
+  }
+  return "";
+}
 function walkFootnoteReferences(node, onRef) {
   if (node === null || typeof node !== "object") {
     return;
@@ -1244,8 +1347,11 @@ function chunkMarkdown(text, max) {
     return [text.length > 0 ? text : " "];
   }
   const out = [];
-  for (let i = 0; i < text.length; i += max) {
-    out.push(text.slice(i, i + max));
+  let i = 0;
+  while (i < text.length) {
+    const end = surrogateSafeEnd(text, i + max);
+    out.push(text.slice(i, end));
+    i = end;
   }
   return out;
 }
@@ -1255,65 +1361,43 @@ import { toString as toString3 } from "mdast-util-to-string";
 
 // src/adapters/inline.ts
 import { toString as toString2 } from "mdast-util-to-string";
-var EMOJI_SHORTCODE_RE = /:([a-z0-9_+-]{1,64}):/g;
-var KNOWN_SLACK_EMOJI = /* @__PURE__ */ new Set([
-  "smile",
-  "grinning",
-  "wink",
-  "blush",
-  "wave",
-  "thumbsup",
-  "thumbsdown",
-  "tada",
-  "rocket",
-  "fire",
-  "heart",
-  "eyes",
-  "thinking_face",
-  "sweat_smile",
-  "joy",
-  "sob",
-  "clap",
-  "100",
-  "white_check_mark",
-  "x",
-  "warning",
-  "bulb",
-  "memo",
-  "mag",
-  "link",
-  "gear",
-  "bug",
-  "sparkles",
-  "+1",
-  "-1",
-  "ok_hand",
-  "pray",
-  "star",
-  "zap",
-  "check",
-  "heavy_check_mark"
-]);
+var EMOJI_SHORTCODE_RE = /(?<![A-Za-z0-9]):([a-z0-9_+-]{1,64}):(?![A-Za-z0-9])/g;
 var HTTP_URL_RE = /^(https?:|mailto:)/i;
 var IMAGE_EXT_RE = /\.(png|jpe?g|gif)(?:\?|#|$)/i;
 function emitPhrasing(nodes, ctx, baseStyle = {}) {
   const elements = [];
   const hoistedImages = [];
+  const work = [...nodes];
   let pendingAnchor;
+  const htmlStyles = [];
+  const activeStyle = () => htmlStyles[htmlStyles.length - 1] ?? baseStyle;
   const flushPendingAnchor = () => {
     if (pendingAnchor === void 0) {
       return;
     }
-    const label = pendingAnchor.textParts.join("");
-    elements.push({
-      type: "link",
-      url: pendingAnchor.href,
-      text: label.length > 0 ? label : pendingAnchor.href,
-      style: styleOrUndefined(pendingAnchor.style)
-    });
+    elements.push(anchorInline(pendingAnchor, ctx));
     pendingAnchor = void 0;
   };
-  for (const node of nodes) {
+  for (let i = 0; i < work.length; i += 1) {
+    const node = work[i];
+    if (pendingAnchor === void 0) {
+      const reassembled = reassembleSlackLabeledLink(work, i, activeStyle());
+      if (reassembled !== void 0) {
+        if (reassembled.leadingText.value.length > 0) {
+          elements.push(
+            ...emitTextWithMentionsAndEmoji(reassembled.leadingText, activeStyle(), ctx)
+          );
+        }
+        elements.push(reassembled.link);
+        if (reassembled.trailingText.value.length > 0) {
+          work.splice(i, 3, reassembled.trailingText);
+        } else {
+          work.splice(i, 3);
+        }
+        i -= 1;
+        continue;
+      }
+    }
     if (pendingAnchor !== void 0) {
       if (node.type === "html" && /^<\/a\s*>$/i.test(node.value.trim())) {
         flushPendingAnchor();
@@ -1332,32 +1416,54 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
     }
     if (node.type === "html") {
       const trimmed = node.value.trim();
+      const entityInlines = slackEntityRichTextInlines(trimmed, activeStyle());
+      if (entityInlines !== void 0) {
+        elements.push(...entityInlines);
+        continue;
+      }
       const openOnly = /^<a\b([^>]{0,500})>\s*$/i.exec(trimmed);
       if (openOnly !== null) {
         const hrefMatch = /href\s*=\s*["']([^"']{0,3000})["']/i.exec(openOnly[1] ?? "");
         const href = hrefMatch?.[1];
-        if (href !== void 0 && isValidLinkUrl(href)) {
-          pendingAnchor = { href, style: baseStyle, textParts: [] };
+        if (href !== void 0) {
+          pendingAnchor = {
+            href,
+            style: activeStyle(),
+            textParts: [],
+            valid: isValidLinkUrl(href)
+          };
           continue;
         }
       }
-      elements.push(...emitInlineHtml(node.value, baseStyle, ctx));
+      const openTag = HTML_STYLE_OPEN_RE.exec(trimmed);
+      if (openTag !== null) {
+        htmlStyles.push(htmlTagStyle(activeStyle(), openTag[1] ?? ""));
+        continue;
+      }
+      if (HTML_STYLE_CLOSE_RE.test(trimmed)) {
+        htmlStyles.pop();
+        continue;
+      }
+      elements.push(...emitInlineHtml(node.value, activeStyle(), ctx));
       continue;
     }
     switch (node.type) {
       case "text": {
-        elements.push(...emitTextWithMentionsAndEmoji(node, baseStyle, ctx));
+        elements.push(...emitTextWithMentionsAndEmoji(node, activeStyle(), ctx));
         break;
       }
       case "strong": {
-        const inner = emitPhrasing(node.children, ctx, { ...baseStyle, bold: true });
+        const inner = emitPhrasing(node.children, ctx, {
+          ...activeStyle(),
+          bold: true
+        });
         elements.push(...inner.elements);
         hoistedImages.push(...inner.hoistedImages);
         break;
       }
       case "emphasis": {
         const inner = emitPhrasing(node.children, ctx, {
-          ...baseStyle,
+          ...activeStyle(),
           italic: true
         });
         elements.push(...inner.elements);
@@ -1365,7 +1471,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
         break;
       }
       case "delete": {
-        const inner = emitPhrasing(node.children, ctx, { ...baseStyle, strike: true });
+        const inner = emitPhrasing(node.children, ctx, { ...activeStyle(), strike: true });
         elements.push(...inner.elements);
         hoistedImages.push(...inner.hoistedImages);
         break;
@@ -1374,21 +1480,21 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
         const el = {
           type: "text",
           text: node.value,
-          style: styleOrUndefined({ ...baseStyle, code: true })
+          style: styleOrUndefined({ ...activeStyle(), code: true })
         };
         elements.push(el);
         break;
       }
       case "break": {
-        elements.push({ type: "text", text: "\n", style: styleOrUndefined(baseStyle) });
+        elements.push({ type: "text", text: "\n", style: styleOrUndefined(activeStyle()) });
         break;
       }
       case "link": {
-        elements.push(...emitLink(node, ctx, baseStyle));
+        elements.push(...emitLink(node, ctx, activeStyle()));
         break;
       }
       case "linkReference": {
-        elements.push(...emitLinkReference(node, ctx, baseStyle));
+        elements.push(...emitLinkReference(node, ctx, activeStyle()));
         break;
       }
       case "image": {
@@ -1403,22 +1509,33 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
             type: "link",
             url,
             text: node.alt && node.alt.length > 0 ? node.alt : url,
-            style: styleOrUndefined(baseStyle)
+            style: styleOrUndefined(activeStyle())
           });
         } else {
+          const linkable = isValidLinkUrl(url);
           ctx.degradations.add({
             nodeType: "image",
             from: "image",
-            to: "link",
+            to: linkable ? "link" : "text",
             reason: "Image URL is not a public http(s) png/jpg/gif \u22643000 chars",
             path: ctx.path
           });
-          elements.push({
-            type: "link",
-            url: url.length > 0 ? url : "#",
-            text: node.alt && node.alt.length > 0 ? node.alt : url,
-            style: styleOrUndefined(baseStyle)
-          });
+          const label = node.alt && node.alt.length > 0 ? node.alt : url.length > 0 ? url : "image";
+          if (linkable) {
+            elements.push({
+              type: "link",
+              url,
+              text: label,
+              style: styleOrUndefined(activeStyle())
+            });
+          } else {
+            const suffix = url.length > 0 && url !== label ? ` (${url})` : "";
+            elements.push({
+              type: "text",
+              text: `${label}${suffix}`,
+              style: styleOrUndefined(activeStyle())
+            });
+          }
         }
         break;
       }
@@ -1428,7 +1545,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
           elements.push({
             type: "text",
             text: node.alt ?? node.identifier,
-            style: styleOrUndefined(baseStyle)
+            style: styleOrUndefined(activeStyle())
           });
           break;
         }
@@ -1442,7 +1559,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
             }
           ],
           ctx,
-          baseStyle
+          activeStyle()
         );
         elements.push(...asImage.elements);
         hoistedImages.push(...asImage.hoistedImages);
@@ -1454,7 +1571,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
         elements.push({
           type: "text",
           text: `[${String(n)}]`,
-          style: styleOrUndefined(baseStyle)
+          style: styleOrUndefined(activeStyle())
         });
         break;
       }
@@ -1462,7 +1579,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
         elements.push({
           type: "text",
           text: node.value,
-          style: styleOrUndefined({ ...baseStyle, code: true })
+          style: styleOrUndefined({ ...activeStyle(), code: true })
         });
         ctx.degradations.add({
           nodeType: "inlineMath",
@@ -1476,7 +1593,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
       default: {
         const text = toString2(node);
         if (text.length > 0) {
-          elements.push({ type: "text", text, style: styleOrUndefined(baseStyle) });
+          elements.push({ type: "text", text, style: styleOrUndefined(activeStyle()) });
         }
         break;
       }
@@ -1545,7 +1662,7 @@ function truncateLabel(label, max) {
   if (label.length <= max) {
     return { text: label, truncated: false };
   }
-  return { text: `${label.slice(0, Math.max(0, max - 1))}${ELLIPSIS}`, truncated: true };
+  return { text: `${sliceSurrogateSafe(label, Math.max(0, max - 1))}${ELLIPSIS}`, truncated: true };
 }
 function hoistedImageBlock(h, ctx) {
   return {
@@ -1566,7 +1683,7 @@ function clampSectionText(text, ctx, nodeType) {
     reason: "Section text truncated to 3000 chars",
     path: ctx.path
   });
-  return text.slice(0, SECTION_TEXT_MAX_CHARS);
+  return sliceSurrogateSafe(text, SECTION_TEXT_MAX_CHARS);
 }
 function preformattedRichText(text, language) {
   return {
@@ -1592,7 +1709,7 @@ function clampImageText(value, ctx, field) {
     reason: `Image ${field} truncated to ${String(IMAGE_ALT_MAX_CHARS)} chars`,
     path: ctx.path
   });
-  return value.slice(0, IMAGE_ALT_MAX_CHARS);
+  return sliceSurrogateSafe(value, IMAGE_ALT_MAX_CHARS);
 }
 function styleOrUndefined(style) {
   if (style.bold === true || style.italic === true || style.strike === true || style.code === true || style.underline === true) {
@@ -1600,7 +1717,94 @@ function styleOrUndefined(style) {
   }
   return void 0;
 }
-var MENTION_RE = /(?<![A-Za-z0-9._-])@([a-zA-Z0-9._-]{1,64})|(?<![A-Za-z0-9_-])#([a-zA-Z0-9_-]{1,80})/g;
+var SLACK_ENTITY_CANDIDATE_RE = /<([@#!][^<>]{1,340}|(?:https?:|mailto:)[^<>|]{1,3000}\|[^<>]{1,300})>/gi;
+var SLACK_USER_RE = /^@([UW][A-Z0-9]{1,60})(?:\|[^>]{0,300})?$/;
+var SLACK_CHANNEL_RE = /^#([CDG][A-Z0-9]{1,60})(?:\|[^>]{0,300})?$/;
+var SLACK_USERGROUP_RE = /^!subteam\^(S[A-Z0-9]{1,60})(?:\|[^>]{0,300})?$/;
+var SLACK_BROADCAST_RE = /^!(here|channel|everyone)(?:\|[^>]{0,300})?$/;
+var SLACK_DATE_RE = /^!date\^(\d{1,13})\^([^^|]{1,300})(?:\^([^^|]{1,3000}))?(?:\|([^]{0,300}))?$/;
+var SLACK_LINK_RE = /^((?:https?:|mailto:)[^|]{1,3000})\|([^]{1,300})$/i;
+function slackEntityElement(inner, style) {
+  const labeledLink = SLACK_LINK_RE.exec(inner);
+  if (labeledLink?.[1] !== void 0 && labeledLink[2] !== void 0) {
+    if (!isValidLinkUrl(labeledLink[1])) {
+      return void 0;
+    }
+    return {
+      type: "link",
+      url: labeledLink[1],
+      text: labeledLink[2],
+      style: styleOrUndefined(style)
+    };
+  }
+  const user = SLACK_USER_RE.exec(inner);
+  if (user?.[1] !== void 0) {
+    return { type: "user", user_id: user[1], style: styleOrUndefined(style) };
+  }
+  const channel = SLACK_CHANNEL_RE.exec(inner);
+  if (channel?.[1] !== void 0) {
+    return { type: "channel", channel_id: channel[1], style: styleOrUndefined(style) };
+  }
+  const usergroup = SLACK_USERGROUP_RE.exec(inner);
+  if (usergroup?.[1] !== void 0) {
+    return { type: "usergroup", usergroup_id: usergroup[1], style: styleOrUndefined(style) };
+  }
+  const broadcast = SLACK_BROADCAST_RE.exec(inner);
+  if (broadcast !== null) {
+    const range = broadcast[1];
+    if (range === "here" || range === "channel" || range === "everyone") {
+      return { type: "broadcast", range, style: styleOrUndefined(style) };
+    }
+  }
+  const date = SLACK_DATE_RE.exec(inner);
+  if (date?.[1] !== void 0 && date[2] !== void 0) {
+    const timestamp = Number(date[1]);
+    if (Number.isSafeInteger(timestamp)) {
+      return {
+        type: "date",
+        timestamp,
+        format: date[2],
+        url: date[3],
+        fallback: date[4],
+        style: styleOrUndefined(style)
+      };
+    }
+  }
+  return void 0;
+}
+function slackEntitySplit(value, style, emit) {
+  SLACK_ENTITY_CANDIDATE_RE.lastIndex = 0;
+  let match = SLACK_ENTITY_CANDIDATE_RE.exec(value);
+  if (match === null) {
+    return void 0;
+  }
+  const out = [];
+  let last = 0;
+  let sawEntity = false;
+  while (match !== null) {
+    const element = slackEntityElement(match[1] ?? "", style);
+    if (element !== void 0) {
+      sawEntity = true;
+      if (match.index > last) {
+        out.push(...emit(value.slice(last, match.index)));
+      }
+      out.push(element);
+      last = match.index + match[0].length;
+    }
+    match = SLACK_ENTITY_CANDIDATE_RE.exec(value);
+  }
+  if (!sawEntity) {
+    return void 0;
+  }
+  if (last < value.length) {
+    out.push(...emit(value.slice(last)));
+  }
+  return out;
+}
+function slackEntityRichTextInlines(value, style) {
+  return slackEntitySplit(value, style, (slice) => emitTextWithEmoji(slice, style));
+}
+var MENTION_RE = /(?<![A-Za-z0-9._-])@([a-zA-Z0-9_-](?:[a-zA-Z0-9._-]{0,62}[a-zA-Z0-9_-])?)|(?<![A-Za-z0-9_-])#([a-zA-Z0-9_-]{1,80})/g;
 function phrasingNeedsMentionResolution(nodes, ctx) {
   const resolvers = ctx.config.mentionResolvers;
   if (resolvers?.resolveUser === void 0 && resolvers?.resolveChannel === void 0) {
@@ -1611,13 +1815,23 @@ function phrasingNeedsMentionResolution(nodes, ctx) {
   return MENTION_RE.test(plain);
 }
 function emitTextWithMentionsAndEmoji(node, style, ctx) {
+  const viaEntities = slackEntitySplit(
+    node.value,
+    style,
+    (slice) => emitMentionsAndEmoji(slice, style, ctx)
+  );
+  if (viaEntities !== void 0) {
+    return viaEntities;
+  }
+  return emitMentionsAndEmoji(node.value, style, ctx);
+}
+function emitMentionsAndEmoji(value, style, ctx) {
   const resolvers = ctx.config.mentionResolvers;
   const canUser = resolvers?.resolveUser !== void 0;
   const canChannel = resolvers?.resolveChannel !== void 0;
   if (!canUser && !canChannel) {
-    return emitTextWithEmoji(node.value, style);
+    return emitTextWithEmoji(value, style);
   }
-  const value = node.value;
   const out = [];
   MENTION_RE.lastIndex = 0;
   let last = 0;
@@ -1667,13 +1881,8 @@ function emitTextWithEmoji(value, style) {
     if (start > last) {
       out.push({ type: "text", text: value.slice(last, start), style: styleOrUndefined(style) });
     }
-    const name = match[1] ?? "";
-    if (KNOWN_SLACK_EMOJI.has(name)) {
-      const emoji = { type: "emoji", name };
-      out.push(emoji);
-    } else {
-      out.push({ type: "text", text: match[0], style: styleOrUndefined(style) });
-    }
+    const emoji = { type: "emoji", name: match[1] ?? "" };
+    out.push(emoji);
     last = start + match[0].length;
     match = EMOJI_SHORTCODE_RE.exec(value);
   }
@@ -1685,9 +1894,53 @@ function emitTextWithEmoji(value, style) {
   }
   return out;
 }
+function reassembleSlackLabeledLink(work, i, style) {
+  const lead = work[i];
+  const linkNode = work[i + 1];
+  const tail = work[i + 2];
+  if (lead?.type !== "text" || !lead.value.endsWith("<")) {
+    return void 0;
+  }
+  if (linkNode?.type !== "link" || tail?.type !== "text") {
+    return void 0;
+  }
+  const url = linkNode.url;
+  const pipeIndex = url.indexOf("|");
+  if (pipeIndex <= 0 || !HTTP_URL_RE.test(url)) {
+    return void 0;
+  }
+  if (phrasingToPlain(linkNode.children) !== url) {
+    return void 0;
+  }
+  const closeIndex = tail.value.indexOf(">");
+  if (closeIndex === -1) {
+    return void 0;
+  }
+  const realUrl = url.slice(0, pipeIndex);
+  if (!isValidLinkUrl(realUrl)) {
+    return void 0;
+  }
+  const label = `${url.slice(pipeIndex + 1)}${tail.value.slice(0, closeIndex)}`;
+  if (label.length === 0) {
+    return void 0;
+  }
+  return {
+    leadingText: { type: "text", value: lead.value.slice(0, -1) },
+    link: { type: "link", url: realUrl, text: label, style: styleOrUndefined(style) },
+    trailingText: { type: "text", value: tail.value.slice(closeIndex + 1) }
+  };
+}
 function emitLink(node, ctx, style) {
   const url = node.url;
   const text = phrasingToPlain(node.children);
+  const pipeIndex = url.indexOf("|");
+  if (pipeIndex > 0 && HTTP_URL_RE.test(url) && text === url) {
+    const realUrl = url.slice(0, pipeIndex);
+    const label = url.slice(pipeIndex + 1);
+    if (label.length > 0 && isValidLinkUrl(realUrl)) {
+      return [{ type: "link", url: realUrl, text: label, style: styleOrUndefined(style) }];
+    }
+  }
   if (!isValidLinkUrl(url)) {
     ctx.degradations.add({
       nodeType: "link",
@@ -1696,7 +1949,7 @@ function emitLink(node, ctx, style) {
       reason: "Invalid or oversized URL",
       path: ctx.path
     });
-    const suffix = url.length > 0 ? ` (${url})` : "";
+    const suffix = url.length > 0 && url !== text ? ` (${url})` : "";
     return [{ type: "text", text: `${text}${suffix}`, style: styleOrUndefined(style) }];
   }
   const link = {
@@ -1733,9 +1986,45 @@ function isValidLinkUrl(url) {
   if (url.length === 0 || url.length > IMAGE_URL_MAX_CHARS) {
     return false;
   }
-  return HTTP_URL_RE.test(url) || url.startsWith("#") || url.startsWith("/");
+  return HTTP_URL_RE.test(url);
+}
+function anchorInline(anchor, ctx) {
+  const label = anchor.textParts.join("");
+  if (anchor.valid) {
+    return {
+      type: "link",
+      url: anchor.href,
+      text: label.length > 0 ? label : anchor.href,
+      style: styleOrUndefined(anchor.style)
+    };
+  }
+  ctx.degradations.add({
+    nodeType: "link",
+    from: "link",
+    to: "text",
+    reason: "Invalid or oversized URL",
+    path: ctx.path
+  });
+  const base = label.length > 0 ? label : anchor.href;
+  const suffix = label.length > 0 && anchor.href.length > 0 && anchor.href !== label ? ` (${anchor.href})` : "";
+  return { type: "text", text: `${base}${suffix}`, style: styleOrUndefined(anchor.style) };
+}
+var HTML_STYLE_OPEN_RE = /^<(b|strong|i|em|s|del|code)(\s+[^>]{0,200})?>$/i;
+var HTML_STYLE_CLOSE_RE = /^<\/(b|strong|i|em|s|del|code)\s*>$/i;
+function htmlTagStyle(base, tag) {
+  const t = tag.toLowerCase();
+  if (t === "b" || t === "strong") {
+    return { ...base, bold: true };
+  }
+  if (t === "i" || t === "em") {
+    return { ...base, italic: true };
+  }
+  if (t === "s" || t === "del") {
+    return { ...base, strike: true };
+  }
+  return { ...base, code: true };
 }
-var INLINE_TAG_RE = /<\/?(b|strong|i|em|s|del|code|br|a)(\s+[^>]{0,200})?>|[^<]+/gi;
+var INLINE_TAG_RE = /<\/?(b|strong|i|em|s|del|code|br|a)(\s+[^>]{0,200})?\s*\/?>|<[^>]{0,200}>|[^<]+|</gi;
 function emitInlineHtml(html, style, ctx) {
   const out = [];
   const stack = [];
@@ -1743,11 +2032,15 @@ function emitInlineHtml(html, style, ctx) {
   let openAnchor;
   INLINE_TAG_RE.lastIndex = 0;
   let m = INLINE_TAG_RE.exec(html);
-  let matched = false;
+  let strippedUnknown = false;
   while (m !== null) {
-    matched = true;
     const token = m[0];
-    if (token.startsWith("<")) {
+    if (token.startsWith("<") && token.length > 1 && m[1] === void 0) {
+      strippedUnknown = true;
+      m = INLINE_TAG_RE.exec(html);
+      continue;
+    }
+    if (token.startsWith("<") && m[1] !== void 0) {
       const tag = (m[1] ?? "").toLowerCase();
       const closing = token.startsWith("</");
       if (tag === "br") {
@@ -1758,13 +2051,7 @@ function emitInlineHtml(html, style, ctx) {
         }
       } else if (closing) {
         if (tag === "a" && openAnchor !== void 0) {
-          const label = openAnchor.textParts.join("");
-          out.push({
-            type: "link",
-            url: openAnchor.href,
-            text: label.length > 0 ? label : openAnchor.href,
-            style: styleOrUndefined(openAnchor.style)
-          });
+          out.push(anchorInline(openAnchor, ctx));
           openAnchor = void 0;
         }
         stack.pop();
@@ -1773,8 +2060,11 @@ function emitInlineHtml(html, style, ctx) {
         const hrefMatch = /href\s*=\s*["']([^"']{0,3000})["']/i.exec(token);
         const href = hrefMatch?.[1];
         stack.push({ tag, style: current });
-        if (href !== void 0 && isValidLinkUrl(href)) {
-          openAnchor = { href, style: current, textParts: [] };
+        if (href !== void 0) {
+          if (openAnchor !== void 0) {
+            out.push(anchorInline(openAnchor, ctx));
+          }
+          openAnchor = { href, style: current, textParts: [], valid: isValidLinkUrl(href) };
         }
       } else {
         const next = { ...current };
@@ -1795,15 +2085,9 @@ function emitInlineHtml(html, style, ctx) {
     m = INLINE_TAG_RE.exec(html);
   }
   if (openAnchor !== void 0) {
-    const label = openAnchor.textParts.join("");
-    out.push({
-      type: "link",
-      url: openAnchor.href,
-      text: label.length > 0 ? label : openAnchor.href,
-      style: styleOrUndefined(openAnchor.style)
-    });
+    out.push(anchorInline(openAnchor, ctx));
   }
-  if (!matched) {
+  if (strippedUnknown) {
     ctx.degradations.add({
       nodeType: "html",
       from: "html",
@@ -1811,10 +2095,6 @@ function emitInlineHtml(html, style, ctx) {
       reason: "Unrecognized inline HTML stripped to text",
       path: ctx.path
     });
-    const stripped = html.replace(/<[^>]{0,200}>/g, "");
-    if (stripped.length > 0) {
-      out.push({ type: "text", text: stripped, style: styleOrUndefined(style) });
-    }
   }
   return out;
 }
@@ -2046,10 +2326,13 @@ function emitPlainHeader(heading, withLevel) {
   const block = {
     type: "header",
     text: { type: "plain_text", text: plain.length > 0 ? plain : " " },
-    level: withLevel ? heading.depth : void 0
+    level: withLevel ? headerLevelOf(heading.depth) : void 0
   };
   return [block];
 }
+function headerLevelOf(depth) {
+  return depth === 1 || depth === 2 || depth === 3 || depth === 4 ? depth : void 0;
+}
 function emitRichHeading(heading, ctx, hoistImages) {
   const plain = phrasingToPlain(heading.children);
   const depth = heading.depth;
@@ -2158,6 +2441,20 @@ ${body}`, ctx, "html.details.section")
         }
       ];
     }
+    const entityInlines = slackEntityRichTextInlines(html.value.trim(), {});
+    if (entityInlines !== void 0) {
+      return [
+        {
+          budget: { blocks: 1 },
+          emit: () => [
+            {
+              type: "rich_text",
+              elements: [{ type: "rich_text_section", elements: entityInlines }]
+            }
+          ]
+        }
+      ];
+    }
     return [
       {
         budget: { blocks: 1 },
@@ -2198,7 +2495,7 @@ function clampContainerTitle(text, ctx) {
     reason: `Container title truncated to ${String(CONTAINER_TITLE_MAX_CHARS)} chars`,
     path: ctx.path
   });
-  return text.slice(0, CONTAINER_TITLE_MAX_CHARS);
+  return sliceSurrogateSafe(text, CONTAINER_TITLE_MAX_CHARS);
 }
 
 // src/adapters/list-adapter.ts
@@ -2278,27 +2575,51 @@ function emitListTree(list, indent, ctx) {
     });
     effectiveIndent = RICH_TEXT_LIST_INDENT_MAX;
   }
-  const sections = [];
-  const nested = [];
+  const ordered = list.ordered === true;
+  const startOffset = ordered && list.start !== null && list.start !== void 0 && list.start > 1 ? list.start - 1 : 0;
+  const out = [];
   const hoistedImages = [];
-  for (const item of list.children) {
+  let pendingSections = [];
+  const flush = (lastIndex) => {
+    if (pendingSections.length === 0) {
+      return;
+    }
+    const chunkStartIndex = lastIndex - pendingSections.length + 1;
+    const offset = startOffset + chunkStartIndex;
+    out.push({
+      type: "rich_text_list",
+      style: ordered ? "ordered" : "bullet",
+      elements: pendingSections,
+      indent: effectiveIndent,
+      offset: ordered && offset > 0 ? offset : void 0
+    });
+    pendingSections = [];
+  };
+  for (const [index, item] of list.children.entries()) {
     const { section, childLists, hoistedImages: itemImages } = emitListItem(item, ctx);
-    sections.push(section);
+    pendingSections.push(section);
     hoistedImages.push(...itemImages);
+    if (childLists.length === 0) {
+      continue;
+    }
+    flush(index);
     for (const child of childLists) {
       const nestedResult = emitListTree(child, effectiveIndent + 1, ctx);
-      nested.push(...nestedResult.elements);
+      out.push(...nestedResult.elements);
       hoistedImages.push(...nestedResult.hoistedImages);
     }
   }
-  const primary = {
-    type: "rich_text_list",
-    style: list.ordered === true ? "ordered" : "bullet",
-    elements: sections.length > 0 ? sections : [{ type: "rich_text_section", elements: [{ type: "text", text: " " }] }],
-    indent: effectiveIndent,
-    offset: list.ordered === true && list.start !== null && list.start !== void 0 && list.start > 1 ? list.start - 1 : void 0
-  };
-  return { elements: [primary, ...nested], hoistedImages };
+  flush(list.children.length - 1);
+  if (out.length === 0) {
+    out.push({
+      type: "rich_text_list",
+      style: ordered ? "ordered" : "bullet",
+      elements: [{ type: "rich_text_section", elements: [{ type: "text", text: " " }] }],
+      indent: effectiveIndent,
+      offset: void 0
+    });
+  }
+  return { elements: out, hoistedImages };
 }
 function collectListItemPhrasing(item) {
   const phrasing = [];
@@ -2615,7 +2936,19 @@ async function tryRenderers(source, ctx) {
     if (!renderer.canRender(req)) {
       continue;
     }
-    const result = await renderer.render(req);
+    let result;
+    try {
+      result = await renderer.render(req);
+    } catch (err) {
+      ctx.degradations.add({
+        nodeType: "code.mermaid",
+        from: "image.render",
+        to: "skip",
+        reason: `Renderer failed: ${err instanceof Error ? err.message : String(err)}`,
+        path: ctx.path
+      });
+      continue;
+    }
     if (result === null) {
       continue;
     }
@@ -2647,7 +2980,19 @@ async function tryRenderers(source, ctx) {
       });
       continue;
     }
-    const uploaded = await uploader.upload(result);
+    let uploaded;
+    try {
+      uploaded = await uploader.upload(result);
+    } catch (err) {
+      ctx.degradations.add({
+        nodeType: "code.mermaid",
+        from: "image.bytes",
+        to: "skip",
+        reason: `Slack upload failed: ${err instanceof Error ? err.message : String(err)}`,
+        path: ctx.path
+      });
+      continue;
+    }
     return {
       type: "image",
       alt_text: clampImageText(result.altText, ctx, "alt_text"),
@@ -2710,11 +3055,11 @@ function emitParagraph(paragraph, emitCtx, loneImage, hoistImages) {
     const img = loneImage;
     if (isPublicImageUrl(img.url)) {
       const altRaw = img.alt ?? "image";
-      const alt = clampImageText(altRaw.length > 0 ? altRaw : "image", emitCtx, "alt_text");
+      const alt2 = clampImageText(altRaw.length > 0 ? altRaw : "image", emitCtx, "alt_text");
       const block = {
         type: "image",
         image_url: img.url,
-        alt_text: alt,
+        alt_text: alt2,
         title: img.title !== null && img.title !== void 0 && img.title.length > 0 ? {
           type: "plain_text",
           text: clampImageText(img.title, emitCtx, "title")
@@ -2722,20 +3067,23 @@ function emitParagraph(paragraph, emitCtx, loneImage, hoistImages) {
       };
       return [block];
     }
+    const linkable = isValidLinkUrl(img.url);
     emitCtx.degradations.add({
       nodeType: "image",
       from: "image",
-      to: "section.link",
+      to: linkable ? "section.link" : "section.text",
       reason: "Non-public or invalid image URL",
       path: emitCtx.path
     });
-    const linkText = `<${img.url}|${img.alt ?? img.url}>`;
+    const alt = img.alt ?? "";
+    const label = alt.length > 0 ? alt : img.url.length > 0 ? img.url : "image";
+    const fallbackText = linkable ? `<${img.url}|${label}>` : img.url.length > 0 && img.url !== label ? `${label} (${img.url})` : label;
     return [
       {
         type: "section",
         text: {
           type: "mrkdwn",
-          text: clampSectionText(linkText, emitCtx, "section")
+          text: clampSectionText(fallbackText, emitCtx, "section")
         }
       }
     ];
@@ -2795,14 +3143,15 @@ var TableAdapter = class {
     return node.type === "table";
   }
   plan(node, ctx) {
-    const table = node;
+    const table = normalizeTableRows(node, ctx);
     const rowCount = table.children.length;
     const colCount = table.children[0]?.children.length ?? 0;
-    const cellChars = countEmittedCellChars(table, ctx);
     if (colCount > TABLE_MAX_COLS) {
+      const cellChars = countEmittedCellChars(table, ctx, "table");
       return markdownThenAscii(table, cellChars, "Table exceeds 20 columns");
     }
     if (rowCount <= TABLE_PREFERRED_MAX_ROWS) {
+      const cellChars = countEmittedCellChars(table, ctx, "table");
       return [
         {
           requires: ["tableBlock"],
@@ -2817,11 +3166,12 @@ var TableAdapter = class {
     const dataRows = Math.max(0, rowCount - 1);
     if (dataRows <= DATA_TABLE_MAX_DATA_ROWS) {
       const preferredTable = truncateRows(table, TABLE_PREFERRED_MAX_ROWS);
-      const preferredChars = countEmittedCellChars(preferredTable, ctx);
+      const preferredChars = countEmittedCellChars(preferredTable, ctx, "table");
+      const dataTableChars = countEmittedCellChars(table, ctx, "data_table");
       return [
         {
           requires: ["dataTable"],
-          budget: { blocks: 1, dataTableChars: cellChars },
+          budget: { blocks: 1, dataTableChars },
           emit: (emitCtx) => {
             emitCtx.degradations.add({
               nodeType: "table",
@@ -2847,11 +3197,11 @@ var TableAdapter = class {
             return [buildTableBlock(preferredTable, emitCtx)];
           }
         },
-        ...markdownThenAscii(table, cellChars, "native table unavailable")
+        ...markdownThenAscii(table, dataTableChars, "native table unavailable")
       ];
     }
     const dataChunk = truncateRows(table, DATA_TABLE_MAX_DATA_ROWS + 1);
-    const dataChunkChars = countEmittedCellChars(dataChunk, ctx);
+    const dataChunkChars = countEmittedCellChars(dataChunk, ctx, "data_table");
     return [
       {
         requires: ["dataTable"],
@@ -2867,10 +3217,37 @@ var TableAdapter = class {
           return [buildDataTable(dataChunk, emitCtx)];
         }
       },
-      ...markdownThenAscii(table, cellChars, "oversized table")
+      ...markdownThenAscii(table, dataChunkChars, "oversized table")
     ];
   }
 };
+function normalizeTableRows(table, ctx) {
+  const colCount = table.children[0]?.children.length ?? 0;
+  if (colCount === 0 || table.children.every((row) => row.children.length === colCount)) {
+    return table;
+  }
+  const children = table.children.map((row, rowIndex) => {
+    if (row.children.length === colCount) {
+      return row;
+    }
+    if (row.children.length > colCount) {
+      ctx.degradations.add({
+        nodeType: "table",
+        from: `row[${String(rowIndex)}]: ${String(row.children.length)} cells`,
+        to: `${String(colCount)} cells`,
+        reason: "Cells beyond the header column count dropped (GFM ignores the excess)",
+        path: ctx.path
+      });
+      return { ...row, children: row.children.slice(0, colCount) };
+    }
+    const padding = Array.from(
+      { length: colCount - row.children.length },
+      () => ({ type: "tableCell", children: [] })
+    );
+    return { ...row, children: [...row.children, ...padding] };
+  });
+  return { ...table, children };
+}
 function markdownThenAscii(table, cellChars, reason) {
   const md = toPipeMarkdown(table);
   return [
@@ -2916,7 +3293,7 @@ function buildTableBlock(table, ctx) {
 }
 function buildDataTable(table, ctx) {
   const captionRaw = ctx.precedingHeading !== void 0 && ctx.precedingHeading.length > 0 ? ctx.precedingHeading : "Table";
-  const caption = captionRaw.slice(0, 150);
+  const caption = sliceSurrogateSafe(captionRaw, 150);
   if (captionRaw.length > 150) {
     ctx.degradations.add({
       nodeType: "table",
@@ -2927,12 +3304,7 @@ function buildDataTable(table, ctx) {
     });
   }
   const rows = table.children.map(
-    (row, rowIndex) => row.children.map((cell) => {
-      if (rowIndex === 0) {
-        return { type: "raw_text", text: toString5(cell) };
-      }
-      return cellToSlack(cell, ctx, false);
-    })
+    (row, rowIndex) => row.children.map((cell) => cellForDataTable(cell, ctx, rowIndex))
   );
   return {
     type: "data_table",
@@ -2942,25 +3314,31 @@ function buildDataTable(table, ctx) {
     row_header_column_index: 0
   };
 }
+function cellForDataTable(cell, ctx, rowIndex) {
+  if (rowIndex === 0) {
+    return { type: "raw_text", text: toString5(cell) };
+  }
+  return cellToSlack(cell, ctx, false);
+}
 function cellToSlack(cell, ctx, header) {
-  const plain = toString5(cell);
-  const styled = cell.children.some(
-    (c) => c.type === "strong" || c.type === "emphasis" || c.type === "delete" || c.type === "link" || c.type === "inlineCode"
-  );
-  if (!styled) {
-    if (!header && /^-?\d+(\.\d+)?$/.test(plain.trim())) {
-      const value = Number(plain.trim());
-      return { type: "raw_number", value, text: plain.trim() };
+  const inline = emitPhrasing(cell.children, ctx);
+  const single = inline.elements.length === 1 ? inline.elements[0] : void 0;
+  const isEmpty = inline.elements.length === 0;
+  const isSingleUnstyledText = single?.type === "text" && single.style === void 0;
+  const plainText = isEmpty ? toString5(cell) : isSingleUnstyledText ? single.text : void 0;
+  if (plainText !== void 0) {
+    const trimmed = plainText.trim();
+    if (!header && /^-?\d+(\.\d+)?$/.test(trimmed)) {
+      return { type: "raw_number", value: Number(trimmed), text: trimmed };
     }
-    return { type: "raw_text", text: plain };
+    return { type: "raw_text", text: plainText };
   }
-  const inline = emitPhrasing(cell.children, ctx);
   const rich = {
     type: "rich_text",
     elements: [
       {
         type: "rich_text_section",
-        elements: inline.elements.length > 0 ? inline.elements : [{ type: "text", text: plain }]
+        elements: inline.elements
       }
     ]
   };
@@ -2987,12 +3365,13 @@ function columnSettings(table) {
   }
   return settings;
 }
-function countEmittedCellChars(table, ctx) {
+function countEmittedCellChars(table, ctx, mode) {
   const probe = ctx.withDegradations(new RecordingDegradationCollector());
   let n = 0;
   for (const [rowIndex, row] of table.children.entries()) {
     for (const cell of row.children) {
-      n += slackCellCharCount(cellToSlack(cell, probe, rowIndex === 0));
+      const emitted = mode === "data_table" ? cellForDataTable(cell, probe, rowIndex) : cellToSlack(cell, probe, rowIndex === 0);
+      n += slackCellCharCount(emitted);
     }
   }
   return n;
@@ -3115,27 +3494,50 @@ function emitUnicodeTaskTree(list, indent, ctx) {
     });
     effectiveIndent = RICH_TEXT_LIST_INDENT_MAX;
   }
-  const sections = [];
-  const nested = [];
+  const out = [];
+  let pendingSections = [];
+  const flush = () => {
+    if (pendingSections.length === 0) {
+      return;
+    }
+    out.push({
+      type: "rich_text_list",
+      style: "bullet",
+      elements: pendingSections,
+      indent: effectiveIndent
+    });
+    pendingSections = [];
+  };
   for (const item of list.children) {
     const prefix = item.checked === true ? "\u2611 " : item.checked === false ? "\u2610 " : "";
-    sections.push({
+    pendingSections.push({
       type: "rich_text_section",
       elements: [{ type: "text", text: `${prefix}${itemText(item)}` }]
     });
+    const childLists = [];
     for (const child of item.children) {
       if (child.type === "list") {
-        nested.push(...emitUnicodeTaskTree(child, effectiveIndent + 1, ctx));
+        childLists.push(child);
       }
     }
+    if (childLists.length === 0) {
+      continue;
+    }
+    flush();
+    for (const child of childLists) {
+      out.push(...emitUnicodeTaskTree(child, effectiveIndent + 1, ctx));
+    }
   }
-  const primary = {
-    type: "rich_text_list",
-    style: "bullet",
-    elements: sections.length > 0 ? sections : [{ type: "rich_text_section", elements: [{ type: "text", text: " " }] }],
-    indent: effectiveIndent
-  };
-  return [primary, ...nested];
+  flush();
+  if (out.length === 0) {
+    out.push({
+      type: "rich_text_list",
+      style: "bullet",
+      elements: [{ type: "rich_text_section", elements: [{ type: "text", text: " " }] }],
+      indent: effectiveIndent
+    });
+  }
+  return out;
 }
 
 // src/adapters/thematic-break-adapter.ts
@@ -3383,12 +3785,10 @@ export {
   CapabilityPresetName,
   ConfigurationError,
   ConversionContext,
-  ConversionStrategy as ConversionStrategies,
   DeterministicPlainTextRenderer,
   MermaidPieParser,
   MermaidXyChartParser,
   MessageAssembler,
-  OverflowMode as OverflowModes,
   RecordingDegradationCollector,
   RemarkMarkdownParser,
   SlackMarkConverter,