chrome-devtools-frontend 1.0.1473514 → 1.0.1506453

package/front_end/core/host/AidaClient.ts

@@ -6,7 +6,7 @@ import * as Common from '../common/common.js';
 import * as Root from '../root/root.js';
 
 import {InspectorFrontendHostInstance} from './InspectorFrontendHost.js';
-import type {AidaClientResult, SyncInformation} from './InspectorFrontendHostAPI.js';
+import type {AidaClientResult, AidaCodeCompleteResult, SyncInformation} from './InspectorFrontendHostAPI.js';
 import {bindOutputStream} from './ResourceLoader.js';
 
 export enum Role {
@@ -113,6 +113,7 @@ export enum FunctionalityType {
   AGENTIC_CHAT = 5,
 }
 
+// See: cs/aida.proto (google3).
 export enum ClientFeature {
   // Unspecified client feature.
   CLIENT_FEATURE_UNSPECIFIED = 0,
@@ -132,6 +133,8 @@ export enum ClientFeature {
   CHROME_PATCH_AGENT = 12,
   // Chrome AI Assistance Performance Insights Agent.
   CHROME_PERFORMANCE_INSIGHTS_AGENT = 13,
+  // Chrome AI Assistance Performance Agent.
+  CHROME_PERFORMANCE_FULL_AGENT = 24,
 }
 
 export enum UserTier {
@@ -169,41 +172,107 @@ export interface RequestFact {
 export type RpcGlobalId = string|number;
 
 /* eslint-disable @typescript-eslint/naming-convention */
-export interface AidaRequest {
+export interface RequestMetadata {
+  string_session_id?: string;
+  user_tier?: UserTier;
+  disable_user_content_logging: boolean;
+  client_version: string;
+}
+/* eslint-enable @typescript-eslint/naming-convention */
+
+/* eslint-disable @typescript-eslint/naming-convention */
+export interface ConversationOptions {
+  temperature?: number;
+  model_id?: string;
+}
+/* eslint-enable @typescript-eslint/naming-convention */
+
+/* eslint-disable @typescript-eslint/naming-convention */
+export interface DoConversationRequest {
   client: string;
   current_message: Content;
   preamble?: string;
   historical_contexts?: Content[];
   function_declarations?: FunctionDeclaration[];
   facts?: RequestFact[];
-  options?: {
-    temperature?: number,
-    model_id?: string,
-  };
-  metadata: {
-    disable_user_content_logging: boolean,
-    client_version: string,
-    string_session_id?: string,
-    user_tier?: UserTier,
-  };
+  options?: ConversationOptions;
+  metadata: RequestMetadata;
   functionality_type?: FunctionalityType;
   client_feature?: ClientFeature;
 }
 /* eslint-enable @typescript-eslint/naming-convention */
 
+/* eslint-disable @typescript-eslint/naming-convention */
+export interface CompleteCodeOptions {
+  temperature?: number;
+  model_id?: string;
+  inference_language?: AidaInferenceLanguage;
+  stop_sequences?: string[];
+}
+/* eslint-enable @typescript-eslint/naming-convention */
+
+export enum EditType {
+  // Unknown edit type
+  EDIT_TYPE_UNSPECIFIED = 0,
+  // User typed code/text into file
+  ADD = 1,
+  // User deleted code/text from file
+  DELETE = 2,
+  // User pasted into file (this includes smart paste)
+  PASTE = 3,
+  // User performs an undo action
+  UNDO = 4,
+  // User performs a redo action
+  REDO = 5,
+  // User accepted a completion from AIDA
+  ACCEPT_COMPLETION = 6,
+}
+
+/* eslint-disable @typescript-eslint/naming-convention */
+export interface CompletionRequest {
+  client: string;
+  prefix: string;
+  suffix?: string;
+  options?: CompleteCodeOptions;
+  metadata: RequestMetadata;
+  last_user_action?: EditType;
+}
+/* eslint-enable @typescript-eslint/naming-convention */
+
 /* eslint-disable @typescript-eslint/naming-convention  */
-export interface AidaDoConversationClientEvent {
-  corresponding_aida_rpc_global_id: RpcGlobalId;
-  disable_user_content_logging: boolean;
-  do_conversation_client_event: {
-    user_feedback: {
-      sentiment?: Rating,
-      user_input?: {
-        comment?: string,
-      },
+export interface DoConversationClientEvent {
+  user_feedback: {
+    sentiment?: Rating,
+    user_input?: {
+      comment?: string,
+    },
+  };
+}
+
+export interface UserImpression {
+  sample: {
+    sample_id: number,
+  };
+  latency: {
+    duration: {
+      seconds: number,
+      nanos: number,
     },
   };
 }
+
+export interface UserAcceptance {
+  sample: {
+    sample_id: number,
+  };
+}
+
+export interface AidaRegisterClientEvent {
+  corresponding_aida_rpc_global_id: RpcGlobalId;
+  disable_user_content_logging: boolean;
+  do_conversation_client_event?: DoConversationClientEvent;
+  complete_code_client_event?: {user_acceptance: UserAcceptance}|{user_impression: UserImpression};
+}
 /* eslint-enable @typescript-eslint/naming-convention */
 
 export enum RecitationAction {
@@ -248,19 +317,31 @@ export interface FactualityMetadata {
   facts: FactualityFact[];
 }
 
-export interface AidaResponseMetadata {
+export interface ResponseMetadata {
   rpcGlobalId?: RpcGlobalId;
   attributionMetadata?: AttributionMetadata;
   factualityMetadata?: FactualityMetadata;
 }
 
-export interface AidaResponse {
+export interface DoConversationResponse {
   explanation: string;
-  metadata: AidaResponseMetadata;
+  metadata: ResponseMetadata;
   functionCalls?: [AidaFunctionCallResponse, ...AidaFunctionCallResponse[]];
   completed: boolean;
 }
 
+export interface CompletionResponse {
+  generatedSamples: GenerationSample[];
+  metadata: ResponseMetadata;
+}
+
+export interface GenerationSample {
+  generationString: string;
+  score: number;
+  sampleId: number;
+  attributionMetadata?: AttributionMetadata;
+}
+
 export const enum AidaAccessPreconditions {
   AVAILABLE = 'available',
   NO_ACCOUNT_EMAIL = 'no-account-email',
@@ -270,7 +351,7 @@ export const enum AidaAccessPreconditions {
   SYNC_IS_PAUSED = 'sync-is-paused',
 }
 
-const enum AidaInferenceLanguage {
+export const enum AidaInferenceLanguage {
   CPP = 'CPP',
   PYTHON = 'PYTHON',
   KOTLIN = 'KOTLIN',
@@ -314,13 +395,13 @@ export class AidaAbortError extends Error {}
 export class AidaBlockError extends Error {}
 
 export class AidaClient {
-  static buildConsoleInsightsRequest(input: string): AidaRequest {
+  static buildConsoleInsightsRequest(input: string): DoConversationRequest {
     const disallowLogging = Root.Runtime.hostConfig.aidaAvailability?.disallowLogging ?? true;
     const chromeVersion = Root.Runtime.getChromeVersion();
     if (!chromeVersion) {
       throw new Error('Cannot determine Chrome version');
     }
-    const request: AidaRequest = {
+    const request: DoConversationRequest = {
       current_message: {parts: [{text: input}], role: Role.USER},
       client: CLIENT_NAME,
       functionality_type: FunctionalityType.EXPLAIN_ERROR,
@@ -366,7 +447,9 @@ export class AidaClient {
     return AidaAccessPreconditions.AVAILABLE;
   }
 
-  async * fetch(request: AidaRequest, options?: {signal?: AbortSignal}): AsyncGenerator<AidaResponse, void, void> {
+  async *
+      doConversation(request: DoConversationRequest, options?: {signal?: AbortSignal}):
+          AsyncGenerator<DoConversationResponse, void, void> {
     if (!InspectorFrontendHostInstance.doAidaConversation) {
       throw new Error('doAidaConversation is not available');
     }
@@ -407,7 +490,7 @@ export class AidaClient {
     const text = [];
     let inCodeChunk = false;
     const functionCalls: AidaFunctionCallResponse[] = [];
-    let metadata: AidaResponseMetadata = {rpcGlobalId: 0};
+    let metadata: ResponseMetadata = {rpcGlobalId: 0};
     while ((chunk = await stream.read())) {
       let textUpdated = false;
       // The AIDA response is a JSON array of objects, split at the object
@@ -486,7 +569,7 @@ export class AidaClient {
     };
   }
 
-  registerClientEvent(clientEvent: AidaDoConversationClientEvent): Promise<AidaClientResult> {
+  registerClientEvent(clientEvent: AidaRegisterClientEvent): Promise<AidaClientResult> {
     const {promise, resolve} = Promise.withResolvers<AidaClientResult>();
     InspectorFrontendHostInstance.registerAidaClientEvent(
         JSON.stringify({
@@ -499,6 +582,53 @@ export class AidaClient {
 
     return promise;
   }
+
+  async completeCode(request: CompletionRequest): Promise<CompletionResponse|null> {
+    if (!InspectorFrontendHostInstance.aidaCodeComplete) {
+      throw new Error('aidaCodeComplete is not available');
+    }
+    const {promise, resolve} = Promise.withResolvers<AidaCodeCompleteResult>();
+    InspectorFrontendHostInstance.aidaCodeComplete(JSON.stringify(request), resolve);
+    const completeCodeResult = await promise;
+
+    if (completeCodeResult.error) {
+      throw new Error(`Cannot send request: ${completeCodeResult.error} ${completeCodeResult.detail || ''}`);
+    }
+    const response = completeCodeResult.response;
+    if (!response?.length) {
+      throw new Error('Empty response');
+    }
+    let parsedResponse;
+    try {
+      parsedResponse = JSON.parse(response);
+    } catch (error) {
+      throw new Error('Cannot parse response: ' + response, {cause: error});
+    }
+
+    const generatedSamples: GenerationSample[] = [];
+    let metadata: ResponseMetadata = {rpcGlobalId: 0};
+    if ('metadata' in parsedResponse) {
+      metadata = parsedResponse.metadata;
+    }
+
+    if ('generatedSamples' in parsedResponse) {
+      for (const generatedSample of parsedResponse.generatedSamples) {
+        const sample: GenerationSample = {
+          generationString: generatedSample.generationString,
+          score: generatedSample.score,
+          sampleId: generatedSample.sampleId,
+        };
+        if ('metadata' in generatedSample && 'attributionMetadata' in generatedSample.metadata) {
+          sample.attributionMetadata = generatedSample.metadata.attributionMetadata;
+        }
+        generatedSamples.push(sample);
+      }
+    } else {
+      return null;
+    }
+
+    return {generatedSamples, metadata};
+  }
 }
 
 export function convertToUserTierEnum(userTier: string|undefined): UserTier {
@@ -551,7 +681,7 @@ export class HostConfigTracker extends Common.ObjectWrapper.ObjectWrapper<EventT
     }
   }
 
-  private async pollAidaAvailability(): Promise<void> {
+  async pollAidaAvailability(): Promise<void> {
     this.#pollTimer = window.setTimeout(() => this.pollAidaAvailability(), 2000);
     const currentAidaAvailability = await AidaClient.checkAccessPreconditions();
     if (currentAidaAvailability !== this.#aidaAvailability) {

package/front_end/core/host/InspectorFrontendHost.ts

@@ -28,9 +28,6 @@
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-// TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration)
-/* eslint-disable @typescript-eslint/no-unused-vars */
-
 import * as Common from '../common/common.js';
 import * as i18n from '../i18n/i18n.js';
 import * as Platform from '../platform/platform.js';
@@ -38,6 +35,7 @@ import * as Root from '../root/root.js';
 
 import {
   type AidaClientResult,
+  type AidaCodeCompleteResult,
   type CanShowSurveyResult,
   type ChangeEvent,
   type ClickEvent,
@@ -62,18 +60,10 @@ import {
 } from './InspectorFrontendHostAPI.js';
 import {streamWrite as resourceLoaderStreamWrite} from './ResourceLoader.js';
 
-interface DecompressionStream extends GenericTransformStream {
-  readonly format: string;
-}
-declare const DecompressionStream: {
-  prototype: DecompressionStream,
-  new (format: string): DecompressionStream,
-};
-
 const UIStrings = {
   /**
-   *@description Document title in Inspector Frontend Host of the DevTools window
-   *@example {example.com} PH1
+   * @description Document title in Inspector Frontend Host of the DevTools window
+   * @example {example.com} PH1
    */
   devtoolsS: 'DevTools - {PH1}',
 } as const;
@@ -95,9 +85,16 @@ const OVERRIDES_FILE_SYSTEM_PATH = '/overrides' as Platform.DevToolsPath.RawPath
  * The native implementations live in devtools_ui_bindings.cc: https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/devtools/devtools_ui_bindings.cc
  */
 export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
-  readonly #urlsBeingSaved = new Map<Platform.DevToolsPath.RawPathString|Platform.DevToolsPath.UrlString, string[]>();
-  events!: Common.EventTarget.EventTarget<EventTypes>;
+  readonly #urlsBeingSaved = new Map<
+      Platform.DevToolsPath.RawPathString|Platform.DevToolsPath.UrlString, {isBase64: boolean, buffer: string[]}>();
   #fileSystem: FileSystem|null = null;
+  /**
+   * Injected bellow in both stub and normal runs via:
+   * ```ts
+   * InspectorFrontendHostInstance.events = new Common.ObjectWrapper.ObjectWrapper();
+   * ```
+   */
+  declare events: Common.EventTarget.EventTarget<EventTypes>;
 
   recordedCountHistograms:
       Array<{histogramName: string, sample: number, min: number, exclusiveMax: number, bucketSize: number}> = [];
@@ -202,20 +199,22 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
         'Show item in folder is not enabled in hosted mode. Please inspect using chrome://inspect');
   }
 
+  // Reminder: the methods in this class belong to InspectorFrontendHostStub and are typically not executed.
+  // InspectorFrontendHostStub is ONLY used in the uncommon case of devtools not being embedded. For example: trace.cafe or http://localhost:9222/devtools/inspector.html?ws=localhost:9222/devtools/page/xTARGET_IDx
   save(
       url: Platform.DevToolsPath.RawPathString|Platform.DevToolsPath.UrlString, content: string, _forceSaveAs: boolean,
-      _isBase64: boolean): void {
-    let buffer = this.#urlsBeingSaved.get(url);
+      isBase64: boolean): void {
+    let buffer = this.#urlsBeingSaved.get(url)?.buffer;
     if (!buffer) {
       buffer = [];
-      this.#urlsBeingSaved.set(url, buffer);
+      this.#urlsBeingSaved.set(url, {isBase64, buffer});
     }
     buffer.push(content);
     this.events.dispatchEventToListeners(Events.SavedURL, {url, fileSystemPath: url});
   }
 
   append(url: Platform.DevToolsPath.RawPathString|Platform.DevToolsPath.UrlString, content: string): void {
-    const buffer = this.#urlsBeingSaved.get(url);
+    const buffer = this.#urlsBeingSaved.get(url)?.buffer;
     if (buffer) {
       buffer.push(content);
       this.events.dispatchEventToListeners(Events.AppendedToURL, url);
@@ -223,7 +222,7 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
   }
 
   close(url: Platform.DevToolsPath.RawPathString|Platform.DevToolsPath.UrlString): void {
-    const buffer = this.#urlsBeingSaved.get(url) || [];
+    const {isBase64, buffer} = this.#urlsBeingSaved.get(url) || {isBase64: false, buffer: []};
     this.#urlsBeingSaved.delete(url);
     let fileName = '';
 
@@ -231,7 +230,7 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
       try {
         const trimmed = Platform.StringUtilities.trimURL(url);
         fileName = Platform.StringUtilities.removeURLFragment(trimmed);
-      } catch (error) {
+      } catch {
         // If url is not a valid URL, it is probably a filename.
         fileName = url;
       }
@@ -240,7 +239,13 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
     /* eslint-disable-next-line rulesdir/no-imperative-dom-api */
     const link = document.createElement('a');
     link.download = fileName;
-    const blob = new Blob([buffer.join('')], {type: 'text/plain'});
+    let blob;
+    if (isBase64) {
+      const bytes = Common.Base64.decode(buffer.join(''));
+      blob = new Blob([bytes], {type: 'application/gzip'});
+    } else {
+      blob = new Blob(buffer, {type: 'text/plain'});
+    }
     const blobUrl = URL.createObjectURL(blob);
     link.href = blobUrl;
     link.click();
@@ -275,6 +280,9 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
   recordUserMetricsAction(_umaName: string): void {
   }
 
+  recordNewBadgeUsage(_featureName: string): void {
+  }
+
   connectAutomaticFileSystem(
       _fileSystemPath: Platform.DevToolsPath.RawPathString,
       _fileSystemUUID: string,
@@ -330,28 +338,10 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
 
   loadNetworkResource(
       url: string, _headers: string, streamId: number, callback: (arg0: LoadNetworkResourceResult) => void): void {
-    // Read the first 3 bytes looking for the gzip signature in the file header
-    function isGzip(ab: ArrayBuffer): boolean {
-      const buf = new Uint8Array(ab);
-      if (!buf || buf.length < 3) {
-        return false;
-      }
-
-      // https://www.rfc-editor.org/rfc/rfc1952#page-6
-      return buf[0] === 0x1F && buf[1] === 0x8B && buf[2] === 0x08;
-    }
     fetch(url)
         .then(async result => {
-          const resultArrayBuf = await result.arrayBuffer();
-          let decoded: ReadableStream|ArrayBuffer = resultArrayBuf;
-          if (isGzip(resultArrayBuf)) {
-            const ds = new DecompressionStream('gzip');
-            const writer = ds.writable.getWriter();
-            void writer.write(resultArrayBuf);
-            void writer.close();
-            decoded = ds.readable;
-          }
-          const text = await new Response(decoded).text();
+          const respBuffer = await result.arrayBuffer();
+          const text = await Common.Gzip.arrayBufferToString(respBuffer);
           return text;
         })
         .then(function(text) {
@@ -429,6 +419,9 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
         thirdPartyCookieHeuristicsEnabled: true,
         managedBlockThirdPartyCookies: 'Unset',
       },
+      devToolsIpProtectionPanelInDevTools: {
+        enabled: false,
+      }
     };
     if ('hostConfigForTesting' in globalThis) {
       const {hostConfigForTesting} = (globalThis as unknown as {hostConfigForTesting: Root.Runtime.HostConfig});
@@ -511,6 +504,20 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
     throw new Error('Soft context menu should be used');
   }
 
+  /**
+   * **Hosted mode** is when DevTools is loaded over `http(s)://` rather than from `devtools://`.
+   * It does **not** indicate whether the frontend is connected to a valid CDP target.
+   *
+   *  | Example case                                         | Mode           | Example URL                                                                   |
+   *  | :--------------------------------------------------- | :------------- | :---------------------------------------------------------------------------- |
+   *  | typical devtools: (un)docked w/ native CDP bindings  | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html?targetType=tab&...`            |
+   *  | tab href is `devtools://…?ws=…`                      | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html?ws=localhost:9228/...`         |
+   *  | tab href is `devtools://…` but no connection         | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html`                               |
+   *  | tab href is `https://…?ws=` (connected)              | **Hosted**     | `https://chrome-devtools-frontend.appspot.com/serve_rev/@.../worker_app.html` |
+   *  | tab href is `http://…` but no connection             | **Hosted**     | `http://localhost:9222/devtools/inspector.html?ws=localhost:9222/...`         |
+   *
+   * See also `canDock` which has similar semantics.
+   */
   isHostedMode(): boolean {
     return true;
   }
@@ -535,6 +542,12 @@ export class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
     });
   }
 
+  aidaCodeComplete(_request: string, callback: (result: AidaCodeCompleteResult) => void): void {
+    callback({
+      error: 'Not implemented',
+    });
+  }
+
   recordImpression(_event: ImpressionEvent): void {
   }
   recordResize(_event: ResizeEvent): void {
@@ -598,19 +611,15 @@ class InspectorFrontendAPIImpl {
 (function(): void {
 
 function initializeInspectorFrontendHost(): void {
-  let proto;
   if (!InspectorFrontendHostInstance) {
     // Instantiate stub for web-hosted mode if necessary.
     // @ts-expect-error Global injected by devtools_compatibility.js
     globalThis.InspectorFrontendHost = InspectorFrontendHostInstance = new InspectorFrontendHostStub();
   } else {
     // Otherwise add stubs for missing methods that are declared in the interface.
-    proto = InspectorFrontendHostStub.prototype;
-    for (const name of Object.getOwnPropertyNames(proto)) {
-      // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration)
-      // @ts-expect-error
+    const proto = InspectorFrontendHostStub.prototype;
+    for (const name of (Object.getOwnPropertyNames(proto) as Array<keyof InspectorFrontendHostAPI>)) {
       const stub = proto[name];
-      // @ts-expect-error Global injected by devtools_compatibility.js
       if (typeof stub !== 'function' || InspectorFrontendHostInstance[name]) {
         continue;
       }

package/front_end/core/host/InspectorFrontendHostAPI.ts

@@ -151,6 +151,12 @@ export interface AidaClientResult {
   detail?: string;
 }
 
+export interface AidaCodeCompleteResult {
+  response?: string;
+  error?: string;
+  detail?: string;
+}
+
 export interface VisualElementImpression {
   id: number;
   type: number;
@@ -349,6 +355,8 @@ export interface InspectorFrontendHostAPI {
 
   recordUserMetricsAction(umaName: string): void;
 
+  recordNewBadgeUsage(featureName: string): void;
+
   sendMessageToBackend(message: string): void;
 
   setDevicesDiscoveryConfig(config: Adb.Config): void;
@@ -393,6 +401,7 @@ export interface InspectorFrontendHostAPI {
 
   doAidaConversation: (request: string, streamId: number, cb: (result: DoAidaConversationResult) => void) => void;
   registerAidaClientEvent: (request: string, cb: (result: AidaClientResult) => void) => void;
+  aidaCodeComplete: (request: string, cb: (result: AidaCodeCompleteResult) => void) => void;
 
   recordImpression(event: ImpressionEvent): void;
   recordClick(event: ClickEvent): void;
@@ -421,6 +430,8 @@ export interface ContextMenuDescriptor {
   subItems?: ContextMenuDescriptor[];
   shortcut?: string;
   jslogContext?: string;
+  /** Setting the featureName requests showing a new badge tied to that feature . */
+  featureName?: string;
 }
 export interface LoadNetworkResourceResult {
   statusCode: number;

package/front_end/core/host/ResourceLoader.ts

@@ -12,57 +12,57 @@ import type {LoadNetworkResourceResult} from './InspectorFrontendHostAPI.js';
 
 const UIStrings = {
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   systemError: 'System error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   connectionError: 'Connection error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   certificateError: 'Certificate error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   httpError: 'HTTP error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   cacheError: 'Cache error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   signedExchangeError: 'Signed Exchange error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   ftpError: 'FTP error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   certificateManagerError: 'Certificate manager error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   dnsResolverError: 'DNS resolver error',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   unknownError: 'Unknown error',
   /**
-   *@description Phrase used in error messages that carry a network error name
-   *@example {404} PH1
-   *@example {net::ERR_INSUFFICIENT_RESOURCES} PH2
+   * @description Phrase used in error messages that carry a network error name
+   * @example {404} PH1
+   * @example {net::ERR_INSUFFICIENT_RESOURCES} PH2
    */
   httpErrorStatusCodeSS: 'HTTP error: status code {PH1}, {PH2}',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   invalidUrl: 'Invalid URL',
   /**
-   *@description Name of an error category used in error messages
+   * @description Name of an error category used in error messages
    */
   decodingDataUrlFailed: 'Decoding Data URL failed',
 } as const;