@oicl/openbridge-webcomponents 2.0.0-next.56 → 2.0.0-next.58

package/custom-elements.json

@@ -36273,6 +36273,34 @@
               "default": "0",
               "attribute": "clipBottom"
             },
+            {
+              "kind": "field",
+              "name": "clipLeft",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "clipLeft"
+            },
+            {
+              "kind": "field",
+              "name": "clipRight",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "clipRight"
+            },
+            {
+              "kind": "field",
+              "name": "endLabelsMaxMin",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Place the horizontal end labels (±90°, e.g. min/max) below the tick instead\nof beside it — the \"Max-min\" placement from the radial label model\n(External / Internal / Max-min). See PR #903 / design discussion.",
+              "attribute": "endLabelsMaxMin"
+            },
             {
               "kind": "field",
               "name": "zoomToFitArc",
@@ -36326,6 +36354,33 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "mapAngle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "safeClips",
+              "type": {
+                "text": "Clips"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "_derivedNeedleColor",
@@ -36685,6 +36740,31 @@
               "default": "0",
               "fieldName": "clipBottom"
             },
+            {
+              "name": "clipLeft",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "clipLeft"
+            },
+            {
+              "name": "clipRight",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "clipRight"
+            },
+            {
+              "name": "endLabelsMaxMin",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Place the horizontal end labels (±90°, e.g. min/max) below the tick instead\nof beside it — the \"Max-min\" placement from the radial label model\n(External / Internal / Max-min). See PR #903 / design discussion.",
+              "fieldName": "endLabelsMaxMin"
+            },
             {
               "name": "zoomToFitArc",
               "type": {
@@ -70468,6 +70548,16 @@
               "default": "false",
               "attribute": "zoomToFitArc"
             },
+            {
+              "kind": "field",
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, shows a centered `<obc-readout>` under the arc displaying the\nheading (label `HDG`, unit `DEG`). The value color follows the HDG entry in\n`priorityElements`, matching the HDG arrow.",
+              "attribute": "hasReadout"
+            },
             {
               "kind": "field",
               "name": "_headingSp",
@@ -70680,6 +70770,16 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "field",
+              "name": "_readoutTopPercent",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "description": "Vertical placement of the readout as a percentage of the host height.\n\nWith `zoomToFitArc` the arc is reframed by `computeZoomToFitArcFrame`, whose\n`radiusOffset`/`viewBox` depend on the arc's *absolute* orientation (which\ncardinal axes its bounding box crosses), not just its bend. The arc itself\nis always rotated back to the top, so it stays put on screen — but a\nframe-derived offset would swing wildly as `heading` rotates the bbox around\nthe circle. So in zoom we use a fixed offset, which keeps the readout steady\nunder the (stationary) arc regardless of heading.\n\nWithout zoom the viewBox is the fixed, origin-symmetric 120° framing, so the\ngeometry is orientation-independent: place the readout halfway down the inner\nradius from the watch center toward the arc's inner edge.",
+              "readonly": true
             }
           ],
           "events": [
@@ -70869,6 +70969,15 @@
               },
               "default": "false",
               "fieldName": "zoomToFitArc"
+            },
+            {
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, shows a centered `<obc-readout>` under the arc displaying the\nheading (label `HDG`, unit `DEG`). The value color follows the HDG entry in\n`priorityElements`, matching the HDG arrow.",
+              "fieldName": "hasReadout"
             }
           ],
           "superclass": {
@@ -73367,7 +73476,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- **Full-range mapping**: The configured `minValue..maxValue` always spans\n  the full 270° sweep. Symmetric ranges still place `0` at 12 o'clock.\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.\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\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  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\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 `showReadout` 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": [
             {
@@ -73481,24 +73590,109 @@
               "type": {
                 "text": "GaugeRadialAdvice[]"
               },
-              "default": "[]"
+              "default": "[]",
+              "description": "Caution/alert arcs. Ignored on `sector: 90-left` / `90-right`."
+            },
+            {
+              "kind": "field",
+              "name": "sector",
+              "type": {
+                "text": "GaugeRadialSector"
+              },
+              "attribute": "sector",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showReadout"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "unit",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "unit"
+            },
+            {
+              "kind": "field",
+              "name": "fractionDigits",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "fractionDigits"
+            },
+            {
+              "kind": "field",
+              "name": "sectorAngles",
+              "type": {
+                "text": "{sweep: number; start: number}"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "sectorClips",
+              "type": {
+                "text": "{\n    top: number;\n    bottom: number;\n    left: number;\n    right: number;\n  }"
+              },
+              "privacy": "private",
+              "description": "Per-edge crop (%) of the shared, origin-centered 448 SVG box each sector\nshows. All sectors render at the same natural scale, so the dial stays the\nsame size; the sector only windows a different part (270 whole, 180 wide,\n90 a quadrant).",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isSector90",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "getAngle"
             },
             {
               "kind": "method",
-              "name": "getAngle",
+              "name": "renderReadout",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "number"
+                  "text": "TemplateResult"
                 }
               },
               "parameters": [
                 {
-                  "name": "v",
+                  "name": "{\n    className,\n    variant,\n    alignment = ReadoutStackVerticalAlignment.vertical,\n    withMeta = true,\n    labelOnly = false,\n  }",
                   "type": {
-                    "text": "number"
+                    "text": "{\n    className: string;\n    variant: ReadoutVariant;\n    alignment?: ReadoutStackVerticalAlignment;\n    withMeta?: boolean;\n    labelOnly?: boolean;\n  }"
                   }
                 }
-              ]
+              ],
+              "description": "Renders one gauge readout; `withMeta`/`labelOnly` pick parts."
+            },
+            {
+              "kind": "method",
+              "name": "renderReadouts",
+              "privacy": "private"
             },
             {
               "kind": "field",
@@ -73779,6 +73973,45 @@
               },
               "fieldName": "tickmarkStyle"
             },
+            {
+              "name": "sector",
+              "type": {
+                "text": "GaugeRadialSector"
+              },
+              "fieldName": "sector"
+            },
+            {
+              "name": "showReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showReadout"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "label"
+            },
+            {
+              "name": "unit",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "unit"
+            },
+            {
+              "name": "fractionDigits",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "fractionDigits"
+            },
             {
               "name": "setpoint",
               "type": {
@@ -79764,6 +79997,16 @@
               },
               "default": "[ PitchRollPriorityElement.pitch, PitchRollPriorityElement.roll, ]"
             },
+            {
+              "kind": "field",
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, the centre shows two stacked `<obc-readout>`s (pitch above\nroll) instead of the vessel images. Default `false`.",
+              "attribute": "hasReadout"
+            },
             {
               "kind": "field",
               "name": "zoomToFitArc",
@@ -79883,6 +80126,31 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "renderReadout",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "label",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "PitchRollPriorityElement"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "renderZoomedArcs",
@@ -80062,6 +80330,15 @@
               },
               "fieldName": "priority"
             },
+            {
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, the centre shows two stacked `<obc-readout>`s (pitch above\nroll) instead of the vessel images. Default `false`.",
+              "fieldName": "hasReadout"
+            },
             {
               "name": "zoomToFitArc",
               "type": {
@@ -80129,7 +80406,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<obc-pitch>` — Pitch (trim) indicator with a side arc scale.\n\nShows `pitch` against a watch arc centred on the right, with an average-pitch\nband and a rotating indicator. Supports an optional opposite-side scale\n(`dual-scale`), a centre readout (`hasReadout`), and a `regular`/`enhanced`\npalette.",
           "name": "ObcPitch",
           "members": [
             {
@@ -80194,6 +80471,34 @@
               "default": "false",
               "attribute": "zoomToFitArc"
             },
+            {
+              "kind": "field",
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, the centre shows an `<obc-readout>` with the pitch value\n(label `Pitch`, unit `DEG`) instead of the horizon line, rotating indicator\nand vessel. Default `false`.",
+              "attribute": "hasReadout"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "ObcPitchType"
+              },
+              "description": "`single-scale` shows one arc on the right (default); `dual-scale` also\nshows the scale on the opposite (left) arc (the indicator's opposite end).",
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "priority",
+              "type": {
+                "text": "Priority"
+              },
+              "description": "Colour palette for the scale fill / indicator and the readout value:\n`regular` (default) or `enhanced`.",
+              "attribute": "priority"
+            },
             {
               "kind": "field",
               "name": "arcAngle",
@@ -80212,6 +80517,43 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "scaleFillColor",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "indicatorColor",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "renderScale",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "areas",
+                  "type": {
+                    "text": "WatchArea[]"
+                  }
+                },
+                {
+                  "name": "opposite",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
             {
               "kind": "field",
               "name": "advices",
@@ -80278,6 +80620,31 @@
               "default": "false",
               "fieldName": "zoomToFitArc"
             },
+            {
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, the centre shows an `<obc-readout>` with the pitch value\n(label `Pitch`, unit `DEG`) instead of the horizon line, rotating indicator\nand vessel. Default `false`.",
+              "fieldName": "hasReadout"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "ObcPitchType"
+              },
+              "description": "`single-scale` shows one arc on the right (default); `dual-scale` also\nshows the scale on the opposite (left) arc (the indicator's opposite end).",
+              "fieldName": "type"
+            },
+            {
+              "name": "priority",
+              "type": {
+                "text": "Priority"
+              },
+              "description": "Colour palette for the scale fill / indicator and the readout value:\n`regular` (default) or `enhanced`.",
+              "fieldName": "priority"
+            },
             {
               "name": "arcAngle",
               "type": {
@@ -83833,7 +84200,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<obc-roll>` — Roll (heel) indicator with a bottom arc scale.\n\nShows `roll` against a watch arc centred at the bottom, with an average-roll\nband and a rotating indicator. Supports an optional top scale (`dual-scale`),\na centre readout (`hasReadout`), and a `regular`/`enhanced` palette. See the\nindividual properties for details.",
           "name": "ObcRoll",
           "members": [
             {
@@ -83907,6 +84274,34 @@
               "default": "false",
               "attribute": "zoomToFitArc"
             },
+            {
+              "kind": "field",
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, the centre shows an `<obc-readout>` with the roll value\n(label `Roll`, unit `DEG`) instead of the horizon line, rotating indicator\nand vessel. Default `false`.",
+              "attribute": "hasReadout"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "ObcRollType"
+              },
+              "description": "`single-scale` shows one arc at the bottom (default); `dual-scale` also\nshows the scale on the top arc (the indicator's opposite end).",
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "priority",
+              "type": {
+                "text": "Priority"
+              },
+              "description": "Colour palette for the scale fill / indicator and the readout value:\n`regular` (default) or `enhanced`.",
+              "attribute": "priority"
+            },
             {
               "kind": "field",
               "name": "arcAngle",
@@ -83934,6 +84329,43 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "scaleFillColor",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "indicatorColor",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "renderScale",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "areas",
+                  "type": {
+                    "text": "WatchArea[]"
+                  }
+                },
+                {
+                  "name": "top",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
             {
               "kind": "field",
               "name": "advices",
@@ -84008,6 +84440,31 @@
               "default": "false",
               "fieldName": "zoomToFitArc"
             },
+            {
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, the centre shows an `<obc-readout>` with the roll value\n(label `Roll`, unit `DEG`) instead of the horizon line, rotating indicator\nand vessel. Default `false`.",
+              "fieldName": "hasReadout"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "ObcRollType"
+              },
+              "description": "`single-scale` shows one arc at the bottom (default); `dual-scale` also\nshows the scale on the top arc (the indicator's opposite end).",
+              "fieldName": "type"
+            },
+            {
+              "name": "priority",
+              "type": {
+                "text": "Priority"
+              },
+              "description": "Colour palette for the scale fill / indicator and the readout value:\n`regular` (default) or `enhanced`.",
+              "fieldName": "priority"
+            },
             {
               "name": "arcAngle",
               "type": {
@@ -84394,6 +84851,16 @@
               "default": "60",
               "attribute": "rotArcExtent"
             },
+            {
+              "kind": "field",
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, shows a centered `<obc-readout>` (label `ROT`, unit `DEG/min`)\nunder the arc with the current rate-of-turn value. Default `false`.",
+              "attribute": "hasReadout"
+            },
             {
               "kind": "field",
               "name": "getAngle"
@@ -84415,6 +84882,16 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "_readoutTopPercent",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "description": "Vertical position of the readout, in % of the host. In the zoomed view the\narc's lower edge shifts with `rotArcExtent`, so the position is interpolated\nbetween the narrow- and wide-arc anchors to keep a roughly constant gap\nbetween the arc and the readout. The static (unzoomed) arc uses a fixed\nposition.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "_needleColor",
@@ -84724,6 +85201,15 @@
               "default": "60",
               "fieldName": "rotArcExtent"
             },
+            {
+              "name": "hasReadout",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When `true`, shows a centered `<obc-readout>` (label `ROT`, unit `DEG/min`)\nunder the arc with the current rate-of-turn value. Default `false`.",
+              "fieldName": "hasReadout"
+            },
             {
               "name": "setpoint",
               "type": {
@@ -88055,6 +88541,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Top clip, % of height. Ignored when `zoomToFitArc` is true.",
               "attribute": "clipTop"
             },
             {
@@ -88064,8 +88551,39 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Bottom clip, % of height. Ignored when `zoomToFitArc` is true.",
               "attribute": "clipBottom"
             },
+            {
+              "kind": "field",
+              "name": "clipLeft",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Left clip, % of width — horizontal counterpart of clipTop/bottom (90° sectors). Ignored when `zoomToFitArc`.",
+              "attribute": "clipLeft"
+            },
+            {
+              "kind": "field",
+              "name": "clipRight",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Right clip, % of width — horizontal counterpart of clipTop/bottom (90° sectors). Ignored when `zoomToFitArc`.",
+              "attribute": "clipRight"
+            },
+            {
+              "kind": "field",
+              "name": "endLabelsMaxMin",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Place the horizontal end labels (±90°, e.g. min/max) below the tick instead\nof beside it. This is the \"Max-min\" label placement from the radial label\nmodel (External / Internal / Max-min) — see PR #903 / design discussion.\nCurrently only used by the 180° sector of `obc-gauge-radial`.",
+              "attribute": "endLabelsMaxMin"
+            },
             {
               "kind": "field",
               "name": "scaleWindIcon",
@@ -88098,7 +88616,7 @@
               "type": {
                 "text": "ZoomToFitArcFrame|undefined"
               },
-              "description": "Pre-computed zoom-to-fit arc frame. When set, the watch skips its own `computeZoomToFitArcFrame()` call and uses these values directly. Consumer instruments (e.g. rudder, instrument-radial) should compute the frame once and pass it here to avoid redundant computation."
+              "description": "Pre-computed zoom-to-fit arc frame. When set, the watch skips its own `computeZoomToFitArcFrame()` call and uses these values directly. Consumer instruments (e.g. rudder, instrument-radial) should compute the frame once and pass it here to avoid redundant computation. If you pass `arcFrame`, you own keeping it in sync with `areas` / `watchCircleType` — obc-watch will NOT recompute it, so a stale frame renders stale geometry."
             },
             {
               "kind": "field",
@@ -88254,6 +88772,25 @@
               "privacy": "private",
               "default": "0"
             },
+            {
+              "kind": "method",
+              "name": "_bandRadius",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "base",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Radius for a dial-band edge under zoom: additive (`base + _rOff`), keeping\nband thickness constant in SVG units. INVARIANT: every band-edge radius\n(rings, value arc, bars, needles, inside-label `textRadius`) must go through\nthis — mixing additive and multiplicative offsets misaligns ticks, labels,\nadvice masks and arcs. The proportional experiments were removed for this\nreason (PR #903)."
+            },
             {
               "kind": "method",
               "name": "watchCircle",
@@ -88610,6 +89147,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Top clip, % of height. Ignored when `zoomToFitArc` is true.",
               "fieldName": "clipTop"
             },
             {
@@ -88618,8 +89156,36 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Bottom clip, % of height. Ignored when `zoomToFitArc` is true.",
               "fieldName": "clipBottom"
             },
+            {
+              "name": "clipLeft",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Left clip, % of width — horizontal counterpart of clipTop/bottom (90° sectors). Ignored when `zoomToFitArc`.",
+              "fieldName": "clipLeft"
+            },
+            {
+              "name": "clipRight",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Right clip, % of width — horizontal counterpart of clipTop/bottom (90° sectors). Ignored when `zoomToFitArc`.",
+              "fieldName": "clipRight"
+            },
+            {
+              "name": "endLabelsMaxMin",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Place the horizontal end labels (±90°, e.g. min/max) below the tick instead\nof beside it. This is the \"Max-min\" label placement from the radial label\nmodel (External / Internal / Max-min) — see PR #903 / design discussion.\nCurrently only used by the 180° sector of `obc-gauge-radial`.",
+              "fieldName": "endLabelsMaxMin"
+            },
             {
               "name": "scaleWindIcon",
               "type": {