chrome-devtools-frontend 1.0.1473514 → 1.0.1506453

package/front_end/panels/security/ipProtectionView.css

@@ -0,0 +1,109 @@
+/*
+ * Copyright 2025 The Chromium Authors. All rights reserved.
+ * Use of this source code is governed by a BSD-style license that can be
+ * found in the LICENSE file.
+ */
+
+@scope to (devtools-widget > *) {
+  :scope {
+    width: 100%;
+    box-shadow: none;
+  }
+
+  .overflow-auto {
+    height: 100%;
+  }
+
+  .ip-protection {
+    display: flex;
+    flex-direction: column;
+    padding: var(--sys-size-5) var(--sys-size-3) var(--sys-size-5) var(--sys-size-5);
+    min-width: fit-content;
+    min-height: fit-content;
+    height: 100%;
+  }
+
+  .header {
+    display: flex;
+    flex-direction: column;
+    gap: var(--sys-size-2);
+    padding-left: var(--sys-size-5);
+  }
+
+  h1 {
+    margin: 0;
+    font: var(--sys-typescale-headline4);
+  }
+
+  .card-container {
+    max-width: 100%;
+  }
+
+  .card {
+    display: flex;
+    flex-direction: column;
+    padding: var(--sys-size-6) var(--sys-size-8);
+    gap: var(--sys-size-6);
+
+    &.enterprise-disabled {
+      color: var(--sys-color-token-subtle);
+    }
+  }
+
+  .card-header {
+    display: flex;
+    align-items: center;
+  }
+
+  .card-header > .lhs {
+    width: 100%;
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding-right: var(--sys-size-9);
+
+    & > devtools-icon {
+      height: var(--sys-size-11);
+      width: var(--sys-size-11);
+    }
+  }
+
+  .text {
+    display: flex;
+    flex-direction: column;
+    gap: var(--sys-size-2);
+  }
+
+  h2 {
+    font: var(--sys-typescale-headline5);
+    margin: 0;
+  }
+
+  .body {
+    font: var(--sys-typescale-body4-regular);
+  }
+
+  .main-text {
+    color: var(--sys-color-on-surface);
+  }
+
+  .body-subtext {
+    color: var(--sys-color-on-surface-subtle);
+  }
+
+  .empty-report {
+    margin: var(--sys-size-5);
+    display: flex;
+    flex-grow: 1;
+    justify-content: center;
+    align-items: center;
+    flex-direction: column;
+    text-align: center;
+    min-height: fit-content;
+    min-width: fit-content;
+  }
+
+  devtools-data-grid {
+  flex: auto;
+  }
+}

package/front_end/panels/security/security-meta.ts

@@ -11,19 +11,19 @@ import * as Security from './security.js';
 
 const UIStrings = {
   /**
-   *@description Default Title of the security panel
+   * @description Default Title of the security panel
    */
   security: 'Security',
   /**
-   *@description Title of privacy and security panel. This is used when the kDevToolsPrivacyUI feature flag is enabled.
+   * @description Title of privacy and security panel. This is used when the kDevToolsPrivacyUI feature flag is enabled.
    */
   PrivacyAndSecurity: 'Privacy and security',
   /**
-   *@description Default command to open the security panel
+   * @description Default command to open the security panel
    */
   showSecurity: 'Show Security',
   /**
-   *@description Command to open the privacy and security panel. This is used when the kDevToolPrivacyUI feature flag is enabled
+   * @description Command to open the privacy and security panel. This is used when the kDevToolPrivacyUI feature flag is enabled
    */
   showPrivacyAndSecurity: 'Show Privacy and security',
 } as const;

package/front_end/panels/security/security.ts

@@ -4,12 +4,14 @@
 
 import * as CookieControlsView from './CookieControlsView.js';
 import * as CookieReportView from './CookieReportView.js';
+import * as IPProtectionView from './IPProtectionView.js';
 import * as SecurityModel from './SecurityModel.js';
 import * as SecurityPanel from './SecurityPanel.js';
 
 export {
   CookieControlsView,
   CookieReportView,
+  IPProtectionView,
   SecurityModel,
   SecurityPanel,
 };

package/front_end/panels/sensors/LocationsSettingsTab.ts

@@ -16,98 +16,98 @@ import locationsSettingsTabStyles from './locationsSettingsTab.css.js';
 
 const UIStrings = {
   /**
-   *@description Title in the Locations Settings Tab, where custom geographic locations that the user
+   * @description Title in the Locations Settings Tab, where custom geographic locations that the user
    *has entered are stored.
    */
   locations: 'Locations',
   /**
-   *@description Label for the name of a geographic location that the user has entered.
+   * @description Label for the name of a geographic location that the user has entered.
    */
   locationName: 'Location name',
   /**
-   *@description Abbreviation of latitude in Locations Settings Tab of the Device Toolbar
+   * @description Abbreviation of latitude in Locations Settings Tab of the Device Toolbar
    */
   lat: 'Lat',
   /**
-   *@description Abbreviation of longitude in Locations Settings Tab of the Device Toolbar
+   * @description Abbreviation of longitude in Locations Settings Tab of the Device Toolbar
    */
   long: 'Long',
   /**
-   *@description Text in Sensors View of the Device Toolbar
+   * @description Text in Sensors View of the Device Toolbar
    */
   timezoneId: 'Timezone ID',
   /**
-   *@description Label for text input for the locale of a particular location.
+   * @description Label for text input for the locale of a particular location.
    */
   locale: 'Locale',
   /**
-   *@description Label for text input for the latitude of a GPS position.
+   * @description Label for text input for the latitude of a GPS position.
    */
   latitude: 'Latitude',
   /**
-   *@description Label for text input for the longitude of a GPS position.
+   * @description Label for text input for the longitude of a GPS position.
    */
   longitude: 'Longitude',
   /**
-   *@description Label for text input for the accuracy of a GPS position.
+   * @description Label for text input for the accuracy of a GPS position.
    */
   accuracy: 'Accuracy',
   /**
-   *@description Error message in the Locations settings pane that declares the location name input must not be empty
+   * @description Error message in the Locations settings pane that declares the location name input must not be empty
    */
   locationNameCannotBeEmpty: 'Location name cannot be empty',
   /**
-   *@description Error message in the Locations settings pane that declares the maximum length of the location name
-   *@example {50} PH1
+   * @description Error message in the Locations settings pane that declares the maximum length of the location name
+   * @example {50} PH1
    */
   locationNameMustBeLessThanS: 'Location name must be less than {PH1} characters',
   /**
-   *@description Error message in the Locations settings pane that declares that the value for the latitude input must be a number
+   * @description Error message in the Locations settings pane that declares that the value for the latitude input must be a number
    */
   latitudeMustBeANumber: 'Latitude must be a number',
   /**
-   *@description Error message in the Locations settings pane that declares the minimum value for the latitude input
-   *@example {-90} PH1
+   * @description Error message in the Locations settings pane that declares the minimum value for the latitude input
+   * @example {-90} PH1
    */
   latitudeMustBeGreaterThanOrEqual: 'Latitude must be greater than or equal to {PH1}',
   /**
-   *@description Error message in the Locations settings pane that declares the maximum value for the latitude input
-   *@example {90} PH1
+   * @description Error message in the Locations settings pane that declares the maximum value for the latitude input
+   * @example {90} PH1
    */
   latitudeMustBeLessThanOrEqualToS: 'Latitude must be less than or equal to {PH1}',
   /**
-   *@description Error message in the Locations settings pane that declares that the value for the longitude input must be a number
+   * @description Error message in the Locations settings pane that declares that the value for the longitude input must be a number
    */
   longitudeMustBeANumber: 'Longitude must be a number',
   /**
-   *@description Error message in the Locations settings pane that declares the minimum value for the longitude input
-   *@example {-180} PH1
+   * @description Error message in the Locations settings pane that declares the minimum value for the longitude input
+   * @example {-180} PH1
    */
   longitudeMustBeGreaterThanOr: 'Longitude must be greater than or equal to {PH1}',
   /**
-   *@description Error message in the Locations settings pane that declares the maximum value for the longitude input
-   *@example {180} PH1
+   * @description Error message in the Locations settings pane that declares the maximum value for the longitude input
+   * @example {180} PH1
    */
   longitudeMustBeLessThanOrEqualTo: 'Longitude must be less than or equal to {PH1}',
   /**
-   *@description Error message in the Locations settings pane that declares timezone ID input invalid
+   * @description Error message in the Locations settings pane that declares timezone ID input invalid
    */
   timezoneIdMustContainAlphabetic: 'Timezone ID must contain alphabetic characters',
   /**
-   *@description Error message in the Locations settings pane that declares locale input invalid
+   * @description Error message in the Locations settings pane that declares locale input invalid
    */
   localeMustContainAlphabetic: 'Locale must contain alphabetic characters',
   /**
-   *@description Error message in the Locations settings pane that declares that the value for the accuracy input must be a number
+   * @description Error message in the Locations settings pane that declares that the value for the accuracy input must be a number
    */
   accuracyMustBeANumber: 'Accuracy must be a number',
   /**
-   *@description Error message in the Locations settings pane that declares the minimum value for the accuracy input
-   *@example {0} PH1
+   * @description Error message in the Locations settings pane that declares the minimum value for the accuracy input
+   * @example {0} PH1
    */
   accuracyMustBeGreaterThanOrEqual: 'Accuracy must be greater than or equal to {PH1}',
   /**
-   *@description Text of add locations button in Locations Settings Tab of the Device Toolbar
+   * @description Text of add locations button in Locations Settings Tab of the Device Toolbar
    */
   addLocation: 'Add location',
 } as const;
@@ -120,11 +120,12 @@ export class LocationsSettingsTab extends UI.Widget.VBox implements UI.ListWidge
   private editor?: UI.ListWidget.Editor<LocationDescription>;
 
   constructor() {
-    super(true);
+    super({
+      jslog: `${VisualLogging.pane('emulation-locations')}`,
+      useShadowDom: true,
+    });
     this.registerRequiredCSS(locationsSettingsTabStyles);
 
-    this.element.setAttribute('jslog', `${VisualLogging.pane('emulation-locations')}`);
-
     const settingsContent =
         this.contentElement.createChild('div', 'settings-card-container-wrapper').createChild('div');
     settingsContent.classList.add('settings-card-container');

package/front_end/panels/sensors/SensorsView.ts

@@ -15,158 +15,158 @@ import sensorsStyles from './sensors.css.js';
 
 const UIStrings = {
   /**
-   *@description Title for a group of cities
+   * @description Title for a group of cities
    */
   location: 'Location',
   /**
-   *@description An option that appears in a drop-down to prevent the GPS location of the user from being overridden.
+   * @description An option that appears in a drop-down to prevent the GPS location of the user from being overridden.
    */
   noOverride: 'No override',
   /**
-   *@description Title of a section that contains overrides for the user's GPS location.
+   * @description Title of a section that contains overrides for the user's GPS location.
    */
   overrides: 'Overrides',
   /**
-   *@description Text of button in Sensors View, takes the user to the custom location setting screen
+   * @description Text of button in Sensors View, takes the user to the custom location setting screen
    *where they can enter/edit custom locations.
    */
   manage: 'Manage',
   /**
-   *@description Aria-label for location manage button in Sensors View
+   * @description Aria-label for location manage button in Sensors View
    */
   manageTheListOfLocations: 'Manage the list of locations',
   /**
-   *@description Option in a drop-down input for selecting the GPS location of the user. As an
+   * @description Option in a drop-down input for selecting the GPS location of the user. As an
    *alternative to selecting a location from the list, the user can select this option and they are
    *prompted to enter the details for a new custom location.
    */
   other: 'Other…',
   /**
-   *@description Title of a section in a drop-down input that contains error locations, e.g. to select
+   * @description Title of a section in a drop-down input that contains error locations, e.g. to select
    *a location override that says 'the location is not available'. A noun.
    */
   error: 'Error',
   /**
-   *@description A type of override where the geographic location of the user is not available.
+   * @description A type of override where the geographic location of the user is not available.
    */
   locationUnavailable: 'Location unavailable',
   /**
-   *@description Tooltip text telling the user how to change the value of a latitude/longitude input
+   * @description Tooltip text telling the user how to change the value of a latitude/longitude input
    *text box. several shortcuts are provided for convenience. The placeholder can be different
    *keyboard keys, depending on the user's settings.
-   *@example {Ctrl} PH1
+   * @example {Ctrl} PH1
    */
   adjustWithMousewheelOrUpdownKeys: 'Adjust with mousewheel or up/down keys. {PH1}: ±10, Shift: ±1, Alt: ±0.01',
   /**
-   *@description Label for latitude of a GPS location.
+   * @description Label for latitude of a GPS location.
    */
   latitude: 'Latitude',
   /**
-   *@description Label for Longitude of a GPS location.
+   * @description Label for Longitude of a GPS location.
    */
   longitude: 'Longitude',
   /**
-   *@description Label for the ID of a timezone for a particular location.
+   * @description Label for the ID of a timezone for a particular location.
    */
   timezoneId: 'Timezone ID',
   /**
-   *@description Label for the locale relevant to a custom location.
+   * @description Label for the locale relevant to a custom location.
    */
   locale: 'Locale',
   /**
-   *@description Label for Accuracy of a GPS location.
+   * @description Label for Accuracy of a GPS location.
    */
   accuracy: 'Accuracy',
   /**
-   *@description Label the orientation of a user's device e.g. tilt in 3D-space.
+   * @description Label the orientation of a user's device e.g. tilt in 3D-space.
    */
   orientation: 'Orientation',
   /**
-   *@description Option that when chosen, turns off device orientation override.
+   * @description Option that when chosen, turns off device orientation override.
    */
   off: 'Off',
   /**
-   *@description Option that when chosen, allows the user to enter a custom orientation for the device e.g. tilt in 3D-space.
+   * @description Option that when chosen, allows the user to enter a custom orientation for the device e.g. tilt in 3D-space.
    */
   customOrientation: 'Custom orientation',
   /**
-   *@description Warning to the user they should enable the device orientation override, in order to
+   * @description Warning to the user they should enable the device orientation override, in order to
    *enable this input which allows them to interactively select orientation by dragging a 3D phone
    *model.
    */
   enableOrientationToRotate: 'Enable orientation to rotate',
   /**
-   *@description Text telling the user how to use an input which allows them to interactively select
+   * @description Text telling the user how to use an input which allows them to interactively select
    *orientation by dragging a 3D phone model.
    */
   shiftdragHorizontallyToRotate: 'Shift+drag horizontally to rotate around the y-axis',
   /**
-   *@description Message in the Sensors tool that is alerted (for screen readers) when the device orientation setting is changed
-   *@example {180} PH1
-   *@example {-90} PH2
-   *@example {0} PH3
+   * @description Message in the Sensors tool that is alerted (for screen readers) when the device orientation setting is changed
+   * @example {180} PH1
+   * @example {-90} PH2
+   * @example {0} PH3
    */
   deviceOrientationSetToAlphaSBeta: 'Device orientation set to alpha: {PH1}, beta: {PH2}, gamma: {PH3}',
   /**
-   *@description Text of orientation reset button in Sensors View of the Device Toolbar
+   * @description Text of orientation reset button in Sensors View of the Device Toolbar
    */
   reset: 'Reset',
   /**
-   *@description Aria-label for orientation reset button in Sensors View. Command.
+   * @description Aria-label for orientation reset button in Sensors View. Command.
    */
   resetDeviceOrientation: 'Reset device orientation',
   /**
-   *@description Description of the Touch select in Sensors tab
+   * @description Description of the Touch select in Sensors tab
    */
   forcesTouchInsteadOfClick: 'Forces touch instead of click',
   /**
-   *@description Description of the Emulate Idle State select in Sensors tab
+   * @description Description of the Emulate Idle State select in Sensors tab
    */
   forcesSelectedIdleStateEmulation: 'Forces selected idle state emulation',
   /**
-   *@description Description of the Emulate CPU Pressure State select in Sensors tab
+   * @description Description of the Emulate CPU Pressure State select in Sensors tab
    */
   forcesSelectedPressureStateEmulation: 'Forces selected pressure state emulation',
   /**
-   *@description Title for a group of configuration options in a drop-down input.
+   * @description Title for a group of configuration options in a drop-down input.
    */
   presets: 'Presets',
   /**
-   *@description Drop-down input option for the orientation of a device in 3D space.
+   * @description Drop-down input option for the orientation of a device in 3D space.
    */
   portrait: 'Portrait',
   /**
-   *@description Drop-down input option for the orientation of a device in 3D space.
+   * @description Drop-down input option for the orientation of a device in 3D space.
    */
   portraitUpsideDown: 'Portrait upside down',
   /**
-   *@description Drop-down input option for the orientation of a device in 3D space.
+   * @description Drop-down input option for the orientation of a device in 3D space.
    */
   landscapeLeft: 'Landscape left',
   /**
-   *@description Drop-down input option for the orientation of a device in 3D space.
+   * @description Drop-down input option for the orientation of a device in 3D space.
    */
   landscapeRight: 'Landscape right',
   /**
-   *@description Drop-down input option for the orientation of a device in 3D space. Noun indicating
+   * @description Drop-down input option for the orientation of a device in 3D space. Noun indicating
    *the display of the device is pointing up.
    */
   displayUp: 'Display up',
   /**
-   *@description Drop-down input option for the orientation of a device in 3D space. Noun indicating
+   * @description Drop-down input option for the orientation of a device in 3D space. Noun indicating
    *the display of the device is pointing down.
    */
   displayDown: 'Display down',
   /**
-   *@description Label for one dimension of device orientation that the user can override.
+   * @description Label for one dimension of device orientation that the user can override.
    */
   alpha: '\u03B1 (alpha)',
   /**
-   *@description Label for one dimension of device orientation that the user can override.
+   * @description Label for one dimension of device orientation that the user can override.
    */
   beta: '\u03B2 (beta)',
   /**
-   *@description Label for one dimension of device orientation that the user can override.
+   * @description Label for one dimension of device orientation that the user can override.
    */
   gamma: '\u03B3 (gamma)',
 } as const;
@@ -212,9 +212,11 @@ export class SensorsView extends UI.Widget.VBox {
   private originalBoxMatrix?: DOMMatrix;
 
   constructor() {
-    super(true);
+    super({
+      jslog: `${VisualLogging.panel('sensors').track({resize: true})}`,
+      useShadowDom: true,
+    });
     this.registerRequiredCSS(sensorsStyles);
-    this.element.setAttribute('jslog', `${VisualLogging.panel('sensors').track({resize: true})}`);
     this.contentElement.classList.add('sensors-view');
 
     this.#locationSetting = Common.Settings.Settings.instance().createSetting('emulation.location-override', '');
@@ -382,6 +384,7 @@ export class SensorsView extends UI.Widget.VBox {
   #locationSelectChanged(): void {
     this.fieldsetElement.disabled = false;
     this.timezoneError.textContent = '';
+    this.accuracyError.textContent = '';
     const value = this.locationSelectElement.options[this.locationSelectElement.selectedIndex].value;
     if (value === NonPresetOptions.NoOverride) {
       this.#locationOverrideEnabled = false;
@@ -428,6 +431,7 @@ export class SensorsView extends UI.Widget.VBox {
     }
 
     this.timezoneError.textContent = '';
+    this.accuracyError.textContent = '';
 
     this.setSelectElementLabel(this.locationSelectElement, NonPresetOptions.Custom);
     this.#location = location;
@@ -451,6 +455,10 @@ export class SensorsView extends UI.Widget.VBox {
             this.localeError.textContent = err.message;
             break;
           }
+          case 'emulation-set-accuracy': {
+            this.accuracyError.textContent = err.message;
+            break;
+          }
         }
       });
     }
@@ -636,7 +644,7 @@ export class SensorsView extends UI.Widget.VBox {
     this.deviceOrientation = deviceOrientation;
     this.applyDeviceOrientation();
 
-    UI.ARIAUtils.alert(i18nString(
+    UI.ARIAUtils.LiveAnnouncer.alert(i18nString(
         UIStrings.deviceOrientationSetToAlphaSBeta,
         {PH1: deviceOrientation.alpha, PH2: deviceOrientation.beta, PH3: deviceOrientation.gamma}));
   }

package/front_end/panels/sensors/sensors-meta.ts

@@ -15,23 +15,23 @@ const UIStrings = {
    */
   sensors: 'Sensors',
   /**
-   *@description A tag of Sensors tool that can be searched in the command menu
+   * @description A tag of Sensors tool that can be searched in the command menu
    */
   geolocation: 'geolocation',
   /**
-   *@description A tag of Sensors tool that can be searched in the command menu
+   * @description A tag of Sensors tool that can be searched in the command menu
    */
   timezones: 'timezones',
   /**
-   *@description Text in Sensors View of the Device Toolbar
+   * @description Text in Sensors View of the Device Toolbar
    */
   locale: 'locale',
   /**
-   *@description A tag of Sensors tool that can be searched in the command menu
+   * @description A tag of Sensors tool that can be searched in the command menu
    */
   locales: 'locales',
   /**
-   *@description A tag of Sensors tool that can be searched in the command menu
+   * @description A tag of Sensors tool that can be searched in the command menu
    */
   accelerometer: 'accelerometer',
   /**
@@ -40,7 +40,7 @@ const UIStrings = {
    */
   deviceOrientation: 'device orientation',
   /**
-   *@description Title of Locations settings. Refers to geographic locations for GPS.
+   * @description Title of Locations settings. Refers to geographic locations for GPS.
    */
   locations: 'Locations',
   /**
@@ -49,39 +49,39 @@ const UIStrings = {
    */
   touch: 'Touch',
   /**
-   *@description Text in Sensors View of the Device Toolbar. Refers to device-based touch input,
+   * @description Text in Sensors View of the Device Toolbar. Refers to device-based touch input,
    *which means the input type will be 'touch' only if the device normally has touch input e.g. a
    *phone or tablet.
    */
   devicebased: 'Device-based',
   /**
-   *@description Text in Sensors View of the Device Toolbar. Means that touch input will be forced
+   * @description Text in Sensors View of the Device Toolbar. Means that touch input will be forced
    *on, even if the device type e.g. desktop computer does not normally have touch input.
    */
   forceEnabled: 'Force enabled',
   /**
-   *@description Title of a section option in Sensors tab for idle emulation. This is a command, to
+   * @description Title of a section option in Sensors tab for idle emulation. This is a command, to
    *emulate the state of the 'Idle Detector'.
    */
   emulateIdleDetectorState: 'Emulate Idle Detector state',
   /**
-   *@description Title of an option in Sensors tab idle emulation drop-down. Turns off emulation of idle state.
+   * @description Title of an option in Sensors tab idle emulation drop-down. Turns off emulation of idle state.
    */
   noIdleEmulation: 'No idle emulation',
   /**
-   *@description Title of an option in Sensors tab idle emulation drop-down.
+   * @description Title of an option in Sensors tab idle emulation drop-down.
    */
   userActiveScreenUnlocked: 'User active, screen unlocked',
   /**
-   *@description Title of an option in Sensors tab idle emulation drop-down.
+   * @description Title of an option in Sensors tab idle emulation drop-down.
    */
   userActiveScreenLocked: 'User active, screen locked',
   /**
-   *@description Title of an option in Sensors tab idle emulation drop-down.
+   * @description Title of an option in Sensors tab idle emulation drop-down.
    */
   userIdleScreenUnlocked: 'User idle, screen unlocked',
   /**
-   *@description Title of an option in Sensors tab idle emulation drop-down.
+   * @description Title of an option in Sensors tab idle emulation drop-down.
    */
   userIdleScreenLocked: 'User idle, screen locked',
   /**
@@ -90,7 +90,7 @@ const UIStrings = {
    */
   showSensors: 'Show Sensors',
   /**
-   *@description Command that shows geographic locations.
+   * @description Command that shows geographic locations.
    */
   showLocations: 'Show Locations',
   /**
@@ -98,23 +98,23 @@ const UIStrings = {
    */
   cpuPressure: 'CPU Pressure',
   /**
-   *@description Title of an option in Sensors tab cpu pressure emulation drop-down. Turns off emulation of cpu pressure state.
+   * @description Title of an option in Sensors tab cpu pressure emulation drop-down. Turns off emulation of cpu pressure state.
    */
   noPressureEmulation: 'No override',
   /**
-   *@description An option that appears in a drop-down that represents the nominal state.
+   * @description An option that appears in a drop-down that represents the nominal state.
    */
   nominal: 'Nominal',
   /**
-   *@description An option that appears in a drop-down that represents the fair state.
+   * @description An option that appears in a drop-down that represents the fair state.
    */
   fair: 'Fair',
   /**
-   *@description An option that appears in a drop-down that represents the serious state.
+   * @description An option that appears in a drop-down that represents the serious state.
    */
   serious: 'Serious',
   /**
-   *@description An option that appears in a drop-down that represents the critical state.
+   * @description An option that appears in a drop-down that represents the critical state.
    */
   critical: 'Critical',
 } as const;