router.js

import EmberRouter from '@embroider/router';
import { scheduleOnce } from '@ember/runloop';
import config from 'ember-api-docs/config/environment';
import { inject as service } from '@ember/service';

class AppRouter extends EmberRouter {
  location = config.locationType;
  rootURL = config.routerRootURL;

  @service metrics;
  @service fastboot;

  constructor() {
    super(...arguments);

    if (!this.fastboot.isFastBoot) {
      this.on('routeDidChange', this, this._trackPage);
    }
  }

  _trackPage() {
    scheduleOnce('afterRender', this, this.__trackPage);
  }

  __trackPage() {
    // this is constant for this app and is only used to identify page views in the GA dashboard
    const hostname = config.APP.domain.replace(/(http|https)?:?\/\//g, '');

    const page = this.url;
    const title =
      this.currentRouteName === undefined ? 'unknown' : this.currentRouteName;
    this.metrics.trackPage({ page, title, hostname });
  }
}

AppRouter.map(function () {
  this.route('ember-cli');
  this.route('project', { path: '/:project' });

  this.route(
    'project-version',
    { path: '/:project/:project_version' },
    function () {
      // this.route('classes-redirect', {path: '/classes'});

      // project-version.classes-redirect => project-version.classes.index
      // project-version.class => project-version.classes.class
      this.route('classes', function () {
        this.route('class', { path: '/:class' }, itemRoutes);
      });
      // this.route('class', {path: '/classes/:class'}, itemRoutes);

      this.route('functions', function () {
        this.route('function', { path: '/:module/:fn' });
      });

      // Namespace routes
      // project-version.namespace => project-version.namespaces.namespace
      //    routes/project-version/namespace   =>  routes/project-version/namespaces/namespace
      this.route('namespaces', function () {
        this.route('namespace', { path: '/:namespace' }, itemRoutes);
      });
      // this.route('namespace', {path: '/namespaces/:namespace'}, itemRoutes);

      // Module routes
      // project-version.module => project-version.modules.module
      //    routes/project-version/module   =>  routes/project-version/modules/module
      //    routes/project-version/module/* =>  routes/project-version/modules/module/*
      this.route('modules', function () {
        this.route('module', { path: '/:module' }, itemRoutes);
      });
      // this.route('module', {path: '/modules/:module'}, itemRoutes);

      // Common sub-routes
      function itemRoutes() {
        this.route('methods', function () {
          this.route('method', { path: '/:method' });
        });
        this.route('properties', function () {
          this.route('property', { path: '/:property' });
        });
        this.route('events', function () {
          this.route('event', { path: '/:event' });
        });
      }
    }
  );
  this.route('class', { path: '/classes/:class' });
  this.route('module', { path: '/modules/:module' });
  this.route('data-class', { path: '/data/classes/:class' });
  this.route('data-module', { path: '/data/modules/:module' });
});

/*
404
ember-cli
project

/:project/:project_version
  /classes/:class
    /methods, /properties, /events
  /functions/:module (no sub routes)
  /namespaces/:namespace
    /methods, /properties, /events
  /modules/:module
    /methods, /properties, /events

SUB ROUTES

Instead of https://api.emberjs.com/ember/4.6/classes/Engine/methods/unregister?anchor=unregister
We can do https://api.emberjs.com/ember/4.6/classes/Engine/methods?anchor=unregister

  /methods/:method
  /properties/:property
  /events/:event

OTHER STATES
private, deprecated, inherited, protected
inherited is not reflected in URL state but it's checked by default

MAYBE REDIRECTS

/data/modules/:module
/data/classes/:class
/modules/:module
/classes/:class
*/

export default AppRouter;