feat(config-panel): add reset functionality for helper categories to default values

Author: snootched

src/core/helpers/lcards-helper-manager.js

@@ -319,7 +319,8 @@ export class LCARdSHelperManager extends BaseService {
 
     for (const helper of allHelpers) {
       try {
-        const result = await ensureHelper(this.hass, helper);
+        // Delegate to this.ensureHelper so default values are set on creation
+        const result = await this.ensureHelper(helper.key);
 
         if (result.exists) {
           results.existing++;
@@ -358,7 +359,76 @@ export class LCARdSHelperManager extends BaseService {
       throw new Error(`[HelperManager] Helper not found in registry: ${key}`);
     }
 
-    return await ensureHelper(this.hass, definition);
+    // Helpers with ws_create_params === null cannot be created via the API
+    // (e.g. template sensors — must be configured manually in configuration.yaml)
+    if (definition.ws_create_params === null) {
+      lcardsLog.debug(`[HelperManager] Skipping non-creatable helper: ${key} (${definition.entity_id})`);
+      return {
+        exists: apiHelperExists(this.hass, definition.entity_id),
+        created: false,
+        skipped: true,
+        entity_id: definition.entity_id
+      };
+    }
+
+    const result = await ensureHelper(this.hass, definition);
+
+    // Set the registry default_value whenever a helper is freshly created
+    if (result.created && definition.default_value !== undefined && definition.default_value !== null) {
+      try {
+        // Small delay to let HA register the entity before we write to it
+        await new Promise(resolve => setTimeout(resolve, 300));
+        await apiSetHelperValue(this.hass, definition.entity_id, definition.default_value);
+        lcardsLog.info(`[HelperManager] Set default value for new helper ${key}: ${definition.default_value}`);
+      } catch (error) {
+        lcardsLog.warn(`[HelperManager] Could not set default value for ${key}:`, error);
+      }
+    }
+
+    return result;
+  }
+
+  /**
+   * Reset all helpers in a category (or all helpers) to their registry default values.
+   * Only affects helpers that already exist in Home Assistant.
+   *
+   * @param {string|null} category - Category name, or null to reset all
+   * @returns {Promise<{success: number, failed: number, skipped: number}>}
+   */
+  async resetCategoryToDefaults(category = null) {
+    if (!this.hass) {
+      throw new Error('[HelperManager] Cannot reset helpers - HASS not available');
+    }
+
+    const helpers = category ? getHelpersByCategory(category) : getAllHelpers();
+    const results = { success: 0, failed: 0, skipped: 0 };
+
+    for (const helper of helpers) {
+      // Skip helpers that don't exist yet
+      if (!apiHelperExists(this.hass, helper.entity_id)) {
+        results.skipped++;
+        continue;
+      }
+
+      // Skip helpers with no defined default
+      if (helper.default_value === undefined || helper.default_value === null) {
+        results.skipped++;
+        continue;
+      }
+
+      try {
+        await apiSetHelperValue(this.hass, helper.entity_id, helper.default_value);
+        this._valueCache.set(helper.key, helper.default_value);
+        lcardsLog.debug(`[HelperManager] Reset ${helper.key} -> ${helper.default_value}`);
+        results.success++;
+      } catch (error) {
+        lcardsLog.error(`[HelperManager] Failed to reset ${helper.key}:`, error);
+        results.failed++;
+      }
+    }
+
+    lcardsLog.info(`[HelperManager] Reset complete: ${results.success} reset, ${results.skipped} skipped, ${results.failed} failed`);
+    return results;
   }
 
   // ===== PUBLIC API: STATE ACCESS =====

src/panels/lcards-config-panel.js

@@ -623,6 +623,36 @@ export class LCARdSConfigPanel extends LitElement {
     }
   }
 
+  async _resetCategoryToDefaults(category) {
+    if (!window.lcards?.core?.helperManager) {
+      this._showError('Helper Manager not available');
+      return;
+    }
+
+    const helperManager = window.lcards.core.helperManager;
+
+    try {
+      const results = await helperManager.resetCategoryToDefaults(category);
+
+      if (results.success > 0) {
+        this._showSuccess(`Reset ${results.success} helper(s) to defaults`);
+      } else if (results.skipped > 0 && results.failed === 0) {
+        this._showSuccess('All helpers already at defaults (or none exist yet)');
+      }
+
+      if (results.failed > 0) {
+        this._showError(`Failed to reset ${results.failed} helper(s)`);
+      }
+
+      // Reload helper status to reflect new values
+      await this._loadHelperStatus();
+      this.requestUpdate();
+    } catch (error) {
+      lcardsLog.error('[ConfigPanel] Failed to reset category to defaults:', error);
+      this._showError(`Error: ${error.message}`);
+    }
+  }
+
   async _setHelperValue(key, value) {
     if (!window.lcards?.core?.helperManager) {
       return;
@@ -895,6 +925,14 @@ export class LCARdSConfigPanel extends LitElement {
               .totalCount=${totalCount}
               ?expanded=${isExpanded}
               @toggle=${() => this._toggleCategory(category)}>
+              <div class="category-actions" style="display: flex; justify-content: flex-end; padding: 4px 0 8px;">
+                <ha-button
+                  @click=${(e) => { e.stopPropagation(); this._resetCategoryToDefaults(category); }}
+                  title="Reset all helpers in this section to their registry default values">
+                  <ha-icon slot="start" icon="mdi:restore"></ha-icon>
+                  Reset to Defaults
+                </ha-button>
+              </div>
               <table class="helper-table">
                 <thead>
                   <tr>
@@ -1033,20 +1071,22 @@ export class LCARdSConfigPanel extends LitElement {
           ${helper.exists ? this._renderValueControl(helper) : '-'}
         </td>
         <td>
-          ${!helper.exists ? html`
+          ${helper.exists ? html`
+            <ha-button
+              @click=${() => this._showMoreInfo(helper.entity_id)}
+            >
+              <ha-icon slot="start" icon="mdi:magnify"></ha-icon>
+              Inspect
+            </ha-button>
+          ` : helper.ws_create_params !== null ? html`
             <ha-button
               @click=${() => this._createHelper(helper.key)}
             >
               <ha-icon slot="start" icon="mdi:plus"></ha-icon>
               Create
             </ha-button>
           ` : html`
-            <ha-button
-              @click=${() => this._showMoreInfo(helper.entity_id)}
-            >
-              <ha-icon slot="start" icon="mdi:magnify"></ha-icon>
-              Inspect
-            </ha-button>
+            <span style="font-size: 12px; color: var(--secondary-text-color); font-style: italic;">Manual setup required</span>
           `}
         </td>
       </tr>