fix: cleanup public api of platform-server

BREAKING CHANGE: Parse5Adapter is no longer exported as public API, use serverBootstrap()

Parse5Adapter is an implementation detail not a public API

Closes #9237

Closes #9205

modules/@angular/platform-server/src/server.ts

@@ -0,0 +1,77 @@
+import {PlatformLocation} from '@angular/common';
+import {ComponentRef, OpaqueToken, PLATFORM_COMMON_PROVIDERS, PLATFORM_INITIALIZER, PlatformRef, ReflectiveInjector, Type, assertPlatform, coreLoadAndBootstrap, createPlatform, getPlatform} from '@angular/core';
+
+import {ReflectionCapabilities, reflector, wtfInit} from '../core_private';
+
+import {Parse5DomAdapter} from './parse5_adapter';
+
+const SERVER_PLATFORM_MARKER = new OpaqueToken('ServerPlatformMarker');
+
+function notSupported(feature: string): Error {
+  throw new Error(`platform-server does not support '${feature}'.`);
+}
+
+class ServerPlatformLocation extends PlatformLocation {
+  getBaseHrefFromDOM(): string { throw notSupported('getBaseHrefFromDOM'); };
+  onPopState(fn: any): void { notSupported('onPopState'); };
+  onHashChange(fn: any): void { notSupported('onHashChange'); };
+  get pathname(): string { throw notSupported('pathname'); }
+  get search(): string { throw notSupported('search'); }
+  get hash(): string { throw notSupported('hash'); }
+  replaceState(state: any, title: string, url: string): void { notSupported('replaceState'); };
+  pushState(state: any, title: string, url: string): void { notSupported('pushState'); };
+  forward(): void { notSupported('forward'); };
+  back(): void { notSupported('back'); };
+}
+
+/**
+ * A set of providers to initialize the Angular platform in a server.
+ *
+ * Used automatically by `serverBootstrap`, or can be passed to {@link platform}.
+ * @experimental
+ */
+export const SERVER_PLATFORM_PROVIDERS: Array<any /*Type | Provider | any[]*/> = [
+  {provide: SERVER_PLATFORM_MARKER, useValue: true}, PLATFORM_COMMON_PROVIDERS,
+  {provide: PLATFORM_INITIALIZER, useValue: initParse5Adapter, multi: true},
+  {provide: PlatformLocation, useClass: ServerPlatformLocation}
+];
+
+
+function initParse5Adapter() {
+  Parse5DomAdapter.makeCurrent();
+  wtfInit();
+}
+
+/**
+ * @experimental
+ */
+export function serverPlatform(): PlatformRef {
+  if (!getPlatform()) {
+    createPlatform(ReflectiveInjector.resolveAndCreate(SERVER_PLATFORM_PROVIDERS));
+  }
+  return assertPlatform(SERVER_PLATFORM_MARKER);
+}
+
+/**
+ * Used to bootstrap Angular in server environment (such as node).
+ *
+ * This version of bootstrap only creates platform injector and does not define anything for
+ * application injector. It is expected that application providers are imported from other
+ * packages such as `@angular/platform-browser` or `@angular/platform-browser-dynamic`.
+ *
+ * ```
+ * import {BROWSER_APP_PROVIDERS} from '@angular/platform-browser';
+ * import {BROWSER_APP_COMPILER_PROVIDERS} from '@angular/platform-browser-dynamic';
+ *
+ * serverBootstrap(..., [BROWSER_APP_PROVIDERS, BROWSER_APP_COMPILER_PROVIDERS])
+ * ```
+ *
+ * @experimental
+ */
+export function serverBootstrap(
+    appComponentType: Type,
+    providers: Array<any /*Type | Provider | any[]*/>): Promise<ComponentRef<any>> {
+  reflector.reflectionCapabilities = new ReflectionCapabilities();
+  var appInjector = ReflectiveInjector.resolveAndCreate(providers, serverPlatform().injector);
+  return coreLoadAndBootstrap(appComponentType, appInjector);
+}