March 2023
New Features
Section titled âNew FeaturesâAddâconfig option
Section titled âAddâconfig optionâEnable specifying path to configuration file
Allow escaping identifiers using backticks
Section titled â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
Section titled âCorrect Order of Application for augment decoratorsâAugment decorators applied last
Added migration script for specs using Cadl
Section titled âAdded migration script for specs using CadlâMigration script available for existing specs, see @typespec/migrate
for details
Added public formatIdentifier function
Section titled âAdded public formatIdentifier functionâAdded public formatIdentifier function.
Visibility defaults to read
Section titled âVisibility defaults to readâDefault visibility is configurable, but default to âreadâ.
Breaking Changes
Section titled âBreaking ChangesâCadl renamed to Typespec
Section titled â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
Section titled â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
Section titled â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
Section titled âRemoved emitters option in configurationâUse emit
and options
instead