---
title: 0.61.0
---

import { LinkCard } from "@astrojs/starlight/components";

<LinkCard
  title="TypeSpec Core 1.5"
  description="See changes to the TypeSpec language and core libraries"
  href="https://typespec.io/docs/release-notes/release-2025-10-08"
/>

# 0.61.0

## Breaking Changes

### @azure-tools/typespec-azure-core

- [#3266](https://github.com/Azure/typespec-azure/pull/3266) Remove legacy Azure.Core paging. The following was removed
  - `@pagedResult` decorator
  - `@items` decorator
  - [API] `getPagedResult` -> `getPagingOperation` in `@typespec/compiler`
  - [API] `getItems`
  - [API] `getNextLink`
- [#3214](https://github.com/Azure/typespec-azure/pull/3214) Remove unused `@nextPageOperation` decorator.

### @azure-tools/typespec-client-generator-core

- [#3286](https://github.com/Azure/typespec-azure/pull/3286) Change `isApiVersion` logic. If a service is not versioning, the function always return false.

## Features

### @azure-tools/typespec-autorest

- [#3358](https://github.com/Azure/typespec-azure/pull/3358) Support x-ms-secret in model types
- [#3358](https://github.com/Azure/typespec-azure/pull/3358) Allow x-ms-long-running-operation for resource get
- [#3360](https://github.com/Azure/typespec-azure/pull/3360) Added an `xml-strategy` option to control whether the emitter outputs XML serialization metadata. The options are:
  - `xml-strategy: xml-service`: Emit XML serialization metadata for the whole service and all its schemas if the service uses the "application/xml" content-type.
  - `xml-strategy: none`: Never emit XML serialization metadata.

- [#3290](https://github.com/Azure/typespec-azure/pull/3290) Added support for emitting XML annotations.

### @azure-tools/typespec-azure-core

- [#3325](https://github.com/Azure/typespec-azure/pull/3325) Export `isPreviewVersion` for `@previewVersion` decorator.

### @azure-tools/typespec-azure-resource-manager

- [#3356](https://github.com/Azure/typespec-azure/pull/3356) Support `@identifiers` on array model

### @azure-tools/typespec-client-generator-core

- [#3198](https://github.com/Azure/typespec-azure/pull/3198) Add `getHttpOperationParametersForClientParameter` helper to find corresponding HTTP parameter list for a client initialization parameter.
- [#3325](https://github.com/Azure/typespec-azure/pull/3325) Add support for `@previewVersion` decorator in API version filtering. TCGC now checks for the `@previewVersion` decorator on enum members in addition to the existing regex-based preview version filtering.
- [#3233](https://github.com/Azure/typespec-azure/pull/3233) Allow `@alternateType` to reference external types as well

## Bug Fixes

### @azure-tools/typespec-autorest

- [#3266](https://github.com/Azure/typespec-azure/pull/3266) Cleanup usage of legacy Azure.Core paging apis

### @azure-tools/typespec-azure-core

- [#3346](https://github.com/Azure/typespec-azure/pull/3346) [rpc-operation-request-body] Correctly ignores properties marked with `@bodyIgnore`
- [#3268](https://github.com/Azure/typespec-azure/pull/3268) Remove versioning

  ```diff lang=tsp
  -@useDependency(Azure.Core.Versions.v1_preview2)
  ```

### @azure-tools/typespec-azure-resource-manager

- [#3268](https://github.com/Azure/typespec-azure/pull/3268) Remove versioning

  ```diff lang=tsp
  -@useDependency(Azure.ResourceManager.Versions.v1_preview2)
  ```

### @azure-tools/typespec-client-generator-core

- [#3353](https://github.com/Azure/typespec-azure/pull/3353) Handle wrong `api-version` config.
- [#3285](https://github.com/Azure/typespec-azure/pull/3285) Fix missing doc for nullable type.
- [#3324](https://github.com/Azure/typespec-azure/pull/3324) Refine error message for `@override`.
- [#3266](https://github.com/Azure/typespec-azure/pull/3266) Cleanup usage of legacy Azure.Core paging apis
- [#3361](https://github.com/Azure/typespec-azure/pull/3361) Fix bug ignoring `@clientName` decorator when applied to `@client` clients
- [#3311](https://github.com/Azure/typespec-azure/pull/3311) Fix missing example for operation directly extends from templated interface.
