BREAKING CHANGE: Deprecate public use of $urlRouter and $urlMatcherFactory in favor of $urlService

The `UrlService` combines the commonly used URL APIs in a single place.
The service may be injected in a run block as `$urlService`, or in a config block as `$urlServiceProvider`.

The service object has two nested API objects, `rules` and `config`. An example usage is `$urlService.rules.otherwise('/home')`

The existing API for `$urlRouter` and `$urlMatcherFactory` will continue to function as before, but are now considered an "internal API".\
The new `$urlService` is a facade which delegates to the appropriate internal APIs.

feat(UrlService): Create UrlService API (facade) for easier access to URL based APIs

Author: christopherthielen

src/services.ts

@@ -15,7 +15,7 @@ import {
   IRootScopeService, IQService, ILocationService, ILocationProvider, IHttpService, ITemplateCacheService
 } from "angular";
 import {
-  services, applyPairs, isString, trace, extend, UIRouter, StateService, UrlRouter, UrlMatcherFactory, ResolveContext
+  services, applyPairs, isString, trace, extend, UIRouter, StateService, UrlRouter, UrlMatcherFactory, ResolveContext, unnestR
 } from "ui-router-core";
 import { ng1ViewsBuilder, getNg1ViewConfigFactory } from "./statebuilders/views";
 import { TemplateFactory } from "./templateFactory";
@@ -88,6 +88,14 @@ runBlock.$inject = ['$injector', '$q', '$uiRouter'];
 function runBlock($injector: IInjectorService, $q: IQService, $uiRouter: UIRouter) {
   services.$injector = $injector;
   services.$q = <any> $q;
+
+  // The $injector is now available.
+  // Find any resolvables that had dependency annotation deferred
+  $uiRouter.stateRegistry.get()
+      .map(x => x.$$state().resolvables)
+      .reduce(unnestR, [])
+      .filter(x => x.deps === "deferred")
+      .forEach(resolvable => resolvable.deps = $injector.annotate(resolvable.resolveFn));
 }
 
 // $urlRouter service and $urlRouterProvider
@@ -106,6 +114,7 @@ export function watchDigests($rootScope: IRootScopeService) {
 
 mod_init .provider("$uiRouter",          <any> $uiRouter);
 mod_rtr  .provider('$urlRouter',         ['$uiRouterProvider', getUrlRouterProvider]);
+mod_util .provider('$urlService',        getProviderFor('urlService'));
 mod_util .provider('$urlMatcherFactory', ['$uiRouterProvider', () => router.urlMatcherFactory]);
 mod_util .provider('$templateFactory',   () => new TemplateFactory());
 mod_state.provider('$stateRegistry',     getProviderFor('stateRegistry'));