@meshmakers/octo-meshboard 3.5.480 → 3.5.500

package/README.md

@@ -240,6 +240,7 @@ interface KpiWidgetConfig {
   suffix?: string;
   icon?: string;
   trend?: 'up' | 'down' | 'neutral';
+  decimalPlaces?: number;
   // For persistent query mode
   queryMode?: 'simpleCount' | 'aggregation' | 'groupedAggregation';
   queryValueField?: string;
@@ -247,6 +248,21 @@ interface KpiWidgetConfig {
 }
 ```
 
+Numbers are formatted with the `de-AT` locale. Without `decimalPlaces` a fractional value shows two
+fraction digits and a whole number none (38.9 -> `38,90`, 46 -> `46`). With `decimalPlaces` every numeric
+value shows exactly that many (`decimalPlaces: 1`: 38.9 -> `38,9`, 46 -> `46,0`). In a seed, set it in the
+widget `Config` JSON, e.g. `{"valueMode":"formula","formula":"...","decimalPlaces":1}`; the configuration
+dialog offers it as *Decimal Places* (AB#7686). Valid values are the JSON numbers 0-3 (integers); anything
+else (a string such as `"1"`, a fraction, a negative value, 4 or more, other types) falls back to the automatic
+format. Unlike the heatmap's `decimalPlaces` (a maximum, default 2), the KPI value is an exact digit count and
+unset means automatic; both widgets format through the shared `formatWidgetNumber` (`utils/widget-data-utils.ts`,
+cached `Intl.NumberFormat` instances). With `decimalPlaces` set, a text value is parsed strictly: only a string
+that is a complete number (`"12"`, `" 12 "`, `"1e3"`) is formatted, anything else (`"12 kWh"`, an ISO date,
+`"12,5"`) is shown unchanged. Without `decimalPlaces` the previous lenient parsing stays (`"12 kWh"` -> `12`).
+A negative value that rounds to zero is shown without a sign (`-0.04` with 1 -> `0,0`). The setting also
+applies to KPI children of a widget group (`childTemplate.staticConfig.decimalPlaces`, also offered in the
+widget-group configuration dialog).
+
 ### Gauge Widget
 Displays a numeric value as arc, circular, linear, or radial gauge.