@oicl/openbridge-webcomponents 2.0.0-next.154 → 2.0.0-next.156

package/custom-elements.json

@@ -41569,7 +41569,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-transmitter-button>` – The pressable readout chip used as the core of a\ntransmitter on a process diagram.\n\nThe value content (leading icon, optional advice and setpoint segments,\nvalue, unit) is laid out inline. The value, advice and setpoint segments all\nshare one numeric format, so they support fixed-width values and muted\nleading zeros identically. The leading icon is slotted so the consumer\nprovides the type-specific content.\n\n### Features / Variants\n- **`value`** – white, bordered box showing an icon, value and unit. Opt into a\n  leading advice segment with `hasAdvice`/`adviceValue` and a setpoint segment\n  with `hasSetPoint`/`setpointValue`.\n- **`tag`** – a static rounded pill showing a short identifier (e.g. `TT`)\n  from the `label` property, with no live value.\n- **`size`** – `regular`, `medium` or `large`, scaling the value text, the icon\n  glyph and the advice/setpoint segments. The unit stays at a fixed size across\n  all sizes.\n- **Formatting** – `fractionDigits` sets the decimal precision, `maxDigits`\n  reserves a number of integer digits, and `hintedZeros` renders the reserved\n  leading positions as muted zeros (e.g. `0012.3`). The sign never consumes\n  a reserved position (`-0012.3`), so a negative value is one character\n  wider than a positive one; `hasSignSpacer` reserves the sign column so\n  the width does not change across zero. All three segments share this\n  formatting — it is `obc-readout-block`'s.\n- **Missing values** – `value`, `adviceValue` and `setpointValue` each render\n  dashes when they are `NaN`, `null` or `undefined`; with `hintedZeros` the\n  dashes fill the whole reserved width (e.g. `---.-`).\n\n### Usage Guidelines\nUse as a building block for `<obc-transmitter>`; it is the part that carries\nthe measured value or the tag identifier. Slot in the type-specific icon; the\nadvice and setpoint segments are value-driven and read-only.\n\n### Slots\n| Slot Name | Conditions                    | Purpose                        |\n|-----------|-------------------------------|--------------------------------|\n| icon      | `value` variant and `hasIcon` | Leading icon beside the value. |",
+          "description": "`<obc-transmitter-button>` – The pressable readout chip at the core of a\ntransmitter: a bordered button around one reading.\n\nThe reading is a label-less `<obc-readout-list-item>` (the Figma \"automation\nvalue\"): leading icon, optional advice and setpoint, value, optional degree\nand unit, all rendered by the readout family. The leading icon is slotted so\nthe consumer provides the type-specific content.\n\n### Features / Variants\n- **`value`** – bordered chip showing an icon, value and unit. Opt into a\n  leading advice segment with `hasAdvice`/`adviceValue`, a setpoint segment\n  with `hasSetPoint`/`setpointValue`, and a degree column before the unit\n  with `hasDegree`.\n- **`tag`** – a static rounded pill showing a short identifier (e.g. `TT`)\n  from the `label` property, with no live value.\n- **`size`** – `regular`, `medium` or `large`, the list item's `small`,\n  `medium` and `large` tiers: the value text, the icon and the advice/setpoint\n  segments scale, the unit stays extra small.\n- **Formatting** – `fractionDigits` sets the decimal precision, `maxDigits`\n  reserves a number of integer digits, and `hintedZeros` renders the reserved\n  leading positions as muted zeros (e.g. `0012.3`). The sign never consumes\n  a reserved position (`-0012.3`), so a negative value is one character\n  wider than a positive one; `hasSignSpacer` reserves the sign column so\n  the width does not change across zero. All three segments share this\n  formatting — it is `obc-readout-block`'s.\n- **Missing values** – `value`, `adviceValue` and `setpointValue` each render\n  dashes when they are `NaN`, `null` or `undefined`; with `hintedZeros` the\n  dashes fill the whole reserved width (e.g. `---.-`).\n\n### Usage Guidelines\nUse as a building block for `<obc-transmitter>` and `<obc-transmitter-stack>`;\nit is the part that carries the measured value or the tag identifier. Slot in\nthe type-specific icon; the advice and setpoint segments are value-driven and\nread-only.\n\n**TODO(designer):** the hit area is the visible chip, 24 px high at `regular`:\nat the WCAG 2.5.8 floor of 24 px, below the 48 px touch-target token. A\n48 px target would overlap the id tag, the leader line and neighbouring\n`<obc-transmitter-stack>` segments, so the size needs a design decision.\n\n### Slots\n| Slot Name | Conditions                    | Purpose                        |\n|-----------|-------------------------------|--------------------------------|\n| icon      | `value` variant and `hasIcon` | Leading icon beside the value. |",
           "name": "ObcTransmitterButton",
           "slots": [
             {
@@ -41649,6 +41649,16 @@
               "description": "Reserve a minus-sign column on every segment, filled by the real sign only while a value is negative, so the width does not change across zero.",
               "attribute": "hasSignSpacer"
             },
+            {
+              "kind": "field",
+              "name": "hasDegree",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show a degree column between the value and the unit (e.g. `12.3°` then `C`).",
+              "attribute": "hasDegree"
+            },
             {
               "kind": "field",
               "name": "hasIcon",
@@ -41706,42 +41716,23 @@
             },
             {
               "kind": "field",
-              "name": "isTag",
-              "privacy": "private",
-              "readonly": true
+              "name": "idTag",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Identifier appended to the button's accessible name only (e.g. `#0001`); the parent transmitter draws the visible tag outside the button, where it cannot join the name.",
+              "attribute": "idTag"
             },
             {
-              "kind": "method",
-              "name": "renderBlock",
+              "kind": "field",
+              "name": "isTag",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "variant",
-                  "type": {
-                    "text": "ReadoutBlockVariant"
-                  }
-                },
-                {
-                  "name": "value",
-                  "type": {
-                    "text": "number | null | undefined"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "renderAdvice",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderSetpoint",
-              "privacy": "private"
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "renderContent",
+              "name": "renderReading",
               "privacy": "private"
             }
           ],
@@ -41809,6 +41800,15 @@
               "description": "Reserve a minus-sign column on every segment, filled by the real sign only while a value is negative, so the width does not change across zero.",
               "fieldName": "hasSignSpacer"
             },
+            {
+              "name": "hasDegree",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show a degree column between the value and the unit (e.g. `12.3°` then `C`).",
+              "fieldName": "hasDegree"
+            },
             {
               "name": "hasIcon",
               "type": {
@@ -41857,6 +41857,15 @@
               "default": "''",
               "description": "Short tag identifier shown in the `tag` variant (e.g. `TT`).",
               "fieldName": "label"
+            },
+            {
+              "name": "idTag",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Identifier appended to the button's accessible name only (e.g. `#0001`); the parent transmitter draws the visible tag outside the button, where it cannot join the name.",
+              "fieldName": "idTag"
             }
           ],
           "superclass": {
@@ -41886,13 +41895,169 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/automation/transmitter-stack/transmitter-stack.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<obc-transmitter-stack>` – Several transmitter readings side by side in one\njoined chip, attached to a line by a single leader line.\n\nEach entry of `values` renders an `<obc-transmitter-button>` segment with its\nown icon, value, unit and id tag. The segments take equal widths, set by the\nwidest reading, and share their borders. Positioning and the leader line\nfollow `<obc-transmitter>`.\n\n### Features / Variants\n- **`orientation`** – `top`, `right`, `bottom`, `left`; the edge the leader\n  line attaches to. `top` places the id tags above the chip.\n- **Values** – `value` and `unit` per segment. `idTag` adds a label row under\n  every segment once any value has one, so the chip stays aligned.\n- **Formatting** – per value `fractionDigits` (default `1`), `maxDigits`\n  (default `0`), `hintedZeros`, `hasSignSpacer` and `hasDegree`, formatted like\n  `<obc-transmitter-button>`. An omitted key takes its default; a key set to\n  `null`, `undefined` or `NaN` renders the reading as the unavailable dash.\n- **Icons** – `iconSlotName` projects the light-DOM element with that slot\n  name as the segment's icon; names must be unique within the stack. The\n  name is chosen per value, so it carries no `@slot` tag (the wrapper\n  generator needs literal names).\n- **Accessible name** – each segment is a native button named by its\n  reading, unit and `idTag`; the visible tag is hidden from assistive\n  technology so it is not read twice.\n- **Empty** – with no `values` nothing renders, leader line included.\n\n### Usage Guidelines\nUse when one source reports several readings that share one leader line. For\na single reading, a tag pill or a trend graph, use `<obc-transmitter>`. Each\nsegment's hit area is `<obc-transmitter-button>`'s chip (24 px high), below\nthe 48 px touch-target token; see its design note.\n\n### Slots\n| Slot Name        | Conditions                      | Purpose                       |\n|------------------|---------------------------------|-------------------------------|\n| `<iconSlotName>` | a value declares `iconSlotName` | Icon in that value's segment. |",
+          "name": "ObcTransmitterStack",
+          "members": [
+            {
+              "kind": "field",
+              "name": "orientation",
+              "type": {
+                "text": "TransmitterOrientation"
+              },
+              "description": "Edge of the chip the leader line attaches to.",
+              "attribute": "orientation"
+            },
+            {
+              "kind": "field",
+              "name": "lineType",
+              "type": {
+                "text": "LineType | undefined"
+              },
+              "default": "undefined",
+              "description": "Line the transmitter sits on; offsets the leader line by half its stroke.",
+              "attribute": "lineType"
+            },
+            {
+              "kind": "field",
+              "name": "values",
+              "type": {
+                "text": "TransmitterStackValue[]"
+              },
+              "default": "[]",
+              "description": "One segment per entry, in order.",
+              "attribute": "values"
+            },
+            {
+              "kind": "method",
+              "name": "handleValueClick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "TransmitterStackValue"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderValue",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "TransmitterStackValue"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "hasIdTags",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "name": "value-click",
+              "type": {
+                "text": "CustomEvent<TransmitterStackValueClickDetail>"
+              },
+              "description": "Fired when a segment is activated, with its value and index."
+            },
+            {
+              "description": "Fired when any segment is clicked; `value-click` tells which.",
+              "name": "click"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "orientation",
+              "type": {
+                "text": "TransmitterOrientation"
+              },
+              "description": "Edge of the chip the leader line attaches to.",
+              "fieldName": "orientation"
+            },
+            {
+              "name": "lineType",
+              "type": {
+                "text": "LineType | undefined"
+              },
+              "default": "undefined",
+              "description": "Line the transmitter sits on; offsets the leader line by half its stroke.",
+              "fieldName": "lineType"
+            },
+            {
+              "name": "values",
+              "type": {
+                "text": "TransmitterStackValue[]"
+              },
+              "default": "[]",
+              "description": "One segment per entry, in order.",
+              "fieldName": "values"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "obc-transmitter-stack",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ObcTransmitterStack",
+          "declaration": {
+            "name": "ObcTransmitterStack",
+            "module": "src/automation/transmitter-stack/transmitter-stack.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "obc-transmitter-stack",
+          "declaration": {
+            "name": "ObcTransmitterStack",
+            "module": "src/automation/transmitter-stack/transmitter-stack.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/automation/transmitter/transmitter.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-transmitter>` – A readout label that attaches to a line on a process\ndiagram via a leader line, showing a measured value, a tag identifier, or a\nvalue paired with a trend graph.\n\nPositioning (orientation + leader line) follows `<obc-automation-readout>`.\nThe value chip is an `<obc-transmitter-button>` and the trend is an\n`<obc-indicator-graph>` with its area fill enabled.\n\n### Features / Variants\n- **`type`** – `indicator` (tag pill), `value` (icon/value/unit), or value\n  paired with a `horizontal-graph` (beside) or `vertical-graph` (below).\n- **`orientation`** – `top`, `right`, `bottom`, `left`; controls which edge\n  the leader line attaches to.\n- **Segments** – opt into a leading advice segment with `hasAdvice`/\n  `adviceValue` and a setpoint segment with `hasSetPoint`/`setpointValue`;\n  both are read-only and shown in the value chip for non-`indicator` types.\n- **`hasAlert`** – wraps the whole transmitter in an alarm `<obc-alert-frame>`.\n- **Formatting** – `fractionDigits`, `maxDigits`, `hintedZeros` and\n  `hasSignSpacer` are forwarded to the value chip to control decimal\n  precision, muted leading-zero padding (e.g. `0012.3`) and the sign\n  column. The advice and setpoint segments reuse the same formatting.\n  `value`, `adviceValue` and `setpointValue` render dashes when they are\n  `NaN`, `null` or `undefined`.\n\n### Slots\n| Slot Name | Conditions              | Purpose                         |\n|-----------|-------------------------|---------------------------------|\n| icon      | value/graph + `hasIcon` | Leading icon in the value chip. |",
+          "description": "`<obc-transmitter>` – A readout label that attaches to a line via a leader\nline, showing a measured value, a tag identifier, or a value paired with a\ntrend graph.\n\nPositioning (orientation + leader line) follows `<obc-automation-readout>`.\nThe value chip is an `<obc-transmitter-button>` and the trend is an\n`<obc-indicator-graph>` with its area fill enabled.\n\n### Features / Variants\n- **`type`** – `indicator` (tag pill), `value` (icon/value/unit), or value\n  paired with a `horizontal-graph` (beside) or `vertical-graph` (below).\n- **`orientation`** – `top`, `right`, `bottom`, `left`; controls which edge\n  the leader line attaches to.\n- **Segments** – opt into a leading advice segment with `hasAdvice`/\n  `adviceValue` and a setpoint segment with `hasSetPoint`/`setpointValue`;\n  both are read-only and shown in the value chip for non-`indicator` types.\n- **`hasAlert`** – wraps the whole transmitter in an alarm `<obc-alert-frame>`.\n- **Formatting** – `fractionDigits`, `maxDigits`, `hintedZeros` and\n  `hasSignSpacer` are forwarded to the value chip to control decimal\n  precision, muted leading-zero padding (e.g. `0012.3`) and the sign\n  column. The advice and setpoint segments reuse the same formatting.\n  `hasDegree` adds a degree column between the value and the unit.\n  `value`, `adviceValue` and `setpointValue` render dashes when they are\n  `NaN`, `null` or `undefined`.\n\n### Slots\n| Slot Name | Conditions              | Purpose                         |\n|-----------|-------------------------|---------------------------------|\n| icon      | value/graph + `hasIcon` | Leading icon in the value chip. |",
           "name": "ObcTransmitter",
           "slots": [
             {
@@ -41981,6 +42146,16 @@
               "description": "Reserve a minus-sign column on every segment, filled by the real sign only while a value is negative, so the chip's width does not change across zero.",
               "attribute": "hasSignSpacer"
             },
+            {
+              "kind": "field",
+              "name": "hasDegree",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show a degree column between the value and the unit (e.g. `12.3°` then `C`).",
+              "attribute": "hasDegree"
+            },
             {
               "kind": "field",
               "name": "size",
@@ -42080,12 +42255,6 @@
               "privacy": "private",
               "readonly": true
             },
-            {
-              "kind": "field",
-              "name": "lineOffset",
-              "privacy": "private",
-              "readonly": true
-            },
             {
               "kind": "method",
               "name": "renderButton",
@@ -42179,6 +42348,15 @@
               "description": "Reserve a minus-sign column on every segment, filled by the real sign only while a value is negative, so the chip's width does not change across zero.",
               "fieldName": "hasSignSpacer"
             },
+            {
+              "name": "hasDegree",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show a degree column between the value and the unit (e.g. `12.3°` then `C`).",
+              "fieldName": "hasDegree"
+            },
             {
               "name": "size",
               "type": {
@@ -42272,6 +42450,22 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "TransmitterOrientation",
+          "declaration": {
+            "name": "TransmitterOrientation",
+            "module": "./transmitter-shared.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "transmitterLeaderOffset",
+          "declaration": {
+            "name": "transmitterLeaderOffset",
+            "module": "./transmitter-shared.js"
+          }
+        },
         {
           "kind": "js",
           "name": "ObcTransmitter",
@@ -87091,7 +87285,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`obc-user-button` – A compact, circular button for representing a user via icon or initials.\n\nDisplays either a user icon or user initials inside a circular button, with optional label text. Commonly used for user profile access, account switching, or avatar actions in toolbars and navigation. The button supports multiple visual styles and can be rendered as a static (non-interactive) element.\n\nAppears as a button by default, but switches to a non-interactive div when the `static` property is set.\n\n## Features\n- **Variants:**\n  - `icon`: Shows a user icon (default, fallback if initials are invalid or missing).\n  - `initials`: Shows up to two uppercase initials (falls back to icon if input is empty or longer than two characters).\n- **Style Types:**\n  - `flat`: Minimal, flat appearance (default).\n  - `normal`: Outlined with background and border.\n  - `selected`: Highlighted to indicate selection or active state.\n- **Static Mode:**\n  - Set `static` to render as a non-interactive element for use in read-only or decorative contexts.\n- **Disabled State:**\n  - Set `disabled` to visually and functionally disable the button.\n- **Custom Icon Slot:**\n  - Provide a custom icon via the `icon` slot when using the `icon` variant.\n- **Label Support:**\n  - Optional `label` property displays text next to the button (not shown in static mode).\n\n## Usage Guidelines\nUse `obc-user-button` to represent a user in navigation bars, toolbars, or menus where a compact, recognizable user indicator is needed. Ideal for profile menus, account switching, or user-related quick actions.\n- Use the `icon` variant for generic user representation, or when no initials are available.\n- Use the `initials` variant to personalize the button with user initials (max two characters).\n- Use `styleType=\"selected\"` to indicate the current user or active selection.\n- Use `static` for non-interactive displays, such as in lists or summaries.\n- Avoid using for critical actions or as a replacement for full user profile cards.\n\n**TODO(designer):** Confirm if there are recommended scenarios for when to use `flat`, `normal`, or `selected` style types, and if there are accessibility guidelines for initials fallback.\n\n## Slots\n\n| Slot Name | Renders When... | Purpose |\n|-----------|-----------------|---------|\n| `icon`    | `variant=\"icon\"` | Custom icon to display instead of the default user icon. |\n\n## Best Practices & Constraints\n- Initials longer than two characters are truncated and a warning is logged.\n- If `initials` is empty or invalid, the button falls back to the user icon.\n- The `label` is only visible when the button is interactive (not static).\n- For accessibility, the button uses `aria-label` based on initials or a default.\n- Only use the `static` property for non-interactive contexts; otherwise, the button is clickable.\n\n## Example:\n```html\n<obc-user-button variant=\"initials\" initials=\"JD\" styleType=\"normal\" label=\"John Doe\"></obc-user-button>\n<obc-user-button variant=\"icon\" styleType=\"flat\">\n  <obi-placeholder slot=\"icon\"></obi-placeholder>\n</obc-user-button>\n```",
+          "description": "`obc-user-button` – A compact, circular button for representing a user via icon or initials.\n\nDisplays either a user icon or user initials inside a circular button, with optional label text. Commonly used for user profile access, account switching, or avatar actions in toolbars and navigation. The button supports multiple visual styles and can be rendered as a static (non-interactive) element.\n\nAppears as a button by default, but switches to a non-interactive div when the `static` property is set.\n\n## Features\n- **Variants:**\n  - `icon`: Shows a user icon (default, fallback if initials are invalid or missing).\n  - `initials`: Shows up to two uppercase initials (falls back to icon if input is empty or longer than two characters).\n- **Style Types:**\n  - `flat`: Minimal, flat appearance (default).\n  - `normal`: Outlined with background and border.\n  - `selected`: Highlighted to indicate selection or active state.\n- **Static Mode:**\n  - Set `static` to render as a non-interactive element for use in read-only or decorative contexts.\n- **Disabled State:**\n  - Set `disabled` to visually and functionally disable the button.\n- **Custom Icon Slot:**\n  - Provide a custom icon via the `icon` slot when using the `icon` variant.\n- **Label Support:**\n  - Optional `label` property displays text next to the button (not shown in static mode).\n  - Optional `sublabel` adds a second, lighter line under the label, for a\n    secondary detail such as the user's role.\n\n## Usage Guidelines\nUse `obc-user-button` to represent a user in navigation bars, toolbars, or menus where a compact, recognizable user indicator is needed. Ideal for profile menus, account switching, or user-related quick actions.\n- Use the `icon` variant for generic user representation, or when no initials are available.\n- Use the `initials` variant to personalize the button with user initials (max two characters).\n- Use `styleType=\"selected\"` to indicate the current user or active selection.\n- Use `static` for non-interactive displays, such as in lists or summaries.\n- Avoid using for critical actions or as a replacement for full user profile cards.\n\n**TODO(designer):** Confirm if there are recommended scenarios for when to use `flat`, `normal`, or `selected` style types, and if there are accessibility guidelines for initials fallback.\n\n## Slots\n\n| Slot Name | Renders When... | Purpose |\n|-----------|-----------------|---------|\n| `icon`    | `variant=\"icon\"` | Custom icon to display instead of the default user icon. |\n\n## Best Practices & Constraints\n- Initials longer than two characters are truncated and a warning is logged.\n- If `initials` is empty or invalid, the button falls back to the user icon.\n- The `label` is only visible when the button is interactive (not static).\n- For accessibility, the button is named after its visible text — `label` and\n  `sublabel` — falling back to the initials when it shows no text.\n- Only use the `static` property for non-interactive contexts; otherwise, the button is clickable.\n\n## Example:\n```html\n<obc-user-button variant=\"initials\" initials=\"JD\" styleType=\"normal\" label=\"John Doe\"></obc-user-button>\n<obc-user-button variant=\"icon\" styleType=\"flat\">\n  <obi-placeholder slot=\"icon\"></obi-placeholder>\n</obc-user-button>\n```",
           "name": "ObcUserButton",
           "slots": [
             {
@@ -87175,6 +87369,20 @@
                 "truthy": false
               }
             },
+            {
+              "kind": "field",
+              "name": "sublabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional second line under the label, for a secondary detail such as a role (not shown in static mode).\n\nAvailable when `static==false`.",
+              "attribute": "sublabel",
+              "availableWhen": "static==false",
+              "availableWhenIf": {
+                "arg": "static",
+                "truthy": false
+              }
+            },
             {
               "kind": "field",
               "name": "formattedInitials",
@@ -87246,6 +87454,14 @@
               },
               "description": "Optional label text to display next to the button (not shown in static mode).\n\nAvailable when `static==false`.",
               "fieldName": "label"
+            },
+            {
+              "name": "sublabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Optional second line under the label, for a secondary detail such as a role (not shown in static mode).\n\nAvailable when `static==false`.",
+              "fieldName": "sublabel"
             }
           ],
           "superclass": {
@@ -87281,7 +87497,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<obc-user-menu>` – A user menu component with sign-in and signed-in layouts.\n\nProvides multiple layouts for authentication and account access states, including\nsign-in forms, user-specific sign-in, loading states, and signed-in navigation.\n\n### Features\n- **Multiple States:** Supports sign-in, user sign-in, loading, and signed-in layouts.\n- **Size Options:** Regular and small sizes for compact layouts.\n- **Recent Users:** Optional \"Recently signed in\" section for quick access.\n- **Navigation Actions:** Signed-in state lists the actions it is given.\n\n### Variants\n- `type`: `sign-in`, `user-sign-in`, `loading-sign-in`, `signed-in`\n- `size`: `regular`, `small`\n\n### Usage Guidelines\nUse `obc-user-menu` in authentication or account panels where quick access to\nsign-in, profile, or account actions is needed. The `user-sign-in` type is\nbest for fast re-auth flows; `loading-sign-in` is for pending auth states.\n\n### Properties and Configuration\n- `type` (`ObcUserMenuType`): Controls the layout state. Defaults to `sign-in`.\n- `size` (`ObcUserMenuSize`): Controls the overall size. Defaults to `regular`.\n- `hasRecentlySignedIn` (`boolean`): Toggles the recent users section.\n  Defaults to `false`.\n- `showUsername` (`boolean`): Toggles the username field. Defaults to `true`.\n- `showPassword` (`boolean`): Toggles the password field. Defaults to `true`.\n- `username` (`string`): Current username value for sign-in layouts.\n- `password` (`string`): Current password value for sign-in layouts.\n- `usernameError` (`string`): Error message for the username field.\n- `passwordError` (`string`): Error message for the password field.\n- `userInitials` (`string`): Initials for the primary user profile.\n- `userLabel` (`string`): Label for the primary user profile.\n- `recentUsers` (`ObcUserMenuUser[]`): List of recent users shown in the\n  \"Recently signed in\" section. Empty renders no section.\n- `signedInActions` (`ObcUserMenuSignedInAction[]`): Actions shown in the\n  signed-in navigation list. Empty renders no actions.\n- `primaryActionId` (`string`): Id of the action promoted to a button in the\n  small signed-in layout.\n\n### Events\n- `sign-in-click` – Fired when a sign-in button is clicked.\n- `sign-out-click` – Fired when the sign-out button is clicked.\n- `signed-in-action-click` – Fired when a signed-in action is clicked.\n- `recent-user-click` – Fired when a recent user button is clicked.\n\n### Slots\n- `signed-in-action-icon-{id}`: Optional icon for a signed-in action. The\n  `{id}` is the normalized action id.\n\n### Example\n```html\n<obc-user-menu\n  type=\"user-sign-in\"\n  size=\"small\"\n  hasRecentlySignedIn=\"false\"\n  userInitials=\"JD\"\n  userLabel=\"John Doe\"\n></obc-user-menu>\n```",
+          "description": "`<obc-user-menu>` – A user menu component with sign-in and signed-in layouts.\n\nProvides multiple layouts for authentication and account access states, including\nsign-in forms, user-specific sign-in, loading states, and signed-in navigation.\n\n### Features\n- **Multiple States:** Supports sign-in, user sign-in, loading, and signed-in layouts.\n- **Size Options:** Regular and small sizes for compact layouts.\n- **Recent Users:** Optional \"Recently signed in\" section for quick access.\n- **Navigation Actions:** Signed-in state lists the actions it is given.\n\n### Variants\n- `type`: `sign-in`, `user-sign-in`, `loading-sign-in`, `signed-in`\n- `size`: `regular`, `small`\n\n### Usage Guidelines\nUse `obc-user-menu` in authentication or account panels where quick access to\nsign-in, profile, or account actions is needed. The `user-sign-in` type is\nbest for fast re-auth flows; `loading-sign-in` is for pending auth states.\n\n### Properties and Configuration\n- `type` (`ObcUserMenuType`): Controls the layout state. Defaults to `sign-in`.\n- `size` (`ObcUserMenuSize`): Controls the overall size. Defaults to `regular`.\n- `hasRecentlySignedIn` (`boolean`): Toggles the recent users section.\n  Defaults to `false`.\n- `showUsername` (`boolean`): Toggles the username field. Defaults to `true`.\n- `showPassword` (`boolean`): Toggles the password field. Defaults to `true`.\n- `username` (`string`): Current username value for sign-in layouts.\n- `password` (`string`): Current password value for sign-in layouts.\n- `usernameError` (`string`): Error message for the username field.\n- `passwordError` (`string`): Error message for the password field.\n- `userInitials` (`string`): Initials for the primary user profile.\n- `userLabel` (`string`): Label for the primary user profile.\n- `userRole` (`string`): Role shown under the primary user's label. Omit it\n  to show no role; only the regular size draws one.\n- `recentUsers` (`ObcUserMenuUser[]`): List of recent users shown in the\n  \"Recently signed in\" section. Empty renders no section. Each user may\n  carry its own `role`.\n- `showUseAnotherAccount` (`boolean`): Toggles the \"Use another account\"\n  button in the `user-sign-in` layouts, both sizes. Defaults to `true`.\n- `signedInActions` (`ObcUserMenuSignedInAction[]`): Actions shown in the\n  signed-in navigation list. Empty renders no actions.\n- `primaryActionId` (`string`): Id of the action promoted to a button in the\n  small signed-in layout.\n\n### Events\n- `sign-in-click` – Fired when a sign-in button is clicked.\n- `sign-out-click` – Fired when the sign-out button is clicked.\n- `use-another-account-click` – Fired when the \"Use another account\" button\n  is clicked. The menu does not change its own type; set it to `sign-in` in\n  the handler to show the full form.\n- `signed-in-action-click` – Fired when a signed-in action is clicked.\n- `recent-user-click` – Fired when a recent user button is clicked.\n\n### Slots\n- `signed-in-action-icon-{id}`: Optional icon for a signed-in action. The\n  `{id}` is the normalized action id.\n\n### Example\n```html\n<obc-user-menu\n  type=\"user-sign-in\"\n  size=\"small\"\n  hasRecentlySignedIn=\"false\"\n  userInitials=\"JD\"\n  userLabel=\"John Doe\"\n></obc-user-menu>\n```",
           "name": "ObcUserMenu",
           "slots": [
             {
@@ -87419,6 +87635,16 @@
                 "neq": "sign-in"
               }
             },
+            {
+              "kind": "field",
+              "name": "userRole",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Role shown under the primary user's label; omit it to show no role.\n\nAvailable when `type!=signIn && size==regular`.",
+              "attribute": "userRole",
+              "availableWhen": "type!=signIn && size==regular"
+            },
             {
               "kind": "field",
               "name": "recentUsers",
@@ -87452,6 +87678,20 @@
               "attribute": "primaryActionId",
               "availableWhen": "type==signedIn && size==small"
             },
+            {
+              "kind": "field",
+              "name": "showUseAnotherAccount",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Controls the visibility of the \"Use another account\" button.\n\nAvailable when `type==userSignIn`.",
+              "availableWhen": "type==userSignIn",
+              "availableWhenIf": {
+                "arg": "type",
+                "eq": "user-sign-in"
+              }
+            },
             {
               "kind": "field",
               "name": "showRecentUsers",
@@ -87624,6 +87864,11 @@
               "name": "handleSignOutClick",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "handleUseAnotherAccountClick",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "renderSignIn",
@@ -87676,9 +87921,9 @@
             {
               "name": "recent-user-click",
               "type": {
-                "text": "CustomEvent<{initials: string, label: string}>"
+                "text": "ObcUserMenuRecentUserClickEvent"
               },
-              "description": "Fired when a recent user button is clicked."
+              "description": "Fired when a recent user button is clicked, carrying that user's entry."
             },
             {
               "name": "sign-in-click",
@@ -87693,6 +87938,13 @@
                 "text": "CustomEvent<void>"
               },
               "description": "Fired when the sign-out button is clicked."
+            },
+            {
+              "name": "use-another-account-click",
+              "type": {
+                "text": "CustomEvent<void>"
+              },
+              "description": "Fired when the \"Use another account\" button is clicked."
             }
           ],
           "attributes": [
@@ -87773,6 +88025,14 @@
               "description": "Label for the primary user profile.\n\nAvailable when `type!=signIn`.",
               "fieldName": "userLabel"
             },
+            {
+              "name": "userRole",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Role shown under the primary user's label; omit it to show no role.\n\nAvailable when `type!=signIn && size==regular`.",
+              "fieldName": "userRole"
+            },
             {
               "name": "primaryActionId",
               "type": {
@@ -109508,7 +109768,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "TemplateResult"
+                  "text": "TemplateResult | typeof nothing"
                 }
               }
             },

package/dist/automation/transmitter/transmitter-shared.d.ts

@@ -0,0 +1,11 @@
+import { LineType } from '../index.js';
+/** Edge of a transmitter's chip that the leader line attaches to. */
+export declare enum TransmitterOrientation {
+    top = "top",
+    right = "right",
+    bottom = "bottom",
+    left = "left"
+}
+/** Half the line's stroke width, so the leader line starts on the line's edge. */
+export declare function transmitterLeaderOffset(lineType: LineType | undefined): number;
+//# sourceMappingURL=transmitter-shared.d.ts.map

package/dist/automation/transmitter/transmitter-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmitter-shared.d.ts","sourceRoot":"","sources":["../../../src/automation/transmitter/transmitter-shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAY,MAAM,aAAa,CAAC;AAEhD,qEAAqE;AACrE,oBAAY,sBAAsB;IAChC,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,CAER"}

package/dist/automation/transmitter/transmitter-shared.js

@@ -0,0 +1,16 @@
+import { lineWidth } from "../index.js";
+var TransmitterOrientation = /* @__PURE__ */ ((TransmitterOrientation2) => {
+  TransmitterOrientation2["top"] = "top";
+  TransmitterOrientation2["right"] = "right";
+  TransmitterOrientation2["bottom"] = "bottom";
+  TransmitterOrientation2["left"] = "left";
+  return TransmitterOrientation2;
+})(TransmitterOrientation || {});
+function transmitterLeaderOffset(lineType) {
+  return lineType === void 0 ? 0 : lineWidth(lineType) / 2;
+}
+export {
+  TransmitterOrientation,
+  transmitterLeaderOffset
+};
+//# sourceMappingURL=transmitter-shared.js.map

package/dist/automation/transmitter/transmitter-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmitter-shared.js","sources":["../../../src/automation/transmitter/transmitter-shared.ts"],"sourcesContent":["import {LineType, lineWidth} from '../index.js';\n\n/** Edge of a transmitter's chip that the leader line attaches to. */\nexport enum TransmitterOrientation {\n  top = 'top',\n  right = 'right',\n  bottom = 'bottom',\n  left = 'left',\n}\n\n/** Half the line's stroke width, so the leader line starts on the line's edge. */\nexport function transmitterLeaderOffset(\n  lineType: LineType | undefined\n): number {\n  return lineType === undefined ? 0 : lineWidth(lineType) / 2;\n}\n"],"names":["TransmitterOrientation"],"mappings":";AAGO,IAAK,2CAAAA,4BAAL;AACLA,0BAAA,KAAA,IAAM;AACNA,0BAAA,OAAA,IAAQ;AACRA,0BAAA,QAAA,IAAS;AACTA,0BAAA,MAAA,IAAO;AAJG,SAAAA;AAAA,GAAA,0BAAA,CAAA,CAAA;AAQL,SAAS,wBACd,UACQ;AACR,SAAO,aAAa,SAAY,IAAI,UAAU,QAAQ,IAAI;AAC5D;"}

package/dist/automation/transmitter/transmitter.css.js

@@ -74,7 +74,19 @@ const componentStyle = css`* {
     left: -4px;
   }
 
+/* Left/right anchor on the chip row's middle (Figma 25656:45233), so the id
+     tag hangs below out of flow; its parent must be the containing block. */
+
+.transmitter:is(.orientation-left,.orientation-right):not(.has-alert) .id-tag {
+    position: absolute;
+    top: calc(100% + 2px);
+    left: 50%;
+    transform: translateX(-50%);
+    white-space: nowrap;
+  }
+
 .content {
+  position: relative; /* containing block for the left/right id tag (transmitter-leader) */
   display: flex;
   flex-direction: column;
   align-items: center;
@@ -141,7 +153,6 @@ const componentStyle = css`* {
 }
 
 .id-tag {
-  color: var(--element-neutral-color);
   color: var(--element-neutral-color);
   font-variant-numeric: lining-nums tabular-nums;
   font-feature-settings: "ss04" on;

package/dist/automation/transmitter/transmitter.css.js.map

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