@@ -16,22 +16,22 @@ The latest released version is [`1.0.0`][latest].
16
16
17
17
## Contents
18
18
19
- * [ Introduction] ( #introduction )
20
- * [ Where this specification fits] ( #where-this-specification-fits )
21
- * [ ESTree] ( #estree )
22
- * [ Nodes] ( #nodes )
23
- * [ ` Node ` ] ( #node )
24
- * [ ` RegExpLiteral ` ] ( #regexpliteral )
25
- * [ ` BigIntLiteral ` ] ( #bigintliteral )
26
- * [ Recommendations] ( #recommendations )
27
- * [ Glossary] ( #glossary )
28
- * [ List of utilities] ( #list-of-utilities )
29
- * [ References] ( #references )
30
- * [ Security] ( #security )
31
- * [ Related] ( #related )
32
- * [ Contribute] ( #contribute )
33
- * [ Acknowledgments] ( #acknowledgments )
34
- * [ License] ( #license )
19
+ * [ Introduction] ( #introduction )
20
+ * [ Where this specification fits] ( #where-this-specification-fits )
21
+ * [ ESTree] ( #estree )
22
+ * [ Nodes] ( #nodes )
23
+ * [ ` Node ` ] ( #node )
24
+ * [ ` RegExpLiteral ` ] ( #regexpliteral )
25
+ * [ ` BigIntLiteral ` ] ( #bigintliteral )
26
+ * [ Recommendations] ( #recommendations )
27
+ * [ Glossary] ( #glossary )
28
+ * [ List of utilities] ( #list-of-utilities )
29
+ * [ References] ( #references )
30
+ * [ Security] ( #security )
31
+ * [ Related] ( #related )
32
+ * [ Contribute] ( #contribute )
33
+ * [ Acknowledgments] ( #acknowledgments )
34
+ * [ License] ( #license )
35
35
36
36
## Introduction
37
37
@@ -64,15 +64,15 @@ throughout its ecosystem.
64
64
65
65
ESTree is great but it is missing some things:
66
66
67
- * Trees can’t be roundtripped through ` JSON.parse(JSON.stringify(s)) ` ,
68
- leading to cache troubles
69
- * Columns are 0-indexed, whereas most text editors display 1-indexed
70
- columns, leading to a tiny discrepancy or some math to display warnings
71
- * There is no recommendation for range-based positional info,
72
- leading implementations to scatter them in different places
73
- * There is no safe space for metadata,
74
- leading implementations to scatter them in different places
75
- * There are no recommendations for how to handle JSX, comments, or raw values
67
+ * Trees can’t be roundtripped through ` JSON.parse(JSON.stringify(s)) ` ,
68
+ leading to cache troubles
69
+ * Columns are 0-indexed, whereas most text editors display 1-indexed
70
+ columns, leading to a tiny discrepancy or some math to display warnings
71
+ * There is no recommendation for range-based positional info,
72
+ leading implementations to scatter them in different places
73
+ * There is no safe space for metadata,
74
+ leading implementations to scatter them in different places
75
+ * There are no recommendations for how to handle JSX, comments, or raw values
76
76
77
77
These are minor nits, which is why esast is a superset.
78
78
@@ -142,22 +142,22 @@ X and Y are both referenced in an array at a field on node Y.
142
142
143
143
See the [ unist list of utilities] [ utilities ] for more utilities.
144
144
145
- * [ ` estree-util-attach-comments ` ] ( https://github.com/syntax-tree/estree-util-attach-comments )
146
- — attach comments to estree nodes
147
- * [ ` estree-util-build-jsx ` ] ( https://github.com/syntax-tree/estree-util-build-jsx )
148
- — transform JSX to function calls
149
- * [ ` estree-util-is-identifier-name ` ] ( https://github.com/syntax-tree/estree-util-is-identifier-name )
150
- — check if something can be an identifier name
151
- * [ ` estree-util-value-to-estree ` ] ( https://github.com/remcohaszing/estree-util-value-to-estree )
152
- — convert a JavaScript value to an estree expression
153
- * [ ` estree-util-to-js ` ] ( https://github.com/syntax-tree/estree-util-to-js )
154
- — serialize as JavaScript
155
- * [ ` estree-util-visit ` ] ( https://github.com/syntax-tree/estree-util-visit )
156
- — visit nodes
157
- * [ ` esast-util-from-estree ` ] ( https://github.com/syntax-tree/esast-util-from-estree )
158
- — transform from estree
159
- * [ ` esast-util-from-js ` ] ( https://github.com/syntax-tree/esast-util-from-js )
160
- — parse from JavaScript
145
+ * [ ` estree-util-attach-comments ` ] ( https://github.com/syntax-tree/estree-util-attach-comments )
146
+ — attach comments to estree nodes
147
+ * [ ` estree-util-build-jsx ` ] ( https://github.com/syntax-tree/estree-util-build-jsx )
148
+ — transform JSX to function calls
149
+ * [ ` estree-util-is-identifier-name ` ] ( https://github.com/syntax-tree/estree-util-is-identifier-name )
150
+ — check if something can be an identifier name
151
+ * [ ` estree-util-value-to-estree ` ] ( https://github.com/remcohaszing/estree-util-value-to-estree )
152
+ — convert a JavaScript value to an estree expression
153
+ * [ ` estree-util-to-js ` ] ( https://github.com/syntax-tree/estree-util-to-js )
154
+ — serialize as JavaScript
155
+ * [ ` estree-util-visit ` ] ( https://github.com/syntax-tree/estree-util-visit )
156
+ — visit nodes
157
+ * [ ` esast-util-from-estree ` ] ( https://github.com/syntax-tree/esast-util-from-estree )
158
+ — transform from estree
159
+ * [ ` esast-util-from-js ` ] ( https://github.com/syntax-tree/esast-util-from-js )
160
+ — parse from JavaScript
161
161
162
162
Please use either ` estree-util- ` (if it works with all ESTrees, preferred)
163
163
or ` esast-util- ` (if it uses on esast specific features) as a prefix.
@@ -167,20 +167,20 @@ topic on GitHub.
167
167
168
168
## References
169
169
170
- * ** unist** :
171
- [ Universal Syntax Tree] [ unist ] .
172
- T. Wormer; et al.
173
- * ** JavaScript** :
174
- [ ECMAScript Language Specification] [ javascript ] .
175
- Ecma International.
176
- * ** JSON**
177
- [ The JavaScript Object Notation (JSON) Data Interchange Format] [ json ] ,
178
- T. Bray.
179
- IETF.
180
- * ** Web IDL** :
181
- [ Web IDL] [ webidl ] ,
182
- C. McCormack.
183
- W3C.
170
+ * ** unist** :
171
+ [ Universal Syntax Tree] [ unist ] .
172
+ T. Wormer; et al.
173
+ * ** JavaScript** :
174
+ [ ECMAScript Language Specification] [ javascript ] .
175
+ Ecma International.
176
+ * ** JSON**
177
+ [ The JavaScript Object Notation (JSON) Data Interchange Format] [ json ] ,
178
+ T. Bray.
179
+ IETF.
180
+ * ** Web IDL** :
181
+ [ Web IDL] [ webidl ] ,
182
+ C. McCormack.
183
+ W3C.
184
184
185
185
## Security
186
186
@@ -190,10 +190,10 @@ Always be careful with user input.
190
190
191
191
## Related
192
192
193
- * [ hast] ( https://github.com/syntax-tree/hast ) — HTML
194
- * [ mdast] ( https://github.com/syntax-tree/mdast ) — Markdown
195
- * [ nlcst] ( https://github.com/syntax-tree/nlcst ) — Natural language
196
- * [ xast] ( https://github.com/syntax-tree/xast ) — XML
193
+ * [ hast] ( https://github.com/syntax-tree/hast ) — HTML
194
+ * [ mdast] ( https://github.com/syntax-tree/mdast ) — Markdown
195
+ * [ nlcst] ( https://github.com/syntax-tree/nlcst ) — Natural language
196
+ * [ xast] ( https://github.com/syntax-tree/xast ) — XML
197
197
198
198
## Contribute
199
199
0 commit comments