@openmarket/rooms-client 0.1.0

package/src/shared/mentions.ts

@@ -0,0 +1,32 @@
+// The ONE @mention matcher, shared by armed-mode triggers, the TUI keyword
+// bell, and the GUI's mention rendering: what highlights is exactly what
+// triggers. Pure and browser-safe.
+
+export function normalizeHandle(value: string | undefined): string {
+  return (value || "").trim().replace(/^@/, "");
+}
+
+/** True when `text` explicitly @mentions `handle` as a real token (never a
+ *  bare substring: short handles like "may" must not fire inside words). */
+export function mentionsHandleExplicit(text: string | undefined, handle: string): boolean {
+  if (!text) return false;
+  const h = normalizeHandle(handle).toLowerCase();
+  if (h.length === 0) return false;
+  const pattern = new RegExp(`(?<![a-z0-9_@-])@${escapeRegExp(h)}(?![a-z0-9_-])`, "i");
+  return pattern.test(text);
+}
+
+/** All @handle tokens in `text` (lowercased, deduped, without the @). */
+export function extractMentionHandles(text: string | undefined): string[] {
+  if (!text) return [];
+  const found = new Set<string>();
+  for (const match of text.matchAll(/(?<![a-z0-9_@-])@([a-z0-9_][a-z0-9_.-]{0,63})/gi)) {
+    const handle = match[1]?.toLowerCase();
+    if (handle) found.add(handle);
+  }
+  return [...found];
+}
+
+function escapeRegExp(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}