@seed-ship/mcp-ui-solid 5.5.1 → 5.7.0

package/dist/components/UIResourceRenderer.d.ts

@@ -57,7 +57,42 @@ export interface UIResourceRendererProps {
  * v4.3.8
  */
 export declare function highlightQuery(html: string, query: string): string;
-export declare function renderCellValue(value: any): string;
+/**
+ * Citation context — opt-in input to `renderCellValue` (v5.7.0).
+ *
+ * When passed, `[N]`, `Citation [N]`, `[CITATION N]` and `[📄 CITATION N]`
+ * markers in the cell text are normalized then replaced with chip HTML.
+ * Chips carry `data-citation-page`, `data-citation-doc`, and
+ * `data-citation-verified` attributes (already in the DOMPurify whitelist
+ * since v5.6.0) so a host's `target.closest('[data-citation-page]')`
+ * delegated click handler routes the click to the source-doc panel.
+ *
+ * See `mcp-ui-solid/docs/briefs/BRIEF-citations-in-table-cells.md`.
+ */
+export interface CitationCtx {
+    /**
+     * `Record<id, mapping>` keyed by the citation marker number (string-keyed
+     * because JSON serialization always produces strings; the runtime call
+     * sites accept either number or string ids and normalize internally).
+     */
+    map: Record<string | number, {
+        page: number | string;
+        file?: string;
+        file_id?: number | string;
+    }>;
+    /**
+     * Optional override returning sanitized chip HTML for one marker. Wins
+     * over the default `defaultCitationChip` shape. Function inputs are
+     * intentionally `any`-loose so consumers can swap shapes (e.g. web
+     * citations vs doc citations) without subtyping the entry shape here.
+     */
+    render?: (id: number, mapping: {
+        page: number | string;
+        file?: string;
+        file_id?: number | string;
+    } | undefined) => string;
+}
+export declare function renderCellValue(value: any, citationCtx?: CitationCtx): string;
 /**
  * Main UIResourceRenderer component
  */

package/dist/components/UIResourceRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UIResourceRenderer.d.ts","sourceRoot":"","sources":["../../src/components/UIResourceRenderer.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAA8D,MAAM,UAAU,CAAA;AAEhG,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAA0B,MAAM,UAAU,CAAA;AAK5F;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAA;AA8DpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAExC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAA;CAChC;AAiJD;;GAEG;AACH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYlE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CA4ElD;AA2iCD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,uBAAuB,CA6GjE,CAAA"}
+{"version":3,"file":"UIResourceRenderer.d.ts","sourceRoot":"","sources":["../../src/components/UIResourceRenderer.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAyE,MAAM,UAAU,CAAA;AAE3G,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAA0B,MAAM,UAAU,CAAA;AAM5F;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAA;AA8DpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAExC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAA;CAChC;AAiJD;;GAEG;AACH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAYlE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAA;IACjG;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CACP,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,SAAS,KACrF,MAAM,CAAA;CACZ;AA8DD,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CAkG7E;AA8nCD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,uBAAuB,CA6GjE,CAAA"}

package/dist/components/UIResourceRenderer.js

@@ -1,9 +1,10 @@
 import { delegateEvents, createComponent, getNextElement, template, getNextMarker, insert, effect, style, className, setProperty, setAttribute, runHydrationEvents, memo, isServer, use, addEventListener, classList, setStyleProperty } from "solid-js/web";
 import purify from "../node_modules/.pnpm/dompurify@3.4.1/node_modules/dompurify/dist/purify.es.js";
-import { createMemo, For, Show, onMount, createSignal, createEffect } from "solid-js";
+import { createMemo, For, Show, onMount, onCleanup, createSignal, createEffect } from "solid-js";
 import { validateComponent, getIframeSandbox, DEFAULT_RESOURCE_LIMITS } from "../services/validation.js";
 import { GenerativeUIErrorBoundary } from "./GenerativeUIErrorBoundary.js";
-import { markRenderStart, markRenderEnd } from "../utils/perf.js";
+import { markRenderStart, markRenderEnd, PERF_PREFIX } from "../utils/perf.js";
+import { useTelemetry } from "../context/MCPUITelemetryContext.js";
 import { GridRenderer } from "./GridRenderer.js";
 import { FooterRenderer } from "./FooterRenderer.js";
 import { CarouselRenderer } from "./CarouselRenderer.js";
@@ -218,7 +219,27 @@ function highlightQuery(html, query) {
     return text.replace(regex, '<mark class="bg-yellow-200 dark:bg-[#222F49] text-inherit rounded px-0.5">$1</mark>');
   });
 }
-function renderCellValue(value) {
+function defaultCitationChip(pageNum, fileName, verified = true) {
+  const safeDocName = encodeURIComponent(fileName || "");
+  const label = fileName ? `${fileName} - ${pageNum}` : `${pageNum}`;
+  if (!verified) {
+    return `<span class="citation-ref inline-flex items-center gap-0.5 align-middle opacity-60"><span class="text-gray-500 line-through">[${label}]</span></span>`;
+  }
+  return ['<span class="citation-ref inline-flex items-center gap-0.5 align-middle">', `<span class="text-gray-500">[${label}]</span>`, '<button class="inline-flex items-center ml-0.5 px-1 py-0.5 text-xs bg-gray-800 hover:bg-gray-700 border border-gray-600 hover:border-teal-500 rounded cursor-pointer transition-colors align-middle"', ` data-citation-page="${pageNum}"`, ` data-citation-doc="${safeDocName}"`, ' data-citation-verified="true"', ` title="View source - ${label}">`, '<svg class="w-3 h-3" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>', "</button>", "</span>"].join("");
+}
+function transformCellCitations(text, ctx) {
+  let out = text.replace(new RegExp("(?<![p.])\\[(\\d{1,2})\\](?!\\()", "g"), "[📄 CITATION $1]");
+  out = out.replace(/\bCitations?\s*\[(\d+)\]/gi, "[📄 CITATION $1]");
+  out = out.replace(/\[CITATION\s+(\d+)\]/gi, "[📄 CITATION $1]");
+  return out.replace(/[【[]\s*📄\s*CITATION\s*(\d+)\s*[】\]]/gi, (_m, idStr) => {
+    const id = parseInt(idStr, 10);
+    const mapping = ctx.map[id] ?? ctx.map[String(id)];
+    if (ctx.render) return ctx.render(id, mapping);
+    if (mapping) return defaultCitationChip(mapping.page, mapping.file ?? "", true);
+    return Object.keys(ctx.map).length > 0 ? "" : `[réf. ${id}]`;
+  });
+}
+function renderCellValue(value, citationCtx) {
   if (value === null || value === void 0) {
     return "-";
   }
@@ -254,20 +275,25 @@ function renderCellValue(value) {
       ADD_ATTR: ["target", "rel"]
     });
   }
-  const hasHtml = /<[a-z][\s\S]*>/i.test(strValue);
-  if (hasHtml) {
-    return purify.sanitize(strValue, {
-      ALLOWED_TAGS: ["a", "strong", "em", "b", "i", "code", "span", "br", "button", "svg", "path"],
-      ALLOWED_ATTR: ["href", "target", "rel", "class", "data-citation-page", "data-citation-source", "data-citation-doc", "data-citation-verified", "title", "fill", "stroke", "viewBox", "stroke-linecap", "stroke-linejoin", "stroke-width", "d"],
-      ADD_ATTR: ["target", "rel"]
-    });
+  if (citationCtx) {
+    strValue = transformCellCitations(strValue, citationCtx);
   }
-  const hasMarkdown = /[*_`[\]#]/.test(strValue);
+  const hasMarkdown = /[*_`#]/.test(strValue);
   if (hasMarkdown) {
     const parsed = k.parse(strValue, {
       async: false
     });
     return purify.sanitize(parsed, {
+      ALLOWED_TAGS: ["a", "strong", "em", "b", "i", "code", "span", "br", "button", "svg", "path", "p", "ul", "ol", "li", "pre", "blockquote", "h1", "h2", "h3", "h4", "h5", "h6"],
+      ALLOWED_ATTR: ["href", "target", "rel", "class", "data-citation-page", "data-citation-source", "data-citation-doc", "data-citation-verified", "title", "fill", "stroke", "viewBox", "stroke-linecap", "stroke-linejoin", "stroke-width", "d"],
+      ADD_ATTR: ["target", "rel"]
+    });
+  }
+  const hasHtml = /<[a-z][\s\S]*>/i.test(strValue);
+  if (hasHtml) {
+    return purify.sanitize(strValue, {
+      ALLOWED_TAGS: ["a", "strong", "em", "b", "i", "code", "span", "br", "button", "svg", "path"],
+      ALLOWED_ATTR: ["href", "target", "rel", "class", "data-citation-page", "data-citation-source", "data-citation-doc", "data-citation-verified", "title", "fill", "stroke", "viewBox", "stroke-linecap", "stroke-linejoin", "stroke-width", "d"],
       ADD_ATTR: ["target", "rel"]
     });
   }
@@ -276,6 +302,10 @@ function renderCellValue(value) {
 function TableRenderer(props) {
   const tableParams = props.component.params;
   let scrollContainerRef;
+  const citationCtx = tableParams.citationMap ? {
+    map: tableParams.citationMap,
+    render: tableParams.citationRender
+  } : void 0;
   const allRows = () => tableParams.rows || [];
   const columns = () => tableParams.columns || [];
   const [sortKey, setSortKey] = createSignal(null);
@@ -516,7 +546,7 @@ ${dataRows}`;
           },
           children: (column) => (() => {
             var _el$23 = getNextElement(_tmpl$10), _el$24 = _el$23.firstChild;
-            effect(() => setProperty(_el$24, "innerHTML", highlightQuery(renderCellValue(row[column.key]), debouncedQuery())));
+            effect(() => setProperty(_el$24, "innerHTML", highlightQuery(renderCellValue(row[column.key], citationCtx), debouncedQuery())));
             return _el$23;
           })()
         }));
@@ -549,7 +579,7 @@ ${dataRows}`;
               },
               children: (column) => (() => {
                 var _el$27 = getNextElement(_tmpl$10), _el$28 = _el$27.firstChild;
-                effect(() => setProperty(_el$28, "innerHTML", highlightQuery(renderCellValue(row[column.key]), debouncedQuery())));
+                effect(() => setProperty(_el$28, "innerHTML", highlightQuery(renderCellValue(row[column.key], citationCtx), debouncedQuery())));
                 return _el$27;
               })()
             }));
@@ -1053,9 +1083,44 @@ function LinkRenderer(props) {
   })();
 }
 function ComponentRenderer(props) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d, _e, _f;
   markRenderStart(props.component.id);
-  onMount(() => markRenderEnd(props.component.id));
+  const telemetry = useTelemetry();
+  onMount(() => {
+    markRenderEnd(props.component.id);
+    if (telemetry) {
+      const ts = Date.now();
+      telemetry.dispatch({
+        type: "component:mounted",
+        id: props.component.id,
+        componentType: props.component.type,
+        ts
+      });
+      if (typeof performance !== "undefined" && typeof performance.getEntriesByName === "function") {
+        const entries = performance.getEntriesByName(`${PERF_PREFIX}${props.component.id}:render`, "measure");
+        const last = entries[entries.length - 1];
+        if (last) {
+          telemetry.dispatch({
+            type: "component:rendered",
+            id: props.component.id,
+            componentType: props.component.type,
+            durationMs: last.duration,
+            ts
+          });
+        }
+      }
+    }
+  });
+  onCleanup(() => {
+    if (telemetry) {
+      telemetry.dispatch({
+        type: "component:unmounted",
+        id: props.component.id,
+        componentType: props.component.type,
+        ts: Date.now()
+      });
+    }
+  });
   const validation = validateComponent(props.component);
   if (!validation.valid) {
     (_a = props.onError) == null ? void 0 : _a.call(props, {
@@ -1064,8 +1129,18 @@ function ComponentRenderer(props) {
       componentId: props.component.id,
       details: validation.errors
     });
+    if (telemetry) {
+      telemetry.dispatch({
+        type: "validation:failed",
+        id: props.component.id,
+        componentType: props.component.type,
+        errorCount: ((_b = validation.errors) == null ? void 0 : _b.length) ?? 0,
+        firstErrorCode: ((_d = (_c = validation.errors) == null ? void 0 : _c[0]) == null ? void 0 : _d.code) ?? null,
+        ts: Date.now()
+      });
+    }
     const mode = props.errorMode ?? "block";
-    const firstError = ((_c = (_b = validation.errors) == null ? void 0 : _b[0]) == null ? void 0 : _c.message) || "Unknown validation error";
+    const firstError = ((_f = (_e = validation.errors) == null ? void 0 : _e[0]) == null ? void 0 : _f.message) || "Unknown validation error";
     if (mode === "silent") {
       return null;
     }
@@ -1317,7 +1392,20 @@ function ActionRenderer(props) {
     execute,
     isExecuting
   } = useAction();
+  const telemetry = useTelemetry();
+  function dispatchTelemetry() {
+    if (!telemetry) return;
+    const actionName = params.toolName ?? params.action ?? "unknown";
+    telemetry.dispatch({
+      type: "action:dispatched",
+      id: props.component.id,
+      componentType: "action",
+      actionName,
+      ts: Date.now()
+    });
+  }
   const handleClick = async (e) => {
+    dispatchTelemetry();
     if (params.action === "tool-call" && params.toolName) {
       e.preventDefault();
       await execute(params.toolName, params.params || {});