[d24f17c] | 1 | 'use strict'
|
---|
| 2 | var refractorJavadoclike = require('./javadoclike.js')
|
---|
| 3 | var refractorTypescript = require('./typescript.js')
|
---|
| 4 | module.exports = jsdoc
|
---|
| 5 | jsdoc.displayName = 'jsdoc'
|
---|
| 6 | jsdoc.aliases = []
|
---|
| 7 | function jsdoc(Prism) {
|
---|
| 8 | Prism.register(refractorJavadoclike)
|
---|
| 9 | Prism.register(refractorTypescript)
|
---|
| 10 | ;(function (Prism) {
|
---|
| 11 | var javascript = Prism.languages.javascript
|
---|
| 12 | var type = /\{(?:[^{}]|\{(?:[^{}]|\{[^{}]*\})*\})+\}/.source
|
---|
| 13 | var parameterPrefix =
|
---|
| 14 | '(@(?:arg|argument|param|property)\\s+(?:' + type + '\\s+)?)'
|
---|
| 15 | Prism.languages.jsdoc = Prism.languages.extend('javadoclike', {
|
---|
| 16 | parameter: {
|
---|
| 17 | // @param {string} foo - foo bar
|
---|
| 18 | pattern: RegExp(
|
---|
| 19 | parameterPrefix + /(?:(?!\s)[$\w\xA0-\uFFFF.])+(?=\s|$)/.source
|
---|
| 20 | ),
|
---|
| 21 | lookbehind: true,
|
---|
| 22 | inside: {
|
---|
| 23 | punctuation: /\./
|
---|
| 24 | }
|
---|
| 25 | }
|
---|
| 26 | })
|
---|
| 27 | Prism.languages.insertBefore('jsdoc', 'keyword', {
|
---|
| 28 | 'optional-parameter': {
|
---|
| 29 | // @param {string} [baz.foo="bar"] foo bar
|
---|
| 30 | pattern: RegExp(
|
---|
| 31 | parameterPrefix +
|
---|
| 32 | /\[(?:(?!\s)[$\w\xA0-\uFFFF.])+(?:=[^[\]]+)?\](?=\s|$)/.source
|
---|
| 33 | ),
|
---|
| 34 | lookbehind: true,
|
---|
| 35 | inside: {
|
---|
| 36 | parameter: {
|
---|
| 37 | pattern: /(^\[)[$\w\xA0-\uFFFF\.]+/,
|
---|
| 38 | lookbehind: true,
|
---|
| 39 | inside: {
|
---|
| 40 | punctuation: /\./
|
---|
| 41 | }
|
---|
| 42 | },
|
---|
| 43 | code: {
|
---|
| 44 | pattern: /(=)[\s\S]*(?=\]$)/,
|
---|
| 45 | lookbehind: true,
|
---|
| 46 | inside: javascript,
|
---|
| 47 | alias: 'language-javascript'
|
---|
| 48 | },
|
---|
| 49 | punctuation: /[=[\]]/
|
---|
| 50 | }
|
---|
| 51 | },
|
---|
| 52 | 'class-name': [
|
---|
| 53 | {
|
---|
| 54 | pattern: RegExp(
|
---|
| 55 | /(@(?:augments|class|extends|interface|memberof!?|template|this|typedef)\s+(?:<TYPE>\s+)?)[A-Z]\w*(?:\.[A-Z]\w*)*/.source.replace(
|
---|
| 56 | /<TYPE>/g,
|
---|
| 57 | function () {
|
---|
| 58 | return type
|
---|
| 59 | }
|
---|
| 60 | )
|
---|
| 61 | ),
|
---|
| 62 | lookbehind: true,
|
---|
| 63 | inside: {
|
---|
| 64 | punctuation: /\./
|
---|
| 65 | }
|
---|
| 66 | },
|
---|
| 67 | {
|
---|
| 68 | pattern: RegExp('(@[a-z]+\\s+)' + type),
|
---|
| 69 | lookbehind: true,
|
---|
| 70 | inside: {
|
---|
| 71 | string: javascript.string,
|
---|
| 72 | number: javascript.number,
|
---|
| 73 | boolean: javascript.boolean,
|
---|
| 74 | keyword: Prism.languages.typescript.keyword,
|
---|
| 75 | operator: /=>|\.\.\.|[&|?:*]/,
|
---|
| 76 | punctuation: /[.,;=<>{}()[\]]/
|
---|
| 77 | }
|
---|
| 78 | }
|
---|
| 79 | ],
|
---|
| 80 | example: {
|
---|
| 81 | pattern:
|
---|
| 82 | /(@example\s+(?!\s))(?:[^@\s]|\s+(?!\s))+?(?=\s*(?:\*\s*)?(?:@\w|\*\/))/,
|
---|
| 83 | lookbehind: true,
|
---|
| 84 | inside: {
|
---|
| 85 | code: {
|
---|
| 86 | pattern: /^([\t ]*(?:\*\s*)?)\S.*$/m,
|
---|
| 87 | lookbehind: true,
|
---|
| 88 | inside: javascript,
|
---|
| 89 | alias: 'language-javascript'
|
---|
| 90 | }
|
---|
| 91 | }
|
---|
| 92 | }
|
---|
| 93 | })
|
---|
| 94 | Prism.languages.javadoclike.addSupport('javascript', Prism.languages.jsdoc)
|
---|
| 95 | })(Prism)
|
---|
| 96 | }
|
---|