multiple-param-alias

Id

@azure-tools/typespec-client-generator-core/multiple-param-alias

Severity: warning

This diagnostic is issued when more than one @paramAlias is applied to the same model property in the same effective scope.

Impact

• Area: Client initialization parameter naming. Generation continues using the first alias, while later aliases for the same scoped parameter are ignored.
• Not affected: Operation-level parameter names and wire names are unchanged.

❌ Incorrect Usage

model ClientOptions {
  account: string;
}

@@paramAlias(ClientOptions.account, "accountName");
@@paramAlias(ClientOptions.account, "storageAccountName"); // second alias for the same parameter scope

Diagnostic Message

TCGC reports:

Multiple param aliases applied to 'account'. Only the first one 'accountName' will be used.

✅ How to Fix

Keep only one alias for the property in a given scope, or scope the aliases so only one applies to each emitter.

model ClientOptions {
  account: string;
}

@@paramAlias(ClientOptions.account, "accountName");

Suppression

This diagnostic should not be suppressed. Fix the @paramAlias usage so each parameter has a single alias.