@oicl/openbridge-webcomponents-svelte 2.0.0-next.121 → 2.0.0-next.122

package/dist/automation/automation-tank/ObcAutomationTank.svelte

@@ -52,9 +52,10 @@ animateSetpoint?: boolean;
      orientation?: TankOrientation;
      compact?: boolean;
       /** Host positioning model — see `TankPositioning` for details. Defaults to
-`button` (host fills parent container, 100% × 100%, no anchor offset).
-Set to `point` for the legacy P&ID canvas mode (fixed default dimensions
-+ top-center anchor offset). */
+`button` (host fills parent container, 100% × 100%, falling back to the
+design aspect ratio on any axis the parent leaves indefinite, no anchor
+offset). Set to `point` for the legacy P&ID canvas mode (fixed default
+dimensions + top-center anchor offset). */
 positioning?: TankPositioning;
       /** Static (display-only) variant. Always rendered at the compact size; the
 inner chart/bar is hidden, the bordered area is filled with
@@ -67,7 +68,33 @@ Static tanks render as a non-interactive `<div role="img">` (not a
 `<button>`), so they are not in the tab order and do not announce as
 activatable controls. */
 static?: boolean;
-      /** Enables the activated background color, used to indicate that the tank is activated/selected. */
+      /** Whether the tank is interactive. `true` (default) renders the root as a
+`<button>` with the full flat-mixin interaction surface. `false` renders a
+non-interactive `<div>` — the resting appearance is unchanged (same
+enabled-state colors and the same 1px border box, via the mixin's
+`noClick` variant), but the hover / pressed / focus-visible states are
+gone and the tank leaves the tab order.
+
+Everything else keeps rendering: the chart / bar, badges, readout, tag and
+the `alert` frame all behave exactly as they do on a clickable tank. Use
+this for a display-only tank that still shows live data — e.g. a row total
+aggregating the tanks beside it. For "device present, current state
+unknown" use `static` instead, which also hides the chart and shrinks to
+the compact footprint.
+
+`static` is already non-interactive, so this has no effect there.
+
+Property-only (`attribute: false`, per the repo's positive-default-true
+boolean convention — a `true` default cannot round-trip through an HTML
+boolean attribute). Set it as a property: `el.clickable = false`,
+`.clickable=${false}` in a Lit template, or the equivalent binding in the
+React / Vue / Angular / Svelte wrappers. A `clickable="false"` attribute in
+plain HTML is **not** observed and leaves the tank interactive. */
+clickable?: boolean;
+      /** Enables the activated background color, used to indicate that the tank is
+activated/selected. Requires an interactive tank — the `noClick` mixin
+variant used when `clickable` is `false` only paints the enabled state, so
+a non-clickable tank ignores this (matching `obc-elevated-card`). */
 activated?: boolean;
      tag?: string;
       /** Chart cell rendering mode.

package/dist/automation/automation-tank/ObcAutomationTank.svelte.d.ts

@@ -40,9 +40,10 @@ regardless of instrument state. */
     orientation?: TankOrientation;
     compact?: boolean;
     /** Host positioning model — see `TankPositioning` for details. Defaults to
-`button` (host fills parent container, 100% × 100%, no anchor offset).
-Set to `point` for the legacy P&ID canvas mode (fixed default dimensions
-+ top-center anchor offset). */
+`button` (host fills parent container, 100% × 100%, falling back to the
+design aspect ratio on any axis the parent leaves indefinite, no anchor
+offset). Set to `point` for the legacy P&ID canvas mode (fixed default
+dimensions + top-center anchor offset). */
     positioning?: TankPositioning;
     /** Static (display-only) variant. Always rendered at the compact size; the
 inner chart/bar is hidden, the bordered area is filled with
@@ -55,7 +56,33 @@ Static tanks render as a non-interactive `<div role="img">` (not a
 `<button>`), so they are not in the tab order and do not announce as
 activatable controls. */
     static?: boolean;
-    /** Enables the activated background color, used to indicate that the tank is activated/selected. */
+    /** Whether the tank is interactive. `true` (default) renders the root as a
+`<button>` with the full flat-mixin interaction surface. `false` renders a
+non-interactive `<div>` — the resting appearance is unchanged (same
+enabled-state colors and the same 1px border box, via the mixin's
+`noClick` variant), but the hover / pressed / focus-visible states are
+gone and the tank leaves the tab order.
+
+Everything else keeps rendering: the chart / bar, badges, readout, tag and
+the `alert` frame all behave exactly as they do on a clickable tank. Use
+this for a display-only tank that still shows live data — e.g. a row total
+aggregating the tanks beside it. For "device present, current state
+unknown" use `static` instead, which also hides the chart and shrinks to
+the compact footprint.
+
+`static` is already non-interactive, so this has no effect there.
+
+Property-only (`attribute: false`, per the repo's positive-default-true
+boolean convention — a `true` default cannot round-trip through an HTML
+boolean attribute). Set it as a property: `el.clickable = false`,
+`.clickable=${false}` in a Lit template, or the equivalent binding in the
+React / Vue / Angular / Svelte wrappers. A `clickable="false"` attribute in
+plain HTML is **not** observed and leaves the tank interactive. */
+    clickable?: boolean;
+    /** Enables the activated background color, used to indicate that the tank is
+activated/selected. Requires an interactive tank — the `noClick` mixin
+variant used when `clickable` is `false` only paints the enabled state, so
+a non-clickable tank ignores this (matching `obc-elevated-card`). */
     activated?: boolean;
     tag?: string;
     /** Chart cell rendering mode.

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

@@ -35,9 +35,19 @@ weight?: ObcTextboxFontWeight;
 hasDegree?: boolean;
       /** Show the leading marker-icon container (always on for setpoint/advice). */
 hasIcon?: boolean;
-      /** Number of fraction digits. */
+      /** 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`). */
+      /** 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;

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

@@ -27,9 +27,19 @@ 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. */
+    /** 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`). */
+    /** 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;

package/dist/navigation-instruments/readout/ObcReadout.svelte

@@ -47,10 +47,19 @@ offText?: string;
      hasDegree?: boolean;
      hasDegreeSpacer?: boolean;
       /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
       /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
      dataQuality?: ReadoutBlockDataQuality | undefined;
      alert?: boolean | AlertFrameConfig;

package/dist/navigation-instruments/readout/ObcReadout.svelte.d.ts

@@ -37,10 +37,19 @@ value block at full size, so the layout does not shift when data arrives. */
     hasDegree?: boolean;
     hasDegreeSpacer?: boolean;
     /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
     /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
     dataQuality?: ReadoutBlockDataQuality | undefined;
     alert?: boolean | AlertFrameConfig;

package/dist/navigation-instruments/readout-list-item/ObcReadoutListItem.svelte

@@ -43,10 +43,19 @@ offText?: string;
      hasDegree?: boolean;
      hasDegreeSpacer?: boolean;
       /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
       /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
      dataQuality?: ReadoutBlockDataQuality | undefined;
      alert?: boolean | AlertFrameConfig;

package/dist/navigation-instruments/readout-list-item/ObcReadoutListItem.svelte.d.ts

@@ -35,10 +35,19 @@ block at full size, so the row does not shift when data arrives. */
     hasDegree?: boolean;
     hasDegreeSpacer?: boolean;
     /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
     /** Also formats the numeric setpoint / advice blocks, which stay numeric
-even when the value is text. */
+even when the value is text. 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;
     dataQuality?: ReadoutBlockDataQuality | undefined;
     alert?: boolean | AlertFrameConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oicl/openbridge-webcomponents-svelte",
-  "version": "2.0.0-next.121",
+  "version": "2.0.0-next.122",
   "scripts": {
     "dev": "vite dev",
     "build": "vite build && npm run prepack",
@@ -31,7 +31,7 @@
     }
   },
   "dependencies": {
-    "@oicl/openbridge-webcomponents": "^2.0.0-next.120"
+    "@oicl/openbridge-webcomponents": "^2.0.0-next.121"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"