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

package/dist/navigation-instruments/pitch-roll-yaw/ObcPitchRollYaw.svelte

@@ -0,0 +1,65 @@
+
+  <script lang="ts">
+    export type {PitchRollYawType, PitchRollSample} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/pitch-roll-yaw/pitch-roll-yaw.js';
+export type {VesselImage} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/watch.js';
+export type {Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+      import '@oicl/openbridge-webcomponents/dist/navigation-instruments/pitch-roll-yaw/pitch-roll-yaw.js';
+      import { setProperties } from "../../util.js";
+      import type {PitchRollYawType, PitchRollSample} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/pitch-roll-yaw/pitch-roll-yaw.js';
+import type {VesselImage} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/watch.js';
+import type {Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+      import type { Snippet } from 'svelte';
+
+      export interface Props {
+     class?: string;
+     style?: string;
+     type?: PitchRollYawType;
+     /** Pitch in degrees; positive moves the attitude dot up. */
+     pitch?: number;
+     /** Roll in degrees; positive moves the attitude dot right. */
+     roll?: number;
+     /** Yaw deviation in degrees on the ±180° scale (0° = top, positive = clockwise). Shown as a dot on the scale in the `level` and `historical-motion` variants and as the end of the live yaw bar in the `actual-motion` variant. */
+     yaw?: number;
+     /** Available when `type!='actual-motion'`. */
+     minAvgYaw?: number;
+     /** Available when `type!='actual-motion'`. */
+     maxAvgYaw?: number;
+     /** Pitch/roll value at the outermost grid circle. Default `20`. */
+     range?: number;
+     /**
+      * Radius of the motion-envelope circle in the same unit as `pitch`/`roll`. Hidden when `0`.
+      *
+      * Available when `type=='actual-motion'`.
+      */
+     motionRadius?: number;
+     /**
+      * Past attitude samples, oldest first; rendered as a fading trail.
+      *
+      * Available when `type=='historical-motion'`.
+      */
+     motionHistory?: PitchRollSample[];
+     /** Available when `type!='level'`. */
+     vesselImage?: VesselImage;
+     priority?: Priority;
+     /** When `true`, shows 0/90/180/-90 labels outside the scale. */
+     showLabels?: boolean
+   }
+      export interface Events {
+    
+  }
+      export interface Slots {
+  children?: Snippet
+}
+      const { class: className, style, children, ...props} = $props<Props & Events & Slots>();
+
+    </script>
+    <obc-pitch-roll-yaw
+    use:setProperties={props}
+    class={className}
+    style={style}
+     >
+      
+    {#if children}
+      {@render children()}
+    {/if}
+    </obc-pitch-roll-yaw>

package/dist/navigation-instruments/pitch-roll-yaw/ObcPitchRollYaw.svelte.d.ts

@@ -0,0 +1,53 @@
+import '@oicl/openbridge-webcomponents/dist/navigation-instruments/pitch-roll-yaw/pitch-roll-yaw.js';
+import type { PitchRollYawType, PitchRollSample } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/pitch-roll-yaw/pitch-roll-yaw.js';
+import type { VesselImage } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/watch.js';
+import type { Priority } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+import type { Snippet } from 'svelte';
+export interface Props {
+    class?: string;
+    style?: string;
+    type?: PitchRollYawType;
+    /** Pitch in degrees; positive moves the attitude dot up. */
+    pitch?: number;
+    /** Roll in degrees; positive moves the attitude dot right. */
+    roll?: number;
+    /** Yaw deviation in degrees on the ±180° scale (0° = top, positive = clockwise). Shown as a dot on the scale in the `level` and `historical-motion` variants and as the end of the live yaw bar in the `actual-motion` variant. */
+    yaw?: number;
+    /** Available when `type!='actual-motion'`. */
+    minAvgYaw?: number;
+    /** Available when `type!='actual-motion'`. */
+    maxAvgYaw?: number;
+    /** Pitch/roll value at the outermost grid circle. Default `20`. */
+    range?: number;
+    /**
+     * Radius of the motion-envelope circle in the same unit as `pitch`/`roll`. Hidden when `0`.
+     *
+     * Available when `type=='actual-motion'`.
+     */
+    motionRadius?: number;
+    /**
+     * Past attitude samples, oldest first; rendered as a fading trail.
+     *
+     * Available when `type=='historical-motion'`.
+     */
+    motionHistory?: PitchRollSample[];
+    /** Available when `type!='level'`. */
+    vesselImage?: VesselImage;
+    priority?: Priority;
+    /** When `true`, shows 0/90/180/-90 labels outside the scale. */
+    showLabels?: boolean;
+}
+export interface Events {
+}
+export interface Slots {
+    children?: Snippet;
+}
+type $$ComponentProps = Props & Events & Slots;
+declare const ObcPitchRollYaw: import("svelte").Component<$$ComponentProps, {
+    PitchRollYawType: typeof PitchRollYawType;
+    PitchRollSample: typeof PitchRollSample;
+    VesselImage: typeof VesselImage;
+    Priority: typeof Priority;
+}, "">;
+type ObcPitchRollYaw = ReturnType<typeof ObcPitchRollYaw>;
+export default ObcPitchRollYaw;

package/dist/navigation-instruments/position-deviation/ObcPositionDeviation.svelte

@@ -0,0 +1,47 @@
+
+  <script lang="ts">
+    export type {PositionDeviationOrientation, PositionDeviationPriority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/position-deviation/position-deviation.js';
+      import '@oicl/openbridge-webcomponents/dist/navigation-instruments/position-deviation/position-deviation.js';
+      import { setProperties } from "../../util.js";
+      import type {PositionDeviationOrientation, PositionDeviationPriority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/position-deviation/position-deviation.js';
+      import type { Snippet } from 'svelte';
+
+      export interface Props {
+     class?: string;
+     style?: string;
+     orientation?: PositionDeviationOrientation;
+     priority?: PositionDeviationPriority;
+     /** Heading in degrees (0 = north, clockwise). */
+     heading?: number;
+     /** Distance from the current position to the setpoint, in the same unit as the limits. */
+     deviation?: number;
+     /** Bearing from the current position towards the setpoint in degrees (0 = north, clockwise). */
+     setpointBearing?: number;
+     /** Deviation at which the dotted caution ring is drawn; hidden when not a positive finite number. */
+     cautionLimit?: number;
+     /** Deviation at which the solid alarm ring is drawn; hidden when not a positive finite number. */
+     alarmLimit?: number;
+     /** When `false`, hides the alarm ring and anchors the scale to the caution ring. */
+     hasAlarmLimit?: boolean;
+     /** When `true`, shows the N/E/S/W labels on the compass card. */
+     showLabels?: boolean
+   }
+      export interface Events {
+    
+  }
+      export interface Slots {
+  children?: Snippet
+}
+      const { class: className, style, children, ...props} = $props<Props & Events & Slots>();
+
+    </script>
+    <obc-position-deviation
+    use:setProperties={props}
+    class={className}
+    style={style}
+     >
+      
+    {#if children}
+      {@render children()}
+    {/if}
+    </obc-position-deviation>

package/dist/navigation-instruments/position-deviation/ObcPositionDeviation.svelte.d.ts

@@ -0,0 +1,35 @@
+import '@oicl/openbridge-webcomponents/dist/navigation-instruments/position-deviation/position-deviation.js';
+import type { PositionDeviationOrientation, PositionDeviationPriority } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/position-deviation/position-deviation.js';
+import type { Snippet } from 'svelte';
+export interface Props {
+    class?: string;
+    style?: string;
+    orientation?: PositionDeviationOrientation;
+    priority?: PositionDeviationPriority;
+    /** Heading in degrees (0 = north, clockwise). */
+    heading?: number;
+    /** Distance from the current position to the setpoint, in the same unit as the limits. */
+    deviation?: number;
+    /** Bearing from the current position towards the setpoint in degrees (0 = north, clockwise). */
+    setpointBearing?: number;
+    /** Deviation at which the dotted caution ring is drawn; hidden when not a positive finite number. */
+    cautionLimit?: number;
+    /** Deviation at which the solid alarm ring is drawn; hidden when not a positive finite number. */
+    alarmLimit?: number;
+    /** When `false`, hides the alarm ring and anchors the scale to the caution ring. */
+    hasAlarmLimit?: boolean;
+    /** When `true`, shows the N/E/S/W labels on the compass card. */
+    showLabels?: boolean;
+}
+export interface Events {
+}
+export interface Slots {
+    children?: Snippet;
+}
+type $$ComponentProps = Props & Events & Slots;
+declare const ObcPositionDeviation: import("svelte").Component<$$ComponentProps, {
+    PositionDeviationOrientation: typeof PositionDeviationOrientation;
+    PositionDeviationPriority: typeof PositionDeviationPriority;
+}, "">;
+type ObcPositionDeviation = ReturnType<typeof ObcPositionDeviation>;
+export default ObcPositionDeviation;

package/dist/navigation-instruments/propulsion-azimuth-indicator/ObcPropulsionAzimuthIndicator.svelte

@@ -0,0 +1,38 @@
+
+  <script lang="ts">
+    export type {PropulsionAzimuthIndicatorType} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/propulsion-azimuth-indicator/propulsion-azimuth-indicator.js';
+export type {InstrumentState} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+      import '@oicl/openbridge-webcomponents/dist/navigation-instruments/propulsion-azimuth-indicator/propulsion-azimuth-indicator.js';
+      import { setProperties } from "../../util.js";
+      import type {PropulsionAzimuthIndicatorType} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/propulsion-azimuth-indicator/propulsion-azimuth-indicator.js';
+import type {InstrumentState} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+      import type { Snippet } from 'svelte';
+
+      export interface Props {
+     class?: string;
+     style?: string;
+     type?: PropulsionAzimuthIndicatorType;
+     hasSilhouette?: boolean;
+     azimuth?: number;
+     value?: number;
+     state?: InstrumentState
+   }
+      export interface Events {
+    
+  }
+      export interface Slots {
+  children?: Snippet
+}
+      const { class: className, style, children, ...props} = $props<Props & Events & Slots>();
+
+    </script>
+    <obc-propulsion-azimuth-indicator
+    use:setProperties={props}
+    class={className}
+    style={style}
+     >
+      
+    {#if children}
+      {@render children()}
+    {/if}
+    </obc-propulsion-azimuth-indicator>

package/dist/navigation-instruments/propulsion-azimuth-indicator/ObcPropulsionAzimuthIndicator.svelte.d.ts

@@ -0,0 +1,25 @@
+import '@oicl/openbridge-webcomponents/dist/navigation-instruments/propulsion-azimuth-indicator/propulsion-azimuth-indicator.js';
+import type { PropulsionAzimuthIndicatorType } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/propulsion-azimuth-indicator/propulsion-azimuth-indicator.js';
+import type { InstrumentState } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+import type { Snippet } from 'svelte';
+export interface Props {
+    class?: string;
+    style?: string;
+    type?: PropulsionAzimuthIndicatorType;
+    hasSilhouette?: boolean;
+    azimuth?: number;
+    value?: number;
+    state?: InstrumentState;
+}
+export interface Events {
+}
+export interface Slots {
+    children?: Snippet;
+}
+type $$ComponentProps = Props & Events & Slots;
+declare const ObcPropulsionAzimuthIndicator: import("svelte").Component<$$ComponentProps, {
+    PropulsionAzimuthIndicatorType: typeof PropulsionAzimuthIndicatorType;
+    InstrumentState: typeof InstrumentState;
+}, "">;
+type ObcPropulsionAzimuthIndicator = ReturnType<typeof ObcPropulsionAzimuthIndicator>;
+export default ObcPropulsionAzimuthIndicator;

package/dist/navigation-instruments/propulsion-tunnel-thruster/ObcTunnelThruster.svelte

@@ -0,0 +1,35 @@
+
+  <script lang="ts">
+    
+      import '@oicl/openbridge-webcomponents/dist/navigation-instruments/propulsion-tunnel-thruster/propulsion-tunnel-thruster.js';
+      import { setProperties } from "../../util.js";
+      
+      import type { Snippet } from 'svelte';
+
+      export interface Props {
+     class?: string;
+     style?: string;
+     value?: number;
+     thrust?: number;
+     state?: string;
+     hasSilhouette?: boolean
+   }
+      export interface Events {
+    
+  }
+      export interface Slots {
+  children?: Snippet
+}
+      const { class: className, style, children, ...props} = $props<Props & Events & Slots>();
+
+    </script>
+    <obc-tunnel-thruster
+    use:setProperties={props}
+    class={className}
+    style={style}
+     >
+      
+    {#if children}
+      {@render children()}
+    {/if}
+    </obc-tunnel-thruster>

package/dist/navigation-instruments/propulsion-tunnel-thruster/ObcTunnelThruster.svelte.d.ts

@@ -0,0 +1,19 @@
+import '@oicl/openbridge-webcomponents/dist/navigation-instruments/propulsion-tunnel-thruster/propulsion-tunnel-thruster.js';
+import type { Snippet } from 'svelte';
+export interface Props {
+    class?: string;
+    style?: string;
+    value?: number;
+    thrust?: number;
+    state?: string;
+    hasSilhouette?: boolean;
+}
+export interface Events {
+}
+export interface Slots {
+    children?: Snippet;
+}
+type $$ComponentProps = Props & Events & Slots;
+declare const ObcTunnelThruster: import("svelte").Component<$$ComponentProps, {}, "">;
+type ObcTunnelThruster = ReturnType<typeof ObcTunnelThruster>;
+export default ObcTunnelThruster;

package/dist/navigation-instruments/rate-of-turn/ObcRateOfTurn.svelte

@@ -11,6 +11,10 @@ import type {Priority} from '@oicl/openbridge-webcomponents/dist/navigation-inst
       export interface Props {
      class?: string;
      style?: string;
+     /** Measured rate of turn in degrees per minute (positive = starboard). When `undefined`, the legacy `rotationsPerMinute` value is used. */
+     rateOfTurnDegreesPerMinute?: number | undefined;
+     /** Visual amplification applied to the spinning dot animation. Default `18` keeps the legacy visual feel (≈1 rpm at 20°/min). */
+     rotDotAnimationFactor?: number;
      rotationsPerMinute?: number;
      rotType?: RotType;
      rotPosition?: RotPosition;
@@ -19,7 +23,41 @@ import type {Priority} from '@oicl/openbridge-webcomponents/dist/navigation-inst
      barEndAngle?: number;
      watchCircleType?: WatchCircleType;
      rotPortStarboard?: boolean;
-     rotAtZeroDeadband?: number
+     rotAtZeroDeadband?: number;
+     /** When `true`, shows a bar in the ring band from the twelve o'clock position to the measured rate of turn, with a needle marker at its end and sector tickmarks. Pairs with `watchCircleType="double"` for the banded face — or `"triple"` when `rotPosition` is `innerCircle`, so the dots get their inner track too. Driven by `rateOfTurnDegreesPerMinute` only. */
+     hasTrackBar?: boolean;
+     /**
+      * Bar-extent reference value in **degrees per minute**: the track bar reaches ±`rotArcExtent` when the measured ROT equals ±`rotMaxValue`. Default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
+      *
+      * Available when `hasTrackBar==true`.
+      */
+     rotMaxValue?: number;
+     /**
+      * Arc extent of the track bar in degrees per direction. Default `60`.
+      *
+      * Available when `hasTrackBar==true`.
+      */
+     rotArcExtent?: number;
+     /** When `true`, shows a centered `<obc-readout>` with the measured rate of turn. Shows a dash while `rateOfTurnDegreesPerMinute` is unset. */
+     hasReadout?: boolean;
+     /**
+      * Readout label. Default `ROT`.
+      *
+      * Available when `hasReadout==true`.
+      */
+     label?: string;
+     /**
+      * Readout unit. Default `DEG/min`.
+      *
+      * 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/rate-of-turn/ObcRateOfTurn.svelte.d.ts

@@ -5,6 +5,10 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
+    /** Measured rate of turn in degrees per minute (positive = starboard). When `undefined`, the legacy `rotationsPerMinute` value is used. */
+    rateOfTurnDegreesPerMinute?: number | undefined;
+    /** Visual amplification applied to the spinning dot animation. Default `18` keeps the legacy visual feel (≈1 rpm at 20°/min). */
+    rotDotAnimationFactor?: number;
     rotationsPerMinute?: number;
     rotType?: RotType;
     rotPosition?: RotPosition;
@@ -14,6 +18,40 @@ export interface Props {
     watchCircleType?: WatchCircleType;
     rotPortStarboard?: boolean;
     rotAtZeroDeadband?: number;
+    /** When `true`, shows a bar in the ring band from the twelve o'clock position to the measured rate of turn, with a needle marker at its end and sector tickmarks. Pairs with `watchCircleType="double"` for the banded face — or `"triple"` when `rotPosition` is `innerCircle`, so the dots get their inner track too. Driven by `rateOfTurnDegreesPerMinute` only. */
+    hasTrackBar?: boolean;
+    /**
+     * Bar-extent reference value in **degrees per minute**: the track bar reaches ±`rotArcExtent` when the measured ROT equals ±`rotMaxValue`. Default `60` aligns with ES-TRIN 2025/1 Art. 3.02.
+     *
+     * Available when `hasTrackBar==true`.
+     */
+    rotMaxValue?: number;
+    /**
+     * Arc extent of the track bar in degrees per direction. Default `60`.
+     *
+     * Available when `hasTrackBar==true`.
+     */
+    rotArcExtent?: number;
+    /** When `true`, shows a centered `<obc-readout>` with the measured rate of turn. Shows a dash while `rateOfTurnDegreesPerMinute` is unset. */
+    hasReadout?: boolean;
+    /**
+     * Readout label. Default `ROT`.
+     *
+     * Available when `hasReadout==true`.
+     */
+    label?: string;
+    /**
+     * Readout unit. Default `DEG/min`.
+     *
+     * 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/readout/ObcReadout.svelte

@@ -0,0 +1,132 @@
+
+  <script lang="ts">
+    export type {ReadoutValueType} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/readout-formatters.js';
+export type {ReadoutBlockSize, ReadoutBlockDataQuality} from '@oicl/openbridge-webcomponents/dist/building-blocks/readout-block/readout-block.js';
+export type {Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+export type {ReadoutDirection, ReadoutStacking, ReadoutAlignment, ReadoutSourceOptions} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/readout.js';
+export type {AlertFrameConfig} from '@oicl/openbridge-webcomponents/dist/components/alert-frame/alert-frame.js';
+export type {ReadoutValueOptions, ReadoutSetpointOptions, ReadoutAdviceOptions, ReadoutLabelOptions, ReadoutReserverOptions} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout-list-item/readout-list-item.js';
+      import '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/readout.js';
+      import { setProperties, forwardEvents } from "../../util.js";
+      import NamedSlot from "../../NamedSlot.svelte";
+      import type {ReadoutValueType} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/readout-formatters.js';
+import type {ReadoutBlockSize, ReadoutBlockDataQuality} from '@oicl/openbridge-webcomponents/dist/building-blocks/readout-block/readout-block.js';
+import type {Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+import type {ReadoutDirection, ReadoutStacking, ReadoutAlignment, ReadoutSourceOptions} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout/readout.js';
+import type {AlertFrameConfig} from '@oicl/openbridge-webcomponents/dist/components/alert-frame/alert-frame.js';
+import type {ReadoutValueOptions, ReadoutSetpointOptions, ReadoutAdviceOptions, ReadoutLabelOptions, ReadoutReserverOptions} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/readout-list-item/readout-list-item.js';
+      import type { Snippet } from 'svelte';
+
+      export interface Props {
+     class?: string;
+     style?: string;
+     label?: string | undefined;
+     unit?: string | undefined;
+     src?: string | undefined;
+     /** Layout switch: `false` renders a deliberately value-less (label-only) readout that hugs its remaining parts. For a temporarily missing value keep `hasValue` and set `value` to `null` instead — the dash keeps the value block at full size, so the layout does not shift when data arrives. */
+     hasValue?: boolean;
+     /** The value; `null` renders a dash. A number by default, or text when `valueType` is `text`. */
+     value?: string | number | null;
+     /** How `value` is interpreted. `number` (default) formats it via `fractionDigits`; `text` renders it verbatim and ignores the numeric format options. Passing text while this is `number` throws. */
+     valueType?: ReadoutValueType;
+     /** Render the value as `offText` (e.g. equipment powered down). Affects the value only. */
+     off?: boolean;
+     /**
+      * Text shown in place of the value when `off` is true.
+      *
+      * Available when `off==true`.
+      */
+     offText?: string;
+     hasSetpoint?: boolean;
+     /** Available when `hasSetpoint==true`. */
+     setpoint?: number | undefined;
+     hasAdvice?: boolean;
+     /** Available when `hasAdvice==true`. */
+     advice?: number | undefined;
+     /**
+      * Density tier. Applies to the vertical direction only — the horizontal arrangement exists in the large tier alone (Figma 6.1: it relies on the label+unit stack aligning with the L-size value caps), so `size` is ignored when `direction` is `horizontal`; a horizontal readout given any other `size` logs a console warning once per element.
+      *
+      * Available when `direction==vertical`.
+      */
+     size?: ReadoutBlockSize | undefined;
+     priority?: Priority | undefined;
+     direction?: ReadoutDirection | undefined;
+     /** Available when `direction==vertical`. */
+     stacking?: ReadoutStacking | undefined;
+     /** Available when `direction==vertical && stacking==stacked`. */
+     alignment?: ReadoutAlignment | undefined;
+     /** Render the cap-height degree glyph (`°`) after the ACTUAL VALUE only — the setpoint / advice blocks never carry one (Figma 6.1 review: the unit is written once for the readout, and the degree follows the same rule). */
+     hasDegree?: boolean;
+     /** Available when `hasDegree==false`. */
+     hasDegreeSpacer?: boolean;
+     /** Show the `leading-icon` slot before the label/unit meta zone. */
+     hasLeadingIcon?: boolean;
+     /**
+      * Also formats the numeric setpoint / advice blocks, which stay numeric even when the value is text. Must be between 0 and 100 — the range `Number.prototype.toFixed` accepts; outside it throws a `RangeError`. A fractional count truncates (`2.7` → `2`). A count that never arrived (`NaN`, `null` or unset) renders the reading as the unavailable dash — formatting with a precision the author never chose would let a critical `0.4` pass for a healthy `0`.
+      *
+      * Available when `valueType==number || hasSetpoint==true || hasAdvice==true`.
+      */
+     fractionDigits?: number;
+     /**
+      * Also formats the numeric setpoint / advice blocks, which stay numeric even when the value is text. Bounded before use: a fractional count truncates (`2.7` → `2`), anything above 100 — including `Infinity` — caps at 100, and a negative count reserves nothing. A count that never arrived (`NaN`, `null` or unset) renders the reading as the unavailable dash, consistent with `fractionDigits`.
+      *
+      * Available when `valueType==number || hasSetpoint==true || hasAdvice==true`.
+      */
+     maxDigits?: number;
+     dataQuality?: ReadoutBlockDataQuality | undefined;
+     alert?: boolean | AlertFrameConfig;
+     /** Available when `hasValue==true`. */
+     valueOptions?: ReadoutValueOptions | undefined;
+     /** Available when `hasSetpoint==true`. */
+     setpointOptions?: ReadoutSetpointOptions | undefined;
+     /** Available when `hasAdvice==true`. */
+     adviceOptions?: ReadoutAdviceOptions | undefined;
+     /** Available when `label!=''`. */
+     labelOptions?: ReadoutLabelOptions | undefined;
+     /** Available when `unit!=''`. */
+     unitOptions?: ReadoutReserverOptions | undefined;
+     /** Available when `src!=''`. */
+     srcOptions?: ReadoutSourceOptions | undefined;
+     /** Development aid: outline the readout building blocks (red), the degree columns (blue) and the degree spacer (green) so reserved widths / alignment are visible. Off by default. */
+     showDebugOverlay?: boolean
+   }
+      export interface Events {
+    onSourceChange?: (event: CustomEvent<{value: string, label?: string}>) => void;
+    onSourceFlyoutClick?: (event: CustomEvent<{src: string}>) => void
+  }
+      export interface Slots {
+  leadingIcon?: Snippet;
+  valueIcon?: Snippet;
+  setpointIcon?: Snippet;
+  adviceIcon?: Snippet;
+  srcPickerContent?: Snippet
+}
+      const {onSourceChange, onSourceFlyoutClick, class: className, style, leadingIcon, valueIcon, setpointIcon, adviceIcon, srcPickerContent, ...props} = $props<Props & Events & Slots>();
+
+    </script>
+    <obc-readout
+    use:setProperties={props}
+    class={className}
+    style={style}
+    use:forwardEvents={{'source-change': onSourceChange, 'source-flyout-click': onSourceFlyoutClick}} >
+      
+      {#if leadingIcon}
+        <NamedSlot name="leading-icon" content={leadingIcon} />
+      {/if}
+
+      {#if valueIcon}
+        <NamedSlot name="value-icon" content={valueIcon} />
+      {/if}
+
+      {#if setpointIcon}
+        <NamedSlot name="setpoint-icon" content={setpointIcon} />
+      {/if}
+
+      {#if adviceIcon}
+        <NamedSlot name="advice-icon" content={adviceIcon} />
+      {/if}
+
+      {#if srcPickerContent}
+        <NamedSlot name="src-picker-content" content={srcPickerContent} />
+      {/if}
+    </obc-readout>