Alan Agius
9af3cf7b0b
This commit migrates the vscode-ng-language-service to use the in-repo `ts_project` macro, which has strict dependency checking enabled. This improves build-time dependency validation and helps ensure that all dependencies are explicitly declared. As part of this change, redundant `tsconfig.json` files have been removed in favor of a centralized configuration, and `jasmine_test` rules have been updated to the standard macro. A minor code adjustment in `server/src/session.ts` was also made to improve error handling. PR Close #64306
Read This!
The JSON files in this directory are not meant to be edited by hand.
If you need to make modification, the respective files should be changed within the repository's syntaxes/src directory.
Running pnpm build:syntaxes will then appropriately update the files in this directory.
Syntaxes
This directory specifies TextMate grammars used by VSCode to syntax highlight Angular source code.
Adding a new grammar
To add a new grammar (not modifying an existing one), write the grammar as a
JSON file in this directory and register it in the root directory's
package.json under the contributes.grammars array.
Testing grammars
This repository uses vscode-tmgrammar-test for testing VSCode TextMate grammars.
Snapshot Tests
Snapshot test cases are specified in test/cases.json.
- The source file to test the grammar on should go in test/data/.
- If an external grammar is needed (e.g. for HTML) is needed, a dummy grammar can be specified in test/dummy/ and will be automatically picked up by the grammar test driver.
- Each snapshot tests requires a language scope to test. Generally, this is the
scope name of the grammar being tested (e.g.
inline-template.ngfor the inline template grammar). This scope will become the base name of the grammar matched for everything in the source file being tested, upon which more specific grammar matches will be stacked.
Snapshot golden files can be updated by running
pnpm test:legacy-syntaxes -u
in the root directory of this repository. Goldens must be updated when a new test case is added. Be sure to check that the updated golden file looks as you expect.