---
title: 0.62.0
---

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

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

# 0.62.0

## Deprecations

### @azure-tools/typespec-autorest

- [#3465](https://github.com/Azure/typespec-azure/pull/3465) Deprecate `arm-resource-flattening` option to reduce confusion with new flattening mechanisms.

  ```diff lang=yaml title=tspconfig.yaml
  options:
    @azure-tools/typespec-autoprest:
  -   arm-resource-flattening: true
  ```

  ```diff lang=tsp title=MyResource.tsp
  +@@Azure.ClientGenerator.Core.Legacy.flattenProperty(MyResource.properties, "autorest");
  ```

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

- [#3465](https://github.com/Azure/typespec-azure/pull/3465) Deprecate `arm-resource-flattening` option to reduce confusion with new flattening mechanisms.

  ```diff lang=yaml title=tspconfig.yaml
  options:
    @azure-tools/typespec-autoprest:
  -   arm-resource-flattening: true
  ```

  ```diff lang=tsp title=MyResource.tsp
  +@@Azure.ClientGenerator.Core.Legacy.flattenProperty(MyResource.properties, "autorest");
  ```

## Features

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

- [#3449](https://github.com/Azure/typespec-azure/pull/3449) Add experimental decorators to namespace `Azure.Core.Experimental` for mutative updates to types. These decorators are dangerous and may be removed at any time, so they automatically trigger a warning diagnostic that requires a suppression.
- [#3350](https://github.com/Azure/typespec-azure/pull/3350) Remove exception for `no-openapi` rule for using `x-ms-identifiers`. Migrating to `@identifiers` is required.
- [#3350](https://github.com/Azure/typespec-azure/pull/3350) Remove dependency on OpenAPI

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

- [#3411](https://github.com/Azure/typespec-azure/pull/3411) Add new `secret-prop` rule scanning for property looking like they might contain sensitive information but not marked with `@secret`
- [#3350](https://github.com/Azure/typespec-azure/pull/3350) Remove dependency on OpenAPI

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

- [#3422](https://github.com/Azure/typespec-azure/pull/3422) Add new `External` usage flag to `UsageFlags` enum. This flag is automatically set for types that are only referenced by external types (types with `@alternateType` decorator pointing to external library types). The flag propagates recursively through the type graph, marking all types that are exclusively accessible through external types.
- [#3401](https://github.com/Azure/typespec-azure/pull/3401) Add `@nextLinkVerb` decorator to specify HTTP verb for next page calls in paging operations. The decorator accepts "POST" or "GET" and defaults to "GET" when not specified. The `nextLinkVerb` field in `SdkPagingServiceMetadata` stores the HTTP verb as a string.
- [#3464](https://github.com/Azure/typespec-azure/pull/3464) Support discriminated union.
- [#3448](https://github.com/Azure/typespec-azure/pull/3448) add support for `Http.File` types as input and output

## Bug Fixes

### @azure-tools/typespec-autorest

- [#3386](https://github.com/Azure/typespec-azure/pull/3386) Fix base64 encoding use correct `byte` format
- [#3481](https://github.com/Azure/typespec-azure/pull/3481) Fix #3477 Allow uniqueItems for nullable array properties

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

- [#3480](https://github.com/Azure/typespec-azure/pull/3480) Include typespec sources in subdirectories of lib into the package.
- [#3481](https://github.com/Azure/typespec-azure/pull/3481) Fix #3477 Allow uniqueItems for nullable array properties

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

- [#3399](https://github.com/Azure/typespec-azure/pull/3399) Fix `arm-resource-operation` rule to skip template instances
- [#3492](https://github.com/Azure/typespec-azure/pull/3492) Fix #3404 changes to resolveArmResources
- [#3410](https://github.com/Azure/typespec-azure/pull/3410) Fix invalid syntax causing error with PrivateLinks

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

- [#3451](https://github.com/Azure/typespec-azure/pull/3451) Propagate client initialization parameters to subclients
