Reify view ownership as a message pipe.

mojo/services/ui/views/interfaces/view_manager.mojom

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 [DartPackage="mojo_services"]
 module mojo.ui;
 
 import "mojo/services/ui/views/interfaces/views.mojom";
 import "mojo/services/ui/views/interfaces/view_associates.mojom";
 import "mojo/services/ui/views/interfaces/view_trees.mojom";
@@ skipping 10 matching lines @@
 interface ViewManager {
   // Registers a view with the view manager.
   //
   // When a view is registered, it receives its own host and a token
   // to identify it.
   //
   // The |view_host| is used to configure the view and interact with its
   // local environment.  The view host is private to the view and should
   // not be shared with anyone else.
   //
-  // The |view_token| is used as a transferable reference which can
+  // The |view_owner| is used as a transferable reference which can
   // be passed to the view's intended container as part of a request to
   // add the view as a child.  The view manager itself does not describe
-  // how this interaction should take place, only that the token should
+  // how this interaction should take place, only that ownership should
   // eventually be passed back through the container's view host interface
-  // as an argument to AddChild().
+  // as an argument to |ViewHost.AddChild()|.
   //
   // The |label| is an optional name to associate with the view for
   // diagnostic purposes.  The label will be truncated if it is longer
   // than |kLabelMaxLength|.
   //
   // To unregister the view and cause it to be removed from the view tree,
-  // simply close the |view| and/or |view_host| message pipes.
+  // simply close the |view|, |view_host|, or |view_owner| message pipes.
+  //
+  // TODO(jeffbrown): Refactor this so View becomes a ViewListener,
+  // ViewHost becomes View, and there are only two pipes here.
   RegisterView(mojo.ui.View view,
                mojo.ui.ViewHost& view_host,
-               string? label) => (mojo.ui.ViewToken view_token);
+               mojo.ui.ViewOwner& view_owner,
+               string? label);
 
   // Registers a view tree with the view manager.
   //
   // The |view_tree_host| is used to configure the view tree and interact
   // with the views it contains.  The view tree host is private to the view
   // and should not be shared with anyone else.
   //
   // The |label| is an optional name to associate with the view tree for
   // diagnostic purposes.  The label will be truncated if it is longer
   // than |kLabelMaxLength|.
   //
   // The |view_tree_token| is used as a transferable reference which can
   // be passed to trusted services to reference the view tree.
   //
   // To unregister the view tree simply close the |view_tree| and/or
   // |view_tree_host| message pipes.
   RegisterViewTree(mojo.ui.ViewTree view_tree,
                    mojo.ui.ViewTreeHost& view_tree_host,
-                   string? label) => (mojo.ui.ViewTreeToken view_tree_token);
+                   string? label);
 };