TypeScript 7.1 Beta Adds Import Attributes Support in Ambient Modules

TypeScript 7.1 Beta Release

The TypeScript team announced the beta release of TypeScript 7.1. This version is available for installation via npm using the command `npm install -D typescript@beta`.

Import Attributes in Ambient Modules

A key feature in TypeScript 7.1 Beta is the support for Import Attributes in ambient modules. Import attributes are metadata attached to import statements, guiding runtimes and bundlers on how to interpret module content and shape. This is particularly relevant for environments like browsers that cannot solely rely on file extensions.

For example, an import statement like `import myData from "./data/someData.json" with { type: "json" };` uses the `type: "json"` attribute to instruct the runtime to parse `someData.json` as a JSON file.

Expanded Type Specification

The `type` attribute has become a standard for customizing import behavior. ECMAScript proposals include `type: "text"` for importing file contents as a string and `type: "bytes"` for importing raw bytes as a `Uint8Array`. Browsers also support `type: "css"` for importing CSS files as `CSSStyleSheet` objects.

Previously, developers used wildcard ambient module declarations (e.g., `*.css`) to handle these files, but this approach did not account for import attributes, leading to potential issues if attributes were omitted.

Addressing Prior Limitations

The new support for Import Attributes directly addresses the limitations of older ambient module declarations. These older declarations did not provide a mechanism to enforce or acknowledge the presence of import attributes, which could lead to incorrect interpretations or runtime errors when attributes were expected but not provided. The update provides a more robust and explicit way to manage diverse import types.