docs: update platform-browser with @publicApi tags (#26595)

PR Close #26595

packages/platform-browser/src/browser.ts

@@ -41,6 +41,9 @@ export const BROWSER_SANITIZATION_PROVIDERS: StaticProvider[] = [
   {provide: DomSanitizer, useClass: DomSanitizerImpl, deps: [DOCUMENT]},
 ];
 
+/**
+ * @publicApi
+ */
 export const platformBrowser: (extraProviders?: StaticProvider[]) => PlatformRef =
     createPlatformFactory(platformCore, 'browser', INTERNAL_BROWSER_PLATFORM_PROVIDERS);
 
@@ -95,7 +98,7 @@ export const BROWSER_MODULE_PROVIDERS: StaticProvider[] = [
  * Re-exports `CommonModule` and `ApplicationModule`, making their
  * exports and providers available to all apps.
  *
- *
+ * @publicApi
  */
 @NgModule({providers: BROWSER_MODULE_PROVIDERS, exports: [CommonModule, ApplicationModule]})
 export class BrowserModule {
@@ -113,8 +116,6 @@ export class BrowserModule {
    * @param params An object containing an identifier for the app to transition.
    * The ID must match between the client and server versions of the app.
    * @returns The reconfigured `BrowserModule` to import into the app's root `AppModule`.
-   *
-   * @publicApi
    */
   static withServerTransition(params: {appId: string}): ModuleWithProviders<BrowserModule> {
     return {

packages/platform-browser/src/dom/dom_tokens.ts

@@ -17,5 +17,6 @@ import {InjectionToken} from '@angular/core';
  * Contexts are not the same (e.g. when running the application into a Web Worker).
  *
  * @deprecated import from `@angular/common` instead.
+ * @publicApi
  */
 export const DOCUMENT = commonDOCUMENT;

packages/platform-browser/src/dom/events/event_manager.ts

@@ -12,6 +12,8 @@ import {getDOM} from '../dom_adapter';
 
 /**
  * The injection token for the event-manager plug-in service.
+ *
+ * @publicApi
  */
 export const EVENT_MANAGER_PLUGINS =
     new InjectionToken<EventManagerPlugin[]>('EventManagerPlugins');
@@ -19,6 +21,8 @@ export const EVENT_MANAGER_PLUGINS =
 /**
  * An injectable service that provides event management for Angular
  * through a browser plug-in.
+ *
+ * @publicApi
  */
 @Injectable()
 export class EventManager {

packages/platform-browser/src/dom/events/hammer_gestures.ts

@@ -62,10 +62,18 @@ const EVENT_NAMES = {
 export const HAMMER_GESTURE_CONFIG = new InjectionToken<HammerGestureConfig>('HammerGestureConfig');
 
 
-/** Function that loads HammerJS, returning a promise that is resolved once HammerJs is loaded. */
+/**
+ * Function that loads HammerJS, returning a promise that is resolved once HammerJs is loaded.
+ *
+ * @publicApi
+ */
 export type HammerLoader = () => Promise<void>;
 
-/** Injection token used to provide a {@link HammerLoader} to Angular. */
+/**
+ * Injection token used to provide a {@link HammerLoader} to Angular.
+ *
+ * @publicApi
+ */
 export const HAMMER_LOADER = new InjectionToken<HammerLoader>('HammerLoader');
 
 export interface HammerInstance {

packages/platform-browser/src/security/dom_sanitization_service.ts

@@ -17,42 +17,42 @@ export {SecurityContext};
 /**
  * Marker interface for a value that's safe to use in a particular context.
  *
- *
+ * @publicApi
  */
 export interface SafeValue {}
 
 /**
  * Marker interface for a value that's safe to use as HTML.
  *
- *
+ * @publicApi
  */
 export interface SafeHtml extends SafeValue {}
 
 /**
  * Marker interface for a value that's safe to use as style (CSS).
  *
- *
+ * @publicApi
  */
 export interface SafeStyle extends SafeValue {}
 
 /**
  * Marker interface for a value that's safe to use as JavaScript.
  *
- *
+ * @publicApi
  */
 export interface SafeScript extends SafeValue {}
 
 /**
  * Marker interface for a value that's safe to use as a URL linking to a document.
  *
- *
+ * @publicApi
  */
 export interface SafeUrl extends SafeValue {}
 
 /**
  * Marker interface for a value that's safe to use as a URL to load executable code from.
  *
- *
+ * @publicApi
  */
 export interface SafeResourceUrl extends SafeValue {}
 
@@ -85,7 +85,7 @@ export interface SafeResourceUrl extends SafeValue {}
  * into this call. Make sure any user data is appropriately escaped for this security context.
  * For more detail, see the [Security Guide](http://g.co/ng/security).
  *
- *
+ * @publicApi
  */
 export abstract class DomSanitizer implements Sanitizer {
   /**

packages/platform-browser/src/version.ts

@@ -14,4 +14,7 @@
 
 import {Version} from '@angular/core';
 
+/**
+ * @publicApi
+ */
 export const VERSION = new Version('0.0.0-PLACEHOLDER');

packages/platform-browser/testing/src/browser.ts

@@ -20,7 +20,7 @@ const _TEST_BROWSER_PLATFORM_PROVIDERS: StaticProvider[] =
 /**
  * Platform for testing
  *
- *
+ * @publicApi
  */
 export const platformBrowserTesting =
     createPlatformFactory(platformCore, 'browserTesting', _TEST_BROWSER_PLATFORM_PROVIDERS);
@@ -28,7 +28,7 @@ export const platformBrowserTesting =
 /**
  * NgModule for testing.
  *
- *
+ * @publicApi
  */
 @NgModule({
   exports: [BrowserModule],