diff --git a/README.md b/README.md
index 89913cf..ddf29bb 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
[](https://github.com/ccpk1/choreops)
[](https://github.com/ccpk1/choreops/actions/workflows/lint-validation.yaml)
[](https://crowdin.com/project/choreops-translations)
-[](https://github.com/ccpk1/choreops/blob/main/LICENSE)
+[](https://github.com/ccpk1/choreops/blob/main/LICENSE)
[](https://github.com/custom-components/hacs)
[](https://github.com/ccpk1/choreops/releases)
[](https://github.com/ccpk1/choreops/stargazers)
@@ -98,9 +98,13 @@ ChoreOps ships with a functional dashboard starter experience, but it is designe
- **Rich sensor data**: granular attributes for dashboards and analytics
- **Service-level control**: automate create/claim/approve/redeem/adjust actions
+- **Live chore CRUD updates**: chore create, edit, and delete update runtime sensors, workflow buttons, and dashboard helper payloads without a full integration reload
- **Automation-first architecture**: integrate with scripts, automations, dashboards, voice, and Node-RED
- **Multi-instance support**: run multiple ChoreOps entries in the same Home Assistant instance
+> [!TIP]
+> Chore create, edit, and delete now update runtime chore entities live. Sanctioned system settings changes still reload the integration when that remains the correct Home Assistant boundary.
+
---
### 📸 See ChoreOps in Action
diff --git a/custom_components/choreops/__init__.py b/custom_components/choreops/__init__.py
index a2c5160..ec7122d 100644
--- a/custom_components/choreops/__init__.py
+++ b/custom_components/choreops/__init__.py
@@ -433,6 +433,7 @@ async def async_unload_entry(hass: HomeAssistant, entry: ChoreOpsConfigEntry) ->
coordinator = entry.runtime_data
if coordinator:
coordinator._persist(immediate=True) # Unload must be immediate
+ coordinator.ui_manager.clear_runtime_state()
const.LOGGER.debug("Forced immediate persist before unload")
# Clear translation cache to prevent stale translations on reload
diff --git a/custom_components/choreops/button.py b/custom_components/choreops/button.py
index 5887e93..bc5caa0 100644
--- a/custom_components/choreops/button.py
+++ b/custom_components/choreops/button.py
@@ -21,6 +21,7 @@
from homeassistant.core import HomeAssistant
from homeassistant.exceptions import HomeAssistantError
from homeassistant.helpers.entity_platform import AddEntitiesCallback
+from homeassistant.helpers.entity_registry import async_get
from . import const
from .coordinator import ChoreOpsConfigEntry, ChoreOpsDataCoordinator
@@ -48,6 +49,153 @@
PARALLEL_UPDATES = 1
+_async_add_entities_callback: AddEntitiesCallback | None = None
+
+
+def register_chore_button_callback(async_add_entities: AddEntitiesCallback) -> None:
+ """Register async_add_entities callback for dynamic chore button creation."""
+ global _async_add_entities_callback # noqa: PLW0603
+ _async_add_entities_callback = async_add_entities
+
+
+def _button_entity_exists(
+ coordinator: ChoreOpsDataCoordinator,
+ unique_id: str,
+) -> bool:
+ """Return whether a button entity with the given unique ID already exists."""
+ entity_registry = async_get(coordinator.hass)
+ return (
+ entity_registry.async_get_entity_id("button", const.DOMAIN, unique_id)
+ is not None
+ )
+
+
+def create_chore_button_entities(
+ coordinator: ChoreOpsDataCoordinator,
+ chore_id: str,
+ *,
+ assignee_ids: list[str] | None = None,
+ replace_existing: bool = False,
+) -> int:
+ """Create missing chore-linked workflow buttons for a chore.
+
+ Args:
+ coordinator: Runtime coordinator.
+ chore_id: Internal ID of the chore.
+ assignee_ids: Optional subset of assignee IDs to create buttons for.
+ When omitted, create buttons for all currently assigned assignees.
+ replace_existing: If True, do not filter existing registry entities. This is
+ intended for flows that have already removed the prior entity set.
+
+ Returns:
+ Count of entities handed to Home Assistant for creation.
+ """
+ if _async_add_entities_callback is None:
+ const.LOGGER.warning("Cannot create chore buttons: callback not registered")
+ return 0
+
+ chore_info = coordinator.chores_data.get(chore_id)
+ if not chore_info:
+ const.LOGGER.warning(
+ "Cannot create chore buttons: chore %s not found", chore_id
+ )
+ return 0
+
+ chore_name = str(
+ chore_info.get(
+ const.DATA_CHORE_NAME, f"{const.TRANS_KEY_LABEL_CHORE} {chore_id}"
+ )
+ )
+ assigned_assignees_ids = chore_info.get(const.DATA_CHORE_ASSIGNED_USER_IDS, [])
+ target_assignee_ids = assigned_assignees_ids
+ if assignee_ids is not None:
+ target_assignee_ids = [
+ assignee_id
+ for assignee_id in assigned_assignees_ids
+ if assignee_id in assignee_ids
+ ]
+
+ chore_claim_icon = chore_info.get(const.DATA_CHORE_ICON, const.SENTINEL_EMPTY)
+ chore_approve_icon = chore_info.get(const.DATA_CHORE_ICON, const.SENTINEL_EMPTY)
+ entry = coordinator.config_entry
+ entities: list[ButtonEntity] = []
+
+ for assignee_id in target_assignee_ids:
+ assignee_name = (
+ get_assignee_name_by_id(coordinator, assignee_id)
+ or f"{const.TRANS_KEY_LABEL_ASSIGNEE} {assignee_id}"
+ )
+
+ claim_unique_id = f"{entry.entry_id}_{assignee_id}_{chore_id}{const.BUTTON_KC_UID_SUFFIX_CLAIM}"
+ if should_create_entity_for_user_assignee(
+ const.BUTTON_KC_UID_SUFFIX_CLAIM,
+ coordinator,
+ assignee_id,
+ ) and (
+ replace_existing or not _button_entity_exists(coordinator, claim_unique_id)
+ ):
+ entities.append(
+ AssigneeChoreClaimButton(
+ coordinator=coordinator,
+ entry=entry,
+ assignee_id=assignee_id,
+ assignee_name=assignee_name,
+ chore_id=chore_id,
+ chore_name=chore_name,
+ icon=chore_claim_icon,
+ )
+ )
+
+ approve_unique_id = f"{entry.entry_id}_{assignee_id}_{chore_id}{const.BUTTON_KC_UID_SUFFIX_APPROVE}"
+ if should_create_entity_for_user_assignee(
+ const.BUTTON_KC_UID_SUFFIX_APPROVE,
+ coordinator,
+ assignee_id,
+ ) and (
+ replace_existing
+ or not _button_entity_exists(coordinator, approve_unique_id)
+ ):
+ entities.append(
+ ApproverChoreApproveButton(
+ coordinator=coordinator,
+ entry=entry,
+ assignee_id=assignee_id,
+ assignee_name=assignee_name,
+ chore_id=chore_id,
+ chore_name=chore_name,
+ icon=chore_approve_icon,
+ )
+ )
+
+ disapprove_unique_id = f"{entry.entry_id}_{assignee_id}_{chore_id}{const.BUTTON_KC_UID_SUFFIX_DISAPPROVE}"
+ if should_create_entity_for_user_assignee(
+ const.BUTTON_KC_UID_SUFFIX_DISAPPROVE,
+ coordinator,
+ assignee_id,
+ ) and (
+ replace_existing
+ or not _button_entity_exists(coordinator, disapprove_unique_id)
+ ):
+ entities.append(
+ ApproverChoreDisapproveButton(
+ coordinator=coordinator,
+ entry=entry,
+ assignee_id=assignee_id,
+ assignee_name=assignee_name,
+ chore_id=chore_id,
+ chore_name=chore_name,
+ )
+ )
+
+ if entities:
+ _async_add_entities_callback(entities)
+ const.LOGGER.debug(
+ "Created %d chore-linked buttons for chore: %s", len(entities), chore_name
+ )
+
+ return len(entities)
+
+
async def async_setup_entry(
hass: HomeAssistant,
entry: ChoreOpsConfigEntry,
@@ -55,6 +203,7 @@ async def async_setup_entry(
) -> None:
"""Set up dynamic buttons."""
coordinator = entry.runtime_data
+ register_chore_button_callback(async_add_entities)
points_label = entry.options.get(
const.CONF_POINTS_LABEL, const.DEFAULT_POINTS_LABEL
diff --git a/custom_components/choreops/const.py b/custom_components/choreops/const.py
index f454f98..6758740 100644
--- a/custom_components/choreops/const.py
+++ b/custom_components/choreops/const.py
@@ -2274,6 +2274,9 @@ def set_default_timezone(hass):
TRANS_KEY_PURPOSE_ACHIEVEMENT_PROGRESS: Final = "purpose_achievement_progress"
TRANS_KEY_PURPOSE_CHALLENGE_PROGRESS: Final = "purpose_challenge_progress"
TRANS_KEY_PURPOSE_DASHBOARD_HELPER: Final = "purpose_dashboard_helper"
+TRANS_KEY_PURPOSE_DASHBOARD_CHORE_SHARD_HELPER: Final = (
+ "purpose_dashboard_chore_shard_helper"
+)
TRANS_KEY_PURPOSE_DASHBOARD_TRANSLATION: Final = "purpose_dashboard_translation"
TRANS_KEY_PURPOSE_SYSTEM_DASHBOARD_HELPER: Final = "purpose_system_dashboard_helper"
# Legacy sensor purposes (sensor_legacy.py)
@@ -2517,12 +2520,17 @@ def set_default_timezone(hass):
# Dashboard Helper Sensor Attributes
ATTR_CHORES_BY_LABEL: Final = "chores_by_label"
+ATTR_CHORE_HELPER_EIDS: Final = "chore_helper_eids"
ATTR_CHORE_CLAIMED_BY: Final = "claimed_by"
ATTR_CHORE_COMPLETED_BY: Final = "completed_by"
ATTR_CHORE_DUE_DATE: Final = "due_date"
+ATTR_HELPER_CONTRACT_VERSION: Final = "helper_contract_version"
ATTR_CHORE_IS_TODAY_AM: Final = "is_today_am"
ATTR_CHORE_LABELS: Final = "labels"
ATTR_CHORE_PRIMARY_GROUP: Final = "primary_group"
+ATTR_SHARD_COUNT: Final = "shard_count"
+ATTR_SHARD_INDEX: Final = "shard_index"
+ATTR_SHARD_RUNTIME: Final = "shard_runtime"
ATTR_UI_CONTROL: Final = "ui_control"
ATTR_UI_ROOT: Final = "ui_root"
ATTR_UI_ROOT_SHARED_ADMIN: Final = "shared_admin"
@@ -2552,6 +2560,13 @@ def set_default_timezone(hass):
PRIMARY_GROUP_THIS_WEEK = "this_week"
PRIMARY_GROUP_OTHER = "other"
+HELPER_CONTRACT_VERSION_V1: Final = 1
+HELPER_SHARD_FAMILY_CHORES: Final = "chores"
+HELPER_SHARD_MODE_INLINE: Final = "inline"
+HELPER_SHARD_MODE_SHARDED: Final = "sharded"
+HELPER_SHARD_ENTER_BYTES: Final = 14 * 1024
+HELPER_SHARD_EXIT_BYTES: Final = 12 * 1024
+
# ================================================================================================
# Entity UID Constants (SUFFIX patterns)
@@ -2595,6 +2610,9 @@ def set_default_timezone(hass):
# Sensor Entity ID constants still in active use (runtime)
SENSOR_KC_UID_SUFFIX_UI_DASHBOARD_HELPER: Final = "_dashboard_helper"
+SENSOR_KC_UID_SUFFIX_UI_DASHBOARD_CHORE_SHARD_HELPER: Final = (
+ "_dashboard_chore_shard_helper"
+)
SENSOR_KC_UID_SUFFIX_SYSTEM_DASHBOARD_HELPER: Final = "_system_dashboard_helper"
# System-level dashboard translation sensor (one per language in use)
@@ -3010,6 +3028,7 @@ class EntityRequirement(StrEnum):
SENSOR_KC_UID_SUFFIX_CHORE_STATUS_SENSOR: EntityRequirement.ALWAYS,
SENSOR_KC_UID_SUFFIX_CHORES_SENSOR: EntityRequirement.ALWAYS,
SENSOR_KC_UID_SUFFIX_UI_DASHBOARD_HELPER: EntityRequirement.ALWAYS,
+ SENSOR_KC_UID_SUFFIX_UI_DASHBOARD_CHORE_SHARD_HELPER: EntityRequirement.ALWAYS,
SENSOR_KC_UID_SUFFIX_SYSTEM_DASHBOARD_HELPER: EntityRequirement.ALWAYS,
# === SENSORS: Gamification ===
SENSOR_KC_UID_SUFFIX_ASSIGNEE_POINTS_SENSOR: EntityRequirement.GAMIFICATION,
@@ -3635,6 +3654,9 @@ class EntityRequirement(StrEnum):
TRANS_KEY_SENSOR_DASHBOARD_TRANSLATION: Final = "system_dashboard_translation_sensor"
TRANS_KEY_SENSOR_SYSTEM_DASHBOARD_HELPER: Final = "system_dashboard_helper_sensor"
TRANS_KEY_SENSOR_DASHBOARD_HELPER: Final = "assignee_dashboard_helper_sensor"
+TRANS_KEY_SENSOR_DASHBOARD_CHORE_LIST_HELPER: Final = (
+ "assignee_dashboard_chore_list_helper_sensor"
+)
# Sensor Attributes Translation Keys
diff --git a/custom_components/choreops/coordinator.py b/custom_components/choreops/coordinator.py
index 895175c..65ffaa8 100644
--- a/custom_components/choreops/coordinator.py
+++ b/custom_components/choreops/coordinator.py
@@ -12,10 +12,11 @@
"""
import asyncio
+from dataclasses import dataclass
from datetime import timedelta
import sys
import time
-from typing import Any, cast
+from typing import Any, Literal, cast
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant
@@ -24,6 +25,11 @@
from . import const
from .engines.statistics_engine import StatisticsEngine
+from .helpers.entity_helpers import (
+ remove_entities_by_item_id,
+ remove_orphaned_assignee_chore_entities,
+ remove_orphaned_shared_chore_sensors,
+)
from .managers import (
ChoreManager,
EconomyManager,
@@ -43,6 +49,8 @@
BadgesCollection,
BonusesCollection,
ChallengesCollection,
+ ChoreData,
+ ChoreEntitySyncContext,
ChoresCollection,
PenaltiesCollection,
RewardsCollection,
@@ -55,6 +63,16 @@
type ChoreOpsConfigEntry = ConfigEntry["ChoreOpsDataCoordinator"]
+@dataclass(slots=True)
+class ChoreEntitySyncResult:
+ """Result summary for chore runtime entity synchronization."""
+
+ sensors_created: int = 0
+ buttons_created: int = 0
+ orphaned_assignee_entities_removed: int = 0
+ orphaned_shared_sensors_removed: int = 0
+
+
class ChoreOpsDataCoordinator(DataUpdateCoordinator):
"""Coordinator for ChoreOps integration.
@@ -387,6 +405,171 @@ async def async_sync_entities_after_service_create(self) -> None:
await self.hass.config_entries.async_reload(self.config_entry.entry_id)
+ async def async_sync_chore_entities(
+ self,
+ sync_context: ChoreEntitySyncContext,
+ ) -> ChoreEntitySyncResult:
+ """Synchronize chore-linked runtime entities without reloading the entry.
+
+ This orchestration handles graph mutations only. It does not write storage;
+ callers must invoke it only after manager-owned persistence succeeds.
+ """
+ from .button import create_chore_button_entities
+ from .sensor import create_chore_entities
+
+ chore_id = sync_context["chore_id"]
+ mutation = sync_context["mutation"]
+ result = ChoreEntitySyncResult()
+
+ if mutation == "deleted":
+ await self.ui_manager.async_reconcile_chore_shards_for_users(
+ sync_context["affected_user_ids"]
+ )
+ result.orphaned_assignee_entities_removed = (
+ await remove_orphaned_assignee_chore_entities(
+ self.hass,
+ self.config_entry.entry_id,
+ self.assignees_data,
+ self.chores_data,
+ )
+ )
+ result.orphaned_shared_sensors_removed = (
+ await remove_orphaned_shared_chore_sensors(
+ self.hass,
+ self.config_entry.entry_id,
+ self.chores_data,
+ )
+ )
+ self.async_update_listeners()
+ self.hass.async_create_task(
+ self.ui_manager.async_finalize_chore_shards_for_users(
+ sync_context["affected_user_ids"],
+ registry_only=True,
+ )
+ )
+ return result
+
+ rename_sensitive_update = sync_context["rename_sensitive_update"]
+ assignments_added = sync_context["assignments_added"]
+
+ if rename_sensitive_update:
+ remove_entities_by_item_id(self.hass, self.config_entry.entry_id, chore_id)
+
+ target_assignee_ids: list[str] | None
+ replace_existing = False
+
+ if mutation == "created" or rename_sensitive_update:
+ target_assignee_ids = None
+ replace_existing = rename_sensitive_update
+ else:
+ target_assignee_ids = assignments_added
+
+ current_chore = self.chores_data.get(chore_id)
+
+ if current_chore is not None:
+ should_create_all = (
+ mutation == "created"
+ or rename_sensitive_update
+ or sync_context["shared_state_changed"]
+ )
+ creation_target_ids = None if should_create_all else target_assignee_ids
+
+ result.sensors_created = create_chore_entities(
+ self,
+ chore_id,
+ assignee_ids=creation_target_ids,
+ replace_existing=replace_existing,
+ )
+ result.buttons_created = create_chore_button_entities(
+ self,
+ chore_id,
+ assignee_ids=creation_target_ids,
+ replace_existing=replace_existing,
+ )
+
+ result.orphaned_assignee_entities_removed = (
+ await remove_orphaned_assignee_chore_entities(
+ self.hass,
+ self.config_entry.entry_id,
+ self.assignees_data,
+ self.chores_data,
+ )
+ )
+ result.orphaned_shared_sensors_removed = (
+ await remove_orphaned_shared_chore_sensors(
+ self.hass,
+ self.config_entry.entry_id,
+ self.chores_data,
+ )
+ )
+ await self.ui_manager.async_reconcile_chore_shards_for_users(
+ sync_context["affected_user_ids"]
+ )
+ self.async_update_listeners()
+ self.hass.async_create_task(
+ self.ui_manager.async_finalize_chore_shards_for_users(
+ sync_context["affected_user_ids"],
+ registry_only=True,
+ )
+ )
+
+ const.LOGGER.debug(
+ "Chore runtime sync completed for %s (%s): sensors=%s buttons=%s removed_assignee=%s removed_shared=%s",
+ chore_id,
+ mutation,
+ result.sensors_created,
+ result.buttons_created,
+ result.orphaned_assignee_entities_removed,
+ result.orphaned_shared_sensors_removed,
+ )
+ return result
+
+ @staticmethod
+ def build_chore_entity_sync_context(
+ chore_id: str,
+ *,
+ mutation: Literal["created", "updated", "deleted"],
+ previous_chore: ChoreData | None = None,
+ current_chore: ChoreData | None = None,
+ ) -> ChoreEntitySyncContext:
+ """Build a chore runtime entity sync context from chore snapshots."""
+
+ def is_shared_chore(chore: ChoreData | None) -> bool:
+ if not chore:
+ return False
+ return chore.get(const.DATA_CHORE_COMPLETION_CRITERIA) in (
+ const.COMPLETION_CRITERIA_SHARED,
+ const.COMPLETION_CRITERIA_SHARED_FIRST,
+ )
+
+ previous_assignees = set(
+ previous_chore.get(const.DATA_CHORE_ASSIGNED_USER_IDS, [])
+ if previous_chore
+ else []
+ )
+ current_assignees = set(
+ current_chore.get(const.DATA_CHORE_ASSIGNED_USER_IDS, [])
+ if current_chore
+ else []
+ )
+ previous_shared = is_shared_chore(previous_chore)
+ current_shared = is_shared_chore(current_chore)
+
+ return {
+ "chore_id": chore_id,
+ "mutation": mutation,
+ "assignments_added": sorted(current_assignees - previous_assignees),
+ "assignments_removed": sorted(previous_assignees - current_assignees),
+ "affected_user_ids": sorted(previous_assignees | current_assignees),
+ "rename_sensitive_update": (
+ previous_chore is not None
+ and current_chore is not None
+ and previous_chore.get(const.DATA_CHORE_NAME)
+ != current_chore.get(const.DATA_CHORE_NAME)
+ ),
+ "shared_state_changed": previous_shared != current_shared,
+ }
+
# -------------------------------------------------------------------------------------
# Properties for Easy Access
# -------------------------------------------------------------------------------------
diff --git a/custom_components/choreops/dashboards/dashboard_registry.json b/custom_components/choreops/dashboards/dashboard_registry.json
index 1a56066..6e00ba8 100644
--- a/custom_components/choreops/dashboards/dashboard_registry.json
+++ b/custom_components/choreops/dashboards/dashboard_registry.json
@@ -1,6 +1,6 @@
{
"schema_version": 1,
- "release_version": "1.0.4",
+ "release_version": "1.0.5",
"repo": "ccpk1/ChoreOps-Dashboards",
"title": "ChoreOps Dashboard Registry",
"description": "Registry manifest for ChoreOps dashboard templates",
diff --git a/custom_components/choreops/dashboards/preferences/admin-peruser-kidschores-classic.md b/custom_components/choreops/dashboards/preferences/admin-peruser-kidschores-classic.md
index be26557..b5829a6 100644
--- a/custom_components/choreops/dashboards/preferences/admin-peruser-kidschores-classic.md
+++ b/custom_components/choreops/dashboards/preferences/admin-peruser-kidschores-classic.md
@@ -2,6 +2,12 @@
This template has configurable `pref_*` values in approval action layout.
+## Scale note
+
+- This is an inline-only classic admin template.
+- It is intended for smaller households, roughly in the same `20-40` chores-per-user range as the other inline-only classic layouts.
+- It is not a shard-aware high-density admin template.
+
- `pref_points_precision` (default: `fixed_0`)
- Controls how point values are formatted in classic admin summary and chore-value displays.
- `fixed_0` shows a rounded whole-number display for compact layouts.
diff --git a/custom_components/choreops/dashboards/preferences/admin-shared-kidschores-classic.md b/custom_components/choreops/dashboards/preferences/admin-shared-kidschores-classic.md
index 149956b..80ab86e 100644
--- a/custom_components/choreops/dashboards/preferences/admin-shared-kidschores-classic.md
+++ b/custom_components/choreops/dashboards/preferences/admin-shared-kidschores-classic.md
@@ -2,6 +2,12 @@
This template has configurable `pref_*` values in approval action layout.
+## Scale note
+
+- This is an inline-only classic admin template.
+- It is intended for smaller households, roughly in the same `20-40` chores-per-user range as the other inline-only classic layouts.
+- It is not a shard-aware high-density admin template.
+
- `pref_points_precision` (default: `fixed_0`)
- Controls how point values are formatted in classic admin summary and chore-value displays.
- `fixed_0` shows a rounded whole-number display for compact layouts.
diff --git a/custom_components/choreops/dashboards/preferences/user-chores-essential-v1.md b/custom_components/choreops/dashboards/preferences/user-chores-essential-v1.md
index 5b1bcd8..89aa4dd 100644
--- a/custom_components/choreops/dashboards/preferences/user-chores-essential-v1.md
+++ b/custom_components/choreops/dashboards/preferences/user-chores-essential-v1.md
@@ -2,6 +2,12 @@
`user-chores-essential-v1` is a lightweight, chore-focused layout that keeps the strong grouping and filtering behavior from the earlier essentials path while using compact chore rows.
+## Scale note
+
+- This is an inline-only small-household template.
+- It is intended for roughly `20-25` chores per user, with `~25` as the practical upper bound for reliable rendering.
+- It is not a shard-aware high-density template and should not be used as the scale target for larger chore lists.
+
## Quick overview
- Lightweight by design: focuses on welcome + chores without adding extra dashboard complexity.
diff --git a/custom_components/choreops/dashboards/preferences/user-chores-lite-v1.md b/custom_components/choreops/dashboards/preferences/user-chores-lite-v1.md
index bc65d4b..7e63042 100644
--- a/custom_components/choreops/dashboards/preferences/user-chores-lite-v1.md
+++ b/custom_components/choreops/dashboards/preferences/user-chores-lite-v1.md
@@ -2,6 +2,12 @@
`user-chores-lite-v1` is a dynamic lightweight profile intended for older devices and lower-capability frontend environments. It keeps the ChoreOps dashboard-helper sorting and grouping intelligence while using native Home Assistant cards for the visible UI.
+## Scale note
+
+- This template supports both inline and shard-backed chore transport.
+- It remains lightweight in the frontend, so it may be a better fit than the richer templates when chore counts grow.
+- It is still intended as a compact profile rather than the most feature-rich dashboard, but it can be used beyond the `20-40` inline-only range when the integration switches to shard-backed chore helpers.
+
## Quick overview
- Dynamic by design: chores and rewards are still generated from the dashboard helper at runtime.
diff --git a/custom_components/choreops/dashboards/preferences/user-kidschores-classic-v1.md b/custom_components/choreops/dashboards/preferences/user-kidschores-classic-v1.md
index 25d71ce..683ad56 100644
--- a/custom_components/choreops/dashboards/preferences/user-kidschores-classic-v1.md
+++ b/custom_components/choreops/dashboards/preferences/user-kidschores-classic-v1.md
@@ -2,6 +2,12 @@
`user-kidschores-classic-v1` is the classic kid-focused user layout. It keeps the original multi-card structure with configurable `pref_*` values.
+## Scale note
+
+- This is an inline-only small-household template.
+- It is intended for roughly `20-40` chores per user.
+- It is not a shard-aware high-density template and should not be used as the scale target for larger chore lists.
+
- `pref_points_precision` (default: `fixed_0`)
- Controls how point values are formatted across the classic dashboard point displays.
- Applies to the welcome card, chore point values, reward costs, and showcase totals.
diff --git a/custom_components/choreops/dashboards/templates/admin-peruser-v1.yaml b/custom_components/choreops/dashboards/templates/admin-peruser-v1.yaml
index f51655d..b0c91a2 100644
--- a/custom_components/choreops/dashboards/templates/admin-peruser-v1.yaml
+++ b/custom_components/choreops/dashboards/templates/admin-peruser-v1.yaml
@@ -137,7 +137,16 @@ views:
{%- set pending_approvals = helper_attrs.pending_approvals | default({}, true) -%}
{%- set pending_chore_data = pending_approvals.get('chores', []) | default([], true) -%}
{%- set pending_reward_data = pending_approvals.get('rewards', []) | default([], true) -%}
- {%- set helper_chore_items = helper_attrs.chores | default([], true) -%}
+ {%- set helper_chore_items_ns = namespace(items=helper_attrs.chores | default([], true)) -%}
+ {%- set helper_chore_helper_eids = dashboard_helpers.get('chore_helper_eids', []) if dashboard_helpers is mapping else [] -%}
+ {%- if helper_chore_helper_eids is iterable and helper_chore_helper_eids is not string -%}
+ {%- for chore_helper_eid in helper_chore_helper_eids | list -%}
+ {%- if chore_helper_eid not in ['', None, 'None'] and states(chore_helper_eid) not in ['unknown', 'unavailable'] -%}
+ {%- set helper_chore_items_ns.items = helper_chore_items_ns.items + (state_attr(chore_helper_eid, 'chores') | default([], true)) -%}
+ {%- endif -%}
+ {%- endfor -%}
+ {%- endif -%}
+ {%- set helper_chore_items = helper_chore_items_ns.items -%}
{%- set helper_reward_items = helper_attrs.rewards | default([], true) -%}
{%- set chore_count = pending_chore_data | count -%}
{%- set reward_count = pending_reward_data | count -%}
@@ -729,7 +738,17 @@ views:
{%- endfor -%}
{%- set has_header_collapsed_override = shared_admin_ui_root.current is mapping and 'header-collapse' in shared_admin_ui_root.current -%}
{%- set selected_user_display = selected_user_name if has_selected_user else '' -%}
- {%- set selected_helper_chores = state_attr(selected_dashboard_helper, 'chores') | default([], true) if selected_dashboard_helper not in ['', None, 'None'] and states(selected_dashboard_helper) not in ['unknown', 'unavailable'] else [] -%}
+ {%- set selected_dashboard_helpers = state_attr(selected_dashboard_helper, 'dashboard_helpers') or {} if selected_dashboard_helper not in ['', None, 'None'] and states(selected_dashboard_helper) not in ['unknown', 'unavailable'] else {} -%}
+ {%- set selected_helper_chores_ns = namespace(items=state_attr(selected_dashboard_helper, 'chores') | default([], true) if selected_dashboard_helper not in ['', None, 'None'] and states(selected_dashboard_helper) not in ['unknown', 'unavailable'] else []) -%}
+ {%- set selected_chore_helper_eids = selected_dashboard_helpers.get('chore_helper_eids', []) if selected_dashboard_helpers is mapping else [] -%}
+ {%- if selected_chore_helper_eids is iterable and selected_chore_helper_eids is not string -%}
+ {%- for chore_helper_eid in selected_chore_helper_eids | list -%}
+ {%- if chore_helper_eid not in ['', None, 'None'] and states(chore_helper_eid) not in ['unknown', 'unavailable'] -%}
+ {%- set selected_helper_chores_ns.items = selected_helper_chores_ns.items + (state_attr(chore_helper_eid, 'chores') | default([], true)) -%}
+ {%- endif -%}
+ {%- endfor -%}
+ {%- endif -%}
+ {%- set selected_helper_chores = selected_helper_chores_ns.items -%}
{%- set overdue_chore_count = selected_helper_chores | selectattr('state', 'eq', 'overdue') | list | count -%}
{%- set show_reset_all_overdue_card = has_selected_user and overdue_chore_count > 0 and integration_entry_id not in ['', None, 'None'] -%}
{%- set header_collapsed = shared_admin_ui_root.current['header-collapse'] if has_header_collapsed_override else pref_selector_default_header_collapsed -%}
@@ -1017,7 +1036,16 @@ views:
{%- set has_chore_selector = chore_select_entity not in ['', None, 'None'] -%}
{%- set has_selected_chore = has_selected_dashboard_helper and has_chore_selector and selected_chore_name not in ['None', 'none', '', 'unknown', 'unavailable'] -%}
{%- set selected_chore_display = selected_chore_name if has_selected_chore else '' -%}
- {%- set helper_chore_items = state_attr(selected_dashboard_helper, 'chores') | default([], true) if has_selected_dashboard_helper else [] -%}
+ {%- set helper_chore_items_ns = namespace(items=state_attr(selected_dashboard_helper, 'chores') | default([], true) if has_selected_dashboard_helper else []) -%}
+ {%- set selected_chore_helper_eids = selected_dashboard_helpers.get('chore_helper_eids', []) if has_selected_dashboard_helper and selected_dashboard_helpers is mapping else [] -%}
+ {%- if selected_chore_helper_eids is iterable and selected_chore_helper_eids is not string -%}
+ {%- for chore_helper_eid in selected_chore_helper_eids | list -%}
+ {%- if chore_helper_eid not in ['', None, 'None'] and states(chore_helper_eid) not in ['unknown', 'unavailable'] -%}
+ {%- set helper_chore_items_ns.items = helper_chore_items_ns.items + (state_attr(chore_helper_eid, 'chores') | default([], true)) -%}
+ {%- endif -%}
+ {%- endfor -%}
+ {%- endif -%}
+ {%- set helper_chore_items = helper_chore_items_ns.items -%}
{%- set overdue_chore_items = helper_chore_items | selectattr('state', 'eq', 'overdue') | list if has_selected_dashboard_helper else [] -%}
{%- set overdue_chore_count = overdue_chore_items | count -%}
{%- set selected_chore_lookup_name = selected_chore_name | string | trim if has_selected_chore else '' -%}
diff --git a/custom_components/choreops/dashboards/templates/admin-shared-v1.yaml b/custom_components/choreops/dashboards/templates/admin-shared-v1.yaml
index b2f130d..44495db 100644
--- a/custom_components/choreops/dashboards/templates/admin-shared-v1.yaml
+++ b/custom_components/choreops/dashboards/templates/admin-shared-v1.yaml
@@ -121,7 +121,16 @@ views:
{%- set pending_approvals = helper_attrs.pending_approvals | default({}, true) -%}
{%- set pending_chore_data = pending_approvals.get('chores', []) | default([], true) -%}
{%- set pending_reward_data = pending_approvals.get('rewards', []) | default([], true) -%}
- {%- set helper_chore_items = helper_attrs.chores | default([], true) -%}
+ {%- set helper_chore_items_ns = namespace(items=helper_attrs.chores | default([], true)) -%}
+ {%- set helper_chore_helper_eids = dashboard_helpers.get('chore_helper_eids', []) if dashboard_helpers is mapping else [] -%}
+ {%- if helper_chore_helper_eids is iterable and helper_chore_helper_eids is not string -%}
+ {%- for chore_helper_eid in helper_chore_helper_eids | list -%}
+ {%- if chore_helper_eid not in ['', None, 'None'] and states(chore_helper_eid) not in ['unknown', 'unavailable'] -%}
+ {%- set helper_chore_items_ns.items = helper_chore_items_ns.items + (state_attr(chore_helper_eid, 'chores') | default([], true)) -%}
+ {%- endif -%}
+ {%- endfor -%}
+ {%- endif -%}
+ {%- set helper_chore_items = helper_chore_items_ns.items -%}
{%- set helper_reward_items = helper_attrs.rewards | default([], true) -%}
{%- set chore_count = pending_chore_data | count -%}
{%- set reward_count = pending_reward_data | count -%}
@@ -703,7 +712,17 @@ views:
{%- endfor -%}
{%- set has_header_collapsed_override = shared_admin_ui_root.current is mapping and 'header-collapse' in shared_admin_ui_root.current -%}
{%- set selected_user_display = selected_user_name if has_selected_user else '' -%}
- {%- set selected_helper_chores = state_attr(selected_dashboard_helper, 'chores') | default([], true) if selected_dashboard_helper not in ['', None, 'None'] and states(selected_dashboard_helper) not in ['unknown', 'unavailable'] else [] -%}
+ {%- set selected_dashboard_helpers = state_attr(selected_dashboard_helper, 'dashboard_helpers') or {} if selected_dashboard_helper not in ['', None, 'None'] and states(selected_dashboard_helper) not in ['unknown', 'unavailable'] else {} -%}
+ {%- set selected_helper_chores_ns = namespace(items=state_attr(selected_dashboard_helper, 'chores') | default([], true) if selected_dashboard_helper not in ['', None, 'None'] and states(selected_dashboard_helper) not in ['unknown', 'unavailable'] else []) -%}
+ {%- set selected_chore_helper_eids = selected_dashboard_helpers.get('chore_helper_eids', []) if selected_dashboard_helpers is mapping else [] -%}
+ {%- if selected_chore_helper_eids is iterable and selected_chore_helper_eids is not string -%}
+ {%- for chore_helper_eid in selected_chore_helper_eids | list -%}
+ {%- if chore_helper_eid not in ['', None, 'None'] and states(chore_helper_eid) not in ['unknown', 'unavailable'] -%}
+ {%- set selected_helper_chores_ns.items = selected_helper_chores_ns.items + (state_attr(chore_helper_eid, 'chores') | default([], true)) -%}
+ {%- endif -%}
+ {%- endfor -%}
+ {%- endif -%}
+ {%- set selected_helper_chores = selected_helper_chores_ns.items -%}
{%- set overdue_chore_count = selected_helper_chores | selectattr('state', 'eq', 'overdue') | list | count -%}
{%- set show_reset_all_overdue_card = has_selected_user and overdue_chore_count > 0 and integration_entry_id not in ['', None, 'None'] -%}
{%- set ns = namespace(chips=[]) -%}
@@ -1085,7 +1104,16 @@ views:
{%- set has_chore_selector = chore_select_entity not in ['', None, 'None'] -%}
{%- set has_selected_chore = has_selected_dashboard_helper and has_chore_selector and selected_chore_name not in ['None', 'none', '', 'unknown', 'unavailable'] -%}
{%- set selected_chore_display = selected_chore_name if has_selected_chore else '' -%}
- {%- set helper_chore_items = state_attr(selected_dashboard_helper, 'chores') | default([], true) if has_selected_dashboard_helper else [] -%}
+ {%- set helper_chore_items_ns = namespace(items=state_attr(selected_dashboard_helper, 'chores') | default([], true) if has_selected_dashboard_helper else []) -%}
+ {%- set selected_chore_helper_eids = selected_dashboard_helpers.get('chore_helper_eids', []) if has_selected_dashboard_helper and selected_dashboard_helpers is mapping else [] -%}
+ {%- if selected_chore_helper_eids is iterable and selected_chore_helper_eids is not string -%}
+ {%- for chore_helper_eid in selected_chore_helper_eids | list -%}
+ {%- if chore_helper_eid not in ['', None, 'None'] and states(chore_helper_eid) not in ['unknown', 'unavailable'] -%}
+ {%- set helper_chore_items_ns.items = helper_chore_items_ns.items + (state_attr(chore_helper_eid, 'chores') | default([], true)) -%}
+ {%- endif -%}
+ {%- endfor -%}
+ {%- endif -%}
+ {%- set helper_chore_items = helper_chore_items_ns.items -%}
{%- set overdue_chore_items = helper_chore_items | selectattr('state', 'eq', 'overdue') | list if has_selected_dashboard_helper else [] -%}
{%- set overdue_chore_count = overdue_chore_items | count -%}
{%- set selected_chore_lookup_name = selected_chore_name | string | trim if has_selected_chore else '' -%}
diff --git a/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_kids_v1.yaml b/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_kids_v1.yaml
index 925f502..4dd0726 100644
--- a/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_kids_v1.yaml
+++ b/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_kids_v1.yaml
@@ -184,6 +184,6 @@ chore_row_kids_v1:
},
},
},
- "kid_status": '[[[ const labelSource = (typeof variables !== ''undefined'' && variables && typeof variables.ui_labels === ''object'') ? variables.ui_labels : ((typeof variables !== ''undefined'' && variables && typeof variables.state_map === ''object'') ? variables.state_map : null); const i18n = (key, fallback) => { const value = labelSource && typeof labelSource[key] === ''string'' ? labelSource[key].trim() : ''''; return value.length > 0 ? value : ((typeof fallback === ''string'' && fallback.startsWith(''err-'')) ? fallback : `err-${key}`); }; const rawState = entity.state; const state = rawState === ''approved_in_part'' ? ''completed_in_part'' : rawState; const label = i18n(state, `err-${state}`); const dateLabel = i18n(''date'', ((typeof variables !== ''undefined'' && variables && typeof variables.date_label === ''string'' && variables.date_label.trim().length > 0) ? variables.date_label : ''err-date'')); const streak = Number(entity.attributes.chore_current_streak || 0); const dueValue = entity.attributes.due_date || entity.attributes.due_window_start; const formatDateWithOrdinal = (value) => { if (!value) return ''''; const dt = new Date(value); if (Number.isNaN(dt.getTime())) return ''''; const day = dt.getDate(); const mod10 = day % 10; const mod100 = day % 100; let suffix = ''th''; if (mod10 === 1 && mod100 !== 11) suffix = ''st''; else if (mod10 === 2 && mod100 !== 12) suffix = ''nd''; else if (mod10 === 3 && mod100 !== 13) suffix = ''rd''; const month = dt.toLocaleString(undefined, { month: ''short'' }); const time = dt.toLocaleString(undefined, { hour: ''numeric'', minute: ''2-digit'' }); return `${month} ${day}${suffix}, ${time}`; }; const dueText = formatDateWithOrdinal(dueValue); const duePart = dueText ? `${dateLabel}: ${dueText}` : ''''; const streakPart = streak > 0 ? `${streak}` : ''''; const extraLine = (duePart || streakPart) ? `
${duePart}${streakPart}` : ''''; return `${String(label).toUpperCase()}${extraLine}`; ]]]',
+ "kid_status": '[[[ const getLabels = () => { const directLabels = (typeof variables !== ''undefined'' && variables && typeof variables.ui_labels === ''object'') ? variables.ui_labels : null; if (directLabels) return directLabels; const sensorId = (typeof variables !== ''undefined'' && variables && typeof variables.translation_sensor_eid === ''string'') ? variables.translation_sensor_eid.trim() : ''''; const sensorState = sensorId && typeof hass !== ''undefined'' && hass && hass.states ? hass.states[sensorId] : null; const sensorLabels = sensorState && sensorState.attributes && typeof sensorState.attributes.ui_translations === ''object'' ? sensorState.attributes.ui_translations : null; if (sensorLabels) return sensorLabels; return (typeof variables !== ''undefined'' && variables && typeof variables.state_map === ''object'') ? variables.state_map : null; }; const labelSource = getLabels(); const i18n = (key, fallback) => { const value = labelSource && typeof labelSource[key] === ''string'' ? labelSource[key].trim() : ''''; return value.length > 0 ? value : ((typeof fallback === ''string'' && fallback.startsWith(''err-'')) ? fallback : `err-${key}`); }; const rawState = entity.state; const state = rawState === ''approved_in_part'' ? ''completed_in_part'' : rawState; const label = i18n(state, `err-${state}`); const dateLabel = i18n(''date'', ((typeof variables !== ''undefined'' && variables && typeof variables.date_label === ''string'' && variables.date_label.trim().length > 0) ? variables.date_label : ''err-date'')); const streak = Number(entity.attributes.chore_current_streak || 0); const dueValue = entity.attributes.due_date || entity.attributes.due_window_start; const formatDateWithOrdinal = (value) => { if (!value) return ''''; const dt = new Date(value); if (Number.isNaN(dt.getTime())) return ''''; const day = dt.getDate(); const mod10 = day % 10; const mod100 = day % 100; let suffix = ''th''; if (mod10 === 1 && mod100 !== 11) suffix = ''st''; else if (mod10 === 2 && mod100 !== 12) suffix = ''nd''; else if (mod10 === 3 && mod100 !== 13) suffix = ''rd''; const month = dt.toLocaleString(undefined, { month: ''short'' }); const time = dt.toLocaleString(undefined, { hour: ''numeric'', minute: ''2-digit'' }); return `${month} ${day}${suffix}, ${time}`; }; const dueText = formatDateWithOrdinal(dueValue); const duePart = dueText ? `${dateLabel}: ${dueText}` : ''''; const streakPart = streak > 0 ? `${streak}` : ''''; const extraLine = (duePart || streakPart) ? `
${duePart}${streakPart}` : ''''; return `${String(label).toUpperCase()}${extraLine}`; ]]]',
},
}
diff --git a/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_v1.yaml b/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_v1.yaml
index 88db7c7..fdf9b1f 100644
--- a/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_v1.yaml
+++ b/custom_components/choreops/dashboards/templates/shared/button_card_template_chore_row_v1.yaml
@@ -146,9 +146,9 @@ chore_row_v1:
},
"custom_fields":
{
- "due": '[[[ const i18n = (key, fallback) => { const labels = (typeof variables !== ''undefined'' && variables && typeof variables.ui_labels === ''object'') ? variables.ui_labels : null; const value = labels && typeof labels[key] === ''string'' ? labels[key].trim() : ''''; return value.length > 0 ? value : ((typeof fallback === ''string'' && fallback.startsWith(''err-'')) ? fallback : `err-${key}`); }; const statusMap = { pending: i18n(''pending'', ''err-pending''), due: i18n(''due'', ''err-due''), claimed: i18n(''claimed'', ''err-claimed''), claimed_in_part: i18n(''claimed_in_part'', ''err-claimed_in_part''), completed: i18n(''completed'', ''err-completed''), completed_in_part: i18n(''completed_in_part'', ''err-completed_in_part''), overdue: i18n(''overdue'', ''err-overdue''), waiting: i18n(''waiting'', ''err-waiting''), missed: i18n(''missed'', ''err-missed''), completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), already_approved: i18n(''completed'', ''err-completed''), pending_claim: i18n(''claimed'', ''err-claimed''), missed_locked: i18n(''missed_locked'', ''err-missed_locked''), blocked_completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), blocked_already_approved: i18n(''completed'', ''err-completed''), blocked_pending_claim: i18n(''claimed'', ''err-claimed''), blocked_waiting_window: i18n(''waiting'', ''err-waiting''), blocked_not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), blocked_missed_locked: i18n(''missed_locked'', ''err-missed_locked''), steal_available: i18n(''steal_available'', ''err-steal_available'') }; const rawState = entity.state; let status = (rawState === ''approved'' || rawState === ''already_approved'') ? ''completed'' : (rawState === ''approved_in_part'' ? ''completed_in_part'' : rawState); const claimMode = entity.attributes.claim_mode || null; if (claimMode === ''steal_available'') status = ''steal_available''; else if (entity.attributes.can_claim === false && claimMode && ![''completed'', ''completed_in_part''].includes(status)) status = claimMode; const formatDateWithOrdinal = (value) => { if (!value) return ''--''; const dt = new Date(value); if (Number.isNaN(dt.getTime())) return ''--''; const day = dt.getDate(); const mod10 = day % 10; const mod100 = day % 100; let suffix = ''th''; if (mod10 === 1 && mod100 !== 11) suffix = ''st''; else if (mod10 === 2 && mod100 !== 12) suffix = ''nd''; else if (mod10 === 3 && mod100 !== 13) suffix = ''rd''; const month = dt.toLocaleString(undefined, { month: ''short'' }); const time = dt.toLocaleString(undefined, { hour: ''numeric'', minute: ''2-digit'' }); return `${month} ${day}${suffix}, ${time}`; }; const normalizeText = (value) => { if (typeof value !== ''string'') return ''''; const text = value.trim(); return text.length > 0 ? text : ''''; }; const formatFreqText = (value) => value.split('' '').filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('' ''); const value = entity.attributes.due_date || entity.attributes.due_window_start; const dateText = formatDateWithOrdinal(value); const statusLabel = statusMap[status] || status; const dueLabel = i18n(''date'', ''err-date''); const freqRaw = normalizeText(entity.attributes.recurring_frequency) || normalizeText(entity.attributes.frequency) || normalizeText(entity.attributes.recurrence) || normalizeText(entity.attributes.recurrence_text); const freqKey = freqRaw.toLowerCase().replace(/ /g, ''_''); const freqLocalizedMap = { daily: i18n(''daily'', ''err-daily''), daily_multi: i18n(''daily_multi'', ''err-daily_multi''), weekly: i18n(''weekly'', ''err-weekly''), biweekly: i18n(''biweekly'', ''err-biweekly''), monthly: i18n(''monthly'', ''err-monthly''), quarterly: i18n(''quarterly'', ''err-quarterly''), yearly: i18n(''yearly'', ''err-yearly''), custom: i18n(''custom'', ''err-custom''), custom_from_complete: i18n(''custom_from_complete'', ''err-custom_from_complete''), custom_1_week: i18n(''custom_1_week'', ''err-custom_1_week''), custom_1_month: i18n(''custom_1_month'', ''err-custom_1_month''), custom_1_quarter: i18n(''custom_1_quarter'', ''err-custom_1_quarter''), custom_1_year: i18n(''custom_1_year'', ''err-custom_1_year'') }; const isKnownNone = [''none'', ''unknown'', ''unavailable'', ''null''].includes(freqKey); const hasFreq = freqKey.length > 0 && !isKnownNone; const freqText = freqLocalizedMap[freqKey] || formatFreqText(freqRaw.toLowerCase().replace(/_/g, '' '')); const rText = hasFreq ? ` • ${freqText}` : ''''; return `${String(statusLabel).toUpperCase()} • ${dueLabel}: ${dateText}${rText}`; ]]]',
+ "due": '[[[ const getLabels = () => { const directLabels = (typeof variables !== ''undefined'' && variables && typeof variables.ui_labels === ''object'') ? variables.ui_labels : null; if (directLabels) return directLabels; const sensorId = (typeof variables !== ''undefined'' && variables && typeof variables.translation_sensor_eid === ''string'') ? variables.translation_sensor_eid.trim() : ''''; const sensorState = sensorId && typeof hass !== ''undefined'' && hass && hass.states ? hass.states[sensorId] : null; const sensorLabels = sensorState && sensorState.attributes && typeof sensorState.attributes.ui_translations === ''object'' ? sensorState.attributes.ui_translations : null; return sensorLabels; }; const i18n = (key, fallback) => { const labels = getLabels(); const value = labels && typeof labels[key] === ''string'' ? labels[key].trim() : ''''; return value.length > 0 ? value : ((typeof fallback === ''string'' && fallback.startsWith(''err-'')) ? fallback : `err-${key}`); }; const statusMap = { pending: i18n(''pending'', ''err-pending''), due: i18n(''due'', ''err-due''), claimed: i18n(''claimed'', ''err-claimed''), claimed_in_part: i18n(''claimed_in_part'', ''err-claimed_in_part''), completed: i18n(''completed'', ''err-completed''), completed_in_part: i18n(''completed_in_part'', ''err-completed_in_part''), overdue: i18n(''overdue'', ''err-overdue''), waiting: i18n(''waiting'', ''err-waiting''), missed: i18n(''missed'', ''err-missed''), completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), already_approved: i18n(''completed'', ''err-completed''), pending_claim: i18n(''claimed'', ''err-claimed''), missed_locked: i18n(''missed_locked'', ''err-missed_locked''), blocked_completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), blocked_already_approved: i18n(''completed'', ''err-completed''), blocked_pending_claim: i18n(''claimed'', ''err-claimed''), blocked_waiting_window: i18n(''waiting'', ''err-waiting''), blocked_not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), blocked_missed_locked: i18n(''missed_locked'', ''err-missed_locked''), steal_available: i18n(''steal_available'', ''err-steal_available'') }; const rawState = entity.state; let status = (rawState === ''approved'' || rawState === ''already_approved'') ? ''completed'' : (rawState === ''approved_in_part'' ? ''completed_in_part'' : rawState); const claimMode = entity.attributes.claim_mode || null; if (claimMode === ''steal_available'') status = ''steal_available''; else if (entity.attributes.can_claim === false && claimMode && ![''completed'', ''completed_in_part''].includes(status)) status = claimMode; const formatDateWithOrdinal = (value) => { if (!value) return ''--''; const dt = new Date(value); if (Number.isNaN(dt.getTime())) return ''--''; const day = dt.getDate(); const mod10 = day % 10; const mod100 = day % 100; let suffix = ''th''; if (mod10 === 1 && mod100 !== 11) suffix = ''st''; else if (mod10 === 2 && mod100 !== 12) suffix = ''nd''; else if (mod10 === 3 && mod100 !== 13) suffix = ''rd''; const month = dt.toLocaleString(undefined, { month: ''short'' }); const time = dt.toLocaleString(undefined, { hour: ''numeric'', minute: ''2-digit'' }); return `${month} ${day}${suffix}, ${time}`; }; const normalizeText = (value) => { if (typeof value !== ''string'') return ''''; const text = value.trim(); return text.length > 0 ? text : ''''; }; const formatFreqText = (value) => value.split('' '').filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('' ''); const value = entity.attributes.due_date || entity.attributes.due_window_start; const dateText = formatDateWithOrdinal(value); const statusLabel = statusMap[status] || status; const dueLabel = i18n(''date'', ''err-date''); const freqRaw = normalizeText(entity.attributes.recurring_frequency) || normalizeText(entity.attributes.frequency) || normalizeText(entity.attributes.recurrence) || normalizeText(entity.attributes.recurrence_text); const freqKey = freqRaw.toLowerCase().replace(/ /g, ''_''); const freqLocalizedMap = { daily: i18n(''daily'', ''err-daily''), daily_multi: i18n(''daily_multi'', ''err-daily_multi''), weekly: i18n(''weekly'', ''err-weekly''), biweekly: i18n(''biweekly'', ''err-biweekly''), monthly: i18n(''monthly'', ''err-monthly''), quarterly: i18n(''quarterly'', ''err-quarterly''), yearly: i18n(''yearly'', ''err-yearly''), custom: i18n(''custom'', ''err-custom''), custom_from_complete: i18n(''custom_from_complete'', ''err-custom_from_complete''), custom_1_week: i18n(''custom_1_week'', ''err-custom_1_week''), custom_1_month: i18n(''custom_1_month'', ''err-custom_1_month''), custom_1_quarter: i18n(''custom_1_quarter'', ''err-custom_1_quarter''), custom_1_year: i18n(''custom_1_year'', ''err-custom_1_year'') }; const isKnownNone = [''none'', ''unknown'', ''unavailable'', ''null''].includes(freqKey); const hasFreq = freqKey.length > 0 && !isKnownNone; const freqText = freqLocalizedMap[freqKey] || formatFreqText(freqRaw.toLowerCase().replace(/_/g, '' '')); const rText = hasFreq ? ` • ${freqText}` : ''''; return `${String(statusLabel).toUpperCase()} • ${dueLabel}: ${dateText}${rText}`; ]]]',
"description": "[[[ const prefEnabled = (typeof variables !== 'undefined' && variables && variables.pref_show_chore_description === false) ? false : true; const value = typeof entity.attributes.description === 'string' ? entity.attributes.description.trim() : ''; if (!prefEnabled || value.length === 0) return ''; const escaped = value.replace(/&/g, '&').replace(//g, '>'); return `${escaped}`; ]]]",
- "history": '[[[ const i18n = (key, fallback) => { const labels = (typeof variables !== ''undefined'' && variables && typeof variables.ui_labels === ''object'') ? variables.ui_labels : null; const value = labels && typeof labels[key] === ''string'' ? labels[key].trim() : ''''; return value.length > 0 ? value : ((typeof fallback === ''string'' && fallback.startsWith(''err-'')) ? fallback : `err-${key}`); }; const map = { completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), already_approved: i18n(''completed'', ''err-completed''), pending_claim: i18n(''claimed'', ''err-claimed''), waiting: i18n(''waiting'', ''err-waiting''), missed_locked: i18n(''missed'', ''err-missed''), blocked_completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), blocked_already_approved: i18n(''completed'', ''err-completed''), blocked_pending_claim: i18n(''claimed'', ''err-claimed''), blocked_waiting_window: i18n(''waiting'', ''err-waiting''), blocked_not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), blocked_missed_locked: i18n(''missed'', ''err-missed'') }; const toNameList = (raw) => { if (Array.isArray(raw)) { return [...new Set(raw.map((item) => String(item == null ? '''' : item)).map((item) => item.trim()).filter(Boolean))]; } return []; }; const formatPoints = (rawValue) => { const numericValue = Number(rawValue); if (!Number.isFinite(numericValue)) return null; const roundedValue = Math.round(numericValue * 100) / 100; const precision = (typeof variables !== ''undefined'' && variables && typeof variables.pref_points_precision === ''string'') ? variables.pref_points_precision.trim().toLowerCase() : ''fixed_0''; if (precision === ''adaptive'') { if (Math.abs(roundedValue - Math.round(roundedValue)) < 0.001) return String(Math.round(roundedValue)); if (Math.abs(roundedValue - Math.round(roundedValue * 10) / 10) < 0.001) return roundedValue.toFixed(1); return roundedValue.toFixed(2); } if (precision === ''fixed_1'') return roundedValue.toFixed(1); if (precision === ''fixed_2'') return roundedValue.toFixed(2); return String(Math.round(roundedValue)); }; const rawState = entity.state; const state = rawState === ''approved_in_part'' ? ''completed_in_part'' : rawState; const rawGlobalState = entity.attributes.global_state; const globalState = typeof rawGlobalState === ''string'' ? rawGlobalState : state; const claimMode = entity.attributes.claim_mode || null; const claimAccent = (typeof variables !== ''undefined'' && variables && typeof variables.pref_claim_accent === ''string'' && variables.pref_claim_accent.trim().length > 0) ? variables.pref_claim_accent.trim() : ''#a957fa''; const overdueAccent = (typeof variables !== ''undefined'' && variables && typeof variables.pref_overdue_accent === ''string'' && variables.pref_overdue_accent.trim().length > 0) ? variables.pref_overdue_accent.trim() : ''#ff4444''; const stealAccent = (typeof variables !== ''undefined'' && variables && typeof variables.pref_steal_accent === ''string'' && variables.pref_steal_accent.trim().length > 0) ? variables.pref_steal_accent.trim() : ''#F2C94C''; const type = entity.attributes.completion_criteria || ''''; const assigned = toNameList(entity.attributes.assigned_user_names); const completed = toNameList(entity.attributes.completed_by); const claimedRaw = entity.attributes.claimed_by; const claimed = Array.isArray(claimedRaw) ? [...new Set(claimedRaw.map((item) => String(item == null ? '''' : item)).map((item) => item.trim()).filter(Boolean))] : (claimedRaw ? [String(claimedRaw).trim()].filter(Boolean) : []); const progressedBy = [...new Set([...claimed, ...completed])]; const progressedByAssigned = assigned.filter((name) => progressedBy.includes(name)); const missingByAssigned = assigned.filter((name) => !progressedBy.includes(name)); const isRotationType = type.includes(''rotation''); const isSharedAll = type === ''shared_all''; const isSingleCompletion = type === ''shared_first'' || isRotationType; const isSharedType = isSharedAll || isSingleCompletion; const isGlobalFullyCompleted = [''completed'', ''already_approved'', ''completed_by_other''].includes(globalState); const missedLabel = i18n(''missed'', ''err-missed''); const stealLabel = i18n(''steal_window_open'', ''err-steal_window_open''); const currentTurnLabel = i18n(''current_turn'', ''err-current_turn''); const currentlyLabel = i18n(''currently'', ''err-currently''); const availableInLabel = i18n(''available_in'', ''err-available_in''); const overdueInLabel = i18n(''overdue_in'', ''err-overdue_in''); const progressLabel = i18n(''progress'', ''err-progress''); const completedLabel = i18n(''completed'', ''err-completed''); const byLabel = i18n(''by'', ''err-by''); const lastLabel = i18n(''last'', ''err-last''); let context = ''''; if (claimMode === ''steal_available'') { const turnName = entity.attributes.turn_user_name; context = turnName ? `${stealLabel} • ${currentTurnLabel}: ${turnName}` : `${stealLabel}`; } else if (isSharedType && globalState === ''overdue'') { if (isRotationType) { const turnName = entity.attributes.turn_user_name; context = turnName ? `${missedLabel}: ${turnName}` : `${missedLabel}`; } else { context = missingByAssigned.length > 0 ? `${missedLabel}: ${missingByAssigned.join('', '')}` : `${missedLabel}`; } } else if (state === ''not_my_turn'' && entity.attributes.turn_user_name) { context = `${currentlyLabel}: ${entity.attributes.turn_user_name}`; } else if (isSharedAll) { const totalCount = assigned.length > 0 ? assigned.length : 1; const progressCount = progressedByAssigned.length; const hasProgressSignal = progressCount > 0 || [''claimed'', ''claimed_in_part'', ''approved_in_part'', ''completed'', ''completed_in_part'', ''already_approved'', ''completed_by_other''].includes(globalState); if (hasProgressSignal) { const label = isGlobalFullyCompleted ? completedLabel : progressLabel; if (progressedByAssigned.length > 0) { context = isGlobalFullyCompleted ? `${label}: ${progressCount}/${totalCount} • ${progressedByAssigned.join('', '')}` : `${label}: ${progressCount}/${totalCount} • ${byLabel} ${progressedByAssigned.join('', '')}`; } else { context = `${label}: ${progressCount}/${totalCount}`; } } } else if (isSingleCompletion) { const actorName = progressedByAssigned[0] || progressedBy[0] || ''''; if (actorName) { context = `${completedLabel}: ${actorName}`; } } else if (state === ''waiting'') { const waitText = entity.attributes.time_until_due || ''--''; context = `${availableInLabel}: ${waitText}`; } else if (state === ''due'') { const overdueInText = entity.attributes.time_until_overdue || ''--''; context = `${overdueInLabel}: ${overdueInText}`; } else if (entity.attributes.can_claim === false && claimMode) { if (!isSharedType && [''missed_locked'', ''blocked_missed_locked''].includes(claimMode)) { context = ''''; } else { context = map[claimMode] || claimMode; } } const parts = []; if (context) parts.push(context); const rawLastCompleted = entity.attributes.last_completed; const lastCompletedText = typeof rawLastCompleted === ''string'' ? rawLastCompleted.trim().toLowerCase() : ''''; const hasLastCompleted = !!rawLastCompleted && !['''', ''never'', ''unknown'', ''unavailable'', ''none'', ''null''].includes(lastCompletedText); if (hasLastCompleted) { const lastDate = new Date(rawLastCompleted); if (!Number.isNaN(lastDate.getTime())) { const lastText = lastDate.toLocaleDateString(undefined, {month:''short'', day:''numeric''}); parts.push(`${lastLabel}: ${lastText}`); } } const gamificationEnabled = typeof variables !== ''undefined'' && variables && variables.gamification_enabled === true; const formattedPoints = formatPoints(entity.attributes.default_points); const pointsLabel = (typeof variables !== ''undefined'' && variables && typeof variables.points_label === ''string'' && variables.points_label.trim().length > 0) ? variables.points_label.trim() : ''Points''; if (gamificationEnabled && formattedPoints !== null) { parts.push(`${pointsLabel}: ${formattedPoints}`); } return parts.join('' • ''); ]]]',
+ "history": '[[[ const getLabels = () => { const directLabels = (typeof variables !== ''undefined'' && variables && typeof variables.ui_labels === ''object'') ? variables.ui_labels : null; if (directLabels) return directLabels; const sensorId = (typeof variables !== ''undefined'' && variables && typeof variables.translation_sensor_eid === ''string'') ? variables.translation_sensor_eid.trim() : ''''; const sensorState = sensorId && typeof hass !== ''undefined'' && hass && hass.states ? hass.states[sensorId] : null; const sensorLabels = sensorState && sensorState.attributes && typeof sensorState.attributes.ui_translations === ''object'' ? sensorState.attributes.ui_translations : null; return sensorLabels; }; const i18n = (key, fallback) => { const labels = getLabels(); const value = labels && typeof labels[key] === ''string'' ? labels[key].trim() : ''''; return value.length > 0 ? value : ((typeof fallback === ''string'' && fallback.startsWith(''err-'')) ? fallback : `err-${key}`); }; const map = { completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), already_approved: i18n(''completed'', ''err-completed''), pending_claim: i18n(''claimed'', ''err-claimed''), waiting: i18n(''waiting'', ''err-waiting''), missed_locked: i18n(''missed'', ''err-missed''), blocked_completed_by_other: i18n(''completed_by_other'', ''err-completed_by_other''), blocked_already_approved: i18n(''completed'', ''err-completed''), blocked_pending_claim: i18n(''claimed'', ''err-claimed''), blocked_waiting_window: i18n(''waiting'', ''err-waiting''), blocked_not_my_turn: i18n(''not_my_turn'', ''err-not_my_turn''), blocked_missed_locked: i18n(''missed'', ''err-missed'') }; const toNameList = (raw) => { if (Array.isArray(raw)) { return [...new Set(raw.map((item) => String(item == null ? '''' : item)).map((item) => item.trim()).filter(Boolean))]; } return []; }; const formatPoints = (rawValue) => { const numericValue = Number(rawValue); if (!Number.isFinite(numericValue)) return null; const roundedValue = Math.round(numericValue * 100) / 100; const precision = (typeof variables !== ''undefined'' && variables && typeof variables.pref_points_precision === ''string'') ? variables.pref_points_precision.trim().toLowerCase() : ''fixed_0''; if (precision === ''adaptive'') { if (Math.abs(roundedValue - Math.round(roundedValue)) < 0.001) return String(Math.round(roundedValue)); if (Math.abs(roundedValue - Math.round(roundedValue * 10) / 10) < 0.001) return roundedValue.toFixed(1); return roundedValue.toFixed(2); } if (precision === ''fixed_1'') return roundedValue.toFixed(1); if (precision === ''fixed_2'') return roundedValue.toFixed(2); return String(Math.round(roundedValue)); }; const rawState = entity.state; const state = rawState === ''approved_in_part'' ? ''completed_in_part'' : rawState; const rawGlobalState = entity.attributes.global_state; const globalState = typeof rawGlobalState === ''string'' ? rawGlobalState : state; const claimMode = entity.attributes.claim_mode || null; const claimAccent = (typeof variables !== ''undefined'' && variables && typeof variables.pref_claim_accent === ''string'' && variables.pref_claim_accent.trim().length > 0) ? variables.pref_claim_accent.trim() : ''#a957fa''; const overdueAccent = (typeof variables !== ''undefined'' && variables && typeof variables.pref_overdue_accent === ''string'' && variables.pref_overdue_accent.trim().length > 0) ? variables.pref_overdue_accent.trim() : ''#ff4444''; const stealAccent = (typeof variables !== ''undefined'' && variables && typeof variables.pref_steal_accent === ''string'' && variables.pref_steal_accent.trim().length > 0) ? variables.pref_steal_accent.trim() : ''#F2C94C''; const type = entity.attributes.completion_criteria || ''''; const assigned = toNameList(entity.attributes.assigned_user_names); const completed = toNameList(entity.attributes.completed_by); const claimedRaw = entity.attributes.claimed_by; const claimed = Array.isArray(claimedRaw) ? [...new Set(claimedRaw.map((item) => String(item == null ? '''' : item)).map((item) => item.trim()).filter(Boolean))] : (claimedRaw ? [String(claimedRaw).trim()].filter(Boolean) : []); const progressedBy = [...new Set([...claimed, ...completed])]; const progressedByAssigned = assigned.filter((name) => progressedBy.includes(name)); const missingByAssigned = assigned.filter((name) => !progressedBy.includes(name)); const isRotationType = type.includes(''rotation''); const isSharedAll = type === ''shared_all''; const isSingleCompletion = type === ''shared_first'' || isRotationType; const isSharedType = isSharedAll || isSingleCompletion; const isGlobalFullyCompleted = [''completed'', ''already_approved'', ''completed_by_other''].includes(globalState); const missedLabel = i18n(''missed'', ''err-missed''); const stealLabel = i18n(''steal_window_open'', ''err-steal_window_open''); const currentTurnLabel = i18n(''current_turn'', ''err-current_turn''); const currentlyLabel = i18n(''currently'', ''err-currently''); const availableInLabel = i18n(''available_in'', ''err-available_in''); const overdueInLabel = i18n(''overdue_in'', ''err-overdue_in''); const progressLabel = i18n(''progress'', ''err-progress''); const completedLabel = i18n(''completed'', ''err-completed''); const byLabel = i18n(''by'', ''err-by''); const lastLabel = i18n(''last'', ''err-last''); let context = ''''; if (claimMode === ''steal_available'') { const turnName = entity.attributes.turn_user_name; context = turnName ? `${stealLabel} • ${currentTurnLabel}: ${turnName}` : `${stealLabel}`; } else if (isSharedType && globalState === ''overdue'') { if (isRotationType) { const turnName = entity.attributes.turn_user_name; context = turnName ? `${missedLabel}: ${turnName}` : `${missedLabel}`; } else { context = missingByAssigned.length > 0 ? `${missedLabel}: ${missingByAssigned.join('', '')}` : `${missedLabel}`; } } else if (state === ''not_my_turn'' && entity.attributes.turn_user_name) { context = `${currentlyLabel}: ${entity.attributes.turn_user_name}`; } else if (isSharedAll) { const totalCount = assigned.length > 0 ? assigned.length : 1; const progressCount = progressedByAssigned.length; const hasProgressSignal = progressCount > 0 || [''claimed'', ''claimed_in_part'', ''approved_in_part'', ''completed'', ''completed_in_part'', ''already_approved'', ''completed_by_other''].includes(globalState); if (hasProgressSignal) { const label = isGlobalFullyCompleted ? completedLabel : progressLabel; if (progressedByAssigned.length > 0) { context = isGlobalFullyCompleted ? `${label}: ${progressCount}/${totalCount} • ${progressedByAssigned.join('', '')}` : `${label}: ${progressCount}/${totalCount} • ${byLabel} ${progressedByAssigned.join('', '')}`; } else { context = `${label}: ${progressCount}/${totalCount}`; } } } else if (isSingleCompletion) { const actorName = progressedByAssigned[0] || progressedBy[0] || ''''; if (actorName) { context = `${completedLabel}: ${actorName}`; } } else if (state === ''waiting'') { const waitText = entity.attributes.time_until_due || ''--''; context = `${availableInLabel}: ${waitText}`; } else if (state === ''due'') { const overdueInText = entity.attributes.time_until_overdue || ''--''; context = `${overdueInLabel}: ${overdueInText}`; } else if (entity.attributes.can_claim === false && claimMode) { if (!isSharedType && [''missed_locked'', ''blocked_missed_locked''].includes(claimMode)) { context = ''''; } else { context = map[claimMode] || claimMode; } } const parts = []; if (context) parts.push(context); const rawLastCompleted = entity.attributes.last_completed; const lastCompletedText = typeof rawLastCompleted === ''string'' ? rawLastCompleted.trim().toLowerCase() : ''''; const hasLastCompleted = !!rawLastCompleted && !['''', ''never'', ''unknown'', ''unavailable'', ''none'', ''null''].includes(lastCompletedText); if (hasLastCompleted) { const lastDate = new Date(rawLastCompleted); if (!Number.isNaN(lastDate.getTime())) { const lastText = lastDate.toLocaleDateString(undefined, {month:''short'', day:''numeric''}); parts.push(`${lastLabel}: ${lastText}`); } } const gamificationEnabled = typeof variables !== ''undefined'' && variables && variables.gamification_enabled === true; const formattedPoints = formatPoints(entity.attributes.default_points); const pointsLabel = (typeof variables !== ''undefined'' && variables && typeof variables.points_label === ''string'' && variables.points_label.trim().length > 0) ? variables.points_label.trim() : ''Points''; if (gamificationEnabled && formattedPoints !== null) { parts.push(`${pointsLabel}: ${formattedPoints}`); } return parts.join('' • ''); ]]]',
"points": "[[[ return ''; ]]]",
"progress": '[[[ const type = entity.attributes.completion_criteria || ''''; if (type !== ''shared_all'') return ''''; const toNameList = (raw) => { if (Array.isArray(raw)) { return [...new Set(raw.map((item) => String(item == null ? '''' : item)).map((item) => item.trim()).filter(Boolean))]; } return []; }; const assigned = toNameList(entity.attributes.assigned_user_names); const completed = toNameList(entity.attributes.completed_by); const claimedRaw = entity.attributes.claimed_by; const claimed = Array.isArray(claimedRaw) ? [...new Set(claimedRaw.map((item) => String(item == null ? '''' : item)).map((item) => item.trim()).filter(Boolean))] : (claimedRaw ? [String(claimedRaw).trim()].filter(Boolean) : []); const progressedBy = [...new Set([...claimed, ...completed])]; const progressedByAssigned = assigned.filter((name) => progressedBy.includes(name)); const total = assigned.length; if (total <= 0) return ''''; const done = Math.min(progressedByAssigned.length, total); const pct = Math.max(0, Math.min(100, Math.round((done / total) * 100))); const globalState = entity.attributes.global_state || ''''; const claimAccent = (typeof variables !== ''undefined'' && variables && typeof variables.pref_claim_accent === ''string'' && variables.pref_claim_accent.trim().length > 0) ? variables.pref_claim_accent.trim() : ''#a957fa''; const isGlobalFullyCompleted = [''completed'', ''already_approved'', ''completed_by_other''].includes(globalState); const fillColor = [''claimed'', ''claimed_in_part''].includes(globalState) ? claimAccent : (globalState === ''approved_in_part'' ? ''var(--primary-color)'' : (isGlobalFullyCompleted ? ''var(--success-color)'' : ''var(--primary-color)'')); return `` + `
` + `
${done}/${total}` + `