@tutti-os/ui-rich-text 0.0.124 → 0.0.126

package/README.md

@@ -129,6 +129,10 @@ Interpretation:
   insertion
 - `resolveMention` restores editor-only label or presentation data from the
   stored mention identity
+- readonly conversation surfaces pass the same providers to
+  `RichTextReadonlyContent.triggerProviders`; it calls `resolveMention` to
+  restore presentation such as app icons while keeping serialized Markdown
+  limited to durable identity and scope
 - group ids, labels, totals, and cursors are candidate-panel metadata only;
   they must not be copied into mention identity, href, or persisted scope
 
@@ -152,6 +156,53 @@ Markdown serialization includes only `providerId`, `entityId`, `label`, and
 short `scope` fields. It does not serialize `presentation`, `href`, `kind`,
 `version`, or arbitrary metadata.
 
+## Mention Service
+
+`RichTextMentionService` is the host-agnostic owner of provider lookup, query,
+reverse resolution, presentation caching, invalidation, and subscriptions.
+Create one service at the host or app root and reuse it across composer,
+readonly conversation, preview, and AgentGUI surfaces:
+
+```tsx
+import {
+  RichTextMentionServiceProvider,
+  RichTextReadonlyContent,
+  RichTextTriggerEditor
+} from "@tutti-os/ui-rich-text/editor";
+import { createRichTextMentionService } from "@tutti-os/ui-rich-text/service";
+
+const mentionService = createRichTextMentionService({ providers });
+
+<RichTextMentionServiceProvider service={mentionService}>
+  <RichTextTriggerEditor value={draft} onChange={setDraft} />
+  <RichTextReadonlyContent value={savedMarkdown} />
+</RichTextMentionServiceProvider>;
+
+// Dispose when the owning host/workspace root is destroyed.
+mentionService.dispose();
+```
+
+Non-React consumers use the same instance directly through `query`, `resolve`,
+`getSnapshot`, `invalidate`, and `subscribe`. The React Provider never creates
+a network client or a global singleton; it only injects an existing service.
+
+Resolution precedence is fixed: an explicit `mentionService` prop wins, then
+the nearest `RichTextMentionServiceProvider`, then the deprecated
+`triggerProviders` compatibility path. If no resolver exists, persisted label
+text and the semantic `MentionPill` icon remain available.
+
+The service uses a normalized `providerId + entityId + canonical scope` key.
+Labels and presentation URLs are deliberately excluded. Ready entries are
+cached for 5 minutes, missing entries for 30 seconds, and errors retry after 5
+seconds. The cache is capped at 1000 identities, concurrent resolution is
+single-flight, and stale ready presentation remains visible during refresh.
+Explicit invalidation may target all entries, a provider, a workspace, or an
+entity.
+
+Never persist a resolved snapshot or copy `presentation` into Markdown. Icon
+URLs and runtime cache state stay in memory; durable mention content remains
+limited to provider identity, entity identity, fallback label, and short scope.
+
 Helpers now exported:
 
 - `createRichTextMentionPlugin`
@@ -195,14 +246,18 @@ Tutti workspace apps that already receive mention candidates from
 `@tutti-os/workspace-external-core/rich-text`:
 
 ```ts
-import { createTuttiExternalAtRichTextTriggerProviders } from "@tutti-os/workspace-external-core/rich-text";
+import { createTuttiExternalRichTextMentionService } from "@tutti-os/workspace-external-core/rich-text";
 
-const providers = createTuttiExternalAtRichTextTriggerProviders({
-  bridge: window.tuttiExternal,
+const mentionService = createTuttiExternalRichTextMentionService({
+  getBridge: () => window.tuttiExternal,
   providerIds: ["workspace-app", "agent-session"]
 });
 ```
 
+The older trigger-provider factory remains available for compatibility, but a
+root-owned service is the preferred integration because editor and readonly
+surfaces share resolution, caching, and invalidation automatically.
+
 Use a custom `RichTextTriggerProvider` only for app-local mention sources or for
 apps that do not use the Tutti external bridge.
 

package/dist/RichTextMentionService-CsZ9CGQf.d.ts

@@ -0,0 +1,45 @@
+import { a as RichTextMentionIdentity, k as RichTextMentionResolved } from './mention-DJq2OJ4K.js';
+import { RichTextTriggerProvider, RichTextTriggerConfig, RichTextTriggerQueryInput, RichTextTriggerQueryMatch } from './types/index.js';
+
+declare const RICH_TEXT_MENTION_READY_TTL_MS = 300000;
+declare const RICH_TEXT_MENTION_MISSING_TTL_MS = 30000;
+declare const RICH_TEXT_MENTION_ERROR_RETRY_MS = 5000;
+declare const RICH_TEXT_MENTION_CACHE_CAPACITY = 1000;
+type RichTextMentionResolutionState = "idle" | "loading" | "ready" | "missing" | "error";
+interface RichTextMentionSnapshot {
+    state: RichTextMentionResolutionState;
+    resolved?: RichTextMentionResolved;
+    updatedAtUnixMs?: number;
+}
+interface RichTextMentionInvalidationSelector {
+    providerId?: string;
+    workspaceId?: string;
+    entityId?: string;
+}
+type RichTextMentionDiagnosticEventName = "mention_query_completed" | "mention_resolve_completed" | "mention_cache_invalidated";
+interface RichTextMentionDiagnosticEvent {
+    name: RichTextMentionDiagnosticEventName;
+    providerId: string;
+    outcome: "success" | "missing" | "error";
+    cacheStatus: "hit" | "miss" | "stale" | "invalidated";
+    durationMs: number;
+}
+interface CreateRichTextMentionServiceInput {
+    providers: readonly RichTextTriggerProvider[];
+    now?: () => number;
+    diagnostics?: (event: RichTextMentionDiagnosticEvent) => void;
+}
+interface RichTextMentionService {
+    listProviders(): readonly RichTextTriggerProvider[];
+    getProvider(providerId: string): RichTextTriggerProvider | undefined;
+    listTriggerConfigs(): readonly RichTextTriggerConfig[];
+    query(input: RichTextTriggerQueryInput): Promise<readonly RichTextTriggerQueryMatch[]>;
+    resolve(identity: RichTextMentionIdentity): Promise<RichTextMentionSnapshot>;
+    getSnapshot(identity: RichTextMentionIdentity): RichTextMentionSnapshot;
+    invalidate(selector?: RichTextMentionInvalidationSelector): void;
+    subscribe(listener: () => void, identity?: RichTextMentionIdentity): () => void;
+    dispose(): void;
+}
+declare function createRichTextMentionService(input: CreateRichTextMentionServiceInput): RichTextMentionService;
+
+export { type CreateRichTextMentionServiceInput as C, RICH_TEXT_MENTION_CACHE_CAPACITY as R, RICH_TEXT_MENTION_ERROR_RETRY_MS as a, RICH_TEXT_MENTION_MISSING_TTL_MS as b, RICH_TEXT_MENTION_READY_TTL_MS as c, type RichTextMentionDiagnosticEvent as d, type RichTextMentionDiagnosticEventName as e, type RichTextMentionInvalidationSelector as f, type RichTextMentionResolutionState as g, type RichTextMentionService as h, type RichTextMentionSnapshot as i, createRichTextMentionService as j };

package/dist/chunk-3UTSSMV7.js

@@ -0,0 +1,113 @@
+// src/plugins/triggerRegistry.ts
+function normalizeProviderId(providerId) {
+  return providerId.trim();
+}
+function normalizeProviderTrigger(provider) {
+  return provider.trigger;
+}
+function normalizeProviderBoundary(provider) {
+  return provider.boundary ?? "punctuation";
+}
+function normalizeProviderTriggerConfig(provider) {
+  return {
+    trigger: normalizeProviderTrigger(provider),
+    boundary: normalizeProviderBoundary(provider)
+  };
+}
+function normalizeOptionalIconUrl(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : void 0;
+}
+function resolveInsertResultIconUrl(insertResult) {
+  if (insertResult.kind !== "mention") {
+    return void 0;
+  }
+  return normalizeOptionalIconUrl(insertResult.mention.presentation?.iconUrl);
+}
+async function resolveItemIconUrl(provider, item, insertResult) {
+  if (provider.getItemIconUrl) {
+    try {
+      const iconUrl = normalizeOptionalIconUrl(
+        await Promise.resolve(provider.getItemIconUrl(item))
+      );
+      if (iconUrl) {
+        return iconUrl;
+      }
+    } catch {
+      return resolveInsertResultIconUrl(insertResult);
+    }
+  }
+  return resolveInsertResultIconUrl(insertResult);
+}
+function createRichTextTriggerRegistry(providers) {
+  const providerMap = /* @__PURE__ */ new Map();
+  const triggerConfigKeys = /* @__PURE__ */ new Set();
+  const triggerConfigs = [];
+  for (const provider of providers) {
+    const providerId = normalizeProviderId(provider.id);
+    if (!providerId) {
+      throw new Error("Rich text trigger provider id is required.");
+    }
+    if (providerMap.has(providerId)) {
+      throw new Error(`Duplicate rich text trigger provider id: ${providerId}`);
+    }
+    providerMap.set(providerId, provider);
+    const triggerConfig = normalizeProviderTriggerConfig(provider);
+    const triggerConfigKey = `${triggerConfig.trigger}:${triggerConfig.boundary}`;
+    if (!triggerConfigKeys.has(triggerConfigKey)) {
+      triggerConfigKeys.add(triggerConfigKey);
+      triggerConfigs.push(triggerConfig);
+    }
+  }
+  async function query(input) {
+    if (input.abortSignal?.aborted) {
+      return [];
+    }
+    const matches = await Promise.all(
+      [...providerMap.values()].filter(
+        (provider) => normalizeProviderTrigger(provider) === input.trigger
+      ).map(async (provider) => {
+        if (input.abortSignal?.aborted) {
+          return [];
+        }
+        const items = await provider.query(input);
+        if (input.abortSignal?.aborted) {
+          return [];
+        }
+        return Promise.all(
+          items.map(async (item) => {
+            const insertResult = provider.toInsertResult(item);
+            return {
+              providerId: provider.id,
+              trigger: input.trigger,
+              key: provider.getItemKey(item),
+              label: provider.getItemLabel(item),
+              subtitle: provider.getItemSubtitle?.(item) || void 0,
+              iconUrl: await resolveItemIconUrl(provider, item, insertResult),
+              keywords: provider.getItemKeywords?.(item),
+              item,
+              insertResult
+            };
+          })
+        );
+      })
+    );
+    const flatMatches = matches.flat();
+    const limit = input.maxResults;
+    if (typeof limit === "number" && limit >= 0) {
+      return flatMatches.slice(0, limit);
+    }
+    return flatMatches;
+  }
+  return {
+    listProviders: () => [...providerMap.values()],
+    getProvider: (providerId) => providerMap.get(normalizeProviderId(providerId)),
+    listTriggerConfigs: () => [...triggerConfigs],
+    query
+  };
+}
+
+export {
+  createRichTextTriggerRegistry
+};
+//# sourceMappingURL=chunk-3UTSSMV7.js.map

package/dist/chunk-3UTSSMV7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/triggerRegistry.ts"],"sourcesContent":["import type {\n  RichTextTrigger,\n  RichTextTriggerBoundary,\n  RichTextTriggerConfig,\n  RichTextTriggerInsertResult,\n  RichTextTriggerProvider,\n  RichTextTriggerQueryInput,\n  RichTextTriggerQueryMatch,\n  RichTextTriggerRegistry\n} from \"../types/trigger.ts\";\n\nfunction normalizeProviderId(providerId: string): string {\n  return providerId.trim();\n}\n\nfunction normalizeProviderTrigger(\n  provider: RichTextTriggerProvider\n): RichTextTrigger {\n  return provider.trigger;\n}\n\nfunction normalizeProviderBoundary(\n  provider: RichTextTriggerProvider\n): RichTextTriggerBoundary {\n  return provider.boundary ?? \"punctuation\";\n}\n\nfunction normalizeProviderTriggerConfig(\n  provider: RichTextTriggerProvider\n): RichTextTriggerConfig {\n  return {\n    trigger: normalizeProviderTrigger(provider),\n    boundary: normalizeProviderBoundary(provider)\n  };\n}\n\nfunction normalizeOptionalIconUrl(\n  value: string | null | undefined\n): string | undefined {\n  const trimmed = value?.trim();\n  return trimmed ? trimmed : undefined;\n}\n\nfunction resolveInsertResultIconUrl(\n  insertResult: RichTextTriggerInsertResult\n): string | undefined {\n  if (insertResult.kind !== \"mention\") {\n    return undefined;\n  }\n  return normalizeOptionalIconUrl(insertResult.mention.presentation?.iconUrl);\n}\n\nasync function resolveItemIconUrl<TItem>(\n  provider: RichTextTriggerProvider<TItem>,\n  item: TItem,\n  insertResult: RichTextTriggerInsertResult\n): Promise<string | undefined> {\n  if (provider.getItemIconUrl) {\n    try {\n      const iconUrl = normalizeOptionalIconUrl(\n        await Promise.resolve(provider.getItemIconUrl(item))\n      );\n      if (iconUrl) {\n        return iconUrl;\n      }\n    } catch {\n      return resolveInsertResultIconUrl(insertResult);\n    }\n  }\n  return resolveInsertResultIconUrl(insertResult);\n}\n\nexport function createRichTextTriggerRegistry(\n  providers: readonly RichTextTriggerProvider[]\n): RichTextTriggerRegistry {\n  const providerMap = new Map<string, RichTextTriggerProvider>();\n  const triggerConfigKeys = new Set<string>();\n  const triggerConfigs: RichTextTriggerConfig[] = [];\n\n  for (const provider of providers) {\n    const providerId = normalizeProviderId(provider.id);\n    if (!providerId) {\n      throw new Error(\"Rich text trigger provider id is required.\");\n    }\n    if (providerMap.has(providerId)) {\n      throw new Error(`Duplicate rich text trigger provider id: ${providerId}`);\n    }\n    providerMap.set(providerId, provider);\n    const triggerConfig = normalizeProviderTriggerConfig(provider);\n    const triggerConfigKey = `${triggerConfig.trigger}:${triggerConfig.boundary}`;\n    if (!triggerConfigKeys.has(triggerConfigKey)) {\n      triggerConfigKeys.add(triggerConfigKey);\n      triggerConfigs.push(triggerConfig);\n    }\n  }\n\n  async function query(\n    input: RichTextTriggerQueryInput\n  ): Promise<readonly RichTextTriggerQueryMatch[]> {\n    if (input.abortSignal?.aborted) {\n      return [];\n    }\n\n    const matches = await Promise.all(\n      [...providerMap.values()]\n        .filter(\n          (provider) => normalizeProviderTrigger(provider) === input.trigger\n        )\n        .map(async (provider) => {\n          if (input.abortSignal?.aborted) {\n            return [];\n          }\n          const items = await provider.query(input);\n          if (input.abortSignal?.aborted) {\n            return [];\n          }\n          return Promise.all(\n            items.map(async (item) => {\n              const insertResult = provider.toInsertResult(item);\n              return {\n                providerId: provider.id,\n                trigger: input.trigger,\n                key: provider.getItemKey(item),\n                label: provider.getItemLabel(item),\n                subtitle: provider.getItemSubtitle?.(item) || undefined,\n                iconUrl: await resolveItemIconUrl(provider, item, insertResult),\n                keywords: provider.getItemKeywords?.(item),\n                item,\n                insertResult\n              };\n            })\n          );\n        })\n    );\n\n    const flatMatches = matches.flat();\n    const limit = input.maxResults;\n    if (typeof limit === \"number\" && limit >= 0) {\n      return flatMatches.slice(0, limit);\n    }\n    return flatMatches;\n  }\n\n  return {\n    listProviders: () => [...providerMap.values()],\n    getProvider: (providerId: string) =>\n      providerMap.get(normalizeProviderId(providerId)),\n    listTriggerConfigs: () => [...triggerConfigs],\n    query\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-RUX5KKX3.js → chunk-CLNWVUDR.js}

@@ -169,115 +169,6 @@ function createRichTextTriggerProvider(provider) {
   };
 }
 
-// src/plugins/triggerRegistry.ts
-function normalizeProviderId(providerId) {
-  return providerId.trim();
-}
-function normalizeProviderTrigger(provider) {
-  return provider.trigger;
-}
-function normalizeProviderBoundary(provider) {
-  return provider.boundary ?? "punctuation";
-}
-function normalizeProviderTriggerConfig(provider) {
-  return {
-    trigger: normalizeProviderTrigger(provider),
-    boundary: normalizeProviderBoundary(provider)
-  };
-}
-function normalizeOptionalIconUrl(value) {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : void 0;
-}
-function resolveInsertResultIconUrl(insertResult) {
-  if (insertResult.kind !== "mention") {
-    return void 0;
-  }
-  return normalizeOptionalIconUrl(insertResult.mention.presentation?.iconUrl);
-}
-async function resolveItemIconUrl(provider, item, insertResult) {
-  if (provider.getItemIconUrl) {
-    try {
-      const iconUrl = normalizeOptionalIconUrl(
-        await Promise.resolve(provider.getItemIconUrl(item))
-      );
-      if (iconUrl) {
-        return iconUrl;
-      }
-    } catch {
-      return resolveInsertResultIconUrl(insertResult);
-    }
-  }
-  return resolveInsertResultIconUrl(insertResult);
-}
-function createRichTextTriggerRegistry(providers) {
-  const providerMap = /* @__PURE__ */ new Map();
-  const triggerConfigKeys = /* @__PURE__ */ new Set();
-  const triggerConfigs = [];
-  for (const provider of providers) {
-    const providerId = normalizeProviderId(provider.id);
-    if (!providerId) {
-      throw new Error("Rich text trigger provider id is required.");
-    }
-    if (providerMap.has(providerId)) {
-      throw new Error(`Duplicate rich text trigger provider id: ${providerId}`);
-    }
-    providerMap.set(providerId, provider);
-    const triggerConfig = normalizeProviderTriggerConfig(provider);
-    const triggerConfigKey = `${triggerConfig.trigger}:${triggerConfig.boundary}`;
-    if (!triggerConfigKeys.has(triggerConfigKey)) {
-      triggerConfigKeys.add(triggerConfigKey);
-      triggerConfigs.push(triggerConfig);
-    }
-  }
-  async function query(input) {
-    if (input.abortSignal?.aborted) {
-      return [];
-    }
-    const matches = await Promise.all(
-      [...providerMap.values()].filter(
-        (provider) => normalizeProviderTrigger(provider) === input.trigger
-      ).map(async (provider) => {
-        if (input.abortSignal?.aborted) {
-          return [];
-        }
-        const items = await provider.query(input);
-        if (input.abortSignal?.aborted) {
-          return [];
-        }
-        return Promise.all(
-          items.map(async (item) => {
-            const insertResult = provider.toInsertResult(item);
-            return {
-              providerId: provider.id,
-              trigger: input.trigger,
-              key: provider.getItemKey(item),
-              label: provider.getItemLabel(item),
-              subtitle: provider.getItemSubtitle?.(item) || void 0,
-              iconUrl: await resolveItemIconUrl(provider, item, insertResult),
-              keywords: provider.getItemKeywords?.(item),
-              item,
-              insertResult
-            };
-          })
-        );
-      })
-    );
-    const flatMatches = matches.flat();
-    const limit = input.maxResults;
-    if (typeof limit === "number" && limit >= 0) {
-      return flatMatches.slice(0, limit);
-    }
-    return flatMatches;
-  }
-  return {
-    listProviders: () => [...providerMap.values()],
-    getProvider: (providerId) => providerMap.get(normalizeProviderId(providerId)),
-    listTriggerConfigs: () => [...triggerConfigs],
-    query
-  };
-}
-
 // src/plugins/mentionRegistry.ts
 function normalizePluginId(pluginId) {
   return pluginId.trim();
@@ -352,7 +243,6 @@ export {
   createRichTextMentionInsertResult,
   renderRichTextTriggerInsertResult,
   createRichTextTriggerProvider,
-  createRichTextTriggerRegistry,
   createRichTextMentionRegistry
 };
-//# sourceMappingURL=chunk-RUX5KKX3.js.map
+//# sourceMappingURL=chunk-CLNWVUDR.js.map

package/dist/chunk-CLNWVUDR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/mention.ts","../src/plugins/trigger.ts","../src/plugins/mentionRegistry.ts"],"sourcesContent":["import type {\n  RichTextMentionAttrs,\n  RichTextMentionInsert,\n  RichTextMentionPresentation,\n  RichTextMentionPlugin,\n  RichTextResolvedMention,\n  RichTextResolvedMentionView\n} from \"../types/mention.ts\";\n\nconst richTextMentionTrigger = \"@\";\n\nfunction normalizeOptionalString(value?: string | null): string | undefined {\n  const trimmed = value?.trim();\n  return trimmed ? trimmed : undefined;\n}\n\nfunction normalizeMentionLabel(value: string): string {\n  return value.trim().replace(/^@+/, \"\").trim();\n}\n\nfunction normalizeStringRecord(\n  values?: Readonly<Record<string, string>> | null\n): Readonly<Record<string, string>> | undefined {\n  if (!values) {\n    return undefined;\n  }\n\n  const nextEntries = Object.entries(values)\n    .map(([key, value]) => [key.trim(), value.trim()] as const)\n    .filter(([key, value]) => key.length > 0 && value.length > 0);\n\n  if (nextEntries.length === 0) {\n    return undefined;\n  }\n\n  return Object.freeze(Object.fromEntries(nextEntries));\n}\n\nfunction normalizeMentionPresentation(\n  presentation?: RichTextMentionPresentation | null\n): RichTextMentionPresentation | undefined {\n  if (!presentation) {\n    return undefined;\n  }\n\n  const normalized: RichTextMentionPresentation = {};\n  for (const key of richTextMentionPresentationKeys) {\n    const value = normalizeOptionalString(presentation[key]);\n    if (value) {\n      normalized[key] = value;\n    }\n  }\n\n  return Object.keys(normalized).length > 0\n    ? Object.freeze(normalized)\n    : undefined;\n}\n\nconst richTextMentionPresentationKeys = [\n  \"agentProviderId\",\n  \"agentIconUrl\",\n  \"iconUrl\",\n  \"thumbnailUrl\",\n  \"subtitle\",\n  \"description\",\n  \"participant\",\n  \"status\",\n  \"statusDataStatus\",\n  \"statusLabel\",\n  \"statusPulse\",\n  \"userAvatarPlaceholderUrl\"\n] as const satisfies readonly (keyof RichTextMentionPresentation)[];\n\nexport function createRichTextMentionAttrs(\n  providerId: string,\n  mention: RichTextMentionInsert\n): RichTextMentionAttrs {\n  const normalizedProviderId = providerId.trim();\n  const entityId = mention.entityId.trim();\n  const label = normalizeMentionLabel(mention.label);\n\n  if (!normalizedProviderId) {\n    throw new Error(\"Rich text mention provider id is required.\");\n  }\n  if (!entityId) {\n    throw new Error(\"Rich text mention entityId is required.\");\n  }\n  if (!label) {\n    throw new Error(\"Rich text mention label is required.\");\n  }\n\n  const attrs: RichTextMentionAttrs = {\n    trigger: richTextMentionTrigger,\n    providerId: normalizedProviderId,\n    entityId,\n    label\n  };\n  const scope = normalizeStringRecord(mention.scope);\n  const presentation = normalizeMentionPresentation(mention.presentation);\n  if (scope) {\n    attrs.scope = scope;\n  }\n  if (presentation) {\n    attrs.presentation = presentation;\n  }\n  return attrs;\n}\n\nexport function isRichTextMentionAttrs(\n  value: unknown\n): value is RichTextMentionAttrs {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n\n  const candidate = value as Partial<RichTextMentionAttrs>;\n  return (\n    candidate.trigger === richTextMentionTrigger &&\n    typeof candidate.providerId === \"string\" &&\n    candidate.providerId.trim().length > 0 &&\n    typeof candidate.entityId === \"string\" &&\n    candidate.entityId.trim().length > 0 &&\n    typeof candidate.label === \"string\" &&\n    candidate.label.trim().length > 0\n  );\n}\n\nexport function getRichTextMentionDisplayText(\n  attrs: RichTextMentionAttrs\n): string {\n  const label = normalizeMentionLabel(attrs.label);\n  return label ? `@${label}` : \"\";\n}\n\nexport function resolveRichTextMentionView(\n  mention: RichTextMentionAttrs,\n  resolved?: RichTextResolvedMention | null\n): RichTextResolvedMentionView {\n  const state = resolved?.state ?? \"active\";\n  const label = normalizeMentionLabel(resolved?.label ?? mention.label);\n  const tooltip = normalizeOptionalString(resolved?.tooltip);\n\n  return {\n    state,\n    label,\n    tooltip,\n    presentation: normalizeMentionPresentation(\n      resolved?.presentation ?? mention.presentation\n    ),\n    entity: resolved?.entity,\n    interactive: state === \"active\"\n  };\n}\n\nexport function createRichTextMentionPlugin<TItem, TResolved = unknown>(\n  plugin: RichTextMentionPlugin<TItem, TResolved>\n): RichTextMentionPlugin<TItem, TResolved> {\n  const id = plugin.id.trim();\n  if (!id) {\n    throw new Error(\"Rich text mention plugin id is required.\");\n  }\n\n  return {\n    ...plugin,\n    id,\n    trigger: richTextMentionTrigger\n  };\n}\n","import { createRichTextMentionAttrs } from \"./mention.ts\";\nimport {\n  createRichTextMentionMarkdown,\n  createRichTextLinkMarkdown\n} from \"../core/richTextDocument.ts\";\nimport type {\n  RichTextTriggerProvider,\n  RichTextMarkdownLinkInsertResult,\n  RichTextMentionTriggerInsertResult,\n  RichTextTriggerInsertResult,\n  RichTextTextInsertResult\n} from \"../types/trigger.ts\";\n\nfunction normalizeRequiredString(value: string, fieldName: string): string {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    throw new Error(`Rich text ${fieldName} is required.`);\n  }\n  return trimmed;\n}\n\nexport function createRichTextTextInsertResult(\n  text: string\n): RichTextTextInsertResult {\n  return {\n    kind: \"text\",\n    text\n  };\n}\n\nexport function createRichTextMarkdownLinkInsertResult(\n  label: string,\n  href: string\n): RichTextMarkdownLinkInsertResult {\n  return {\n    kind: \"markdown-link\",\n    label: normalizeRequiredString(label, \"insert label\"),\n    href: normalizeRequiredString(href, \"insert href\")\n  };\n}\n\nexport function createRichTextMentionInsertResult(\n  mention: RichTextMentionTriggerInsertResult[\"mention\"]\n): RichTextMentionTriggerInsertResult {\n  return {\n    kind: \"mention\",\n    mention\n  };\n}\n\nexport function renderRichTextTriggerInsertResult(\n  providerId: string,\n  result: RichTextTriggerInsertResult\n): string {\n  switch (result.kind) {\n    case \"mention\":\n      return createRichTextMentionMarkdown(\n        createRichTextMentionAttrs(providerId, result.mention)\n      );\n    case \"markdown-link\":\n      return createRichTextLinkMarkdown({\n        name: result.label,\n        path: result.href,\n        kind: result.href.endsWith(\"/\") ? \"folder\" : \"file\"\n      });\n    case \"text\":\n      return result.text;\n    default:\n      return \"\";\n  }\n}\n\nexport function createRichTextTriggerProvider<TItem>(\n  provider: RichTextTriggerProvider<TItem>\n): RichTextTriggerProvider<TItem> {\n  const id = normalizeRequiredString(provider.id, \"provider id\");\n\n  return {\n    ...provider,\n    id\n  };\n}\n","import {\n  createRichTextMentionAttrs,\n  resolveRichTextMentionView\n} from \"./mention.ts\";\nimport type {\n  RichTextMentionPlugin,\n  RichTextMentionQueryInput,\n  RichTextMentionQueryMatch,\n  RichTextMentionRegistry,\n  RichTextMentionResolveInput,\n  RichTextResolvedMentionView\n} from \"../types/mention.ts\";\n\nfunction normalizePluginId(pluginId: string): string {\n  return pluginId.trim();\n}\n\nexport function createRichTextMentionRegistry(\n  plugins: readonly RichTextMentionPlugin[]\n): RichTextMentionRegistry {\n  const pluginMap = new Map<string, RichTextMentionPlugin>();\n\n  for (const plugin of plugins) {\n    const pluginId = normalizePluginId(plugin.id);\n    if (!pluginId) {\n      throw new Error(\"Rich text mention plugin id is required.\");\n    }\n    if (pluginMap.has(pluginId)) {\n      throw new Error(`Duplicate rich text mention plugin id: ${pluginId}`);\n    }\n    pluginMap.set(pluginId, plugin);\n  }\n\n  async function query(\n    input: RichTextMentionQueryInput\n  ): Promise<readonly RichTextMentionQueryMatch[]> {\n    const matches = await Promise.all(\n      [...pluginMap.values()].map(async (plugin) => {\n        const items = await plugin.query(input);\n        return items.map<RichTextMentionQueryMatch>((item) => ({\n          pluginId: plugin.id,\n          key: plugin.getItemKey(item),\n          label: plugin.getItemLabel(item),\n          subtitle: plugin.getItemSubtitle?.(item) || undefined,\n          keywords: plugin.getItemKeywords?.(item),\n          item,\n          mention: createRichTextMentionAttrs(plugin.id, plugin.toMention(item))\n        }));\n      })\n    );\n\n    const flatMatches = matches.flat();\n    const limit = input.maxResults;\n    if (typeof limit === \"number\" && limit >= 0) {\n      return flatMatches.slice(0, limit);\n    }\n    return flatMatches;\n  }\n\n  async function resolve(\n    input: RichTextMentionResolveInput\n  ): Promise<RichTextResolvedMentionView> {\n    const plugin = pluginMap.get(input.mention.providerId);\n    if (!plugin) {\n      return resolveRichTextMentionView(input.mention, {\n        state: \"missing\"\n      });\n    }\n\n    if (!plugin.resolveMention) {\n      return resolveRichTextMentionView(input.mention, {\n        state: \"active\"\n      });\n    }\n\n    return resolveRichTextMentionView(\n      input.mention,\n      await plugin.resolveMention(input)\n    );\n  }\n\n  return {\n    listPlugins: () => [...pluginMap.values()],\n    getPlugin: (pluginId: string) => pluginMap.get(normalizePluginId(pluginId)),\n    query,\n    resolve\n  };\n}\n"],"mappings":"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","names":[]}