vscode/extensions/typescript-basics/syntaxes/Readme.md
Alpha Romer Coma 7ef754c2f6
Fix supported markdown-lint violations in markdown files (#190750)
docs: fix supported markdownlint violations
2023-08-24 08:37:25 +00:00

1.3 KiB

The file TypeScript.tmLanguage.json and TypeScriptReact.tmLanguage.json are derived from TypeScript.tmLanguage and TypeScriptReact.tmLanguage.

To update to the latest version:

  • cd extensions/typescript and run npm run update-grammars
  • don't forget to run the integration tests at ./scripts/test-integration.sh

Migration notes and todos:

  • differentiate variable and function declarations from references

    • I suggest we use a new scope segment 'function-call' to signal a function reference, and 'definition' to the declaration. An alternative is to use 'support.function' everywhere.
    • I suggest we use a new scope segment 'definition' to the variable declarations. Haven't yet found a scope for references that other grammars use.
  • rename scope to return.type to return-type, which is already used in other grammars

  • rename entity.name.class to entity.name.type.class which is used in all other grammars I've seen

  • do we really want to have the list of all the 'library' types (Math, Dom...). It adds a lot of size to the grammar, lots of special rules and is not really correct as it depends on the JavaScript runtime which types are present.