-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathparsers.js
129 lines (116 loc) · 3.1 KB
/
parsers.js
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
module.exports = {
/**
* Match element state pseudo-classes.
*
* @usage `@state :hover This is a description`.
*
* @param {string} value The tag's value to parse.
* @return {array}
*/
state: (value) => {
const match = value.match(/(^:[-_a-zA-Z]+)(.*)/);
if (!match) {
throw new Error('No state pseudo-class could be matched');
}
return [
{
type: 'state',
value: match[1].trim(),
},
{
type: 'description',
value: match[2].trim(),
},
];
},
/**
* Match element modifier classes.
*
* @usage `@modifier .some-class This is a description`.
* @usage `@modifier .-some-class This is a description`.
* @usage `@modifier ._some_class This is a description`.
*
* @param {string} value The tag's value to parse.
* @return {array}
*/
modifier: (value) => {
const match = value.match(/^(\.?-?[_a-zA-Z]+[_a-zA-Z0-9-]*)(.*)/);
if (!match) {
throw new Error('No modifier class could be matched');
}
return [
{
type: 'modifier',
value: match[1].trim(),
},
{
type: 'description',
value: match[2].trim(),
},
];
},
/**
* Match an example with optional description.
*
* @usage `@example <div class="some-example"><p>Hello, World!</p></div>`
*
* @usage `@example
* <div class="some-example">
* <p>Hello, World!</p>
* </div>`
*
* @usage `@example This is an optional description
* <div class="some-example">
* <p>Hello, World!</p>
* </div>`
*
* @param {string} value The tag's value to parse.
* @return {array}
*/
example: (value) => {
const match = value.match(/([^\n]*)\n((?:.|\n)*)/);
const markup = {
type: 'markup',
value: value,
};
const description = {
type: 'description',
value: '',
};
if (match) {
markup.value = match[2].trim();
description.value = match[1].trim();
}
return [markup, description];
},
/**
* Parse a list of tags into an array.
*
* @usage `@tags
* - tag-1
* - tag-2
* - tag-3`
*
* @usage `@tags
* * tag-1
* * tag-2
* * tag-3`
*
* @param {string} value The tag's value to parse.
* @return {array}
*/
tags: (value) => {
const match = value.match(/\s*[-*]\s+[\w-_]*/g);
if (!match) {
throw new Error('No tags could be matched');
}
return [
{
type: 'tags',
value: match.map(function (tag) {
return tag.trim().replace(/[-*]\s/, '');
}),
},
];
},
};