knowledgebase_law/node_modules/refractor/lang/jsdoc.js
2025-04-11 11:47:09 -04:00

97 lines
2.8 KiB
JavaScript

'use strict'
var refractorJavadoclike = require('./javadoclike.js')
var refractorTypescript = require('./typescript.js')
module.exports = jsdoc
jsdoc.displayName = 'jsdoc'
jsdoc.aliases = []
function jsdoc(Prism) {
Prism.register(refractorJavadoclike)
Prism.register(refractorTypescript)
;(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+(?:<TYPE>\s+)?)[A-Z]\w*(?:\.[A-Z]\w*)*/.source.replace(
/<TYPE>/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)
}