@oicl/openbridge-webcomponents-svelte 2.0.0-next.131 → 2.0.0-next.133

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

@@ -13,50 +13,48 @@ import type {InstrumentState, Priority, FrameStyle, BorderRadiusPosition} from '
       export interface Props {
      class?: string;
      style?: string;
-      /** 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. */
-showGridX?: boolean;
-      /** Show horizontal grid lines (y-axis). Default: false. */
-showGridY?: boolean;
-      /** Show axis tick marks and labels. */
-showTickMarks?: boolean;
+     /** 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
@@ -73,41 +71,44 @@ 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). */
-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
+     /** 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

@@ -6,9 +6,7 @@ import type { Snippet } from 'svelte';
 export interface Props {
     class?: string;
     style?: string;
-    /** 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). */
+    /** 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;
@@ -24,19 +22,11 @@ or Temporal object). Points are drawn in array order (no sorting). */
     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, evenly spaced data points; 'time'
-for time-based data positioned proportionally; 'number' for plain
-numeric x-values. */
+    /** 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;
@@ -44,9 +34,17 @@ numeric x-values. */
     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;
@@ -72,7 +70,11 @@ because a `true`-default boolean cannot work as an HTML boolean attribute. */
     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;
@@ -92,14 +94,13 @@ because a `true`-default boolean cannot work as an HTML boolean attribute. */
     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 {

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

@@ -42,38 +42,35 @@ animateSetpoint?: boolean;
      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;
+     /** 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;
+     /** 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
+     /** 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

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

@@ -34,37 +34,34 @@ regardless of instrument state. */
     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. */
+    /** 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. */
+    /** 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 {

package/dist/building-blocks/readout-block/ObcReadoutBlock.svelte

@@ -15,65 +15,66 @@ import type {AlertFrameConfig} from '@oicl/openbridge-webcomponents/dist/compone
       export interface Props {
      class?: string;
      style?: string;
-      /** Semantic variant (value / setpoint / advice). */
-variant?: ReadoutBlockVariant;
+     /** Semantic variant (value / setpoint / advice). */
+     variant?: ReadoutBlockVariant;
       /** [object Object],[object Object],[object Object] */
 value?: string | number | null;
       /** [object Object],[object Object],[object Object] */
 valueType?: ReadoutValueType;
-      /** Density tier — icon size, gap, degree tier. */
-size?: ReadoutBlockSize;
-      /** Resolved number-typography size. When unset it is derived from `size`
-(small→s, medium→m, large→l), so a parent that de-emphasises a block (e.g.
-a secondary setpoint) can pass a smaller size without changing the tier. */
-valueSize?: ObcTextboxSize | undefined;
-      /** Accent (in-command) colour tone. */
-enhanced?: boolean;
-      /** Number font weight (regular / semibold / bold); colour is independent. */
-weight?: ObcTextboxFontWeight;
-      /** Render the trailing cap-height degree glyph (`°`). */
-hasDegree?: boolean;
-      /** Show the leading marker-icon container (always on for setpoint/advice). */
-hasIcon?: boolean;
-      /** Number of fraction digits. Must be between 0 and 100 — the range
-`Number.prototype.toFixed` accepts; outside it throws a `RangeError`.
-A fractional count truncates (`2.7` → `2`). A count that never arrived
-(`NaN`, `null` or unset) renders the reading as the unavailable dash —
-formatting with a precision the author never chose would let a critical
-`0.4` pass for a healthy `0`. */
-fractionDigits?: number;
-      /** Integer digits to reserve / hint (independent of `fractionDigits`).
-Bounded before use: a fractional count
-truncates (`2.7` → `2`), anything above 100 — including `Infinity` —
-caps at 100, and a negative count reserves nothing. A count that never
-arrived (`NaN`, `null` or unset) renders the reading as the unavailable
-dash, consistent with `fractionDigits`. */
-maxDigits?: number;
-      /** Render muted leading zeros filling the integer part to `maxDigits`. */
-hintedZeros?: boolean;
-      /** Explicit longest string to reserve width for (e.g. `"0000.0"`). */
-spaceReserver?: string | undefined;
-      /** Render `offText` instead of a number (e.g. equipment powered down). */
-off?: boolean;
-      /** Text shown when `off` is true. */
-offText?: string;
-      /** Text alignment of the number within its reserved width. */
-alignment?: ObcTextboxAlignment;
+     /** Density tier — icon size, gap, degree tier. */
+     size?: ReadoutBlockSize;
+     /** Resolved number-typography size. When unset it is derived from `size` (small→s, medium→m, large→l), so a parent that de-emphasises a block (e.g. a secondary setpoint) can pass a smaller size without changing the tier. */
+     valueSize?: ObcTextboxSize | undefined;
+     /** Accent (in-command) colour tone. */
+     enhanced?: boolean;
+     /** Number font weight (regular / semibold / bold); colour is independent. */
+     weight?: ObcTextboxFontWeight;
+     /** Render the trailing cap-height degree glyph (`°`). */
+     hasDegree?: boolean;
+     /** Show the leading marker-icon container (always on for setpoint/advice). */
+     hasIcon?: boolean;
+     /**
+      * Number of fraction digits. Must be between 0 and 100 — the range `Number.prototype.toFixed` accepts; outside it throws a `RangeError`. A fractional count truncates (`2.7` → `2`). A count that never arrived (`NaN`, `null` or unset) renders the reading as the unavailable dash — formatting with a precision the author never chose would let a critical `0.4` pass for a healthy `0`.
+      *
+      * Available when `valueType==number`.
+      */
+     fractionDigits?: number;
+     /**
+      * Integer digits to reserve / hint (independent of `fractionDigits`). Bounded before use: a fractional count truncates (`2.7` → `2`), anything above 100 — including `Infinity` — caps at 100, and a negative count reserves nothing. A count that never arrived (`NaN`, `null` or unset) renders the reading as the unavailable dash, consistent with `fractionDigits`.
+      *
+      * Available when `valueType==number`.
+      */
+     maxDigits?: number;
+     /**
+      * Render muted leading zeros filling the integer part to `maxDigits`.
+      *
+      * Available when `valueType==number`.
+      */
+     hintedZeros?: boolean;
+     /** Explicit longest string to reserve width for (e.g. `"0000.0"`). */
+     spaceReserver?: string | undefined;
+     /** Render `offText` instead of a number (e.g. equipment powered down). */
+     off?: boolean;
+     /** Text shown when `off` is true. */
+     offText?: string;
+     /** Text alignment of the number within its reserved width. */
+     alignment?: ObcTextboxAlignment;
       /** [object Object],[object Object],[object Object] */
 category?: ReadoutAdviceCategory;
-      /** The advice is triggered: the marker swaps to its filled/status icon and
-the number takes the category's triggered styling (SemiBold for
-regular/optimal/eco, active text colour for the alert categories). Only
-meaningful for `variant="advice"`. */
-active?: boolean;
-      /** Per-block measurement quality (outline chip). */
-dataQuality?: ReadoutBlockDataQuality | undefined;
-      /** Per-block alert frame; nests inside any parent alert frame. */
-alert?: boolean | AlertFrameConfig;
-      /** Setpoint focus (touch) state — only meaningful for `role="setpoint"`. */
-touching?: boolean;
-      /** Setpoint pop-up fade phase — only meaningful for `role="setpoint"`. */
-hidePhase?: ReadoutBlockHidePhase
+     /**
+      * The advice is triggered: the marker swaps to its filled/status icon and the number takes the category's triggered styling (SemiBold for regular/optimal/eco, active text colour for the alert categories). Only meaningful for `variant="advice"`.
+      *
+      * Available when `variant==advice`.
+      */
+     active?: boolean;
+     /** Per-block measurement quality (outline chip). */
+     dataQuality?: ReadoutBlockDataQuality | undefined;
+     /** Per-block alert frame; nests inside any parent alert frame. */
+     alert?: boolean | AlertFrameConfig;
+     /** Setpoint focus (touch) state — only meaningful for `role="setpoint"`. */
+     touching?: boolean;
+     /** Setpoint pop-up fade phase — only meaningful for `role="setpoint"`. */
+     hidePhase?: ReadoutBlockHidePhase
    }
       export interface Events {
     

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

@@ -15,9 +15,7 @@ export interface Props {
     valueType?: ReadoutValueType;
     /** Density tier — icon size, gap, degree tier. */
     size?: ReadoutBlockSize;
-    /** Resolved number-typography size. When unset it is derived from `size`
-(small→s, medium→m, large→l), so a parent that de-emphasises a block (e.g.
-a secondary setpoint) can pass a smaller size without changing the tier. */
+    /** Resolved number-typography size. When unset it is derived from `size` (small→s, medium→m, large→l), so a parent that de-emphasises a block (e.g. a secondary setpoint) can pass a smaller size without changing the tier. */
     valueSize?: ObcTextboxSize | undefined;
     /** Accent (in-command) colour tone. */
     enhanced?: boolean;
@@ -27,21 +25,23 @@ a secondary setpoint) can pass a smaller size without changing the tier. */
     hasDegree?: boolean;
     /** Show the leading marker-icon container (always on for setpoint/advice). */
     hasIcon?: boolean;
-    /** Number of fraction digits. Must be between 0 and 100 — the range
-`Number.prototype.toFixed` accepts; outside it throws a `RangeError`.
-A fractional count truncates (`2.7` → `2`). A count that never arrived
-(`NaN`, `null` or unset) renders the reading as the unavailable dash —
-formatting with a precision the author never chose would let a critical
-`0.4` pass for a healthy `0`. */
+    /**
+     * Number of fraction digits. Must be between 0 and 100 — the range `Number.prototype.toFixed` accepts; outside it throws a `RangeError`. A fractional count truncates (`2.7` → `2`). A count that never arrived (`NaN`, `null` or unset) renders the reading as the unavailable dash — formatting with a precision the author never chose would let a critical `0.4` pass for a healthy `0`.
+     *
+     * Available when `valueType==number`.
+     */
     fractionDigits?: number;
-    /** Integer digits to reserve / hint (independent of `fractionDigits`).
-Bounded before use: a fractional count
-truncates (`2.7` → `2`), anything above 100 — including `Infinity` —
-caps at 100, and a negative count reserves nothing. A count that never
-arrived (`NaN`, `null` or unset) renders the reading as the unavailable
-dash, consistent with `fractionDigits`. */
+    /**
+     * Integer digits to reserve / hint (independent of `fractionDigits`). Bounded before use: a fractional count truncates (`2.7` → `2`), anything above 100 — including `Infinity` — caps at 100, and a negative count reserves nothing. A count that never arrived (`NaN`, `null` or unset) renders the reading as the unavailable dash, consistent with `fractionDigits`.
+     *
+     * Available when `valueType==number`.
+     */
     maxDigits?: number;
-    /** Render muted leading zeros filling the integer part to `maxDigits`. */
+    /**
+     * Render muted leading zeros filling the integer part to `maxDigits`.
+     *
+     * Available when `valueType==number`.
+     */
     hintedZeros?: boolean;
     /** Explicit longest string to reserve width for (e.g. `"0000.0"`). */
     spaceReserver?: string | undefined;
@@ -53,10 +53,11 @@ dash, consistent with `fractionDigits`. */
     alignment?: ObcTextboxAlignment;
     /** [object Object],[object Object],[object Object] */
     category?: ReadoutAdviceCategory;
-    /** The advice is triggered: the marker swaps to its filled/status icon and
-the number takes the category's triggered styling (SemiBold for
-regular/optimal/eco, active text colour for the alert categories). Only
-meaningful for `variant="advice"`. */
+    /**
+     * The advice is triggered: the marker swaps to its filled/status icon and the number takes the category's triggered styling (SemiBold for regular/optimal/eco, active text colour for the alert categories). Only meaningful for `variant="advice"`.
+     *
+     * Available when `variant==advice`.
+     */
     active?: boolean;
     /** Per-block measurement quality (outline chip). */
     dataQuality?: ReadoutBlockDataQuality | undefined;

package/dist/building-blocks/single-axis-inclinometer/SingleAxisInclinometer.svelte

@@ -10,12 +10,8 @@
      class?: string;
      style?: string;
      zoomToFitArc?: boolean;
-      /** When `true`, the centre shows an `<obc-readout>` with the value instead of
-the horizon line, rotating indicator and vessel. Default `false`. */
-hasReadout?: boolean;
-      /** Colour palette for the scale fill / indicator and the readout value:
-`regular` (default) or `enhanced`. */
-priority?: Priority;
+     hasReadout?: boolean;
+     priority?: Priority;
       /** Half-extent of the watch arc in degrees. The arc spans `centre ± arcAngle`
 and values are placed at their true position within it. Default `45`
 reproduces the historical 90°-wide arc.

package/dist/building-blocks/single-axis-inclinometer/SingleAxisInclinometer.svelte.d.ts

@@ -5,11 +5,7 @@ export interface Props {
     class?: string;
     style?: string;
     zoomToFitArc?: boolean;
-    /** When `true`, the centre shows an `<obc-readout>` with the value instead of
-the horizon line, rotating indicator and vessel. Default `false`. */
     hasReadout?: boolean;
-    /** Colour palette for the scale fill / indicator and the readout value:
-`regular` (default) or `enhanced`. */
     priority?: Priority;
     /** Half-extent of the watch arc in degrees. The arc spans `centre ± arcAngle`
 and values are placed at their true position within it. Default `45`