feat(#87): configurable min state threshold

Author: MindFreeze

README.md

@@ -32,6 +32,7 @@ This card is intended to display connections between entities with numeric state
 | show_units        | boolean | **Optional** | true                | Display unit of measurement
 | min_box_height    | number  | **Optional** | 3                   | Minimum size of an entity box
 | min_box_distance  | number  | **Optional** | 5                   | Minimum space between entity boxes
+| min_state         | number  | **Optional** | 0+                  | Any entity below this value will not be displayed. The default is to show everything above 0
 | throttle          | number  | **Optional** |                     | Minimum time in ms between updates/rerenders
 
 ### Sections object

src/chart.ts

@@ -227,14 +227,16 @@ export class Chart extends LitElement {
         let total = 0;
         const boxes: Box[] = section.entities
           .filter(entityConf => {
+            const {min_state} = this.config;
             // remove empty entity boxes
             if (entityConf.type === 'remaining_parent_state') {
-              return this.connectionsByChild.get(entityConf)?.some(c => c.state);
+              return this.connectionsByChild.get(entityConf)?.some(c => c.state && c.state >= min_state);
             }
             if (entityConf.type === 'remaining_child_state') {
-              return this.connectionsByParent.get(entityConf)?.some(c => c.state);
+              return this.connectionsByParent.get(entityConf)?.some(c => c.state && c.state >= min_state);
             }
-            return this._getMemoizedState(entityConf).state;
+            const { state } = this._getMemoizedState(entityConf);
+            return state && state >= min_state;
           })
           .map(entityConf => {
             const { state, unit_of_measurement } = this._getMemoizedState(entityConf);

src/types.ts

@@ -66,6 +66,7 @@ export interface SankeyChartConfig extends LovelaceCardConfig {
   min_box_height?: number,
   min_box_distance?: number,
   throttle?: number,
+  min_state?: number,
 }
 
 export interface Section {
@@ -80,6 +81,7 @@ export interface Config extends SankeyChartConfig {
   height: number;
   min_box_height: number;
   min_box_distance: number;
+  min_state: number;
   sections: Section[];
 }
 

src/utils.ts

@@ -173,6 +173,7 @@ export function normalizeConfig(conf: SankeyChartConfig): Config {
     show_states: true,
     show_units: true,
     ...config,
+    min_state: config.min_state ? Math.abs(config.min_state) : 0,
     sections,
   };
 }