@oicl/openbridge-webcomponents 2.0.0-next.128 → 2.0.0-next.129

package/custom-elements.json

@@ -41270,6 +41270,25 @@
               "description": "Text alignment of the number within its reserved width.",
               "attribute": "alignment"
             },
+            {
+              "kind": "field",
+              "name": "category",
+              "type": {
+                "text": "ReadoutAdviceCategory"
+              },
+              "description": "Semantic category of an advice block — picks the default marker icon and\nthe active styling. Only meaningful for `variant=\"advice\"`.",
+              "attribute": "category"
+            },
+            {
+              "kind": "field",
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "The advice is triggered: the marker swaps to its filled/status icon and\nthe number takes the category's triggered styling (SemiBold for\nregular/optimal/eco, active text colour for the alert categories). Only\nmeaningful for `variant=\"advice\"`.",
+              "attribute": "active"
+            },
             {
               "kind": "field",
               "name": "dataQuality",
@@ -41415,6 +41434,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "adviceFallbackIcon",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The advice marker for the current category / triggered state. Resting\ncategories carry a neutral outline glyph (tinted via `currentColor`);\ntriggered alert categories swap to the filled IEC status icon, whose\ncolours are fixed fills and ignore `currentColor` by design."
+            },
             {
               "kind": "method",
               "name": "renderDegreeGlyph",
@@ -41573,6 +41603,23 @@
               "description": "Text alignment of the number within its reserved width.",
               "fieldName": "alignment"
             },
+            {
+              "name": "category",
+              "type": {
+                "text": "ReadoutAdviceCategory"
+              },
+              "description": "Semantic category of an advice block — picks the default marker icon and\nthe active styling. Only meaningful for `variant=\"advice\"`.",
+              "fieldName": "category"
+            },
+            {
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "The advice is triggered: the marker swaps to its filled/status icon and\nthe number takes the category's triggered styling (SemiBold for\nregular/optimal/eco, active text colour for the alert categories). Only\nmeaningful for `variant=\"advice\"`.",
+              "fieldName": "active"
+            },
             {
               "name": "dataQuality",
               "type": {
@@ -92765,6 +92812,14 @@
               },
               "attribute": "adviceOptions"
             },
+            {
+              "kind": "field",
+              "name": "labelOptions",
+              "type": {
+                "text": "ReadoutLabelOptions | undefined"
+              },
+              "attribute": "labelOptions"
+            },
             {
               "kind": "field",
               "name": "unitOptions",
@@ -92909,6 +92964,15 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "isEqualSize",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "isPopUp",
@@ -92995,6 +93059,26 @@
               "description": "Value font weight passes straight to obc-textbox; regular when unset. Colour is separate.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "labelSize",
+              "type": {
+                "text": "ObcTextboxSize"
+              },
+              "privacy": "private",
+              "description": "Label size: `xs` for dense list rows unless overridden (see ReadoutLabelOptions).",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "labelWeight",
+              "type": {
+                "text": "ObcTextboxFontWeight"
+              },
+              "privacy": "private",
+              "description": "Label weight: SemiBold only for enhanced (in-command) rows, regular\notherwise — the designer reduced the amount of semibold in the interface\n(Figma 6.1 review).",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "setpointWeight",
@@ -93074,7 +93158,7 @@
                 {
                   "name": "config",
                   "type": {
-                    "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  }"
+                    "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    /** Advice-only: semantic category + triggered state. */\n    category?: ReadoutAdviceCategory;\n    active?: boolean;\n  }"
                   }
                 }
               ]
@@ -93217,6 +93301,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "renderSourceBlock",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "description": "The source text plus its optional state chip and deviation line. The\nplain (regular, no-deviation) case renders the bare textbox — byte-for-\nbyte the pre-6.1 output; a state or a deviation wraps it in the\n`.source-block` stack."
+            },
             {
               "kind": "method",
               "name": "renderTrailingSource",
@@ -93448,6 +93543,13 @@
               },
               "fieldName": "adviceOptions"
             },
+            {
+              "name": "labelOptions",
+              "type": {
+                "text": "ReadoutLabelOptions | undefined"
+              },
+              "fieldName": "labelOptions"
+            },
             {
               "name": "unitOptions",
               "type": {
@@ -93497,6 +93599,14 @@
             "module": "../readout/readout-formatters.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadoutAdviceCategory",
+          "declaration": {
+            "name": "ReadoutAdviceCategory",
+            "module": "../../building-blocks/readout-block/readout-block.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReadoutListItemSize",
@@ -93654,6 +93764,10 @@
           "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": [
+            {
+              "description": "Icon before the label/unit meta zone.",
+              "name": "leading-icon"
+            },
             {
               "description": "Icon before the value.",
               "name": "value-icon"
@@ -93784,6 +93898,7 @@
               "type": {
                 "text": "ReadoutSize | undefined"
               },
+              "description": "Density tier. Applies to the vertical direction only — the horizontal\narrangement exists in the large tier alone (Figma 6.1: it relies on the\nlabel+unit stack aligning with the L-size value caps), so `size` is\nignored when `direction` is `horizontal`.",
               "attribute": "size"
             },
             {
@@ -93825,6 +93940,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Render the cap-height degree glyph (`°`) after the ACTUAL VALUE only —\nthe setpoint / advice blocks never carry one (Figma 6.1 review: the unit\nis written once for the readout, and the degree follows the same rule).",
               "attribute": "hasDegree"
             },
             {
@@ -93836,6 +93952,16 @@
               "default": "false",
               "attribute": "hasDegreeSpacer"
             },
+            {
+              "kind": "field",
+              "name": "hasLeadingIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show the `leading-icon` slot before the label/unit meta zone.",
+              "attribute": "hasLeadingIcon"
+            },
             {
               "kind": "field",
               "name": "fractionDigits",
@@ -93897,6 +94023,14 @@
               },
               "attribute": "adviceOptions"
             },
+            {
+              "kind": "field",
+              "name": "labelOptions",
+              "type": {
+                "text": "ReadoutLabelOptions | undefined"
+              },
+              "attribute": "labelOptions"
+            },
             {
               "kind": "field",
               "name": "unitOptions",
@@ -94109,6 +94243,15 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "isEqualSize",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "isPopUp",
@@ -94205,6 +94348,26 @@
               "description": "Value font weight passes straight to obc-textbox; regular when unset. Colour is separate.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "labelSize",
+              "type": {
+                "text": "ObcTextboxSize"
+              },
+              "privacy": "private",
+              "description": "Label size. The Figma 6.1 title block defaults large readouts to `s` — a\nscannable label should not sit at the smallest permitted size — while\nsmall/medium tiers stay `xs`; `labelOptions.size` overrides either way\n(per the design team, for context / density / secondary instruments).\nThe `s` default was confirmed by the design team (2026-08-17).\nTODO(designer): the medium-tier default is unverified in the new sheets\n(only XS and S exist on the title's size axis).",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "labelWeight",
+              "type": {
+                "text": "ObcTextboxFontWeight"
+              },
+              "privacy": "private",
+              "description": "Label weight: SemiBold only for enhanced (in-command) readouts, regular\notherwise — the designer reduced the amount of semibold in the interface\n(Figma 6.1 review).",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "setpointWeight",
@@ -94284,7 +94447,7 @@
                 {
                   "name": "config",
                   "type": {
-                    "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  }"
+                    "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    /** Advice-only: semantic category + triggered state. */\n    category?: ReadoutAdviceCategory;\n    active?: boolean;\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  }"
                   }
                 }
               ]
@@ -94438,6 +94601,25 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "renderSourceBlock",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "src",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The plain (non-interactive) source: the textbox plus its optional state\nchip and deviation line. The regular no-deviation case renders the bare\ntextbox — the pre-6.1 output; a state or deviation wraps it in the\n`.source-block` stack. The picker / flyout button variants do not carry\nstate / deviation yet — TODO(designer): undefined in the 6.1 sheets."
+            },
             {
               "kind": "method",
               "name": "renderSource",
@@ -94447,7 +94629,7 @@
                   "text": "TemplateResult | typeof nothing"
                 }
               },
-              "description": "The source row (vertical) / segment (horizontal), with its auto divider."
+              "description": "The source row (vertical) / segment (horizontal). Only the horizontal\ndirection draws an auto divider before the source — the Figma 6.1 review\n(node 95:24490 \"remove dividers\", 95:26891 \"Source-divider are there\")\nkeeps the vertical source row divider-free while the horizontal flow\nseparates the source with a vertical rule."
             },
             {
               "kind": "method",
@@ -94712,6 +94894,7 @@
               "type": {
                 "text": "ReadoutSize | undefined"
               },
+              "description": "Density tier. Applies to the vertical direction only — the horizontal\narrangement exists in the large tier alone (Figma 6.1: it relies on the\nlabel+unit stack aligning with the L-size value caps), so `size` is\nignored when `direction` is `horizontal`.",
               "fieldName": "size"
             },
             {
@@ -94748,6 +94931,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Render the cap-height degree glyph (`°`) after the ACTUAL VALUE only —\nthe setpoint / advice blocks never carry one (Figma 6.1 review: the unit\nis written once for the readout, and the degree follows the same rule).",
               "fieldName": "hasDegree"
             },
             {
@@ -94758,6 +94942,15 @@
               "default": "false",
               "fieldName": "hasDegreeSpacer"
             },
+            {
+              "name": "hasLeadingIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show the `leading-icon` slot before the label/unit meta zone.",
+              "fieldName": "hasLeadingIcon"
+            },
             {
               "name": "fractionDigits",
               "type": {
@@ -94812,6 +95005,13 @@
               },
               "fieldName": "adviceOptions"
             },
+            {
+              "name": "labelOptions",
+              "type": {
+                "text": "ReadoutLabelOptions | undefined"
+              },
+              "fieldName": "labelOptions"
+            },
             {
               "name": "unitOptions",
               "type": {
@@ -94861,6 +95061,22 @@
             "module": "./readout-formatters.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadoutAdviceCategory",
+          "declaration": {
+            "name": "ReadoutAdviceCategory",
+            "module": "../../building-blocks/readout-block/readout-block.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ReadoutSourceState",
+          "declaration": {
+            "name": "ReadoutSourceState",
+            "module": "../readout-list-item/readout-list-item.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReadoutBlockState",
@@ -94893,6 +95109,14 @@
             "module": "../readout-list-item/readout-list-item.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "ReadoutLabelOptions",
+          "declaration": {
+            "name": "ReadoutLabelOptions",
+            "module": "../readout-list-item/readout-list-item.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ReadoutReserverOptions",

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

@@ -49,7 +49,11 @@ const componentStyle = css`* {
 }
 
 .hinted-zero {
-  color: var(--obc-readout-block-hinted-color, var(--element-inactive-color));
+  /* Figma 6.1 review (node 95:24490): hinted zeros are lighter than the old
+     inactive tone and NEVER inherit the value's weight — a bold value must not
+     bold its hints. */
+  color: var(--obc-readout-block-hinted-color, var(--element-disabled-color));
+  font-weight: var(--global-typography-generic-l-font-weight-regular);
 }
 
 /* ---------- Text colours (overridable via custom properties) ----------
@@ -124,6 +128,27 @@ const componentStyle = css`* {
   color: var(--obc-readout-block-advice-color, var(--element-neutral-color));
 }
 
+/* ---------- Advice categories (Figma 6.1 Readout-block-advice) ----------
+ * Resting categories are neutral; \`advice-active\` (triggered) tints the
+ * regular/optimal/eco diamond via currentColor (the IEC status icons of the
+ * alert categories carry fixed fills and ignore this) and switches the alert
+ * categories' number to the active text colour. */
+
+.block-advice.advice-active.advice-optimal .block-icon {
+  color: var(--element-neutral-enhanced-color);
+}
+
+.block-advice.advice-active.advice-eco .block-icon {
+  color: var(--base-mint-400);
+}
+
+.block-advice.advice-active.advice-caution,
+.block-advice.advice-active.advice-warning,
+.block-advice.advice-active.advice-alarm,
+.block-advice.advice-active.advice-running {
+  color: var(--element-active-color);
+}
+
 /* ---------- Per-block data quality ----------
  * Uses \`outline\` (not \`border\`) so the chip never shifts the block's width — the
  * value stays column-aligned across rows. */
@@ -188,39 +213,48 @@ const componentStyle = css`* {
 
 /* ---------- Size tiers ----------
  * Public small/medium/large map to the design token regular/medium/large
- * tiers. */
+ * tiers. The icon↔number gap follows the tier; the marker ICON size follows
+ * the block's rendered number size (\`value-size-*\`) instead — Figma 6.1
+ * (Readout-block-setpoint, review node 95:26891): a de-emphasised S setpoint
+ * carries the 16px arrow while an emphasised L one carries the 24px arrow,
+ * even though both sit in the same large-tier readout.
+ * \`--obc-readout-block-icon-size\` is the consumer escape hatch. */
 
 .block.size-small {
   gap: var(--instrument-components-readout-new-general-regular-icon-gap);
 }
 
-.size-small .block-icon {
-  inline-size: var(
-    --instrument-components-readout-new-general-regular-icon-size
-  );
-  block-size: var(
-    --instrument-components-readout-new-general-regular-icon-size
-  );
-}
-
 .block.size-medium {
   gap: var(--instrument-components-readout-new-general-medium-icon-gap);
 }
 
-.size-medium .block-icon {
-  inline-size: var(
+.block.size-large {
+  gap: var(--instrument-components-readout-new-general-large-icon-gap);
+}
+
+.block.value-size-xs,
+.block.value-size-s {
+  --_block-icon-size: var(
+    --instrument-components-readout-new-general-regular-icon-size
+  );
+}
+
+.block.value-size-m {
+  --_block-icon-size: var(
     --instrument-components-readout-new-general-medium-icon-size
   );
-  block-size: var(--instrument-components-readout-new-general-medium-icon-size);
 }
 
-.block.size-large {
-  gap: var(--instrument-components-readout-new-general-large-icon-gap);
+.block.value-size-l,
+.block.value-size-xl {
+  --_block-icon-size: var(
+    --instrument-components-readout-new-general-large-icon-size
+  );
 }
 
-.size-large .block-icon {
-  inline-size: var(--instrument-components-readout-new-general-large-icon-size);
-  block-size: var(--instrument-components-readout-new-general-large-icon-size);
+.block .block-icon {
+  inline-size: var(--obc-readout-block-icon-size, var(--_block-icon-size));
+  block-size: var(--obc-readout-block-icon-size, var(--_block-icon-size));
 }
 `;
 export {

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

@@ -1 +1 @@
-{"version":3,"file":"readout-block.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"readout-block.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

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

@@ -5,6 +5,15 @@ 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';
+import '../../icons/icon-notification-advice-active.js';
+import '../../icons/icon-caution-google.js';
+import '../../icons/icon-caution-color-iec.js';
+import '../../icons/icon-warning-unacknowledged-outlined.js';
+import '../../icons/icon-warning-unacknowledged-iec.js';
+import '../../icons/icon-alarm.js';
+import '../../icons/icon-alarm-unacknowledged-iec.js';
+import '../../icons/icon-running.js';
+import '../../icons/icon-running-color-iec.js';
 export { ObcTextboxSize, ObcTextboxFontWeight, ObcTextboxAlignment, } from '../../components/textbox/textbox.js';
 export { ReadoutValueType } from '../../navigation-instruments/readout/readout-formatters.js';
 /**
@@ -39,6 +48,31 @@ export declare enum ReadoutBlockDataQuality {
     lowIntegrity = "low-integrity",
     invalid = "invalid"
 }
+/**
+ * Semantic category of an advice block (Figma 6.1 "Readout-block-advice"
+ * Value axis). Drives the default marker icon and — while {@link
+ * ObcReadoutBlock.active} — the triggered styling:
+ * - `regular` / `optimal` / `eco`: the advice diamond; triggered renders the
+ *   filled diamond (tinted enhanced-blue / mint for optimal / eco) and a
+ *   SemiBold number.
+ * - `caution` / `warning` / `alarm` / `running`: the matching neutral outline
+ *   icon; triggered swaps in the filled IEC status icon and the active text
+ *   colour.
+ *
+ * TODO(designer): the optimal / eco triggered tint covers the whole diamond
+ * glyph — the Figma icon tints only the inner plus, which needs a two-tone
+ * icon asset; and the advice "Enhanced" state (indent background chip) is not
+ * implemented yet. Both flagged as "may change" in the 6.1 review.
+ */
+export declare enum ReadoutAdviceCategory {
+    regular = "regular",
+    optimal = "optimal",
+    eco = "eco",
+    caution = "caution",
+    warning = "warning",
+    alarm = "alarm",
+    running = "running"
+}
 /**
  * Pop-up fade phase for a setpoint block. Driven by the parent's setpoint
  * interaction state machine; only meaningful for `role="setpoint"`.
@@ -140,6 +174,20 @@ export declare class ObcReadoutBlock extends LitElement {
     offText: string;
     /** Text alignment of the number within its reserved width. */
     alignment: ObcTextboxAlignment;
+    /**
+     * Semantic category of an advice block — picks the default marker icon and
+     * the {@link active} styling. Only meaningful for `variant="advice"`.
+     * @availableWhen variant==advice
+     */
+    category: ReadoutAdviceCategory;
+    /**
+     * The advice is triggered: the marker swaps to its filled/status icon and
+     * the number takes the category's triggered styling (SemiBold for
+     * regular/optimal/eco, active text colour for the alert categories). Only
+     * meaningful for `variant="advice"`.
+     * @availableWhen variant==advice
+     */
+    active: boolean;
     /** Per-block measurement quality (outline chip). */
     dataQuality?: ReadoutBlockDataQuality;
     /** Per-block alert frame; nests inside any parent alert frame. */
@@ -179,6 +227,13 @@ export declare class ObcReadoutBlock extends LitElement {
     private dataQualityClasses;
     private onIconSlotChange;
     private renderIcon;
+    /**
+     * The advice marker for the current category / triggered state. Resting
+     * categories carry a neutral outline glyph (tinted via `currentColor`);
+     * triggered alert categories swap to the filled IEC status icon, whose
+     * colours are fixed fills and ignore `currentColor` by design.
+     */
+    private adviceFallbackIcon;
     /**
      * A cap-height `°` column whose width scales with the number size. Inherits the
      * block's colour.

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":"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"}
+{"version":3,"file":"readout-block.d.ts","sourceRoot":"","sources":["../../../src/building-blocks/readout-block/readout-block.ts"],"names":[],"mappings":"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"}