March 2023

New Features

Add—config option

Enable specifying path to configuration file

Allow escaping identifiers using backticks

Identifiers may contain reserved words or non-standard characters when surrounded with backticks (`), for example:

op `op`(): void;

Correct Order of Application for augment decorators

Augment decorators applied last

Added migration script for specs using Cadl

Migration script available for existing specs, see @typespec/migrate for details

Added public formatIdentifier function

Added public formatIdentifier function.

Visibility defaults to read

Default visibility is configurable, but default to ‘read’.

Breaking Changes

Cadl renamed to Typespec

All core cadl packages moved from the @cadl-lang group to the @typespec group

Old Package Name	New Package Name
@cadl-lang/compiler	@typespec/compiler
@cadl-lang/rest	@typespec/rest, @typespec/http
@cadl-lang/migrate	@typespec/migrate
@cadl-lang/openapi	@typespec/openapi
@cadl-lang/openapi3	@typespec/openapi3
@cadl-lang/versioning	@typespec/versioning

`rest` library split into `http` and `rest` libraries

Basic http protocol support is in the http library, support for resources and ReST are in the rest library. The migration tool will correctly update imports in your spec to match the new libraries.

Removed Support for Visual Studio 2019 in Visual Studio IDE extension

You must use a later version of Visual Studio

Removed `emitters` option in configuration

Use emit and options instead