custom-card-helpers 2.0.0 → 2.1.0

package/dist/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@formatjs/intl-utils')) :
-    typeof define === 'function' && define.amd ? define(['exports', '@formatjs/intl-utils'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.customCardHelpers = {}, global.intlUtils));
-})(this, (function (exports, intlUtils) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+    typeof define === 'function' && define.amd ? define(['exports'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.customCardHelpers = {}));
+})(this, (function (exports) { 'use strict';
 
     /**
      * Apply a theme to an element by setting the CSS variables on it.
@@ -89,6 +89,13 @@
         return DOMAIN_ICONS[domain] || "mdi:bookmark";
     };
 
+    /**
+     * @deprecated Reads `friendly_name`, which Home Assistant is moving away from -
+     * it now always includes the device name, so this duplicates context the
+     * surrounding UI already shows. Prefer `hass.formatEntityName(stateObj, name)`
+     * on HA 2026.4 and later, which resolves the name from the entity's registry
+     * context and lets users choose which parts to include.
+     */
     const computeName = (stateObj) => stateObj.attributes.friendly_name || stateObj.entity_id;
 
     function computeRTL(hass) {
@@ -139,6 +146,30 @@
         TimeFormat["am_pm"] = "12";
         TimeFormat["twenty_four"] = "24";
     })(exports.TimeFormat || (exports.TimeFormat = {}));
+    exports.TimeZone = void 0;
+    (function (TimeZone) {
+        TimeZone["local"] = "local";
+        TimeZone["server"] = "server";
+    })(exports.TimeZone || (exports.TimeZone = {}));
+    exports.DateFormat = void 0;
+    (function (DateFormat) {
+        DateFormat["language"] = "language";
+        DateFormat["system"] = "system";
+        DateFormat["DMY"] = "DMY";
+        DateFormat["MDY"] = "MDY";
+        DateFormat["YMD"] = "YMD";
+    })(exports.DateFormat || (exports.DateFormat = {}));
+    exports.FirstWeekday = void 0;
+    (function (FirstWeekday) {
+        FirstWeekday["language"] = "language";
+        FirstWeekday["monday"] = "monday";
+        FirstWeekday["tuesday"] = "tuesday";
+        FirstWeekday["wednesday"] = "wednesday";
+        FirstWeekday["thursday"] = "thursday";
+        FirstWeekday["friday"] = "friday";
+        FirstWeekday["saturday"] = "saturday";
+        FirstWeekday["sunday"] = "sunday";
+    })(exports.FirstWeekday || (exports.FirstWeekday = {}));
 
     // REF: https://github.com/home-assistant/frontend/blob/dev/src/common/datetime/use_am_pm.ts
     /**
@@ -737,6 +768,74 @@
         return parts[0] * 3600 + parts[1] * 60 + parts[2];
     }
 
+    /*
+     * selectUnit() taken from @formatjs/intl-units 3.8.4.
+     *
+     */
+    const MS_PER_SECOND = 1e3;
+    const SECS_PER_MIN = 60;
+    const SECS_PER_HOUR = SECS_PER_MIN * 60;
+    const SECS_PER_DAY = SECS_PER_HOUR * 24;
+    const SECS_PER_WEEK = SECS_PER_DAY * 7;
+    function selectUnit(from, to = Date.now(), thresholds = {}) {
+        const resolvedThresholds = Object.assign(Object.assign({}, DEFAULT_THRESHOLDS), (thresholds || {}));
+        const secs = (+from - +to) / MS_PER_SECOND;
+        if (Math.abs(secs) < resolvedThresholds.second) {
+            return {
+                value: Math.round(secs),
+                unit: 'second',
+            };
+        }
+        const mins = secs / SECS_PER_MIN;
+        if (Math.abs(mins) < resolvedThresholds.minute) {
+            return {
+                value: Math.round(mins),
+                unit: 'minute',
+            };
+        }
+        const hours = secs / SECS_PER_HOUR;
+        if (Math.abs(hours) < resolvedThresholds.hour) {
+            return {
+                value: Math.round(hours),
+                unit: 'hour',
+            };
+        }
+        const days = secs / SECS_PER_DAY;
+        if (Math.abs(days) < resolvedThresholds.day) {
+            return {
+                value: Math.round(days),
+                unit: 'day',
+            };
+        }
+        const fromDate = new Date(from);
+        const toDate = new Date(to);
+        const years = fromDate.getFullYear() - toDate.getFullYear();
+        if (Math.round(Math.abs(years)) > 0) {
+            return {
+                value: Math.round(years),
+                unit: 'year',
+            };
+        }
+        const months = years * 12 + fromDate.getMonth() - toDate.getMonth();
+        if (Math.round(Math.abs(months)) > 0) {
+            return {
+                value: Math.round(months),
+                unit: 'month',
+            };
+        }
+        const weeks = secs / SECS_PER_WEEK;
+        return {
+            value: Math.round(weeks),
+            unit: 'week',
+        };
+    }
+    const DEFAULT_THRESHOLDS = {
+        second: 45, // seconds to minute
+        minute: 45, // minutes to hour
+        hour: 22, // hour to day
+        day: 5, // day to week
+    };
+
     //REF: https://github.com/home-assistant/frontend/blob/dev/src/common/datetime/relative_time.ts
     const formatRelTimeMem = (locale) => new Intl.RelativeTimeFormat(locale.language, { numeric: "auto" });
     /**
@@ -745,7 +844,7 @@
      * Example output: 5 minutes ago, in 3 days.
      */
     const relativeTime = (from, locale, to, includeTense = true) => {
-        const diff = intlUtils.selectUnit(from, to);
+        const diff = selectUnit(from, to);
         if (includeTense) {
             return formatRelTimeMem(locale).format(diff.value, diff.unit);
         }
@@ -756,6 +855,24 @@
         }).format(Math.abs(diff.value));
     };
 
+    //REF: https://github.com/home-assistant/frontend/blob/dev/src/common/datetime/seconds_to_duration.ts
+    const leftPad = (num) => (num < 10 ? `0${num}` : num);
+    function secondsToDuration(d) {
+        const h = Math.floor(d / 3600);
+        const m = Math.floor((d % 3600) / 60);
+        const s = Math.floor((d % 3600) % 60);
+        if (h > 0) {
+            return `${h}:${leftPad(m)}:${leftPad(s)}`;
+        }
+        if (m > 0) {
+            return `${m}:${leftPad(s)}`;
+        }
+        if (s > 0) {
+            return "" + s;
+        }
+        return null;
+    }
+
     function timerTimeRemaining(stateObj) {
         let timeRemaining = durationToSeconds(stateObj.attributes.remaining);
         if (stateObj.state === "active") {
@@ -1043,18 +1160,15 @@
     };
 
     const getLovelace = () => {
-        let root = document.querySelector('home-assistant');
-        root = root && root.shadowRoot;
-        root = root && root.querySelector('home-assistant-main');
-        root = root && root.shadowRoot;
-        root = root && root.querySelector('app-drawer-layout partial-panel-resolver');
-        root = root && root.shadowRoot || root;
-        root = root && root.querySelector('ha-panel-lovelace');
-        root = root && root.shadowRoot;
-        root = root && root.querySelector('hui-root');
-        if (root) {
-            const ll = root.lovelace;
-            ll.current_view = root.___curView;
+        var _a, _b, _c, _d, _e, _f;
+        const root = (_c = (_b = (_a = document
+            .querySelector("home-assistant")) === null || _a === void 0 ? void 0 : _a.shadowRoot) === null || _b === void 0 ? void 0 : _b.querySelector("home-assistant-main")) === null || _c === void 0 ? void 0 : _c.shadowRoot;
+        const resolver = (root === null || root === void 0 ? void 0 : root.querySelector("ha-drawer partial-panel-resolver")) ||
+            (root === null || root === void 0 ? void 0 : root.querySelector("app-drawer-layout partial-panel-resolver"));
+        const huiRoot = (_f = (_e = (_d = ((resolver === null || resolver === void 0 ? void 0 : resolver.shadowRoot) || resolver)) === null || _d === void 0 ? void 0 : _d.querySelector("ha-panel-lovelace")) === null || _e === void 0 ? void 0 : _e.shadowRoot) === null || _f === void 0 ? void 0 : _f.querySelector("hui-root");
+        if (huiRoot) {
+            const ll = huiRoot.lovelace;
+            ll.current_view = huiRoot.___curView;
             return ll;
         }
         return null;
@@ -1092,6 +1206,8 @@
         }
         return hass.callService(serviceDomain, service, { entity_id: entityId });
     };
+    const turnOnEntity = (hass, entityId) => turnOnOffEntity(hass, entityId, true);
+    const turnOffEntity = (hass, entityId) => turnOnOffEntity(hass, entityId, false);
 
     const toggleEntity = (hass, entityId) => {
         const turnOn = STATES_OFF.includes(hass.states[entityId].state);
@@ -1137,13 +1253,21 @@
                     forwardHaptic("success");
                 }
                 break;
+            case "turn_on":
+                turnOnOffEntity(hass, actionConfig.entity || config.entity, true);
+                forwardHaptic("success");
+                break;
+            case "turn_off":
+                turnOnOffEntity(hass, actionConfig.entity || config.entity, false);
+                forwardHaptic("success");
+                break;
             case "call-service": {
                 if (!actionConfig.service) {
                     forwardHaptic("failure");
                     return;
                 }
                 const [domain, service] = actionConfig.service.split(".", 2);
-                hass.callService(domain, service, actionConfig.service_data, actionConfig.target);
+                hass.callService(domain, service, actionConfig.data, actionConfig.target);
                 forwardHaptic("success");
                 break;
             }
@@ -1228,7 +1352,7 @@
                     return;
                 }
                 const [domain, service] = actionConfig.service.split(".", 2);
-                const serviceData = Object.assign({}, actionConfig.service_data);
+                const serviceData = Object.assign({}, actionConfig.data);
                 if (serviceData.entity_id === "entity") {
                     serviceData.entity_id = config.entity;
                 }
@@ -1273,6 +1397,46 @@
         return config !== undefined && config.action !== "none";
     }
 
+    /**
+     * Scroll to a specific y coordinate.
+     *
+     * Copied from paper-scroll-header-panel.
+     *
+     * @method scroll
+     * @param {number} top The coordinate to scroll to, along the y-axis.
+     * @param {boolean} smooth true if the scroll position should be smoothly adjusted.
+     */
+    function scrollToTarget(element, target) {
+        // the scroll event will trigger _updateScrollState directly,
+        // However, _updateScrollState relies on the previous `scrollTop` to update the states.
+        // Calling _updateScrollState will ensure that the states are synced correctly.
+        const top = 0;
+        const scroller = target;
+        const easingFn = function easeOutQuad(t, b, c, d) {
+            /* eslint-disable no-param-reassign, space-infix-ops, no-mixed-operators */
+            t /= d;
+            return -c * t * (t - 2) + b;
+            /* eslint-enable no-param-reassign, space-infix-ops, no-mixed-operators */
+        };
+        const animationId = Math.random();
+        const duration = 200;
+        const startTime = Date.now();
+        const currentScrollTop = scroller.scrollTop;
+        const deltaScrollTop = top - currentScrollTop;
+        element._currentAnimationId = animationId;
+        (function updateFrame() {
+            const now = Date.now();
+            const elapsedTime = now - startTime;
+            if (elapsedTime > duration) {
+                scroller.scrollTop = top;
+            }
+            else if (element._currentAnimationId === animationId) {
+                scroller.scrollTop = easingFn(elapsedTime, currentScrollTop, deltaScrollTop, duration);
+                requestAnimationFrame(updateFrame.bind(element));
+            }
+        }.call(element));
+    }
+
     /** Return an icon representing a binary sensor state. */
     const binarySensorIcon = (state, stateObj) => {
         const is_off = state === "off";
@@ -1335,17 +1499,86 @@
         const open = state.state !== "closed";
         switch (state.attributes.device_class) {
             case "garage":
-                return open ? "mdi:garage-open" : "mdi:garage";
+                switch (state.state) {
+                    case "opening":
+                        return "mdi:arrow-up-box";
+                    case "closing":
+                        return "mdi:arrow-down-box";
+                    case "closed":
+                        return "mdi:garage";
+                    default:
+                        return "mdi:garage-open";
+                }
+            case "gate":
+                switch (state.state) {
+                    case "opening":
+                    case "closing":
+                        return "mdi:gate-arrow-right";
+                    case "closed":
+                        return "mdi:gate";
+                    default:
+                        return "mdi:gate-open";
+                }
             case "door":
                 return open ? "mdi:door-open" : "mdi:door-closed";
+            case "damper":
+                return open ? "mdi:circle" : "mdi:circle-slice-8";
             case "shutter":
-                return open ? "mdi:window-shutter-open" : "mdi:window-shutter";
+                switch (state.state) {
+                    case "opening":
+                        return "mdi:arrow-up-box";
+                    case "closing":
+                        return "mdi:arrow-down-box";
+                    case "closed":
+                        return "mdi:window-shutter";
+                    default:
+                        return "mdi:window-shutter-open";
+                }
+            case "curtain":
+                switch (state.state) {
+                    case "opening":
+                        return "mdi:arrow-split-vertical";
+                    case "closing":
+                        return "mdi:arrow-collapse-horizontal";
+                    case "closed":
+                        return "mdi:curtains-closed";
+                    default:
+                        return "mdi:curtains";
+                }
             case "blind":
-                return open ? "mdi:blinds-open" : "mdi:blinds";
+            case "shade":
+                switch (state.state) {
+                    case "opening":
+                        return "mdi:arrow-up-box";
+                    case "closing":
+                        return "mdi:arrow-down-box";
+                    case "closed":
+                        return "mdi:blinds";
+                    default:
+                        return "mdi:blinds-open";
+                }
             case "window":
-                return open ? "mdi:window-open" : "mdi:window-closed";
+                switch (state.state) {
+                    case "opening":
+                        return "mdi:arrow-up-box";
+                    case "closing":
+                        return "mdi:arrow-down-box";
+                    case "closed":
+                        return "mdi:window-closed";
+                    default:
+                        return "mdi:window-open";
+                }
             default:
-                return domainIcon("cover", state.state);
+                switch (state.state) {
+                    case "opening":
+                        return "mdi:arrow-up-box";
+                    case "closing":
+                        return "mdi:arrow-down-box";
+                    case "closed":
+                        return "mdi:window-closed";
+                    default:
+                        return "mdi:window-open";
+                }
         }
     };
 
@@ -1406,7 +1639,7 @@
     };
 
     const domainIcons = {
-        binary_sensor: binarySensorIcon,
+        binary_sensor: (stateObj) => binarySensorIcon(stateObj.state, stateObj),
         cover: coverIcon,
         sensor: sensorIcon,
         input_datetime: inputDateTimeIcon,
@@ -1482,6 +1715,7 @@
     exports.debounce = debounce;
     exports.deepEqual = deepEqual;
     exports.domainIcon = domainIcon;
+    exports.durationToSeconds = durationToSeconds;
     exports.evaluateFilter = evaluateFilter;
     exports.fireEvent = fireEvent;
     exports.fixedIcons = fixedIcons;
@@ -1513,9 +1747,13 @@
     exports.numberFormatToLocale = numberFormatToLocale;
     exports.relativeTime = relativeTime;
     exports.round = round;
+    exports.scrollToTarget = scrollToTarget;
+    exports.secondsToDuration = secondsToDuration;
     exports.stateIcon = stateIcon;
     exports.timerTimeRemaining = timerTimeRemaining;
     exports.toggleEntity = toggleEntity;
+    exports.turnOffEntity = turnOffEntity;
+    exports.turnOnEntity = turnOnEntity;
     exports.turnOnOffEntities = turnOnOffEntities;
     exports.turnOnOffEntity = turnOnOffEntity;