/* ===================================================================== WER IST MIT "@" GEMEINT? (20.09.2026) Filipe: "ich will das man die leute mit @ markieren kann im chat." --------------------------------------------------------------------- WARUM DAS EINE EIGENE DATEI IST Die Auflösung "Text -> Menschen" wird an DREI Stellen gebraucht und muss überall dasselbe ergeben: 1. beim Schreiben -- wer bekommt eine Benachrichtigung, 2. im Browser -- welcher Teil des Satzes wird hervorgehoben, 3. in der Prüfung -- ohne dafür einen Server hochzufahren. Stünde sie in workspace-chat.js, müsste die Prüfung die halbe Anwendung laden, um einen Satz zu zerlegen. Und der Browser hätte ohnehin eine zweite, eigene Fassung -- also genau die Stelle, an der zwei Rechnungen irgendwann auseinanderlaufen und die Seite jemanden farbig hervorhebt, den der Server nie benachrichtigt hat. DIE DATEI HAT DESHALB KEINE ABHÄNGIGKEITEN. Kein Datenbankzugriff, kein Import. Herein kommt ein Text und eine Liste von Menschen, heraus kommt, wer gemeint ist. Der Browser bekommt dieselbe Logik in `chat.js` -- bewusst als kurze, gleichlautende Fassung, die pruef-erwaehnung.mjs Zeile für Zeile gegen diese hier prüft. --------------------------------------------------------------------- DIE REGELN, UND WARUM JEDE EINZELNE NÖTIG IST (1) NUR WER IM RAUM IST. "@Marina" in einem Gespräch, in dem Marina nicht sitzt, ist kein Ansprechen, sondern ein Wort über sie. Sie bekäme sonst eine Meldung zu einem Gespräch, das sie nicht öffnen darf -- eine Benachrichtigung, die auf eine verschlossene Tür führt. (2) DAS ZEICHEN DAVOR DARF KEIN BUCHSTABE UND KEINE ZIFFER SEIN. Ohne diese Regel wird aus "filipe@dogfather-universe.com" ein Ansprechen von Dogfather -- jede E-Mail-Adresse im Chat würde jemanden anpiepsen. Gemessen an einer echten Adresse, siehe Prüfung. (3) DAS ZEICHEN DANACH DARF KEIN BUCHSTABE UND KEINE ZIFFER SEIN. Sonst wäre "@Tili" in "@Tilikum" enthalten. Satzzeichen dagegen schon: "@Tili, kannst du?" und "@Tili!" sind normale Sätze. (4) DER LÄNGSTE PASSENDE NAME GEWINNT. Gäbe es "Van" und "VanVan", träfe die kurze Fassung zuerst und ließe "Van" stehen. Heute hat niemand einen Namen, der im Namen eines anderen steckt -- aber das ist eine Tatsache von heute, kein Gesetz, und sie ändert sich mit dem nächsten Zugang. (5) GROSS UND KLEIN EGAL. Wer "@vanvan" tippt, meint VanVan. Auf einer Handytastatur entscheidet die Autokorrektur mit, nicht der Mensch. (6) JEDE PERSON HÖCHSTENS EINMAL. Dreimal "@Anna" in einem Satz ist trotzdem eine Ansprache. --------------------------------------------------------------------- WAS ES BEWUSST NICHT GIBT KEIN "@alle". Es wäre in fünf Minuten gebaut und ist der zuverlässigste Weg, dass alle die Benachrichtigungen abschalten -- und dann kommt auch die an, die wirklich für einen bestimmten Menschen gedacht war. Wenn Filipe es ausdrücklich will, gehört dazu eine Entscheidung, WER es benutzen darf; das ist eine Frage an ihn, keine, die ich hier beantworte. AUFRUF (auch aus einer Prüfung heraus): import { erwaehnungenFinden } from "./chat-erwaehnung.js"; ===================================================================== */ /** Ein Zeichen, das einen Namen fortsetzen könnte. * * BUCHSTABE ODER ZIFFER, und zwar auch mit Umlaut oder Akzent: * `\p{L}` statt `[a-z]`. Mit `[a-zA-Z0-9]` wäre "@Jose" in "@José" * ein Treffer gewesen -- das "é" hätte als Grenze gezählt. */ const WORTZEICHEN = /[\p{L}\p{N}_]/u; /** Steht an dieser Stelle ein Wortzeichen? * Außerhalb des Textes (Anfang/Ende) ist die Antwort NEIN -- ein * Satzanfang ist eine Grenze wie jede andere. */ function wortzeichenBei(text, i) { if (i < 0 || i >= text.length) return false; return WORTZEICHEN.test(text[i]); } /** * Wer ist in diesem Text mit "@" angesprochen? * * @param {string} text Die geschriebene Nachricht. * @param {Array<{id:number,name:string}>} leute * Die Teilnehmer DIESES Raums. Wer nicht darin steht, kann * nicht gemeint sein -- siehe Regel (1) oben. * @returns {Array<{id:number, name:string, von:number, bis:number}>} * Je Treffer die Person und die Stelle im Text (`von` bis * `bis`, ohne das "@"-Zeichen gerechnet wie `slice`). Die * Stellen braucht der Browser zum Hervorheben; der Server * benutzt nur `id`. Sortiert nach Vorkommen im Text. */ export function erwaehnungenFinden(text, leute) { const satz = String(text || ""); if (!satz.includes("@")) return []; /* REGEL (4): der längste Name zuerst. Einmal sortiert statt bei jedem Treffer neu -- und auf einer Kopie, damit die Liste des Aufrufers unberührt bleibt. */ const nachLaenge = (Array.isArray(leute) ? leute.slice() : []) .filter((p) => p && p.id != null && String(p.name || "").trim()) .sort((a, b) => String(b.name).length - String(a.name).length); if (!nachLaenge.length) return []; const klein = satz.toLowerCase(); const treffer = []; const schonDa = new Set(); // Regel (6) for (let i = klein.indexOf("@"); i !== -1; i = klein.indexOf("@", i + 1)) { /* REGEL (2): Was steht vor dem "@"? */ if (wortzeichenBei(satz, i - 1)) continue; for (const person of nachLaenge) { const name = String(person.name); const nk = name.toLowerCase(); if (!klein.startsWith(nk, i + 1)) continue; /* REGEL (3): Was steht hinter dem Namen? */ if (wortzeichenBei(satz, i + 1 + name.length)) continue; /* Die Stelle wird IMMER gemeldet, auch wenn dieselbe Person schon einmal vorkam: Der Browser soll jedes "@Anna" im Satz hervorheben, nicht nur das erste. Nur die ID-Liste für die Benachrichtigung wird entdoppelt -- das macht `ideeVon()` weiter unten. */ treffer.push({ id: person.id, name, von: i, bis: i + 1 + name.length }); schonDa.add(person.id); break; // Regel (4): der Längste hat gewonnen } } return treffer; } /** * Nur die Personennummern, jede einmal -- das, was der Server zum * Benachrichtigen braucht. * * ALS EIGENE FUNKTION, damit an der Aufrufstelle nicht steht * `[...new Set(x.map(t => t.id))]`. Diese Zeile wäre an drei Orten * gleich zu schreiben, und an einem davon irgendwann anders. */ export function erwaehnteIds(text, leute) { return [...new Set(erwaehnungenFinden(text, leute).map((t) => t.id))]; }