@joewinke/jatui 0.35.0 → 0.36.2

package/dist/utils/mentionParser.d.ts

@@ -4,8 +4,16 @@
  * Handles parsing and rendering of @-mentions in messages.
  * Format: [@Display Name](type:id) -> clickable links
  *
- * The URL generator is configurable — consuming apps provide their own
- * routing via the `urlGenerator` parameter or by setting a default.
+ * URL routing has three layers (most specific first):
+ *   1. the `urlGenerator` parameter on a given parse/render call
+ *   2. a per-type registration — registerMentionType(type, generator) —
+ *      so each mention type carries its own routing (e.g. @agent mentions
+ *      route to /admin/settings/agent while @user routes elsewhere)
+ *   3. the single app-wide default — setMentionUrlGenerator
+ *
+ * The per-type registry is what lets a consuming app retire a local
+ * mentionParser copy (mos-i8nnd.18): one default generator cannot express
+ * per-type routing.
  */
 export interface MentionMatch {
     type: string;
@@ -17,6 +25,22 @@ export interface MentionMatch {
     fullMatch: string;
 }
 export type MentionUrlGenerator = (type: string, id: string) => string;
+/** The mention type used to reference agents (extractAgentMentions). */
+export declare const AGENT_MENTION_TYPE = "agent";
+/** Per-type registration record held by the registry. */
+export interface MentionTypeConfig {
+    urlGenerator: MentionUrlGenerator;
+}
+/**
+ * Register a URL generator for a specific mention type.
+ *
+ * Call once at app startup per routed type (e.g. registerMentionType('agent',
+ * () => '/admin/settings/agent')). Re-registering a type replaces its
+ * generator; the returned function unregisters exactly that registration.
+ * The type must be an identifier token — the mention regex only accepts
+ * `[A-Za-z0-9_-]+`, so anything else could never match a mention.
+ */
+export declare function registerMentionType(type: string, urlGenerator: MentionUrlGenerator): () => void;
 /**
  * Set the default URL generator for mentions.
  * Call this once at app startup to configure mention link routing.
@@ -73,6 +97,24 @@ export declare function replaceMentionInContent(content: string, startIndex: num
     newContent: string;
     newCursorPosition: number;
 };
+/**
+ * Extract only agent mentions (type='agent').
+ */
+export declare function extractAgentMentions(content: string): MentionMatch[];
+/**
+ * Cheap boolean check — does the content contain at least one mention?
+ */
+export declare function hasMentions(content: string): boolean;
+/**
+ * Unique ids of @user mentions, in order of first appearance.
+ * Agent mentions are separate — use extractAgentMentions.
+ */
+export declare function getMentionedUserIds(content: string): string[];
+/**
+ * Mentions deduped by type+id (first occurrence wins, appearance order
+ * preserved), optionally filtered to a single type.
+ */
+export declare function getUniqueMentionsByType(content: string, type?: string): MentionMatch[];
 /**
  * Simple HTML escape function
  */

package/dist/utils/mentionParser.js

@@ -4,9 +4,43 @@
  * Handles parsing and rendering of @-mentions in messages.
  * Format: [@Display Name](type:id) -> clickable links
  *
- * The URL generator is configurable — consuming apps provide their own
- * routing via the `urlGenerator` parameter or by setting a default.
+ * URL routing has three layers (most specific first):
+ *   1. the `urlGenerator` parameter on a given parse/render call
+ *   2. a per-type registration — registerMentionType(type, generator) —
+ *      so each mention type carries its own routing (e.g. @agent mentions
+ *      route to /admin/settings/agent while @user routes elsewhere)
+ *   3. the single app-wide default — setMentionUrlGenerator
+ *
+ * The per-type registry is what lets a consuming app retire a local
+ * mentionParser copy (mos-i8nnd.18): one default generator cannot express
+ * per-type routing.
+ */
+/** The mention type used to reference agents (extractAgentMentions). */
+export const AGENT_MENTION_TYPE = 'agent';
+// Per-type registry — populated by registerMentionType; wins over the
+// app-wide default for that type, loses to an explicit generator argument.
+const mentionTypes = new Map();
+/**
+ * Register a URL generator for a specific mention type.
+ *
+ * Call once at app startup per routed type (e.g. registerMentionType('agent',
+ * () => '/admin/settings/agent')). Re-registering a type replaces its
+ * generator; the returned function unregisters exactly that registration.
+ * The type must be an identifier token — the mention regex only accepts
+ * `[A-Za-z0-9_-]+`, so anything else could never match a mention.
  */
+export function registerMentionType(type, urlGenerator) {
+    if (!/^[A-Za-z0-9_-]+$/.test(type)) {
+        throw new TypeError(`mention type ${JSON.stringify(type)} must match /^[A-Za-z0-9_-]+$/ — ` +
+            'the mention regex only matches identifier tokens');
+    }
+    mentionTypes.set(type, { urlGenerator });
+    return () => {
+        // Only remove OUR registration — a later re-registration must survive.
+        if (mentionTypes.get(type)?.urlGenerator === urlGenerator)
+            mentionTypes.delete(type);
+    };
+}
 // Regex to match mention pattern: [@Display Name](type:id)
 //
 // `type` is an identifier token, never free text (mos-3xvn1): it lands in
@@ -28,7 +62,6 @@ export function setMentionUrlGenerator(generator) {
  */
 export function parseMentions(content, urlGenerator) {
     const mentions = [];
-    const gen = urlGenerator ?? defaultUrlGenerator;
     let match;
     MENTION_REGEX.lastIndex = 0;
     while ((match = MENTION_REGEX.exec(content)) !== null) {
@@ -37,7 +70,9 @@ export function parseMentions(content, urlGenerator) {
             type,
             id,
             displayName,
-            url: gen(type, id),
+            // Resolution: explicit call-site generator > per-type registered
+            // generator > the app-wide default.
+            url: (urlGenerator ?? mentionTypes.get(type)?.urlGenerator ?? defaultUrlGenerator)(type, id),
             startIndex: match.index,
             endIndex: match.index + fullMatch.length,
             fullMatch
@@ -147,6 +182,51 @@ export function replaceMentionInContent(content, startIndex, endIndex, mentionSt
     const newCursorPosition = startIndex + mentionString.length;
     return { newContent, newCursorPosition };
 }
+/**
+ * Extract only agent mentions (type='agent').
+ */
+export function extractAgentMentions(content) {
+    return parseMentions(content).filter((mention) => mention.type === AGENT_MENTION_TYPE);
+}
+/**
+ * Cheap boolean check — does the content contain at least one mention?
+ */
+export function hasMentions(content) {
+    MENTION_REGEX.lastIndex = 0;
+    return MENTION_REGEX.test(content);
+}
+/**
+ * Unique ids of @user mentions, in order of first appearance.
+ * Agent mentions are separate — use extractAgentMentions.
+ */
+export function getMentionedUserIds(content) {
+    const ids = [];
+    for (const mention of parseMentions(content)) {
+        if (mention.type !== 'user')
+            continue;
+        if (!ids.includes(mention.id))
+            ids.push(mention.id);
+    }
+    return ids;
+}
+/**
+ * Mentions deduped by type+id (first occurrence wins, appearance order
+ * preserved), optionally filtered to a single type.
+ */
+export function getUniqueMentionsByType(content, type) {
+    const seen = new Set();
+    const out = [];
+    for (const mention of parseMentions(content)) {
+        if (type && mention.type !== type)
+            continue;
+        const key = `${mention.type}:${mention.id}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(mention);
+    }
+    return out;
+}
 /**
  * Simple HTML escape function
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.35.0",
+  "version": "0.36.2",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",
@@ -188,6 +188,7 @@
     "lenis": "^1.3.25",
     "livekit-client": "^2.20.1",
     "motion": "^12.42.2",
+    "@playwright/test": "^1.62.1",
     "playwright": "^1.62.1",
     "svelte": "^5.0.0",
     "tailwindcss": "^4.0.0",