@seed-ship/mcp-ui-solid 5.6.0 → 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,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,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CA4ElD;AAsnCD;;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

@@ -219,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 "-";
   }
@@ -255,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"]
     });
   }
@@ -277,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);
@@ -517,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;
           })()
         }));
@@ -550,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;
               })()
             }));