@oicl/openbridge-webcomponents-svelte 2.0.0-next.15 → 2.0.0-next.151

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

@@ -2,12 +2,16 @@
   <script lang="ts">
     export type {AngleAdvice} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/advice.js';
 export type {VesselImage, RotType, RotPosition} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/watch.js';
+export type {CompassCenterReadout} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/center-readout.js';
+export type {HdgArrowStyle, CogArrowStyle} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/course-arrows/course-arrows.js';
 export type {CompassDirection, CompassPriorityElement} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass/compass.js';
 export type {InstrumentState, Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
       import '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass/compass.js';
       import { setProperties } from "../../util.js";
       import type {AngleAdvice} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/advice.js';
 import type {VesselImage, RotType, RotPosition} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/watch.js';
+import type {CompassCenterReadout} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/center-readout.js';
+import type {HdgArrowStyle, CogArrowStyle} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/course-arrows/course-arrows.js';
 import type {CompassDirection, CompassPriorityElement} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass/compass.js';
 import type {InstrumentState, Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
       import type { Snippet } from 'svelte';
@@ -15,38 +19,124 @@ import type {InstrumentState, Priority} from '@oicl/openbridge-webcomponents/dis
       export interface Props {
      class?: string;
      style?: string;
+     /** The current heading of the vessel in degrees. */
      heading?: number;
+     /** The current course over ground in degrees. */
      courseOverGround?: number;
+     /** The set point for the heading in degrees. */
      headingSetpoint?: number | null;
+     /** Available when `headingSetpoint!=null`. */
      newHeadingSetpoint?: number | undefined;
+     /**
+      * Indicates if the vessel is at the heading set point.
+      *
+      * Available when `headingSetpoint!=null && autoAtHeadingSetpoint==false`.
+      */
      atHeadingSetpoint?: boolean;
+     /** Available when `headingSetpoint!=null`. */
      headingSetpointAtZeroDeadband?: number;
+     /** Available when `headingSetpoint!=null`. */
      headingSetpointOverride?: boolean;
+     /**
+      * Enables automatic at heading set point calculation.
+      *
+      * Available when `headingSetpoint!=null`.
+      */
      autoAtHeadingSetpoint?: boolean;
+     /**
+      * The deadband for the heading set point in degrees.
+      *
+      * Available when `headingSetpoint!=null && autoAtHeadingSetpoint==true`.
+      */
      autoAtHeadingSetpointDeadband?: number;
+     /** Available when `headingSetpoint!=null`. */
      animateSetpoint?: boolean;
+     /**
+      * Indicates if the compass is being touched.
+      *
+      * Available when `headingSetpoint!=null`.
+      */
      touching?: boolean;
+     /** An array of angle advices for the compass. */
      headingAdvices?: AngleAdvice[];
-     windSpeed?: number | null;
+     /**
+      * The wind speed in knots.
+      *
+      * Available when `windFromDirection!=null`.
+      */
+     currentWindSpeedKnots?: number | null;
+     /**
+      * The direction the wind is coming from in degrees.
+      *
+      * Available when `currentWindSpeedKnots!=null`.
+      */
      windFromDirection?: number | null;
+     /**
+      * The current speed, number of arrows.
+      *
+      * Available when `currentFromDirection!=null`.
+      */
      currentSpeed?: number | null;
+     /**
+      * The direction the current is coming from in degrees.
+      *
+      * Available when `currentSpeed!=null`.
+      */
      currentFromDirection?: number | null;
+     /**
+      * The image of the vessel. Hidden while `centerReadouts` is non-empty.
+      *
+      * Available when `centerReadouts==[]`.
+      */
      vesselImage?: VesselImage;
-     rotationsPerMinute?: number;
+     /** Center readouts replacing the vessel: the first entry renders on top, the rest side by side below a horizontal divider. Values bind per entry `source` (`hdg` → `heading`, `cog` → `courseOverGround`, `rot` → `rateOfTurnDegreesPerMinute`, a dash when unset) and colors follow `priorityElements`. While non-empty, the crosshair's center is cut out so the readouts sit on a clean face. */
+     centerReadouts?: CompassCenterReadout[];
+     /** HDG arrow style: `arrowHead` (default), `needle`, `vector`, or `beamLine`. */
+     hdgArrowStyle?: HdgArrowStyle;
+     /** COG arrow style: `arrowHead` (default), `needle`, `vector`, or `velocityVector`. */
+     cogArrowStyle?: CogArrowStyle;
+     /** Measured rate of turn in degrees per minute (positive = starboard). Drives both the bar extent and (after multiplication by `rotDotAnimationFactor`) the spinning dot animation. When `undefined`, falls back to the deprecated `rotationsPerMinute`. */
+     rateOfTurnDegreesPerMinute?: number | undefined;
+     /**
+      * Visual amplification applied only to the spinning dot animation (not to the bar extent). Default `18` keeps the legacy visual feel (≈1 rpm at 20°/min).
+      *
+      * Available when `rotType==dots`.
+      */
+     rotDotAnimationFactor?: number;
+      /** Legacy rate-of-turn input, in rotations per minute. When
+`rateOfTurnDegreesPerMinute` is `undefined`, this value is used
+(unconverted) as the fallback ROT, driving both the spinning dot ring
+and the bar extent. */
+rotationsPerMinute?: number;
+     /** ROT display mode: `'dots'` (spinning dots, default) or `'bar'` (a rate-of-turn arc anchored at the current heading, its length proportional to the rate of turn). */
      rotType?: RotType;
+     /** ROT track position: `'innerCircle'` (default) or `'scale'` (on the outer ring). */
      rotPosition?: RotPosition;
-     rotMaxValue?: number;
+      /** 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;
+     /** Available when `rotType==bar`. */
      rotArcExtent?: number;
      rotPortStarboard?: boolean;
+     /** Available when `rotType==bar`. */
      rotAtZeroDeadband?: number;
      direction?: CompassDirection;
      state?: InstrumentState;
+     /** Color priority: `Priority.enhanced` uses the blue/enhanced color palette, `Priority.regular` (default) uses the standard palette. */
      priority?: Priority;
+     /** Available when `priority==enhanced`. */
      priorityElements?: CompassPriorityElement[];
-      /** Show compass NSEW labels and north arrow. */
-showLabels?: boolean;
-      /** When true, labels and north arrow are placed inside the outer ring. */
-tickmarksInside?: boolean
+     /** Show compass NSEW labels. The north arrow is always shown, independent of this flag. */
+     showLabels?: boolean;
+     /** When true, labels and north arrow are placed inside the outer ring. */
+     tickmarksInside?: boolean;
+     /** 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/compass/ObcCompass.svelte.d.ts

@@ -1,44 +1,132 @@
 import '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass/compass.js';
 import type { AngleAdvice } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/advice.js';
 import type { VesselImage, RotType, RotPosition } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/watch.js';
+import type { CompassCenterReadout } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/center-readout.js';
+import type { HdgArrowStyle, CogArrowStyle } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/course-arrows/course-arrows.js';
 import type { CompassDirection, CompassPriorityElement } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass/compass.js';
 import type { InstrumentState, Priority } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
 import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
+    /** The current heading of the vessel in degrees. */
     heading?: number;
+    /** The current course over ground in degrees. */
     courseOverGround?: number;
+    /** The set point for the heading in degrees. */
     headingSetpoint?: number | null;
+    /** Available when `headingSetpoint!=null`. */
     newHeadingSetpoint?: number | undefined;
+    /**
+     * Indicates if the vessel is at the heading set point.
+     *
+     * Available when `headingSetpoint!=null && autoAtHeadingSetpoint==false`.
+     */
     atHeadingSetpoint?: boolean;
+    /** Available when `headingSetpoint!=null`. */
     headingSetpointAtZeroDeadband?: number;
+    /** Available when `headingSetpoint!=null`. */
     headingSetpointOverride?: boolean;
+    /**
+     * Enables automatic at heading set point calculation.
+     *
+     * Available when `headingSetpoint!=null`.
+     */
     autoAtHeadingSetpoint?: boolean;
+    /**
+     * The deadband for the heading set point in degrees.
+     *
+     * Available when `headingSetpoint!=null && autoAtHeadingSetpoint==true`.
+     */
     autoAtHeadingSetpointDeadband?: number;
+    /** Available when `headingSetpoint!=null`. */
     animateSetpoint?: boolean;
+    /**
+     * Indicates if the compass is being touched.
+     *
+     * Available when `headingSetpoint!=null`.
+     */
     touching?: boolean;
+    /** An array of angle advices for the compass. */
     headingAdvices?: AngleAdvice[];
-    windSpeed?: number | null;
+    /**
+     * The wind speed in knots.
+     *
+     * Available when `windFromDirection!=null`.
+     */
+    currentWindSpeedKnots?: number | null;
+    /**
+     * The direction the wind is coming from in degrees.
+     *
+     * Available when `currentWindSpeedKnots!=null`.
+     */
     windFromDirection?: number | null;
+    /**
+     * The current speed, number of arrows.
+     *
+     * Available when `currentFromDirection!=null`.
+     */
     currentSpeed?: number | null;
+    /**
+     * The direction the current is coming from in degrees.
+     *
+     * Available when `currentSpeed!=null`.
+     */
     currentFromDirection?: number | null;
+    /**
+     * The image of the vessel. Hidden while `centerReadouts` is non-empty.
+     *
+     * Available when `centerReadouts==[]`.
+     */
     vesselImage?: VesselImage;
+    /** Center readouts replacing the vessel: the first entry renders on top, the rest side by side below a horizontal divider. Values bind per entry `source` (`hdg` → `heading`, `cog` → `courseOverGround`, `rot` → `rateOfTurnDegreesPerMinute`, a dash when unset) and colors follow `priorityElements`. While non-empty, the crosshair's center is cut out so the readouts sit on a clean face. */
+    centerReadouts?: CompassCenterReadout[];
+    /** HDG arrow style: `arrowHead` (default), `needle`, `vector`, or `beamLine`. */
+    hdgArrowStyle?: HdgArrowStyle;
+    /** COG arrow style: `arrowHead` (default), `needle`, `vector`, or `velocityVector`. */
+    cogArrowStyle?: CogArrowStyle;
+    /** Measured rate of turn in degrees per minute (positive = starboard). Drives both the bar extent and (after multiplication by `rotDotAnimationFactor`) the spinning dot animation. When `undefined`, falls back to the deprecated `rotationsPerMinute`. */
+    rateOfTurnDegreesPerMinute?: number | undefined;
+    /**
+     * Visual amplification applied only to the spinning dot animation (not to the bar extent). Default `18` keeps the legacy visual feel (≈1 rpm at 20°/min).
+     *
+     * Available when `rotType==dots`.
+     */
+    rotDotAnimationFactor?: number;
+    /** Legacy rate-of-turn input, in rotations per minute. When
+`rateOfTurnDegreesPerMinute` is `undefined`, this value is used
+(unconverted) as the fallback ROT, driving both the spinning dot ring
+and the bar extent. */
     rotationsPerMinute?: number;
+    /** ROT display mode: `'dots'` (spinning dots, default) or `'bar'` (a rate-of-turn arc anchored at the current heading, its length proportional to the rate of turn). */
     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;
+    /** Available when `rotType==bar`. */
     rotArcExtent?: number;
     rotPortStarboard?: boolean;
+    /** Available when `rotType==bar`. */
     rotAtZeroDeadband?: number;
     direction?: CompassDirection;
     state?: InstrumentState;
+    /** Color priority: `Priority.enhanced` uses the blue/enhanced color palette, `Priority.regular` (default) uses the standard palette. */
     priority?: Priority;
+    /** Available when `priority==enhanced`. */
     priorityElements?: CompassPriorityElement[];
-    /** Show compass NSEW labels and north arrow. */
+    /** Show compass NSEW labels. The north arrow is always shown, independent of this flag. */
     showLabels?: boolean;
     /** When true, labels and north arrow are placed inside the outer ring. */
     tickmarksInside?: boolean;
+    /** 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 {
 }
@@ -51,6 +139,9 @@ declare const ObcCompass: import("svelte").Component<$$ComponentProps, {
     VesselImage: typeof VesselImage;
     RotType: typeof RotType;
     RotPosition: typeof RotPosition;
+    CompassCenterReadout: typeof CompassCenterReadout;
+    HdgArrowStyle: typeof HdgArrowStyle;
+    CogArrowStyle: typeof CogArrowStyle;
     CompassDirection: typeof CompassDirection;
     CompassPriorityElement: typeof CompassPriorityElement;
     InstrumentState: typeof InstrumentState;

package/dist/navigation-instruments/compass-flat/ObcCompassFlat.svelte

@@ -14,7 +14,9 @@ import type {RotType} from '@oicl/openbridge-webcomponents/dist/navigation-instr
      class?: string;
      style?: string;
      FOVIndicator?: boolean;
+     /** Current heading in degrees. */
      heading?: number;
+     /** Current COG in degrees. */
      courseOverGround?: number;
      tickInterval?: number;
      FOV?: number;
@@ -22,12 +24,58 @@ import type {RotType} from '@oicl/openbridge-webcomponents/dist/navigation-instr
      maxFOV?: number;
      priority?: Priority;
      priorityElements?: CompassFlatPriorityElement[];
+     /** ROT display mode: `'dots'`, `'bar'`, or `undefined` (hidden). */
      rotType?: RotType | undefined;
-     rotationsPerMinute?: number;
+     /**
+      * Measured rate of turn in degrees per minute (positive = starboard). When `undefined`, falls back to the deprecated `rotationsPerMinute`.
+      *
+      * Available when `rotType!=undefined`.
+      */
+     rateOfTurnDegreesPerMinute?: number | undefined;
+     /**
+      * Visual amplification applied only to the spinning dot animation.
+      *
+      * Available when `rotType!=undefined`.
+      */
+     rotDotAnimationFactor?: number;
+      /** **Deprecated.** Use `rateOfTurnDegreesPerMinute` instead. */
+rotationsPerMinute?: number;
+     /**
+      * Bar-extent reference value in **degrees per minute**. Default `60` per ES-TRIN 2025/1 Art. 3.02.
+      *
+      * Available when `rotType!=undefined`.
+      */
      rotMaxValue?: number;
+     /**
+      * Degrees of bar arc per max-value ROT (default 60).
+      *
+      * Available when `rotType!=undefined`.
+      */
      rotArcExtent?: number;
+     /** Available when `rotType!=undefined`. */
      rotPortStarboard?: boolean;
-     rotAtZeroDeadband?: number
+     /** Available when `rotType!=undefined`. */
+     rotAtZeroDeadband?: number;
+     /** When `true`, shows a centered `<obc-readout>` below the strip displaying the heading (label `HDG`, unit `DEG`). The value color follows the HDG entry in `priorityElements`. */
+     hasReadout?: boolean;
+     /**
+      * Readout label. Default `HDG`.
+      *
+      * Available when `hasReadout==true`.
+      */
+     label?: string;
+     /**
+      * Readout unit. Default `DEG`.
+      *
+      * Available when `hasReadout==true`.
+      */
+     unit?: string;
+     /**
+      * Number of fraction digits shown in the readout. Default `0`.
+      *
+      * Available when `hasReadout==true`.
+      */
+     fractionDigits?: number
    }
       export interface Events {
     

package/dist/navigation-instruments/compass-flat/ObcCompassFlat.svelte.d.ts

@@ -7,7 +7,9 @@ export interface Props {
     class?: string;
     style?: string;
     FOVIndicator?: boolean;
+    /** Current heading in degrees. */
     heading?: number;
+    /** Current COG in degrees. */
     courseOverGround?: number;
     tickInterval?: number;
     FOV?: number;
@@ -15,12 +17,58 @@ export interface Props {
     maxFOV?: number;
     priority?: Priority;
     priorityElements?: CompassFlatPriorityElement[];
+    /** ROT display mode: `'dots'`, `'bar'`, or `undefined` (hidden). */
     rotType?: RotType | undefined;
+    /**
+     * Measured rate of turn in degrees per minute (positive = starboard). When `undefined`, falls back to the deprecated `rotationsPerMinute`.
+     *
+     * Available when `rotType!=undefined`.
+     */
+    rateOfTurnDegreesPerMinute?: number | undefined;
+    /**
+     * Visual amplification applied only to the spinning dot animation.
+     *
+     * Available when `rotType!=undefined`.
+     */
+    rotDotAnimationFactor?: number;
+    /** **Deprecated.** Use `rateOfTurnDegreesPerMinute` instead. */
     rotationsPerMinute?: number;
+    /**
+     * Bar-extent reference value in **degrees per minute**. Default `60` per ES-TRIN 2025/1 Art. 3.02.
+     *
+     * Available when `rotType!=undefined`.
+     */
     rotMaxValue?: number;
+    /**
+     * Degrees of bar arc per max-value ROT (default 60).
+     *
+     * Available when `rotType!=undefined`.
+     */
     rotArcExtent?: number;
+    /** Available when `rotType!=undefined`. */
     rotPortStarboard?: boolean;
+    /** Available when `rotType!=undefined`. */
     rotAtZeroDeadband?: number;
+    /** When `true`, shows a centered `<obc-readout>` below the strip displaying the heading (label `HDG`, unit `DEG`). The value color follows the HDG entry in `priorityElements`. */
+    hasReadout?: boolean;
+    /**
+     * Readout label. Default `HDG`.
+     *
+     * Available when `hasReadout==true`.
+     */
+    label?: string;
+    /**
+     * Readout unit. Default `DEG`.
+     *
+     * Available when `hasReadout==true`.
+     */
+    unit?: string;
+    /**
+     * Number of fraction digits shown in the readout. Default `0`.
+     *
+     * Available when `hasReadout==true`.
+     */
+    fractionDigits?: number;
 }
 export interface Events {
 }

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

@@ -1,17 +1,24 @@
 
   <script lang="ts">
-    export type {CompassIndicatorArrow} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
+    export type {CompassIndicatorType, CompassIndicatorDirection} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
       import '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
       import { setProperties } from "../../util.js";
-      import type {CompassIndicatorArrow} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
+      import type {CompassIndicatorType, CompassIndicatorDirection} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
       import type { Snippet } from 'svelte';
 
       export interface Props {
      class?: string;
      style?: string;
      angle?: number;
-     arrow?: CompassIndicatorArrow;
-     northUp?: boolean
+     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
    }
       export interface Events {
     

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

@@ -1,11 +1,18 @@
 import '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
-import type { CompassIndicatorArrow } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
+import type { CompassIndicatorType, CompassIndicatorDirection } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/compass-indicator/compass-indicator.js';
 import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
     angle?: number;
-    arrow?: CompassIndicatorArrow;
+    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;
 }
 export interface Events {
@@ -15,7 +22,8 @@ export interface Slots {
 }
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcCompassIndicator: import("svelte").Component<$$ComponentProps, {
-    CompassIndicatorArrow: typeof CompassIndicatorArrow;
+    CompassIndicatorType: typeof CompassIndicatorType;
+    CompassIndicatorDirection: typeof CompassIndicatorDirection;
 }, "">;
 type ObcCompassIndicator = ReturnType<typeof ObcCompassIndicator>;
 export default ObcCompassIndicator;

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

@@ -18,42 +18,93 @@ import type {CompassSectorPriorityElement} from '@oicl/openbridge-webcomponents/
      heading?: number;
      courseOverGround?: number;
      headingSetpoint?: number | null;
+     /** Available when `headingSetpoint!=null`. */
      newHeadingSetpoint?: number | undefined;
+     /** Available when `headingSetpoint!=null && autoAtHeadingSetpoint==false`. */
      atHeadingSetpoint?: boolean;
+     /** Available when `headingSetpoint!=null`. */
      headingSetpointAtZeroDeadband?: number;
+     /** Available when `headingSetpoint!=null`. */
      headingSetpointOverride?: boolean;
+     /** Available when `headingSetpoint!=null`. */
      autoAtHeadingSetpoint?: boolean;
+     /** Available when `headingSetpoint!=null && autoAtHeadingSetpoint==true`. */
      autoAtHeadingSetpointDeadband?: number;
+     /** Available when `headingSetpoint!=null`. */
      animateSetpoint?: boolean;
+     /** Available when `headingSetpoint!=null`. */
      touching?: boolean;
      headingAdvices?: AngleAdvice[];
      minFOV?: number;
      rotType?: RotType | undefined;
+     /** Available when `rotType!=undefined`. */
      rotPosition?: RotPosition;
+     /**
+      * Measured rate of turn in degrees per minute (positive = starboard). Drives both the bar extent and (after multiplication by `rotDotAnimationFactor`) the spinning dot animation. When `undefined`, falls back to the deprecated `rotationsPerMinute`.
+      *
+      * Available when `rotType!=undefined`.
+      */
+     rateOfTurnDegreesPerMinute?: number | undefined;
+     /**
+      * Visual amplification applied only to the spinning dot animation (not to the bar extent). Default `18` keeps the legacy visual feel (≈1 rpm at 20°/min).
+      *
+      * Available when `rotType!=undefined`.
+      */
+     rotDotAnimationFactor?: number;
+     /** Available when `rotType!=undefined && rateOfTurnDegreesPerMinute==undefined`. */
      rotationsPerMinute?: number;
-     rotMaxValue?: 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;
+     /** Available when `rotType!=undefined`. */
      rotPortStarboard?: boolean;
+     /** Available when `rotType==bar`. */
      rotAtZeroDeadband?: number;
      state?: InstrumentState;
      priority?: Priority;
+     /** Available when `priority==enhanced`. */
      priorityElements?: CompassSectorPriorityElement[];
      tickmarksInside?: boolean;
-     zoomToFitArc?: boolean
+     zoomToFitArc?: boolean;
+     /** When `true`, shows a centered `<obc-readout>` under the arc displaying the heading (label `HDG`, unit `DEG`). The value color follows the HDG entry in `priorityElements`, matching the HDG arrow. */
+     hasReadout?: boolean;
+     /**
+      * Readout label. Default `HDG`.
+      *
+      * Available when `hasReadout==true`.
+      */
+     label?: string;
+     /**
+      * Readout unit. Default `DEG`.
+      *
+      * Available when `hasReadout==true`.
+      */
+     unit?: string;
+     /**
+      * Number of fraction digits shown in the readout. Default `0`.
+      *
+      * Available when `hasReadout==true`.
+      */
+     fractionDigits?: number
    }
       export interface Events {
-    onNone?: (event: CustomEvent<unknown>) => void
+    
   }
       export interface Slots {
   children?: Snippet
 }
-      const {onNone, class: className, style, children, ...props} = $props<Props & Events & Slots>();
+      const { class: className, style, children, ...props} = $props<Props & Events & Slots>();
 
     </script>
     <obc-compass-sector
     use:setProperties={props}
     class={className}
     style={style}
-    onNone={onNone} >
+     >
       
     {#if children}
       {@render children()}