refactor(nav): queue based transitions

src/navigation/nav-util.ts

@@ -0,0 +1,176 @@
+import { Renderer, TypeDecorator } from '@angular/core';
+
+import { DeepLinker } from './deep-linker';
+import { isPresent } from '../util/util';
+import { isViewController, ViewController } from './view-controller';
+import { NavControllerBase } from './nav-controller-base';
+import { Transition } from '../transitions/transition';
+
+
+export function convertToView(linker: DeepLinker, nameOrPageOrView: any, params: any): ViewController {
+  if (nameOrPageOrView) {
+    if (isViewController(nameOrPageOrView)) {
+      // is already a ViewController
+      return nameOrPageOrView;
+    }
+    if (typeof nameOrPageOrView === 'function') {
+      // is a page component, now turn it into a ViewController
+      return new ViewController(nameOrPageOrView, params);
+    }
+    if (typeof nameOrPageOrView === 'string') {
+      // is a string, see if it matches a
+      const component = linker.getComponentFromName(nameOrPageOrView);
+      if (component) {
+        // found a page component in the link config by name
+        return new ViewController(component, params);
+      }
+    }
+  }
+  console.error(`invalid page component: ${nameOrPageOrView}`);
+  return null;
+}
+
+export function convertToViews(linker: DeepLinker, pages: any[]): ViewController[] {
+  const views: ViewController[] = [];
+  if (pages) {
+    for (var i = 0; i < pages.length; i++) {
+      var page = pages[i];
+      if (page) {
+        if (isViewController(page)) {
+          views.push(page);
+
+        } else {
+          views.push(convertToView(linker, page.page, page.params));
+        }
+      }
+    }
+  }
+  return views;
+}
+
+export function setZIndex(nav: NavControllerBase, enteringView: ViewController, leavingView: ViewController, direction: string, renderer: Renderer) {
+  if (enteringView) {
+
+    leavingView = leavingView || nav.getPrevious(enteringView);
+
+    if (leavingView && isPresent(leavingView._zIndex)) {
+      if (direction === DIRECTION_BACK) {
+        enteringView._setZIndex(leavingView._zIndex - 1, renderer);
+
+      } else {
+        enteringView._setZIndex(leavingView._zIndex + 1, renderer);
+      }
+
+    } else {
+      enteringView._setZIndex(nav._isPortal ? PORTAL_ZINDEX : INIT_ZINDEX, renderer);
+    }
+  }
+}
+
+export function isTabs(nav: any) {
+  // Tabs (ion-tabs)
+  return !!nav && !!nav.getSelected;
+}
+
+export function isTab(nav: any) {
+  // Tab (ion-tab)
+  return !!nav && isPresent(nav._tabId);
+}
+
+export function isNav(nav: any) {
+  // Nav (ion-nav), Tab (ion-tab), Portal (ion-portal)
+  return !!nav && !!nav.push;
+}
+
+// public link interface
+export interface DeepLinkMetadataType {
+  name: string;
+  segment?: string;
+  defaultHistory?: any[];
+}
+
+export class DeepLinkMetadata implements DeepLinkMetadataType {
+  component: any;
+  name: string;
+  segment?: string;
+  defaultHistory?: any[];
+}
+
+export interface DeepLinkDecorator extends TypeDecorator {}
+
+export interface DeepLinkMetadataFactory {
+  (obj: DeepLinkMetadataType): DeepLinkDecorator;
+  new (obj: DeepLinkMetadataType): DeepLinkMetadata;
+}
+
+export var DeepLink: DeepLinkMetadataFactory;
+
+export interface DeepLinkConfig {
+  links: DeepLinkMetadata[];
+}
+
+// internal link interface, not exposed publicly
+export interface NavLink {
+  component: any;
+  name?: string;
+  segment?: string;
+  parts?: string[];
+  partsLen?: number;
+  staticLen?: number;
+  dataLen?: number;
+  defaultHistory?: any[];
+}
+
+export interface NavSegment {
+  id: string;
+  name: string;
+  component: any;
+  data: any;
+  navId?: string;
+  defaultHistory?: NavSegment[];
+}
+
+export interface NavOptions {
+  animate?: boolean;
+  animation?: string;
+  direction?: string;
+  duration?: number;
+  easing?: string;
+  id?: string;
+  keyboardClose?: boolean;
+  progressAnimation?: boolean;
+  ev?: any;
+  updateUrl?: boolean;
+  isNavRoot?: boolean;
+}
+
+export interface TransitionResolveFn {
+  (hasCompleted: boolean, requiresTransition: boolean, enteringName?: string, leavingName?: string, direction?: string): void;
+}
+
+export interface TransitionRejectFn {
+  (rejectReason: any, transition?: Transition): void;
+}
+
+export interface TransitionInstruction {
+  opts: NavOptions;
+  insertStart?: number;
+  insertViews?: ViewController[];
+  removeStart?: number;
+  removeCount?: number;
+  resolve?: TransitionResolveFn;
+  reject?: TransitionRejectFn;
+}
+
+export enum ViewState {
+  INITIALIZED,
+  PRE_RENDERED,
+  LOADED,
+}
+
+export const INIT_ZINDEX = 100;
+export const PORTAL_ZINDEX = 9999;
+
+export const DIRECTION_BACK = 'back';
+export const DIRECTION_FORWARD = 'forward';
+export const DIRECTION_SWITCH = 'switch';