@oicl/openbridge-webcomponents 2.0.0-next.87 → 2.0.0-next.89

package/custom-elements.json

@@ -38223,6 +38223,548 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/building-blocks/readout-block/readout-block.ts",
+      "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.",
+          "name": "ObcReadoutBlock",
+          "cssParts": [
+            {
+              "description": "The block container (carries role / tone / data-quality).",
+              "name": "block"
+            },
+            {
+              "description": "The number + degree group.",
+              "name": "block-content"
+            },
+            {
+              "description": "The `obc-textbox` rendering the number.",
+              "name": "block-text"
+            },
+            {
+              "description": "The leading marker-icon container.",
+              "name": "block-icon"
+            },
+            {
+              "description": "The trailing degree-glyph column.",
+              "name": "degree"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Replaces the role's default marker icon.",
+              "name": "icon"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "ReadoutBlockVariant"
+              },
+              "description": "Semantic variant (value / setpoint / advice).",
+              "attribute": "variant"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "The numeric value; `null`/`undefined` renders a dash.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "ReadoutBlockSize"
+              },
+              "description": "Density tier — icon size, gap, degree tier.",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "valueSize",
+              "type": {
+                "text": "ObcTextboxSize | undefined"
+              },
+              "description": "Resolved number-typography size. When unset it is derived from `size`\n(small→s, medium→m, large→l), so a parent that de-emphasises a block (e.g.\na secondary setpoint) can pass a smaller size without changing the tier.",
+              "attribute": "valueSize"
+            },
+            {
+              "kind": "field",
+              "name": "enhanced",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Accent (in-command) colour tone.",
+              "attribute": "enhanced"
+            },
+            {
+              "kind": "field",
+              "name": "weight",
+              "type": {
+                "text": "ObcTextboxFontWeight"
+              },
+              "description": "Number font weight (regular / semibold / bold); colour is independent.",
+              "attribute": "weight"
+            },
+            {
+              "kind": "field",
+              "name": "hasDegree",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render the trailing cap-height degree glyph (`°`).",
+              "attribute": "hasDegree"
+            },
+            {
+              "kind": "field",
+              "name": "hasIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show the leading marker-icon container (always on for setpoint/advice).",
+              "attribute": "hasIcon"
+            },
+            {
+              "kind": "field",
+              "name": "fractionDigits",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Number of fraction digits.",
+              "attribute": "fractionDigits"
+            },
+            {
+              "kind": "field",
+              "name": "maxDigits",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Integer digits to reserve / hint (independent of `fractionDigits`).",
+              "attribute": "maxDigits"
+            },
+            {
+              "kind": "field",
+              "name": "hintedZeros",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render muted leading zeros filling the integer part to `maxDigits`.",
+              "attribute": "hintedZeros"
+            },
+            {
+              "kind": "field",
+              "name": "spaceReserver",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Explicit longest string to reserve width for (e.g. `\"0000.0\"`).",
+              "attribute": "spaceReserver"
+            },
+            {
+              "kind": "field",
+              "name": "off",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render `offText` instead of a number (e.g. equipment powered down).",
+              "attribute": "off"
+            },
+            {
+              "kind": "field",
+              "name": "offText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'OFF'",
+              "description": "Text shown when `off` is true.",
+              "attribute": "offText"
+            },
+            {
+              "kind": "field",
+              "name": "alignment",
+              "type": {
+                "text": "ObcTextboxAlignment"
+              },
+              "description": "Text alignment of the number within its reserved width.",
+              "attribute": "alignment"
+            },
+            {
+              "kind": "field",
+              "name": "dataQuality",
+              "type": {
+                "text": "ReadoutBlockDataQuality | undefined"
+              },
+              "description": "Per-block measurement quality (outline chip).",
+              "attribute": "dataQuality"
+            },
+            {
+              "kind": "field",
+              "name": "alert",
+              "type": {
+                "text": "boolean | AlertFrameConfig"
+              },
+              "default": "false",
+              "description": "Per-block alert frame; nests inside any parent alert frame.",
+              "attribute": "alert"
+            },
+            {
+              "kind": "field",
+              "name": "touching",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Setpoint focus (touch) state — only meaningful for `role=\"setpoint\"`.",
+              "attribute": "touching"
+            },
+            {
+              "kind": "field",
+              "name": "hidePhase",
+              "type": {
+                "text": "ReadoutBlockHidePhase"
+              },
+              "description": "Setpoint pop-up fade phase — only meaningful for `role=\"setpoint\"`.",
+              "attribute": "hidePhase"
+            },
+            {
+              "kind": "field",
+              "name": "hasAssignedIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "resolvedValueSize",
+              "type": {
+                "text": "ObcTextboxSize"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "numericFormatOptions",
+              "type": {
+                "text": "ReadoutNumericFormatOptions"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "reserverText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Widest possible value string for width reservation (e.g. `\"000.0\"`).",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "widerReserver",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "explicit",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                },
+                {
+                  "name": "derived",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Effective width reserver: the wider of the explicit `spaceReserver` and the\n`maxDigits`/`fractionDigits`-derived reserve, so an explicit reserver can\nnever reserve *less* than the formatted value needs. Under tabular-nums the\nrendered width is proportional to character count, so \"wider\" compares length."
+            },
+            {
+              "kind": "method",
+              "name": "dataQualityClasses",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Record<string, boolean>"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "onIconSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "renderIcon",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderDegreeGlyph",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "size",
+                  "type": {
+                    "text": "ObcTextboxSize"
+                  }
+                }
+              ],
+              "description": "A cap-height `°` column whose width scales with the number size. Inherits the\nblock's colour."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "variant",
+              "type": {
+                "text": "ReadoutBlockVariant"
+              },
+              "description": "Semantic variant (value / setpoint / advice).",
+              "fieldName": "variant"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "The numeric value; `null`/`undefined` renders a dash.",
+              "fieldName": "value"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "ReadoutBlockSize"
+              },
+              "description": "Density tier — icon size, gap, degree tier.",
+              "fieldName": "size"
+            },
+            {
+              "name": "valueSize",
+              "type": {
+                "text": "ObcTextboxSize | undefined"
+              },
+              "description": "Resolved number-typography size. When unset it is derived from `size`\n(small→s, medium→m, large→l), so a parent that de-emphasises a block (e.g.\na secondary setpoint) can pass a smaller size without changing the tier.",
+              "fieldName": "valueSize"
+            },
+            {
+              "name": "enhanced",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Accent (in-command) colour tone.",
+              "fieldName": "enhanced"
+            },
+            {
+              "name": "weight",
+              "type": {
+                "text": "ObcTextboxFontWeight"
+              },
+              "description": "Number font weight (regular / semibold / bold); colour is independent.",
+              "fieldName": "weight"
+            },
+            {
+              "name": "hasDegree",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render the trailing cap-height degree glyph (`°`).",
+              "fieldName": "hasDegree"
+            },
+            {
+              "name": "hasIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show the leading marker-icon container (always on for setpoint/advice).",
+              "fieldName": "hasIcon"
+            },
+            {
+              "name": "fractionDigits",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Number of fraction digits.",
+              "fieldName": "fractionDigits"
+            },
+            {
+              "name": "maxDigits",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Integer digits to reserve / hint (independent of `fractionDigits`).",
+              "fieldName": "maxDigits"
+            },
+            {
+              "name": "hintedZeros",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render muted leading zeros filling the integer part to `maxDigits`.",
+              "fieldName": "hintedZeros"
+            },
+            {
+              "name": "spaceReserver",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Explicit longest string to reserve width for (e.g. `\"0000.0\"`).",
+              "fieldName": "spaceReserver"
+            },
+            {
+              "name": "off",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Render `offText` instead of a number (e.g. equipment powered down).",
+              "fieldName": "off"
+            },
+            {
+              "name": "offText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'OFF'",
+              "description": "Text shown when `off` is true.",
+              "fieldName": "offText"
+            },
+            {
+              "name": "alignment",
+              "type": {
+                "text": "ObcTextboxAlignment"
+              },
+              "description": "Text alignment of the number within its reserved width.",
+              "fieldName": "alignment"
+            },
+            {
+              "name": "dataQuality",
+              "type": {
+                "text": "ReadoutBlockDataQuality | undefined"
+              },
+              "description": "Per-block measurement quality (outline chip).",
+              "fieldName": "dataQuality"
+            },
+            {
+              "name": "alert",
+              "type": {
+                "text": "boolean | AlertFrameConfig"
+              },
+              "default": "false",
+              "description": "Per-block alert frame; nests inside any parent alert frame.",
+              "fieldName": "alert"
+            },
+            {
+              "name": "touching",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Setpoint focus (touch) state — only meaningful for `role=\"setpoint\"`.",
+              "fieldName": "touching"
+            },
+            {
+              "name": "hidePhase",
+              "type": {
+                "text": "ReadoutBlockHidePhase"
+              },
+              "description": "Setpoint pop-up fade phase — only meaningful for `role=\"setpoint\"`.",
+              "fieldName": "hidePhase"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "obc-readout-block",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ObcTextboxSize",
+          "declaration": {
+            "name": "ObcTextboxSize",
+            "module": "../../components/textbox/textbox.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ObcTextboxFontWeight",
+          "declaration": {
+            "name": "ObcTextboxFontWeight",
+            "module": "../../components/textbox/textbox.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ObcTextboxAlignment",
+          "declaration": {
+            "name": "ObcTextboxAlignment",
+            "module": "../../components/textbox/textbox.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ObcReadoutBlock",
+          "declaration": {
+            "name": "ObcReadoutBlock",
+            "module": "src/building-blocks/readout-block/readout-block.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "obc-readout-block",
+          "declaration": {
+            "name": "ObcReadoutBlock",
+            "module": "src/building-blocks/readout-block/readout-block.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/accordion-card/accordion-card.ts",
@@ -76494,7 +77036,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-gauge-radial>` — Configurable radial gauge for generic numeric values.\n\n`ObcGaugeRadial` is a thin wrapper around `<obc-instrument-radial>` that adds\ndomain-independent value-to-angle mapping with automatic range handling for\nboth positive-only and bipolar (negative-to-positive) scales. It inherits a\nfull setpoint property bundle from SetpointMixin, including\nauto at-setpoint detection, dual-marker adjustment preview, and deadband\ntuning — no manual wiring required.\n\n## Features\n\n- **Three display types**: `filled` (solid arc), `bar` (thinner arc), and\n  `needle` (pointer indicator) via the `type` property.\n- **Sector sweep**: `sector` selects the arc span (`270`, `180`, `90-left`, or `90-right`).\n  The configured `minValue..maxValue` always spans the full sector. For the\n  centered sectors (`270`, `180`) a symmetric range places `0` at 12 o'clock;\n  for `90-left`/`90-right` the range midpoint sits at the middle of the quadrant.\n- **Setpoint via mixin**: `setpoint`, `newSetpoint`, `touching`,\n  `autoAtSetpointDeadband`, `setpointOverride`, and all other setpoint\n  properties are provided by `SetpointMixin` and forwarded to the inner\n  `<obc-instrument-radial>`.\n- **Advice zones**: Pass an array of GaugeRadialAdvice objects to\n  render caution/alert arcs on the gauge. Not shown on the `90-left` /\n  `90-right` sectors.\n\n## Usage Guidelines\n\n- Set `minValue` / `maxValue` to define the scale range.\n- Use `priority` to switch between regular and enhanced color palettes.\n- Provide `primaryTickmarkInterval` and `secondaryTickmarkInterval` to\n  control tickmark density.\n- Enable `showLabels` to show numeric labels at primary tickmarks.\n- Enable `hasReadout` with optional `label` and `unit`. Layout depends on `sector`\n  and `type`: **270** filled/bar — value at center + a label-only `meta` row in\n  the bottom gap (two separate readouts); **180** filled/bar — a single centered\n  stack (value + label/unit) at the bottom; **270** needle — bottom stack;\n  **180** needle — no readout; **90-left** / **90-right** filled/bar — corner\n  readout in a square host; **90** needle — no readout.\n\n## Best Practices\n\n- Prefer `SetpointMixin` properties (`setpoint`, `touching`, etc.) over\n  any legacy aliases — the mixin is the single source of truth.\n- Keep domain-specific logic (units, formatting) in the parent view; this\n  component is intentionally unit-agnostic.\n\n## Example\n\n```html\n<obc-gauge-radial\n  value=\"42\"\n  minValue=\"0\"\n  maxValue=\"100\"\n  type=\"filled\"\n  priority=\"enhanced\"\n  showLabels\n  primaryTickmarkInterval=\"25\"\n  secondaryTickmarkInterval=\"5\"\n  setpoint=\"60\"\n></obc-gauge-radial>\n```",
+          "description": "`<obc-gauge-radial>` — Configurable radial gauge for generic numeric values.\n\n`ObcGaugeRadial` is a thin wrapper around `<obc-instrument-radial>` that adds\ndomain-independent value-to-angle mapping with automatic range handling for\nboth positive-only and bipolar (negative-to-positive) scales. It inherits a\nfull setpoint property bundle from SetpointMixin, including\nauto at-setpoint detection, dual-marker adjustment preview, and deadband\ntuning — no manual wiring required.\n\n## Features\n\n- **Three display types**: `filled` (solid arc), `bar` (thinner arc), and\n  `needle` (pointer indicator) via the `type` property.\n- **Sector sweep**: `sector` selects the arc span (`270`, `180`, `90-left`, or `90-right`).\n  The configured `minValue..maxValue` always spans the full sector. For the\n  centered sectors (`270`, `180`) a symmetric range places `0` at 12 o'clock;\n  for `90-left`/`90-right` the range midpoint sits at the middle of the quadrant.\n- **Setpoint via mixin**: `setpoint`, `newSetpoint`, `touching`,\n  `autoAtSetpointDeadband`, `setpointOverride`, and all other setpoint\n  properties are provided by `SetpointMixin` and forwarded to the inner\n  `<obc-instrument-radial>`.\n- **Advice zones**: Pass an array of GaugeRadialAdvice objects to\n  render caution/alert arcs on the gauge. Not shown on the `90-left` /\n  `90-right` sectors.\n- **Alignment**: The host always fills its container and the dial shrinks to\n  fit the smaller of the available width/height, so a short, wide (or tall,\n  narrow) container leaves slack on one axis. `horizontalAlignment`\n  (`left` | `center` | `right`) and `verticalAlignment`\n  (`top` | `center` | `bottom`) position the dial within that slack; both\n  default to `center`.\n\n## Usage Guidelines\n\n- Set `minValue` / `maxValue` to define the scale range.\n- Use `priority` to switch between regular and enhanced color palettes.\n- Provide `primaryTickmarkInterval` and `secondaryTickmarkInterval` to\n  control tickmark density.\n- Enable `showLabels` to show numeric labels at primary tickmarks.\n- Enable `hasReadout` with optional `label` and `unit`. Layout depends on `sector`\n  and `type`: **270** filled/bar — value at center + a label-only `meta` row in\n  the bottom gap (two separate readouts); **180** filled/bar — a single centered\n  stack (value + label/unit) at the bottom; **270** needle — bottom stack;\n  **180** needle — no readout; **90-left** / **90-right** filled/bar — corner\n  readout in a square host; **90** needle — no readout.\n\n## Best Practices\n\n- Prefer `SetpointMixin` properties (`setpoint`, `touching`, etc.) over\n  any legacy aliases — the mixin is the single source of truth.\n- Keep domain-specific logic (units, formatting) in the parent view; this\n  component is intentionally unit-agnostic.\n\n## Example\n\n```html\n<obc-gauge-radial\n  value=\"42\"\n  minValue=\"0\"\n  maxValue=\"100\"\n  type=\"filled\"\n  priority=\"enhanced\"\n  showLabels\n  primaryTickmarkInterval=\"25\"\n  secondaryTickmarkInterval=\"5\"\n  setpoint=\"60\"\n></obc-gauge-radial>\n```",
           "name": "ObcGaugeRadial",
           "members": [
             {
@@ -76620,6 +77162,24 @@
               "attribute": "sector",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "horizontalAlignment",
+              "type": {
+                "text": "GaugeRadialHorizontalAlignment"
+              },
+              "description": "Horizontal placement of the dial when the host is wider than the dial\n(e.g. a short, wide container shrinks the dial to fit the height, leaving\nhorizontal slack). Default `center`.",
+              "attribute": "horizontalAlignment"
+            },
+            {
+              "kind": "field",
+              "name": "verticalAlignment",
+              "type": {
+                "text": "GaugeRadialVerticalAlignment"
+              },
+              "description": "Vertical placement of the dial when the host is taller than the dial\n(e.g. a tall, narrow container shrinks the dial to fit the width, leaving\nvertical slack). Default `center`.",
+              "attribute": "verticalAlignment"
+            },
             {
               "kind": "field",
               "name": "hasReadout",
@@ -76999,6 +77559,22 @@
               },
               "fieldName": "sector"
             },
+            {
+              "name": "horizontalAlignment",
+              "type": {
+                "text": "GaugeRadialHorizontalAlignment"
+              },
+              "description": "Horizontal placement of the dial when the host is wider than the dial\n(e.g. a short, wide container shrinks the dial to fit the height, leaving\nhorizontal slack). Default `center`.",
+              "fieldName": "horizontalAlignment"
+            },
+            {
+              "name": "verticalAlignment",
+              "type": {
+                "text": "GaugeRadialVerticalAlignment"
+              },
+              "description": "Vertical placement of the dial when the host is taller than the dial\n(e.g. a tall, narrow container shrinks the dial to fit the width, leaving\nvertical slack). Default `center`.",
+              "fieldName": "verticalAlignment"
+            },
             {
               "name": "hasReadout",
               "type": {
@@ -85291,9 +85867,19 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Render the value as the literal \"OFF\" (e.g. equipment powered down). Affects the value only.",
+              "description": "Render the value as `offText` (e.g. equipment powered down). Affects the value only.",
               "attribute": "off"
             },
+            {
+              "kind": "field",
+              "name": "offText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'OFF'",
+              "description": "Text shown in place of the value when `off` is true.",
+              "attribute": "offText"
+            },
             {
               "kind": "field",
               "name": "hasSetpoint",
@@ -85463,6 +86049,17 @@
               },
               "attribute": "srcOptions"
             },
+            {
+              "kind": "field",
+              "name": "showDebugOverlay",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Development aid: outline the readout building blocks (red), the degree\ncolumns (blue) and the degree spacer (green) so reserver widths / alignment\nare visible. Off by default.",
+              "attribute": "showDebugOverlay",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "deferredSetpointHidePhase",
@@ -85685,41 +86282,6 @@
                 }
               ]
             },
-            {
-              "kind": "field",
-              "name": "reserverText",
-              "type": {
-                "text": "string"
-              },
-              "privacy": "private",
-              "description": "Widest possible value string for width reservation (e.g. `\"000.0\"`).",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "widerReserver",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "explicit",
-                  "type": {
-                    "text": "string | undefined"
-                  }
-                },
-                {
-                  "name": "derived",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Effective width reserver for a numeric block: the wider of the explicit\n`spaceReserver` and the `maxDigits`/`fractionDigits`-derived reserve, so an\nexplicit reserver can never reserve *less* than the formatted value needs.\nUnder tabular-nums the rendered width is proportional to character count, so\n\"wider\" compares string length."
-            },
             {
               "kind": "method",
               "name": "dataQualityClasses",
@@ -85741,21 +86303,22 @@
             },
             {
               "kind": "method",
-              "name": "renderIcon",
+              "name": "renderForwardedIcon",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "TemplateResult | typeof nothing"
+                  "text": "TemplateResult"
                 }
               },
               "parameters": [
                 {
-                  "name": "role",
+                  "name": "variant",
                   "type": {
-                    "text": "BlockRole"
+                    "text": "ReadoutBlockVariant"
                   }
                 }
-              ]
+              ],
+              "description": "Forward the matching list-item icon slot into the block's single `icon`\nslot. The variant's default marker lives in `obc-readout-block` and shows\nwhen nothing is assigned here (an empty forwarded slot flattens to nothing)."
             },
             {
               "kind": "method",
@@ -85770,7 +86333,7 @@
                 {
                   "name": "config",
                   "type": {
-                    "text": "{\n    role: BlockRole;\n    value: number | null | undefined;\n    size: ObcTextboxSize;\n    enhanced: boolean;\n    weight: ObcTextboxFontWeight;\n    hintedZeros: boolean;\n    spaceReserver?: string;\n    off?: boolean;\n    hasDegree?: boolean;\n    extraClasses?: Record<string, boolean>;\n    dataQuality?: ReadoutListItemDataQuality;\n    alert?: false | AlertFrameConfig;\n  }"
+                    "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  }"
                   }
                 }
               ]
@@ -85958,9 +86521,18 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Render the value as the literal \"OFF\" (e.g. equipment powered down). Affects the value only.",
+              "description": "Render the value as `offText` (e.g. equipment powered down). Affects the value only.",
               "fieldName": "off"
             },
+            {
+              "name": "offText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'OFF'",
+              "description": "Text shown in place of the value when `off` is true.",
+              "fieldName": "offText"
+            },
             {
               "name": "hasSetpoint",
               "type": {
@@ -86109,6 +86681,15 @@
                 "text": "ReadoutSrcOptions | undefined"
               },
               "fieldName": "srcOptions"
+            },
+            {
+              "name": "showDebugOverlay",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Development aid: outline the readout building blocks (red), the degree\ncolumns (blue) and the degree spacer (green) so reserver widths / alignment\nare visible. Off by default.",
+              "fieldName": "showDebugOverlay"
             }
           ],
           "superclass": {
@@ -86128,6 +86709,22 @@
             "module": "../../components/textbox/textbox.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadoutListItemSize",
+          "declaration": {
+            "name": "ReadoutListItemSize",
+            "module": "src/navigation-instruments/readout-list-item/readout-list-item.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ReadoutListItemDataQuality",
+          "declaration": {
+            "name": "ReadoutListItemDataQuality",
+            "module": "src/navigation-instruments/readout-list-item/readout-list-item.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "ObcReadoutListItem",
@@ -86146,6 +86743,120 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/navigation-instruments/readout-list/readout-list.ts",
+      "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.",
+          "name": "ObcReadoutList",
+          "cssParts": [
+            {
+              "description": "The vertical stack container.",
+              "name": "list"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The `<obc-readout-list-item>` rows.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "showDebugOverlay",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Development aid: outline each row's readout building blocks (red), degree\ncolumns (blue) and degree spacer (green) so the reserved column widths are\nvisible. Propagated to every row. Off by default.",
+              "attribute": "showDebugOverlay",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "mutationObserver",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "items",
+              "type": {
+                "text": "ObcReadoutListItem[]"
+              },
+              "privacy": "private",
+              "description": "The `obc-readout-list-item` rows, including those nested in wrapper elements.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "align",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Recompute and apply the shared column reservers across all rows. Call this\nafter updating rows via JS properties only (attribute/DOM changes are picked\nup automatically)."
+            },
+            {
+              "kind": "method",
+              "name": "observeChildren",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleSlotChange",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "showDebugOverlay",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Development aid: outline each row's readout building blocks (red), degree\ncolumns (blue) and degree spacer (green) so the reserved column widths are\nvisible. Propagated to every row. Off by default.",
+              "fieldName": "showDebugOverlay"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "obc-readout-list",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ObcReadoutList",
+          "declaration": {
+            "name": "ObcReadoutList",
+            "module": "src/navigation-instruments/readout-list/readout-list.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "obc-readout-list",
+          "declaration": {
+            "name": "ObcReadoutList",
+            "module": "src/navigation-instruments/readout-list/readout-list.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/navigation-instruments/readout-setpoint/readout-setpoint.ts",