Use when making code changes to ensure they pass VS Code's hygiene checks. Covers the pre-commit hook, unicode restrictions, string quoting rules, copyright headers, indentation, formatting, ESLint, and stylelint. Run the hygiene check before declaring work complete.
VS Code runs a hygiene check as a git pre-commit hook. Commits will be rejected if hygiene fails.
Always run the pre-commit hygiene check before declaring work complete. This catches issues that would block a commit.
To run the hygiene check on your staged files:
npm run precommit
This executes node --experimental-strip-types build/hygiene.ts, which scans only staged files (from git diff --cached).
To check specific files directly (without staging them first):
node --experimental-strip-types build/hygiene.ts path/to/file.ts
The hygiene linter scans staged files for issues including (but not limited to):
// allow-any-unicode-next-line or // allow-any-unicode-comment-file."double quotes" for externalized (localized) strings. Use 'single quotes' everywhere else.Format Document to fix).