From a98b5ea6fe8e8cc98a55e0fd793e6e8660ea31c1 Mon Sep 17 00:00:00 2001 From: Armand Philippot Date: Thu, 30 Dec 2021 19:47:21 +0100 Subject: chore: add prismjs for syntax highlighting --- public/prism/prism-jsdoc.js | 90 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 public/prism/prism-jsdoc.js (limited to 'public/prism/prism-jsdoc.js') diff --git a/public/prism/prism-jsdoc.js b/public/prism/prism-jsdoc.js new file mode 100644 index 0000000..fee0bc0 --- /dev/null +++ b/public/prism/prism-jsdoc.js @@ -0,0 +1,90 @@ +(function (Prism) { + var javascript = Prism.languages.javascript; + + var type = /\{(?:[^{}]|\{(?:[^{}]|\{[^{}]*\})*\})+\}/.source; + var parameterPrefix = + '(@(?:arg|argument|param|property)\\s+(?:' + type + '\\s+)?)'; + + Prism.languages.jsdoc = Prism.languages.extend('javadoclike', { + parameter: { + // @param {string} foo - foo bar + pattern: RegExp( + parameterPrefix + /(?:(?!\s)[$\w\xA0-\uFFFF.])+(?=\s|$)/.source + ), + lookbehind: true, + inside: { + punctuation: /\./, + }, + }, + }); + + Prism.languages.insertBefore('jsdoc', 'keyword', { + 'optional-parameter': { + // @param {string} [baz.foo="bar"] foo bar + pattern: RegExp( + parameterPrefix + + /\[(?:(?!\s)[$\w\xA0-\uFFFF.])+(?:=[^[\]]+)?\](?=\s|$)/.source + ), + lookbehind: true, + inside: { + parameter: { + pattern: /(^\[)[$\w\xA0-\uFFFF\.]+/, + lookbehind: true, + inside: { + punctuation: /\./, + }, + }, + code: { + pattern: /(=)[\s\S]*(?=\]$)/, + lookbehind: true, + inside: javascript, + alias: 'language-javascript', + }, + punctuation: /[=[\]]/, + }, + }, + 'class-name': [ + { + pattern: RegExp( + /(@(?:augments|class|extends|interface|memberof!?|template|this|typedef)\s+(?:\s+)?)[A-Z]\w*(?:\.[A-Z]\w*)*/.source.replace( + //g, + function () { + return type; + } + ) + ), + lookbehind: true, + inside: { + punctuation: /\./, + }, + }, + { + pattern: RegExp('(@[a-z]+\\s+)' + type), + lookbehind: true, + inside: { + string: javascript.string, + number: javascript.number, + boolean: javascript.boolean, + keyword: Prism.languages.typescript.keyword, + operator: /=>|\.\.\.|[&|?:*]/, + punctuation: /[.,;=<>{}()[\]]/, + }, + }, + ], + example: { + pattern: + /(@example\s+(?!\s))(?:[^@\s]|\s+(?!\s))+?(?=\s*(?:\*\s*)?(?:@\w|\*\/))/, + lookbehind: true, + inside: { + code: { + pattern: /^([\t ]*(?:\*\s*)?)\S.*$/m, + lookbehind: true, + inside: javascript, + alias: 'language-javascript', + }, + }, + }, + }); + + Prism.languages.javadoclike.addSupport('javascript', Prism.languages.jsdoc); +})(Prism); -- cgit v1.2.3