Что нового в TypeScript 7.1 Beta: import attributes и другие фишки

#TypeScript#frontend#typescript-beta#import-attributes

Вышла бета версия TypeScript 7.1, и в этот раз команда Microsoft решила добавить поддержку import attributes в ambient модулях. Это не самый громкий апдейт, но для тех, кто активно работает с современными bundler-ами и экспериментирует с vibe coding, это может оказаться полезным.

Давайте разбираться, что именно изменилось, как это может помочь в реальных проектах и какие подводные камни стоит учесть.

Import attributes в ambient модулях — зачем и как?

Если вы не сталкивались с import attributes, то кратко: это дополнительные метаданные, которые прикрепляются к import выражениям. Их основная цель — дать подсказки рантайму или бандлеру, как именно обрабатывать импортируемый ресурс. Например, можно указать, что импортируемый файл — это модуль с типом JSON, или что нужно его загружать асинхронно.

До TypeScript 7.1 поддержка import attributes работала в обычных модулях, но ambient модули (те, что описывают типы и не содержат реального кода) эту фишку не понимали. Теперь это исправлено.

На практике это значит, что если у вас есть декларация ambient модуля, например:

declare module "*.json" {
  import type { JsonImport } from "some-types";

  const value: JsonImport;
  export default value;
}

Вы можете добавить import attributes, чтобы типы учитывали, как именно будет импортироваться JSON:

declare module "*.json" {
  import type { JsonImport } from "some-types";

  const value: JsonImport;
  export default value;
  
  // Пример использования import attributes
  // import data from "./data.json" assert { type: "json" };
}

Теперь TypeScript 7.1 понимает эти атрибуты в ambient модулях и не будет ругаться, если вы их используете. Это помогает точнее описывать, что именно импортируется, и уменьшает баги на этапе типизации.

Почему это важно для vibe coding и agentic workflows

В vibe coding, где мы максимально используем возможности языка и инструментов, чтобы писать выразительный, компактный и безопасный код, такие мелочи играют большую роль. Особенно если проект растёт и используются разные типы ассетов — JSON, wasm, CSS-модули и прочее.

Agentic workflows, где код активно взаимодействует с внешними API и динамическими ресурсами, выигрывают от более точной типизации импортов. Если bundler или runtime требует указания атрибутов, теперь можно спокойно описать это на уровне типов без костылей.

Это снижает cognitive load — не нужно запоминать, как именно импортировать разные ресурсы, и не нужно обходить ошибки TypeScript, связанные с несовпадением типов.

Практический сценарий: JSON модули с import assertions

Допустим, вы работаете с проектом, где JSON-файлы импортируются с помощью import assertions:

import config from "./config.json" assert { type: "json" };

Раньше TypeScript ругался на такой синтаксис, если вы не описали ambient модуль с поддержкой import attributes. Теперь можно написать декларацию модуля так:

declare module "*.json" {
  const value: unknown;
  export default value;
}

Но с TypeScript 7.1 можно явно указать поддержку import attributes:

declare module "*.json" {
  import type { ImportAttributes } from "typescript";

  const value: unknown;
  export default value;
}

Конечно, точный синтаксис зависит от вашего setup, но главное — теперь TypeScript не ломается на такого рода импортах, и вы можете спокойно работать с экспериментальными возможностями ECMAScript.

Что ещё нового в TypeScript 7.1?

В бете кроме import attributes в ambient модулях, команда подтянула несколько мелких фиксов и улучшений производительности. Ничего революционного, зато важного для поддержания стабильности и удобства.

Для тех, кто следит за AI coding, стоит отметить, что улучшенная типизация импортов может помочь генеративным AI-инструментам, типа Claude Code или Codex, точнее понимать структуру проекта и выдавать более релевантные подсказки.

Итого: кому это зайдёт, а кому — нет

Если вы уже на TypeScript 7 и активно используете экспериментальные возможности импорта, или у вас есть проекты с разнообразными ассетами и сложными bundler-конфигами — обновление на 7.1 beta стоит попробовать.

Плюсы:

Минусы:

Если вы работаете в vibe coding режиме и любите держать руку на пульсе, TypeScript 7.1 beta стоит включить в свой pipeline, поиграться и посмотреть, как это зайдёт в вашем проекте. Для остальных пока можно отложить до стабильного релиза.

Пару недель назад я обновил один из своих side projects и заметил, что теперь IDE не ругается на import assertions в JSON — мелочь, а приятно. В целом, команда TypeScript продолжает аккуратно расширять возможности языка, не ломая обратную совместимость. Следим дальше, экспериментируем и адаптируемся.


Попробуй сам: Cursor — AI-редактор для разработчиков.


Источник: https://devblogs.microsoft.com/typescript/announcing-typescript-7-1-beta/