@oicl/openbridge-webcomponents 2.0.0-next.57 → 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": {
@@ -73396,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": [
             {
@@ -73510,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",
@@ -73808,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": {
@@ -88337,6 +88541,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Top clip, % of height. Ignored when `zoomToFitArc` is true.",
               "attribute": "clipTop"
             },
             {
@@ -88346,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",
@@ -88380,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",
@@ -88536,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",
@@ -88892,6 +89147,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Top clip, % of height. Ignored when `zoomToFitArc` is true.",
               "fieldName": "clipTop"
             },
             {
@@ -88900,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": {

package/dist/building-blocks/instrument-radial/instrument-radial.d.ts

@@ -46,12 +46,22 @@ export declare class ObcInstrumentRadial extends ObcInstrumentRadial_base {
     advices: GaugeRadialAdvice[];
     clipTop: number;
     clipBottom: number;
+    clipLeft: number;
+    clipRight: number;
+    /**
+     * Place the horizontal end labels (±90°, e.g. min/max) below the tick instead
+     * of beside it — the "Max-min" placement from the radial label model
+     * (External / Internal / Max-min). See PR #903 / design discussion.
+     */
+    endLabelsMaxMin: boolean;
     zoomToFitArc: boolean;
     private _radiusOffset;
     private _arcFrame;
     private get clampedValue();
     private get minAngle();
     private get maxAngle();
+    private mapAngle;
+    private get safeClips();
     private get _derivedNeedleColor();
     private get _derivedBarColor();
     render(): import('lit-html').TemplateResult<1>;

package/dist/building-blocks/instrument-radial/instrument-radial.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrument-radial.d.ts","sourceRoot":"","sources":["../../../src/building-blocks/instrument-radial/instrument-radial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,UAAU,EAAqB,MAAM,KAAK,CAAC;AAGxD,OAAO,EAEL,UAAU,EAEX,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAC,QAAQ,EAAC,MAAM,gDAAgD,CAAC;AAExE,OAAO,EAAC,aAAa,EAAC,MAAM,gDAAgD,CAAC;AAC7E,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,uCAAuC,CAAC;AAWhF,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;;AAuBD,qBACa,mBAAoB,SAAQ,wBAAyB;IAKtC,KAAK,EAAE,eAAe,CAA0B;IAChD,QAAQ,EAAE,QAAQ,CAAoB;IAEtC,KAAK,SAAK;IACV,QAAQ,SAAO;IACf,QAAQ,SAAK;IACT,QAAQ,EAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAS;IACvD;;;OAGG;IACuB,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAM;IAC3E;;;OAGG;IACuB,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAM;IAC7E;;;OAGG;IACuB,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAC1D;IACc,IAAI,EAAE,kBAAkB,CACtB;IACF,UAAU,EAAE,kBAAkB,CAC5B;IACD,eAAe,EAAE,OAAO,CAAS;IAClC,aAAa,EAAE,aAAa,CAC9B;IACmB,OAAO,EAAE,iBAAiB,EAAE,CAAM;IACnD,OAAO,EAAE,MAAM,CAAK;IACpB,UAAU,EAAE,MAAM,CAAK;IACtB,YAAY,EAAE,OAAO,CAAS;IAEzD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAgC;IAEjD,OAAO,KAAK,YAAY,GAIvB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,mBAAmB,GAU9B;IAED,OAAO,KAAK,gBAAgB,GAe3B;IAEQ,MAAM;IAwFf,OAAO,KAAK,OAAO,GAoBlB;IAED,IAAI,SAAS,IAAI,QAAQ,EAAE,CA6G1B;IAED,OAAO,KAAK,QAAQ,GAoBnB;IAED,OAAgB,MAAM,0BAmCpB;CACH;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,uBAAuB,EAAE,mBAAmB,CAAC;KAC9C;CACF"}
+{"version":3,"file":"instrument-radial.d.ts","sourceRoot":"","sources":["../../../src/building-blocks/instrument-radial/instrument-radial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,UAAU,EAAqB,MAAM,KAAK,CAAC;AAGxD,OAAO,EAEL,UAAU,EAEX,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EAAC,QAAQ,EAAC,MAAM,gDAAgD,CAAC;AAExE,OAAO,EAAC,aAAa,EAAC,MAAM,gDAAgD,CAAC;AAC7E,OAAO,EAAC,eAAe,EAAE,QAAQ,EAAC,MAAM,uCAAuC,CAAC;AAehF,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;;AA8ED,qBACa,mBAAoB,SAAQ,wBAAyB;IAKtC,KAAK,EAAE,eAAe,CAA0B;IAChD,QAAQ,EAAE,QAAQ,CAAoB;IAEtC,KAAK,SAAK;IACV,QAAQ,SAAO;IACf,QAAQ,SAAK;IACT,QAAQ,EAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAS;IACvD;;;OAGG;IACuB,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAM;IAC3E;;;OAGG;IACuB,yBAAyB,EAAE,MAAM,GAAG,SAAS,CAAM;IAC7E;;;OAGG;IACuB,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAC1D;IACc,IAAI,EAAE,kBAAkB,CACtB;IACF,UAAU,EAAE,kBAAkB,CAC5B;IACD,eAAe,EAAE,OAAO,CAAS;IAClC,aAAa,EAAE,aAAa,CAC9B;IACmB,OAAO,EAAE,iBAAiB,EAAE,CAAM;IACnD,OAAO,EAAE,MAAM,CAAK;IACpB,UAAU,EAAE,MAAM,CAAK;IACvB,QAAQ,EAAE,MAAM,CAAK;IACrB,SAAS,EAAE,MAAM,CAAK;IAChD;;;;OAIG;IACwB,eAAe,EAAE,OAAO,CAAS;IACjC,YAAY,EAAE,OAAO,CAAS;IAEzD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAgC;IAEjD,OAAO,KAAK,YAAY,GAIvB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED,OAAO,KAAK,QAAQ,GAEnB;IAID,OAAO,CAAC,QAAQ;IAWhB,OAAO,KAAK,SAAS,GAOpB;IAED,OAAO,KAAK,mBAAmB,GAU9B;IAED,OAAO,KAAK,gBAAgB,GAe3B;IAEQ,MAAM;IA8Ff,OAAO,KAAK,OAAO,GAsBlB;IAED,IAAI,SAAS,IAAI,QAAQ,EAAE,CA6G1B;IAED,OAAO,KAAK,QAAQ,GAoBnB;IAED,OAAgB,MAAM,0BAmCpB;CACH;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,uBAAuB,EAAE,mBAAmB,CAAC;KAC9C;CACF"}

package/dist/building-blocks/instrument-radial/instrument-radial.js

@@ -17,12 +17,17 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
+const WATCH_DEFAULT_VIEWBOX = 448;
 var ObcGaugeRadialType = /* @__PURE__ */ ((ObcGaugeRadialType2) => {
   ObcGaugeRadialType2["filled"] = "filled";
   ObcGaugeRadialType2["bar"] = "bar";
   ObcGaugeRadialType2["needle"] = "needle";
   return ObcGaugeRadialType2;
 })(ObcGaugeRadialType || {});
+const NEEDLE_TIP_RADIUS = 160;
+const NEEDLE_TIP_GAP = 5;
+const NEEDLE_WIDTH = 8;
+const NEEDLE_HUB_RADIUS = 16;
 function rangeIncludesZero(minValue, maxValue) {
   return minValue <= 0 && maxValue >= 0;
 }
@@ -38,6 +43,31 @@ function strongerTickmarkType(existing, candidate) {
   };
   return priority[candidate] > priority[existing] ? candidate : existing;
 }
+function clampClipPercent(n) {
+  return Number.isFinite(n) ? Math.min(Math.max(n, 0), 100) : 0;
+}
+function normalizeClips(clips) {
+  let top = clampClipPercent(clips.top);
+  let bottom = clampClipPercent(clips.bottom);
+  let left = clampClipPercent(clips.left);
+  let right = clampClipPercent(clips.right);
+  if (top + bottom >= 100) {
+    top = 0;
+    bottom = 0;
+  }
+  if (left + right >= 100) {
+    left = 0;
+    right = 0;
+  }
+  return { top, bottom, left, right };
+}
+function defaultGaugeAngle(value, minValue, maxValue) {
+  const span = maxValue - minValue;
+  if (!Number.isFinite(span) || span <= 0) {
+    return -135;
+  }
+  return (value - minValue) / span * 270 - 135;
+}
 let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
   constructor() {
     super(...arguments);
@@ -57,6 +87,9 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
     this.advices = [];
     this.clipTop = 0;
     this.clipBottom = 0;
+    this.clipLeft = 0;
+    this.clipRight = 0;
+    this.endLabelsMaxMin = false;
     this.zoomToFitArc = false;
     this._radiusOffset = 0;
   }
@@ -66,10 +99,27 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
     return Math.max(lowerBound, Math.min(this.value, upperBound));
   }
   get minAngle() {
-    return this.getAngle(this.minValue);
+    return this.mapAngle(this.minValue);
   }
   get maxAngle() {
-    return this.getAngle(this.maxValue);
+    return this.mapAngle(this.maxValue);
+  }
+  // Map a value to an angle via the consumer's `getAngle`, guarding a missing
+  // or non-finite mapping so a misconfigured consumer can't emit NaN geometry.
+  mapAngle(value) {
+    const fn = this.getAngle;
+    const angle = typeof fn === "function" ? fn(value) : defaultGaugeAngle(value, this.minValue, this.maxValue);
+    return Number.isFinite(angle) ? angle : 0;
+  }
+  // Clamped clips, reused for the overlay viewBox and the clips forwarded to
+  // obc-watch.
+  get safeClips() {
+    return normalizeClips({
+      top: this.clipTop,
+      bottom: this.clipBottom,
+      left: this.clipLeft,
+      right: this.clipRight
+    });
   }
   get _derivedNeedleColor() {
     if (this.state === InstrumentState.loading || this.state === InstrumentState.off) {
@@ -90,12 +140,12 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
     const barColor = this.barColor ?? this._derivedBarColor;
     const barStartValue = Math.max(this.minValue, Math.min(0, this.maxValue));
     const value = this.clampedValue;
-    const setpointAngle = this.setpoint !== void 0 ? this.getAngle(this.setpoint) : void 0;
-    const newSetpointAngle = this.newSetpoint !== void 0 ? this.getAngle(this.newSetpoint) : void 0;
+    const setpointAngle = this.setpoint !== void 0 ? this.mapAngle(this.setpoint) : void 0;
+    const newSetpointAngle = this.newSetpoint !== void 0 ? this.mapAngle(this.newSetpoint) : void 0;
     const barAreas = this.type === "needle" ? [] : [
       {
-        startAngle: this.getAngle(barStartValue),
-        endAngle: this.getAngle(value),
+        startAngle: this.mapAngle(barStartValue),
+        endAngle: this.mapAngle(value),
         fillColor: barColor
       }
     ];
@@ -108,6 +158,7 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
       }
     ];
     const watchCircleType = this.type === "needle" ? WatchCircleType.single : WatchCircleType.double;
+    const clips = this.safeClips;
     let viewBox;
     if (this.zoomToFitArc) {
       const ext = 48;
@@ -119,16 +170,18 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
         extension: ext,
         targetSize
       });
-      viewBox = frame.viewBox;
       this._radiusOffset = frame.radiusOffset;
+      viewBox = frame.viewBox;
       this._arcFrame = frame;
     } else {
       this._radiusOffset = 0;
       this._arcFrame = void 0;
-      const width = 448;
-      const height = width * (1 - this.clipTop / 100 - this.clipBottom / 100);
-      const top = -width / 2 + width * this.clipTop / 100;
-      viewBox = `${-width / 2} ${top} ${width} ${height}`;
+      const full = WATCH_DEFAULT_VIEWBOX;
+      const w = full * (1 - clips.left / 100 - clips.right / 100);
+      const h = full * (1 - clips.top / 100 - clips.bottom / 100);
+      const left = -full / 2 + full * clips.left / 100;
+      const top = -full / 2 + full * clips.top / 100;
+      viewBox = `${left} ${top} ${w} ${h}`;
     }
     return html`
       <div class="container">
@@ -149,8 +202,11 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
           .areas=${areas}
           .watchCircleType=${watchCircleType}
           .barAreas=${barAreas}
-          .clipTop=${this.zoomToFitArc ? 0 : this.clipTop}
-          .clipBottom=${this.zoomToFitArc ? 0 : this.clipBottom}
+          .clipTop=${this.zoomToFitArc ? 0 : clips.top}
+          .clipBottom=${this.zoomToFitArc ? 0 : clips.bottom}
+          .clipLeft=${this.zoomToFitArc ? 0 : clips.left}
+          .clipRight=${this.zoomToFitArc ? 0 : clips.right}
+          .endLabelsMaxMin=${this.endLabelsMaxMin}
           .zoomToFitArc=${this.zoomToFitArc}
           .arcFrame=${this._arcFrame}
         ></obc-watch>
@@ -166,14 +222,14 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
     const rOff = this._radiusOffset;
     const value = this.clampedValue;
     if (this.type === "needle") {
-      return svg`<g transform="rotate(${this.getAngle(value)}) translate(-256, -256)">
-      <circle cx="256" cy="256" r="14" fill=${needleColor}/>
-      <rect x="250" y="${96 - rOff}" width="12" height="${192 + rOff}" rx="6" fill=${needleColor}/>
-      <rect x="252" y="${98 - rOff}" width="8" height="${188 + rOff}" rx="4" stroke=${needleColor} fill=${needleColor} stroke-width="4"/>
+      const tipY = 256 - (NEEDLE_TIP_RADIUS - NEEDLE_TIP_GAP) - rOff;
+      return svg`<g transform="rotate(${this.mapAngle(value)}) translate(-256, -256)">
+      <rect x="${256 - NEEDLE_WIDTH / 2}" y="${tipY}" width="${NEEDLE_WIDTH}" height="${256 - tipY}" rx="${NEEDLE_WIDTH / 2}" fill=${needleColor} stroke=${needleColor}/>
+      <circle cx="256" cy="256" r="${NEEDLE_HUB_RADIUS}" fill=${needleColor}/>
       </g>
 `;
     } else {
-      return svg`<g transform="rotate(${this.getAngle(value)}) translate(-256, -256)">
+      return svg`<g transform="rotate(${this.mapAngle(value)}) translate(-256, -256)">
 <rect x="252" y="${96 - rOff}" width="8" height="48" rx="4" fill=${needleColor} stroke="var(--border-silhouette-color)"/>
 </g>
       `;
@@ -196,7 +252,7 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
         return;
       }
       tickmarksByValue.set(normalizedValue, {
-        angle: this.getAngle(normalizedValue),
+        angle: this.mapAngle(normalizedValue),
         type,
         text
       });
@@ -256,8 +312,8 @@ let ObcInstrumentRadial = class extends SetpointMixin(LitElement) {
   get _advices() {
     const value = this.clampedValue;
     return this.advices.map((advice) => {
-      const minAngle = this.getAngle(advice.minValue);
-      const maxAngle = this.getAngle(advice.maxValue);
+      const minAngle = this.mapAngle(advice.minValue);
+      const maxAngle = this.mapAngle(advice.maxValue);
       let state = advice.hinted ? AdviceState.hinted : AdviceState.regular;
       if (value >= advice.minValue && value <= advice.maxValue) {
         state = AdviceState.triggered;
@@ -366,6 +422,15 @@ __decorateClass([
 __decorateClass([
   property({ type: Number })
 ], ObcInstrumentRadial.prototype, "clipBottom", 2);
+__decorateClass([
+  property({ type: Number })
+], ObcInstrumentRadial.prototype, "clipLeft", 2);
+__decorateClass([
+  property({ type: Number })
+], ObcInstrumentRadial.prototype, "clipRight", 2);
+__decorateClass([
+  property({ type: Boolean })
+], ObcInstrumentRadial.prototype, "endLabelsMaxMin", 2);
 __decorateClass([
   property({ type: Boolean })
 ], ObcInstrumentRadial.prototype, "zoomToFitArc", 2);