Initial commit: Add Pstryk Energy Card v4.1.0

- Add main card implementation with full/compact/super_compact modes - Support for sparkline and bars widgets with effects - Price color coding based on best/worst price ranges - Alert system for high/low price thresholds - Polish/English translations support - HACS integration configuration - Development guidelines in AGENTS.md
2025-11-21 12:13:59 +01:00
commit f6147a0787
4 changed files with 1356 additions and 0 deletions
--- a/README.md
+++ b/README.md
@ -0,0 +1,94 @@
+# 🏠 Pstryk Energy Card dla Home Assistant
+
+![Version](https://img.shields.io/badge/version-4.1.0-blue.svg) ![HACS](https://img.shields.io/badge/HACS-Custom-orange.svg) ![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+---
+
+## ✨ Co potrafi?
+
+* 🎨 Trzy tryby wyświetlania: **pełny**, **kompaktowy**, **super kompaktowy**
+* 📊 Widgety: słupki lub linia z animacją
+* 🚨 Alerty: ostrzeżenia, gdy cena przekracza ustalone progi
+* 🔴🟢 Zmiana koloru na czerwony/zielony w zależności od ustawień cen w integracji
+* 🌍 Obsługa PL i EN – karta sama wykryje język
+* 🎯 Efekty i zbędne bajery
+
+![{8ADD4FD9-6CE4-4984-B94C-3022E159F392}](https://github.com/user-attachments/assets/d27dab7a-0055-4e85-9b22-12e0a8c3f8cf)
+![{55E1D715-4207-4254-A312-30519EF5FC50}](https://github.com/user-attachments/assets/9ca7fef7-1693-4b67-ba07-32cb5d36f38b)
+![{4FC17EE9-74AA-4445-BF92-BE63CAB8F9BD}](https://github.com/user-attachments/assets/e65754ac-1a92-49d7-bd03-0af2f87a8117)
+
+## 📦 Jak zainstalować?
+
+**1. HACS (najprościej)**
+
+1. Otwórz HACS → **+**
+2. Wybierz **Custom repositories**
+3. Wklej URL: `https://github.com/balgerion/ha_Pstryk_card`
+4. W kategorii zaznacz **Dashboard** i kliknij **Add**
+5. Zainstaluj **Pstryk Energy Card**
+6. Zrestartuj Home Assistant
+
+**2. Ręcznie**
+
+1. Ściągnij plik `pstryk-card.js` i wrzuć do `/www/community/pstryk-card`
+2. W Home Assistant: **Settings → Dashboards → Resources → Add Resource**
+
+   * URL: `/local/community/pstryk-card/pstryk-card.js`
+   * Typ: **JavaScript Module**
+3. Zrestartuj
+
+---
+
+## 🚀 Szybki start - przykłady
+
+##full
+                   
+```yaml
+type: custom:pstryk-card
+buy_entity: sensor.pstryk_current_buy_price
+sell_entity: sensor.pstryk_current_sell_price
+card_mode: full                   # full | compact | super_compact
+show_title: true                  # true | false
+show_legend: true                 # true | false
+show_widget: sparkline            # none | bars | sparkline
+widget_effect: pulse              # none | pulse (sparkline) | fill (bars)
+widget_hours: 24                  # 1-48
+alert_buy_above: 1.15             # liczba lub null
+alert_sell_below: 0.25            # liczba lub null
+hover_effect: lift                # none | lift | glow | shake | pulse
+click_action: none                # none | more-info
+```
+##Kompaktowy z słupkami
+```yaml
+type: custom:pstryk-card
+buy_entity: sensor.pstryk_current_buy_price
+sell_entity: sensor.pstryk_current_sell_price
+card_mode: compact                # full | compact | super_compact
+show_widget: bars                 # none | bars | sparkline
+widget_effect: fill               # none | fill (bars) | pulse (sparkline) 
+widget_hours: 12                  # 1-48
+hover_effect: glow                # none | lift | glow | shake | pulse
+attribute_config: average_24      # next_hour | average_remaining | average_24 | null | custom_attribute
+```
+
+##Super kompaktowy (minimalny)
+```yaml
+type: custom:pstryk-card
+buy_entity: sensor.pstryk_current_buy_price
+sell_entity: sensor.pstryk_current_sell_price
+card_mode: super_compact          # full | compact | super_compact
+alert_buy_above: 1.0              # liczba lub null
+alert_sell_below: 0.1             # liczba lub null
+```
+
+## ⚙️ Wszystkie opcje
+
+* **buy\_entity** (`string`) – encja z ceną zakupu (np. `sensor.pstryk_current_buy_price`)
+* **sell\_entity** (`string`) – encja z ceną sprzedaży
+* **card\_mode** (`full`/`compact`/`super_compact`) – wybierz wygląd karty
+* **title** (`string`) – tekst nagłówka (domyślnie "Energy Prices")
+* **show\_title** (`true`/`false`) – wyświetl tytuł
+* **show\_legend** (`true`/`false`) – legenda kolorów (tylko w `full`)
+* **attribute\_config** (`next_hour`/`average_remaining`/`average_24`/`null`/`custom`) – dodatkowy atrybut
+* **show\_widget** (`none`/`bars`/`sparkline`) – typ wykresu
+* **widget\_effect** (`none`/`pulse`/`fill`) – animacja wykresu (pulse (sparkline), fill (bars))