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