slackmark 0.6.1 → 0.6.2

package/dist/adapters/phrasing-to-markdown.d.ts

@@ -0,0 +1,15 @@
+import type { Definition, PhrasingContent } from "mdast";
+/**
+ * Inline markdown for content bound for a Slack `markdown` block.
+ *
+ * Slack renders standard markdown in that block — links, bold, italic,
+ * strikethrough, inline code, and images (as link text) — so flattening inlines
+ * to bare text discards fidelity the destination would have carried.
+ *
+ * Text nodes pass through unescaped, exactly as they did when this content was
+ * flattened wholesale. This only re-adds syntax around nodes that already
+ * carried that meaning in the source, so a document with no links converts
+ * byte-identically to before.
+ */
+export declare function phrasingToMarkdown(nodes: ReadonlyArray<PhrasingContent>, definitions: ReadonlyMap<string, Definition>): string;
+//# sourceMappingURL=phrasing-to-markdown.d.ts.map

package/dist/adapters/phrasing-to-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phrasing-to-markdown.d.ts","sourceRoot":"","sources":["../../src/adapters/phrasing-to-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAGzD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,EACrC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAC3C,MAAM,CAMR"}

package/dist/adapters/task-list-adapter.d.ts

@@ -3,9 +3,14 @@ import type { ConversionContext } from "../budget/conversion-context.js";
 import type { Candidate, NodeAdapter } from "./node-adapter.js";
 /**
  * Task lists → markdown block (checkboxes); fallback unicode in rich_text_list.
+ *
+ * Both rungs carry inline links: Slack renders `[label](url)` in a `markdown`
+ * block, and a rich_text section holds real `link` elements next to the unicode
+ * checkbox. Only a block child of an item (a table, a code fence) still has to
+ * be flattened, and only that flattening drops URLs.
  */
 export declare class TaskListAdapter implements NodeAdapter {
     match(node: RootContent, _ctx: ConversionContext): boolean;
-    plan(node: RootContent, _ctx: ConversionContext): ReadonlyArray<Candidate>;
+    plan(node: RootContent, ctx: ConversionContext): ReadonlyArray<Candidate>;
 }
 //# sourceMappingURL=task-list-adapter.d.ts.map

package/dist/adapters/task-list-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-list-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/task-list-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,OAAO,CAAC;AAUzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CA4BzE;CACF"}
+{"version":3,"file":"task-list-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/task-list-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA+C,WAAW,EAAE,MAAM,OAAO,CAAC;AAStF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAezE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEzD;IAED,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAwCxE;CACF"}

package/dist/assemble/text-fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-fallback.d.ts","sourceRoot":"","sources":["../../src/assemble/text-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAmC,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,qBAAa,8BAA+B,YAAW,iBAAiB;IACtE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2B/B;IAED,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAsDrD;CACF"}
+{"version":3,"file":"text-fallback.d.ts","sourceRoot":"","sources":["../../src/assemble/text-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAmC,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,qBAAa,8BAA+B,YAAW,iBAAiB;IACtE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkC/B;IAED,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAsDrD;CACF"}

package/dist/index.js

@@ -958,7 +958,7 @@ var DeterministicPlainTextRenderer = class {
 			parts.push(src[i] ?? "");
 			i += 1;
 		}
-		const raw = parts.join("").replace(/!\[[^\]]{0,200}\]\([^)]{0,3000}\)/g, " ").replace(/\[([^\]]{0,200})\]\([^)]{0,3000}\)/g, "$1").replace(/[#>*_`~]/g, "").replace(/\s+/g, " ").trim();
+		const raw = slackEntitiesToPlain(parts.join("")).replace(/!\[[^\]]{0,200}\]\([^)]{0,3000}\)/g, " ").replace(/\[([^\]]{0,200})\]\([^)]{0,3000}\)/g, "$1").replace(/^[ \t]*#{1,6}[ \t]*/gm, "").replace(/^[ \t]*>[ \t]?/gm, "").replace(/[*_`~]/g, "").replace(/\\([\\`*_{}[\]()#+\-.!>~|])/g, "$1").replace(/\s+/g, " ").trim();
 		return raw.length > 0 ? raw : " ";
 	}
 	renderFromBlocks(blocks) {
@@ -1003,7 +1003,37 @@ var DeterministicPlainTextRenderer = class {
 	}
 };
 function stripMrkdwn(text) {
-	return text.replace(/<([^|>]{1,3000})\|([^>]{0,500})>/g, "$2").replace(/<([^>]{1,3000})>/g, "$1").replace(/[*_~`]/g, "");
+	return slackEntitiesToPlain(text).replace(/[*_~`]/g, "");
+}
+/**
+* Slack entity syntax rendered the way {@link inlinesToPlain} renders the
+* equivalent structured element, so a mention reads the same whether it reached
+* the output as a `rich_text` element or as literal text in a `markdown` block.
+*
+* This has to run before markdown punctuation is stripped. `>` closes every one
+* of these forms and also marks a blockquote, and `#` opens a channel reference
+* and also a heading, so stripping those characters first leaves `<@U123` behind.
+*/
+function slackEntitiesToPlain(text) {
+	return text.replace(/<([^<>]{1,3000})>/g, (_match, body) => {
+		const [target, label] = splitOnce(body, "|");
+		if (target.startsWith("@")) return `@${target.slice(1)}`;
+		if (target.startsWith("#")) return `#${target.slice(1)}`;
+		if (target.startsWith("!")) return specialToPlain(target.slice(1), label);
+		return label ?? target;
+	});
+}
+/** `<!here>`, `<!subteam^S1|@x>`, `<!date^…|fallback>` and friends. */
+function specialToPlain(command, label) {
+	const [name, argument] = splitOnce(command, "^");
+	if (name === "subteam") return `@${argument ?? ""}`;
+	if (name === "date") return label ?? command;
+	return `@${name}`;
+}
+function splitOnce(value, separator) {
+	const index = value.indexOf(separator);
+	if (index === -1) return [value, void 0];
+	return [value.slice(0, index), value.slice(index + separator.length)];
 }
 function richTextToPlain(elements) {
 	const parts = [];
@@ -3013,7 +3043,7 @@ function flattenQuote(quote, ctx) {
 			reason: "Nested list inside blockquote flattened",
 			path: ctx.path
 		});
-		flagFlattenedUrls$1(child, ctx);
+		flagFlattenedUrls(child, ctx);
 		if (parts.length > 0) parts.push({
 			type: "text",
 			text: "\n"
@@ -3047,7 +3077,7 @@ function flattenQuote(quote, ctx) {
 			reason: "Nested block inside blockquote flattened",
 			path: ctx.path
 		});
-		flagFlattenedUrls$1(child, ctx);
+		flagFlattenedUrls(child, ctx);
 		if (parts.length > 0) parts.push({
 			type: "text",
 			text: "\n"
@@ -3063,7 +3093,7 @@ function flattenQuote(quote, ctx) {
 	}];
 }
 /** Flattening keeps labels and alt text only; every dropped URL gets a record. */
-function flagFlattenedUrls$1(node, ctx) {
+function flagFlattenedUrls(node, ctx) {
 	const dropped = [];
 	collectFlattenedUrls(node, dropped);
 	for (const { nodeType, url } of dropped) ctx.degradations.add({
@@ -4711,83 +4741,266 @@ function asciiTableBlock(table) {
 	return preformattedRichText(toPipeMarkdown(table), void 0);
 }
 //#endregion
+//#region src/adapters/phrasing-to-markdown.ts
+/**
+* Inline markdown for content bound for a Slack `markdown` block.
+*
+* Slack renders standard markdown in that block — links, bold, italic,
+* strikethrough, inline code, and images (as link text) — so flattening inlines
+* to bare text discards fidelity the destination would have carried.
+*
+* Text nodes pass through unescaped, exactly as they did when this content was
+* flattened wholesale. This only re-adds syntax around nodes that already
+* carried that meaning in the source, so a document with no links converts
+* byte-identically to before.
+*/
+function phrasingToMarkdown(nodes, definitions) {
+	let out = "";
+	for (const node of nodes) out += nodeToMarkdown(node, definitions);
+	return out;
+}
+function nodeToMarkdown(node, definitions) {
+	if (node.type === "text") return node.value;
+	if (node.type === "inlineCode") return `\`${node.value}\``;
+	if (node.type === "strong") return `**${phrasingToMarkdown(node.children, definitions)}**`;
+	if (node.type === "emphasis") return `_${phrasingToMarkdown(node.children, definitions)}_`;
+	if (node.type === "delete") return `~~${phrasingToMarkdown(node.children, definitions)}~~`;
+	if (node.type === "link") return labelledLink(phrasingToMarkdown(node.children, definitions), node.url);
+	if (node.type === "image") return `![${node.alt ?? ""}](${node.url})`;
+	if (node.type === "linkReference") {
+		const url = definitions.get(node.identifier)?.url;
+		const label = phrasingToMarkdown(node.children, definitions);
+		return url === void 0 ? label : labelledLink(label, url);
+	}
+	if (node.type === "imageReference") {
+		const url = definitions.get(node.identifier)?.url;
+		const alt = node.alt ?? "";
+		return url === void 0 ? alt : `![${alt}](${url})`;
+	}
+	if (node.type === "break") return " ";
+	return toString(node);
+}
+/**
+* An autolink already reads as its own URL; wrapping it as `[url](url)` would be
+* noise, and bare URLs are what this path emitted before.
+*/
+function labelledLink(label, url) {
+	return label === url ? url : `[${label}](${url})`;
+}
+//#endregion
 //#region src/adapters/task-list-adapter.ts
 /**
 * Task lists → markdown block (checkboxes); fallback unicode in rich_text_list.
+*
+* Both rungs carry inline links: Slack renders `[label](url)` in a `markdown`
+* block, and a rich_text section holds real `link` elements next to the unicode
+* checkbox. Only a block child of an item (a table, a code fence) still has to
+* be flattened, and only that flattening drops URLs.
 */
 var TaskListAdapter = class {
 	match(node, _ctx) {
 		return node.type === "list" && isTaskList(node);
 	}
-	plan(node, _ctx) {
+	plan(node, ctx) {
 		const list = node;
-		const md = serializeTaskList(list);
-		return [{
+		const md = serializeTaskList(list, ctx.definitions);
+		const hoistCount = countHoistableImagesInTaskList(list, ctx);
+		const candidates = [{
 			requires: ["markdownBlock"],
 			budget: {
 				blocks: 1,
 				markdownChars: md.length
 			},
-			emit: (ctx) => {
-				flagFlattenedUrls(list, ctx);
+			emit: (emitCtx) => {
+				flagBlockChildUrlLoss(list, emitCtx);
+				flagImagesRenderedAsLinks(list, emitCtx);
 				return [{
 					type: "markdown",
 					text: md
 				}];
 			}
 		}, {
+			budget: { blocks: 1 + hoistCount },
+			emit: (emitCtx) => {
+				flagUnicodeCheckboxes(list, emitCtx);
+				return emitUnicodeTaskBlocks(list, emitCtx, HOIST_IMAGES);
+			}
+		}];
+		if (hoistCount > 0) candidates.push({
 			budget: { blocks: 1 },
-			emit: (ctx) => {
-				flagFlattenedUrls(list, ctx);
-				ctx.degradations.add({
+			emit: (emitCtx) => {
+				flagUnicodeCheckboxes(list, emitCtx);
+				emitCtx.degradations.add({
 					nodeType: "list",
-					from: "markdown.task_list",
-					to: "rich_text_list.unicode_checkbox",
-					reason: "markdownBlock unavailable or budget exhausted",
-					path: ctx.path
+					from: "rich_text+images",
+					to: "rich_text",
+					reason: "Budget exhausted for hoisted task list images; emitting text only",
+					path: emitCtx.path
 				});
-				return [unicodeTaskList(list, ctx)];
+				return emitUnicodeTaskBlocks(list, emitCtx, TEXT_ONLY);
 			}
-		}];
+		});
+		return candidates;
 	}
 };
-function serializeTaskList(list, indent = 0) {
+function flagUnicodeCheckboxes(list, ctx) {
+	flagBlockChildUrlLoss(list, ctx);
+	ctx.degradations.add({
+		nodeType: "list",
+		from: "markdown.task_list",
+		to: "rich_text_list.unicode_checkbox",
+		reason: "markdownBlock unavailable or budget exhausted",
+		path: ctx.path
+	});
+}
+/**
+* URLs inside a block child of an item. Both rungs flatten a table or code fence
+* to plain text, which keeps labels only, so this loss is real on either path.
+* Inline links in a paragraph are not flagged: both rungs now carry them.
+*/
+function flagBlockChildUrlLoss(list, ctx) {
+	for (const item of list.children) for (const child of item.children) {
+		if (child.type === "list") {
+			flagBlockChildUrlLoss(child, ctx);
+			continue;
+		}
+		if (child.type === "paragraph") continue;
+		const urls = [];
+		collectFlattenedUrls(child, urls);
+		for (const { nodeType, url } of urls) ctx.degradations.add({
+			nodeType,
+			from: url,
+			to: "label_only",
+			reason: "Block child of task list item flattened into text; URL dropped",
+			path: ctx.path
+		});
+	}
+}
+/**
+* Slack renders `![alt](url)` in a `markdown` block as link text, so on that rung
+* the URL survives but the image does not. A fidelity note, not a dropped URL.
+* The rich_text rung hoists images into real image blocks instead.
+*/
+function flagImagesRenderedAsLinks(list, ctx) {
+	for (const item of list.children) for (const child of item.children) {
+		if (child.type === "list") {
+			flagImagesRenderedAsLinks(child, ctx);
+			continue;
+		}
+		if (child.type !== "paragraph") continue;
+		const urls = [];
+		collectRenderedImageUrls(child, ctx.definitions, urls);
+		for (const url of urls) ctx.degradations.add({
+			nodeType: "image",
+			from: url,
+			to: "link",
+			reason: "Slack renders images in a markdown block as link text",
+			path: ctx.path
+		});
+	}
+}
+/**
+* Image URLs this rung will render as link text, reference images included.
+* {@link collectFlattenedUrls} cannot see those: a reference carries an identifier,
+* not a url. But {@link phrasingToMarkdown} resolves it and emits the same
+* `![alt](url)`, so it loses the same fidelity and owes the same note. An
+* unresolvable reference emits no image, and so is correctly skipped here.
+*/
+function collectRenderedImageUrls(node, definitions, into) {
+	if (node === null || typeof node !== "object") return;
+	const record = node;
+	if (record.type === "image" && typeof record.url === "string") into.push(record.url);
+	if (record.type === "imageReference" && typeof record.identifier === "string") {
+		const resolved = definitions.get(record.identifier)?.url;
+		if (resolved !== void 0) into.push(resolved);
+	}
+	for (const child of record.children ?? []) collectRenderedImageUrls(child, definitions, into);
+}
+function serializeTaskList(list, definitions, indent = 0) {
 	const pad = "  ".repeat(indent);
 	const lines = [];
 	for (const item of list.children) {
-		const box = item.checked === true ? "[x]" : "[ ]";
-		const text = itemText(item);
-		lines.push(`${pad}- ${box} ${text}`);
-		for (const child of item.children) if (child.type === "list") lines.push(serializeTaskList(child, indent + 1));
+		const text = itemMarkdown(item, definitions);
+		lines.push(`${pad}${taskMarker(item.checked)}${escapeLeadingCheckbox(item.checked, text)}`);
+		for (const child of item.children) if (child.type === "list") lines.push(serializeTaskList(child, definitions, indent + 1));
 	}
 	return lines.join("\n");
 }
 /**
-* Both task-list rungs render item content as plain text ({@link itemText}),
-* so a `[label](url)` or `![alt](url)` inside an item keeps only its label.
+* `checked` has three states, and a plain bullet is not an unchecked task. A
+* mixed list holds both, so collapsing `undefined` into `false` renders work the
+* author never wrote as unfinished. The rich_text rung already omits the prefix
+* for these items; this keeps the two rungs saying the same thing.
 */
-function flagFlattenedUrls(list, ctx) {
-	const dropped = [];
-	collectFlattenedUrls(list, dropped);
-	for (const { nodeType, url } of dropped) ctx.degradations.add({
-		nodeType,
-		from: url,
-		to: "label_only",
-		reason: "Task list item rendered as plain text; URL dropped",
-		path: ctx.path
-	});
+function taskMarker(checked) {
+	if (checked === true) return "- [x] ";
+	if (checked === false) return "- [ ] ";
+	return "- ";
+}
+/**
+* A plain item whose text happens to start with `[x]` would be re-parsed as a
+* checked task once the marker in front of it is a bare bullet, which is the same
+* meaning change {@link taskMarker} exists to avoid. `- [x] ` with a trailing
+* space is exactly this: GFM reads it as a plain item whose literal text is
+* `[x]`. Escaping the bracket keeps it literal.
+*/
+function escapeLeadingCheckbox(checked, text) {
+	if (checked !== void 0 && checked !== null) return text;
+	return /^\[[ xX]\]/.test(text) ? `\\${text}` : text;
 }
-function itemText(item) {
+/**
+* Item content as inline markdown. Slack renders links, emphasis and code in a
+* `markdown` block, so flattening those to bare text would discard fidelity the
+* destination carries natively.
+*/
+function itemMarkdown(item, definitions) {
 	const parts = [];
-	for (const child of item.children) if (child.type === "paragraph") parts.push(toString(child));
-	else if (child.type !== "list") parts.push(toString(child));
+	for (const child of item.children) if (child.type === "paragraph") parts.push(phrasingToMarkdown(child.children, definitions));
+	else if (child.type !== "list") parts.push(blockToPlainText(child));
 	return parts.join(" ").trim();
 }
-function unicodeTaskList(list, ctx) {
-	return {
+/** Phrasing content of a task item, for hoist counting and for emission. */
+function taskItemPhrasing(item) {
+	const phrasing = [];
+	for (const child of item.children) {
+		let segment = [];
+		if (child.type === "paragraph") segment = child.children;
+		else if (child.type !== "list") {
+			const text = blockToPlainText(child);
+			segment = text.length > 0 ? [{
+				type: "text",
+				value: text
+			}] : [];
+		}
+		if (segment.length === 0) continue;
+		if (phrasing.length > 0) phrasing.push({
+			type: "text",
+			value: " "
+		});
+		phrasing.push(...segment);
+	}
+	return phrasing;
+}
+function countHoistableImagesInTaskList(list, ctx) {
+	let count = 0;
+	for (const item of list.children) {
+		count += countHoistableImages(taskItemPhrasing(item), ctx);
+		for (const child of item.children) if (child.type === "list") count += countHoistableImagesInTaskList(child, ctx);
+	}
+	return count;
+}
+/** Named at the call site, because `emitUnicodeTaskBlocks(list, ctx, true)` says nothing. */
+const HOIST_IMAGES = true;
+const TEXT_ONLY = false;
+function emitUnicodeTaskBlocks(list, ctx, hoistImages) {
+	const { elements, hoistedImages } = emitUnicodeTaskTree(list, 0, ctx);
+	const blocks = [{
 		type: "rich_text",
-		elements: emitUnicodeTaskTree(list, 0, ctx)
-	};
+		elements
+	}];
+	if (!hoistImages) return blocks;
+	for (const image of hoistedImages) blocks.push(hoistedImageBlock(image, ctx));
+	return blocks;
 }
 function emitUnicodeTaskTree(list, indent, ctx) {
 	let effectiveIndent = indent;
@@ -4802,6 +5015,7 @@ function emitUnicodeTaskTree(list, indent, ctx) {
 		effectiveIndent = 6;
 	}
 	const out = [];
+	const hoistedImages = [];
 	let pendingSections = [];
 	const flush = () => {
 		if (pendingSections.length === 0) return;
@@ -4815,18 +5029,28 @@ function emitUnicodeTaskTree(list, indent, ctx) {
 	};
 	for (const item of list.children) {
 		const prefix = item.checked === true ? "☑ " : item.checked === false ? "☐ " : "";
+		const inline = emitPhrasing(taskItemPhrasing(item), ctx);
+		hoistedImages.push(...inline.hoistedImages);
+		const elements = prefix === "" ? [...inline.elements] : [{
+			type: "text",
+			text: prefix
+		}, ...inline.elements];
 		pendingSections.push({
 			type: "rich_text_section",
-			elements: [{
+			elements: elements.length > 0 ? elements : [{
 				type: "text",
-				text: `${prefix}${itemText(item)}`
+				text: " "
 			}]
 		});
 		const childLists = [];
 		for (const child of item.children) if (child.type === "list") childLists.push(child);
 		if (childLists.length === 0) continue;
 		flush();
-		for (const child of childLists) out.push(...emitUnicodeTaskTree(child, effectiveIndent + 1, ctx));
+		for (const child of childLists) {
+			const nested = emitUnicodeTaskTree(child, effectiveIndent + 1, ctx);
+			out.push(...nested.elements);
+			hoistedImages.push(...nested.hoistedImages);
+		}
 	}
 	flush();
 	if (out.length === 0) out.push({
@@ -4841,7 +5065,10 @@ function emitUnicodeTaskTree(list, indent, ctx) {
 		}],
 		indent: effectiveIndent
 	});
-	return out;
+	return {
+		elements: out,
+		hoistedImages
+	};
 }
 //#endregion
 //#region src/adapters/thematic-break-adapter.ts