@oicl/openbridge-webcomponents-full-bundle 2.0.0-next.111 → 2.0.0-next.113

package/custom-elements.json

@@ -40052,7 +40052,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-readout-block>` – the most atomic readout primitive: a single\ncap-height-aligned, width-reservable numeric segment (value / setpoint /\nadvice).\n\nIt renders one `obc-textbox` number with optional hinted leading zeros, a\nreservable width, an optional leading marker icon (via the `icon` slot or the\nrole default), an optional trailing degree glyph, an `off`/unavailable text\nstate, per-block data-quality and an optional per-block alert frame.\n\nThis is a building block used inside `obc-readout-list-item` (and, in a future\nrefactor, inside `obc-readout`); it is not normally used on its own. Colour is\ninherited from the host context (the parent sets the role colour), so the\nblock stays neutral until placed.",
+          "description": "`<obc-readout-block>` – the most atomic readout primitive: a single\ncap-height-aligned, width-reservable numeric segment (value / setpoint /\nadvice).\n\nIt renders one `obc-textbox` number with optional hinted leading zeros, a\nreservable width, an optional leading marker icon (via the `icon` slot or the\nrole default), an optional trailing degree glyph, an `off`/unavailable text\nstate, per-block data-quality and an optional per-block alert frame.\n\nSetting `valueType` to `text` renders `value` verbatim (e.g.\n`\"Auto\"`) instead of a formatted number.\n\nThis is a building block used inside `obc-readout-list-item` (and, in a future\nrefactor, inside `obc-readout`); it is not normally used on its own. Colour is\ninherited from the host context (the parent sets the role colour), so the\nblock stays neutral until placed.",
           "name": "ObcReadoutBlock",
           "cssParts": [
             {
@@ -40096,12 +40096,21 @@
               "kind": "field",
               "name": "value",
               "type": {
-                "text": "number | null"
+                "text": "number | string | null"
               },
               "default": "null",
-              "description": "The numeric value; `null`/`undefined` renders a dash.",
+              "description": "The value; `null`/`undefined` renders a dash. A number by default, or text\nwhen valueType is `text`.",
               "attribute": "value"
             },
+            {
+              "kind": "field",
+              "name": "valueType",
+              "type": {
+                "text": "ReadoutValueType"
+              },
+              "description": "How value is interpreted. `number` (default) formats it via\n`fractionDigits`; `text` renders it verbatim and ignores the numeric\nformat options. Passing text while this is `number` throws.",
+              "attribute": "valueType"
+            },
             {
               "kind": "field",
               "name": "size",
@@ -40384,12 +40393,20 @@
             {
               "name": "value",
               "type": {
-                "text": "number | null"
+                "text": "number | string | null"
               },
               "default": "null",
-              "description": "The numeric value; `null`/`undefined` renders a dash.",
+              "description": "The value; `null`/`undefined` renders a dash. A number by default, or text\nwhen valueType is `text`.",
               "fieldName": "value"
             },
+            {
+              "name": "valueType",
+              "type": {
+                "text": "ReadoutValueType"
+              },
+              "description": "How value is interpreted. `number` (default) formats it via\n`fractionDigits`; `text` renders it verbatim and ignores the numeric\nformat options. Passing text while this is `number` throws.",
+              "fieldName": "valueType"
+            },
             {
               "name": "size",
               "type": {
@@ -40570,6 +40587,14 @@
             "module": "../../components/textbox/textbox.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadoutValueType",
+          "declaration": {
+            "name": "ReadoutValueType",
+            "module": "../../navigation-instruments/readout/readout-formatters.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ObcReadoutBlock",
@@ -77021,7 +77046,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Show compass NSEW labels and north arrow.",
+              "description": "Show compass NSEW labels. The north arrow is always shown, independent of this flag.",
               "attribute": "showLabels"
             },
             {
@@ -77427,7 +77452,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Show compass NSEW labels and north arrow.",
+              "description": "Show compass NSEW labels. The north arrow is always shown, independent of this flag.",
               "fieldName": "showLabels"
             },
             {
@@ -77521,7 +77546,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-current>` – Water-current instrument with direction chevrons and a\nforce-graphics band pattern.\n\nRenders the current's from-direction and strength on a circular watch\nface. Two layouts are available via `type`: `vessel` (default) shows a\nvessel silhouette on a double-ring track face with a chevron icon at the\nperiphery pointing with the flow; `direction` shows a single-ring face\nwith a large centered chevron icon. In both, a soft band pattern fills the\nface, rotated perpendicular to the flow.\n\n## Features\n\n- **Types**: `vessel` (track face + vessel + peripheral icon) or\n  `direction` (single ring + large centered icon) via `type`.\n- **Strength buckets**: `currentSpeed` selects the chevron icon\n  (`0`–`4` = number of chevrons); values are rounded and clamped.\n- **Color priority**: `priority=enhanced` switches the pattern and icon to\n  the enhanced (blue) palette.\n- **Vessel image**: configurable silhouette rotating with\n  `vesselHeadingDeg` (vessel type).\n\n## Usage Guidelines\n\nSet `currentSpeed` and `currentFromDirection` to the sensor values. Use\n`obc-wind` for the analogous wind instrument; use `obc-compass` when the\ncurrent indicator should overlay a full compass.\n\n## Example\n\n```html\n<obc-current\n  currentSpeed=\"3\"\n  currentFromDirection=\"330\"\n  vesselHeadingDeg=\"15\"\n></obc-current>\n```",
+          "description": "`<obc-current>` – Water-current instrument with direction chevrons and a\nforce-graphics band pattern.\n\nRenders the current's from-direction and strength on a circular watch\nface. Two layouts are available via `type`: `vessel` (default) shows a\nvessel silhouette on a double-ring track face with a chevron icon at the\nperiphery pointing with the flow; `direction` shows a single-ring face\nwith a large centered chevron icon. In both, a soft band pattern fills the\nface, rotated perpendicular to the flow.\n\n## Features\n\n- **Types**: `vessel` (track face + vessel + peripheral icon) or\n  `direction` (single ring + large centered icon) via `type`.\n- **Strength buckets**: `currentSpeed` selects the chevron icon\n  (`0`–`4` = number of chevrons); values are rounded and clamped.\n- **Color priority**: `priority=enhanced` switches the pattern and icon to\n  the enhanced (blue) palette.\n- **Vessel image**: configurable silhouette rotating with\n  `vesselHeadingDeg` (vessel type).\n- **Pattern toggle & wave tuning**: `hasPattern` switches the band pattern\n  off; `waveLength`, `waveHeight` and `waveSpeed` tune the band spacing,\n  intensity and drift motion.\n\n## Usage Guidelines\n\nSet `currentSpeed` and `currentFromDirection` to the sensor values. Use\n`obc-wind` for the analogous wind instrument; use `obc-compass` when the\ncurrent indicator should overlay a full compass.\n\n## Example\n\n```html\n<obc-current\n  currentSpeed=\"3\"\n  currentFromDirection=\"330\"\n  vesselHeadingDeg=\"15\"\n></obc-current>\n```",
           "name": "ObcCurrent",
           "members": [
             {
@@ -77562,6 +77587,45 @@
               "description": "Color priority: `Priority.enhanced` uses the blue/enhanced palette (default: `Priority.regular`).",
               "attribute": "priority"
             },
+            {
+              "kind": "field",
+              "name": "hasPattern",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Show the force-graphics band pattern behind the watch face."
+            },
+            {
+              "kind": "field",
+              "name": "waveLength",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Wavelength of the pattern bands as a multiplier on the design spacing\n(1 = design, 0.5 = twice as dense).",
+              "attribute": "waveLength"
+            },
+            {
+              "kind": "field",
+              "name": "waveHeight",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Wave intensity: the peak opacity the pattern bands fade up to (0–1).",
+              "attribute": "waveHeight"
+            },
+            {
+              "kind": "field",
+              "name": "waveSpeed",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Drift speed of the pattern in wavelengths per second, moving with the\nflow (negative drifts against it); 0 keeps the pattern static.",
+              "attribute": "waveSpeed"
+            },
             {
               "kind": "field",
               "name": "vesselImage",
@@ -77648,6 +77712,33 @@
               "description": "Color priority: `Priority.enhanced` uses the blue/enhanced palette (default: `Priority.regular`).",
               "fieldName": "priority"
             },
+            {
+              "name": "waveLength",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Wavelength of the pattern bands as a multiplier on the design spacing\n(1 = design, 0.5 = twice as dense).",
+              "fieldName": "waveLength"
+            },
+            {
+              "name": "waveHeight",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Wave intensity: the peak opacity the pattern bands fade up to (0–1).",
+              "fieldName": "waveHeight"
+            },
+            {
+              "name": "waveSpeed",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Drift speed of the pattern in wavelengths per second, moving with the\nflow (negative drifts against it); 0 keeps the pattern static.",
+              "fieldName": "waveSpeed"
+            },
             {
               "name": "vesselImage",
               "type": {
@@ -87967,7 +88058,7 @@
                   "text": "SVGTemplateResult"
                 }
               },
-              "description": "Crosshair drawn on the overlay rather than through `obc-watch`'s own\n`crosshairEnabled`: the design has the arc bands covering the arms, but\n`obc-watch` renders its crosshair after the bands, i.e. on top of them.\nDrawing it here puts it under the watch layer, so the bands and the heave\ncolumn mask it naturally."
+              "description": "Crosshair drawn on the overlay rather than through `obc-watch`'s own\n`crosshairEnabled`: the design has the arc bands covering the arms, but\n`obc-watch` renders its crosshair after the bands, i.e. on top of them.\nDrawing it here puts it under the watch layer, so the bands and the heave\ncolumn mask it naturally.\n\nIn `single-scale` nothing frames the segment above the vessel (the other\nthree arms end under the pitch band, roll band and heave column), so the\nvertical arm stops at the centre instead of continuing upward. In\n`dual-scale` the top roll band gives it a natural endpoint, so the full\narm is kept."
             },
             {
               "kind": "method",
@@ -90661,7 +90752,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-rate-of-turn>` — Standalone rate-of-turn indicator rendered on a circular watch face.\n\nWraps `<obc-watch>` to display a spinning-dot or arc-bar ROT visualization\nwithout any additional instrument overlays. Useful for isolating the ROT\nindicator in layouts where heading/compass elements are handled separately.\n\n## Features\n\n- **Dot mode** (`rotType=\"dots\"`): Five evenly-spaced dots spin at the\n  resolved rotations-per-minute (derived from\n  `rateOfTurnDegreesPerMinute × rotDotAnimationFactor / 360`).\n- **Bar mode** (`rotType=\"bar\"`): A banana-shaped arc from `barStartAngle`\n  to `barEndAngle` with clipped spinning dots inside.\n- **Track position**: Place the indicator on the outer scale ring\n  (`rotPosition=\"scale\"`) or the inner circle\n  (`rotPosition=\"innerCircle\"`).\n- **Track bar** (`hasTrackBar`): A bar in the ring band growing from the\n  twelve o'clock position to the measured rate of turn, with a needle\n  marker at its end and sector tickmarks (pairs with\n  `watchCircleType=\"double\"` for the banded face).\n- **Center readout** (`hasReadout`): A centered readout showing the\n  measured rate of turn (label `ROT`, unit `DEG/min` by default).\n- **Color priority**: Uses `priority` to select regular or enhanced color\n  palette; `rotPortStarboard` colors the track bar and needle by turn\n  direction.\n\n## Usage Guidelines\n\n- Set `rateOfTurnDegreesPerMinute` to the current sensor value in degrees\n  per minute (the maritime/AIS convention). Sign controls direction\n  (positive = starboard / clockwise).\n- Tune `rotDotAnimationFactor` to amplify the dot animation independently\n  of the physical value (default `18` ≈ 1 rpm at 20°/min).\n- In bar mode, `barStartAngle` and `barEndAngle` define the static arc\n  span (0° = 12 o'clock, clockwise).\n- Change `watchCircleType` to match the surrounding instrument ring style\n  (e.g. `triple` for compass contexts).",
+          "description": "`<obc-rate-of-turn>` — Standalone rate-of-turn indicator rendered on a circular watch face.\n\nWraps `<obc-watch>` to display a spinning-dot or arc-bar ROT visualization\nwithout any additional instrument overlays. Useful for isolating the ROT\nindicator in layouts where heading/compass elements are handled separately.\n\n## Features\n\n- **Dot mode** (`rotType=\"dots\"`): Five evenly-spaced dots spin at the\n  resolved rotations-per-minute (derived from\n  `rateOfTurnDegreesPerMinute × rotDotAnimationFactor / 360`).\n- **Bar mode** (`rotType=\"bar\"`): A banana-shaped arc from `barStartAngle`\n  to `barEndAngle` with clipped spinning dots inside.\n- **Track position**: Place the indicator on the outer scale ring\n  (`rotPosition=\"scale\"`) or the inner circle\n  (`rotPosition=\"innerCircle\"`).\n- **Track bar** (`hasTrackBar`): A bar in the ring band growing from the\n  twelve o'clock position to the measured rate of turn, with a needle\n  marker at its end and sector tickmarks (pairs with\n  `watchCircleType=\"double\"` for the banded face, or `\"triple\"` when the\n  ROT dots sit on the inner circle).\n- **Center readout** (`hasReadout`): A centered readout showing the\n  measured rate of turn (label `ROT`, unit `DEG/min` by default).\n- **Color priority**: Uses `priority` to select regular or enhanced color\n  palette; `rotPortStarboard` colors the track bar and needle by turn\n  direction.\n\n## Usage Guidelines\n\n- Set `rateOfTurnDegreesPerMinute` to the current sensor value in degrees\n  per minute (the maritime/AIS convention). Sign controls direction\n  (positive = starboard / clockwise).\n- Tune `rotDotAnimationFactor` to amplify the dot animation independently\n  of the physical value (default `18` ≈ 1 rpm at 20°/min).\n- In bar mode, `barStartAngle` and `barEndAngle` define the static arc\n  span (0° = 12 o'clock, clockwise).\n- Change `watchCircleType` to match the surrounding instrument ring style\n  (e.g. `triple` for compass contexts).",
           "name": "ObcRateOfTurn",
           "members": [
             {
@@ -90768,7 +90859,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When `true`, shows a bar in the ring band from the twelve o'clock\nposition to the measured rate of turn, with a needle marker at its end\nand sector tickmarks. Pairs with `watchCircleType=\"double\"` for the\nbanded face. Driven by `rateOfTurnDegreesPerMinute` only.",
+              "description": "When `true`, shows a bar in the ring band from the twelve o'clock\nposition to the measured rate of turn, with a needle marker at its end\nand sector tickmarks. Pairs with `watchCircleType=\"double\"` for the\nbanded face — or `\"triple\"` when `rotPosition` is `innerCircle`, so the\ndots get their inner track too. Driven by `rateOfTurnDegreesPerMinute`\nonly.",
               "attribute": "hasTrackBar"
             },
             {
@@ -90961,7 +91052,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "When `true`, shows a bar in the ring band from the twelve o'clock\nposition to the measured rate of turn, with a needle marker at its end\nand sector tickmarks. Pairs with `watchCircleType=\"double\"` for the\nbanded face. Driven by `rateOfTurnDegreesPerMinute` only.",
+              "description": "When `true`, shows a bar in the ring band from the twelve o'clock\nposition to the measured rate of turn, with a needle marker at its end\nand sector tickmarks. Pairs with `watchCircleType=\"double\"` for the\nbanded face — or `\"triple\"` when `rotPosition` is `innerCircle`, so the\ndots get their inner track too. Driven by `rateOfTurnDegreesPerMinute`\nonly.",
               "fieldName": "hasTrackBar"
             },
             {
@@ -91068,7 +91159,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-readout-list-item>` – A compact, dense readout row for lists and tables.\n\nRenders a label, an optional source, an optional unit, and up to three\ncap-height \"readout building blocks\" – advice, setpoint, and value – each a\nfixed-width-reservable numeric segment. Dynamic data is passed as top-level\nprimitives (`value`, `setpoint`, `advice`, `label`, `unit`, `src`). Global\nlayout/format is configured via top-level props (`size`, `priority`,\n`stacking`, `hasDegree`, `dataQuality`, `alert`, …) and per-block tweaks via one\nobject per block (`valueOptions`, `setpointOptions`, `adviceOptions`,\n`unitOptions`, `srcOptions`).\n\n### Features\n- **Building blocks:** value, optional setpoint, and optional advice segments,\n  each cap-height-aligned and able to reserve a stable width.\n- **Sizes:** `small`, `medium`, `large` density scales.\n- **Stacking:** `trailing-unit`, `leading-unit`, `leading-src` placement.\n- **Priority:** `regular`/`enhanced` colour emphasis; per-value `weight`\n  (`regular`/`semibold`/`bold`) is independent of colour.\n- **Setpoint flip-flop:** swaps emphasis between value and setpoint as the\n  value reaches the setpoint.\n- **Data quality:** `low-integrity`/`invalid` styling, combinable with `alert`.\n- **Alert frame:** optional `alert` wrapper (caution/warning/alarm/level).\n- **Clickable:** optionally rendered as a focusable button with `squared`,\n  `round-corners`, or `round` corners.\n- **Formatting:** shared `fractionDigits`, width reservation via `maxDigits`\n  and per-segment `hintedZeros`; a `null` value renders a dash (`-`).\n\n### Usage Guidelines\nUse for dense readout rows in lists/tables. Prefer `<obc-readout>` for rich\nmulti-segment instrument layouts, source pickers, or flyout behaviour.",
+          "description": "`<obc-readout-list-item>` – A compact, dense readout row for lists and tables.\n\nRenders a label, an optional source, an optional unit, and up to three\ncap-height \"readout building blocks\" – advice, setpoint, and value – each a\nfixed-width-reservable numeric segment. Dynamic data is passed as top-level\nprimitives (`value`, `setpoint`, `advice`, `label`, `unit`, `src`). Global\nlayout/format is configured via top-level props (`size`, `priority`,\n`stacking`, `hasDegree`, `dataQuality`, `alert`, …) and per-block tweaks via one\nobject per block (`valueOptions`, `setpointOptions`, `adviceOptions`,\n`unitOptions`, `srcOptions`).\n\n### Features\n- **Building blocks:** value, optional setpoint, and optional advice segments,\n  each cap-height-aligned and able to reserve a stable width.\n- **Sizes:** `small`, `medium`, `large` density scales.\n- **Stacking:** `trailing-unit`, `leading-unit`, `leading-src` placement.\n- **Priority:** `regular`/`enhanced` colour emphasis; per-value `weight`\n  (`regular`/`semibold`/`bold`) is independent of colour.\n- **Setpoint flip-flop:** swaps emphasis between value and setpoint as the\n  value reaches the setpoint.\n- **Data quality:** `low-integrity`/`invalid` styling, combinable with `alert`.\n- **Alert frame:** optional `alert` wrapper (caution/warning/alarm/level).\n- **Clickable:** optionally rendered as a focusable button with `squared`,\n  `round-corners`, or `round` corners.\n- **Formatting:** shared `fractionDigits`, width reservation via `maxDigits`\n  and per-segment `hintedZeros`; a `null` value renders a dash (`-`).\n- **Text values:** `valueType=\"text\"` renders `value` verbatim (e.g.\n  `\"Thermo On\"`) instead of formatting it as a number.\n\n### Usage Guidelines\nUse for dense readout rows in lists/tables. Prefer `<obc-readout>` for rich\nmulti-segment instrument layouts, source pickers, or flyout behaviour.",
           "name": "ObcReadoutListItem",
           "slots": [
             {
@@ -91126,11 +91217,21 @@
               "kind": "field",
               "name": "value",
               "type": {
-                "text": "number | null"
+                "text": "number | string | null"
               },
               "default": "null",
+              "description": "The value; `null` renders a dash. A number by default, or text when\nvalueType is `text`.",
               "attribute": "value"
             },
+            {
+              "kind": "field",
+              "name": "valueType",
+              "type": {
+                "text": "ReadoutValueType"
+              },
+              "description": "How value is interpreted. `number` (default) formats it via\n`fractionDigits`; `text` renders it verbatim and ignores the numeric\nformat options. Passing text while this is `number` throws.",
+              "attribute": "valueType"
+            },
             {
               "kind": "field",
               "name": "off",
@@ -91252,6 +91353,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "attribute": "fractionDigits"
             },
             {
@@ -91261,6 +91363,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "attribute": "maxDigits"
             },
             {
@@ -91603,7 +91706,7 @@
                 {
                   "name": "config",
                   "type": {
-                    "text": "{\n    variant: ReadoutBlockVariant;\n    value: number | null | undefined;\n    valueSize: ObcTextboxSize;\n    enhanced: boolean;\n    weight: ObcTextboxFontWeight;\n    hintedZeros: boolean;\n    spaceReserver?: string;\n    off?: boolean;\n    hasDegree?: boolean;\n    hasIcon?: boolean;\n    touching?: boolean;\n    hidePhase?: ReadoutBlockHidePhase;\n    dataQuality?: ReadoutBlockDataQuality;\n    alert?: false | AlertFrameConfig;\n  }"
+                    "text": "{\n    variant: ReadoutBlockVariant;\n    value: number | string | null | undefined;\n    /** Only the value block is ever text; setpoint / advice stay numeric. */\n    valueType?: ReadoutValueType;\n    valueSize: ObcTextboxSize;\n    enhanced: boolean;\n    weight: ObcTextboxFontWeight;\n    hintedZeros: boolean;\n    spaceReserver?: string;\n    off?: boolean;\n    hasDegree?: boolean;\n    hasIcon?: boolean;\n    touching?: boolean;\n    hidePhase?: ReadoutBlockHidePhase;\n    dataQuality?: ReadoutBlockDataQuality;\n    alert?: false | AlertFrameConfig;\n  }"
                   }
                 }
               ]
@@ -91802,11 +91905,20 @@
             {
               "name": "value",
               "type": {
-                "text": "number | null"
+                "text": "number | string | null"
               },
               "default": "null",
+              "description": "The value; `null` renders a dash. A number by default, or text when\nvalueType is `text`.",
               "fieldName": "value"
             },
+            {
+              "name": "valueType",
+              "type": {
+                "text": "ReadoutValueType"
+              },
+              "description": "How value is interpreted. `number` (default) formats it via\n`fractionDigits`; `text` renders it verbatim and ignores the numeric\nformat options. Passing text while this is `number` throws.",
+              "fieldName": "valueType"
+            },
             {
               "name": "off",
               "type": {
@@ -91914,6 +92026,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "fieldName": "fractionDigits"
             },
             {
@@ -91922,6 +92035,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "fieldName": "maxDigits"
             },
             {
@@ -92001,6 +92115,14 @@
             "module": "../../components/textbox/textbox.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadoutValueType",
+          "declaration": {
+            "name": "ReadoutValueType",
+            "module": "../readout/readout-formatters.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReadoutListItemSize",
@@ -92041,7 +92163,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-readout-list>` – A container that groups `<obc-readout-list-item>` rows\nand **auto-aligns their columns**.\n\nBecause each row is its own custom element, cross-row column alignment is not\nautomatic. This container inspects its rows and pushes shared width reservers\ndown so the unit column, the value / setpoint / advice columns and the source\ncolumn all line up — the same effect the `Readout List Item → ColumnAlignment`\nstory achieves by hand, done for you. Alignment is always on.\n\nWhat it equalizes — derived from each row's data and broadcast to every row, so\nthe widest value / unit / source is never clipped:\n- **Unit:** the longest `unit` becomes every row's unit space-reserver.\n- **Value / setpoint / advice:** the widest numeric width (max integer digits +\n  max fraction digits across rows, derived from each row's `maxDigits` /\n  `fractionDigits` / current values) is reserved on every row's numeric blocks.\n  Reserving off digit counts keeps it stable as live values update.\n- **Source:** the longest `src` becomes every row's source space-reserver.\n- **Degree:** if any row has a degree, non-degree rows reserve the degree column\n  (`hasDegreeSpacer`) so their digits line up with the degree rows; the spacer is\n  cleared once no degree rows remain.\n\nThe list **owns** these reservers: it recomputes them from the rows' data on\nevery pass (and clears stale reservers / spacers when rows change), so a\n`spaceReserver` set directly on a row inside the list is overwritten. Drive the\ndata (`maxDigits` / `fractionDigits` / `unit` / `src`) rather than setting a\nmanual reserver when a row lives in a list.\n\nAlignment runs on `slotchange` and on child mutations (added/removed rows and\nHTML-attribute changes). When rows are updated via JS **properties** only (no\nattribute/DOM mutation), call align to recompute.",
+          "description": "`<obc-readout-list>` – A container that groups `<obc-readout-list-item>` rows\nand **auto-aligns their columns**.\n\nBecause each row is its own custom element, cross-row column alignment is not\nautomatic. This container inspects its rows and pushes shared width reservers\ndown so the unit column, the value / setpoint / advice columns and the source\ncolumn all line up — the same effect the `Readout List Item → ColumnAlignment`\nstory achieves by hand, done for you. Alignment is always on.\n\nWhat it equalizes — derived from each row's data and broadcast to every row, so\nthe widest value / unit / source is never clipped:\n- **Unit:** the longest `unit` becomes every row's unit space-reserver.\n- **Value / setpoint / advice:** the widest numeric width (max integer digits +\n  max fraction digits across rows, derived from each row's `maxDigits` /\n  `fractionDigits` / current values) is reserved on every row's numeric blocks.\n  Reserving off digit counts keeps it stable as live values update. A row with\n  `valueType=\"text\"` is excluded in both directions — it neither contributes\n  to the reserve (so a long text value cannot inflate the numeric column) nor\n  receives it (so short text is not padded to a digit width); its value block\n  sizes to its own content. Its setpoint / advice blocks stay numeric and are\n  reserved normally.\n- **Source:** the longest `src` becomes every row's source space-reserver.\n- **Degree:** if any row has a degree, non-degree rows reserve the degree column\n  (`hasDegreeSpacer`) so their digits line up with the degree rows; the spacer is\n  cleared once no degree rows remain.\n\nThe list **owns** these reservers: it recomputes them from the rows' data on\nevery pass (and clears stale reservers / spacers when rows change), so a\n`spaceReserver` set directly on a row inside the list is overwritten. Drive the\ndata (`maxDigits` / `fractionDigits` / `unit` / `src`) rather than setting a\nmanual reserver when a row lives in a list.\n\nAlignment runs on `slotchange` and on child mutations (added/removed rows and\nHTML-attribute changes). When rows are updated via JS **properties** only (no\nattribute/DOM mutation), call align to recompute.",
           "name": "ObcReadoutList",
           "cssParts": [
             {
@@ -92155,7 +92277,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-readout>` – An instrument readout: a value with optional setpoint,\nadvice, label, unit, and source, arranged vertically or horizontally.\n\nA layout sibling of `<obc-readout-list-item>` built from the same\ncap-height \"readout building blocks\" (`obc-readout-block`): dynamic data is\npassed as top-level primitives (`value`, `setpoint`, `advice`, `label`,\n`unit`, `src`), global layout/format via top-level props (`size`,\n`priority`, `direction`, `stacking`, `alignment`, `hasDegree`,\n`dataQuality`, `alert`, …) and per-block tweaks via one object per block\n(`valueOptions`, `setpointOptions`, `adviceOptions`, `unitOptions`,\n`srcOptions`).\n\n### Features\n- **Building blocks:** value, optional setpoint, and optional advice\n  segments, each cap-height-aligned and able to reserve a stable width.\n- **Sizes:** `small`, `medium`, `large` density scales.\n- **Direction:** `vertical` (blocks above a label+unit meta zone and source\n  row) or `horizontal` (all segments on one row).\n- **Stacking & alignment:** vertical readouts arrange label/unit `inline`\n  or `stacked`; stacked readouts align `vertical` (right), `left`, or\n  `center`.\n- **Priority:** `regular`/`enhanced` colour emphasis; per-value `weight`\n  is independent of colour.\n- **Setpoint interactions:** `always-visible`, `flip-flop` (emphasis swap),\n  and `pop-up` (fade-out at setpoint), plus the `touching` focus state.\n- **Data quality:** `low-integrity`/`invalid` styling, per block or for the\n  whole readout, combinable with `alert`.\n- **Alert frame:** optional `alert` wrapper (caution/warning/alarm/level).\n- **Source:** plain text by default; opt-in `picker` (context menu) or\n  `flyout` interactivity via `srcOptions.interaction`.\n- **Formatting:** shared `fractionDigits`, width reservation via\n  `maxDigits` and per-segment `hintedZeros`; a `null` value renders a dash.\n\n### Usage Guidelines\nUse for stand-alone instrument readouts and readouts embedded in\ninstruments. Prefer `<obc-readout-list-item>` for dense rows in\nlists/tables (label left, value right) and `<obc-readout-list>` for\nauto-aligned groups of rows.",
+          "description": "`<obc-readout>` – An instrument readout: a value with optional setpoint,\nadvice, label, unit, and source, arranged vertically or horizontally.\n\nA layout sibling of `<obc-readout-list-item>` built from the same\ncap-height \"readout building blocks\" (`obc-readout-block`): dynamic data is\npassed as top-level primitives (`value`, `setpoint`, `advice`, `label`,\n`unit`, `src`), global layout/format via top-level props (`size`,\n`priority`, `direction`, `stacking`, `alignment`, `hasDegree`,\n`dataQuality`, `alert`, …) and per-block tweaks via one object per block\n(`valueOptions`, `setpointOptions`, `adviceOptions`, `unitOptions`,\n`srcOptions`).\n\n### Features\n- **Building blocks:** value, optional setpoint, and optional advice\n  segments, each cap-height-aligned and able to reserve a stable width.\n- **Sizes:** `small`, `medium`, `large` density scales.\n- **Direction:** `vertical` (blocks above a label+unit meta zone and source\n  row) or `horizontal` (all segments on one row).\n- **Stacking & alignment:** vertical readouts arrange label/unit `inline`\n  or `stacked`; stacked readouts align `vertical` (right), `left`, or\n  `center`.\n- **Priority:** `regular`/`enhanced` colour emphasis; per-value `weight`\n  is independent of colour.\n- **Setpoint interactions:** `always-visible`, `flip-flop` (emphasis swap),\n  and `pop-up` (fade-out at setpoint), plus the `touching` focus state.\n- **Data quality:** `low-integrity`/`invalid` styling, per block or for the\n  whole readout, combinable with `alert`.\n- **Alert frame:** optional `alert` wrapper (caution/warning/alarm/level).\n- **Source:** plain text by default; opt-in `picker` (context menu) or\n  `flyout` interactivity via `srcOptions.interaction`.\n- **Formatting:** shared `fractionDigits`, width reservation via\n  `maxDigits` and per-segment `hintedZeros`; a `null` value renders a dash.\n- **Text values:** `valueType=\"text\"` renders `value` verbatim (e.g.\n  `\"Auto\"`) instead of formatting it as a number.\n\n### Usage Guidelines\nUse for stand-alone instrument readouts and readouts embedded in\ninstruments. Prefer `<obc-readout-list-item>` for dense rows in\nlists/tables (label left, value right) and `<obc-readout-list>` for\nauto-aligned groups of rows.",
           "name": "ObcReadout",
           "slots": [
             {
@@ -92213,11 +92335,21 @@
               "kind": "field",
               "name": "value",
               "type": {
-                "text": "number | null"
+                "text": "number | string | null"
               },
               "default": "null",
+              "description": "The value; `null` renders a dash. A number by default, or text when\nvalueType is `text`.",
               "attribute": "value"
             },
+            {
+              "kind": "field",
+              "name": "valueType",
+              "type": {
+                "text": "ReadoutValueType"
+              },
+              "description": "How value is interpreted. `number` (default) formats it via\n`fractionDigits`; `text` renders it verbatim and ignores the numeric\nformat options. Passing text while this is `number` throws.",
+              "attribute": "valueType"
+            },
             {
               "kind": "field",
               "name": "off",
@@ -92337,6 +92469,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "attribute": "fractionDigits"
             },
             {
@@ -92346,6 +92479,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "attribute": "maxDigits"
             },
             {
@@ -92766,7 +92900,7 @@
                 {
                   "name": "config",
                   "type": {
-                    "text": "{\n    variant: ReadoutBlockVariant;\n    value: number | null | undefined;\n    valueSize: ObcTextboxSize;\n    enhanced: boolean;\n    weight: ObcTextboxFontWeight;\n    hintedZeros: boolean;\n    spaceReserver?: string;\n    off?: boolean;\n    hasDegree?: boolean;\n    hasIcon?: boolean;\n    touching?: boolean;\n    hidePhase?: ReadoutBlockHidePhase;\n    dataQuality?: ReadoutBlockDataQuality;\n    alert?: false | AlertFrameConfig;\n    /**\n     * Invisible width-reserving duplicate (see\n     * {@link renderSetpointWidthReserve}): skips the forwarded icon slot so\n     * the visible block keeps the slotted content — the block's default\n     * marker has the same fixed tier width.\n     */\n    ghost?: boolean;\n  }"
+                    "text": "{\n    variant: ReadoutBlockVariant;\n    value: number | string | null | undefined;\n    /** Only the value block is ever text; setpoint / advice stay numeric. */\n    valueType?: ReadoutValueType;\n    valueSize: ObcTextboxSize;\n    enhanced: boolean;\n    weight: ObcTextboxFontWeight;\n    hintedZeros: boolean;\n    spaceReserver?: string;\n    off?: boolean;\n    hasDegree?: boolean;\n    hasIcon?: boolean;\n    touching?: boolean;\n    hidePhase?: ReadoutBlockHidePhase;\n    dataQuality?: ReadoutBlockDataQuality;\n    alert?: false | AlertFrameConfig;\n    /**\n     * Invisible width-reserving duplicate (see\n     * {@link renderSetpointWidthReserve}): skips the forwarded icon slot so\n     * the visible block keeps the slotted content — the block's default\n     * marker has the same fixed tier width.\n     */\n    ghost?: boolean;\n  }"
                   }
                 }
               ]
@@ -93127,11 +93261,20 @@
             {
               "name": "value",
               "type": {
-                "text": "number | null"
+                "text": "number | string | null"
               },
               "default": "null",
+              "description": "The value; `null` renders a dash. A number by default, or text when\nvalueType is `text`.",
               "fieldName": "value"
             },
+            {
+              "name": "valueType",
+              "type": {
+                "text": "ReadoutValueType"
+              },
+              "description": "How value is interpreted. `number` (default) formats it via\n`fractionDigits`; `text` renders it verbatim and ignores the numeric\nformat options. Passing text while this is `number` throws.",
+              "fieldName": "valueType"
+            },
             {
               "name": "off",
               "type": {
@@ -93237,6 +93380,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "fieldName": "fractionDigits"
             },
             {
@@ -93245,6 +93389,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Also formats the numeric setpoint / advice blocks, which stay numeric\neven when the value is text.",
               "fieldName": "maxDigits"
             },
             {
@@ -93324,6 +93469,14 @@
             "module": "../../components/textbox/textbox.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadoutValueType",
+          "declaration": {
+            "name": "ReadoutValueType",
+            "module": "./readout-formatters.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReadoutBlockState",
@@ -98661,6 +98814,12 @@
               "name": "renderLoadingArc",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "renderInnerRingLine",
+              "privacy": "private",
+              "description": "Thin outline on the track band's inner edge, always shown per the\ndesign's track face. Drawn on the overlay because the watch paints its\nband bars over the ring circles, which would swallow a watch-side line."
+            },
             {
               "kind": "method",
               "name": "renderPropeller",

package/dist/building-blocks/readout-block/readout-block.d.ts

@@ -1,10 +1,12 @@
 import { LitElement } from 'lit';
 import { ObcTextboxSize, ObcTextboxFontWeight, ObcTextboxAlignment } from '../../components/textbox/textbox.js';
+import { ReadoutValueType } from '../../navigation-instruments/readout/readout-formatters.js';
 import { AlertFrameConfig } from '../../components/alert-frame/alert-frame.js';
 import '../../components/textbox/textbox.js';
 import '../../icons/icon-input-right.js';
 import '../../icons/icon-notification-advice.js';
 export { ObcTextboxSize, ObcTextboxFontWeight, ObcTextboxAlignment, } from '../../components/textbox/textbox.js';
+export { ReadoutValueType } from '../../navigation-instruments/readout/readout-formatters.js';
 /**
  * Semantic variant of the block. Drives the default marker icon and the
  * colour token; the layout is identical across variants.
@@ -56,6 +58,9 @@ export declare enum ReadoutBlockHidePhase {
  * role default), an optional trailing degree glyph, an `off`/unavailable text
  * state, per-block data-quality and an optional per-block alert frame.
  *
+ * Setting `valueType` to `text` renders `value` verbatim (e.g.
+ * `"Auto"`) instead of a formatted number.
+ *
  * This is a building block used inside `obc-readout-list-item` (and, in a future
  * refactor, inside `obc-readout`); it is not normally used on its own. Colour is
  * inherited from the host context (the parent sets the role colour), so the
@@ -75,8 +80,17 @@ export declare enum ReadoutBlockHidePhase {
 export declare class ObcReadoutBlock extends LitElement {
     /** Semantic variant (value / setpoint / advice). */
     variant: ReadoutBlockVariant;
-    /** The numeric value; `null`/`undefined` renders a dash. */
-    value: number | null;
+    /**
+     * The value; `null`/`undefined` renders a dash. A number by default, or text
+     * when {@link valueType} is `text`.
+     */
+    value: number | string | null;
+    /**
+     * How {@link 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;
     /** Density tier — icon size, gap, degree tier. */
     size: ReadoutBlockSize;
     /**
@@ -93,11 +107,20 @@ export declare class ObcReadoutBlock extends LitElement {
     hasDegree: boolean;
     /** Show the leading marker-icon container (always on for setpoint/advice). */
     hasIcon: boolean;
-    /** Number of fraction digits. */
+    /**
+     * Number of fraction digits.
+     * @availableWhen valueType==number
+     */
     fractionDigits: number;
-    /** Integer digits to reserve / hint (independent of `fractionDigits`). */
+    /**
+     * Integer digits to reserve / hint (independent of `fractionDigits`).
+     * @availableWhen valueType==number
+     */
     maxDigits: number;
-    /** Render muted leading zeros filling the integer part to `maxDigits`. */
+    /**
+     * Render muted leading zeros filling the integer part to `maxDigits`.
+     * @availableWhen valueType==number
+     */
     hintedZeros: boolean;
     /** Explicit longest string to reserve width for (e.g. `"0000.0"`). */
     spaceReserver?: string;
@@ -135,6 +158,7 @@ export declare class ObcReadoutBlock extends LitElement {
      * block's colour.
      */
     private renderDegreeGlyph;
+    protected willUpdate(changed: Map<string, unknown>): void;
     render(): import('lit-html').HTMLTemplateResult;
     static styles: import('lit').CSSResult;
 }

package/dist/building-blocks/readout-block/readout-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readout-block.d.ts","sourceRoot":"","sources":["../../../src/building-blocks/readout-block/readout-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAgD,MAAM,KAAK,CAAC;AAK9E,OAAO,qCAAqC,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,iCAAiC,CAAC;AACzC,OAAO,yCAAyC,CAAC;AAMjD,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;GAMG;AACH,oBAAY,mBAAmB;IAC7B,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED;;;;GAIG;AACH,oBAAY,uBAAuB;IACjC,YAAY,kBAAkB;IAC9B,OAAO,YAAY;CACpB;AAED;;;GAGG;AACH,oBAAY,qBAAqB;IAC/B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,oDAAoD;IAC1B,OAAO,EAAE,mBAAmB,CAC1B;IAE5B,4DAA4D;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtD,kDAAkD;IACxB,IAAI,EAAE,gBAAgB,CAA0B;IAE1E;;;;OAIG;IACuB,SAAS,CAAC,EAAE,cAAc,CAAC;IAErD,uCAAuC;IACZ,QAAQ,UAAS;IAE5C,6EAA6E;IACnD,MAAM,EAAE,oBAAoB,CACvB;IAE/B,yDAAyD;IAC9B,SAAS,UAAS;IAE7C,8EAA8E;IACnD,OAAO,UAAS;IAE3C,iCAAiC;IACP,cAAc,SAAK;IAE7C,0EAA0E;IAChD,SAAS,SAAK;IAExC,0EAA0E;IAC/C,WAAW,UAAS;IAE/C,sEAAsE;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEjD,0EAA0E;IAC/C,GAAG,UAAS;IAEvC,qCAAqC;IACX,OAAO,SAAS;IAE1C,8DAA8D;IACpC,SAAS,EAAE,mBAAmB,CAC5B;IAE5B,oDAAoD;IAC1B,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAKhE,kEAAkE;IACxC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAS;IAEpE,4EAA4E;IACjD,QAAQ,UAAS;IAE5C,0EAA0E;IAChD,SAAS,EAAE,qBAAqB,CAC7B;IAEpB,OAAO,CAAC,eAAe,CAAS;IAEzC,OAAO,KAAK,iBAAiB,GAY5B;IAED,OAAO,KAAK,oBAAoB,GAM/B;IAED,2EAA2E;IAC3E,OAAO,KAAK,YAAY,GASvB;IAED;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,gBAAgB,CAMtB;IAEF,OAAO,CAAC,UAAU;IAsBlB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiBhB,MAAM;IAiEf,OAAgB,MAAM,0BAA6B;CACpD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,eAAe,CAAC;KACtC;CACF"}
+{"version":3,"file":"readout-block.d.ts","sourceRoot":"","sources":["../../../src/building-blocks/readout-block/readout-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAgD,MAAM,KAAK,CAAC;AAK9E,OAAO,qCAAqC,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,iCAAiC,CAAC;AACzC,OAAO,yCAAyC,CAAC;AACjD,OAAO,EAML,gBAAgB,EAEjB,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,4DAA4D,CAAC;AAE5F;;;;;;GAMG;AACH,oBAAY,mBAAmB;IAC7B,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED;;;;GAIG;AACH,oBAAY,uBAAuB;IACjC,YAAY,kBAAkB;IAC9B,OAAO,YAAY;CACpB;AAED;;;GAGG;AACH,oBAAY,qBAAqB;IAC/B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,oDAAoD;IAC1B,OAAO,EAAE,mBAAmB,CAC1B;IAE5B;;;OAGG;IACuB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAQ;IAE/D;;;;OAIG;IACuB,SAAS,EAAE,gBAAgB,CAC3B;IAE1B,kDAAkD;IACxB,IAAI,EAAE,gBAAgB,CAA0B;IAE1E;;;;OAIG;IACuB,SAAS,CAAC,EAAE,cAAc,CAAC;IAErD,uCAAuC;IACZ,QAAQ,UAAS;IAE5C,6EAA6E;IACnD,MAAM,EAAE,oBAAoB,CACvB;IAE/B,yDAAyD;IAC9B,SAAS,UAAS;IAE7C,8EAA8E;IACnD,OAAO,UAAS;IAE3C;;;OAGG;IACuB,cAAc,SAAK;IAE7C;;;OAGG;IACuB,SAAS,SAAK;IAExC;;;OAGG;IACwB,WAAW,UAAS;IAE/C,sEAAsE;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEjD,0EAA0E;IAC/C,GAAG,UAAS;IAEvC,qCAAqC;IACX,OAAO,SAAS;IAE1C,8DAA8D;IACpC,SAAS,EAAE,mBAAmB,CAC5B;IAE5B,oDAAoD;IAC1B,WAAW,CAAC,EAAE,uBAAuB,CAAC;IAKhE,kEAAkE;IACxC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAS;IAEpE,4EAA4E;IACjD,QAAQ,UAAS;IAE5C,0EAA0E;IAChD,SAAS,EAAE,qBAAqB,CAC7B;IAEpB,OAAO,CAAC,eAAe,CAAS;IAEzC,OAAO,KAAK,iBAAiB,GAY5B;IAED,OAAO,KAAK,oBAAoB,GAM/B;IAED,2EAA2E;IAC3E,OAAO,KAAK,YAAY,GASvB;IAED;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,gBAAgB,CAMtB;IAEF,OAAO,CAAC,UAAU;IAsBlB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;cAiBN,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYzD,MAAM;IA+Ef,OAAgB,MAAM,0BAA6B;CACpD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,eAAe,CAAC;KACtC;CACF"}

package/dist/building-blocks/readout-block/readout-block.js

@@ -6,7 +6,7 @@ import { customElement } from "../../decorator.js";
 import { ObcTextboxFontWeight, ObcTextboxAlignment, ObcTextboxSize } from "../../components/textbox/textbox.js";
 import "../../icons/icon-input-right.js";
 import "../../icons/icon-notification-advice.js";
-import { formatNumericValue, readoutFormattedInteger } from "../../navigation-instruments/readout/readout-formatters.js";
+import { ReadoutValueType, assertReadoutValueType, resolveReadoutNumericValue, resolveReadoutTextValue, formatNumericValue, readoutFormattedInteger } from "../../navigation-instruments/readout/readout-formatters.js";
 import { wrapWithAlertFrame } from "../../components/alert-frame/alert-frame.js";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -46,6 +46,7 @@ let ObcReadoutBlock = class extends LitElement {
     super(...arguments);
     this.variant = "value";
     this.value = null;
+    this.valueType = ReadoutValueType.number;
     this.size = "small";
     this.enhanced = false;
     this.weight = ObcTextboxFontWeight.regular;
@@ -152,14 +153,23 @@ let ObcReadoutBlock = class extends LitElement {
       </span>
     `;
   }
+  willUpdate(changed) {
+    super.willUpdate(changed);
+    assertReadoutValueType("obc-readout-block", this.value, this.valueType);
+  }
   render() {
     const valueSize = this.resolvedValueSize;
     const formatOptions = this.numericFormatOptions;
-    const valueForFormat = this.value ?? void 0;
-    const text = this.off ? this.offText : formatNumericValue(valueForFormat, formatOptions);
-    const hintCount = this.off || !this.hintedZeros || valueForFormat === void 0 || valueForFormat < 0 ? 0 : Math.max(this.maxDigits - readoutFormattedInteger(text), 0);
+    const isTextMode = this.valueType === ReadoutValueType.text;
+    const valueForFormat = resolveReadoutNumericValue(
+      this.value,
+      this.valueType
+    );
+    const textValue = resolveReadoutTextValue(this.value, this.valueType);
+    const text = this.off ? this.offText : isTextMode ? textValue ?? "-" : formatNumericValue(valueForFormat, formatOptions);
+    const hintCount = this.off || isTextMode || !this.hintedZeros || valueForFormat === void 0 || valueForFormat < 0 ? 0 : Math.max(this.maxDigits - readoutFormattedInteger(text), 0);
     const hinted = hintCount > 0 ? "0".repeat(hintCount) : "";
-    const reserver = this.hintedZeros ? this.reserverText : this.widerReserver(this.spaceReserver, this.reserverText);
+    const reserver = isTextMode ? this.spaceReserver ?? "" : this.hintedZeros ? this.reserverText : this.widerReserver(this.spaceReserver, this.reserverText);
     const block = html`
       <div
         class=${classMap({
@@ -201,8 +211,11 @@ __decorateClass([
   property({ type: String })
 ], ObcReadoutBlock.prototype, "variant", 2);
 __decorateClass([
-  property({ type: Number })
+  property({ type: String })
 ], ObcReadoutBlock.prototype, "value", 2);
+__decorateClass([
+  property({ type: String })
+], ObcReadoutBlock.prototype, "valueType", 2);
 __decorateClass([
   property({ type: String })
 ], ObcReadoutBlock.prototype, "size", 2);
@@ -268,6 +281,7 @@ export {
   ReadoutBlockDataQuality,
   ReadoutBlockHidePhase,
   ReadoutBlockSize,
-  ReadoutBlockVariant
+  ReadoutBlockVariant,
+  ReadoutValueType
 };
 //# sourceMappingURL=readout-block.js.map