intermediate

Declaration files и CI typecheck

Публикация и потребление .d.ts, ambient types и детерминированный typecheck в CI.

Declaration files (`.d.ts`) описывают JavaScript modules или published package APIs без implementation. Могут генерироваться из TypeScript, писаться manually для JavaScript или устанавливаться из DefinitelyTyped. CI typecheck делает contracts reproducible вне editor.

Stale `.d.ts` могут обещать APIs, которых runtime code не даёт. Broad ambient globals mask missing imports.

					{ "scripts": { "typecheck": "tsc --noEmit" } }
				

На интервью: объясняйте на конкретном примере и называйте, что проверяют в production code.

Типовые ошибки: путать похожие API и забывать edge cases в live coding.

Компромисс часто между ясностью и безопасностью или expressiveness и maintainability.

Чеклист:

  • Назовите core idea.
  • Приведите пример.
  • Упомяните одну ошибку.

Checklist:

  • Generate declarations для packages.
  • d.ts tied to runtime API.
  • Typecheck в CI.