Files
Tom Moor be75e8e0a8 fix: Resolve Slab cross-links and import Slab-hosted attachments (#14109)
* fix: Resolve Slab cross-links and import Slab-hosted attachments

Slab exports links between posts as absolute URLs and file attachments as
signed links, so both stayed pointing at Slab after import. Post links are
now matched to imported documents by slug (or by label for id-only mention
links) and Slab-hosted file links become attachments that are re-hosted.

Also fixes concurrent mention transforms assigning different ids to the
same not-yet-imported document.

* fix: Address review feedback on Slab link and file conversion

Prefer exact slug matches and leave ambiguous slugs unresolved, convert
file links in headings, and keep a toggle's leading text block so its
attachments are still converted.
2026-10-16 17:23:13 -04:00

96 lines
2.5 KiB
TypeScript

const escapes: [RegExp, string][] = [
[/\\/g, "\\\\"],
[/\*/g, "\\*"],
[/^-/g, "\\-"],
[/^\+ /g, "\\+ "],
[/^(=+)/g, "\\$1"],
[/^(#{1,6}) /g, "\\$1 "],
[/`/g, "\\`"],
[/^~~~/g, "\\~~~"],
[/\[/g, "\\["],
[/\]/g, "\\]"],
[/\(/g, "\\("], // OLN-91
[/\)/g, "\\)"], // OLN-91
[/^>/g, "\\>"],
[/_/g, "\\_"],
[/^(\d+)\. /g, "$1\\. "],
[/\$/g, "\\$"],
];
/**
* Escape markdown characters in a string
*
* @param text - The text to escape
* @returns The escaped text
*/
export const escape = function (text: string) {
return escapes.reduce(function (accumulator, esc) {
return accumulator.replace(esc[0], esc[1]);
}, text);
};
/**
* Unescape markdown characters in a string
*
* @param text - The text to unescape
* @returns The unescaped text
*/
export const unescape = function (text: string) {
return text.replace(/\\([\\*+-\d.])/g, "$1");
};
/**
* Matches a markdown link or image, capturing the text between its
* parentheses. A destination containing an unescaped closing parenthesis is
* not matched.
*/
const linkRegex = /(!?\[[^\]]*\]\()([^)]*)(\))/g;
/**
* Replaces the destination of every markdown link and image in a string.
*
* Understands the angle-bracket form used when a destination contains spaces,
* and preserves any link title.
*
* @param text The markdown text to rewrite.
* @param replace Called with each destination and the link label; return the
* replacement, or undefined to leave the link as it was written.
* @returns The markdown with replaced destinations.
*/
export function replaceMarkdownLinks(
text: string,
replace: (href: string, label: string) => string | undefined
): string {
return text.replace(
linkRegex,
(match, prefix: string, target: string, suffix: string) => {
const leading = target.length - target.trimStart().length;
const trimmed = target.trim();
let href: string;
let title: string;
if (trimmed.startsWith("<")) {
const end = trimmed.indexOf(">");
if (end === -1) {
return match;
}
href = trimmed.slice(1, end);
title = target.slice(leading + end + 1);
} else {
[href] = trimmed.split(/\s/, 1);
if (!href) {
return match;
}
title = target.slice(leading + href.length);
}
const label = prefix.replace(/^!?\[/, "").slice(0, -2);
const replacement = replace(href, label);
return replacement === undefined
? match
: `${prefix}${replacement}${title}${suffix}`;
}
);
}