Teilen-Blatt, HIG-Blaetter, geteilte Ansichtseinstellungen (2026.8.31.1)

Share-Erweiterung: ein PDF aus Mail landet ueber Teilen -> DataMetric360 als
Tankbeleg. Alles Native liegt versioniert unter companion-app/native/, weil
ios/ gitignored ist und npx cap add ios es sonst wieder frisst;
scripts/ios-teilen-einrichten.mjs haengt es bei jedem Bau ins Xcode-Projekt
und ist in ios-signieren.sh eingehaengt. Der pbxproj-Teil ist auf keinem Mac
erprobt - er bricht vor dem Schreiben ab, und docs/SHARE_EXTENSION.md
beschreibt dieselben Handgriffe fuer Xcode.

"In den Kalender uebernehmen" ging in der App nie: WKWebView ignoriert das
download-Attribut, der Klick lief ins Leere. Auf dem Geraet jetzt
@capacitor/filesystem plus @capacitor/share.

useTheme/useBoden legten je Aufrufer eigenen Zustand an - fuenf Kopien. Der
Schalter aenderte nur seine eigene, data-theme in App.tsx blieb stehen, die
Tag/Nacht-Umschaltung wirkte erst nach einem Neustart. Jetzt ein Speicher je
Einstellung ueber useSyncExternalStore. Zwei Regressionstests, gegen den
alten Stand als fehlschlagend nachgewiesen.

Alle Popups nach Apple HIG: neue Bausteine Sheet und ActionSheet, blickdicht
und mit abgedunkeltem Schleier, in beiden Codebasen. Popup portalierte nach
document.body - ausserhalb von [data-theme] - und war deshalb im Tagmodus
fast unsichtbar; Portal zielt jetzt auf .ads-root.

ImagePlaceholder merkte sich "fehlgeschlagen" ohne die Adresse: nach einem
leeren Galerieplatz zeigten auch die mit Foto nur noch den Platzhalter.
Vier Regressionstests, ebenfalls gegen den alten Stand geprueft.

Bildadressen tragen jetzt einen Cache-Brecher - HA liefert /local/ mit 31
Tagen Cache-Vorgabe aus, im Panel eingefuegte Radfotos erschienen in der App
deshalb nicht.

uebersichtsbild: Panel speichert den Namen, die App verglich gegen den
Dateinamen - der Vergleich traf nie zu. Kanonisch ist der Name.

Weiter: Navigationspfeil statt gleichschenkligem Dreieck auf der Streckenlinie
(die Kerbe unterscheidet Kopf und Ende), CI-Symbol tour-s als Fahrten-Icon,
Datumsfelder zeigen ihren Wert ohne erstes Antippen, feste Beispielnamen im
Setup, Kopf-Gegengewicht fuer mittige Titel, Standort-Blatt mit festem
Fussabstand, NSLocationWhenInUseUsageDescription, watchPosition fuer die
Live-Ortung, Art-Pille wieder als Knopf, Zwischenablage fuer Tankbelege.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

custom_components/audi_dashboard/einstellungen.py

@@ -159,94 +159,116 @@ FELDER: list[dict] = [
     {"key": "ZUENDUNG_SENSOR", "label": "Zündung/ACC-Status", "gruppe": "fahrterkennung",
      "hinweis": "on = Fahrt läuft, erkennt Fahrtbeginn/-ende.",
      "domains": ["binary_sensor"], "device_classes": [], "units": [], "liste": False, "pflicht": True,
+     "beispiel": "engine_ignition_or_acc_status",
      "stichworte": ["zündung", "ignition", "acc", "motor", "engine"]},
     {"key": "KM_SENSOR", "label": "Kilometerstand", "gruppe": "fahrterkennung",
      "hinweis": "Gesamt-Kilometerstand des Fahrzeugs - für Fahrtabschluss-Screening, Reifenzähler und Ölwechsel-Prognose.",
      "domains": ["sensor"], "device_classes": ["distance"], "units": ["km", "mi"], "liste": False, "pflicht": False,
+     "beispiel": "total_vehicle_mileage_read_from_can",
      "stichworte": ["kilometer", "km", "mileage", "odometer", "tacho", "laufleistung"]},
     {"key": "TANK_SENSOR", "label": "Tankfüllstand", "gruppe": "fahrterkennung",
      "hinweis": "Füllstand in Prozent - für die automatische Tankerkennung.",
      "domains": ["sensor"], "device_classes": [], "units": ["%"], "liste": False, "pflicht": False,
+     "beispiel": "fuel_level_in_tank_read_from_can",
      "stichworte": ["tank", "fuel", "kraftstoff", "füllstand", "level"]},
     {"key": "TANK_LITER_SENSOR", "label": "Tankvolumen", "gruppe": "fahrterkennung",
      "hinweis": "Optional, vom CAN statt aus dem Prozentwert umgerechnet - macht die automatische "
                 "Tankerkennung genauer und liefert eine Vorbelegung für die getankte Menge.",
      "domains": ["sensor"], "device_classes": ["volume"], "units": ["L", "l"], "liste": False, "pflicht": False,
+     "beispiel": "can_fuel_volume",
      "stichworte": ["tankvolumen", "liter", "litres", "fuel volume", "kraftstoffvolumen"]},
     {"key": "TANK_DISTANZ_SENSOR", "label": "Strecke seit letzter Tankung", "gruppe": "fahrterkennung",
      "hinweis": "Optional, vom Fahrzeug selbst berechnet - ersetzt die eigene Kilometerstand-Rechnung "
                 "für die Strecke eines Tankvorgangs.",
      "domains": ["sensor"], "device_classes": ["distance"], "units": ["km", "mi"], "liste": False, "pflicht": False,
+     "beispiel": "calculated_distance_covered_after_the_latest_refueling",
      "stichworte": ["strecke tankung", "distance refuel", "distance since refueling", "refuelling"]},
     {"key": "RANGE_SENSOR", "label": "Reichweite", "gruppe": "uebersicht",
      "hinweis": "Für die Übersicht - bleibt sie leer, zeigt die Oberfläche \"unbekannt\".",
      "domains": ["sensor"], "device_classes": ["distance"], "units": ["km", "mi"], "liste": False, "pflicht": False,
+     "beispiel": "vehicle_range_read_from_can",
      "stichworte": ["reichweite", "range"]},
     {"key": "BATTERIE_SENSOR", "label": "12V-Batteriespannung", "gruppe": "uebersicht",
      "hinweis": "Nicht jede Integration liefert diesen Wert - bleibt er leer, zeigt \"Mein Audi\" \"unbekannt\".",
      "domains": ["sensor"], "device_classes": ["voltage"], "units": ["V"], "liste": False, "pflicht": False,
+     "beispiel": "external_power_voltage",
      "stichworte": ["batterie", "battery", "spannung", "volt", "12v"]},
     {"key": "AUSSENTEMP_SENSOR", "label": "Außentemperatur", "gruppe": "uebersicht",
      "hinweis": "CAN-Außentemperatur - optional, ergänzt die Batteriespannungs-Messwertliste um den "
                 "Temperaturwert je Tag.",
      "domains": ["sensor"], "device_classes": ["temperature"], "units": ["°C", "°F"], "liste": False,
-     "pflicht": False, "stichworte": ["außentemperatur", "aussentemperatur", "ambient", "temperatur", "temperature"]},
+     "pflicht": False, "beispiel": "can_ambient_air_temperature",
+     "stichworte": ["außentemperatur", "aussentemperatur", "ambient", "temperatur", "temperature"]},
     {"key": "REFRESH_BUTTON", "label": "Sofort-Aktualisierung", "gruppe": "uebersicht",
      "hinweis": "Der von der Integration bereitgestellte Knopf für \"Ziehen zum Aktualisieren\".",
      "domains": ["button"], "device_classes": [], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "refresh_now",
      "stichworte": ["refresh", "aktualisieren", "update", "abrufen", "poll"]},
     {"key": "TUER_SENSOREN", "label": "Türen", "gruppe": "sicherheit",
      "hinweis": "\"aus\"/off = zu. Für \"Sicher abgestellt\" wichtig.",
      "domains": ["binary_sensor"], "device_classes": ["door"], "units": [], "liste": True, "positionen": POSITIONEN,
-     "pflicht": False, "stichworte": ["tür", "door"]},
+     "pflicht": False, "beispiel": "front_left_door",
+     "stichworte": ["tür", "door"]},
     {"key": "FENSTER_SENSOREN", "label": "Fenster", "gruppe": "sicherheit",
      "hinweis": "\"aus\"/off = zu.",
      "domains": ["binary_sensor"], "device_classes": ["window"], "units": [], "liste": True, "positionen": POSITIONEN,
-     "pflicht": False, "stichworte": ["fenster", "window"]},
+     "pflicht": False, "beispiel": "front_left_window",
+     "stichworte": ["fenster", "window"]},
     {"key": "HECKKLAPPE_SENSOR", "label": "Heckklappe", "gruppe": "sicherheit",
      "hinweis": "\"aus\"/off = zu.",
      "domains": ["binary_sensor"], "device_classes": ["door", "opening"], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "tailgate",
      "stichworte": ["heckklappe", "tailgate", "kofferraum", "trunk"]},
     {"key": "HAUBE_SENSOR", "label": "Motorhaube", "gruppe": "sicherheit",
      "hinweis": "\"aus\"/off = zu.",
      "domains": ["binary_sensor"], "device_classes": ["door", "opening"], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "hood",
      "stichworte": ["haube", "hood", "bonnet", "motorhaube"]},
     {"key": "TUERSCHLOSS_SENSOR", "label": "Türschloss", "gruppe": "sicherheit",
      "hinweis": "\"aus\"/off = verriegelt. Die Zentralverriegelung schließt alle Türen gemeinsam - "
                 "die Fahrertür genügt für \"Fahrzeug verriegelt\".",
      "domains": ["binary_sensor"], "device_classes": ["lock"], "units": [], "liste": False,
-     "pflicht": False, "stichworte": ["türschloss", "schloss", "lock", "verriegelt", "fahrertür"]},
+     "pflicht": False, "beispiel": "front_left_door_lock",
+     "stichworte": ["türschloss", "schloss", "lock", "verriegelt", "fahrertür"]},
     {"key": "DACH_SENSOR", "label": "Schiebedach", "gruppe": "sicherheit",
      "hinweis": "\"aus\"/off = zu.",
      "domains": ["binary_sensor"], "device_classes": ["window", "door", "opening"], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "sunroof",
      "stichworte": ["dach", "schiebedach", "sunroof", "roof"]},
     {"key": "LICHT_SENSOR", "label": "Standlicht", "gruppe": "sicherheit",
      "hinweis": "\"aus\"/off = kein Licht.",
      "domains": ["binary_sensor"], "device_classes": ["light"], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "parking_lights",
      "stichworte": ["licht", "standlicht", "light", "parking lights"]},
     {"key": "NAECHSTER_OELWECHSEL_SENSOR", "label": "Nächster Ölwechsel", "gruppe": "uebersicht",
      "hinweis": "Vom Fahrzeug selbst gemeldete Fälligkeit, ergänzt die App-eigene Servicebuch-Prognose.",
      "domains": ["sensor"], "device_classes": ["date", "timestamp"], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "oil_change_due",
      "stichworte": ["ölwechsel", "oil", "service", "change"]},
     {"key": "OELWECHSEL_STRECKE_SENSOR", "label": "Nächster Ölwechsel", "gruppe": "uebersicht",
      "hinweis": "Meldet die Integration oft als negativen Countdown - die App zeigt nur den Betrag.",
      "domains": ["sensor"], "device_classes": ["distance"], "units": ["km", "mi"], "liste": False, "pflicht": False,
+     "beispiel": "oil_change_distance",
      "stichworte": ["ölwechsel", "oil", "distance", "strecke"]},
     {"key": "NAECHSTE_INSPEKTION_SENSOR", "label": "Nächste Inspektion", "gruppe": "uebersicht",
      "hinweis": "Vom Fahrzeug selbst gemeldete Fälligkeit.",
      "domains": ["sensor"], "device_classes": ["date", "timestamp"], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "inspection_due",
      "stichworte": ["inspektion", "inspection", "service"]},
     {"key": "INSPEKTION_STRECKE_SENSOR", "label": "Nächste Inspektion", "gruppe": "uebersicht",
      "hinweis": "Meldet die Integration oft als negativen Countdown - die App zeigt nur den Betrag.",
      "domains": ["sensor"], "device_classes": ["distance"], "units": ["km", "mi"], "liste": False, "pflicht": False,
+     "beispiel": "inspection_distance",
      "stichworte": ["inspektion", "inspection", "distance", "strecke"]},
     {"key": "STANDORT_LAT_SENSOR", "label": "GPS-Standort: Breitengrad", "gruppe": "standort",
      "hinweis": "Breitengrad als eigener Sensor (z. B. flespi).",
      "domains": ["sensor"], "device_classes": [], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "latitude_coordinate_value",
      "stichworte": ["breitengrad", "latitude", "lat", "standort", "gps", "position", "ortung"]},
     {"key": "STANDORT_LON_SENSOR", "label": "GPS-Standort: Längengrad", "gruppe": "standort",
      "hinweis": "Längengrad als eigener Sensor (z. B. flespi).",
      "domains": ["sensor"], "device_classes": [], "units": [], "liste": False, "pflicht": False,
+     "beispiel": "longitude_coordinate_value",
      "stichworte": ["längengrad", "longitude", "lon", "lng", "standort", "gps", "position", "ortung"]},
 ]