release: v1.7.31

fix: addToInventory creates new row when all existing rows are opened
When adding a new pack of a product that already has an opened row in inventory (opened_at IS NOT NULL), the previous code merged the new stock into the opened row, corrupting opened_at tracking and hiding the second pack from the anomaly model. Now: search only for sealed rows (opened_at IS NULL) to merge into. If only opened rows exist, INSERT a new sealed row instead.
2026-05-29 06:46:40 +00:00 · 2026-05-29 06:46:37 +00:00 · 2026-05-29 06:37:52 +00:00 · 2026-05-29 06:37:50 +00:00 · 2026-05-29 06:34:50 +00:00 · 2026-05-29 06:34:40 +00:00
24 changed files with 11825 additions and 6923 deletions
@@ -129,6 +129,33 @@ GDRIVE_RETENTION_DAYS=30
 # Leave empty to allow anyone with access to the server to change settings.
 SETTINGS_TOKEN=

+# INSTANCE_NAME: display name for this EverShelf instance (used by the HA integration
+# for Zeroconf discovery label and device name in Home Assistant).
+# Defaults to the server hostname if left empty.
+INSTANCE_NAME=
+
+# ── Home Assistant Integration ────────────────────────────────────────────────
+# All HA settings can also be configured from the Settings → 🏠 tab.
+#
+# HA_ENABLED: master switch for all HA features (webhooks, TTS, sensors)
+HA_ENABLED=false
+# HA_URL: base URL of your HA instance — no trailing slash
+# Examples: http://homeassistant.local:8123  or  http://192.168.1.50:8123
+HA_URL=
+# HA_TOKEN: Long-Lived Access Token (HA Profile → Security → Long-Lived Access Tokens)
+HA_TOKEN=
+# HA_TTS_ENTITY: media_player entity for recipe step TTS (e.g. media_player.living_room)
+HA_TTS_ENTITY=
+# HA_WEBHOOK_ID: ID of an HA automation's Webhook trigger
+HA_WEBHOOK_ID=
+# HA_WEBHOOK_EVENTS: comma-separated events to fire webhooks for
+#   Available: expiry, shopping_add, stock_update, barcode_scan
+HA_WEBHOOK_EVENTS=expiry,shopping_add,stock_update
+# HA_NOTIFY_SERVICE: HA notify service for push alerts (e.g. notify.mobile_app_my_phone)
+HA_NOTIFY_SERVICE=
+# HA_EXPIRY_DAYS: days before expiry to trigger expiry alert (default 3)
+HA_EXPIRY_DAYS=3
+
 # ── Developer / demo ─────────────────────────────────────────────────────────
 # DEMO_MODE: when true, all write operations are blocked (for public demos)
 DEMO_MODE=false
@@ -1,5 +1,8 @@
 name: Build & Release Kiosk APK

+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 on:
  push:
    branches: [main]
@@ -6,6 +6,9 @@ on:
  pull_request:
    branches: [main]

+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 jobs:
  lint-php:
    name: PHP Syntax Check
@@ -102,7 +105,9 @@ jobs:
        uses: actions/checkout@v6
        with:
          fetch-depth: 0
-          token: ${{ secrets.GITHUB_TOKEN }}
+          # Always use the built-in GITHUB_TOKEN for checkout (read-only fetch).
+          # WORKFLOW_PAT is only needed for the push step below.
+          token: ${{ github.token }}

      - name: Configure git bot identity
        run: |
@@ -111,6 +116,15 @@ jobs:

      - name: Merge develop → main
        run: |
+          # ── ROOT CAUSE FIX ──────────────────────────────────────────────────
+          # actions/checkout writes an http.extraheader (AUTHORIZATION: basic …)
+          # that silently overrides any credentials embedded in git remote URLs.
+          # We must clear it BEFORE setting the remote URL with WORKFLOW_PAT,
+          # otherwise GITHUB_TOKEN is always used for the push and workflow-file
+          # changes are rejected.
+          # ────────────────────────────────────────────────────────────────────
+          git config --local --unset-all http."https://github.com/".extraheader 2>/dev/null || true
+
          LAST=$(git log --oneline -1 origin/develop)
          git checkout main
          git pull --ff-only origin main
@@ -118,6 +132,26 @@ jobs:
            -m "chore: auto-merge develop → main

          Triggered by: $LAST"
+
+          # ── PUSH STRATEGY ───────────────────────────────────────────────────
+          # Priority 1: WORKFLOW_PAT (classic PAT, repo+workflow scopes)
+          #   → can push workflow file changes; set as a repo secret.
+          # Priority 2: GITHUB_TOKEN fallback
+          #   → cannot push workflow files; strip them from the merge commit.
+          # ────────────────────────────────────────────────────────────────────
+          PUSH_TOKEN="${{ secrets.WORKFLOW_PAT }}"
+          if [ -z "$PUSH_TOKEN" ]; then
+            WF=$(git diff --name-only origin/main -- .github/workflows/ 2>/dev/null || echo "")
+            if [ -n "$WF" ]; then
+              echo "::warning::WORKFLOW_PAT not set — stripping workflow changes from merge commit:"
+              echo "$WF"
+              git checkout origin/main -- .github/workflows/
+              git diff --cached --quiet || git commit --amend --no-edit
+            fi
+            PUSH_TOKEN="${{ github.token }}"
+          fi
+
+          git remote set-url origin "https://x-access-token:${PUSH_TOKEN}@github.com/${{ github.repository }}.git"
          git push origin main

  # ── Auto-create GitHub Release on main ───────────────────────────────────
@@ -1,5 +1,8 @@
 name: Security Scan (Trivy)

+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
 on:
  push:
    branches: [main, develop]
@@ -11,6 +11,75 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

 - **Recipe scraps tips** — During cooking steps, detect "waste" generated (peels, cores, bones, eggshells, coffee grounds, citrus zest, etc.) and surface AI-powered tips on how to reuse them (compost, natural cleaner, broth, candied peel, etc.). Could be shown as an optional collapsible hint card below the step that generates the scrap.

+## [1.7.31] - 2026-05-29
+
+### Fixed
+- **New pack merges into opened pack on add** — `addToInventory` was looking for ANY existing row for the same product+location and adding the new quantity to it. This caused a newly purchased sealed pack to be silently merged with an already-opened pack, collapsing two physically distinct containers into one row and corrupting the `opened_at` timestamp. The fix now searches only for a **sealed** (unopened) row (`opened_at IS NULL`) to merge into. If only opened rows exist, a new sealed row is created instead — keeping the two packs separate and allowing the anomaly model and shelf-life tracker to work correctly.
+
+
+## [1.7.30] - 2026-05-29
+
+### Fixed
+- **False consumption anomaly with multi-row stock** — The anomaly detection banner was evaluating each inventory row in isolation. Products split across multiple rows (e.g. one opened pack with 1 pz + one sealed pack with 6 pz) incorrectly triggered a "consumed faster than expected" warning because only the opened row (1 pz) was compared against the model. The check now aggregates the total quantity across all rows for the same product before deciding to flag an anomaly. If the combined total ≥ expected remaining, the anomaly is suppressed.
+
+
+## [1.7.29] - 2026-05-29
+
+### Added
+- **Buy-cycle consumption prediction** — Products that are never tracked per-use (salt, spices, cleaning supplies, etc.) now use the average time between restocks as a proxy for consumption rate. When a product has ≥ 3 purchase events and no individual `out` events, EverShelf calculates the average buy cycle (`(lastBuy - firstBuy) / (buyCount - 1)`) and estimates how many days of stock remain in the current cycle. The product appears in the smart shopping list with a reason like "Finisce tra ~12gg (ciclo medio 75gg)" before it runs out, rather than only after. These products are now also treated as `isRegular` so all stock-level urgency checks apply correctly.
+
+
+## [1.7.28] - 2026-05-30
+
+### Fixed
+- **Duplicate auto-reported issues** — The GitHub issue reporter was relying solely on the GitHub Search API for deduplication. Because search indexing has a several-minutes lag, rapid error recurrences each created a new issue before the previous one was indexed, producing ~50 duplicate issues. The reporter now uses a local file cache (`data/reported_issue_fps.json`, with `/tmp/` fallback when `data/` is not writable) as the primary deduplication store. A 30-minute per-fingerprint comment throttle is also applied to prevent flooding an existing issue. GitHub Search is used only on first run or after a cache miss. Closes [#134](https://github.com/dadaloop82/EverShelf/issues/134) (and all duplicates #135–#183).
+
+## [1.7.27] - 2026-05-29
+
+### Added
+- **HA sensor enrichment** — All HA sensor attributes that list products now include full product details: `location`, `brand`, `category`, `days_remaining`, `opened_at`, `vacuum_sealed`, `default_quantity`, `package_unit`, `product_id`, `inventory_id`. Applies to `expiring_list`, the new `expired_list`, and the new `low_stock_list`.
+- **HA `expired_list` attribute** — `sensor.evershelf_overview` now exposes `expired_list` (full details for all expired items, not just a count).
+- **HA `low_stock_list` attribute** — New attribute listing all items with quantity ≤ 1 with full product info.
+- **HA `sensor=product` endpoint** — New `GET /api/?action=ha_sensor&sensor=product` returns the full inventory with all product details. Optional filters: `&id=N`, `&name=...`, `&location=...`.
+- **Inventory edit safety guard** — Confirm dialog when saving a quantity that is unusually large for its unit (e.g. 183 conf), preventing accidental data loss from unit-confusion typos.
+- **Bread shelf-life in fridge** — Opened shelf-life rules added for piadina/crescia (2 days), packaged sliced bread/bauletto (4 days), and generic bread (3 days).
+
+### Fixed
+- **Recipe AI ingredient substitution** — Added explicit rule to both recipe prompts preventing Gemini from substituting ingredient forms (e.g. fresh tomatoes ↔ passata, fresh milk ↔ UHT ↔ cream, flour 00 ↔ wholemeal).
+- **HA cron webhook payload** — Expiry alert webhook items now include full product details (brand, category, location, days_remaining, opened_at, vacuum_sealed) instead of only name/qty/unit/expiry_date.
+
+### Docs
+- `docs/wiki/Home-Assistant.md` — Documented new `sensor=product` endpoint, full product schema table, enriched webhook payload example, and Lovelace/automation template examples using `location` and `days_remaining`.
+
+## [1.7.26] - 2026-05-26
+
+### Added
+- **Monthly stats panel** — Third rotating card in the insight banner (anti-waste → nutrition → monthly stats, 1 minute each). Shows products consumed this month with a trend vs. the previous calendar month (↑/↓/→ with % delta), animated horizontal category bars, and badges for items added, wasted, and top-used product. Falls back gracefully when the current month has no transactions. Closes [#100](https://github.com/dadaloop82/EverShelf/issues/100).
+- **Extended smart-shopping horizon for staples** — Items consumed ≥ 4 times/month now get a 28-day look-ahead window; ≥ 2 times/month get 21 days. Frequently used staples no longer disappear from the smart list between restocks. Closes [#98](https://github.com/dadaloop82/EverShelf/issues/98).
+
+### Fixed
+- **TTS test interactive confirmation** — Test timeout raised from 4 s to 10 s; instead of an error, the UI shows a YES/NO prompt ("Did you hear it?") so users can confirm or report failure explicitly.
+- **`end()` PHP 8 reference error** — `_offFetchProduct()` passed the result of `??` directly to `end()`, which requires a variable. Fixed with a temporary variable.
+- **Database migration crash on fresh installs** — `migrateDB()` tried to rename the `transactions` table before it existed. A `sqlite_master` guard now calls `initializeDB()` and returns early when the schema is absent. Closes [#131](https://github.com/dadaloop82/EverShelf/issues/131), [#133](https://github.com/dadaloop82/EverShelf/issues/133).
+- **Health-check crash on empty database** — `db_row_count` query was executed even when the `inventory` table was missing, causing a fatal PDO error. The query is now skipped until the schema is fully initialised. Closes [#132](https://github.com/dadaloop82/EverShelf/issues/132).
+- **Insight banner stuck on one panel** — Rotation interval was 1 hour (effectively invisible); now 60 seconds. `_applyInsightPhase` also now skips empty panels instead of always falling back to the anti-waste card, so the rotation works correctly even when a panel has no data.
+- **Untranslated OpenFoodFacts category labels** — Categories stored as OFF slugs (`en:plant-based-foods-and-beverages`, `en:dairies`, …) were shown raw. A new `_normalizeCat()` PHP function maps ~60 OFF slugs to Italian app categories; counts are re-aggregated after normalisation so `en:dairies` + `en:milk` both contribute to `latticini`.
+
+## [1.7.25] - 2026-05-25
+
+### Added
+- **Home Assistant integration** — Full bidirectional HA support: inventory sensor (`sensor.evershelf_*`) exposes item counts, expiring items, shopping total, opened items and next-expiry info. Webhooks fire on inventory changes (add/use/shopping). Daily cron alert notifies via HA for items expiring within the configured threshold. TTS announces cooking steps through HA Media Player. New Settings tab 🏠 with connection test, TTS preset (Piper, Google, Nabu Casa), webhook config, and YAML snippet for `configuration.yaml`. Resolves [#111](https://github.com/dadaloop82/EverShelf/issues/111).
+- **Offline mode** — Full offline-first support. Full-screen overlay on network loss; "Continue offline" button after 3 s, auto-enter after 8 s. Inventory and settings are synced to `localStorage` at startup and cached on every successful API call. Writes (add/use/update/delete) are queued and synced on reconnect with optimistic UI updates. Pending operations survive page refresh and are re-synced automatically at next startup. AI/network-dependent sections (anti-waste chart, nutrition analysis, recipe generator, price fetching, Gemini chat) are hidden in offline mode. `remoteLog` and `reportError` are buffered offline and flushed on restore. Broken external images replaced with a grey placeholder.
+- **Offline-computed dashboard** — While offline, `inventory_summary` and `stats` (expiring/expired/opened) are derived client-side from the local cache so all dashboard stat cards and expiry alerts show accurate data.
+
+### Fixed
+- **Offline banner flood** — Opened items in the offline `stats` response lacked `is_edible`; `!undefined` evaluated to `true`, causing every opened item to be shown as "not edible" in the dashboard banner. Field is now set to `true` (client-side shelf-life check already handles genuinely expired items).
+- **Version update badge showing older versions** — `_checkWebappUpdate` used `latestTag !== _loadedVersion` (inequality only), so running a newer dev build triggered an "update available" badge for an older GitHub release. Now uses `_semverGt(latest, current)` so only genuinely newer releases trigger the badge.
+- **Bring! items re-appearing after manual purchase removal** — `removeBringItem` and `confirmShoppingItemFound` now call `_markBringPurchased` immediately, and `autoAddCriticalItems` respects the blocklist for depleted items.
+- **Barcode lookup false "not found"** — New `_offFetchProduct()` tries three barcode candidates (given, UPC-A↔EAN-13 conversion) across two Open Food Facts locales with auto-retry.
+- **Partial throw from expired-items banner** — "Butta" now opens the throw modal (qty + location) instead of silently deleting the entire inventory row.
+- **Related stock display when scanning branded products** — When scanning a product, the action page now shows a green card listing any inventory items from the same generic family already at home.
+
 ## [1.7.24] - 2026-05-21

 ### Fixed
@@ -25,7 +25,7 @@
 [![SQLite](https://img.shields.io/badge/SQLite-3-blue.svg)](https://www.sqlite.org/)
 [![Docker](https://img.shields.io/badge/Docker-Ready-2496ED.svg)](Dockerfile)
 [![i18n](https://img.shields.io/badge/i18n-IT%20%7C%20EN%20%7C%20DE%20%7C%20FR%20%7C%20ES-orange.svg)](translations/)
-[![Version](https://img.shields.io/badge/version-1.7.24-brightgreen.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-1.7.25-brightgreen.svg)](CHANGELOG.md)
 [![GitHub stars](https://img.shields.io/github/stars/dadaloop82/EverShelf?style=social)](https://github.com/dadaloop82/EverShelf/stargazers)
 [![Last commit](https://img.shields.io/github/last-commit/dadaloop82/EverShelf/main)](https://github.com/dadaloop82/EverShelf/commits/main)
 [![Contributors](https://img.shields.io/github/contributors/dadaloop82/EverShelf)](https://github.com/dadaloop82/EverShelf/graphs/contributors)
@@ -36,13 +36,39 @@

 ---

+> **⚠️ Name disambiguation:** There is an unrelated iOS app also called **EverShelf**, developed and published by [Joshumi Technologies LLC](https://evershelf.joshumi.com/) on the [Apple App Store](https://apps.apple.com/app/evershelf/id6759439940). That application is a **completely separate, independent product** with no affiliation, association, or collaboration with this open-source project. This repository has no connection to Joshumi Technologies LLC, its products, or its services.
+
+---
+
 ## ✨ Features

-> ⚙️ **New in v1.7.23 — Global settings tab, DB auto-cleanup, vacuum-sealed expiry**
-> A new **General** tab groups all global settings (language, currency, theme, screensaver, zero-waste, export) in one place.
-> Recipes older than `RECIPE_RETENTION_DAYS` and transactions older than `TRANSACTION_RETENTION_DAYS` are deleted automatically every cron cycle, followed by a SQLite `VACUUM` to keep the database small.
-> Vacuum-sealed products get an extended grace period (`VACUUM_EXPIRY_EXTENSION_DAYS`, default 30 days) before being flagged as expired.
-> Auto theme now follows **time of day** (dark 20:00–07:00) instead of the OS setting, making it server-friendly.
+### 🏠 NEW — Home Assistant Integration
+
+EverShelf has a **native Home Assistant integration** available on HACS.  
+Connect your pantry to your smart home in minutes — no YAML, no manual sensor setup.
+
+[![Install via HACS](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=dadaloop82&repository=ha-evershelf&category=integration)
+&nbsp;
+[![Add Integration](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=evershelf)
+
+**What you get:**
+
+| | |
+|---|---|
+| **16 sensors** | Expiry counts, stock levels by location (pantry / fridge / freezer), shopping list total, AI API usage, last backup timestamp, days to next expiry |
+| **6 binary sensors** | Expired items, expiring items, expiring today, shopping list active, backup overdue, Bring! connected |
+| **5 action buttons** | Refresh data, Refresh prices, **Suggest Recipe** (AI — result as HA notification), Sync smart shopping, Clear expired rows |
+| **Shopping list todo** | Bidirectional sync — add, remove, check off items directly from HA |
+| **Expiry calendar** | Every product's expiry date as a native HA calendar event — works with the calendar card and any calendar automation |
+| **Quick-add text entity** | Type a product name in HA to instantly add it to the shopping list (great for voice assistants / Assist) |
+| **6 services** | `add_to_shopping`, `mark_used`, `refresh`, `suggest_recipe`, `refresh_prices`, `clear_expired` |
+| **Auto-discovery** | Detected automatically via Zeroconf/mDNS when `avahi-daemon` runs on the EverShelf host |
+| **5 languages** | English, Italian, German, French, Spanish |
+
+> **Requires a self-hosted EverShelf instance.** The integration talks directly to your server — no cloud involved.  
+> Full documentation: [ha-evershelf on GitHub](https://github.com/dadaloop82/ha-evershelf)
+
+---

 ### 📦 Inventory Management
 - **Export inventory** — Download the full inventory as a UTF-8 CSV (Excel-compatible) or open a print-ready page to save as PDF; export button always visible in the inventory page header
@@ -111,7 +137,16 @@
 - **Mobile-first design** — Optimized for phones, works on tablets and desktop
 - **Installable** — Add to home screen for a native app experience
 - **Multi-device** — All user data (shopping tags, pinned items, location preferences, scan history) is stored server-side in SQLite and shared across every device on the same instance; no data is siloed in a single browser's localStorage
-
+### 📶 Offline Mode
+- **Automatic detection** — Full-screen overlay appears immediately on network loss; shows a "Continue offline" button after 3 s, and auto-enters offline mode after 8 s
+- **Local inventory cache** — Inventory is synced to `localStorage` at every startup and on each successful API call; the offline view always reflects the last known state
+- **Write queue** — Add, use, update and delete operations performed while offline are queued locally and synced to the server automatically on reconnect (including after a page refresh)
+- **Optimistic UI** — Queued writes are applied immediately to the local cache so the interface stays responsive
+- **Offline-computed stats** — Expiring and expired items are derived client-side from the cache; dashboard stat cards show real counts instead of zeros
+- **AI/network sections hidden** — Anti-waste chart, nutrition analysis, recipe generator, price fetching, and Gemini chat are hidden in offline mode; the inventory, history, and manually-managed shopping list remain fully functional
+- **Broken image fallback** — External product images (Open Food Facts, etc.) that fail to load are replaced with a neutral grey placeholder, keeping the layout intact
+- **Startup recovery** — If the page is refreshed while operations are queued, they are detected and synced automatically on the next successful startup
+- **Buffered error reporting** — `remoteLog` and `reportError` calls made while offline are stored locally and flushed to the server (and to GitHub issues) when the connection is restored
 ### ⚖️ Smart Scale Integration (Add-on)
 - **Bluetooth gateway** — Connects a BLE smart scale to EverShelf via local WebSocket
 - **SSE relay** — Server-side relay avoids mixed-content (HTTPS→WS) issues
@@ -133,3 +133,120 @@ try {
    _phpErrorReport($msg, $e->getFile(), $e->getLine(), $e->getTraceAsString(), get_class($e));
    exit(1);
 }
+
+// ── Home Assistant: expiry alerts ─────────────────────────────────────────────
+// Fire one HA webhook per expiring item (once per day guard via a simple flag file).
+if (env('HA_ENABLED', 'false') === 'true' && env('HA_WEBHOOK_ID', '') !== '') {
+    try {
+        $haFlagFile = __DIR__ . '/../data/ha_expiry_notified_' . date('Y-m-d') . '.json';
+        if (!file_exists($haFlagFile)) {
+            $expiryDays = max(1, (int)env('HA_EXPIRY_DAYS', '3'));
+            $expiringItems = $db->query(
+                "SELECT p.id AS product_id, i.id AS inventory_id,
+                        p.name, p.brand, p.category, p.unit, p.default_quantity, p.package_unit,
+                        i.quantity, i.location, i.expiry_date, i.opened_at, i.vacuum_sealed
+                 FROM inventory i JOIN products p ON i.product_id = p.id
+                 WHERE i.quantity > 0 AND i.expiry_date IS NOT NULL
+                   AND i.expiry_date BETWEEN date('now') AND date('now', '+{$expiryDays} days')
+                 ORDER BY i.expiry_date ASC LIMIT 20"
+            )->fetchAll(PDO::FETCH_ASSOC);
+
+            $expiredItems = $db->query(
+                "SELECT p.id AS product_id, i.id AS inventory_id,
+                        p.name, p.brand, p.category, p.unit, p.default_quantity, p.package_unit,
+                        i.quantity, i.location, i.expiry_date, i.opened_at, i.vacuum_sealed
+                 FROM inventory i JOIN products p ON i.product_id = p.id
+                 WHERE i.quantity > 0 AND i.expiry_date IS NOT NULL
+                   AND i.expiry_date < date('now')
+                 ORDER BY i.expiry_date ASC LIMIT 10"
+            )->fetchAll(PDO::FETCH_ASSOC);
+
+            // Normalise rows to full product format
+            if (!function_exists('_haFormatProduct')) {
+                function _haFormatProduct(array $row): array {
+                    $daysRemaining = null;
+                    if (!empty($row['expiry_date'])) {
+                        $diff = (new DateTime(date('Y-m-d')))->diff(new DateTime($row['expiry_date']));
+                        $daysRemaining = (int)$diff->format('%r%a');
+                    }
+                    return [
+                        'product_id'       => (int)($row['product_id'] ?? 0),
+                        'inventory_id'     => (int)($row['inventory_id'] ?? 0),
+                        'name'             => $row['name'],
+                        'brand'            => $row['brand'] ?? null,
+                        'category'         => $row['category'] ?? null,
+                        'quantity'         => (float)($row['quantity'] ?? 0),
+                        'unit'             => $row['unit'] ?? '',
+                        'default_quantity' => (float)($row['default_quantity'] ?? 0),
+                        'package_unit'     => $row['package_unit'] ?? null,
+                        'location'         => $row['location'] ?? null,
+                        'expiry_date'      => $row['expiry_date'] ?? null,
+                        'days_remaining'   => $daysRemaining,
+                        'opened_at'        => $row['opened_at'] ?? null,
+                        'vacuum_sealed'    => !empty($row['vacuum_sealed']),
+                    ];
+                }
+            }
+            $expiringItems = array_map('_haFormatProduct', $expiringItems);
+            $expiredItems  = array_map('_haFormatProduct', $expiredItems);
+
+            if (!empty($expiringItems)) {
+                $names = implode(', ', array_column($expiringItems, 'name'));
+                _fireHaWebhook('expiry_alert', [
+                    'count'    => count($expiringItems),
+                    'items'    => $expiringItems,
+                    'type'     => 'expiring_soon',
+                    'days'     => $expiryDays,
+                    'summary'  => $names,
+                ]);
+                // Also send HA notification if service configured
+                if (env('HA_NOTIFY_SERVICE', '') !== '') {
+                    $msg = count($expiringItems) . ' product(s) expiring within ' . $expiryDays . ' days: ' . $names;
+                    _sendHaNotify($msg, ['expiring_items' => $expiringItems]);
+                }
+                echo '[' . date('Y-m-d H:i:s') . '] HA expiry_alert fired: ' . count($expiringItems) . " items\n";
+            }
+
+            if (!empty($expiredItems)) {
+                $expNames = implode(', ', array_column($expiredItems, 'name'));
+                _fireHaWebhook('expiry_alert', [
+                    'count'   => count($expiredItems),
+                    'items'   => $expiredItems,
+                    'type'    => 'expired',
+                    'summary' => $expNames,
+                ]);
+                echo '[' . date('Y-m-d H:i:s') . '] HA expired fired: ' . count($expiredItems) . " items\n";
+            }
+
+            // Mark as done for today
+            file_put_contents($haFlagFile, json_encode(['ts' => time(), 'expiring' => count($expiringItems ?? []), 'expired' => count($expiredItems ?? [])]));
+            // Clean up old flag files (keep last 7 days)
+            foreach (glob(__DIR__ . '/../data/ha_expiry_notified_*.json') as $oldFlag) {
+                $flagDate = str_replace([__DIR__ . '/../data/ha_expiry_notified_', '.json'], '', $oldFlag);
+                if ($flagDate < date('Y-m-d', strtotime('-7 days'))) @unlink($oldFlag);
+            }
+        }
+    } catch (Throwable $haE) {
+        echo '[' . date('Y-m-d H:i:s') . '] HA expiry hook warning: ' . $haE->getMessage() . "\n";
+    }
+}
+
+// ── Avahi/mDNS discovery registration ─────────────────────────────────────────
+// If avahi-daemon is running on this host, register the _evershelf._tcp service
+// so that Home Assistant can auto-discover this instance via Zeroconf.
+if (function_exists('shell_exec')) {
+    try {
+        $avahiService = '/etc/avahi/services/evershelf.xml';
+        // Only create/update if avahi-daemon is installed and the file doesn't exist yet
+        if (!file_exists($avahiService) && (shell_exec('which avahi-daemon 2>/dev/null') || shell_exec('which avahi-publish 2>/dev/null'))) {
+            $template = __DIR__ . '/../docker/avahi-evershelf.xml';
+            if (file_exists($template)) {
+                $xml = file_get_contents($template);
+                @file_put_contents($avahiService, $xml);
+                echo '[' . date('Y-m-d H:i:s') . '] Avahi mDNS service registered at ' . $avahiService . "\n";
+            }
+        }
+    } catch (Throwable $avahiE) {
+        // Non-fatal: avahi not available
+    }
+}
@@ -126,6 +126,16 @@ function initializeDB(PDO $db): void {
 }

 function migrateDB(PDO $db): void {
+    // Guard: if core tables don't exist yet (e.g. DB file present but empty / partial init),
+    // run initializeDB first so all tables are created, then return — no ALTER TABLE needed.
+    $productsExists = $db->query(
+        "SELECT name FROM sqlite_master WHERE type='table' AND name='products'"
+    )->fetchColumn();
+    if (!$productsExists) {
+        initializeDB($db);
+        return;
+    }
+
    // Add package_unit column if missing
    $cols = $db->query("PRAGMA table_info(products)")->fetchAll();
    $colNames = array_column($cols, 'name');
@@ -267,6 +277,20 @@ function migrateDB(PDO $db): void {
        ");
        $db->exec("CREATE UNIQUE INDEX IF NOT EXISTS idx_shopping_list_name ON shopping_list(lower(name))");
    }
+
+    // Add is_favorite column to recipes if missing (#124)
+    $recCols = array_column($db->query("PRAGMA table_info(recipes)")->fetchAll(), 'name');
+    if (!in_array('is_favorite', $recCols)) {
+        try { $db->exec("ALTER TABLE recipes ADD COLUMN is_favorite INTEGER NOT NULL DEFAULT 0"); }
+        catch (PDOException $e) { if (strpos($e->getMessage(), 'duplicate column') === false) throw $e; }
+    }
+
+    // Add nutriments_json column to products if missing (#118)
+    $prodCols2 = array_column($db->query("PRAGMA table_info(products)")->fetchAll(), 'name');
+    if (!in_array('nutriments_json', $prodCols2)) {
+        try { $db->exec("ALTER TABLE products ADD COLUMN nutriments_json TEXT DEFAULT NULL"); }
+        catch (PDOException $e) { if (strpos($e->getMessage(), 'duplicate column') === false) throw $e; }
+    }
 }

 /**
@@ -440,6 +464,14 @@ function estimateOpenedExpiryDaysPHP(string $name, string $category, string $loc
    if (preg_match('/\b(patata|patate|tubero)\b/', $n)) return 4;
    if (preg_match('/\baglio\b/', $n)) return 14;

+    // ── F.extra: Bread in fridge (opened) ──────────────────────────────────
+    // Thin flatbreads (piadina, crescia, tigella) get mold very quickly
+    if (preg_match('/\b(piadina|piadelle?|crescia|tigella)\b/', $n)) return 2;
+    // Packaged sliced bread — preservatives help a bit
+    if (preg_match('/\b(bauletto|pancarrè|pan\s+carr|tramezzin)\b/', $n)) return 4;
+    // Generic bread / sandwich bread in fridge
+    if (preg_match('/\bpane\b/', $cat)) return 3;
+
    // ── G: Fridge condiments — medium shelf-life ─────────────────────────
    if (preg_match('/maionese|mayo|mayon/', $n)) return 90;
    if (preg_match('/\bketchup\b/', $n)) return 90;
@@ -596,13 +596,37 @@ body {
 }
 .offline-banner-retry:hover { background: rgba(255,255,255,0.38); }

+/* Pulsing dot shown in the banner while the offline cache is being read */
+.offline-banner-dot {
+    display: inline-block;
+    width: 7px;
+    height: 7px;
+    border-radius: 50%;
+    background: #f87171;
+    margin-right: 6px;
+    vertical-align: middle;
+    animation: offline-dot-pulse 1.1s ease-in-out infinite;
+}
+@keyframes offline-dot-pulse {
+    0%, 100% { opacity: 0.3; transform: scale(0.8); }
+    50%       { opacity: 1;   transform: scale(1.15); }
+}
+
 /* When server is offline, block interactions with the main content */
-body.server-offline .app-content {
+body.server-offline:not(.offline-mode) .app-content {
    opacity: 0.4;
    pointer-events: none;
    user-select: none;
    transition: opacity 0.3s;
 }
+/* In offline-mode the app is usable; just a subtle left-border indicator */
+body.offline-mode .app-content {
+    border-left: 3px solid rgba(239, 68, 68, 0.45);
+}
+/* Hide the "Retry" button in the banner when in offline mode — use the Continue button instead */
+body.offline-mode .offline-banner-retry {
+    display: none;
+}
 body.server-offline .bottom-nav {
    opacity: 0.4;
    pointer-events: none;
@@ -1945,6 +1969,46 @@ body.server-offline .bottom-nav {
    text-overflow: ellipsis;
 }

+/* — Scan status bar — */
+.scan-status-bar {
+    position: absolute;
+    bottom: 38px;
+    left: 0;
+    right: 0;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 2px;
+    pointer-events: none;
+    z-index: 12;
+}
+.scan-status-method {
+    font-size: 0.58rem;
+    color: rgba(255,255,255,0.45);
+    text-transform: uppercase;
+    letter-spacing: 0.07em;
+    font-family: monospace;
+}
+.scan-status-msg {
+    font-size: 0.74rem;
+    color: rgba(255,255,255,0.9);
+    background: rgba(0,0,0,0.55);
+    padding: 3px 10px;
+    border-radius: 12px;
+    text-align: center;
+    max-width: 92%;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    transition: color 0.2s, background 0.2s;
+    backdrop-filter: blur(3px);
+}
+.scan-status-msg:empty { visibility: hidden; }
+.scan-status-msg.state-partial { color: #fbbf24; }
+.scan-status-msg.state-invalid { color: #f87171; background: rgba(239,68,68,0.28); }
+.scan-status-msg.state-confirmed { color: #4ade80; background: rgba(74,222,128,0.22); }
+.scan-status-msg.state-retry { color: #fb923c; }
+
 /* — Viewport overlay controls (torch / zoom / flip) — */
 .scan-viewport-controls {
    position: absolute;
@@ -2567,6 +2631,17 @@ body.server-offline .bottom-nav {
    color: var(--text-muted);
 }

+.shopping-pantry-hint {
+    font-size: 0.72rem;
+    color: #15803d;
+    font-weight: 500;
+    margin-top: 2px;
+    opacity: 0.85;
+}
+[data-theme="dark"] .shopping-pantry-hint {
+    color: #4ade80;
+}
+
 .shopping-item-right {
    display: flex;
    flex-direction: column;
@@ -3027,10 +3102,82 @@ body.server-offline .bottom-nav {
    gap: 14px;
 }

-.product-preview-small {
-    padding: 12px;
+/* Action and Use page hero card */
+#page-action .product-preview-small,
+#page-use .product-preview-small {
+    padding: 14px 16px;
+    gap: 14px;
+    border-left: 4px solid var(--primary);
+    align-items: flex-start;
+    position: relative;
 }

+/* action page: slightly larger name */
+#page-action .use-hero-name {
+    font-size: 1.15rem;
+}
+
+/* barcode pill on action page */
+.action-pill-barcode { background: #f1f5f9; color: #64748b; }
+
+.use-hero-icon {
+    font-size: 2.4rem;
+    width: 52px;
+    text-align: center;
+    flex-shrink: 0;
+    line-height: 1;
+    padding-top: 2px;
+}
+
+.use-hero-body {
+    flex: 1;
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    gap: 3px;
+}
+
+.use-hero-name {
+    font-size: 1.05rem;
+    font-weight: 700;
+    color: var(--text);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.use-hero-brand {
+    font-size: 0.8rem;
+    color: var(--text-light);
+}
+
+.use-hero-meta {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 5px;
+    margin-top: 5px;
+}
+
+.use-meta-pill {
+    display: inline-flex;
+    align-items: center;
+    gap: 3px;
+    font-size: 0.75rem;
+    font-weight: 600;
+    padding: 3px 8px;
+    border-radius: 99px;
+    line-height: 1.3;
+    white-space: nowrap;
+}
+
+/* Expiry pill colours */
+.use-pill-ok       { background: #dcfce7; color: #166534; }
+.use-pill-warn     { background: #fef9c3; color: #854d0e; }
+.use-pill-soon     { background: #fed7aa; color: #7c2d12; }
+.use-pill-expired  { background: #fee2e2; color: #991b1b; }
+/* Quantity pill */
+.use-pill-qty      { background: #e0f2fe; color: #0c4a6e; }
+
 .product-preview img, .product-preview-small img {
    width: 60px;
    height: 60px;
@@ -3040,8 +3187,11 @@ body.server-offline .bottom-nav {
 }

 .product-preview-small img {
-    width: 45px;
-    height: 45px;
+    width: 52px;
+    height: 52px;
+    border-radius: var(--radius-sm);
+    object-fit: cover;
+    flex-shrink: 0;
 }

 .product-preview-emoji {
@@ -4130,6 +4280,7 @@ body.server-offline .bottom-nav {
 .recipe-result .recipe-meta {
    display: flex;
    flex-wrap: wrap;
+    align-items: center;
    gap: 8px;
    margin-bottom: 12px;
 }
@@ -4166,6 +4317,35 @@ body.server-offline .bottom-nav {
    color: #3730a3;
    white-space: nowrap;
 }
+/* Appliance/mode badge shown inline next to a step text */
+.recipe-step-appliance {
+    display: inline-block;
+    margin-left: 6px;
+    background: #f0fdf4;
+    border: 1px solid #bbf7d0;
+    border-radius: 12px;
+    padding: 1px 8px;
+    font-size: 0.72rem;
+    color: #15803d;
+    vertical-align: middle;
+    white-space: nowrap;
+}
+
+/* Regen choice panel */
+.recipe-regen-choice {
+    background: #f8fafc;
+    border: 1px solid #e2e8f0;
+    border-radius: 12px;
+    padding: 14px;
+    margin-top: 10px;
+}
+.recipe-regen-choice-title {
+    font-size: 0.9rem;
+    font-weight: 600;
+    color: #475569;
+    margin: 0 0 10px 0;
+    text-align: center;
+}

 /* Recipe ingredient use buttons */
 .recipe-ingredients {
@@ -5583,6 +5763,26 @@ body.cooking-mode-active .app-header {
    background: rgba(59, 130, 246, 0.15);
 }

+/* Related stock hint (same generic family, different brand/product) */
+.action-related-stock-card {
+    background: #f0fdf4;
+    border: 1.5px solid #86efac;
+    border-radius: var(--radius);
+    padding: 10px 14px;
+    font-size: 0.82rem;
+    color: #166534;
+    margin-bottom: 12px;
+    line-height: 1.5;
+}
+.action-related-stock-card strong { color: #15803d; }
+.related-stock-item { display: inline-block; margin-right: 8px; }
+[data-theme="dark"] .action-related-stock-card {
+    background: rgba(21, 128, 61, 0.12);
+    border-color: #166534;
+    color: #86efac;
+}
+[data-theme="dark"] .action-related-stock-card strong { color: #4ade80; }
+
 /* ===== ACTION BUTTONS GRID ===== */
 .action-buttons-3col {
    display: grid;
@@ -6376,6 +6576,117 @@ body.cooking-mode-active .app-header {
    flex-wrap: wrap;
 }

+/* ===== RECIPE FAVORITES (#124) ===== */
+.recipe-fav-badge {
+    margin-left: auto;
+    font-size: 1.1rem;
+    color: #f59e0b;
+    flex-shrink: 0;
+}
+
+.recipe-archive-card-fav {
+    border-left: 3px solid #f59e0b;
+}
+
+.btn-recipe-fav {
+    background: none;
+    border: none;
+    font-size: 1.8rem;
+    cursor: pointer;
+    color: var(--text-muted);
+    padding: 0 4px;
+    line-height: 1;
+    vertical-align: middle;
+    transition: color 0.2s, transform 0.15s;
+    margin-left: auto;
+}
+
+.btn-recipe-fav:hover { color: #f59e0b; transform: scale(1.2); }
+.btn-recipe-fav.active { color: #f59e0b; }
+
+/* ===== PORTION RESCALER (#123) ===== */
+.recipe-persons-ctrl {
+    display: inline-flex;
+    align-items: center;
+    gap: 3px;
+    padding: 0 6px;
+    vertical-align: middle;
+    line-height: 1;
+}
+
+.btn-persons-adj {
+    background: none;
+    border: none;
+    color: var(--text-primary);
+    border-radius: 50%;
+    width: 18px;
+    height: 18px;
+    font-size: 0.85rem;
+    line-height: 1;
+    cursor: pointer;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0;
+    flex-shrink: 0;
+    transition: background 0.15s;
+}
+
+.btn-persons-adj:hover { background: var(--accent, #6366f1); color: #fff; }
+
+#recipe-persons-display {
+    white-space: nowrap;
+    font-size: 0.82rem;
+}
+
+/* ===== MACRONUTRIENT PANEL (#118) ===== */
+.macro-bars {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    margin: 12px 0 8px;
+}
+
+.macro-row {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+}
+
+.macro-label {
+    font-size: 0.75rem;
+    color: var(--text-muted);
+    min-width: 70px;
+    flex-shrink: 0;
+}
+
+.macro-bar-wrap {
+    flex: 1;
+    height: 8px;
+    background: var(--bg-secondary, #1e2a3a);
+    border-radius: 4px;
+    overflow: hidden;
+}
+
+.macro-bar-fill {
+    height: 100%;
+    width: 0%;
+    border-radius: 4px;
+    transition: width 0.6s ease;
+}
+
+.macro-val {
+    font-size: 0.72rem;
+    color: var(--text-primary);
+    text-align: right;
+    min-width: 80px;
+    flex-shrink: 0;
+}
+
+.macro-val small {
+    color: var(--text-muted);
+}
+
 /* ===== SCREENSAVER ===== */
 .screensaver-overlay {
    position: fixed;
@@ -6765,6 +7076,82 @@ body.cooking-mode-active .app-header {
 }
 .nutr-score-val { flex: 0 0 32px; text-align: right; font-weight: 600; }

+/* ===== MONTHLY STATS PANEL ===== */
+.ms-main-row {
+    display: flex;
+    align-items: center;
+    gap: 14px;
+    margin: 12px 0 8px;
+}
+.ms-main-num {
+    font-size: 2.8rem;
+    font-weight: 700;
+    color: #6366f1;
+    line-height: 1;
+    letter-spacing: -0.02em;
+}
+.ms-main-info {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+}
+.ms-main-label {
+    font-size: .85rem;
+    color: #94a3b8;
+}
+.ms-trend {
+    font-size: .8rem;
+    font-weight: 500;
+}
+.ms-cats-section {
+    margin: 6px 0 4px;
+}
+.ms-cats-title {
+    font-size: .68rem;
+    font-weight: 600;
+    color: #64748b;
+    text-transform: uppercase;
+    letter-spacing: .06em;
+    margin-bottom: 7px;
+}
+.ms-cat-row {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 5px;
+}
+.ms-cat-name {
+    font-size: .74rem;
+    color: #cbd5e1;
+    min-width: 78px;
+    max-width: 78px;
+    text-align: right;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+.ms-cat-bar-wrap {
+    flex: 1;
+    height: 8px;
+    background: #1e293b;
+    border-radius: 4px;
+    overflow: hidden;
+}
+.ms-cat-bar {
+    height: 100%;
+    border-radius: 4px;
+    width: 0;
+}
+.ms-cat-cnt {
+    font-size: .7rem;
+    color: #64748b;
+    min-width: 22px;
+    text-align: right;
+}
+.ms-badges-row {
+    margin-top: 6px;
+}
+
 /* ===== SETUP WIZARD ===== */
 .setup-wizard-content {
    max-width: 480px;
@@ -7510,11 +7897,22 @@ body.cooking-mode-active .app-header {
 /* ── Use inventory info ── */
 [data-theme="dark"] .use-inventory-info { background: #0c2a4e; color: #7dd3fc; }
 [data-theme="dark"] #use-expiry-hint    { background: #2a1e00; border-color: #78350f; color: #fde68a; }
+[data-theme="dark"] #page-use .product-preview-small  { border-left-color: var(--primary); }
+[data-theme="dark"] #page-action .product-preview-small { border-left-color: var(--primary); }
+[data-theme="dark"] .action-pill-barcode { background: #1e293b; color: #94a3b8; }
+[data-theme="dark"] .use-pill-ok       { background: #14532d; color: #86efac; }
+[data-theme="dark"] .use-pill-warn     { background: #422006; color: #fde68a; }
+[data-theme="dark"] .use-pill-soon     { background: #431407; color: #fdba74; }
+[data-theme="dark"] .use-pill-expired  { background: #450a0a; color: #fca5a5; }
+[data-theme="dark"] .use-pill-qty      { background: #0c2a4e; color: #7dd3fc; }

 /* ── Recipe components ── */
 [data-theme="dark"] .recipe-expiry-note  { background: #2a1e00; color: #fde68a; }
 [data-theme="dark"] .recipe-tools-banner { background: #1a1040; border-color: #3730a3; color: #c4b5fd; }
 [data-theme="dark"] .recipe-tool-chip    { background: #2e1a4a; color: #c4b5fd; }
+[data-theme="dark"] .recipe-step-appliance { background: #052e16; border-color: #166534; color: #4ade80; }
+[data-theme="dark"] .recipe-regen-choice { background: #1e293b; border-color: #334155; }
+[data-theme="dark"] .recipe-regen-choice-title { color: #94a3b8; }
 [data-theme="dark"] .recipe-subtype-chip { background: #1c1300; border-color: #78350f; color: var(--text); }
 [data-theme="dark"] .recipe-subtype-chip:has(input:checked) { background: #2a1e00; border-color: #d97706; }

@@ -7541,3 +7939,117 @@ body.cooking-mode-active .app-header {

 /* ── Appliance remove active ── */
 [data-theme="dark"] .appliance-item .appliance-remove:active { background: #2a0808; }
+
+/* ===== NETWORK ERROR OVERLAY ===== */
+#network-error-overlay {
+    position: fixed;
+    inset: 0;
+    background: rgba(6, 8, 20, 0.97);
+    z-index: 300000; /* highest: above screensaver(10000), cooking(99999), preloader(200000) */
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    opacity: 0;
+    transition: opacity 0.4s ease;
+    pointer-events: none;
+}
+#network-error-overlay.visible {
+    opacity: 1;
+    pointer-events: auto;
+}
+.net-error-body {
+    text-align: center;
+    padding: 2.5rem 2rem;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+}
+.net-error-icon {
+    font-size: 5.5rem;
+    line-height: 1;
+    margin-bottom: 1.75rem;
+    animation: net-pulse 2.2s ease-in-out infinite;
+    display: block;
+    filter: drop-shadow(0 0 32px rgba(248, 113, 113, 0.35));
+}
+#network-error-overlay.restored .net-error-icon {
+    animation: none;
+    filter: drop-shadow(0 0 32px rgba(74, 222, 128, 0.45));
+}
+#network-error-overlay.checking .net-error-icon {
+    animation: net-spin 1.2s linear infinite;
+}
+@keyframes net-pulse {
+    0%, 100% { opacity: 0.45; transform: scale(0.92); }
+    50%       { opacity: 1;    transform: scale(1.06); }
+}
+@keyframes net-spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
+.net-error-title {
+    font-size: 2.5rem;
+    font-weight: 700;
+    color: #f87171;
+    margin-bottom: 0.75rem;
+    letter-spacing: -0.02em;
+    transition: color 0.4s;
+}
+#network-error-overlay.restored .net-error-title {
+    color: #4ade80;
+}
+.net-error-subtitle {
+    font-size: 1.1rem;
+    color: #94a3b8;
+    max-width: 420px;
+    line-height: 1.6;
+    margin: 0 auto;
+}
+.net-error-status {
+    margin-top: 1.5rem;
+    font-size: 0.88rem;
+    color: #475569;
+    min-height: 1.3em;
+    letter-spacing: 0.01em;
+}
+/* "Continue in offline mode" button — appears after 3 s */
+.net-error-continue-btn {
+    margin-top: 2.2rem;
+    background: rgba(255,255,255,0.07);
+    border: 1px solid rgba(255,255,255,0.22);
+    color: #94a3b8;
+    border-radius: 10px;
+    padding: 0.7rem 1.6rem;
+    font-size: 0.92rem;
+    cursor: pointer;
+    transition: background 0.2s, color 0.2s, transform 0.3s, opacity 0.3s;
+    opacity: 0;
+    transform: translateY(8px);
+}
+.net-error-continue-btn.visible {
+    opacity: 1;
+    transform: translateY(0);
+}
+.net-error-continue-btn:hover {
+    background: rgba(255,255,255,0.16);
+    color: #e2e8f0;
+}
+
+/* ─── Offline mode: hide AI and network-dependent UI ────────────────────────
+   Sections that require a live server response or AI are hidden so the user
+   isn't confronted with empty/broken widgets while offline.               */
+body.offline-mode #waste-chart-section,
+body.offline-mode #nutrition-section,
+body.offline-mode #quick-recipe-bar,
+body.offline-mode .header-gemini-btn,
+body.offline-mode #btn-suggest,
+body.offline-mode #btn-fetch-prices,
+body.offline-mode .recipe-generate-btn {
+    display: none !important;
+}
+/* Smart-shopping AI section: show as disabled rather than disappearing entirely */
+body.offline-mode #smart-shopping {
+    opacity: 0.45;
+    pointer-events: none;
+    filter: grayscale(0.6);
+}
@@ -0,0 +1,12 @@
+<?xml version="1.0" standalone='no'?>
+<!DOCTYPE service-group SYSTEM "avahi-service.dtd">
+<service-group>
+  <name replace-wildcards="yes">EverShelf Pantry (%h)</name>
+  <service>
+    <type>_evershelf._tcp</type>
+    <port>80</port>
+    <txt-record>path=/api/</txt-record>
+    <txt-record>version=1.0</txt-record>
+    <txt-record>app=evershelf</txt-record>
+  </service>
+</service-group>
@@ -0,0 +1,308 @@
+# Home Assistant Integration
+
+EverShelf integrates natively with [Home Assistant](https://www.home-assistant.io/) to bring your pantry data into your smart-home automations.
+
+**Capabilities:**
+- 📡 **REST sensors** — expose pantry counts as HA sensor entities (expiring, expired, shopping list, total items)
+- 🔔 **Webhooks** — trigger HA automations on pantry events (expiry alerts, shopping additions, stock updates)
+- 📣 **Push notifications** — send alerts to your phone via any HA `notify.*` service
+- 🔊 **TTS on smart speakers** — read recipe steps aloud on any HA `media_player` entity
+- ⚙️ **In-app config panel** — configure everything from Settings → 🏠 tab (no need to edit `.env` manually)
+
+---
+
+## Quick Setup
+
+1. **Generate a Long-Lived Access Token** in Home Assistant:
+   - Open HA → your **Profile** (bottom-left avatar) → **Security** → **Long-Lived Access Tokens** → **Create Token**
+   - Copy the generated token — you won't see it again.
+
+2. **Open EverShelf Settings** → tab **🏠 Home Assistant**.
+
+3. Fill in **Home Assistant URL** (e.g. `http://homeassistant.local:8123`) and paste the token.
+
+4. Click **Test connection** — you should see ✅.
+
+5. Enable the features you want (TTS, Webhooks, REST Sensors) and click **Save HA settings**.
+
+---
+
+## REST Sensors
+
+Add EverShelf pantry data as native HA sensor entities that update automatically.
+
+### Endpoints
+
+| URL | Returns | Sensor |
+|-----|---------|--------|
+| `/api/?action=ha_sensor` | Items expiring soon (≤`HA_EXPIRY_DAYS` days) | `sensor.evershelf_overview` |
+| `/api/?action=ha_sensor&sensor=expired` | Expired items count | `sensor.evershelf_expired` |
+| `/api/?action=ha_sensor&sensor=shopping` | Shopping list item count | `sensor.evershelf_shopping` |
+| `/api/?action=ha_sensor&sensor=total` | Total pantry items | `sensor.evershelf_total` |
+| `/api/?action=ha_sensor&sensor=product` | Full inventory — all items with complete details | `sensor.evershelf_products` |
+| `/api/?action=ha_sensor&sensor=product&id=42` | Full details for inventory row `id=42` | — |
+| `/api/?action=ha_sensor&sensor=product&name=milk` | Full details for items whose name contains "milk" | — |
+| `/api/?action=ha_sensor&sensor=product&location=frigo` | All items in a specific location | — |
+
+### Generate & Copy YAML
+
+In Settings → 🏠 Home Assistant → **REST Sensors** card, click **Copy YAML** to get a ready-to-paste `configuration.yaml` block that already contains your EverShelf URL.
+
+### Manual YAML example
+
+```yaml
+# configuration.yaml
+sensor:
+  - platform: rest
+    name: "EverShelf Overview"
+    unique_id: evershelf_overview
+    resource: "http://YOUR_EVERSHELF_URL/api/?action=ha_sensor"
+    scan_interval: 300        # seconds
+    value_template: "{{ value_json.state }}"
+    json_attributes:
+      - expiring_soon
+      - expiring_3d
+      - expired_items
+      - total_items
+      - shopping_items
+      - expiring_list      # full product details for expiring items
+      - expired_list       # full product details for expired items
+      - low_stock_list     # full product details for items with quantity ≤ 1
+      - next_expiry_name
+      - next_expiry_date
+      - days_to_next_expiry
+      - last_updated
+    unit_of_measurement: "items"
+
+  - platform: rest
+    name: "EverShelf Shopping Count"
+    unique_id: evershelf_shopping
+    resource: "http://YOUR_EVERSHELF_URL/api/?action=ha_sensor&sensor=shopping"
+    scan_interval: 180
+    value_template: "{{ value_json.state }}"
+    unit_of_measurement: "items"
+
+  # Full product inventory — each item includes all details (location, brand, category, …)
+  - platform: rest
+    name: "EverShelf Products"
+    unique_id: evershelf_products
+    resource: "http://YOUR_EVERSHELF_URL/api/?action=ha_sensor&sensor=product"
+    scan_interval: 600
+    value_template: "{{ value_json.state }}"
+    json_attributes:
+      - items
+      - last_updated
+    unit_of_measurement: "items"
+```
+
+Restart Home Assistant after editing `configuration.yaml`.
+
+Every product entry inside `expiring_list`, `expired_list`, `low_stock_list`, and `sensor=product` responses follows the same schema:
+
+```json
+{
+  "product_id":       42,
+  "inventory_id":     7,
+  "name":             "Latte intero",
+  "brand":            "Parmalat",
+  "category":         "Lattiero-caseari",
+  "quantity":         2.0,
+  "unit":             "conf",
+  "default_quantity": 1000.0,
+  "package_unit":     "ml",
+  "location":         "frigo",
+  "expiry_date":      "2025-06-15",
+  "days_remaining":   3,
+  "opened_at":        "2025-06-10",
+  "vacuum_sealed":    false
+}
+```
+
+Field details:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `product_id` | int | Products table ID |
+| `inventory_id` | int | Inventory row ID |
+| `name` | string | Product name |
+| `brand` | string\|null | Brand (if set) |
+| `category` | string\|null | Category (if set) |
+| `quantity` | float | Current quantity in inventory |
+| `unit` | string | Unit (`conf`, `g`, `ml`, `pz`, …) |
+| `default_quantity` | float | Default package size (e.g. 1000 for 1-litre carton) |
+| `package_unit` | string\|null | Unit of the default package (`g`, `ml`) |
+| `location` | string\|null | Storage location (`frigo`, `freezer`, `dispensa`, …) |
+| `expiry_date` | string\|null | ISO date `YYYY-MM-DD` |
+| `days_remaining` | int\|null | Days until expiry (negative = already expired) |
+| `opened_at` | string\|null | ISO date when the package was opened |
+| `vacuum_sealed` | bool | Whether the item is vacuum-sealed |
+
+---
+
+## Webhook Automations
+
+EverShelf fires an HTTP POST to your HA webhook URL when pantry events occur.
+
+### Create the HA Webhook Automation
+
+1. HA → **Settings** → **Automations & Scenes** → **Create Automation**
+2. Click **Add Trigger** → choose **Webhook**
+3. HA generates a **Webhook ID** — copy it
+4. Paste the ID into **Settings → 🏠 Home Assistant → Webhook ID**
+5. Select which events should trigger the webhook
+
+### Supported Events
+
+| Event key | When it fires |
+|-----------|--------------|
+| `expiry` | Daily cron — items expiring within `HA_EXPIRY_DAYS` days |
+| `shopping_add` | Item added to the shopping list |
+| `stock_update` | Inventory quantity changed |
+| `barcode_scan` | (reserved for future use) |
+
+### Webhook Payload (POST body)
+
+```json
+{
+  "event": "expiry_alert",
+  "timestamp": "2025-06-12T08:00:00+00:00",
+  "data": {
+    "type": "expiring_soon",
+    "count": 3,
+    "days": 3,
+    "summary": "Milk, Yogurt, Butter",
+    "items": [
+      {
+        "product_id": 42,
+        "inventory_id": 7,
+        "name": "Milk",
+        "brand": "Parmalat",
+        "category": "Dairy",
+        "quantity": 2.0,
+        "unit": "conf",
+        "default_quantity": 1000.0,
+        "package_unit": "ml",
+        "location": "frigo",
+        "expiry_date": "2025-06-14",
+        "days_remaining": 2,
+        "opened_at": "2025-06-10",
+        "vacuum_sealed": false
+      }
+    ]
+  }
+}
+```
+
+### Example: Expiry Alert → Telegram
+
+```yaml
+alias: EverShelf Expiry Alert
+trigger:
+  - platform: webhook
+    webhook_id: "evershelf_webhook_abc123"   # ← your Webhook ID
+action:
+  - service: notify.telegram_bot
+    data:
+      message: >
+        🥫 EverShelf: {{ trigger.json.data.count }} product(s) expiring soon
+        {% for item in trigger.json.data.items %}
+        — {{ item.name }}{% if item.brand %} ({{ item.brand }}){% endif %} ·
+          {{ item.quantity }} {{ item.unit }} · 📍 {{ item.location }} ·
+          expires {{ item.expiry_date }} ({{ item.days_remaining }} days)
+        {% endfor %}
+```
+
+### Example: Automation on location
+
+You can filter by location in the automation template to only alert for fridge items:
+
+```yaml
+condition:
+  - condition: template
+    value_template: >
+      {{ trigger.json.data.items | selectattr('location','eq','frigo') | list | length > 0 }}
+```
+
+---
+
+## Push Notifications
+
+If you prefer to receive push alerts without using webhooks, configure a **HA notify service** directly:
+
+1. Find your notify service name in HA: **Developer Tools → Services** → search `notify`
+2. Paste it into **Settings → 🏠 → Notify service** (e.g. `notify.mobile_app_my_phone`)
+3. Save
+
+EverShelf will call this service from the cron job whenever expiry alerts fire.
+
+---
+
+## TTS on Smart Speakers
+
+Read recipe steps aloud on an Amazon Echo, Google Home, Sonos, or any HA `media_player`.
+
+### Configuration
+
+1. Enter the **Entity ID** of your media player (e.g. `media_player.kitchen_display`)
+   - Find it in HA: **Developer Tools → States**
+2. Click **Apply HA preset to TTS tab** — this auto-fills the TTS tab with the correct HA endpoint and auth headers
+3. Save settings
+
+### How it Works
+
+When recipe step TTS is triggered, EverShelf calls:
+
+```
+POST /api/services/tts/speak
+Authorization: Bearer <HA_TOKEN>
+{
+  "entity_id": "media_player.kitchen_display",
+  "message": "Add 200 g of flour and mix well."
+}
+```
+
+The request is proxied through the EverShelf PHP backend (avoids CORS / mixed-content issues).
+
+---
+
+## Environment Variables Reference
+
+All settings are configurable from `.env` or from the in-app Settings panel.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `HA_ENABLED` | `false` | Master switch for all HA features |
+| `HA_URL` | _(empty)_ | Base URL of HA instance, no trailing slash |
+| `HA_TOKEN` | _(empty)_ | Long-Lived Access Token |
+| `HA_TTS_ENTITY` | _(empty)_ | `media_player` entity for TTS |
+| `HA_WEBHOOK_ID` | _(empty)_ | Webhook trigger ID from HA automation |
+| `HA_WEBHOOK_EVENTS` | `expiry,shopping_add,stock_update` | Comma-separated list of events |
+| `HA_NOTIFY_SERVICE` | _(empty)_ | HA notify service (e.g. `notify.mobile_app_phone`) |
+| `HA_EXPIRY_DAYS` | `3` | Days before expiry to trigger the daily alert |
+
+---
+
+## Troubleshooting
+
+**Test shows ❌ "Connection failed"**
+- Verify the URL is reachable from the EverShelf server (not just your browser)
+- If using HTTPS with a self-signed certificate, the server-side cURL request may fail — use HTTP on the local network instead
+- Check that port 8123 (or your custom port) is open on the HA host
+
+**Test shows ❌ "bad_token"**
+- The Long-Lived Access Token may have expired or been revoked — generate a new one in HA Profile
+
+**Webhook not firing**
+- Confirm HA_ENABLED=true and the Webhook ID is exactly as shown in HA
+- Check the EverShelf cron is running (`/api/cron_smart_shopping.php` every 5 minutes)
+- For shopping/stock events: verify the event name is in `HA_WEBHOOK_EVENTS`
+
+**TTS not speaking**
+- Ensure the media player entity is online in HA (check its state in Developer Tools)
+- Try the "Apply HA preset to TTS tab" button and send a test from the TTS tab
+- Check HA logs for `tts.speak` errors (some platforms require `tts_options`)
+
+**Sensors show unavailable in HA**
+- The EverShelf URL must be reachable from the HA host
+- If running EverShelf behind a reverse proxy, ensure `/api/` is accessible
+- Use `scan_interval` ≥ 60 to avoid hammering the server
@@ -18,7 +18,9 @@ import android.os.Bundle
 import android.os.Handler
 import android.os.Looper
 import android.provider.Settings
+import android.media.AudioManager
 import android.speech.tts.TextToSpeech
+import android.speech.tts.UtteranceProgressListener
 import android.view.View
 import android.view.WindowInsets
 import android.view.WindowInsetsController
@@ -144,6 +146,25 @@ class KioskActivity : AppCompatActivity() {
                if (res == TextToSpeech.LANG_MISSING_DATA || res == TextToSpeech.LANG_NOT_SUPPORTED) {
                    tts?.language = Locale.getDefault()
                }
+                tts?.setOnUtteranceProgressListener(object : UtteranceProgressListener() {
+                    override fun onStart(utteranceId: String?) {}
+                    override fun onDone(utteranceId: String?) {
+                        runOnUiThread {
+                            webView.evaluateJavascript("if(window._kioskTtsDone)window._kioskTtsDone('$utteranceId')", null)
+                        }
+                    }
+                    @Deprecated("Deprecated in API 21")
+                    override fun onError(utteranceId: String?) {
+                        runOnUiThread {
+                            webView.evaluateJavascript("if(window._kioskTtsError)window._kioskTtsError('$utteranceId','error')", null)
+                        }
+                    }
+                    override fun onError(utteranceId: String?, errorCode: Int) {
+                        runOnUiThread {
+                            webView.evaluateJavascript("if(window._kioskTtsError)window._kioskTtsError('$utteranceId',$errorCode)", null)
+                        }
+                    }
+                })
                ttsReady = true
            }
        }
@@ -466,7 +487,10 @@ class KioskActivity : AppCompatActivity() {
                if (!ttsReady) return
                engine.setSpeechRate(rate.coerceIn(0.1f, 4f))
                engine.setPitch(pitch.coerceIn(0.1f, 4f))
-                engine.speak(text, android.speech.tts.TextToSpeech.QUEUE_FLUSH, null, "kiosk_tts")
+                val params = Bundle().apply {
+                    putInt(TextToSpeech.Engine.KEY_PARAM_STREAM, AudioManager.STREAM_MUSIC)
+                }
+                engine.speak(text, TextToSpeech.QUEUE_FLUSH, params, "kiosk_tts")
            }
            @JavascriptInterface
            fun stopSpeech() { tts?.stop() }
@@ -123,6 +123,9 @@ class SettingsActivity : AppCompatActivity() {
        // Back
        findViewById<android.widget.ImageButton>(R.id.btnBack).setOnClickListener { finish() }

+        // Advanced settings → back to webapp (where HA, Gemini, Bring! etc. are configured)
+        findViewById<MaterialButton>(R.id.btnOpenAppSettings).setOnClickListener { finish() }
+
        // Test connection
        findViewById<MaterialButton>(R.id.btnTestConnection).setOnClickListener { testConnection() }

@@ -400,6 +400,7 @@ class SetupActivity : AppCompatActivity() {
            scaleTestCard.visibility   = View.GONE
            testWeightBox.visibility   = View.GONE
            bleSetupCard.visibility    = View.VISIBLE
+            step3NextButtons.visibility = View.VISIBLE   // restore nav buttons (back/next)
            tvSelectedScale.text       = ""
            tvSelectedScale.visibility = View.GONE
            tvScanStatus.text          = getString(R.string.ble_not_confirmed)
@@ -960,6 +961,8 @@ class SetupActivity : AppCompatActivity() {
            testWeightBox.visibility = View.GONE
            testHasWeight = false
            findViewById<MaterialButton>(R.id.btnTestConfirm).isEnabled = false
+            // Always re-enable retry so the user is never stuck
+            findViewById<MaterialButton>(R.id.btnTestRetry).isEnabled = true
        }
        override fun onWeightReceived(reading: WeightReading) {
            if (!isInTestMode) return
@@ -224,6 +224,43 @@
            </LinearLayout>
        </LinearLayout>

+        <!-- Advanced / App Settings link -->
+        <TextView
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:text="IMPOSTAZIONI AVANZATE"
+            android:textColor="#7c3aed"
+            android:textSize="12sp"
+            android:textStyle="bold"
+            android:letterSpacing="0.1"
+            android:layout_marginBottom="12dp" />
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:orientation="vertical"
+            android:background="@drawable/card_background"
+            android:padding="16dp"
+            android:layout_marginBottom="24dp">
+
+            <TextView
+                android:layout_width="match_parent"
+                android:layout_height="wrap_content"
+                android:text="Home Assistant, Gemini AI, Bring!, TTS, notifiche e tutte le altre funzionalità si configurano direttamente nell'app EverShelf."
+                android:textColor="#94a3b8"
+                android:textSize="13sp"
+                android:layout_marginBottom="12dp" />
+
+            <com.google.android.material.button.MaterialButton
+                android:id="@+id/btnOpenAppSettings"
+                android:layout_width="match_parent"
+                android:layout_height="44dp"
+                android:text="← Torna all'app per le impostazioni avanzate"
+                android:textSize="13sp"
+                android:textAllCaps="false"
+                android:backgroundTint="#7c3aed" />
+        </LinearLayout>
+
        <!-- Danger Zone -->
        <TextView
            android:layout_width="match_parent"
@@ -64,7 +64,7 @@
        <div id="preloader-warnings" class="preloader-warnings" style="display:none"></div>
        <div id="preloader-error-msg" class="preloader-error-msg" style="display:none"></div>
        <button id="preloader-retry-btn" class="preloader-retry-btn" style="display:none" onclick="_startupRetry()">🔄 <span data-i18n="startup.retry">Riprova</span></button>
-        <span class="app-preloader-version" id="preloader-version">v1.7.23</span>
+        <span class="app-preloader-version" id="preloader-version">v1.7.25</span>
    </div>
 </div>

@@ -77,7 +77,7 @@
        <!-- Title — left-aligned; grows to fill space -->
        <div class="header-title-wrap">
            <h1 class="header-title" onclick="showPage('dashboard')">
-                <img src="assets/img/logo/logo_icon.png" alt="" class="header-logo-icon" aria-hidden="true" /><span data-i18n="nav.title">EverShelf</span><span class="header-version">v1.7.23</span>
+                <img src="assets/img/logo/logo_icon.png" alt="" class="header-logo-icon" aria-hidden="true" /><span data-i18n="nav.title">EverShelf</span><span class="header-version">v1.7.25</span>
            </h1>
            <!-- Update badge — shown alongside title, never replaces it -->
            <span class="header-update-badge" id="header-update-badge" style="display:none"></span>
@@ -169,10 +169,12 @@
            <div id="expired-list"></div>
        </div>

-        <!-- Anti-Waste Report Card + Nutrition Analysis (alternating, content rendered by JS) -->
+        <!-- Anti-Waste Report Card + Nutrition Analysis + Monthly Stats (alternating, content rendered by JS) -->
        <div id="dashboard-insight-wrap" style="position:relative">
            <div id="waste-chart-section" style="display:none"></div>
            <div id="nutrition-section" style="display:none"></div>
+            <div id="monthly-stats-section" style="display:none"></div>
+            <div id="macros-section" style="display:none"></div>
        </div>

        <!-- Alert for soonest expiring items -->
@@ -249,6 +251,11 @@
                </div>
                <!-- Live partial code preview -->
                <div class="scan-live-code" id="scan-live-code" style="display:none"></div>
+                <!-- Scan status bar -->
+                <div class="scan-status-bar" id="scan-status-bar">
+                    <span id="scan-status-method" class="scan-status-method"></span>
+                    <span id="scan-status-msg" class="scan-status-msg" data-i18n="scan.status_ready"></span>
+                </div>
                <!-- Success flash overlay -->
                <div class="scan-confirm-overlay" id="scan-confirm-overlay" style="display:none">
                    <div class="scan-confirm-check">✓</div>
@@ -331,8 +338,9 @@
        </div>
        <!-- Banner: shopping list scan context -->
        <div id="shopping-scan-target-banner" class="shopping-scan-target-banner" style="display:none"></div>
-        <div class="product-preview product-preview-large" id="action-product-preview"></div>
+        <div class="product-preview product-preview-small" id="action-product-preview"></div>
        <div class="inventory-status-bar" id="action-inventory-status" style="display:none"></div>
+        <div id="action-related-stock" style="display:none"></div>
        <div class="action-buttons" id="action-buttons-container">
            <button class="btn btn-huge btn-success" onclick="showAddForm()">
                <span class="btn-icon">📥</span>
@@ -671,7 +679,7 @@
            <h2 data-i18n="recipes.title">🍳 Ricette</h2>
        </div>
        <div class="recipe-page-container">
-            <button class="btn btn-large btn-success full-width" onclick="openRecipeDialog()" data-i18n="recipes.generate">
+            <button class="btn btn-large btn-success full-width recipe-generate-btn" onclick="openRecipeDialog()" data-i18n="recipes.generate">
                ✨ Genera nuova ricetta
            </button>
            <div id="recipe-archive" class="recipe-archive"></div>
@@ -840,6 +848,7 @@
            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-camera')" data-tab="tab-camera" title="Fotocamera">📷</button>
            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-security')" data-tab="tab-security" title="Sicurezza">🔒</button>
            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-tts')" data-tab="tab-tts" title="Voce (TTS)" data-i18n-title="settings.tab_tts">🔊</button>
+            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-ha'); _loadHaTab();" data-tab="tab-ha" title="Home Assistant" data-i18n-title="settings.ha.tab">🏠</button>
            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-scale')" data-tab="tab-scale" title="Bilancia Smart" data-i18n-title="settings.scale.tab">⚖️</button>
            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-backup'); _loadBackupTab();" data-tab="tab-backup" data-i18n-title="settings.backup.tab" title="Backup">💾</button>
            <button class="settings-tab" onclick="switchSettingsTab(this, 'tab-info'); _loadInfoTab();" data-tab="tab-info" data-i18n-title="settings.info.tab" title="Info">ℹ️</button>
@@ -1312,10 +1321,127 @@
                    </div>
                    </div><!-- /tts-server-section -->

+                    <button class="btn btn-large btn-secondary full-width mt-2" onclick="testSound()" data-i18n="settings.tts.test_sound_btn">🔔 Esegui Test Suono</button>
                    <button class="btn btn-large btn-accent full-width mt-2" onclick="testTTS()" data-i18n="settings.tts.test_btn">🔊 Invia Test Vocale</button>
                    <div id="tts-test-status" style="display:none;margin-top:8px"></div>
+                    <!-- HA TTS quick-fill hint -->
+                    <div style="margin-top:12px;padding:10px 12px;background:rgba(3,169,244,0.07);border:1px solid rgba(3,169,244,0.25);border-radius:8px;font-size:0.82rem">
+                        <span data-i18n="settings.ha.ha_hint">🏠 Se usi Home Assistant, usa il tab <strong>Home Assistant</strong> per configurare TTS, webhook e sensori.</span>
                    </div>
                </div>
+            </div>
+            <!-- Home Assistant Tab -->
+            <div class="settings-panel" id="tab-ha">
+                <!-- Connection card -->
+                <div class="settings-card">
+                    <h4 data-i18n="settings.ha.title">🏠 Home Assistant</h4>
+                    <p class="settings-hint" data-i18n="settings.ha.hint">Integra EverShelf con Home Assistant: TTS su speaker smart, webhook per automazioni, sensori per la dashboard.</p>
+
+                    <div class="form-group" style="margin-bottom:10px">
+                        <label class="toggle-row">
+                            <span data-i18n="settings.ha.enabled">✅ Abilita integrazione Home Assistant</span>
+                            <span class="toggle-switch">
+                                <input type="checkbox" id="setting-ha-enabled" onchange="onHaEnabledChange()">
+                                <span class="toggle-slider"></span>
+                            </span>
+                        </label>
+                    </div>
+
+                    <div id="ha-config-section">
+                        <div class="form-group">
+                            <label data-i18n="settings.ha.url_label">🌐 Home Assistant URL</label>
+                            <input type="url" id="setting-ha-url" class="form-input" placeholder="http://192.168.1.50:8123">
+                            <p class="settings-hint" data-i18n="settings.ha.url_hint">URL base della tua istanza HA (senza slash finale). Es: <code>http://homeassistant.local:8123</code></p>
+                        </div>
+                        <div class="form-group">
+                            <label data-i18n="settings.ha.token_label">🔑 Long-Lived Access Token</label>
+                            <div style="display:flex;gap:8px;align-items:center">
+                                <input type="password" id="setting-ha-token" class="form-input" style="flex:1" placeholder="eyJhbGci...">
+                                <button class="btn btn-secondary" style="flex-shrink:0" onclick="togglePasswordVisibility('setting-ha-token')" data-i18n="btn.toggle_password">👁️</button>
+                            </div>
+                            <p class="settings-hint" data-i18n="settings.ha.token_hint">Genera un token in HA → Profilo → Token di accesso a lungo termine.</p>
+                        </div>
+                        <button class="btn btn-secondary full-width" onclick="testHaConnection()" data-i18n="settings.ha.test_btn">🔗 Testa connessione HA</button>
+                        <div id="ha-test-status" style="display:none;margin-top:8px" class="settings-status"></div>
+                    </div>
+                </div>
+
+                <!-- TTS via HA card -->
+                <div class="settings-card">
+                    <h4 data-i18n="settings.ha.tts_title">🔊 TTS su Speaker Smart</h4>
+                    <p class="settings-hint" data-i18n="settings.ha.tts_hint">Leggi i passi della ricetta su un altoparlante gestito da HA (Sonos, Echo, Google Home, ecc.).</p>
+
+                    <div class="form-group">
+                        <label data-i18n="settings.ha.tts_entity_label">🔈 Entity ID del media player</label>
+                        <input type="text" id="setting-ha-tts-entity" class="form-input" placeholder="media_player.living_room">
+                        <p class="settings-hint" data-i18n="settings.ha.tts_entity_hint">Copia l'entity ID del media player da HA → Strumenti sviluppatore → Stati.</p>
+                    </div>
+                    <div class="form-group">
+                        <label data-i18n="settings.ha.tts_platform_label">🎙️ Piattaforma TTS</label>
+                        <select id="setting-ha-tts-platform" class="form-input">
+                            <option value="tts.speak" data-i18n="settings.ha.tts_platform_speak">tts.speak (raccomandato)</option>
+                            <option value="notify" data-i18n="settings.ha.tts_platform_notify">notify.* (servizio notifiche)</option>
+                        </select>
+                    </div>
+                    <button class="btn btn-secondary full-width" onclick="applyHaTtsPreset()" data-i18n="settings.ha.tts_apply_btn">✅ Applica preset HA al TTS</button>
+                    <p class="settings-hint mt-2" data-i18n="settings.ha.tts_apply_hint">Configura automaticamente il tab TTS con i parametri HA corretti.</p>
+                </div>
+
+                <!-- Webhook card -->
+                <div class="settings-card">
+                    <h4 data-i18n="settings.ha.webhook_title">⚡ Automazioni Webhook</h4>
+                    <p class="settings-hint" data-i18n="settings.ha.webhook_hint">EverShelf chiama il webhook HA quando si verificano eventi (prodotto in scadenza, aggiunto alla lista, ecc.).</p>
+
+                    <div class="form-group">
+                        <label data-i18n="settings.ha.webhook_id_label">🔗 Webhook ID</label>
+                        <input type="text" id="setting-ha-webhook-id" class="form-input" placeholder="evershelf_events">
+                        <p class="settings-hint" data-i18n="settings.ha.webhook_id_hint">Crea un'automazione in HA con trigger "Webhook" e copia qui l'ID. <a href="#" onclick="showHaWebhookHelp();return false" style="color:var(--accent)">Come farlo?</a></p>
+                    </div>
+                    <div class="form-group">
+                        <label data-i18n="settings.ha.webhook_events_label">📋 Eventi da notificare</label>
+                        <div style="display:flex;flex-direction:column;gap:6px;margin-top:4px">
+                            <label style="display:flex;align-items:center;gap:8px;font-weight:normal">
+                                <input type="checkbox" id="ha-event-expiry" value="expiry"> <span data-i18n="settings.ha.event_expiry">Prodotti in scadenza (cron giornaliero)</span>
+                            </label>
+                            <label style="display:flex;align-items:center;gap:8px;font-weight:normal">
+                                <input type="checkbox" id="ha-event-shopping" value="shopping_add"> <span data-i18n="settings.ha.event_shopping">Aggiunta alla lista della spesa</span>
+                            </label>
+                            <label style="display:flex;align-items:center;gap:8px;font-weight:normal">
+                                <input type="checkbox" id="ha-event-stock" value="stock_update"> <span data-i18n="settings.ha.event_stock">Aggiornamento scorte (quantità modificata)</span>
+                            </label>
+                        </div>
+                    </div>
+                    <div class="form-group">
+                        <label data-i18n="settings.ha.expiry_days_label">📅 Giorni anticipo per scadenze</label>
+                        <input type="number" id="setting-ha-expiry-days" class="form-input" min="1" max="30" value="3">
+                        <p class="settings-hint" data-i18n="settings.ha.expiry_days_hint">Quanti giorni prima della scadenza inviare l'alert.</p>
+                    </div>
+                </div>
+
+                <!-- Notify service card -->
+                <div class="settings-card">
+                    <h4 data-i18n="settings.ha.notify_title">📱 Notifiche Push</h4>
+                    <p class="settings-hint" data-i18n="settings.ha.notify_hint">EverShelf invia notifiche push tramite il servizio <code>notify.*</code> di HA (Telegram, Pushover, app mobile, ecc.).</p>
+
+                    <div class="form-group">
+                        <label data-i18n="settings.ha.notify_service_label">📣 Servizio notify</label>
+                        <input type="text" id="setting-ha-notify-service" class="form-input" placeholder="notify.mobile_app_mio_telefono">
+                        <p class="settings-hint" data-i18n="settings.ha.notify_service_hint">Formato: <code>notify.NOME_SERVIZIO</code>. Lascia vuoto per disabilitare. Richiede token HA configurato.</p>
+                    </div>
+                </div>
+
+                <!-- Sensor card (read-only info) -->
+                <div class="settings-card">
+                    <h4 data-i18n="settings.ha.sensor_title">📊 Sensori REST per HA</h4>
+                    <p class="settings-hint" data-i18n="settings.ha.sensor_hint">HA può leggere i dati dell'inventario via REST polling. Aggiungi questo snippet a <code>configuration.yaml</code>:</p>
+                    <div id="ha-sensor-yaml" style="background:var(--bg-secondary,#f1f5f9);border-radius:8px;padding:12px;font-family:monospace;font-size:0.75rem;white-space:pre;overflow-x:auto;max-height:220px;overflow-y:auto;border:1px solid var(--border,#e2e8f0)"></div>
+                    <button class="btn btn-secondary full-width mt-2" onclick="copyHaSensorYaml()" data-i18n="settings.ha.sensor_copy_btn">📋 Copia YAML</button>
+                </div>
+
+                <!-- Save button -->
+                <button class="btn btn-large btn-accent full-width" onclick="saveHaSettings()" data-i18n="settings.ha.save_btn">💾 Salva impostazioni HA</button>
+                <div id="ha-save-status" style="display:none;margin-top:8px" class="settings-status"></div>
+            </div>
            <!-- Scale Tab -->
            <div class="settings-panel" id="tab-scale">
                <div class="settings-card">
@@ -1698,9 +1824,15 @@
        </div>
        <div id="recipe-result" style="display:none" class="recipe-result">
            <div id="recipe-content"></div>
-            <button class="btn btn-large btn-secondary full-width mt-2" onclick="regenerateRecipe()" data-i18n="recipes.regenerate">
+            <button id="recipe-regen-btn" class="btn btn-large btn-secondary full-width mt-2" onclick="showRegenChoice()" data-i18n="recipes.regenerate">
                🔄 Generane un'altra
            </button>
+            <div id="recipe-regen-choice" style="display:none" class="recipe-regen-choice">
+                <p class="recipe-regen-choice-title" data-i18n="recipes.regen_choice_title">Cosa vuoi fare con questa ricetta?</p>
+                <button class="btn btn-large btn-warning full-width" onclick="doRegenerateReplace()" data-i18n="recipes.regen_replace">🔄 Genera un'altra (scarta questa)</button>
+                <button class="btn btn-large btn-success full-width mt-2" onclick="doRegenerateSave()" data-i18n="recipes.regen_save_new">💾 Salva nell'archivio e genera nuova</button>
+                <button class="btn btn-large btn-ghost full-width mt-2" onclick="cancelRegenChoice()" data-i18n="action.cancel">Annulla</button>
+            </div>
            <button class="btn btn-large btn-primary full-width mt-2" onclick="closeRecipeDialog()" data-i18n="recipes.close_btn">
                ✅ Chiudi
            </button>
@@ -1757,6 +1889,17 @@
    </div>
 </div>

+<!-- ===== NETWORK ERROR OVERLAY ===== -->
+<div id="network-error-overlay" style="display:none" aria-live="assertive" role="alert">
+    <div class="net-error-body">
+        <div class="net-error-icon" id="net-error-icon">📡</div>
+        <div class="net-error-title" id="net-error-title" data-i18n="error.offline_title">Nessuna connessione</div>
+        <div class="net-error-subtitle" id="net-error-subtitle" data-i18n="error.offline_subtitle">L'app non riesce a raggiungere il server. Verifica la connessione Wi-Fi.</div>
+        <div class="net-error-status" id="net-error-status"></div>
+        <button class="net-error-continue-btn" id="net-error-continue-btn" onclick="_enterOfflineMode()" data-i18n="error.offline_continue" style="display:none">Continua in modalità offline</button>
+    </div>
+</div>
+
 <!-- ===== COOKING MODE OVERLAY ===== -->
 <div id="cooking-overlay" class="cooking-overlay" style="display:none" aria-live="polite">
    <div id="cooking-flash-overlay" class="cooking-flash-overlay"></div>
@@ -2,7 +2,7 @@
    "name": "EverShelf",
    "short_name": "EverShelf",
    "description": "Gestione completa della dispensa di casa con scansione barcode",
-    "version": "1.7.24",
+    "version": "1.7.25",
    "start_url": "/evershelf/",
    "display": "standalone",
    "background_color": "#f0f4e8",
@@ -213,7 +213,14 @@
        "barcode_acquired": "🔖 Barcode gescannt: {code}",
        "scan_barcode": "🔖 Barcode scannen",
        "create_named": "{name} erstellen",
-    "new_without_barcode": "Neues Produkt ohne Barcode"
+        "new_without_barcode": "Neues Produkt ohne Barcode",
+        "stock_in_pantry": "Bereits im Vorrat:",
+        "status_ready": "Kamera auf Barcode richten",
+        "status_scanning": "Scanne...",
+        "status_partial": "Erkannt: {code} — prüfe...",
+        "status_invalid": "Ungültig: {code} — versuche erneut",
+        "status_confirmed": "Bestätigt!",
+        "status_parallel": "Kombinierter Scan aktiv..."
    },
    "action": {
        "title": "Was möchtest du tun?",
@@ -227,7 +234,8 @@
        "throw_btn": "🗑️ ENTSORGEN",
        "throw_sub": "wegwerfen",
        "edit_sub": "Ablauf, Ort…",
-    "create_recipe_btn": "Rezept"
+        "create_recipe_btn": "Rezept",
+        "related_stock_title": "Auch zuhause"
    },
    "add": {
        "title": "Zum Vorrat hinzufügen",
@@ -359,12 +367,16 @@
        "loading_msg": "Rezept wird vorbereitet...",
        "start_cooking": "👨‍🍳 Kochmodus",
        "regenerate": "🔄 Noch eins generieren",
+        "regen_choice_title": "Was möchtest du mit diesem Rezept machen?",
+        "regen_replace": "🔄 Neues generieren (dieses verwerfen)",
+        "regen_save_new": "💾 Im Archiv speichern & neues generieren",
        "close_btn": "✅ Schließen",
        "ingredients_title": "🧾 Zutaten",
        "tools_title": "Benötigte Geräte",
        "steps_title": "👨‍🍳 Zubereitung",
        "no_steps": "Keine Zubereitungsschritte verfügbar",
        "generate_error": "Fehler bei der Generierung",
+        "stream_interrupted": "Generierung unterbrochen (unvollstaendige Antwort vom Server). Protokolle pruefen oder erneut versuchen.",
        "persons_short": "Pers.",
        "use_ingredient_title": "Zutat verwenden",
        "recipe_qty_label": "Rezept",
@@ -378,7 +390,10 @@
        "scale_wait_stable": "10s stabiles Gewicht für Auto-Ausfüllen abwarten…",
        "ingredient_scaled_toast": "📦 Zutat vom Vorrat abgezogen!",
        "finished_added_bring_toast": "🛒 Produkt aufgebraucht → zu Bring! hinzugefügt!",
-    "load_error": "Fehler beim Laden"
+        "load_error": "Fehler beim Laden",
+        "favorite": "Zu Favoriten hinzufügen",
+        "unfavorite": "Aus Favoriten entfernen",
+        "adjust_persons": "Personen"
    },
    "shopping": {
        "title": "🛒 Einkaufsliste",
@@ -473,7 +488,8 @@
        "priority_medium": "Mittel",
        "priority_low": "Niedrig",
        "smart_last_update": "Aktualisiert {time}",
-    "names_already_updated": "Alle Namen sind bereits aktuell"
+        "names_already_updated": "Alle Namen sind bereits aktuell",
+        "pantry_hint": "Bereits zuhause: {qty}"
    },
    "ai": {
        "title": "🤖 KI-Identifikation",
@@ -686,6 +702,7 @@
            "extra_fields_label": "➕ Zusätzliche Felder (JSON)",
            "extra_fields_placeholder": "{\"entity_id\": \"media_player.living_room\"}",
            "extra_fields_hint": "Zusätzliche Felder im Payload, im JSON-Format. Leer lassen wenn nicht benötigt.",
+            "test_sound_btn": "🔔 Klangtest ausführen",
            "test_btn": "🔊 Testansage senden",
            "voices_loading": "Stimmen werden geladen…",
            "voice_not_supported": "Stimme vom Browser nicht unterstützt",
@@ -693,7 +710,12 @@
            "voices_hint": "Verfügbare Stimmen hängen vom Betriebssystem und Browser ab. Auf macOS/iOS ist die Stimme Paola (Italienisch) verfügbar. Drücken Sie ↺ wenn die Liste nicht lädt.",
            "url_missing": "⚠️ Endpunkt-URL fehlt.",
            "test_sending": "⏳ Wird gesendet…",
-      "test_ok": "✅ Antwort {code} — prüfe ob der Lautsprecher gesprochen hat."
+            "test_ok": "✅ Antwort {code} — prüfe ob der Lautsprecher gesprochen hat.",
+            "heard_question": "Hast du die Stimme gehört?",
+            "heard_yes": "Ja, ich habe es gehört",
+            "heard_no": "Nein, ich habe nichts gehört",
+            "test_ok_kiosk": "TTS funktioniert.",
+            "test_fail_steps": "Prüfe: 1) Medienvolume ist nicht 0; 2) Google Text-to-Speech installiert und aktualisiert; 3) Deutsches Sprachpaket in den Android TTS-Einstellungen heruntergeladen."
        },
        "language": {
            "title": "🌐 Sprache",
@@ -864,6 +886,60 @@
            "forecast_label": "Prognose für bald leere Produkte",
            "auto_add_label": "Automatisch hinzufügen wenn",
            "auto_add_suffix": "im Lager verbleibend (0 = nur wenn leer)"
+        },
+        "ha": {
+            "tab": "Home Assistant",
+            "title": "Home Assistant",
+            "hint": "Verbinde EverShelf mit Home Assistant für Automationen, Push-Benachrichtigungen und REST-Sensoren.",
+            "enabled": "Home Assistant-Integration aktivieren",
+            "connection_title": "Verbindung",
+            "url_label": "Home Assistant URL",
+            "url_placeholder": "http://192.168.1.50:8123",
+            "url_hint": "Basis-URL deiner Home Assistant-Instanz (z.B. http://homeassistant.local:8123).",
+            "token_label": "Long-Lived Access Token",
+            "token_hint": "Erstelle unter HA-Profil → Sicherheit → Langlebige Zugangstoken.",
+            "token_placeholder": "eyJhbGci...",
+            "token_saved": "Token gespeichert (aus Sicherheitsgründen verborgen)",
+            "test_btn": "Verbindung testen",
+            "test_ok": "Verbunden mit {version}",
+            "test_fail": "Verbindung fehlgeschlagen: {error}",
+            "test_bad_token": "HA erreichbar, aber Token ist ungültig",
+            "testing": "Teste…",
+            "error_no_url": "Bitte zuerst die Home Assistant URL eingeben.",
+            "tts_title": "TTS auf Smart Speaker",
+            "tts_hint": "Rezeptschritte auf einem Home Assistant Media Player vorlesen.",
+            "tts_entity_label": "Media Player Entity ID",
+            "tts_entity_placeholder": "media_player.wohnzimmer",
+            "tts_entity_hint": "Entity-ID des HA-Media-Players. Zu finden unter HA: Entwicklertools → Zustände.",
+            "tts_platform_label": "TTS-Plattform",
+            "tts_platform_speak": "tts.speak (empfohlen)",
+            "tts_platform_notify": "notify.* (Benachrichtigungsdienst)",
+            "tts_apply_btn": "HA-Voreinstellung auf TTS-Tab anwenden",
+            "tts_apply_hint": "Füllt den TTS-Tab mit der Home Assistant URL und dem Token aus.",
+            "tts_preset_applied": "HA-Voreinstellung auf TTS-Tab angewendet.",
+            "webhook_title": "Webhook-Automationen",
+            "webhook_hint": "Sende Daten an Home Assistant, wenn Ereignisse in der Vorratskammer auftreten.",
+            "webhook_id_label": "Webhook-ID",
+            "webhook_id_placeholder": "evershelf_webhook_abc123",
+            "webhook_id_hint": "ID des in HA erstellten Webhooks. Kopiere aus: HA → Einstellungen → Automationen → Erstellen → Webhook-Auslöser.",
+            "webhook_events_label": "Benachrichtige bei diesen Ereignissen",
+            "event_expiry": "Ablaufende Produkte (täglich)",
+            "event_shopping": "Artikel zur Einkaufsliste hinzugefügt",
+            "event_stock": "Lagerbestand aktualisiert",
+            "expiry_days_label": "Ablaufwarnung im Voraus (Tage)",
+            "expiry_days_hint": "Sende die Ablaufwarnung N Tage vor dem Ablaufdatum.",
+            "webhook_help": "In HA: Einstellungen → Automationen → Automation erstellen → Auslöser: Webhook → ID kopieren.",
+            "notify_title": "Push-Benachrichtigungen",
+            "notify_hint": "Sende Push-Benachrichtigungen über einen Home Assistant notify-Dienst.",
+            "notify_service_label": "Notify-Dienst",
+            "notify_service_placeholder": "notify.mobile_app_mein_handy",
+            "notify_service_hint": "Name des HA-notify-Dienstes (z.B. notify.mobile_app_phone). Leer lassen zum Deaktivieren.",
+            "sensor_title": "REST-Sensoren",
+            "sensor_hint": "Zur configuration.yaml hinzufügen, um EverShelf-Sensoren in Home Assistant zu erstellen.",
+            "sensor_copy_btn": "YAML kopieren",
+            "sensor_copied": "YAML in die Zwischenablage kopiert!",
+            "save_btn": "HA-Einstellungen speichern",
+            "ha_hint": "Wenn du Home Assistant verwendest, nutze den Home Assistant-Tab für TTS, Webhooks und Sensoren."
        }
    },
    "expiry": {
@@ -998,13 +1074,25 @@
        "server_retry": "Erneut versuchen",
        "unknown": "Unbekannter Fehler",
        "prefix": "Fehler",
-    "no_inventory_entry": "Kein Inventareintrag gefunden"
+        "no_inventory_entry": "Kein Inventareintrag gefunden",
+        "offline_title": "Keine Verbindung",
+        "offline_subtitle": "Die App kann den Server nicht erreichen. Überprüfe deine WLAN-Verbindung.",
+        "offline_checking": "Verbindung prüfen…",
+        "offline_restored": "Verbindung wiederhergestellt!",
+        "offline_continue": "Im Offline-Modus fortfahren",
+        "offline_reading_cache": "Lese aus lokalem Cache",
+        "offline_ops_pending": "{n} Aktionen ausstehend",
+        "offline_synced": "{n} Aktionen synchronisiert",
+        "offline_ai_disabled": "Offline nicht verfügbar",
+        "offline_cache_ready": "Offline — {n} Produkte im Cache"
    },
+    "confirm_placeholder_search": null,
    "confirm": {
        "remove_item": "Möchtest du dieses Produkt wirklich aus dem Bestand entfernen?",
        "kiosk_exit": "Kioskmodus verlassen?",
        "cancel": "Abbrechen",
-    "proceed": "Bestätigen"
+        "proceed": "Bestätigen",
+        "discard_one": "1 Stück wegwerfen"
    },
    "location": {
        "dispensa": "Vorratskammer",
@@ -1016,7 +1104,8 @@
        "unknown_hint": "Produktname und Informationen eingeben",
        "label_name": "🏷️ Produktname",
        "choose_location_title": "Welchen Ort?",
-    "choose_location_hint": "Wähle den zu bearbeitenden Ort:"
+        "choose_location_hint": "Wähle den zu bearbeitenden Ort:",
+        "confirm_large_qty": "Du setzt die Menge auf {qty} {unit}. Das scheint ungewöhnlich hoch zu sein. Bestätigen?"
    },
    "screensaver": {
        "recipe_btn": "Rezepte",
@@ -1170,7 +1259,13 @@
        "source": "Basierend auf {n} Produkten in deiner Vorratskammer · EverShelf",
        "products_count": "Produkte",
        "today_title": "🥗 Deine Vorratskammer heute",
-    "products_n": "{n} Produkte"
+        "products_n": "{n} Produkte",
+        "macros_title": "Geschätzte Makronährstoffe",
+        "macros_proteins": "Proteine",
+        "macros_carbs": "Kohlenhydrate",
+        "macros_fat": "Fett",
+        "macros_fiber": "Ballaststoffe",
+        "macros_source": "Schätzung basierend auf {n} Vorratsprodukten"
    },
    "facts": {
        "greeting_morning": "Guten Morgen",
@@ -1344,6 +1439,20 @@
        "critical_error_intro": "Die App kann aufgrund folgender Probleme nicht gestartet werden:",
        "error_network": "Server nicht erreichbar.",
        "error_network_detail": "Der Browser kann den PHP-Server nicht erreichen.\n\nMögliche Ursachen:\n• Apache/PHP-Server läuft nicht\n• Netzwerk- oder Firewall-Problem\n• Falsche App-URL\n\nBitte Server starten und erneut versuchen.",
-    "retry": "Erneut versuchen"
+        "retry": "Erneut versuchen",
+        "syncing_local": "Lokale Daten synchronisieren...",
+        "sync_done": "Lokale Daten aktualisiert"
+    },
+    "stats_monthly": {
+        "title": "Monatsstatistik",
+        "consumed": "Produkte verbraucht",
+        "trend_up": "+{pct}% vs. {prev}",
+        "trend_down": "-{pct}% vs. {prev}",
+        "trend_same": "gleiches Tempo wie letzten Monat",
+        "added": "hinzugefügt",
+        "wasted": "verschwendet",
+        "top_used": "meistbenutzt",
+        "top_cats": "Hauptkategorien",
+        "source": "Transaktionsverlauf · aktueller Monat"
    }
 }
@@ -213,7 +213,14 @@
        "barcode_acquired": "🔖 Barcode scanned: {code}",
        "scan_barcode": "🔖 Scan Barcode",
        "create_named": "Create {name}",
-    "new_without_barcode": "New product without barcode"
+        "new_without_barcode": "New product without barcode",
+        "stock_in_pantry": "Already in pantry:",
+        "status_ready": "Point camera at barcode",
+        "status_scanning": "Scanning...",
+        "status_partial": "Detected: {code} — verifying...",
+        "status_invalid": "Invalid: {code} — retrying",
+        "status_confirmed": "Confirmed!",
+        "status_parallel": "Using combined scan methods..."
    },
    "action": {
        "title": "What do you want to do?",
@@ -227,7 +234,8 @@
        "throw_btn": "🗑️ DISCARD",
        "throw_sub": "throw away",
        "edit_sub": "expiry, location…",
-    "create_recipe_btn": "Recipe"
+        "create_recipe_btn": "Recipe",
+        "related_stock_title": "Also at home"
    },
    "add": {
        "title": "Add to Pantry",
@@ -359,12 +367,16 @@
        "loading_msg": "Preparing your recipe...",
        "start_cooking": "👨‍🍳 Cooking Mode",
        "regenerate": "🔄 Generate another one",
+        "regen_choice_title": "What do you want to do with this recipe?",
+        "regen_replace": "🔄 Generate another (discard this one)",
+        "regen_save_new": "💾 Save to archive & generate a new one",
        "close_btn": "✅ Close",
        "ingredients_title": "🧾 Ingredients",
        "tools_title": "Equipment needed",
        "steps_title": "👨‍🍳 Steps",
        "no_steps": "No steps available",
        "generate_error": "Generation error",
+        "stream_interrupted": "Generation interrupted (incomplete server response). Check logs or try again.",
        "persons_short": "serv.",
        "use_ingredient_title": "Use ingredient",
        "recipe_qty_label": "Recipe",
@@ -378,7 +390,10 @@
        "scale_wait_stable": "Wait 10s of stable weight for auto-fill…",
        "ingredient_scaled_toast": "📦 Ingredient deducted from pantry!",
        "finished_added_bring_toast": "🛒 Finished product → added to Bring!",
-    "load_error": "Loading error"
+        "load_error": "Loading error",
+        "favorite": "Add to favourites",
+        "unfavorite": "Remove from favourites",
+        "adjust_persons": "Persons"
    },
    "shopping": {
        "title": "🛒 Shopping List",
@@ -473,7 +488,8 @@
        "priority_medium": "Medium",
        "priority_low": "Low",
        "smart_last_update": "Updated {time}",
-    "names_already_updated": "All names are already up to date"
+        "names_already_updated": "All names are already up to date",
+        "pantry_hint": "Already at home: {qty}"
    },
    "ai": {
        "title": "🤖 AI Identification",
@@ -686,6 +702,7 @@
            "extra_fields_label": "➕ Extra fields (JSON)",
            "extra_fields_placeholder": "{\"entity_id\": \"media_player.living_room\"}",
            "extra_fields_hint": "Additional fields to include in the payload, in JSON format. Leave empty if not needed.",
+            "test_sound_btn": "🔔 Run Sound Test",
            "test_btn": "🔊 Send Test Voice",
            "voices_loading": "Loading voices…",
            "voice_not_supported": "Voice not supported by this browser",
@@ -693,7 +710,12 @@
            "voices_hint": "Available voices depend on the OS and browser. On macOS/iOS the Paola (Italian) voice is available. Press ↺ if the list does not load.",
            "url_missing": "⚠️ Endpoint URL missing.",
            "test_sending": "⏳ Sending…",
-      "test_ok": "✅ Response {code} — check that the speaker has spoken."
+            "test_ok": "✅ Response {code} — check that the speaker has spoken.",
+            "heard_question": "Did you hear the voice?",
+            "heard_yes": "Yes, I heard it",
+            "heard_no": "No, I didn't hear it",
+            "test_ok_kiosk": "TTS is working.",
+            "test_fail_steps": "Check: 1) media volume is not 0; 2) Google Text-to-Speech is installed and updated; 3) Italian voice package is downloaded in Android TTS settings."
        },
        "language": {
            "title": "🌐 Language",
@@ -864,6 +886,60 @@
            "forecast_label": "Forecast low-stock products",
            "auto_add_label": "Auto-add to list when",
            "auto_add_suffix": "remaining in stock (0 = only when empty)"
+        },
+        "ha": {
+            "tab": "Home Assistant",
+            "title": "Home Assistant",
+            "hint": "Connect EverShelf to Home Assistant for automations, push notifications and REST sensors.",
+            "enabled": "Enable Home Assistant integration",
+            "connection_title": "Connection",
+            "url_label": "Home Assistant URL",
+            "url_placeholder": "http://192.168.1.50:8123",
+            "url_hint": "Base URL of your Home Assistant instance (e.g. http://homeassistant.local:8123).",
+            "token_label": "Long-Lived Access Token",
+            "token_hint": "Generate from HA Profile → Security → Long-Lived Access Tokens.",
+            "token_placeholder": "eyJhbGci...",
+            "token_saved": "Token saved (hidden for security)",
+            "test_btn": "Test connection",
+            "test_ok": "Connected to {version}",
+            "test_fail": "Connection failed: {error}",
+            "test_bad_token": "HA reachable but token is invalid",
+            "testing": "Testing…",
+            "error_no_url": "Please enter the Home Assistant URL first.",
+            "tts_title": "TTS on Smart Speaker",
+            "tts_hint": "Read recipe steps aloud on a Home Assistant media player.",
+            "tts_entity_label": "Media player entity ID",
+            "tts_entity_placeholder": "media_player.living_room",
+            "tts_entity_hint": "Entity ID of the HA media player. Find it in HA: Developer Tools → States.",
+            "tts_platform_label": "TTS platform",
+            "tts_platform_speak": "tts.speak (recommended)",
+            "tts_platform_notify": "notify.* (notification service)",
+            "tts_apply_btn": "Apply HA preset to TTS tab",
+            "tts_apply_hint": "Pre-fills the TTS tab with the Home Assistant URL and token.",
+            "tts_preset_applied": "HA preset applied to TTS tab.",
+            "webhook_title": "Webhook Automations",
+            "webhook_hint": "Send data to Home Assistant when pantry events occur. Create an HA automation with a Webhook trigger and paste the generated ID here.",
+            "webhook_id_label": "Webhook ID",
+            "webhook_id_placeholder": "evershelf_webhook_abc123",
+            "webhook_id_hint": "ID of the webhook created in HA. Copy from: HA → Settings → Automations → Create → Webhook Trigger.",
+            "webhook_events_label": "Notify on these events",
+            "event_expiry": "Expiring products (daily)",
+            "event_shopping": "Item added to shopping list",
+            "event_stock": "Stock level updated",
+            "expiry_days_label": "Expiry lead time (days)",
+            "expiry_days_hint": "Send the expiry alert N days before the expiry date.",
+            "webhook_help": "In HA: Settings → Automations → Create automation → Trigger: Webhook → copy the generated ID above.",
+            "notify_title": "Push Notifications",
+            "notify_hint": "Send push notifications to your phone via a Home Assistant notify service.",
+            "notify_service_label": "Notify service",
+            "notify_service_placeholder": "notify.mobile_app_my_phone",
+            "notify_service_hint": "HA notify service name (e.g. notify.mobile_app_phone). Leave empty to disable.",
+            "sensor_title": "REST Sensors",
+            "sensor_hint": "Add to configuration.yaml to create EverShelf sensors in Home Assistant.",
+            "sensor_copy_btn": "Copy YAML",
+            "sensor_copied": "YAML copied to clipboard!",
+            "save_btn": "Save HA settings",
+            "ha_hint": "If you use Home Assistant, use the Home Assistant tab to configure TTS, webhooks and sensors."
        }
    },
    "expiry": {
@@ -998,13 +1074,25 @@
        "server_retry": "Retry",
        "unknown": "Unknown error",
        "prefix": "Error",
-    "no_inventory_entry": "No inventory entry found"
+        "no_inventory_entry": "No inventory entry found",
+        "offline_title": "No connection",
+        "offline_subtitle": "The app cannot reach the server. Check your Wi-Fi connection.",
+        "offline_checking": "Checking connection…",
+        "offline_restored": "Connection restored!",
+        "offline_continue": "Continue in offline mode",
+        "offline_reading_cache": "Reading from local cache",
+        "offline_ops_pending": "{n} operations pending",
+        "offline_synced": "{n} operations synced",
+        "offline_ai_disabled": "Not available offline",
+        "offline_cache_ready": "Offline — {n} items cached"
    },
+    "confirm_placeholder_search": null,
    "confirm": {
        "remove_item": "Do you really want to remove this product from inventory?",
        "kiosk_exit": "Exit kiosk mode?",
        "cancel": "Cancel",
-    "proceed": "Confirm"
+        "proceed": "Confirm",
+        "discard_one": "Discard 1 piece"
    },
    "location": {
        "dispensa": "Pantry",
@@ -1016,7 +1104,8 @@
        "unknown_hint": "Enter the product name and information",
        "label_name": "🏷️ Product name",
        "choose_location_title": "Which location?",
-    "choose_location_hint": "Choose the location to edit:"
+        "choose_location_hint": "Choose the location to edit:",
+        "confirm_large_qty": "You are setting the quantity to {qty} {unit}. This seems unusually high. Confirm?"
    },
    "screensaver": {
        "recipe_btn": "Recipes",
@@ -1170,7 +1259,13 @@
        "source": "Based on {n} products in your pantry · EverShelf",
        "products_count": "products",
        "today_title": "🥗 Your pantry today",
-    "products_n": "{n} products"
+        "products_n": "{n} products",
+        "macros_title": "Estimated Macronutrients",
+        "macros_proteins": "Proteins",
+        "macros_carbs": "Carbohydrates",
+        "macros_fat": "Fat",
+        "macros_fiber": "Fibre",
+        "macros_source": "Estimate based on {n} pantry products"
    },
    "facts": {
        "greeting_morning": "Good morning",
@@ -1344,6 +1439,20 @@
        "critical_error_intro": "The app cannot start due to the following issues:",
        "error_network": "Cannot reach the server.",
        "error_network_detail": "The browser cannot reach the PHP server.\n\nPossible causes:\n• Apache/PHP server is not running\n• Network or firewall issue\n• Incorrect app URL\n\nMake sure the server is started and try again.",
-    "retry": "Retry"
+        "retry": "Retry",
+        "syncing_local": "Syncing local data...",
+        "sync_done": "Local data synced"
+    },
+    "stats_monthly": {
+        "title": "Monthly Stats",
+        "consumed": "products used",
+        "trend_up": "+{pct}% vs {prev}",
+        "trend_down": "-{pct}% vs {prev}",
+        "trend_same": "same pace as last month",
+        "added": "added",
+        "wasted": "wasted",
+        "top_used": "top used",
+        "top_cats": "Top categories",
+        "source": "Transaction history · current month"
    }
 }
@@ -211,7 +211,13 @@
        "barcode_acquired": "🔖 Código de barras escaneado: {code}",
        "scan_barcode": "🔖 Escanear código de barras",
        "create_named": "Crear {name}",
-    "new_without_barcode": "Nuevo producto sin código de barras"
+        "new_without_barcode": "Nuevo producto sin código de barras",
+        "status_ready": "Apunta la cámara al código de barras",
+        "status_scanning": "Escaneando...",
+        "status_partial": "Detectado: {code} — verificando...",
+        "status_invalid": "Inválido: {code} — reintentando",
+        "status_confirmed": "Confirmado!",
+        "status_parallel": "Escaneo combinado activo..."
    },
    "action": {
        "title": "¿Qué quieres hacer?",
@@ -357,6 +363,9 @@
        "loading_msg": "Preparando tu receta...",
        "start_cooking": "👨‍🍳 Modo cocina",
        "regenerate": "🔄 Generar otra",
+        "regen_choice_title": "¿Qué quieres hacer con esta receta?",
+        "regen_replace": "🔄 Generar otra (descartar esta)",
+        "regen_save_new": "💾 Guardar en el archivo y generar una nueva",
        "close_btn": "✅ Cerrar",
        "ingredients_title": "🧾 Ingredientes",
        "tools_title": "Equipo necesario",
@@ -376,7 +385,10 @@
        "scale_wait_stable": "Espera 10s de peso estable para el relleno automático…",
        "ingredient_scaled_toast": "📦 ¡Ingrediente deducido de la despensa!",
        "finished_added_bring_toast": "🛒 Producto terminado → ¡añadido a Bring!",
-    "load_error": "Error de carga"
+        "load_error": "Error de carga",
+        "favorite": "Añadir a favoritos",
+        "unfavorite": "Quitar de favoritos",
+        "adjust_persons": "Personas"
    },
    "shopping": {
        "title": "🛒 Lista de la compra",
@@ -691,7 +703,12 @@
            "voices_hint": "Las voces disponibles dependen del SO y el navegador. Pulsa ↺ si la lista no carga.",
            "url_missing": "⚠️ URL del endpoint faltante.",
            "test_sending": "⏳ Enviando…",
-      "test_ok": "✅ Respuesta {code} — comprueba que el altavoz haya hablado."
+            "test_ok": "✅ Respuesta {code} — comprueba que el altavoz haya hablado.",
+            "heard_question": "¿Has escuchado la voz?",
+            "heard_yes": "Sí, la escuché",
+            "heard_no": "No, no escuché nada",
+            "test_ok_kiosk": "TTS funcionando.",
+            "test_fail_steps": "Comprueba: 1) el volumen del multimedia no es 0; 2) Google Text-to-Speech está instalado y actualizado; 3) el paquete de voz español está descargado en la configuración TTS de Android."
        },
        "language": {
            "title": "🌐 Idioma",
@@ -821,6 +838,60 @@
            "forecast_label": "Previsión de productos por agotar",
            "auto_add_label": "Añadir automáticamente cuando",
            "auto_add_suffix": "restante en stock (0 = solo cuando se agota)"
+        },
+        "ha": {
+            "tab": "Home Assistant",
+            "title": "Home Assistant",
+            "hint": "Conecta EverShelf a Home Assistant para automatizaciones, notificaciones push y sensores REST.",
+            "enabled": "Activar integración con Home Assistant",
+            "connection_title": "Conexión",
+            "url_label": "URL de Home Assistant",
+            "url_placeholder": "http://192.168.1.50:8123",
+            "url_hint": "URL base de tu instancia de Home Assistant.",
+            "token_label": "Token de acceso de larga duración",
+            "token_hint": "Genera desde Perfil HA → Seguridad → Tokens de acceso de larga duración.",
+            "token_placeholder": "eyJhbGci...",
+            "token_saved": "Token guardado (oculto por seguridad)",
+            "test_btn": "Probar conexión",
+            "test_ok": "Conectado a {version}",
+            "test_fail": "Conexión fallida: {error}",
+            "test_bad_token": "HA accesible pero el token no es válido",
+            "testing": "Probando…",
+            "error_no_url": "Por favor, introduce primero la URL de Home Assistant.",
+            "tts_title": "TTS en altavoz inteligente",
+            "tts_hint": "Lee los pasos de la receta en un reproductor de medios de Home Assistant.",
+            "tts_entity_label": "Entity ID del reproductor multimedia",
+            "tts_entity_placeholder": "media_player.salon",
+            "tts_entity_hint": "ID de entidad del reproductor multimedia HA. Encuéntralo en HA: Herramientas para desarrolladores → Estados.",
+            "tts_platform_label": "Plataforma TTS",
+            "tts_platform_speak": "tts.speak (recomendado)",
+            "tts_platform_notify": "notify.* (servicio de notificaciones)",
+            "tts_apply_btn": "Aplicar preset HA a la pestaña TTS",
+            "tts_apply_hint": "Pre-rellena la pestaña TTS con la URL y el token de Home Assistant.",
+            "tts_preset_applied": "Preset HA aplicado a la pestaña TTS.",
+            "webhook_title": "Automatizaciones Webhook",
+            "webhook_hint": "Envía datos a Home Assistant cuando ocurren eventos en la despensa.",
+            "webhook_id_label": "ID de Webhook",
+            "webhook_id_placeholder": "evershelf_webhook_abc123",
+            "webhook_id_hint": "ID del webhook creado en HA. Copia desde: HA → Ajustes → Automatizaciones → Crear → Disparador Webhook.",
+            "webhook_events_label": "Notificar en estos eventos",
+            "event_expiry": "Productos próximos a caducar (diario)",
+            "event_shopping": "Artículo añadido a la lista de compras",
+            "event_stock": "Nivel de stock actualizado",
+            "expiry_days_label": "Antelación de caducidad (días)",
+            "expiry_days_hint": "Enviar alerta de caducidad N días antes de la fecha.",
+            "webhook_help": "En HA: Ajustes → Automatizaciones → Crear automatización → Disparador: Webhook → copia el ID generado.",
+            "notify_title": "Notificaciones push",
+            "notify_hint": "Envía notificaciones push a tu teléfono mediante un servicio notify de Home Assistant.",
+            "notify_service_label": "Servicio notify",
+            "notify_service_placeholder": "notify.mobile_app_mi_telefono",
+            "notify_service_hint": "Nombre del servicio notify de HA. Déjalo vacío para desactivar.",
+            "sensor_title": "Sensores REST",
+            "sensor_hint": "Añade a configuration.yaml para crear sensores de EverShelf en Home Assistant.",
+            "sensor_copy_btn": "Copiar YAML",
+            "sensor_copied": "¡YAML copiado al portapapeles!",
+            "save_btn": "Guardar ajustes HA",
+            "ha_hint": "Si usas Home Assistant, utiliza la pestaña Home Assistant para configurar TTS, webhooks y sensores."
        }
    },
    "expiry": {
@@ -954,13 +1025,25 @@
        "server_retry": "Reintentar",
        "unknown": "Error desconocido",
        "prefix": "Error",
-    "no_inventory_entry": "No se encontró ninguna entrada de inventario"
+        "no_inventory_entry": "No se encontró ninguna entrada de inventario",
+        "offline_title": "Sin conexión",
+        "offline_subtitle": "La app no puede conectar con el servidor. Verifica tu conexión Wi-Fi.",
+        "offline_checking": "Verificando conexión…",
+        "offline_restored": "¡Conexión restaurada!",
+        "offline_continue": "Continuar en modo sin conexión",
+        "offline_reading_cache": "Leyendo desde caché local",
+        "offline_ops_pending": "{n} operaciones pendientes",
+        "offline_synced": "{n} operaciones sincronizadas",
+        "offline_ai_disabled": "No disponible sin conexión",
+        "offline_cache_ready": "Offline — {n} productos en caché"
    },
+    "confirm_placeholder_search": null,
    "confirm": {
        "remove_item": "¿Realmente quieres eliminar este producto del inventario?",
        "kiosk_exit": "¿Salir del modo kiosco?",
        "cancel": "Cancelar",
-    "proceed": "Confirmar"
+        "proceed": "Confirmar",
+        "discard_one": "Tirar 1 unidad"
    },
    "location": {
        "dispensa": "Despensa",
@@ -972,7 +1055,8 @@
        "unknown_hint": "Introduce el nombre del producto y la información",
        "label_name": "🏷️ Nombre del producto",
        "choose_location_title": "¿Qué ubicación?",
-    "choose_location_hint": "Elige la ubicación a editar:"
+        "choose_location_hint": "Elige la ubicación a editar:",
+        "confirm_large_qty": "Estás configurando la cantidad a {qty} {unit}. Esto parece inusualmente alto. ¿Confirmar?"
    },
    "screensaver": {
        "recipe_btn": "Recetas",
@@ -1123,7 +1207,13 @@
        "source": "Basado en {n} productos en tu despensa · EverShelf",
        "products_count": "productos",
        "today_title": "🥗 Tu despensa hoy",
-    "products_n": "{n} productos"
+        "products_n": "{n} productos",
+        "macros_title": "Macronutrientes estimados",
+        "macros_proteins": "Proteínas",
+        "macros_carbs": "Carbohidratos",
+        "macros_fat": "Grasas",
+        "macros_fiber": "Fibra",
+        "macros_source": "Estimación basada en {n} productos en despensa"
    },
    "facts": {
        "greeting_morning": "Buenos días",
@@ -1292,6 +1382,20 @@
        "critical_error_short": "Error crítico",
        "critical_error": "Error crítico: la aplicación no puede iniciarse. Revisa los registros del servidor.",
        "error_network": "No se puede contactar con el servidor. Comprueba tu conexión de red.",
-    "retry": "Reintentar"
+        "retry": "Reintentar",
+        "syncing_local": "Sincronizando datos locales...",
+        "sync_done": "Datos locales sincronizados"
+    },
+    "stats_monthly": {
+        "title": "Estadísticas Mensuales",
+        "consumed": "productos usados",
+        "trend_up": "+{pct}% vs {prev}",
+        "trend_down": "-{pct}% vs {prev}",
+        "trend_same": "mismo ritmo que el mes pasado",
+        "added": "añadidos",
+        "wasted": "desperdiciados",
+        "top_used": "más usado",
+        "top_cats": "Categorías principales",
+        "source": "Historial de transacciones · mes actual"
    }
 }
@@ -211,7 +211,13 @@
        "barcode_acquired": "🔖 Code-barres scanné : {code}",
        "scan_barcode": "🔖 Scanner le code-barres",
        "create_named": "Créer {name}",
-    "new_without_barcode": "Nouveau produit sans code-barres"
+        "new_without_barcode": "Nouveau produit sans code-barres",
+        "status_ready": "Pointez la caméra sur le code-barres",
+        "status_scanning": "Scan en cours...",
+        "status_partial": "Lu : {code} — vérification...",
+        "status_invalid": "Invalide : {code} — nouvel essai",
+        "status_confirmed": "Confirmé !",
+        "status_parallel": "Scan combiné actif..."
    },
    "action": {
        "title": "Que voulez-vous faire ?",
@@ -357,6 +363,9 @@
        "loading_msg": "Préparation de votre recette...",
        "start_cooking": "👨‍🍳 Mode cuisine",
        "regenerate": "🔄 En générer une autre",
+        "regen_choice_title": "Que veux-tu faire de cette recette ?",
+        "regen_replace": "🔄 En générer une autre (ignorer celle-ci)",
+        "regen_save_new": "💾 Sauvegarder dans l'archive et en générer une nouvelle",
        "close_btn": "✅ Fermer",
        "ingredients_title": "🧾 Ingrédients",
        "tools_title": "Matériel nécessaire",
@@ -376,7 +385,10 @@
        "scale_wait_stable": "Attendez 10s de poids stable pour le remplissage automatique…",
        "ingredient_scaled_toast": "📦 Ingrédient déduit du garde-manger !",
        "finished_added_bring_toast": "🛒 Produit terminé → ajouté à Bring !",
-    "load_error": "Erreur de chargement"
+        "load_error": "Erreur de chargement",
+        "favorite": "Ajouter aux favoris",
+        "unfavorite": "Retirer des favoris",
+        "adjust_persons": "Personnes"
    },
    "shopping": {
        "title": "🛒 Liste de courses",
@@ -691,7 +703,12 @@
            "voices_hint": "Les voix disponibles dépendent du système d'exploitation et du navigateur. Appuyez sur ↺ si la liste ne se charge pas.",
            "url_missing": "⚠️ URL de l'endpoint manquante.",
            "test_sending": "⏳ Envoi…",
-      "test_ok": "✅ Réponse {code} — vérifiez que le haut-parleur a parlé."
+            "test_ok": "✅ Réponse {code} — vérifiez que le haut-parleur a parlé.",
+            "heard_question": "Avez-vous entendu la voix ?",
+            "heard_yes": "Oui, je l'ai entendu",
+            "heard_no": "Non, je n'ai rien entendu",
+            "test_ok_kiosk": "TTS fonctionne.",
+            "test_fail_steps": "Vérifiez : 1) le volume média n'est pas 0 ; 2) Google Text-to-Speech est installé et mis à jour ; 3) le pack vocal français est téléchargé dans les paramètres TTS Android."
        },
        "language": {
            "title": "🌐 Langue",
@@ -821,6 +838,60 @@
            "forecast_label": "Prévision des produits bientôt épuisés",
            "auto_add_label": "Ajouter automatiquement quand",
            "auto_add_suffix": "restant en stock (0 = seulement quand épuisé)"
+        },
+        "ha": {
+            "tab": "Home Assistant",
+            "title": "Home Assistant",
+            "hint": "Connectez EverShelf à Home Assistant pour les automations, les notifications push et les capteurs REST.",
+            "enabled": "Activer l'intégration Home Assistant",
+            "connection_title": "Connexion",
+            "url_label": "URL Home Assistant",
+            "url_placeholder": "http://192.168.1.50:8123",
+            "url_hint": "URL de base de votre instance Home Assistant.",
+            "token_label": "Jeton d'accès longue durée",
+            "token_hint": "Générez depuis Profil HA → Sécurité → Jetons d'accès longue durée.",
+            "token_placeholder": "eyJhbGci...",
+            "token_saved": "Jeton enregistré (masqué pour des raisons de sécurité)",
+            "test_btn": "Tester la connexion",
+            "test_ok": "Connecté à {version}",
+            "test_fail": "Connexion échouée : {error}",
+            "test_bad_token": "HA accessible mais le jeton est invalide",
+            "testing": "Test en cours…",
+            "error_no_url": "Veuillez d'abord saisir l'URL de Home Assistant.",
+            "tts_title": "TTS sur enceinte connectée",
+            "tts_hint": "Lisez les étapes de recette sur un media player Home Assistant.",
+            "tts_entity_label": "Entity ID du lecteur multimédia",
+            "tts_entity_placeholder": "media_player.salon",
+            "tts_entity_hint": "Entity ID du lecteur multimédia HA. Disponible dans HA : Outils développeur → États.",
+            "tts_platform_label": "Plateforme TTS",
+            "tts_platform_speak": "tts.speak (recommandé)",
+            "tts_platform_notify": "notify.* (service de notification)",
+            "tts_apply_btn": "Appliquer le preset HA à l'onglet TTS",
+            "tts_apply_hint": "Pré-remplit l'onglet TTS avec l'URL et le jeton de Home Assistant.",
+            "tts_preset_applied": "Preset HA appliqué à l'onglet TTS.",
+            "webhook_title": "Automations Webhook",
+            "webhook_hint": "Envoyez des données à Home Assistant lors d'événements dans le garde-manger.",
+            "webhook_id_label": "ID Webhook",
+            "webhook_id_placeholder": "evershelf_webhook_abc123",
+            "webhook_id_hint": "ID du webhook créé dans HA. Copiez depuis : HA → Paramètres → Automations → Créer → Déclencheur Webhook.",
+            "webhook_events_label": "Notifier pour ces événements",
+            "event_expiry": "Produits expirant bientôt (quotidien)",
+            "event_shopping": "Article ajouté à la liste de courses",
+            "event_stock": "Niveau de stock mis à jour",
+            "expiry_days_label": "Préavis d'expiration (jours)",
+            "expiry_days_hint": "Envoyer l'alerte d'expiration N jours avant la date d'expiration.",
+            "webhook_help": "Dans HA : Paramètres → Automations → Créer → Déclencheur : Webhook → copier l'ID généré.",
+            "notify_title": "Notifications push",
+            "notify_hint": "Envoyez des notifications push sur votre téléphone via un service notify de Home Assistant.",
+            "notify_service_label": "Service notify",
+            "notify_service_placeholder": "notify.mobile_app_mon_telephone",
+            "notify_service_hint": "Nom du service notify HA. Laissez vide pour désactiver.",
+            "sensor_title": "Capteurs REST",
+            "sensor_hint": "Ajoutez à configuration.yaml pour créer des capteurs EverShelf dans Home Assistant.",
+            "sensor_copy_btn": "Copier le YAML",
+            "sensor_copied": "YAML copié dans le presse-papiers !",
+            "save_btn": "Enregistrer les paramètres HA",
+            "ha_hint": "Si vous utilisez Home Assistant, utilisez l'onglet Home Assistant pour configurer TTS, webhooks et capteurs."
        }
    },
    "expiry": {
@@ -954,13 +1025,25 @@
        "server_retry": "Réessayer",
        "unknown": "Erreur inconnue",
        "prefix": "Erreur",
-    "no_inventory_entry": "Aucune entrée d'inventaire trouvée"
+        "no_inventory_entry": "Aucune entrée d'inventaire trouvée",
+        "offline_title": "Aucune connexion",
+        "offline_subtitle": "L'app ne peut pas atteindre le serveur. Vérifiez votre connexion Wi-Fi.",
+        "offline_checking": "Vérification de la connexion…",
+        "offline_restored": "Connexion rétablie !",
+        "offline_continue": "Continuer en mode hors ligne",
+        "offline_reading_cache": "Lecture depuis le cache local",
+        "offline_ops_pending": "{n} opérations en attente",
+        "offline_synced": "{n} opérations synchronisées",
+        "offline_ai_disabled": "Indisponible hors ligne",
+        "offline_cache_ready": "Offline — {n} produits en cache"
    },
+    "confirm_placeholder_search": null,
    "confirm": {
        "remove_item": "Voulez-vous vraiment supprimer ce produit de l'inventaire ?",
        "kiosk_exit": "Quitter le mode kiosque ?",
        "cancel": "Annuler",
-    "proceed": "Confirmer"
+        "proceed": "Confirmer",
+        "discard_one": "Jeter 1 pièce"
    },
    "location": {
        "dispensa": "Garde-manger",
@@ -972,7 +1055,8 @@
        "unknown_hint": "Entrez le nom du produit et les informations",
        "label_name": "🏷️ Nom du produit",
        "choose_location_title": "Quel emplacement ?",
-    "choose_location_hint": "Choisissez l'emplacement à modifier :"
+        "choose_location_hint": "Choisissez l'emplacement à modifier :",
+        "confirm_large_qty": "Vous définissez la quantité à {qty} {unit}. Cela semble inhabituellement élevé. Confirmer ?"
    },
    "screensaver": {
        "recipe_btn": "Recettes",
@@ -1123,7 +1207,13 @@
        "source": "Basé sur {n} produits dans votre garde-manger · EverShelf",
        "products_count": "produits",
        "today_title": "🥗 Votre garde-manger aujourd'hui",
-    "products_n": "{n} produits"
+        "products_n": "{n} produits",
+        "macros_title": "Macronutriments estimés",
+        "macros_proteins": "Protéines",
+        "macros_carbs": "Glucides",
+        "macros_fat": "Lipides",
+        "macros_fiber": "Fibres",
+        "macros_source": "Estimation basée sur {n} produits en stock"
    },
    "facts": {
        "greeting_morning": "Bonjour",
@@ -1292,6 +1382,20 @@
        "critical_error_short": "Erreur critique",
        "critical_error": "Erreur critique : l'application ne peut pas démarrer. Vérifiez les logs.",
        "error_network": "Impossible de contacter le serveur. Vérifiez votre connexion réseau.",
-    "retry": "Réessayer"
+        "retry": "Réessayer",
+        "syncing_local": "Synchronisation des données locales...",
+        "sync_done": "Données locales synchronisées"
+    },
+    "stats_monthly": {
+        "title": "Statistiques Mensuelles",
+        "consumed": "produits utilisés",
+        "trend_up": "+{pct}% vs {prev}",
+        "trend_down": "-{pct}% vs {prev}",
+        "trend_same": "même rythme que le mois dernier",
+        "added": "ajoutés",
+        "wasted": "gaspillés",
+        "top_used": "le plus utilisé",
+        "top_cats": "Catégories principales",
+        "source": "Historique des transactions · mois en cours"
    }
 }
@@ -213,7 +213,14 @@
        "barcode_acquired": "🔖 Barcode acquisito: {code}",
        "scan_barcode": "🔖 Scansiona Barcode",
        "create_named": "Crea {name}",
-    "new_without_barcode": "Nuovo prodotto senza barcode"
+        "new_without_barcode": "Nuovo prodotto senza barcode",
+        "stock_in_pantry": "Hai gia in dispensa:",
+        "status_ready": "Inquadra il codice a barre",
+        "status_scanning": "Scansione in corso...",
+        "status_partial": "Letto: {code} — verifico...",
+        "status_invalid": "Non valido: {code} — riprovo",
+        "status_confirmed": "Confermato!",
+        "status_parallel": "Doppia scansione attiva..."
    },
    "action": {
        "title": "Cosa vuoi fare?",
@@ -227,7 +234,8 @@
        "throw_btn": "🗑️ BUTTA",
        "throw_sub": "butta il prodotto",
        "edit_sub": "scadenza, luogo…",
-    "create_recipe_btn": "Ricetta"
+        "create_recipe_btn": "Ricetta",
+        "related_stock_title": "Hai anche in casa"
    },
    "add": {
        "title": "Aggiungi alla Dispensa",
@@ -359,12 +367,16 @@
        "loading_msg": "Sto preparando la ricetta...",
        "start_cooking": "👨‍🍳 Modalità Cucina",
        "regenerate": "🔄 Generane un'altra",
+        "regen_choice_title": "Cosa vuoi fare con questa ricetta?",
+        "regen_replace": "🔄 Genera un'altra (scarta questa)",
+        "regen_save_new": "💾 Salva nell'archivio e genera una nuova",
        "close_btn": "✅ Chiudi",
        "ingredients_title": "🧾 Ingredienti",
        "tools_title": "Strumenti necessari",
        "steps_title": "👨‍🍳 Procedimento",
        "no_steps": "Nessun procedimento disponibile",
        "generate_error": "Errore nella generazione",
+        "stream_interrupted": "Generazione interrotta (risposta incompleta dal server). Controlla i log o riprova.",
        "persons_short": "pers.",
        "use_ingredient_title": "Usa ingrediente",
        "recipe_qty_label": "Ricetta",
@@ -378,7 +390,10 @@
        "scale_wait_stable": "Attendi 10s di stabilità per la compilazione automatica…",
        "ingredient_scaled_toast": "📦 Ingrediente scalato dalla dispensa!",
        "finished_added_bring_toast": "🛒 Prodotto finito → aggiunto a Bring!",
-    "load_error": "Errore nel caricamento"
+        "load_error": "Errore nel caricamento",
+        "favorite": "Aggiungi ai preferiti",
+        "unfavorite": "Rimuovi dai preferiti",
+        "adjust_persons": "Persone"
    },
    "shopping": {
        "title": "🛒 Lista della Spesa",
@@ -473,7 +488,8 @@
        "priority_medium": "Media",
        "priority_low": "Bassa",
        "smart_last_update": "Aggiornato {time}",
-    "names_already_updated": "Tutti i nomi sono già aggiornati"
+        "names_already_updated": "Tutti i nomi sono già aggiornati",
+        "pantry_hint": "Hai gia {qty} in dispensa"
    },
    "ai": {
        "title": "🤖 Identificazione AI",
@@ -686,6 +702,7 @@
            "extra_fields_label": "➕ Campi extra (JSON)",
            "extra_fields_placeholder": "{\"entity_id\": \"media_player.living_room\"}",
            "extra_fields_hint": "Campi aggiuntivi da includere nel payload, in formato JSON. Lascia vuoto se non necessario.",
+            "test_sound_btn": "🔔 Esegui Test Suono",
            "test_btn": "🔊 Invia Test Vocale",
            "voices_loading": "Caricamento voci…",
            "voice_not_supported": "Voce non supportata dal browser",
@@ -693,7 +710,12 @@
            "voices_hint": "Le voci disponibili dipendono dal sistema operativo e dal browser. Su macOS/iOS è disponibile la voce Paola (italiano). Premi ↺ se la lista non si carica.",
            "url_missing": "⚠️ URL endpoint mancante.",
            "test_sending": "⏳ Invio in corso…",
-      "test_ok": "✅ Risposta {code} — controlla che l'altoparlante abbia parlato."
+            "test_ok": "✅ Risposta {code} — controlla che l'altoparlante abbia parlato.",
+            "heard_question": "Hai sentito la voce?",
+            "heard_yes": "Sì, ho sentito",
+            "heard_no": "No, non ho sentito",
+            "test_ok_kiosk": "TTS funzionante.",
+            "test_fail_steps": "Controlla: 1) volume media del dispositivo non sia 0; 2) Google Text-to-Speech installato e aggiornato; 3) pacchetto vocale italiano scaricato nelle impostazioni TTS Android."
        },
        "language": {
            "title": "🌐 Lingua / Language",
@@ -864,6 +886,60 @@
            "forecast_label": "Previsione prodotti in esaurimento",
            "auto_add_label": "Aggiungi automaticamente quando",
            "auto_add_suffix": "rimasto in magazzino (0 = solo quando esaurito)"
+        },
+        "ha": {
+            "tab": "Home Assistant",
+            "title": "Home Assistant",
+            "hint": "Collega EverShelf a Home Assistant per automazioni, notifiche push e sensori REST.",
+            "enabled": "Abilita integrazione Home Assistant",
+            "connection_title": "Connessione",
+            "url_label": "URL Home Assistant",
+            "url_placeholder": "http://192.168.1.50:8123",
+            "url_hint": "URL del tuo server Home Assistant (es. http://homeassistant.local:8123).",
+            "token_label": "Long-Lived Access Token",
+            "token_hint": "Genera da Profilo HA → Sicurezza → Token di accesso a lungo termine.",
+            "token_placeholder": "eyJhbGci...",
+            "token_saved": "Token salvato (non mostrato per sicurezza)",
+            "test_btn": "Testa connessione",
+            "test_ok": "Connesso a {version}",
+            "test_fail": "Connessione fallita: {error}",
+            "test_bad_token": "HA raggiungibile ma token non valido",
+            "testing": "Test in corso…",
+            "error_no_url": "Inserisci prima l'URL di Home Assistant.",
+            "tts_title": "TTS su Speaker Smart",
+            "tts_hint": "Leggi i passi delle ricette su un media player di Home Assistant.",
+            "tts_entity_label": "Entity ID media player",
+            "tts_entity_placeholder": "media_player.living_room",
+            "tts_entity_hint": "Entity ID del media player su cui vuoi la voce. Puoi trovarlo in HA: Strumenti per sviluppatori → Stati.",
+            "tts_platform_label": "Piattaforma TTS",
+            "tts_platform_speak": "tts.speak (raccomandato)",
+            "tts_platform_notify": "notify.* (servizio notifiche)",
+            "tts_apply_btn": "Applica preset HA al tab TTS",
+            "tts_apply_hint": "Pre-compila il tab TTS con l'URL e il token di Home Assistant.",
+            "tts_preset_applied": "Preset HA applicato al tab TTS.",
+            "webhook_title": "Automazioni Webhook",
+            "webhook_hint": "Invia dati a Home Assistant quando avvengono eventi nella dispensa. Crea un'automazione in HA con trigger Webhook e copia l'ID generato.",
+            "webhook_id_label": "Webhook ID",
+            "webhook_id_placeholder": "evershelf_webhook_abc123",
+            "webhook_id_hint": "ID del webhook creato in HA. Copia da: HA → Impostazioni → Automazioni → Crea → Trigger Webhook.",
+            "webhook_events_label": "Notifica per questi eventi",
+            "event_expiry": "Prodotti in scadenza (giornaliero)",
+            "event_shopping": "Aggiunta alla lista della spesa",
+            "event_stock": "Aggiornamento scorte",
+            "expiry_days_label": "Anticipo scadenze (giorni)",
+            "expiry_days_hint": "Invia la notifica di scadenza N giorni prima della data di scadenza.",
+            "webhook_help": "In HA: Impostazioni → Automazioni → Crea automazione → Trigger: Webhook → copia l'ID generato qui sopra.",
+            "notify_title": "Notifiche Push",
+            "notify_hint": "Invia notifiche push al tuo telefono tramite il servizio notify di Home Assistant.",
+            "notify_service_label": "Servizio notify",
+            "notify_service_placeholder": "notify.mobile_app_mio_telefono",
+            "notify_service_hint": "Nome del servizio notify HA (es. notify.mobile_app_phone). Lascia vuoto per disabilitare.",
+            "sensor_title": "Sensori REST",
+            "sensor_hint": "Aggiungi a configuration.yaml per creare sensori EverShelf in Home Assistant.",
+            "sensor_copy_btn": "Copia YAML",
+            "sensor_copied": "YAML copiato negli appunti!",
+            "save_btn": "Salva impostazioni HA",
+            "ha_hint": "Se usi Home Assistant, usa il tab Home Assistant per configurare TTS, webhook e sensori."
        }
    },
    "expiry": {
@@ -998,13 +1074,24 @@
        "server_retry": "Riprova",
        "unknown": "Errore sconosciuto",
        "prefix": "Errore",
-    "no_inventory_entry": "Nessuna voce di inventario trovata"
+        "no_inventory_entry": "Nessuna voce di inventario trovata",
+        "offline_title": "Nessuna connessione",
+        "offline_subtitle": "L'app non riesce a raggiungere il server. Verifica la connessione Wi-Fi.",
+        "offline_checking": "Verifica connessione…",
+        "offline_restored": "Connessione ripristinata!",
+        "offline_continue": "Continua in modalità offline",
+        "offline_reading_cache": "Lettura dalla cache locale",
+        "offline_ops_pending": "{n} operazioni in attesa",
+        "offline_synced": "{n} operazioni sincronizzate",
+        "offline_ai_disabled": "Non disponibile offline",
+        "offline_cache_ready": "Offline — {n} prodotti in cache"
    },
    "confirm": {
        "remove_item": "Vuoi davvero rimuovere questo prodotto dall'inventario?",
        "kiosk_exit": "Uscire dalla modalità kiosk?",
        "cancel": "Annulla",
-    "proceed": "Conferma"
+        "proceed": "Conferma",
+        "discard_one": "Butta 1 pezzo"
    },
    "location": {
        "dispensa": "Dispensa",
@@ -1016,7 +1103,8 @@
        "unknown_hint": "Inserisci il nome e le informazioni del prodotto",
        "label_name": "🏷️ Nome prodotto",
        "choose_location_title": "Quale modifica?",
-    "choose_location_hint": "Scegli la posizione da modificare:"
+        "choose_location_hint": "Scegli la posizione da modificare:",
+        "confirm_large_qty": "Stai impostando la quantità a {qty} {unit}. Questo sembra un valore insolitamente alto. Confermare?"
    },
    "screensaver": {
        "recipe_btn": "Ricette",
@@ -1181,7 +1269,13 @@
        "source": "Basato su {n} prodotti in dispensa · EverShelf",
        "products_count": "prodotti",
        "today_title": "🥗 La tua dispensa oggi",
-    "products_n": "{n} prodotti"
+        "products_n": "{n} prodotti",
+        "macros_title": "Macronutrienti stimati",
+        "macros_proteins": "Proteine",
+        "macros_carbs": "Carboidrati",
+        "macros_fat": "Grassi",
+        "macros_fiber": "Fibre",
+        "macros_source": "Stima basata su {n} prodotti in dispensa"
    },
    "facts": {
        "greeting_morning": "Buongiorno",
@@ -1344,6 +1438,20 @@
        "critical_error_intro": "L'app non può avviarsi a causa dei seguenti problemi:",
        "error_network": "Impossibile contattare il server.",
        "error_network_detail": "Il browser non riesce a raggiungere il server PHP.\n\nPossibili cause:\n• Il server Apache/PHP non è in esecuzione\n• Problema di rete o firewall\n• URL dell'app non corretta\n\nControlla che il server sia avviato e riprova.",
-    "retry": "Riprova"
+        "retry": "Riprova",
+        "syncing_local": "Sincronizzazione dati locali...",
+        "sync_done": "Dati locali aggiornati"
+    },
+    "stats_monthly": {
+        "title": "Statistiche Mensili",
+        "consumed": "prodotti usati",
+        "trend_up": "+{pct}% rispetto a {prev}",
+        "trend_down": "-{pct}% rispetto a {prev}",
+        "trend_same": "stesso ritmo del mese scorso",
+        "added": "aggiunti",
+        "wasted": "sprecati",
+        "top_used": "più usato",
+        "top_cats": "Categorie principali",
+        "source": "Storico transazioni · mese corrente"
    }
 }