@sussudio/base/common/htmlContent.mjs

Internal APIs for VS Code's utilities and user interface building blocks.

/*---------------------------------------------------------------------------------------------
 *  Copyright (c) Microsoft Corporation. All rights reserved.
 *  Licensed under the MIT License. See License.txt in the project root for license information.
 *--------------------------------------------------------------------------------------------*/
import { illegalArgument } from './errors.mjs';
import { escapeIcons } from './iconLabels.mjs';
import { isEqual } from './resources.mjs';
import { escapeRegExpCharacters } from './strings.mjs';
import { URI } from './uri.mjs';
export class MarkdownString {
	value;
	isTrusted;
	supportThemeIcons;
	supportHtml;
	baseUri;
	constructor(value = '', isTrustedOrOptions = false) {
		this.value = value;
		if (typeof this.value !== 'string') {
			throw illegalArgument('value');
		}
		if (typeof isTrustedOrOptions === 'boolean') {
			this.isTrusted = isTrustedOrOptions;
			this.supportThemeIcons = false;
			this.supportHtml = false;
		} else {
			this.isTrusted = isTrustedOrOptions.isTrusted ?? undefined;
			this.supportThemeIcons = isTrustedOrOptions.supportThemeIcons ?? false;
			this.supportHtml = isTrustedOrOptions.supportHtml ?? false;
		}
	}
	appendText(value, newlineStyle = 0 /* MarkdownStringTextNewlineStyle.Paragraph */) {
		this.value += escapeMarkdownSyntaxTokens(this.supportThemeIcons ? escapeIcons(value) : value)
			.replace(/([ \t]+)/g, (_match, g1) => ' '.repeat(g1.length))
			.replace(/\>/gm, '\\>')
			.replace(/\n/g, newlineStyle === 1 /* MarkdownStringTextNewlineStyle.Break */ ? '\\\n' : '\n\n');
		return this;
	}
	appendMarkdown(value) {
		this.value += value;
		return this;
	}
	appendCodeblock(langId, code) {
		this.value += '\n```';
		this.value += langId;
		this.value += '\n';
		this.value += code;
		this.value += '\n```\n';
		return this;
	}
	appendLink(target, label, title) {
		this.value += '[';
		this.value += this._escape(label, ']');
		this.value += '](';
		this.value += this._escape(String(target), ')');
		if (title) {
			this.value += ` "${this._escape(this._escape(title, '"'), ')')}"`;
		}
		this.value += ')';
		return this;
	}
	_escape(value, ch) {
		const r = new RegExp(escapeRegExpCharacters(ch), 'g');
		return value.replace(r, (match, offset) => {
			if (value.charAt(offset - 1) !== '\\') {
				return `\\${match}`;
			} else {
				return match;
			}
		});
	}
}
export function isEmptyMarkdownString(oneOrMany) {
	if (isMarkdownString(oneOrMany)) {
		return !oneOrMany.value;
	} else if (Array.isArray(oneOrMany)) {
		return oneOrMany.every(isEmptyMarkdownString);
	} else {
		return true;
	}
}
export function isMarkdownString(thing) {
	if (thing instanceof MarkdownString) {
		return true;
	} else if (thing && typeof thing === 'object') {
		return (
			typeof thing.value === 'string' &&
			(typeof thing.isTrusted === 'boolean' || thing.isTrusted === undefined) &&
			(typeof thing.supportThemeIcons === 'boolean' || thing.supportThemeIcons === undefined)
		);
	}
	return false;
}
export function markdownStringEqual(a, b) {
	if (a === b) {
		return true;
	} else if (!a || !b) {
		return false;
	} else {
		return (
			a.value === b.value &&
			a.isTrusted === b.isTrusted &&
			a.supportThemeIcons === b.supportThemeIcons &&
			a.supportHtml === b.supportHtml &&
			(a.baseUri === b.baseUri || (!!a.baseUri && !!b.baseUri && isEqual(URI.from(a.baseUri), URI.from(b.baseUri))))
		);
	}
}
export function escapeMarkdownSyntaxTokens(text) {
	// escape markdown syntax tokens: http://daringfireball.net/projects/markdown/syntax#backslash
	return text.replace(/[\\`*_{}[\]()#+\-!~]/g, '\\$&');
}
export function escapeDoubleQuotes(input) {
	return input.replace(/"/g, '"');
}
export function removeMarkdownEscapes(text) {
	if (!text) {
		return text;
	}
	return text.replace(/\\([\\`*_{}[\]()#+\-.!~])/g, '$1');
}
export function parseHrefAndDimensions(href) {
	const dimensions = [];
	const splitted = href.split('|').map((s) => s.trim());
	href = splitted[0];
	const parameters = splitted[1];
	if (parameters) {
		const heightFromParams = /height=(\d+)/.exec(parameters);
		const widthFromParams = /width=(\d+)/.exec(parameters);
		const height = heightFromParams ? heightFromParams[1] : '';
		const width = widthFromParams ? widthFromParams[1] : '';
		const widthIsFinite = isFinite(parseInt(width));
		const heightIsFinite = isFinite(parseInt(height));
		if (widthIsFinite) {
			dimensions.push(`width="${width}"`);
		}
		if (heightIsFinite) {
			dimensions.push(`height="${height}"`);
		}
	}
	return { href, dimensions };
}