You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
helix/runtime/queries/ecma
Daniel S Poulin 1abb64e48d
Add textobject for entries/elements of list-like things (#8150)
7 months ago
..
README.md Refactor queries for ecma based languages (#7207) 1 year ago
highlights.scm build(tree-sitter): update javascript, typescript and tsx (#7852) 1 year ago
indents.scm Add `switch_statement` to ecma indents (#6369) 2 years ago
injections.scm Inherit javascript/typescript from common 'ecma' queries (#3301) 2 years ago
locals.scm Refactor queries for ecma based languages (#7207) 1 year ago
textobjects.scm Add textobject for entries/elements of list-like things (#8150) 7 months ago

README.md

Inheritance model for ecma-based languages

Ecma-based languages share many traits. Because of this we want to share as many queries as possible while avoiding nested inheritance that can make query behaviour unpredictable due to unexpected precedence.

To achieve that, there are "public" and "private" versions for javascript, jsx, and typescript query files, that share the same name, but the "private" version name starts with an underscore (with the exception of ecma, that already exists as a sort of base "private" language). This allows the "private" versions to host the specific queries of the language excluding any ; inherits statement, in order to make them safe to be inherited by the "public" version of the same language and other languages as well. The tsx language doesn't have a "private" version given that currently it doesn't need to be inherited by other languages.

Language Inherits from
javascript _javascript, ecma
jsx _jsx, _javascript, ecma
typescript _typescript, ecma
tsx _jsx, _typescript, ecma

If you intend to add queries to any of the ecma-based languages above, make sure you add them to the correct private language they belong to, so that other languages down the line can benefit from them.