refactor: Move dom_adapter.ts to @angular/common (#32154)

This work is needed in preparation for turning tokens into tree-shakable injectables.

PR Close #32154

packages/common/src/common.ts

@@ -11,6 +11,7 @@
  * @description
  * Entry point for all public APIs of the common package.
  */
+export * from './private_export';
 export * from './location/index';
 export {formatDate} from './i18n/format_date';
 export {formatCurrency, formatNumber, formatPercent} from './i18n/format_number';
@@ -26,8 +27,3 @@ export {DeprecatedDatePipe, DeprecatedCurrencyPipe, DeprecatedDecimalPipe, Depre
 export {PLATFORM_BROWSER_ID as ɵPLATFORM_BROWSER_ID, PLATFORM_SERVER_ID as ɵPLATFORM_SERVER_ID, PLATFORM_WORKER_APP_ID as ɵPLATFORM_WORKER_APP_ID, PLATFORM_WORKER_UI_ID as ɵPLATFORM_WORKER_UI_ID, isPlatformBrowser, isPlatformServer, isPlatformWorkerApp, isPlatformWorkerUi} from './platform_id';
 export {VERSION} from './version';
 export {ViewportScroller, NullViewportScroller as ɵNullViewportScroller} from './viewport_scroller';
-
-export {NgClassImplProvider__POST_R3__ as ɵNgClassImplProvider__POST_R3__, NgClassR2Impl as ɵNgClassR2Impl, NgClassImpl as ɵNgClassImpl} from './directives/ng_class_impl';
-export {NgStyleImplProvider__POST_R3__ as ɵNgStyleImplProvider__POST_R3__, NgStyleR2Impl as ɵNgStyleR2Impl, NgStyleImpl as ɵNgStyleImpl} from './directives/ng_style_impl';
-export {ngStyleDirectiveDef__POST_R3__ as ɵngStyleDirectiveDef__POST_R3__, ngStyleFactoryDef__POST_R3__ as ɵngStyleFactoryDef__POST_R3__} from './directives/ng_style';
-export {ngClassDirectiveDef__POST_R3__ as ɵngClassDirectiveDef__POST_R3__, ngClassFactoryDef__POST_R3__ as ɵngClassFactoryDef__POST_R3__} from './directives/ng_class';

packages/common/src/dom_adapter.ts

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+
+let _DOM: DomAdapter = null !;
+
+export function getDOM(): DomAdapter {
+  return _DOM;
+}
+
+export function setDOM(adapter: DomAdapter) {
+  _DOM = adapter;
+}
+
+export function setRootDomAdapter(adapter: DomAdapter) {
+  if (!_DOM) {
+    _DOM = adapter;
+  }
+}
+
+/* tslint:disable:requireParameterType */
+/**
+ * Provides DOM operations in an environment-agnostic way.
+ *
+ * @security Tread carefully! Interacting with the DOM directly is dangerous and
+ * can introduce XSS risks.
+ */
+export abstract class DomAdapter {
+  // Needs Domino-friendly test utility
+  abstract getProperty(el: Element, name: string): any;
+  abstract dispatchEvent(el: any, evt: any): any;
+
+  // Used by router
+  abstract log(error: any): any;
+  abstract logGroup(error: any): any;
+  abstract logGroupEnd(): any;
+
+  // Used by Meta
+  abstract querySelectorAll(el: any, selector: string): any[];
+  abstract remove(el: any): Node;
+  abstract getAttribute(element: any, attribute: string): string|null;
+
+  // Used by platform-server
+  abstract setProperty(el: Element, name: string, value: any): any;
+  abstract querySelector(el: any, selector: string): any;
+  abstract nextSibling(el: any): Node|null;
+  abstract parentElement(el: any): Node|null;
+  abstract clearNodes(el: any): any;
+  abstract appendChild(el: any, node: any): any;
+  abstract removeChild(el: any, node: any): any;
+  abstract insertBefore(parent: any, ref: any, node: any): any;
+  abstract setText(el: any, value: string): any;
+  abstract createComment(text: string): any;
+  abstract createElement(tagName: any, doc?: any): HTMLElement;
+  abstract createElementNS(ns: string, tagName: string, doc?: any): Element;
+  abstract createTextNode(text: string, doc?: any): Text;
+  abstract getElementsByTagName(element: any, name: string): HTMLElement[];
+  abstract addClass(element: any, className: string): any;
+  abstract removeClass(element: any, className: string): any;
+  abstract getStyle(element: any, styleName: string): any;
+  abstract setStyle(element: any, styleName: string, styleValue: string): any;
+  abstract removeStyle(element: any, styleName: string): any;
+  abstract setAttribute(element: any, name: string, value: string): any;
+  abstract setAttributeNS(element: any, ns: string, name: string, value: string): any;
+  abstract removeAttribute(element: any, attribute: string): any;
+  abstract removeAttributeNS(element: any, ns: string, attribute: string): any;
+  abstract createHtmlDocument(): HTMLDocument;
+  abstract getDefaultDocument(): Document;
+
+  // Used by Title
+  abstract getTitle(doc: Document): string;
+  abstract setTitle(doc: Document, newTitle: string): any;
+
+  // Used by By.css
+  abstract elementMatches(n: any, selector: string): boolean;
+  abstract isElementNode(node: any): boolean;
+
+  // Used by Testability
+  abstract isShadowRoot(node: any): boolean;
+  abstract getHost(el: any): any;
+
+  // Used by KeyEventsPlugin
+  abstract onAndCancel(el: any, evt: any, listener: any): Function;
+  abstract getEventKey(event: any): string;
+  abstract supportsDOMEvents(): boolean;
+
+  // Used by PlatformLocation and ServerEventManagerPlugin
+  abstract getGlobalEventTarget(doc: Document, target: string): any;
+
+  // Used by PlatformLocation
+  abstract getHistory(): History;
+  abstract getLocation():
+      any; /** This is the ambient Location definition, NOT Location from @angular/common.  */
+  abstract getBaseHref(doc: Document): string|null;
+  abstract resetBaseElement(): void;
+
+  // TODO: remove dependency in DefaultValueAccessor
+  abstract getUserAgent(): string;
+
+  // Used by AngularProfiler
+  abstract performanceNow(): number;
+
+  // Used by CookieXSRFStrategy
+  abstract supportsCookies(): boolean;
+  abstract getCookie(name: string): string|null;
+}

packages/common/src/private_export.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ */
+
+export {ngClassDirectiveDef__POST_R3__ as ɵngClassDirectiveDef__POST_R3__, ngClassFactoryDef__POST_R3__ as ɵngClassFactoryDef__POST_R3__} from './directives/ng_class';
+export {NgClassImpl as ɵNgClassImpl, NgClassImplProvider__POST_R3__ as ɵNgClassImplProvider__POST_R3__, NgClassR2Impl as ɵNgClassR2Impl} from './directives/ng_class_impl';
+export {ngStyleDirectiveDef__POST_R3__ as ɵngStyleDirectiveDef__POST_R3__, ngStyleFactoryDef__POST_R3__ as ɵngStyleFactoryDef__POST_R3__} from './directives/ng_style';
+export {NgStyleImpl as ɵNgStyleImpl, NgStyleImplProvider__POST_R3__ as ɵNgStyleImplProvider__POST_R3__, NgStyleR2Impl as ɵNgStyleR2Impl} from './directives/ng_style_impl';
+export {DomAdapter as ɵDomAdapter, getDOM as ɵgetDOM, setRootDomAdapter as ɵsetRootDomAdapter} from './dom_adapter';