slackmark 0.3.0 → 0.5.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",
@@ -9,7 +18,6 @@ var CapabilityPresetName = {
   D2026_06: "2026-06"
 };
 var ALL_OFF = {
-  richText: false,
   markdownBlock: false,
   tableBlock: false,
   preformattedLanguage: false,
@@ -18,10 +26,7 @@ var ALL_OFF = {
   dataVisualization: false,
   containerBlock: false
 };
-var CONSERVATIVE = {
-  ...ALL_OFF,
-  richText: true
-};
+var CONSERVATIVE = { ...ALL_OFF };
 var P_2025_02 = {
   ...CONSERVATIVE,
   markdownBlock: true
@@ -59,12 +64,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,8 +81,11 @@ 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";
+  return 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";
 }
 
 // src/constants.ts
@@ -298,6 +307,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",
@@ -398,7 +430,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) {
@@ -417,7 +449,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 });
     }
@@ -622,7 +654,7 @@ function inlinesToPlain(elements) {
         parts.push(`@${el.range}`);
         break;
       case "date":
-        parts.push(el.fallback ?? el.format);
+        parts.push(el.fallback ?? formatDateTokensUtc(el.timestamp, el.format));
         break;
       default:
         break;
@@ -630,6 +662,101 @@ function inlinesToPlain(elements) {
   }
   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) {
@@ -869,15 +996,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 = {
@@ -967,7 +1085,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;
@@ -992,11 +1110,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);
@@ -1105,7 +1225,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) {
@@ -1118,17 +1238,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 = [];
@@ -1139,8 +1280,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;
@@ -1164,8 +1343,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;
 }
@@ -1175,45 +1357,6 @@ 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 HTTP_URL_RE = /^(https?:|mailto:)/i;
 var IMAGE_EXT_RE = /\.(png|jpe?g|gif)(?:\?|#|$)/i;
 function emitPhrasing(nodes, ctx, baseStyle = {}) {
@@ -1221,26 +1364,24 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
   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 (let i = 0; i < work.length; i += 1) {
     const node = work[i];
     if (pendingAnchor === void 0) {
-      const reassembled = reassembleSlackLabeledLink(work, i, baseStyle);
+      const reassembled = reassembleSlackLabeledLink(work, i, activeStyle());
       if (reassembled !== void 0) {
         if (reassembled.leadingText.value.length > 0) {
-          elements.push(...emitTextWithMentionsAndEmoji(reassembled.leadingText, baseStyle, ctx));
+          elements.push(
+            ...emitTextWithMentionsAndEmoji(reassembled.leadingText, activeStyle(), ctx)
+          );
         }
         elements.push(reassembled.link);
         if (reassembled.trailingText.value.length > 0) {
@@ -1270,7 +1411,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
     }
     if (node.type === "html") {
       const trimmed = node.value.trim();
-      const entityInlines = slackEntityRichTextInlines(trimmed, baseStyle);
+      const entityInlines = slackEntityRichTextInlines(trimmed, activeStyle());
       if (entityInlines !== void 0) {
         elements.push(...entityInlines);
         continue;
@@ -1279,28 +1420,45 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
       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);
@@ -1308,7 +1466,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;
@@ -1317,21 +1475,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": {
@@ -1346,22 +1504,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;
       }
@@ -1371,7 +1540,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
           elements.push({
             type: "text",
             text: node.alt ?? node.identifier,
-            style: styleOrUndefined(baseStyle)
+            style: styleOrUndefined(activeStyle())
           });
           break;
         }
@@ -1385,7 +1554,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
             }
           ],
           ctx,
-          baseStyle
+          activeStyle()
         );
         elements.push(...asImage.elements);
         hoistedImages.push(...asImage.hoistedImages);
@@ -1397,7 +1566,7 @@ function emitPhrasing(nodes, ctx, baseStyle = {}) {
         elements.push({
           type: "text",
           text: `[${String(n)}]`,
-          style: styleOrUndefined(baseStyle)
+          style: styleOrUndefined(activeStyle())
         });
         break;
       }
@@ -1405,13 +1574,13 @@ 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",
           from: "inlineMath",
           to: "style.code",
-          reason: "Math rendering not configured; emitted as inline code",
+          reason: "Math is emitted as preformatted/code text",
           path: ctx.path
         });
         break;
@@ -1419,7 +1588,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;
       }
@@ -1488,7 +1657,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 {
@@ -1509,7 +1678,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 {
@@ -1535,7 +1704,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) {
@@ -1543,13 +1712,21 @@ function styleOrUndefined(style) {
   }
   return void 0;
 }
-var SLACK_ENTITY_CANDIDATE_RE = /<([@#!][^<>]{1,340}|(?:https?:|mailto:)[^<>|]{1,3000}\|[^<>]{1,300})>/gi;
+var SLACK_ENTITY_AT_RE = /<([@#!][^<>]{1,340}|(?:https?:|mailto:)[^<>|]{1,3000}\|[^<>]{1,300})>/iy;
+var CHAR_LT = 60;
+var CHAR_HASH = 35;
+var CHAR_AT = 64;
+var CHAR_COLON = 58;
 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;
+var MENTION_PATTERN = String.raw`(?<![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})`;
+var MENTION_RE = new RegExp(MENTION_PATTERN, "g");
+var MENTION_AT_RE = new RegExp(MENTION_PATTERN, "y");
+var EMOJI_AT_RE = /(?<![A-Za-z0-9]):([a-z0-9_+-]{1,64}):(?![A-Za-z0-9])/y;
 function slackEntityElement(inner, style) {
   const labeledLink = SLACK_LINK_RE.exec(inner);
   if (labeledLink?.[1] !== void 0 && labeledLink[2] !== void 0) {
@@ -1598,39 +1775,79 @@ function slackEntityElement(inner, 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;
-  }
+function scanTextRun(value, style, resolveUser, resolveChannel) {
+  const scanMentions = resolveUser !== void 0 || resolveChannel !== void 0;
+  const styleOpt = styleOrUndefined(style);
   const out = [];
-  let last = 0;
   let sawEntity = false;
-  while (match !== null) {
-    const element = slackEntityElement(match[1] ?? "", style);
+  let i = 0;
+  let textStart = 0;
+  while (i < value.length) {
+    const ch = value.charCodeAt(i);
+    let element;
+    let tokenEnd = 0;
+    if (ch === CHAR_LT) {
+      SLACK_ENTITY_AT_RE.lastIndex = i;
+      const match = SLACK_ENTITY_AT_RE.exec(value);
+      if (match !== null) {
+        element = slackEntityElement(match[1] ?? "", style);
+        if (element !== void 0) {
+          tokenEnd = SLACK_ENTITY_AT_RE.lastIndex;
+          sawEntity = true;
+        }
+      }
+    } else if (scanMentions && (ch === CHAR_AT || ch === CHAR_HASH)) {
+      MENTION_AT_RE.lastIndex = i;
+      const match = MENTION_AT_RE.exec(value);
+      if (match !== null) {
+        const userHandle = match[1];
+        const channelName = match[2];
+        if (userHandle !== void 0 && resolveUser !== void 0) {
+          const userId = resolveUser(userHandle);
+          if (userId !== void 0 && userId.length > 0) {
+            element = { type: "user", user_id: userId, style: styleOpt };
+            tokenEnd = MENTION_AT_RE.lastIndex;
+          }
+        } else if (channelName !== void 0 && resolveChannel !== void 0) {
+          const channelId = resolveChannel(channelName);
+          if (channelId !== void 0 && channelId.length > 0) {
+            element = { type: "channel", channel_id: channelId, style: styleOpt };
+            tokenEnd = MENTION_AT_RE.lastIndex;
+          }
+        }
+      }
+    } else if (ch === CHAR_COLON) {
+      EMOJI_AT_RE.lastIndex = i;
+      const match = EMOJI_AT_RE.exec(value);
+      if (match !== null) {
+        const emoji = { type: "emoji", name: match[1] ?? "" };
+        element = emoji;
+        tokenEnd = EMOJI_AT_RE.lastIndex;
+      }
+    }
     if (element !== void 0) {
-      sawEntity = true;
-      if (match.index > last) {
-        out.push(...emit(value.slice(last, match.index)));
+      if (i > textStart) {
+        out.push({ type: "text", text: value.slice(textStart, i), style: styleOpt });
       }
       out.push(element);
-      last = match.index + match[0].length;
+      i = tokenEnd;
+      textStart = i;
+      continue;
     }
-    match = SLACK_ENTITY_CANDIDATE_RE.exec(value);
+    i += 1;
   }
-  if (!sawEntity) {
-    return void 0;
+  if (textStart < value.length) {
+    out.push({ type: "text", text: value.slice(textStart), style: styleOpt });
   }
-  if (last < value.length) {
-    out.push(...emit(value.slice(last)));
+  if (out.length === 0) {
+    out.push({ type: "text", text: value, style: styleOpt });
   }
-  return out;
+  return { elements: out, sawEntity };
 }
 function slackEntityRichTextInlines(value, style) {
-  return slackEntitySplit(value, style, (slice) => emitTextWithEmoji(slice, style));
+  const { elements, sawEntity } = scanTextRun(value, style);
+  return sawEntity ? elements : 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;
 function phrasingNeedsMentionResolution(nodes, ctx) {
   const resolvers = ctx.config.mentionResolvers;
   if (resolvers?.resolveUser === void 0 && resolvers?.resolveChannel === void 0) {
@@ -1641,89 +1858,8 @@ 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(value, style);
-  }
-  const out = [];
-  MENTION_RE.lastIndex = 0;
-  let last = 0;
-  let match = MENTION_RE.exec(value);
-  while (match !== null) {
-    const start = match.index;
-    if (start > last) {
-      out.push(...emitTextWithEmoji(value.slice(last, start), style));
-    }
-    const userHandle = match[1];
-    const channelName = match[2];
-    if (userHandle !== void 0 && canUser) {
-      const userId = resolvers.resolveUser?.(userHandle);
-      if (userId !== void 0 && userId.length > 0) {
-        out.push({ type: "user", user_id: userId, style: styleOrUndefined(style) });
-      } else {
-        out.push(...emitTextWithEmoji(match[0], style));
-      }
-    } else if (channelName !== void 0 && canChannel) {
-      const channelId = resolvers.resolveChannel?.(channelName);
-      if (channelId !== void 0 && channelId.length > 0) {
-        out.push({ type: "channel", channel_id: channelId, style: styleOrUndefined(style) });
-      } else {
-        out.push(...emitTextWithEmoji(match[0], style));
-      }
-    } else {
-      out.push(...emitTextWithEmoji(match[0], style));
-    }
-    last = start + match[0].length;
-    match = MENTION_RE.exec(value);
-  }
-  if (last < value.length) {
-    out.push(...emitTextWithEmoji(value.slice(last), style));
-  }
-  if (out.length === 0) {
-    out.push(...emitTextWithEmoji(value, style));
-  }
-  return out;
-}
-function emitTextWithEmoji(value, style) {
-  const out = [];
-  EMOJI_SHORTCODE_RE.lastIndex = 0;
-  let last = 0;
-  let match = EMOJI_SHORTCODE_RE.exec(value);
-  while (match !== null) {
-    const start = match.index;
-    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) });
-    }
-    last = start + match[0].length;
-    match = EMOJI_SHORTCODE_RE.exec(value);
-  }
-  if (last < value.length) {
-    out.push({ type: "text", text: value.slice(last), style: styleOrUndefined(style) });
-  }
-  if (out.length === 0) {
-    out.push({ type: "text", text: value, style: styleOrUndefined(style) });
-  }
-  return out;
+  return scanTextRun(node.value, style, resolvers?.resolveUser, resolvers?.resolveChannel).elements;
 }
 function reassembleSlackLabeledLink(work, i, style) {
   const lead = work[i];
@@ -1780,7 +1916,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 = {
@@ -1817,9 +1953,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 = [];
@@ -1827,11 +1999,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") {
@@ -1842,13 +2018,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();
@@ -1857,8 +2027,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 };
@@ -1879,15 +2052,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",
@@ -1895,10 +2062,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;
 }
@@ -2130,10 +2293,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;
@@ -2296,7 +2462,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
@@ -2376,27 +2542,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 = [];
@@ -2489,7 +2679,7 @@ function preformattedMath(value, withLang, ctx) {
     nodeType: "math",
     from: "math",
     to: "rich_text_preformatted",
-    reason: "No math renderer configured; emitting TeX source",
+    reason: "Math is emitted as preformatted/code text",
     path: ctx.path
   });
   return preformattedRichText(value, withLang ? "latex" : void 0);
@@ -2713,7 +2903,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;
     }
@@ -2745,7 +2947,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"),
@@ -2808,11 +3022,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")
@@ -2820,20 +3034,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")
         }
       }
     ];
@@ -2893,14 +3110,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"],
@@ -2915,11 +3133,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",
@@ -2945,11 +3164,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"],
@@ -2965,10 +3184,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 [
@@ -3014,7 +3260,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",
@@ -3025,12 +3271,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",
@@ -3040,25 +3281,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
       }
     ]
   };
@@ -3085,12 +3332,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;
@@ -3213,27 +3461,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
@@ -3308,117 +3579,37 @@ function validateBlocks(blocks) {
       message: `Too many blocks: ${String(blocks.length)} > ${String(MAX_BLOCKS_PER_MESSAGE)}`
     });
   }
-  let markdownChars = 0;
-  let tableChars = 0;
-  let dataTableChars = 0;
-  let charts = 0;
+  const counters = {
+    markdownChars: 0,
+    tableChars: 0,
+    dataTableChars: 0,
+    charts: 0
+  };
   blocks.forEach((block, i) => {
-    const path = `blocks[${String(i)}]`;
-    switch (block.type) {
-      case "header":
-        if (block.text.text.length > HEADER_TEXT_MAX_CHARS) {
-          issues.push({ path, message: "header text > 150" });
-        }
-        if (block.level !== void 0 && (block.level < 1 || block.level > 4)) {
-          issues.push({ path, message: "header level out of 1\u20134" });
-        }
-        break;
-      case "section":
-        if (block.text !== void 0 && block.text.text.length > SECTION_TEXT_MAX_CHARS) {
-          issues.push({ path, message: "section text > 3000" });
-        }
-        break;
-      case "image":
-        if (block.alt_text.length > IMAGE_ALT_MAX_CHARS) {
-          issues.push({ path, message: "image alt > 2000" });
-        }
-        if (block.image_url !== void 0 && block.image_url.length > IMAGE_URL_MAX_CHARS) {
-          issues.push({ path, message: "image_url > 3000" });
-        }
-        break;
-      case "context":
-        if (block.elements.length > CONTEXT_ELEMENTS_MAX) {
-          issues.push({ path, message: "context elements > 10" });
-        }
-        break;
-      case "markdown":
-        markdownChars += block.text.length;
-        break;
-      case "table": {
-        if (block.rows.length > TABLE_MAX_ROWS) {
-          issues.push({ path, message: "table rows > 100" });
-        }
-        for (const row of block.rows) {
-          if (row.length > TABLE_MAX_COLS) {
-            issues.push({ path, message: "table cols > 20" });
-          }
-          for (const cell of row) {
-            tableChars += cellCharCount(cell);
-          }
-        }
-        break;
-      }
-      case "data_table": {
-        if (block.rows.length > DATA_TABLE_MAX_DATA_ROWS + 1) {
-          issues.push({ path, message: "data_table rows > 201" });
-        }
-        for (const row of block.rows) {
-          if (row.length > TABLE_MAX_COLS) {
-            issues.push({ path, message: "data_table cols > 20" });
-          }
-          for (const cell of row) {
-            dataTableChars += cellCharCount(cell);
-          }
-        }
-        break;
-      }
-      case "data_visualization":
-        charts += 1;
-        if (block.title.length > CHART_TITLE_MAX_CHARS) {
-          issues.push({ path, message: "chart title > 50" });
-        }
-        validateChart(block, path, issues);
-        break;
-      case "container":
-        if (block.child_blocks.length > CONTAINER_CHILDREN_MAX) {
-          issues.push({ path, message: "container children > 10" });
-        }
-        if (block.title !== void 0 && block.title.text.length > CONTAINER_TITLE_MAX_CHARS) {
-          issues.push({ path, message: "container title > 150" });
-        }
-        break;
-      case "divider":
-      case "rich_text":
-        break;
-      default: {
-        const exhaustive = block;
-        void exhaustive;
-        break;
-      }
-    }
+    validateBlock(block, `blocks[${String(i)}]`, issues, counters, 0);
   });
-  if (markdownChars > MARKDOWN_CUMULATIVE_MAX_CHARS) {
+  if (counters.markdownChars > MARKDOWN_CUMULATIVE_MAX_CHARS) {
     issues.push({
       path: "$",
-      message: `markdown cumulative ${String(markdownChars)} > 12000`
+      message: `markdown cumulative ${String(counters.markdownChars)} > 12000`
     });
   }
-  if (tableChars > TABLE_CELL_CHARS_MAX) {
+  if (counters.tableChars > TABLE_CELL_CHARS_MAX) {
     issues.push({
       path: "$",
-      message: `table chars ${String(tableChars)} > 10000`
+      message: `table chars ${String(counters.tableChars)} > 10000`
     });
   }
-  if (dataTableChars > DATA_TABLE_CELL_CHARS_MAX) {
+  if (counters.dataTableChars > DATA_TABLE_CELL_CHARS_MAX) {
     issues.push({
       path: "$",
-      message: `data_table chars ${String(dataTableChars)} > 20000`
+      message: `data_table chars ${String(counters.dataTableChars)} > 20000`
     });
   }
-  if (charts > DATA_VISUALIZATION_MAX_PER_MESSAGE) {
+  if (counters.charts > DATA_VISUALIZATION_MAX_PER_MESSAGE) {
     issues.push({
       path: "$",
-      message: `charts ${String(charts)} > ${String(DATA_VISUALIZATION_MAX_PER_MESSAGE)}`
+      message: `charts ${String(counters.charts)} > ${String(DATA_VISUALIZATION_MAX_PER_MESSAGE)}`
     });
   }
   if (issues.length > 0) {
@@ -3427,6 +3618,158 @@ function validateBlocks(blocks) {
   }
   return blocks;
 }
+function validateBlock(block, path, issues, counters, depth) {
+  if (depth > MAX_BLOCKS_PER_MESSAGE) {
+    issues.push({ path, message: "container nesting too deep" });
+    return;
+  }
+  switch (block.type) {
+    case "header":
+      if (block.text.text.length > HEADER_TEXT_MAX_CHARS) {
+        issues.push({ path, message: "header text > 150" });
+      }
+      if (block.level !== void 0 && (block.level < 1 || block.level > 4)) {
+        issues.push({ path, message: "header level out of 1\u20134" });
+      }
+      break;
+    case "section":
+      if (block.text !== void 0 && block.text.text.length > SECTION_TEXT_MAX_CHARS) {
+        issues.push({ path, message: "section text > 3000" });
+      }
+      break;
+    case "image":
+      if (block.alt_text.length > IMAGE_ALT_MAX_CHARS) {
+        issues.push({ path, message: "image alt > 2000" });
+      }
+      if (block.image_url !== void 0 && block.image_url.length > IMAGE_URL_MAX_CHARS) {
+        issues.push({ path, message: "image_url > 3000" });
+      }
+      break;
+    case "context":
+      if (block.elements.length === 0) {
+        issues.push({ path, message: "context elements empty" });
+      } else if (block.elements.length > CONTEXT_ELEMENTS_MAX) {
+        issues.push({ path, message: "context elements > 10" });
+      }
+      break;
+    case "markdown":
+      counters.markdownChars += block.text.length;
+      break;
+    case "table":
+      if (block.rows.length > TABLE_MAX_ROWS) {
+        issues.push({ path, message: "table rows > 100" });
+      }
+      counters.tableChars += validateTableCells(block.rows, path, "table cols > 20", issues);
+      break;
+    case "data_table":
+      if (block.rows.length > DATA_TABLE_MAX_DATA_ROWS + 1) {
+        issues.push({ path, message: "data_table rows > 201" });
+      }
+      counters.dataTableChars += validateTableCells(
+        block.rows,
+        path,
+        "data_table cols > 20",
+        issues
+      );
+      break;
+    case "data_visualization":
+      counters.charts += 1;
+      if (block.title.length > CHART_TITLE_MAX_CHARS) {
+        issues.push({ path, message: "chart title > 50" });
+      }
+      validateChart(block, path, issues);
+      break;
+    case "container":
+      if (block.child_blocks.length > CONTAINER_CHILDREN_MAX) {
+        issues.push({ path, message: "container children > 10" });
+      }
+      if (block.title !== void 0 && block.title.text.length > CONTAINER_TITLE_MAX_CHARS) {
+        issues.push({ path, message: "container title > 150" });
+      }
+      if (block.rich_text_title !== void 0) {
+        validateRichTextBlock(block.rich_text_title, `${path}.rich_text_title`, issues);
+      }
+      for (const [i, child] of block.child_blocks.entries()) {
+        validateBlock(child, `${path}.child_blocks[${String(i)}]`, issues, counters, depth + 1);
+      }
+      break;
+    case "divider":
+      break;
+    case "rich_text":
+      validateRichTextBlock(block, path, issues);
+      break;
+    default: {
+      const exhaustive = block;
+      void exhaustive;
+      break;
+    }
+  }
+}
+function validateRichTextBlock(block, path, issues) {
+  if (block.elements.length === 0) {
+    issues.push({ path, message: "rich_text elements empty" });
+    return;
+  }
+  for (const [i, element] of block.elements.entries()) {
+    validateRichTextElement(element, `${path}.elements[${String(i)}]`, issues);
+  }
+}
+function validateRichTextElement(element, path, issues) {
+  switch (element.type) {
+    case "rich_text_section":
+    case "rich_text_quote":
+    case "rich_text_preformatted":
+      if (element.elements.length === 0) {
+        issues.push({ path, message: `${element.type} elements empty` });
+        return;
+      }
+      for (const [i, inline] of element.elements.entries()) {
+        if (inline.type === "link" && !isValidRichTextLinkUrl(inline.url)) {
+          issues.push({
+            path: `${path}.elements[${String(i)}]`,
+            message: "invalid rich text link URL"
+          });
+        }
+      }
+      break;
+    case "rich_text_list":
+      if (element.elements.length === 0) {
+        issues.push({ path, message: "rich_text_list elements empty" });
+        return;
+      }
+      for (const [i, section] of element.elements.entries()) {
+        validateRichTextElement(section, `${path}.elements[${String(i)}]`, issues);
+      }
+      break;
+    default: {
+      const exhaustive = element;
+      void exhaustive;
+      break;
+    }
+  }
+}
+function validateTableCells(rows, path, colsMessage, issues) {
+  let chars = 0;
+  for (const [r, row] of rows.entries()) {
+    if (row.length > TABLE_MAX_COLS) {
+      issues.push({ path, message: colsMessage });
+    }
+    for (const [c, cell] of row.entries()) {
+      chars += cellCharCount(cell);
+      if (cell.type === "rich_text") {
+        validateRichTextBlock(cell, `${path}.rows[${String(r)}][${String(c)}]`, issues);
+      }
+    }
+  }
+  return chars;
+}
+var HTTP_OR_MAILTO_URL_RE = /^(https?:|mailto:)/i;
+function isValidRichTextLinkUrl(url) {
+  if (url.length === 0 || url.length > IMAGE_URL_MAX_CHARS) {
+    return false;
+  }
+  return HTTP_OR_MAILTO_URL_RE.test(url);
+}
 function cellCharCount(cell) {
   if (cell.type === "raw_text") {
     return cell.text.length;