@oicl/openbridge-webcomponents-svelte 2.0.0-next.159 → 2.0.0-next.160

package/dist/components/top-bar/ObcTopBar.svelte.d.ts

@@ -7,25 +7,57 @@ export interface Props {
     style?: string;
     /** Sets the main application title displayed in the top bar. */
     appTitle?: string;
-    /** Sets the current page or section name displayed in the top bar. */
+    /**
+     * Sets the current page or section name displayed in the top bar.
+     *
+     * Available when `settings==false`.
+     */
     pageName?: string;
     /** Available when `settings==false && inactive==false`. */
     menuButtonIcon?: ObcTopBarMenuButtonIcon;
-    /** Highlights the menu button as active. */
+    /**
+     * Highlights the menu button as active.
+     *
+     * Available when `settings==false && inactive==false`.
+     */
     menuButtonActivated?: boolean;
-    /** Highlights the dimming (day/night) button as active. */
+    /**
+     * Highlights the dimming (day/night) button as active.
+     *
+     * Available when `showDimmingButton==true && inactive==false`.
+     */
     dimmingButtonActivated?: boolean;
-    /** Highlights the apps button as active. */
+    /**
+     * Highlights the apps button as active.
+     *
+     * Available when `showAppsButton==true && inactive==false`.
+     */
     appsButtonActivated?: boolean;
-    /** Highlights the left more button as active. */
+    /**
+     * Highlights the left more button as active.
+     *
+     * Available when `inactive==false`.
+     */
     leftMoreButtonActivated?: boolean;
-    /** Highlights the user/profile button as active. */
+    /**
+     * Highlights the user/profile button as active.
+     *
+     * Available when `showUserButton==true && inactive==false`.
+     */
     userButtonActivated?: boolean;
-    /** Disables the user/profile button. */
+    /**
+     * Disables the user/profile button.
+     *
+     * Available when `showUserButton==true && inactive==false`.
+     */
     userButtonDisabled?: boolean;
     /** Increases the height of the top bar for larger touch targets. */
     tall?: boolean;
-    /** Expands the menu button for wide-rail layouts. */
+    /**
+     * Expands the menu button for wide-rail layouts.
+     *
+     * Available when `settings==false && inactive==false`.
+     */
     wideMenuButton?: boolean;
     /** Shows or hides the apps button. */
     showAppsButton?: boolean;
@@ -53,7 +85,11 @@ export interface Props {
     appIconBreakpointPx?: number;
     /** Enables settings mode, displaying close, back buttons, breadcrumbs, and app title. */
     settings?: boolean;
-    /** Array of breadcrumb items for navigation (used in settings mode). */
+    /**
+     * Array of breadcrumb items for navigation (used in settings mode).
+     *
+     * Available when `settings==true`.
+     */
     breadcrumbItems?: BreadcrumbItem[];
 }
 export interface Events {

package/dist/components/topbar-message-item/ObcTopbarMessageItem.svelte

@@ -10,22 +10,10 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** Controls the visual and interactive type of the message item.
-
-- `simple`: No action button, just message content.
-- `with-button`: Shows a text-based action button.
-- `with-icon-button`: Shows an icon-based action button.
-- `inactive`: Shows an empty/inactive state.
-
-Defaults to `with-button`. */
-type?: ObcTopbarMessageItemType;
-      /** Sets the vertical size of the message item.
-
-- `regular`: Standard compact height.
-- `tall`: Expanded height for more content.
-
-Defaults to `regular`. */
-size?: ObcTopbarMessageItemSize;
+     /** Visual and interactive type: `simple` is message content alone, `with-button` (default) adds a text action button, `with-icon-button` an icon action button, and `inactive` shows the empty state. */
+     type?: ObcTopbarMessageItemType;
+     /** Vertical size: `regular` (default) is the compact height, `tall` the expanded one. */
+     size?: ObcTopbarMessageItemSize;
      /**
       * Whether to show the title slot.
       *

package/dist/components/topbar-message-item/ObcTopbarMessageItem.svelte.d.ts

@@ -4,21 +4,9 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Controls the visual and interactive type of the message item.
-
-- `simple`: No action button, just message content.
-- `with-button`: Shows a text-based action button.
-- `with-icon-button`: Shows an icon-based action button.
-- `inactive`: Shows an empty/inactive state.
-
-Defaults to `with-button`. */
+    /** Visual and interactive type: `simple` is message content alone, `with-button` (default) adds a text action button, `with-icon-button` an icon action button, and `inactive` shows the empty state. */
     type?: ObcTopbarMessageItemType;
-    /** Sets the vertical size of the message item.
-
-- `regular`: Standard compact height.
-- `tall`: Expanded height for more content.
-
-Defaults to `regular`. */
+    /** Vertical size: `regular` (default) is the compact height, `tall` the expanded one. */
     size?: ObcTopbarMessageItemSize;
     /**
      * Whether to show the title slot.

package/dist/components/tree-navigation-group/ObcTreeNavigationGroup.svelte

@@ -24,8 +24,8 @@
      hasIcon?: boolean;
      /** Terminal type for the header row, controlling the alert-header marker shown in the terminal. One of `regular` (default), `aggregated-header`, or `group-header`. */
      terminalType?: string;
-      /** [object Object],[object Object],[object Object] */
-alerts?: TreeNavigationItemAlerts | undefined;
+     /** Per-severity alert counts shown as trailing badges on the header row while the group is collapsed; expanding it hides them, since the rows then carry their own. A group usually sets `combine` so its header shows one badge totalling the alerts of the rows beneath it. */
+     alerts?: TreeNavigationItemAlerts | undefined;
      /** The URL to navigate to when the header is activated. If set, the header row renders as a link; otherwise it acts as a button. */
      href?: string | undefined
    }

package/dist/components/tree-navigation-group/ObcTreeNavigationGroup.svelte.d.ts

@@ -18,7 +18,7 @@ export interface Props {
     hasIcon?: boolean;
     /** Terminal type for the header row, controlling the alert-header marker shown in the terminal. One of `regular` (default), `aggregated-header`, or `group-header`. */
     terminalType?: string;
-    /** [object Object],[object Object],[object Object] */
+    /** Per-severity alert counts shown as trailing badges on the header row while the group is collapsed; expanding it hides them, since the rows then carry their own. A group usually sets `combine` so its header shows one badge totalling the alerts of the rows beneath it. */
     alerts?: TreeNavigationItemAlerts | undefined;
     /** The URL to navigate to when the header is activated. If set, the header row renders as a link; otherwise it acts as a button. */
     href?: string | undefined;

package/dist/components/tree-navigation-item/ObcTreeNavigationItem.svelte

@@ -28,8 +28,8 @@
      hasLeadingIcon?: boolean;
      /** Terminal type, controlling the alert-header marker shown in the terminal. One of `regular` (default), `aggregated-header`, or `group-header`. */
      terminalType?: string;
-      /** [object Object],[object Object],[object Object] */
-alerts?: TreeNavigationItemAlerts | undefined;
+     /** Per-severity alert counts for the row's trailing badges; omit it, or leave every count at 0, for a row with no alerts. Its `combine` flag collapses them into one badge carrying the total and the highest severity present; otherwise each non-zero count gets its own badge, ordered most to least severe. */
+     alerts?: TreeNavigationItemAlerts | undefined;
      /** The URL to navigate to when the row is activated. If set, the row renders as a link; otherwise it acts as a button. */
      href?: string | undefined
    }

package/dist/components/tree-navigation-item/ObcTreeNavigationItem.svelte.d.ts

@@ -22,7 +22,7 @@ export interface Props {
     hasLeadingIcon?: boolean;
     /** Terminal type, controlling the alert-header marker shown in the terminal. One of `regular` (default), `aggregated-header`, or `group-header`. */
     terminalType?: string;
-    /** [object Object],[object Object],[object Object] */
+    /** Per-severity alert counts for the row's trailing badges; omit it, or leave every count at 0, for a row with no alerts. Its `combine` flag collapses them into one badge carrying the total and the highest severity present; otherwise each non-zero count gets its own badge, ordered most to least severe. */
     alerts?: TreeNavigationItemAlerts | undefined;
     /** The URL to navigate to when the row is activated. If set, the row renders as a link; otherwise it acts as a button. */
     href?: string | undefined;

package/dist/components/user-button/ObcUserButton.svelte

@@ -10,16 +10,11 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** Controls whether the button displays a user icon (`icon`) or user initials (`initials`).
-- `icon`: Shows a user icon (default, or if initials are invalid).
-- `initials`: Shows up to two uppercase initials (falls back to icon if empty or longer than two characters). */
-variant?: Variant;
+     /** What the button displays: `icon` (default) a user icon, `initials` up to two uppercase initials — falling back to the icon when `initials` is empty or longer than two characters. */
+     variant?: Variant;
      size?: Size;
-      /** Sets the visual style of the button.
-- `flat`: Minimal, flat appearance (default).
-- `normal`: Outlined with background and border.
-- `selected`: Highlighted to indicate selection or active state. */
-styleType?: StyleType;
+     /** Visual style: `flat` (default) is the minimal appearance, `normal` adds a background and border, `selected` highlights the active state. */
+     styleType?: StyleType;
      /** If true, renders the button as a static (non-interactive) element using a `<div>`. Use for decorative or read-only contexts where user interaction is not required. */
      static?: boolean;
      /**
@@ -28,10 +23,8 @@ styleType?: StyleType;
       * Available when `static==false`.
       */
      disabled?: boolean;
-      /** The initials to display when `variant="initials"`.
-- Only the first two non-whitespace characters are used and converted to uppercase.
-- If empty or longer than two characters, falls back to the user icon. */
-initials?: string;
+     /** Initials shown when `variant` is `initials`. Whitespace is stripped and the rest uppercased, then truncated to two characters — three at the `large` size. An empty value falls back to the user icon. */
+     initials?: string;
      /**
       * Optional label text to display next to the button (not shown in static mode).
       *

package/dist/components/user-button/ObcUserButton.svelte.d.ts

@@ -4,15 +4,10 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Controls whether the button displays a user icon (`icon`) or user initials (`initials`).
-- `icon`: Shows a user icon (default, or if initials are invalid).
-- `initials`: Shows up to two uppercase initials (falls back to icon if empty or longer than two characters). */
+    /** What the button displays: `icon` (default) a user icon, `initials` up to two uppercase initials — falling back to the icon when `initials` is empty or longer than two characters. */
     variant?: Variant;
     size?: Size;
-    /** Sets the visual style of the button.
-- `flat`: Minimal, flat appearance (default).
-- `normal`: Outlined with background and border.
-- `selected`: Highlighted to indicate selection or active state. */
+    /** Visual style: `flat` (default) is the minimal appearance, `normal` adds a background and border, `selected` highlights the active state. */
     styleType?: StyleType;
     /** If true, renders the button as a static (non-interactive) element using a `<div>`. Use for decorative or read-only contexts where user interaction is not required. */
     static?: boolean;
@@ -22,9 +17,7 @@ export interface Props {
      * Available when `static==false`.
      */
     disabled?: boolean;
-    /** The initials to display when `variant="initials"`.
-- Only the first two non-whitespace characters are used and converted to uppercase.
-- If empty or longer than two characters, falls back to the user icon. */
+    /** Initials shown when `variant` is `initials`. Whitespace is stripped and the rest uppercased, then truncated to two characters — three at the `large` size. An empty value falls back to the user icon. */
     initials?: string;
     /**
      * Optional label text to display next to the button (not shown in static mode).

package/dist/components/vendor-button/ObcVendorButton.svelte

@@ -9,14 +9,10 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** The URL of the image to display as the button's content.
-
-Typically this should be a logo or brand image representing a vendor or external service. */
-imageSrc?: string;
-      /** Alternative text for the image, used for accessibility.
-
-This should describe the logo or vendor for screen readers. */
-alt?: string
+     /** The URL of the image to display as the button's content. Typically this should be a logo or brand image representing a vendor or external service. */
+     imageSrc?: string;
+     /** Alternative text for the image, used for accessibility. This should describe the logo or vendor for screen readers. */
+     alt?: string
    }
       export interface Events {
     onClick?: (event: CustomEvent<unknown>) => void

package/dist/components/vendor-button/ObcVendorButton.svelte.d.ts

@@ -3,13 +3,9 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** The URL of the image to display as the button's content.
-
-Typically this should be a logo or brand image representing a vendor or external service. */
+    /** The URL of the image to display as the button's content. Typically this should be a logo or brand image representing a vendor or external service. */
     imageSrc?: string;
-    /** Alternative text for the image, used for accessibility.
-
-This should describe the logo or vendor for screen readers. */
+    /** Alternative text for the image, used for accessibility. This should describe the logo or vendor for screen readers. */
     alt?: string;
 }
 export interface Events {

package/dist/integration-systems/integration-dropdown-button/ObcIntegrationDropdownButton.svelte

@@ -10,14 +10,8 @@
       export interface Props {
      class?: string;
      style?: string;
-      /** List of selectable options. Each option is an object with a `value` (string), `label` (string), `icon` (HTMLTemplateResult), and optional `disabled` (boolean).
-
-Example:
-[
-  { value: 'volvo', label: 'Volvo', icon: html`<obi-ship></obi-ship>` },
-  { value: 'xc90', label: 'XC 90', icon: html`<obi-ship></obi-ship>` }
-] */
-options?: IntegrationDropdownOption[];
+     /** Selectable options, each with a `value`, a `label`, an `icon` template and optional `status` text and `disabled` flag. */
+     options?: IntegrationDropdownOption[];
      hasFleet?: boolean;
      fleetLabel?: string;
      /** The value of the currently selected option. */

package/dist/integration-systems/integration-dropdown-button/ObcIntegrationDropdownButton.svelte.d.ts

@@ -4,13 +4,7 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** List of selectable options. Each option is an object with a `value` (string), `label` (string), `icon` (HTMLTemplateResult), and optional `disabled` (boolean).
-
-Example:
-[
-{ value: 'volvo', label: 'Volvo', icon: html`<obi-ship></obi-ship>` },
-{ value: 'xc90', label: 'XC 90', icon: html`<obi-ship></obi-ship>` }
-] */
+    /** Selectable options, each with a `value`, a `label`, an `icon` template and optional `status` text and `disabled` flag. */
     options?: IntegrationDropdownOption[];
     hasFleet?: boolean;
     fleetLabel?: string;

package/dist/navigation-instruments/compass/ObcCompass.svelte

@@ -112,14 +112,12 @@ rotationsPerMinute?: number;
      rotType?: RotType;
      /** ROT track position: `'innerCircle'` (default) or `'scale'` (on the outer ring). */
      rotPosition?: RotPosition;
-      /** Bar-extent reference value in **degrees per minute**. The bar fills the
-full ±`rotArcExtent` arc when the measured ROT equals ±`rotMaxValue`.
-Default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
-
-Note: prior to the introduction of `rateOfTurnDegreesPerMinute` this
-property was interpreted in rotations per minute. The unit changed when
-the physical ROT API was introduced. */
-rotMaxValue?: number;
+     /**
+      * Bar-extent reference value in degrees per minute: the bar fills the full ±`rotArcExtent` arc when the measured rate of turn reaches ±`rotMaxValue`. The default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
+      *
+      * Available when `rotType==bar`.
+      */
+     rotMaxValue?: number;
      /** Available when `rotType==bar`. */
      rotArcExtent?: number;
      rotPortStarboard?: boolean;

package/dist/navigation-instruments/compass/ObcCompass.svelte.d.ts

@@ -102,13 +102,11 @@ and the bar extent. */
     rotType?: RotType;
     /** ROT track position: `'innerCircle'` (default) or `'scale'` (on the outer ring). */
     rotPosition?: RotPosition;
-    /** Bar-extent reference value in **degrees per minute**. The bar fills the
-full ±`rotArcExtent` arc when the measured ROT equals ±`rotMaxValue`.
-Default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
-
-Note: prior to the introduction of `rateOfTurnDegreesPerMinute` this
-property was interpreted in rotations per minute. The unit changed when
-the physical ROT API was introduced. */
+    /**
+     * Bar-extent reference value in degrees per minute: the bar fills the full ±`rotArcExtent` arc when the measured rate of turn reaches ±`rotMaxValue`. The default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
+     *
+     * Available when `rotType==bar`.
+     */
     rotMaxValue?: number;
     /** Available when `rotType==bar`. */
     rotArcExtent?: number;

package/dist/navigation-instruments/compass-indicator/ObcCompassIndicator.svelte

@@ -12,13 +12,8 @@
      angle?: number;
      type?: CompassIndicatorType;
      direction?: CompassIndicatorDirection;
-      /** When `true` (default) the compass face stays north-up and the arrow
-rotates by `angle`. When `false` the arrow stays pointing up and the
-compass face rotates instead (heading-up / course-up presentation).
-
-Declared with `attribute: false` because the default is `true`; set it
-via the JavaScript property (or framework binding) to opt out. */
-northUp?: boolean
+     /** When `true` (default) the compass face stays north-up and the arrow rotates by `angle`; when `false` the arrow stays pointing up and the face rotates instead, the heading-up presentation. */
+     northUp?: boolean
    }
       export interface Events {
     

package/dist/navigation-instruments/compass-indicator/ObcCompassIndicator.svelte.d.ts

@@ -7,12 +7,7 @@ export interface Props {
     angle?: number;
     type?: CompassIndicatorType;
     direction?: CompassIndicatorDirection;
-    /** When `true` (default) the compass face stays north-up and the arrow
-rotates by `angle`. When `false` the arrow stays pointing up and the
-compass face rotates instead (heading-up / course-up presentation).
-
-Declared with `attribute: false` because the default is `true`; set it
-via the JavaScript property (or framework binding) to opt out. */
+    /** When `true` (default) the compass face stays north-up and the arrow rotates by `angle`; when `false` the arrow stays pointing up and the face rotates instead, the heading-up presentation. */
     northUp?: boolean;
 }
 export interface Events {

package/dist/navigation-instruments/compass-sector/ObcCompassSector.svelte

@@ -53,13 +53,12 @@ import type {CompassSectorPriorityElement} from '@oicl/openbridge-webcomponents/
      rotDotAnimationFactor?: number;
      /** Available when `rotType!=undefined && rateOfTurnDegreesPerMinute==undefined`. */
      rotationsPerMinute?: number;
-      /** Bar-extent reference value in **degrees per minute**. The bar fills the
-full ±`ARC_HALF_EXTENT` arc when the measured ROT equals
-±`rotMaxValue`. Default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
-
-Note: the unit changed from rotations per minute to degrees per minute
-with the introduction of `rateOfTurnDegreesPerMinute`. */
-rotMaxValue?: number;
+     /**
+      * Bar-extent reference value in degrees per minute: the bar fills the full ±`ARC_HALF_EXTENT` arc when the measured rate of turn reaches ±`rotMaxValue`. The default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
+      *
+      * Available when `rotType==bar`.
+      */
+     rotMaxValue?: number;
      /** Available when `rotType!=undefined`. */
      rotPortStarboard?: boolean;
      /** Available when `rotType==bar`. */

package/dist/navigation-instruments/compass-sector/ObcCompassSector.svelte.d.ts

@@ -45,12 +45,11 @@ export interface Props {
     rotDotAnimationFactor?: number;
     /** Available when `rotType!=undefined && rateOfTurnDegreesPerMinute==undefined`. */
     rotationsPerMinute?: number;
-    /** Bar-extent reference value in **degrees per minute**. The bar fills the
-full ±`ARC_HALF_EXTENT` arc when the measured ROT equals
-±`rotMaxValue`. Default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
-
-Note: the unit changed from rotations per minute to degrees per minute
-with the introduction of `rateOfTurnDegreesPerMinute`. */
+    /**
+     * Bar-extent reference value in degrees per minute: the bar fills the full ±`ARC_HALF_EXTENT` arc when the measured rate of turn reaches ±`rotMaxValue`. The default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
+     *
+     * Available when `rotType==bar`.
+     */
     rotMaxValue?: number;
     /** Available when `rotType!=undefined`. */
     rotPortStarboard?: boolean;

package/dist/navigation-instruments/gauge-radial/ObcGaugeRadial.svelte

@@ -40,38 +40,27 @@ animateSetpoint?: boolean;
      showLabels?: boolean;
      primaryTickmarkInterval?: number;
      secondaryTickmarkInterval?: number;
-      /** Interval for tertiary tickmarks in value units.
-When undefined or <= 0, no tertiary tickmarks are shown. */
-tertiaryTickmarkInterval?: number | undefined;
+     /** Interval for tertiary tickmarks in value units. When undefined or <= 0, no tertiary tickmarks are shown. */
+     tertiaryTickmarkInterval?: number | undefined;
      state?: InstrumentState;
      priority?: Priority;
      type?: ObcGaugeRadialType;
      tickmarksInside?: boolean;
      tickmarkStyle?: TickmarkStyle;
-      /** Caution/alert arcs. Ignored on `sector: 90-left` / `90-right`. */
-advices?: GaugeRadialAdvice[];
+     /** Caution/alert arcs. Ignored on `sector: 90-left` / `90-right`. */
+     advices?: GaugeRadialAdvice[];
      sector?: GaugeRadialSector;
-      /** Horizontal placement of the dial when the host is wider than the dial
-(e.g. a short, wide container shrinks the dial to fit the height, leaving
-horizontal slack). Default `center`. */
-horizontalAlignment?: GaugeRadialHorizontalAlignment;
-      /** Vertical placement of the dial when the host is taller than the dial
-(e.g. a tall, narrow container shrinks the dial to fit the width, leaving
-vertical slack). Default `center`. */
-verticalAlignment?: GaugeRadialVerticalAlignment;
-      /** When `true`, shows the centre `<obc-readout>`(s) with the current value
-(and optional `label`/`unit`). Layout depends on `sector` and `type`.
-Default `false`. */
-hasReadout?: boolean;
+     /** Horizontal placement of the dial when the host is wider than the dial (e.g. a short, wide container shrinks the dial to fit the height, leaving horizontal slack). Default `center`. */
+     horizontalAlignment?: GaugeRadialHorizontalAlignment;
+     /** Vertical placement of the dial when the host is taller than the dial (e.g. a tall, narrow container shrinks the dial to fit the width, leaving vertical slack). Default `center`. */
+     verticalAlignment?: GaugeRadialVerticalAlignment;
+     /** When `true`, shows the centre `<obc-readout>`(s) with the current value (and optional `label`/`unit`). Layout depends on `sector` and `type`. Default `false`. */
+     hasReadout?: boolean;
      label?: string;
      unit?: string;
      fractionDigits?: number;
-      /** Outer-ring diameter in CSS pixels. When set, the instrument renders at a
-fixed intrinsic size derived from the ring, arc shape and label reserve —
-so instruments sharing the same value have identical ring circumference
-regardless of label width or arc extent (like obc-donut-chart's
-fixedHeight). When unset (default), the instrument fills its container. */
-faceDiameter?: number | undefined
+     /** Outer-ring diameter in CSS pixels. When set, the instrument renders at a fixed intrinsic size derived from the ring, arc shape and label reserve — so instruments sharing the same value have identical ring circumference regardless of label width or arc extent (like obc-donut-chart's fixedHeight). When unset (default), the instrument fills its container. */
+     faceDiameter?: number | undefined
    }
       export interface Events {
     

package/dist/navigation-instruments/gauge-radial/ObcGaugeRadial.svelte.d.ts

@@ -33,8 +33,7 @@ regardless of instrument state. */
     showLabels?: boolean;
     primaryTickmarkInterval?: number;
     secondaryTickmarkInterval?: number;
-    /** Interval for tertiary tickmarks in value units.
-When undefined or <= 0, no tertiary tickmarks are shown. */
+    /** Interval for tertiary tickmarks in value units. When undefined or <= 0, no tertiary tickmarks are shown. */
     tertiaryTickmarkInterval?: number | undefined;
     state?: InstrumentState;
     priority?: Priority;
@@ -44,26 +43,16 @@ When undefined or <= 0, no tertiary tickmarks are shown. */
     /** Caution/alert arcs. Ignored on `sector: 90-left` / `90-right`. */
     advices?: GaugeRadialAdvice[];
     sector?: GaugeRadialSector;
-    /** Horizontal placement of the dial when the host is wider than the dial
-(e.g. a short, wide container shrinks the dial to fit the height, leaving
-horizontal slack). Default `center`. */
+    /** Horizontal placement of the dial when the host is wider than the dial (e.g. a short, wide container shrinks the dial to fit the height, leaving horizontal slack). Default `center`. */
     horizontalAlignment?: GaugeRadialHorizontalAlignment;
-    /** Vertical placement of the dial when the host is taller than the dial
-(e.g. a tall, narrow container shrinks the dial to fit the width, leaving
-vertical slack). Default `center`. */
+    /** Vertical placement of the dial when the host is taller than the dial (e.g. a tall, narrow container shrinks the dial to fit the width, leaving vertical slack). Default `center`. */
     verticalAlignment?: GaugeRadialVerticalAlignment;
-    /** When `true`, shows the centre `<obc-readout>`(s) with the current value
-(and optional `label`/`unit`). Layout depends on `sector` and `type`.
-Default `false`. */
+    /** When `true`, shows the centre `<obc-readout>`(s) with the current value (and optional `label`/`unit`). Layout depends on `sector` and `type`. Default `false`. */
     hasReadout?: boolean;
     label?: string;
     unit?: string;
     fractionDigits?: number;
-    /** Outer-ring diameter in CSS pixels. When set, the instrument renders at a
-fixed intrinsic size derived from the ring, arc shape and label reserve —
-so instruments sharing the same value have identical ring circumference
-regardless of label width or arc extent (like obc-donut-chart's
-fixedHeight). When unset (default), the instrument fills its container. */
+    /** Outer-ring diameter in CSS pixels. When set, the instrument renders at a fixed intrinsic size derived from the ring, arc shape and label reserve — so instruments sharing the same value have identical ring circumference regardless of label width or arc extent (like obc-donut-chart's fixedHeight). When unset (default), the instrument fills its container. */
     faceDiameter?: number | undefined;
 }
 export interface Events {