[TIMOB-25522] iOS: Add "navigationWindow" property to Ti.UI.Window, add unit-tests for all nav-window API's

apidoc/Titanium/UI/Window.yml

@@ -641,6 +641,16 @@ properties:
     osver: {ios: {min: "7.0"}}
     platforms: [iphone,ipad]
 
+  - name: navigationWindow
+    summary: The <Titanium.UI.iOS.NavigationWindow> instance hosting this window.
+    description: |
+        Returns the navigation window that hosts this window. Returns `null` if the window is not 
+        hosted by a navigation window.
+    since: "7.1.0"
+    type: Titanium.UI.iOS.NavigationWindow
+    permission: read-only
+    platforms: [iphone, ipad]  
+
   - name: opacity
     summary: The opacity from 0.0-1.0.
     description: |

iphone/Classes/TiWindowProxy.m

@@ -11,6 +11,10 @@
 #import "TiUIWindow.h"
 #import "TiUIWindowProxy.h"
 
+#ifdef USE_TI_UIIOSNAVIGATIONWINDOW
+#import "TiUIiOSNavWindowProxy.h"
+#endif
+
 @interface TiWindowProxy (Private)
 - (void)openOnUIThread:(id)args;
 - (void)closeOnUIThread:(id)args;
@@ -646,6 +650,18 @@ - (void)showToolbar:(NSArray *)args
   }
 }
 
+#ifdef USE_TI_UIIOSNAVIGATIONWINDOW
+- (TiUIiOSNavWindowProxy *)navigationWindow
+{
+  if (parentController != nil && [parentController isKindOfClass:[TiUIiOSNavWindowProxy class]]) {
+    return (TiUIiOSNavWindowProxy *)parentController;
+  }
+
+  NSLog(@"[ERROR] Trying to receive a Ti.UI.NavigationWindow instance that does not exist in this context!");
+  return nil;
+}
+#endif
+
 - (void)hideToolbar:(NSArray *)args
 {
   ENSURE_UI_THREAD(hideToolbar, args);

tests/Resources/ti.ui.ios.navigationwindow.addontest.js

@@ -0,0 +1,132 @@
+/*
+ * Appcelerator Titanium Mobile
+ * Copyright (c) 2011-Present by Appcelerator, Inc. All Rights Reserved.
+ * Licensed under the terms of the Apache Public License
+ * Please see the LICENSE included with this distribution for details.
+ */
+/* eslint-env mocha */
+/* global Ti */
+/* eslint no-unused-expressions: "off" */
+'use strict';
+
+var should = require('./utilities/assertions'),
+	utilities = require('./utilities/utilities');
+
+describe('Titanium.UI.iOS.NavigationWindow', function () {
+	var win, rootWindow;
+
+	this.timeout(5000);
+
+	// Create and open a root window for the rest of the below child window tests to use as a parent.
+	// We're not going to close this window until the end of this test suite.
+	// Note: Android needs this so that closing the last window won't back us out of the app.
+	before(function (finish) {
+		rootWindow = Ti.UI.createWindow();
+		rootWindow.addEventListener('open', function () {
+			finish();
+		});
+		rootWindow.open();
+	});
+
+	after(function (finish) {
+		rootWindow.addEventListener('close', function () {
+			finish();
+		});
+		rootWindow.close();
+	});
+
+	afterEach(function () {
+		if (win) {
+			win.close();
+		}
+		win = null;
+	});
+
+	it.ios('#openWindow', function () {
+		var nav = Ti.UI.iOS.createNavigationWindow({
+			window: win
+		});
+
+		win = Ti.UI.createWindow();
+		var subWindow = Ti.UI.createWindow();
+
+		win.addEventListener('open', function () {
+			should(nav.openWindow).be.a.function;
+			nav.openWindow(subWindow);
+		});
+
+		subWindow.addEventListener('open', function () {
+			nav.close();
+			finish();
+		});
+
+		nav.open();
+	});
+
+	it.ios('#closeWindow', function () {
+		var nav = Ti.UI.iOS.createNavigationWindow({
+			window: win
+		});
+
+		win = Ti.UI.createWindow();
+		var subWindow = Ti.UI.createWindow();
+
+		win.addEventListener('open', function () {
+			nav.openWindow(subWindow);
+		});
+
+		subWindow.addEventListener('open', function () {
+			should(nav.closeWindow).be.a.function;
+			nav.closeWindow(subWindow);
+		});
+
+		subWindow.addEventListener('close', function () {
+			finish();
+		});
+
+		nav.open();
+	});
+
+	it.ios('#popToRootWindow', function () {
+		var nav = Ti.UI.iOS.createNavigationWindow({
+			window: win
+		});
+
+		win = Ti.UI.createWindow();
+		var subWindow = Ti.UI.createWindow();
+
+		win.addEventListener('open', function () {
+			nav.openWindow(subWindow);
+		});
+
+		subWindow.addEventListener('open', function () {
+			should(nav.popToRootWindow).be.a.function;
+			nav.popToRootWindow();
+			finish();
+		});
+
+		nav.open();
+	});
+
+	it.ios('.navigationWindow', function () {
+		var nav = Ti.UI.iOS.createNavigationWindow({
+		  window: win
+		});
+
+		win = Ti.UI.createWindow();
+
+		win.addEventListener('open', function () {
+			should(nav).not.be.undefined;
+			should(win.navigationWindow).not.be.undefined;
+
+			should(win.navigationWindow).eql(nav);
+
+			should(nav.openWindow).be.a.function;
+			should(win.navigationWindow.openWindow).be.a.function;
+			nav.close();
+			finish();
+		});
+
+		nav.open();
+	});
+});