aboutsummaryrefslogtreecommitdiffstats
path: root/public/prism/prism-jsdoc.js
blob: fee0bc031d0f0c2822a027cef3b1a394be7dbfc5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
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+(?:<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);
pan> } &__title { font-size: var(--font-size-2xl); @extend %typing-animation; } &__baseline { color: var(--color-fg-light); font-size: var(--font-size-lg); font-weight: 600; @extend %typing-animation; } } .search, .settings { @include mix.media("screen") { @include mix.dimensions("sm") { min-width: 30ch; } } } .main { flex: 1; } .article { &--grid { @extend %grid; grid-auto-flow: column dense; align-items: baseline; } &--padding { padding-bottom: var(--spacing-lg); } } .footer { display: flex; flex-flow: column wrap; gap: var(--spacing-xs); place-items: center; place-content: center; padding: var(--spacing-md) 0 calc(var(--toolbar-size) + var(--spacing-md)); border-top: fun.convert-px(3) solid var(--color-border-light); @include mix.media("screen") { @include mix.dimensions("sm") { --toolbar-size: 0px; flex-flow: row wrap; font-size: var(--font-size-sm); } } } .back-to-top { position: fixed; bottom: calc(var(--toolbar-size, 0px) + var(--spacing-md)); right: var(--spacing-md); transition: all 0.4s ease-in 0s; &--hidden { opacity: 0; transform: translateY(calc(var(--button-height) + var(--spacing-md))); visibility: hidden; } &--visible { opacity: 1; transform: translateY(0); visibility: visible; } } .noscript { padding: var(--spacing-xs) var(--spacing-sm); position: fixed; top: 0; left: 0; right: 0; z-index: 10; background: var(--color-bg); border-bottom: fun.convert-px(3) solid var(--color-border); color: var(--color-primary-darker); font-size: var(--font-size-sm); font-weight: 600; text-align: center; } .noscript-spacing { width: 100%; height: fun.convert-px(75); @include mix.media("screen") { @include mix.dimensions("xs") { height: fun.convert-px(50); } } } @keyframes flip-logo { 0%, 90% { transform: rotateY(180deg); } 100% { transform: rotateY(0deg); } }