Remove unused RequestParameter and ResponseProperty

.chronus/changes/remove-unused-request-response-prop-2025-7-29-15-23-30.md

@@ -0,0 +1,8 @@
+---
+# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking
+changeKind: fix
+packages:
+  - "@azure-tools/typespec-azure-core"
+---
+
+Remove unused `RequestParameter` and `ResponseProperty` models

packages/typespec-azure-core/README.md

@@ -379,8 +379,6 @@ Overrides the final state value for an operation
 ### Azure.Core.Foundations
 
 - [`@omitKeyProperties`](#@omitkeyproperties)
-- [`@requestParameter`](#@requestparameter)
-- [`@responseProperty`](#@responseproperty)
 
 #### `@omitKeyProperties`
 
@@ -398,42 +396,6 @@ Deletes any key properties from the model.
 
 None
 
-#### `@requestParameter`
-
-Identifies a property on a request model that serves as a linked operation parameter.
-
-```typespec
-@Azure.Core.Foundations.requestParameter(name: valueof string)
-```
-
-##### Target
-
-`Model`
-
-##### Parameters
-
-| Name | Type             | Description                 |
-| ---- | ---------------- | --------------------------- |
-| name | `valueof string` | Property name on the target |
-
-#### `@responseProperty`
-
-Identifies a property on _all_ non-error response models that serve as a linked operation parameter.
-
-```typespec
-@Azure.Core.Foundations.responseProperty(name: valueof string)
-```
-
-##### Target
-
-`Model`
-
-##### Parameters
-
-| Name | Type             | Description                 |
-| ---- | ---------------- | --------------------------- |
-| name | `valueof string` | Property name on the target |
-
 ### Azure.Core.Traits
 
 - [`@trait`](#@trait)

packages/typespec-azure-core/generated-defs/Azure.Core.Foundations.ts

@@ -8,30 +8,6 @@ export type OmitKeyPropertiesDecorator = (
   entity: Model,
 ) => DecoratorValidatorCallbacks | void;
 
-/**
- * Identifies a property on a request model that serves as a linked operation parameter.
- *
- * @param name Property name on the target
- */
-export type RequestParameterDecorator = (
-  context: DecoratorContext,
-  entity: Model,
-  name: string,
-) => DecoratorValidatorCallbacks | void;
-
-/**
- * Identifies a property on *all* non-error response models that serve as a linked operation parameter.
- *
- * @param name Property name on the target
- */
-export type ResponsePropertyDecorator = (
-  context: DecoratorContext,
-  entity: Model,
-  name: string,
-) => DecoratorValidatorCallbacks | void;
-
 export type AzureCoreFoundationsDecorators = {
   omitKeyProperties: OmitKeyPropertiesDecorator;
-  requestParameter: RequestParameterDecorator;
-  responseProperty: ResponsePropertyDecorator;
 };

packages/typespec-azure-core/lib/decorators.tsp

@@ -139,18 +139,6 @@ namespace Azure.Core.Foundations {
    * Deletes any key properties from the model.
    */
   extern dec omitKeyProperties(entity: Model);
-
-  /**
-   * Identifies a property on a request model that serves as a linked operation parameter.
-   * @param name Property name on the target
-   */
-  extern dec requestParameter(entity: Model, name: valueof string);
-
-  /**
-   * Identifies a property on *all* non-error response models that serve as a linked operation parameter.
-   * @param name Property name on the target
-   */
-  extern dec responseProperty(entity: Model, name: valueof string);
 }
 
 namespace Azure.Core.Foundations.Private {

packages/typespec-azure-core/lib/models.tsp

@@ -23,20 +23,6 @@ model Page<Resource extends TypeSpec.Reflection.Model> {
   nextLink?: ResourceLocation<Resource>;
 }
 
-/**
- * Defines a property as a request parameter.
- * @template Name The parameter name.
- */
-@Foundations.requestParameter(Name)
-model RequestParameter<Name extends valueof string> {}
-
-/**
- * Defines a property as a response header.
- * @template Name The header name.
- */
-@Foundations.responseProperty(Name)
-model ResponseProperty<Name extends valueof string> {}
-
 /**
  * @dev Provides the status of a resource operation.
  * @template Resource The resource type.

packages/typespec-azure-core/src/decorators.ts

@@ -1,34 +1,12 @@
 import { AzureCoreStateKeys } from "./lib.js";
 
 import { DecoratorContext, Model, ModelProperty, Program, Type } from "@typespec/compiler";
 import { getUniqueItems } from "./decorators/unique-items.js";
 
-export const $requestParameter = (context: DecoratorContext, entity: Model, name: string) => {
-  context.program.stateMap(AzureCoreStateKeys.requestParameter).set(entity, name);
-};
-
-export function getRequestParameter(program: Program, entity: ModelProperty): string | undefined {
-  if (entity.type.kind !== "Model") return undefined;
-  const parameterName: string | undefined = program
-    .stateMap(AzureCoreStateKeys.requestParameter)
-    .get(entity.type);
-  return parameterName;
-}
-
-export const $responseProperty = (context: DecoratorContext, entity: Model, name: string) => {
-  context.program.stateMap(AzureCoreStateKeys.responseParameter).set(entity, name);
-};
-
-export function getResponseProperty(program: Program, entity: ModelProperty): string | undefined {
-  if (entity.type.kind !== "Model") return undefined;
-  const parameterName: string | undefined = program
-    .stateMap(AzureCoreStateKeys.responseParameter)
-    .get(entity.type);
-  return parameterName;
-}
 
 /**
- * Checks if an array model or array-valued model property has unique items.
+ * Checks if an array model or array-valued model property has 
+ e items.
  * @param program The program context.
  * @param type The model or model property to check.
  * @returns True if the model or model property has unique items, false otherwise.

packages/typespec-azure-core/src/tsp-index.ts

@@ -3,7 +3,6 @@ import type { AzureCoreFoundationsPrivateDecorators } from "../generated-defs/Az
 import type { AzureCoreDecorators } from "../generated-defs/Azure.Core.js";
 import type { AzureCoreTraitsDecorators } from "../generated-defs/Azure.Core.Traits.js";
 import type { AzureCoreTraitsPrivateDecorators } from "../generated-defs/Azure.Core.Traits.Private.js";
-import { $requestParameter, $responseProperty } from "./decorators.js";
 import { $finalLocation } from "./decorators/final-location.js";
 import { $finalOperation } from "./decorators/final-operation.js";
 import { $omitKeyProperties } from "./decorators/foundations/omit-key-properties.js";
@@ -67,8 +66,6 @@ export const $decorators = {
 
   "Azure.Core.Foundations": {
     omitKeyProperties: $omitKeyProperties,
-    requestParameter: $requestParameter,
-    responseProperty: $responseProperty,
   } satisfies AzureCoreFoundationsDecorators,
   "Azure.Core.Foundations.Private": {
     spreadCustomParameters: $spreadCustomParameters,

website/src/content/docs/docs/libraries/azure-core/reference/data-types.md

@@ -312,24 +312,6 @@ model Azure.Core.RequestIdResponseHeader
 | ---------- | -------------------------- | ------------------------------------------------------------------------------- |
 | requestId? | [`uuid`](#Azure.Core.uuid) | An opaque, globally-unique, server-generated string identifier for the request. |
 
-### `RequestParameter` {#Azure.Core.RequestParameter}
-
-Defines a property as a request parameter.
-
-```typespec
-model Azure.Core.RequestParameter<Name>
-```
-
-#### Template Parameters
-
-| Name | Description         |
-| ---- | ------------------- |
-| Name | The parameter name. |
-
-#### Properties
-
-None
-
 ### `ResourceOperationStatus` {#Azure.Core.ResourceOperationStatus}
 
 ```typespec
@@ -353,24 +335,6 @@ model Azure.Core.ResourceOperationStatus<Resource, StatusResult, StatusError>
 | error?  | `StatusError`                                                             |             |
 | result? | `StatusResult`                                                            |             |
 
-### `ResponseProperty` {#Azure.Core.ResponseProperty}
-
-Defines a property as a response header.
-
-```typespec
-model Azure.Core.ResponseProperty<Name>
-```
-
-#### Template Parameters
-
-| Name | Description      |
-| ---- | ---------------- |
-| Name | The header name. |
-
-#### Properties
-
-None
-
 ### `SelectQueryParameter` {#Azure.Core.SelectQueryParameter}
 
 Provides the standard 'select' query parameter for list operations.

website/src/content/docs/docs/libraries/azure-core/reference/decorators.md

@@ -311,42 +311,6 @@ Deletes any key properties from the model.
 
 None
 
-### `@requestParameter` {#@Azure.Core.Foundations.requestParameter}
-
-Identifies a property on a request model that serves as a linked operation parameter.
-
-```typespec
-@Azure.Core.Foundations.requestParameter(name: valueof string)
-```
-
-#### Target
-
-`Model`
-
-#### Parameters
-
-| Name | Type             | Description                 |
-| ---- | ---------------- | --------------------------- |
-| name | `valueof string` | Property name on the target |
-
-### `@responseProperty` {#@Azure.Core.Foundations.responseProperty}
-
-Identifies a property on _all_ non-error response models that serve as a linked operation parameter.
-
-```typespec
-@Azure.Core.Foundations.responseProperty(name: valueof string)
-```
-
-#### Target
-
-`Model`
-
-#### Parameters
-
-| Name | Type             | Description                 |
-| ---- | ---------------- | --------------------------- |
-| name | `valueof string` | Property name on the target |
-
 ## Azure.Core.Traits
 
 ### `@trait` {#@Azure.Core.Traits.trait}

website/src/content/docs/docs/libraries/azure-core/reference/index.mdx

@@ -94,9 +94,7 @@ npm install --save-peer @azure-tools/typespec-azure-core
 - [`RepeatabilityRequestHeaders`](./data-types.md#Azure.Core.RepeatabilityRequestHeaders)
 - [`RepeatabilityResponseHeaders`](./data-types.md#Azure.Core.RepeatabilityResponseHeaders)
 - [`RequestIdResponseHeader`](./data-types.md#Azure.Core.RequestIdResponseHeader)
-- [`RequestParameter`](./data-types.md#Azure.Core.RequestParameter)
 - [`ResourceOperationStatus`](./data-types.md#Azure.Core.ResourceOperationStatus)
-- [`ResponseProperty`](./data-types.md#Azure.Core.ResponseProperty)
 - [`SelectQueryParameter`](./data-types.md#Azure.Core.SelectQueryParameter)
 - [`SkipQueryParameter`](./data-types.md#Azure.Core.SkipQueryParameter)
 - [`StandardListQueryParameters`](./data-types.md#Azure.Core.StandardListQueryParameters)
@@ -109,8 +107,6 @@ npm install --save-peer @azure-tools/typespec-azure-core
 ### Decorators
 
 - [`@omitKeyProperties`](./decorators.md#@Azure.Core.Foundations.omitKeyProperties)
-- [`@requestParameter`](./decorators.md#@Azure.Core.Foundations.requestParameter)
-- [`@responseProperty`](./decorators.md#@Azure.Core.Foundations.responseProperty)
 
 ### Operations