/*--------------------------------------------------------------------------------------------- * Copyright (c) Microsoft Corporation. All rights reserved. * Licensed under the Source EULA. See License.txt in the project root for license information. *--------------------------------------------------------------------------------------------*/ import { MarkdownIt, Token } from 'markdown-it'; import * as path from 'path'; import * as vscode from 'vscode'; import { MarkdownContributions } from './markdownExtensions'; import { Slugifier } from './slugify'; const FrontMatterRegex = /^---\s*[^]*?(-{3}|\.{3})\s*/; export class MarkdownEngine { private md?: MarkdownIt; private firstLine?: number; private currentDocument?: vscode.Uri; public constructor( private readonly extensionPreviewResourceProvider: MarkdownContributions, private readonly slugifier: Slugifier, ) { } private usePlugin(factory: (md: any) => any): void { try { this.md = factory(this.md); } catch (e) { // noop } } private async getEngine(resource: vscode.Uri): Promise { if (!this.md) { const hljs = await import('highlight.js'); const mdnh = await import('markdown-it-named-headers'); this.md = (await import('markdown-it'))({ html: true, highlight: (str: string, lang: string) => { // Workaround for highlight not supporting tsx: https://github.com/isagalaev/highlight.js/issues/1155 if (lang && ['tsx', 'typescriptreact'].indexOf(lang.toLocaleLowerCase()) >= 0) { lang = 'jsx'; } if (lang && hljs.getLanguage(lang)) { try { return `
${hljs.highlight(lang, str, true).value}
`; } catch (error) { } } return `
${this.md!.utils.escapeHtml(str)}
`; } }).use(mdnh, { slugify: (header: string) => this.slugifier.fromHeading(header).value }); for (const plugin of this.extensionPreviewResourceProvider.markdownItPlugins) { this.usePlugin(await plugin); } for (const renderName of ['paragraph_open', 'heading_open', 'image', 'code_block', 'fence', 'blockquote_open', 'list_item_open']) { this.addLineNumberRenderer(this.md, renderName); } this.addFencedRenderer(this.md); this.addLinkNormalizer(this.md); this.addLinkValidator(this.md); } const config = vscode.workspace.getConfiguration('markdown', resource); this.md.set({ breaks: config.get('preview.breaks', false), linkify: config.get('preview.linkify', true) }); return this.md; } private stripFrontmatter(text: string): { text: string, offset: number } { let offset = 0; const frontMatterMatch = FrontMatterRegex.exec(text); if (frontMatterMatch) { const frontMatter = frontMatterMatch[0]; offset = frontMatter.split(/\r\n|\n|\r/g).length - 1; text = text.substr(frontMatter.length); } return { text, offset }; } // {{SQL CARBON EDIT}} public async renderText(document: vscode.Uri, text: string): Promise { const engine = await this.getEngine(document); return engine.render(text); } public async render(document: vscode.Uri, stripFrontmatter: boolean, text: string): Promise { let offset = 0; if (stripFrontmatter) { const markdownContent = this.stripFrontmatter(text); offset = markdownContent.offset; text = markdownContent.text; } this.currentDocument = document; this.firstLine = offset; const engine = await this.getEngine(document); return engine.render(text); } public async parse(document: vscode.Uri, source: string): Promise { const { text, offset } = this.stripFrontmatter(source); this.currentDocument = document; const engine = await this.getEngine(document); return engine.parse(text, {}).map(token => { if (token.map) { token.map[0] += offset; } return token; }); } private addLineNumberRenderer(md: any, ruleName: string): void { const original = md.renderer.rules[ruleName]; md.renderer.rules[ruleName] = (tokens: any, idx: number, options: any, env: any, self: any) => { const token = tokens[idx]; if (token.map && token.map.length) { token.attrSet('data-line', this.firstLine + token.map[0]); token.attrJoin('class', 'code-line'); } if (original) { return original(tokens, idx, options, env, self); } else { return self.renderToken(tokens, idx, options, env, self); } }; } private addFencedRenderer(md: any): void { const original = md.renderer.rules['fenced']; md.renderer.rules['fenced'] = (tokens: any, idx: number, options: any, env: any, self: any) => { const token = tokens[idx]; if (token.map && token.map.length) { token.attrJoin('class', 'hljs'); } return original(tokens, idx, options, env, self); }; } private addLinkNormalizer(md: any): void { const normalizeLink = md.normalizeLink; md.normalizeLink = (link: string) => { try { let uri = vscode.Uri.parse(link); if (!uri.scheme && uri.path) { // Assume it must be a file const fragment = uri.fragment; if (uri.path[0] === '/') { const root = vscode.workspace.getWorkspaceFolder(this.currentDocument!); if (root) { uri = vscode.Uri.file(path.join(root.uri.fsPath, uri.path)); } } else { uri = vscode.Uri.file(path.join(path.dirname(this.currentDocument!.path), uri.path)); } if (fragment) { uri = uri.with({ fragment: this.slugifier.fromHeading(fragment).value }); } return normalizeLink(uri.with({ scheme: 'vscode-resource' }).toString(true)); } else if (!uri.scheme && !uri.path && uri.fragment) { return normalizeLink(uri.with({ fragment: this.slugifier.fromHeading(uri.fragment).value }).toString(true)); } } catch (e) { // noop } return normalizeLink(link); }; } private addLinkValidator(md: any): void { const validateLink = md.validateLink; md.validateLink = (link: string) => { // support file:// links return validateLink(link) || link.indexOf('file:') === 0; }; } }