Warn about invalid triple slash directive location.

沒有指定原始檔或測試。首先定位處理 triple-slash 指示詞的編譯器程式碼，以及相關的 language-service quick-fix 基礎結構。完成標準是：被忽略的指示詞會產生包含所需措辭的警告，並提供將其移至頂端的修正，同時涵蓋 import 位於指示詞之前的範例。

🔍 Search Terms

"triple slash directive warning", "triple slash directive", "triple slash"

✅ Viability Checklist

• This wouldn't be a breaking change in existing TypeScript/JavaScript code
• This wouldn't change the runtime behavior of existing JavaScript code
• This could be implemented without emitting different JS based on the types of the expressions
• This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, new syntax sugar for JS, etc.)
• This isn't a request to add a new utility type: https://github.com/microsoft/TypeScript/wiki/No-New-Utility-Types
• This feature would agree with the rest of our Design Goals: https://github.com/Microsoft/TypeScript/wiki/TypeScript-Design-Goals

⭐ Suggestion

Provide a warning when triple slash directives are found places where they are ignored.

eg.

import { AudioBuffer } from '@/audio/AudioBuffer';

/// <reference lib="WebWorker" />

Typescript could emit a warning on line 3 "triple slash directive is ignored due to not being first" and a quick fix to move it to the top.

This would provide clarity in the case that people don't remember (or haven't read) the docs.

📃 Motivating Example

I just spent 20 minutes with a file equivalent to the above trying to work out why the webworker types would only get included when i commented out my import statements. I thought it was some problem with imports specifically.

💻 Use Cases

1. What do you want to use this for?
   Save time trying to search for the wrong problem.
2. What shortcomings exist with current approaches?
   People don't always read or remember what's documented.
3. What workarounds are you using in the meantime?
   n/a