microsoft/typespec

---
title: March 2023
---

# Release Notes March 2023 (2023-03-13)

:::danger
This release contains **breaking changes**

Please see [Cadl to TypeSpec rename and migration FAQ](./cadl-typespec-migration.md)
:::

## 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:

```typespec
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