Вышла бета версия 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 стоит попробовать.
Плюсы:
- Чёткая типизация import attributes в ambient модулях.
- Меньше проблем с нестандартными импортами (JSON, wasm и др.).
- Лучше совместимость с современными bundler-ами и runtimes.
Минусы:
- Это бета, могут быть баги.
- Если вы не используете import attributes, апдейт мало на что повлияет.
- Пока что не все bundler-ы и рантаймы одинаково поддерживают import assertions.
Если вы работаете в 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/