@oicl/openbridge-webcomponents-svelte 2.0.0-next.15 → 2.0.0-next.151

package/dist/building-blocks/chart-line/ObcChartLineBase.svelte

@@ -1,93 +1,114 @@
 
   <script lang="ts">
-    export type {ChartDataset} from 'chart.js';
-export type {XAxisType, YAxisPosition, LineMode, TimeDisplay} from '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
+    export type {ChartLineDataItem, ChartLinePoint, XAxisType, YAxisPosition, ChartLineYAxisConfig, LineMode, TimeDisplay} from '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
+export type {ChartDataset} from 'chart.js';
 export type {InstrumentState, Priority, FrameStyle, BorderRadiusPosition} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
       import '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
       import { setProperties } from "../../util.js";
-      import type {ChartDataset} from 'chart.js';
-import type {XAxisType, YAxisPosition, LineMode, TimeDisplay} from '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
+      import type {ChartLineDataItem, ChartLinePoint, XAxisType, YAxisPosition, ChartLineYAxisConfig, LineMode, TimeDisplay} from '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
+import type {ChartDataset} from 'chart.js';
 import type {InstrumentState, Priority, FrameStyle, BorderRadiusPosition} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
       import type { Snippet } from 'svelte';
 
       export interface Props {
      class?: string;
      style?: string;
-      /** Simple single-series data (array of {label, value}). */
-data?: { label: string; value: number; }[];
-      /** Chart.js-style datasets for multi-series use. If provided, takes precedence over `data`. */
-datasets?: ChartDataset<"line", (number | { x: string | number | Date; y: number; })[]>[] | undefined;
-      /** Optional explicit labels for the x-axis (category mode). If omitted labels are derived from `data` */
-labels?: (string | number)[] | undefined;
-      /** Custom color palette (CSS variable names or color strings). */
-colors?: string[];
-      /** Show HTML legend below chart with series labels and colors. */
-legend?: boolean;
-      /** Development mode: show visual debug overlay with dimension guides. */
-showDebugOverlay?: boolean;
-      /** Width of the chart in pixels. Default: 480. */
-width?: number;
-      /** Height of the chart in pixels. Default: 320. */
-height?: number;
-      /** Enable fixed aspect ratio scaling mode.
-When true, width/height properties define the aspect ratio (not actual pixels).
-The component fills 100% of parent width and calculates height from aspect ratio.
-When false (default), width/height are used as actual pixel dimensions. */
-fixedAspectRatioScaling?: boolean;
-      /** Reference size for external scales when using fixedAspectRatioScaling.
-This value is passed down to external scales to determine their 1:1 Figma design size.
-At this reference size, scales render at native size; above/below they scale proportionally.
-Default: 384 (matches Figma design baseline). */
-scaleReferenceSize?: number;
-      /** X-axis mode: 'category' for labeled data points, 'time' for time-based data. */
-xAxisType?: XAxisType;
-      /** Single y-axis position ('left' or 'right'). For multiple y-axes, use yAxes instead. */
-yAxisPosition?: YAxisPosition;
-      /** Multiple y-axis definitions for complex multi-axis charts. */
-yAxes?: { id?: string | undefined; position?: "left" | "right" | undefined; min?: number | undefined; max?: number | undefined; grid?: boolean | undefined; }[] | undefined;
-      /** Show grid lines. */
-showGrid?: boolean;
-      /** Show vertical grid lines (x-axis). Default: false. */
-showGridX?: boolean;
-      /** Show horizontal grid lines (y-axis). Default: false. */
-showGridY?: boolean;
-      /** Show axis tick marks and labels. */
-showTickMarks?: boolean;
-      /** Show point markers on data points. Default: false. */
-showPoints?: boolean;
-      /** Line drawing style: 'smooth' (curved), 'straight', or 'stepped'. */
-lineMode?: LineMode;
-      /** Unit label displayed in tooltips (e.g., 'kW', 'kg', '%'). */
-unit?: string;
-      /** Time axis label format: 'date' (full date/time) or 'minutes' (relative). */
-timeDisplay?: TimeDisplay;
-      /** Max number of x-axis ticks/grid lines. Useful for matching external axes. */
-xTicksLimit?: number | undefined;
-      /** Force x-axis tick interval. Useful for matching external axes. */
-xStepSize?: number | undefined;
-      /** Max number of y-axis ticks/grid lines. Useful for matching external axes. */
-yTicksLimit?: number | undefined;
-      /** Force y-axis tick interval. Useful for matching external axes. */
-yStepSize?: number | undefined;
-      /** Instrument state affecting colors of external scales. */
-state?: InstrumentState;
-      /** Color priority: enhanced uses blue palette instead of default gray. */
-priority?: Priority;
-      /** Frame style for chart and external scales. */
-frameStyle?: FrameStyle;
-      /** Border radius position for the chart's own border. */
-borderRadiusPosition?: BorderRadiusPosition | undefined;
-      /** Border radius position for external scales based on layout. */
-borderRadiusPositionExternalScales?: BorderRadiusPosition | undefined;
-      /** When true, the chart is used inside an instrument (e.g., gauge-trend).
-In this mode, only label font size responds to .obc-component-size-* CSS classes.
-Border radius uses the explicit `borderRadius` property value (or defaults to 8px),
-rather than reading from CSS variables. */
-instrumentMode?: boolean;
-      /** Explicit border radius value in pixels.
-When instrumentMode=true, this value is used directly (defaults to 8px).
-When instrumentMode=false, this is ignored and border radius is read from CSS variable. */
-borderRadius?: number | undefined
+     /** Simple single-series data. `{label, value}` items for the category axis; `{x, value}` items for time/number axes (x: epoch ms, ISO string, Date, or Temporal object). Points are drawn in array order (no sorting). */
+     data?: ChartLineDataItem[];
+     /** Chart.js-style datasets for multi-series use. If provided, takes precedence over `data`. */
+     datasets?: ChartDataset<"line", ChartLinePoint[]>[] | undefined;
+     /** Optional explicit labels for the x-axis (category mode). If omitted labels are derived from `data` */
+     labels?: (string | number)[] | undefined;
+     /** Custom color palette (CSS variable names or color strings). */
+     colors?: string[];
+     /** Show HTML legend below chart with series labels and colors. */
+     legend?: boolean;
+     /** Development mode: show visual debug overlay with dimension guides. */
+     showDebugOverlay?: boolean;
+     /** Width of the chart in pixels. Default: 480. */
+     width?: number;
+     /** Height of the chart in pixels. Default: 320. */
+     height?: number;
+     /** Enable fixed aspect ratio scaling mode. When true, width/height properties define the aspect ratio (not actual pixels). The component fills 100% of parent width and calculates height from aspect ratio. When false (default), width/height are used as actual pixel dimensions. */
+     fixedAspectRatioScaling?: boolean;
+     /** Reference size for external scales when using fixedAspectRatioScaling. This value is passed down to external scales to determine their 1:1 Figma design size. At this reference size, scales render at native size; above/below they scale proportionally. Default: 384 (matches Figma design baseline). */
+     scaleReferenceSize?: number;
+     /** X-axis mode: 'category' for labeled, evenly spaced data points; 'time' for time-based data positioned proportionally; 'number' for plain numeric x-values. */
+     xAxisType?: XAxisType;
+     /** Single y-axis position ('left' or 'right'). For multiple y-axes, use yAxes instead. */
+     yAxisPosition?: YAxisPosition;
+     /** Multiple y-axis definitions for complex multi-axis charts. */
+     yAxes?: ChartLineYAxisConfig[] | undefined;
+     /** Show grid lines. */
+     showGrid?: boolean;
+     /**
+      * Show vertical grid lines (x-axis). Default: false.
+      *
+      * Available when `showGrid==true`.
+      */
+     showGridX?: boolean;
+     /**
+      * Show horizontal grid lines (y-axis). Default: false.
+      *
+      * Available when `showGrid==true`.
+      */
+     showGridY?: boolean;
+     /** Show axis tick marks and labels. */
+     showTickMarks?: boolean;
+      /** Reserve canvas padding for axis tick labels on sides without an external scale.
+
+When `true` (default), the chart leaves room for tick labels and renders them
+(subject to `showTickMarks` and the 192px auto-compact threshold).
+
+When `false`, the chart renders edge-to-edge on sides without a slotted external
+scale AND axis tick labels are force-hidden so they cannot be clipped. This also
+suppresses the automatic edge-to-edge switch that normally happens below the
+192px threshold, eliminating the visible padding "jump" when crossing it.
+
+Useful when embedding the chart inside another component that owns framing
+and never wants to show axis labels (e.g. `obc-automation-tank`).
+
+Defaults to `true` to preserve existing behavior. Declared with `attribute: false`
+because a `true`-default boolean cannot work as an HTML boolean attribute. */
+hasLabelPadding?: boolean;
+     /** Show point markers on data points. Default: false. */
+     showPoints?: boolean;
+     /** Line drawing style: 'smooth' (curved), 'straight', or 'stepped'. */
+     lineMode?: LineMode;
+     /** Unit label displayed in tooltips (e.g., 'kW', 'kg', '%'). */
+     unit?: string;
+     /**
+      * Time axis label format: 'date' (full date/time) or 'minutes' (relative).
+      *
+      * Available when `xAxisType==time`.
+      */
+     timeDisplay?: TimeDisplay;
+     /** Max number of x-axis ticks/grid lines. Useful for matching external axes. */
+     xTicksLimit?: number | undefined;
+     /** Force x-axis tick interval. Useful for matching external axes. */
+     xStepSize?: number | undefined;
+     /** Max number of y-axis ticks/grid lines. Useful for matching external axes. */
+     yTicksLimit?: number | undefined;
+     /** Force y-axis tick interval. Useful for matching external axes. */
+     yStepSize?: number | undefined;
+     /** Instrument state affecting colors of external scales. */
+     state?: InstrumentState;
+     /** Color priority: enhanced uses blue palette instead of default gray. */
+     priority?: Priority;
+     /** Frame style for chart and external scales. */
+     frameStyle?: FrameStyle;
+     /** Border radius position for the chart's own border. */
+     borderRadiusPosition?: BorderRadiusPosition | undefined;
+     /** Border radius position for external scales based on layout. */
+     borderRadiusPositionExternalScales?: BorderRadiusPosition | undefined;
+     /** When true, the chart is used inside an instrument (e.g., gauge-trend). In this mode, only label font size responds to .obc-component-size-* CSS classes. Border radius uses the explicit `borderRadius` property value (or defaults to 8px), rather than reading from CSS variables. */
+     instrumentMode?: boolean;
+     /**
+      * Explicit border radius value in pixels. When instrumentMode=true, this value is used directly (defaults to 8px). When instrumentMode=false, this is ignored and border radius is read from CSS variable.
+      *
+      * Available when `instrumentMode==true`.
+      */
+     borderRadius?: number | undefined
    }
       export interface Events {
     

package/dist/building-blocks/chart-line/ObcChartLineBase.svelte.d.ts

@@ -1,21 +1,15 @@
 import '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
+import type { ChartLineDataItem, ChartLinePoint, XAxisType, YAxisPosition, ChartLineYAxisConfig, LineMode, TimeDisplay } from '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
 import type { ChartDataset } from 'chart.js';
-import type { XAxisType, YAxisPosition, LineMode, TimeDisplay } from '@oicl/openbridge-webcomponents/dist/building-blocks/chart-line/chart-line-base.js';
 import type { InstrumentState, Priority, FrameStyle, BorderRadiusPosition } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
 import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** Simple single-series data (array of {label, value}). */
-    data?: {
-        label: string;
-        value: number;
-    }[];
+    /** Simple single-series data. `{label, value}` items for the category axis; `{x, value}` items for time/number axes (x: epoch ms, ISO string, Date, or Temporal object). Points are drawn in array order (no sorting). */
+    data?: ChartLineDataItem[];
     /** Chart.js-style datasets for multi-series use. If provided, takes precedence over `data`. */
-    datasets?: ChartDataset<"line", (number | {
-        x: string | number | Date;
-        y: number;
-    })[]>[] | undefined;
+    datasets?: ChartDataset<"line", ChartLinePoint[]>[] | undefined;
     /** Optional explicit labels for the x-axis (category mode). If omitted labels are derived from `data` */
     labels?: (string | number)[] | undefined;
     /** Custom color palette (CSS variable names or color strings). */
@@ -28,43 +22,59 @@ export interface Props {
     width?: number;
     /** Height of the chart in pixels. Default: 320. */
     height?: number;
-    /** Enable fixed aspect ratio scaling mode.
-When true, width/height properties define the aspect ratio (not actual pixels).
-The component fills 100% of parent width and calculates height from aspect ratio.
-When false (default), width/height are used as actual pixel dimensions. */
+    /** Enable fixed aspect ratio scaling mode. When true, width/height properties define the aspect ratio (not actual pixels). The component fills 100% of parent width and calculates height from aspect ratio. When false (default), width/height are used as actual pixel dimensions. */
     fixedAspectRatioScaling?: boolean;
-    /** Reference size for external scales when using fixedAspectRatioScaling.
-This value is passed down to external scales to determine their 1:1 Figma design size.
-At this reference size, scales render at native size; above/below they scale proportionally.
-Default: 384 (matches Figma design baseline). */
+    /** Reference size for external scales when using fixedAspectRatioScaling. This value is passed down to external scales to determine their 1:1 Figma design size. At this reference size, scales render at native size; above/below they scale proportionally. Default: 384 (matches Figma design baseline). */
     scaleReferenceSize?: number;
-    /** X-axis mode: 'category' for labeled data points, 'time' for time-based data. */
+    /** X-axis mode: 'category' for labeled, evenly spaced data points; 'time' for time-based data positioned proportionally; 'number' for plain numeric x-values. */
     xAxisType?: XAxisType;
     /** Single y-axis position ('left' or 'right'). For multiple y-axes, use yAxes instead. */
     yAxisPosition?: YAxisPosition;
     /** Multiple y-axis definitions for complex multi-axis charts. */
-    yAxes?: {
-        id?: string | undefined;
-        position?: "left" | "right" | undefined;
-        min?: number | undefined;
-        max?: number | undefined;
-        grid?: boolean | undefined;
-    }[] | undefined;
+    yAxes?: ChartLineYAxisConfig[] | undefined;
     /** Show grid lines. */
     showGrid?: boolean;
-    /** Show vertical grid lines (x-axis). Default: false. */
+    /**
+     * Show vertical grid lines (x-axis). Default: false.
+     *
+     * Available when `showGrid==true`.
+     */
     showGridX?: boolean;
-    /** Show horizontal grid lines (y-axis). Default: false. */
+    /**
+     * Show horizontal grid lines (y-axis). Default: false.
+     *
+     * Available when `showGrid==true`.
+     */
     showGridY?: boolean;
     /** Show axis tick marks and labels. */
     showTickMarks?: boolean;
+    /** Reserve canvas padding for axis tick labels on sides without an external scale.
+
+When `true` (default), the chart leaves room for tick labels and renders them
+(subject to `showTickMarks` and the 192px auto-compact threshold).
+
+When `false`, the chart renders edge-to-edge on sides without a slotted external
+scale AND axis tick labels are force-hidden so they cannot be clipped. This also
+suppresses the automatic edge-to-edge switch that normally happens below the
+192px threshold, eliminating the visible padding "jump" when crossing it.
+
+Useful when embedding the chart inside another component that owns framing
+and never wants to show axis labels (e.g. `obc-automation-tank`).
+
+Defaults to `true` to preserve existing behavior. Declared with `attribute: false`
+because a `true`-default boolean cannot work as an HTML boolean attribute. */
+    hasLabelPadding?: boolean;
     /** Show point markers on data points. Default: false. */
     showPoints?: boolean;
     /** Line drawing style: 'smooth' (curved), 'straight', or 'stepped'. */
     lineMode?: LineMode;
     /** Unit label displayed in tooltips (e.g., 'kW', 'kg', '%'). */
     unit?: string;
-    /** Time axis label format: 'date' (full date/time) or 'minutes' (relative). */
+    /**
+     * Time axis label format: 'date' (full date/time) or 'minutes' (relative).
+     *
+     * Available when `xAxisType==time`.
+     */
     timeDisplay?: TimeDisplay;
     /** Max number of x-axis ticks/grid lines. Useful for matching external axes. */
     xTicksLimit?: number | undefined;
@@ -84,14 +94,13 @@ Default: 384 (matches Figma design baseline). */
     borderRadiusPosition?: BorderRadiusPosition | undefined;
     /** Border radius position for external scales based on layout. */
     borderRadiusPositionExternalScales?: BorderRadiusPosition | undefined;
-    /** When true, the chart is used inside an instrument (e.g., gauge-trend).
-In this mode, only label font size responds to .obc-component-size-* CSS classes.
-Border radius uses the explicit `borderRadius` property value (or defaults to 8px),
-rather than reading from CSS variables. */
+    /** When true, the chart is used inside an instrument (e.g., gauge-trend). In this mode, only label font size responds to .obc-component-size-* CSS classes. Border radius uses the explicit `borderRadius` property value (or defaults to 8px), rather than reading from CSS variables. */
     instrumentMode?: boolean;
-    /** Explicit border radius value in pixels.
-When instrumentMode=true, this value is used directly (defaults to 8px).
-When instrumentMode=false, this is ignored and border radius is read from CSS variable. */
+    /**
+     * Explicit border radius value in pixels. When instrumentMode=true, this value is used directly (defaults to 8px). When instrumentMode=false, this is ignored and border radius is read from CSS variable.
+     *
+     * Available when `instrumentMode==true`.
+     */
     borderRadius?: number | undefined;
 }
 export interface Events {
@@ -101,11 +110,14 @@ export interface Slots {
 }
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcChartLineBase: import("svelte").Component<$$ComponentProps, {
-    ChartDataset: typeof ChartDataset;
+    ChartLineDataItem: typeof ChartLineDataItem;
+    ChartLinePoint: typeof ChartLinePoint;
     XAxisType: typeof XAxisType;
     YAxisPosition: typeof YAxisPosition;
+    ChartLineYAxisConfig: typeof ChartLineYAxisConfig;
     LineMode: typeof LineMode;
     TimeDisplay: typeof TimeDisplay;
+    ChartDataset: typeof ChartDataset;
     InstrumentState: typeof InstrumentState;
     Priority: typeof Priority;
     FrameStyle: typeof FrameStyle;

package/dist/building-blocks/instrument-radial/ObcInstrumentRadial.svelte

@@ -1,11 +1,13 @@
 
   <script lang="ts">
-    export type {InstrumentState, Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+    export type {RadialFrame} from '@oicl/openbridge-webcomponents/dist/svghelpers/radial-frame.js';
+export type {InstrumentState, Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
 export type {ObcGaugeRadialType, GaugeRadialAdvice} from '@oicl/openbridge-webcomponents/dist/building-blocks/instrument-radial/instrument-radial.js';
 export type {TickmarkStyle} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/tickmark.js';
       import '@oicl/openbridge-webcomponents/dist/building-blocks/instrument-radial/instrument-radial.js';
-      import { setProperties } from "../../util.js";
-      import type {InstrumentState, Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
+      import { setProperties, forwardEvents } from "../../util.js";
+      import type {RadialFrame} from '@oicl/openbridge-webcomponents/dist/svghelpers/radial-frame.js';
+import type {InstrumentState, Priority} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
 import type {ObcGaugeRadialType, GaugeRadialAdvice} from '@oicl/openbridge-webcomponents/dist/building-blocks/instrument-radial/instrument-radial.js';
 import type {TickmarkStyle} from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/tickmark.js';
       import type { Snippet } from 'svelte';
@@ -13,47 +15,77 @@ import type {TickmarkStyle} from '@oicl/openbridge-webcomponents/dist/navigation
       export interface Props {
      class?: string;
      style?: string;
+      /** Target setpoint value. `undefined` = no setpoint marker shown. */
+setpoint?: number | undefined;
+      /** Adjustment preview for 2-step interface.
+When defined, two markers are shown: original (dimmed) + new (focus). */
+newSetpoint?: number | undefined;
+      /** Manual at-setpoint override (used when `autoAtSetpoint` is false). */
+atSetpoint?: boolean;
+      /** User is physically interacting with the control.
+Suppresses at-setpoint calculation and triggers focus visual. */
+touching?: boolean;
+      /** When false, uses manual `atSetpoint` boolean instead of auto-calculation. */
+autoAtSetpoint?: boolean;
+      /** Tolerance for auto at-setpoint detection. */
+autoAtSetpointDeadband?: number;
+      /** Tolerance for zero-snap visual state. */
+setpointAtZeroDeadband?: number;
+      /** Override to derive the setpoint color from the instrument's `priority`
+regardless of instrument state. */
+setpointOverride?: boolean;
+      /** Enable CSS-animated confirm transition. */
+animateSetpoint?: boolean;
      state?: InstrumentState;
      priority?: Priority;
      value?: number;
      maxValue?: number;
      minValue?: number;
      getAngle?: (v: number) => number;
+     /** Available when `type!=filled`. */
      needleColor?: string | undefined;
+     /** Available when `type!=needle`. */
      barColor?: string | undefined;
      showLabels?: boolean;
-      /** Interval for primary tickmarks in value units.
-When undefined or <= 0, no primary tickmarks are shown. */
-primaryTickmarkInterval?: number | undefined;
-      /** Interval for secondary tickmarks in value units.
-When undefined or <= 0, no secondary tickmarks are shown. */
-secondaryTickmarkInterval?: number | undefined;
-      /** Interval for tertiary tickmarks in value units.
-When undefined or <= 0, no tertiary tickmarks are shown. */
-tertiaryTickmarkInterval?: number | undefined;
+     /** Interval for primary tickmarks in value units. When undefined or <= 0, no primary tickmarks are shown. */
+     primaryTickmarkInterval?: number | undefined;
+     /** Interval for secondary tickmarks in value units. When undefined or <= 0, no secondary tickmarks are shown. */
+     secondaryTickmarkInterval?: number | undefined;
+     /** Interval for tertiary tickmarks in value units. When undefined or <= 0, no tertiary tickmarks are shown. */
+     tertiaryTickmarkInterval?: number | undefined;
      type?: ObcGaugeRadialType;
      needleType?: ObcGaugeRadialType;
      tickmarksInside?: boolean;
      tickmarkStyle?: TickmarkStyle;
      advices?: GaugeRadialAdvice[];
+     /** Available when `zoomToFitArc==false`. */
      clipTop?: number;
+     /** Available when `zoomToFitArc==false`. */
      clipBottom?: number;
-     zoomToFitArc?: boolean
+     /** Available when `zoomToFitArc==false`. */
+     clipLeft?: number;
+     /** Available when `zoomToFitArc==false`. */
+     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;
+     /** Outer-ring diameter in CSS pixels. When set, the instrument renders at a fixed intrinsic size derived from the ring, arc shape and label reserve — so instruments sharing the same value have identical ring circumference regardless of label width or arc extent (like obc-donut-chart's fixedHeight). When unset (default), the instrument fills its container. */
+     faceDiameter?: number | undefined
    }
       export interface Events {
-    
+    onFrameChanged?: (event: CustomEvent<RadialFrame>) => void
   }
       export interface Slots {
   children?: Snippet
 }
-      const { class: className, style, children, ...props} = $props<Props & Events & Slots>();
+      const {onFrameChanged, class: className, style, children, ...props} = $props<Props & Events & Slots>();
 
     </script>
     <obc-instrument-radial
     use:setProperties={props}
     class={className}
     style={style}
-     >
+    use:forwardEvents={{'frame-changed': onFrameChanged}} >
       
     {#if children}
       {@render children()}

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

@@ -1,4 +1,5 @@
 import '@oicl/openbridge-webcomponents/dist/building-blocks/instrument-radial/instrument-radial.js';
+import type { RadialFrame } from '@oicl/openbridge-webcomponents/dist/svghelpers/radial-frame.js';
 import type { InstrumentState, Priority } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/types.js';
 import type { ObcGaugeRadialType, GaugeRadialAdvice } from '@oicl/openbridge-webcomponents/dist/building-blocks/instrument-radial/instrument-radial.js';
 import type { TickmarkStyle } from '@oicl/openbridge-webcomponents/dist/navigation-instruments/watch/tickmark.js';
@@ -6,40 +7,72 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
+    /** Target setpoint value. `undefined` = no setpoint marker shown. */
+    setpoint?: number | undefined;
+    /** Adjustment preview for 2-step interface.
+When defined, two markers are shown: original (dimmed) + new (focus). */
+    newSetpoint?: number | undefined;
+    /** Manual at-setpoint override (used when `autoAtSetpoint` is false). */
+    atSetpoint?: boolean;
+    /** User is physically interacting with the control.
+Suppresses at-setpoint calculation and triggers focus visual. */
+    touching?: boolean;
+    /** When false, uses manual `atSetpoint` boolean instead of auto-calculation. */
+    autoAtSetpoint?: boolean;
+    /** Tolerance for auto at-setpoint detection. */
+    autoAtSetpointDeadband?: number;
+    /** Tolerance for zero-snap visual state. */
+    setpointAtZeroDeadband?: number;
+    /** Override to derive the setpoint color from the instrument's `priority`
+regardless of instrument state. */
+    setpointOverride?: boolean;
+    /** Enable CSS-animated confirm transition. */
+    animateSetpoint?: boolean;
     state?: InstrumentState;
     priority?: Priority;
     value?: number;
     maxValue?: number;
     minValue?: number;
     getAngle?: (v: number) => number;
+    /** Available when `type!=filled`. */
     needleColor?: string | undefined;
+    /** Available when `type!=needle`. */
     barColor?: string | undefined;
     showLabels?: boolean;
-    /** Interval for primary tickmarks in value units.
-When undefined or <= 0, no primary tickmarks are shown. */
+    /** Interval for primary tickmarks in value units. When undefined or <= 0, no primary tickmarks are shown. */
     primaryTickmarkInterval?: number | undefined;
-    /** Interval for secondary tickmarks in value units.
-When undefined or <= 0, no secondary tickmarks are shown. */
+    /** Interval for secondary tickmarks in value units. When undefined or <= 0, no secondary tickmarks are shown. */
     secondaryTickmarkInterval?: number | undefined;
-    /** Interval for tertiary tickmarks in value units.
-When undefined or <= 0, no tertiary tickmarks are shown. */
+    /** Interval for tertiary tickmarks in value units. When undefined or <= 0, no tertiary tickmarks are shown. */
     tertiaryTickmarkInterval?: number | undefined;
     type?: ObcGaugeRadialType;
     needleType?: ObcGaugeRadialType;
     tickmarksInside?: boolean;
     tickmarkStyle?: TickmarkStyle;
     advices?: GaugeRadialAdvice[];
+    /** Available when `zoomToFitArc==false`. */
     clipTop?: number;
+    /** Available when `zoomToFitArc==false`. */
     clipBottom?: number;
+    /** Available when `zoomToFitArc==false`. */
+    clipLeft?: number;
+    /** Available when `zoomToFitArc==false`. */
+    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;
+    /** Outer-ring diameter in CSS pixels. When set, the instrument renders at a fixed intrinsic size derived from the ring, arc shape and label reserve — so instruments sharing the same value have identical ring circumference regardless of label width or arc extent (like obc-donut-chart's fixedHeight). When unset (default), the instrument fills its container. */
+    faceDiameter?: number | undefined;
 }
 export interface Events {
+    onFrameChanged?: (event: CustomEvent<RadialFrame>) => void;
 }
 export interface Slots {
     children?: Snippet;
 }
 type $$ComponentProps = Props & Events & Slots;
 declare const ObcInstrumentRadial: import("svelte").Component<$$ComponentProps, {
+    RadialFrame: typeof RadialFrame;
     InstrumentState: typeof InstrumentState;
     Priority: typeof Priority;
     ObcGaugeRadialType: typeof ObcGaugeRadialType;