# Wichtel für Gruppencodes

Die neun PNG-Dateien werden für Einladungen und die senkrechten Code-Drehräder
verwendet. Ihre Unicode-Dateinamen bleiben unverändert. Bedienung und Grenzen:
[Gruppenbearbeitung.md](Gruppenbearbeitung.md).

Die Reihenfolge entspricht der Vorlage: oben von links nach rechts, danach unten
von links nach rechts.

| Symbol / Dateiname | Motiv | Bemerkung |
| --- | --- | --- |
| 🪵.png | Holz tragender Gnom | Holz |
| 🪨.png | Gnom auf einem Felsen | Felsen |
| 🏮.png | Gnom mit Laterne | Symbol zeigt eine Papierlaterne |
| 🌼.png | Gnom mit Blume | Blüte |
| 🚬.png | Gnom mit Pfeife | Symbol zeigt eine Zigarette; Kennung für das Pfeifenmotiv |
| 🐦.png | Gnom mit Wanderstab und Vogel | Vogel |
| 🍄.png | Gnom unter einem Pilz | Pilz |
| 🍓.png | Gnom mit Erdbeere | Erdbeere |
| 🎃.png | Gnom mit Kürbis | Symbol zeigt einen Halloween-Kürbis |

Alle Bilder liegen unter `public/images/group-symbols/`.
Die Gruppenfunktion verwendet fünf Symbole je Code; Wiederholungen sind erlaubt. Bilder werden dafür nicht
umbenannt oder neu erzeugt.

## Klasse

`public/js/group-symbols.js` registriert `Wegwichtel.GroupSymbols`, beim Laden der App. Die Initialisierung des Namensraums steht als
eigene Anweisung vor der Registrierung (Korrektur für Sonar javascript:S1121).

```js
Wegwichtel.GroupSymbols.list();
Wegwichtel.GroupSymbols.get('🍓');
// { unicode: '🍓', label: 'Erdbeere', imageUrl: '/images/group-symbols/🍓.png' }
Wegwichtel.GroupSymbols.imageUrl('🍓');
Wegwichtel.GroupSymbols.has('🍓');
```

Die Liste und ihre Einträge sind eingefroren. Text-/Emoji-Präsentationsselektoren
werden beim Nachschlagen ignoriert. Unbekannte Symbole ergeben `null` bzw. `false`.
Die deutschen Namen dienen nur als Beschreibung und möglicher Alternativtext.
Tests verlangen gültige PNG-Dateien, aber keinen bestimmten Farbmodus, damit auch
RGB-PNGs als Ersatz verwendet werden können.

Prüfung: `node --test test/group-symbols.test.js`.

## Alte Dateien entfernen

Ein ZIP-Archiv entfernt beim Entpacken keine alten Dateien. Nach Übernahme können
diese acht bisher verwendeten Dateien unter `public/images/group-symbols/` gelöscht
werden, sofern sie nicht anderweitig benötigt werden:

- `🍎.png`
- `🔑.png`
- `🔔.png`
- `📘.png`
- `🌻.png`
- `☂️.png`
- `⚽.png`
- `☕.png`