add nested test cases for client-initialization

.chronus/changes/nested-test-cases-for-clientinit-2026-0-20-9-55-29.md

@@ -0,0 +1,8 @@
+---
+# Change versionKind to one of: internal, fix, dependencies, feature, deprecation, breaking
+changeKind: fix
+packages:
+  - "@azure-tools/azure-http-specs"
+---
+
+add nested test cases for client-initialization

packages/azure-http-specs/specs/azure/client-generator-core/client-initialization/client.tsp → packages/azure-http-specs/specs/azure/client-generator-core/client-initialization/default/main.tsp

@@ -1,23 +1,19 @@
-import "./main.tsp";
-import "@azure-tools/typespec-client-generator-core";
-import "@typespec/spector";
 import "@typespec/http";
+import "@typespec/spector";
+import "@azure-tools/typespec-client-generator-core";
 
-using Spector;
 using Http;
+using Spector;
+using Azure.ClientGenerator.Core;
 
-@route("/azure/client-generator-core/client-initialization")
-namespace _Specs_.Azure.ClientGenerator.Core.ClientInitialization;
+@doc("Test for client initialization decorator - moving parameters from method to client level")
+@scenarioService("/azure/client-generator-core/client-initialization/default")
+namespace _Specs_.Azure.ClientGenerator.Core.ClientInitialization.DefaultClient;
 
-@@global.Azure.ClientGenerator.Core.clientNamespace(_Specs_.Azure.ClientGenerator.Core.ClientInitialization,
-  "azure.clientgenerator.core.clientinitialization",
-  "java"
-);
-@@global.Azure.ClientGenerator.Core.clientNamespace(Service,
-  "azure.clientgenerator.core.clientinitialization",
+@global.Azure.ClientGenerator.Core.clientNamespace(
+  "azure.clientgenerator.core.clientinitialization.defaultclient",
   "java"
-);
-
+)
 model HeaderParamClientOptions {
   @doc("The name of the client. This parameter is used as a header in all operations.")
   name: string;
@@ -47,6 +43,32 @@ model ParamAliasClientOptions {
   blobName: string;
 }
 
+model BlobQueryParamClientOptions {
+  @doc("The blob name to use for operations")
+  blobName: string;
+}
+
+// Common parameter types and models
+
+model NameHeaderParam {
+  @header("name")
+  name: string;
+}
+
+model RegionQueryParam {
+  @query
+  region: string;
+}
+
+model Input {
+  name: string;
+}
+
+model BlobQueryParam {
+  @query
+  blobName: string;
+}
+
 // Scenario 1: Header parameter moved to client level
 @scenarioDoc("""
   Client for testing header parameter moved to client level.
@@ -68,13 +90,17 @@ model ParamAliasClientOptions {
 @doc("Client for testing header parameter moved to client level.")
 @global.Azure.ClientGenerator.Core.client({
   name: "HeaderParamClient",
-  service: Service,
 })
 @global.Azure.ClientGenerator.Core.clientInitialization(HeaderParamClientOptions)
 @route("/header-param")
 interface HeaderParam {
-  withQuery is Service.HeaderParam.withQuery;
-  withBody is Service.HeaderParam.withBody;
+  @route("/with-query")
+  @get
+  withQuery(...NameHeaderParam, @query id: string): void;
+
+  @route("/with-body")
+  @post
+  withBody(...NameHeaderParam, @body body: Input): void;
 }
 
 // Scenario 2: Multiple parameters (header and query) moved to client level
@@ -97,47 +123,63 @@ interface HeaderParam {
   ```
   """)
 @scenario
+@doc("Client for testing multiple parameters (header and query) moved to client level.")
 @global.Azure.ClientGenerator.Core.client({
   name: "MultipleParamsClient",
-  service: Service,
 })
 @global.Azure.ClientGenerator.Core.clientInitialization(MultipleParamsClientOptions)
 @route("/multiple-params")
 interface MultipleParams {
-  withQuery is Service.MultipleParams.withQuery;
-  withBody is Service.MultipleParams.withBody;
+  @route("/with-query")
+  @get
+  withQuery(...NameHeaderParam, ...RegionQueryParam, @query id: string): void;
+
+  @route("/with-body")
+  @post
+  withBody(...NameHeaderParam, ...RegionQueryParam, @body body: Input): void;
 }
 
 // Scenario 3: Mix of client-level and method-level parameters
 @scenarioDoc("""
-    Client for testing a mix of client-level and method-level parameters.
-    
-    Parameters elevated to client level:
-    - name: "test-name-value" (header parameter)
-    
-    Parameters remaining at method level:
-    - region: "us-west" (query parameter)
-    
-    Expected client usage:
-    ```ts
-    const client = new MixedParamsClient({
-      name: "test-name-value"
-    });
-    
-    client.withQuery(region: "us-west", id: "test-id");  // region stays as method param
-    client.withBody( region: "us-west", body: { name: "test-name" });  // region stays as method param
-    ```
+  Client for testing a mix of client-level and method-level parameters.
+
+  Parameters elevated to client level:
+  - name: "test-name-value" (header parameter)
+
+  Parameters remaining at method level:
+  - region: "us-west" (query parameter)
+
+  Expected client usage:
+  ```ts
+  const client = new MixedParamsClient({
+    name: "test-name-value"
+  });
+
+  client.withQuery(region: "us-west", id: "test-id");  // region stays as method param
+  client.withBody(region: "us-west", body: { name: "test-name" });  // region stays as method param
+  ```
   """)
 @scenario
+@doc("Client for testing a mix of client-level and method-level parameters.")
 @global.Azure.ClientGenerator.Core.client({
   name: "MixedParamsClient",
-  service: Service,
 })
 @global.Azure.ClientGenerator.Core.clientInitialization(MixedParamsClientOptions)
 @route("/mixed-params")
 interface MixedParams {
-  withQuery is Service.MixedParams.withQuery;
-  withBody is Service.MixedParams.withBody;
+  @route("/with-query")
+  @get
+  withQuery(...NameHeaderParam, ...RegionQueryParam, @query id: string): void;
+
+  @route("/with-body")
+  @post
+  withBody(
+    ...NameHeaderParam,
+    ...RegionQueryParam,
+    @body body: {
+      name: string;
+    },
+  ): void;
 }
 
 // Scenario 4: Path parameter moved to client level
@@ -160,87 +202,111 @@ interface MixedParams {
   ```
   """)
 @scenario
+@doc("Blob operations with path parameter that should be moved to client level")
 @global.Azure.ClientGenerator.Core.client({
   name: "PathParamClient",
-  service: Service,
 })
 @global.Azure.ClientGenerator.Core.clientInitialization(PathParamClientOptions)
 @route("/path")
 interface PathParam {
-  withQuery is Service.PathParam.withQuery;
-  getStandalone is Service.PathParam.getStandalone;
-  deleteStandalone is Service.PathParam.deleteStandalone;
+  @route("/{blobName}/with-query")
+  @get
+  withQuery(@path blobName: string, @query format?: string): void;
+
+  @route("/{blobName}/get-standalone")
+  @get
+  getStandalone(@path blobName: string): BlobProperties;
+
+  @route("/{blobName}")
+  @delete
+  deleteStandalone(@path blobName: string): void;
 }
 
 // Scenario 5: Parameter aliases for better client API names
 @scenarioDoc("""
   Client for testing the @paramAlias decorator for renaming parameters in client code.
 
   Parameters elevated to client level:
-  - blobName: "sample-blob" (path parameter)
+  - blobName: "sample-blob" (path parameter with @paramAlias("blob"))
 
   Expected client usage:
   ```ts
-  // Elevated to client level via alias
-  client.withAliasedName();
+  const client = new ParamAliasClient({
+    blobName: "sample-blob"
+  });
 
-  // Elevated to client level via original name
+  // Operations don't need blob/blobName parameter
+  client.withAliasedName();
   client.withOriginalName();
   ```
   """)
 @scenario
-@global.Azure.ClientGenerator.Core.clientInitialization(ParamAliasClientOptions)
+@doc("Operations demonstrating the @paramAlias decorator for renaming parameters in client code")
 @global.Azure.ClientGenerator.Core.client({
   name: "ParamAliasClient",
-  service: Service,
 })
+@global.Azure.ClientGenerator.Core.clientInitialization(ParamAliasClientOptions)
 @route("/param-alias")
 interface ParamAlias {
-  withAliasedName is Service.ParamAlias.withAliasedName;
-  withOriginalName is Service.ParamAlias.withOriginalName;
+  @route("/{blob}/with-aliased-name")
+  @get
+  withAliasedName(
+    @path
+    blob: string,
+  ): void;
+
+  @route("/{blobName}/with-original-name")
+  @get
+  withOriginalName(
+    @path
+    blobName: string,
+  ): void;
 }
 
+@doc("Properties of a blob")
+model BlobProperties {
+  name: string;
+  size: int64;
+  contentType: string;
+  createdOn: utcDateTime;
+}
+
+// Scenario 6: Query parameter moved to client level
+@scenarioDoc("""
+  Client for testing query parameter moved to client level.
+
+  Parameters elevated to client level:
+  - blobName: "test-blob" (query parameter)
+
+  Expected client usage:
+  ```ts
+  const client = new QueryParamClient({
+    blobName: "test-blob"
+  });
+
+  // Operations don't need blobName parameter
+  client.withQuery(format: "text");
+  client.getStandalone();
+  client.deleteStandalone();
+  ```
+  """)
+@scenario
+@doc("Blob operations with query parameter that should be moved to client level")
 @global.Azure.ClientGenerator.Core.client({
-  name: "ParentClient",
-  service: Service,
+  name: "QueryParamClient",
 })
-namespace ParentClient {
-  @scenarioDoc("""
-    Client for testing a path parameter (blobName) moved to client level, in child client.
-
-    The child client can be initialized individually, or via its parent client.
-
-    Parameters elevated to client level:
-    - blobName: "sample-blob" (path parameter)
-
-    Expected client usage:
-    ```ts
-    // via ParentClient
-    const client = new ParentClient.getChildClient({
-      blobName: "sample-blob"
-    });
-
-    // directly
-    const client = new ChildClient({
-      blobName: "sample-blob"
-    });
-
-    // No need to pass blobName to any operations
-    client.withQuery(format: "text");  
-    client.getStandalone();
-    client.deleteStandalone();
-    ```
-    """)
-  @scenario
-  @global.Azure.ClientGenerator.Core.operationGroup
-  @global.Azure.ClientGenerator.Core.clientInitialization({
-    parameters: PathParamClientOptions,
-    initializedBy: global.Azure.ClientGenerator.Core.InitializedBy.individually | global.Azure.ClientGenerator.Core.InitializedBy.parent,
-  })
-  @route("/child-client")
-  interface ChildClient {
-    withQuery is Service.ChildClient.withQuery;
-    getStandalone is Service.ChildClient.getStandalone;
-    deleteStandalone is Service.ChildClient.deleteStandalone;
-  }
+@global.Azure.ClientGenerator.Core.clientInitialization(BlobQueryParamClientOptions)
+@route("/query")
+interface QueryParam {
+  @route("/with-query")
+  @get
+  withQuery(...BlobQueryParam, @query format?: string): void;
+
+  @route("/get-standalone")
+  @get
+  getStandalone(...BlobQueryParam): BlobProperties;
+
+  @route("/delete-resource")
+  @delete
+  deleteStandalone(...BlobQueryParam): void;
 }