Implement the Route Manager API (RFC #1169)

.gitignore

@@ -31,6 +31,7 @@ test/version_tmp
 test_*.html
 /tests/ember-tests.js
 /smoke-tests/scenarios/output/
+/smoke-tests/scenarios/output-*/
 tmp
 tmp*.gem
 tmp.bpm

package.json

@@ -205,6 +205,16 @@
       "@ember/-internals/metal/index.js": "ember-source/@ember/-internals/metal/index.js",
       "@ember/-internals/owner/index.js": "ember-source/@ember/-internals/owner/index.js",
       "@ember/-internals/routing/index.js": "ember-source/@ember/-internals/routing/index.js",
+      "@ember/-internals/routing/route-managers/api.js": "ember-source/@ember/-internals/routing/route-managers/api.js",
+      "@ember/-internals/routing/route-managers/classic/bucket.js": "ember-source/@ember/-internals/routing/route-managers/classic/bucket.js",
+      "@ember/-internals/routing/route-managers/classic/manager.js": "ember-source/@ember/-internals/routing/route-managers/classic/manager.js",
+      "@ember/-internals/routing/route-managers/classic/outlet-component.js": "ember-source/@ember/-internals/routing/route-managers/classic/outlet-component.js",
+      "@ember/-internals/routing/route-managers/classic/query-params.js": "ember-source/@ember/-internals/routing/route-managers/classic/query-params.js",
+      "@ember/-internals/routing/route-managers/classic/substates.js": "ember-source/@ember/-internals/routing/route-managers/classic/substates.js",
+      "@ember/-internals/routing/route-managers/management.js": "ember-source/@ember/-internals/routing/route-managers/management.js",
+      "@ember/-internals/routing/route-managers/outlet-state.js": "ember-source/@ember/-internals/routing/route-managers/outlet-state.js",
+      "@ember/-internals/routing/route-managers/registry.js": "ember-source/@ember/-internals/routing/route-managers/registry.js",
+      "@ember/-internals/routing/route-managers/root-outlet.js": "ember-source/@ember/-internals/routing/route-managers/root-outlet.js",
       "@ember/-internals/runtime/index.js": "ember-source/@ember/-internals/runtime/index.js",
       "@ember/-internals/runtime/lib/ext/rsvp.js": "ember-source/@ember/-internals/runtime/lib/ext/rsvp.js",
       "@ember/-internals/runtime/lib/mixins/-proxy.js": "ember-source/@ember/-internals/runtime/lib/mixins/-proxy.js",

packages/@ember/-internals/glimmer/index.ts

@@ -17,7 +17,7 @@
   The documentation for `@ember/component` still refers to the older authoring format. To read about
   the new authoring format, see the
   [Glimmer Component API documentation](/ember/release/modules/@glimmer%2Fcomponent).
-    
+
   ### Showing a property
 
   Templates manage the flow of an application's UI, and display state (through
@@ -118,6 +118,7 @@ export { default as Input } from './lib/components/input';
 export { default as LinkTo } from './lib/components/link-to';
 export { default as Textarea } from './lib/components/textarea';
 export { default as Component } from './lib/component';
+export { makeRouteTemplate } from './lib/component-managers/route-template';
 export {
   default as Helper,
   helper,
@@ -139,6 +140,7 @@ export {
   _resetRenderers,
   renderSettled,
   renderComponent,
+  setRenderer,
   type View,
 } from './lib/renderer';
 export {
@@ -156,8 +158,7 @@ export { DOMChanges, NodeDOMTreeConstruction, DOMTreeConstruction } from './lib/
 // TODO just test these through public API
 // a lot of these are testing how a problem was solved
 // rather than the problem was solved
-export { default as OutletView, type BootEnvironment } from './lib/views/outlet';
-export type { OutletState, RenderState } from './lib/utils/outlet';
+export type { BootEnvironment } from '@ember/engine/instance';
 export {
   componentCapabilities,
   modifierCapabilities,

packages/@ember/-internals/glimmer/lib/base-renderer.ts

@@ -426,6 +426,15 @@ interface RenderCacheEntry {
   glimmerResult: GlimmerRenderResult | undefined;
 }
 
+// Cursor descriptor isn't a stable enough reference.
+// Cursor fails during application teardown
+type RendererCacheKey = Element | SimpleElement;
+
+const isDOMElement = (into: IntoTarget): into is Element => 'innerHTML' in into;
+
+const cacheKey = (into: IntoTarget): RendererCacheKey =>
+  'element' in into ? (into as Cursor).element : (into as RendererCacheKey);
+
 function intoTarget(into: IntoTarget): Cursor {
   if ('element' in into) {
     return into;
@@ -527,14 +536,15 @@ export function renderComponent(
    *
    * NOTE: destruction is async
    */
-  let existing = RENDER_CACHE.get(into);
+  let key = cacheKey(into);
+  let existing = RENDER_CACHE.get(key);
   existing?.result.destroy();
   /**
    * We can only replace the inner HTML the first time.
    * Because destruction is async, it won't be safe to
    * do this again, and we'll have to rely on the above destroy.
    */
-  if (!existing && into instanceof Element) {
+  if (!existing && isDOMElement(into)) {
     into.innerHTML = '';
   }
 
@@ -552,16 +562,19 @@ export function renderComponent(
    */
   let renderTarget: IntoTarget = into;
   if (existing?.glimmerResult) {
-    let parentElement =
-      into instanceof Element ? (into as unknown as SimpleElement) : (into as Cursor).element;
     let firstNode = existing.glimmerResult.firstNode();
-    renderTarget = { element: parentElement, nextSibling: firstNode };
+    renderTarget = { element: key as SimpleElement, nextSibling: firstNode };
   }
 
   let innerResult = renderer.render(component, { into: renderTarget, args }).result;
 
   if (innerResult) {
     associateDestroyableChild(owner, innerResult);
+    registerDestructor(innerResult, () => {
+      if (RENDER_CACHE.get(key)?.glimmerResult === innerResult) {
+        RENDER_CACHE.delete(key);
+      }
+    });
   }
 
   let result: RenderResult = {
@@ -572,14 +585,22 @@ export function renderComponent(
     },
   };
 
-  RENDER_CACHE.set(into, { result, glimmerResult: innerResult });
+  RENDER_CACHE.set(key, { result, glimmerResult: innerResult });
 
   return result;
 }
 
-const RENDER_CACHE = new WeakMap<IntoTarget, RenderCacheEntry>();
+const RENDER_CACHE = new WeakMap<RendererCacheKey, RenderCacheEntry>();
 const RENDERER_CACHE = new WeakMap<object, BaseRenderer>();
 
+/**
+ * The application seeds its `renderer:-dom` service which allows for
+ * router-aware resolver to resolve {{mount}}
+ */
+export function setRenderer(owner: object, renderer: BaseRenderer): void {
+  RENDERER_CACHE.set(owner, renderer);
+}
+
 export class BaseRenderer {
   static strict(
     owner: object,