@seed-ship/mcp-ui-solid 6.4.0 → 6.5.0

package/dist/components/UIResourceRenderer.d.ts

@@ -4,6 +4,7 @@
  */
 import { Component } from 'solid-js';
 import type { UIComponent, UILayout, RendererError } from '../types';
+import { type DuplicateMountInfo } from '../utils/duplicate-mount-registry';
 /**
  * How `<UIResourceRenderer>` reacts when `validateComponent()` rejects a
  * component (v5.4.0).
@@ -59,6 +60,25 @@ export interface UIResourceRendererProps {
      * graph, map, video, carousel, image-gallery, code.
      */
     toolbarVariant?: 'hover' | 'always-visible';
+    /**
+     * Per-instance hook fired when this renderer mounts a content key that
+     * is already mounted elsewhere in the document (v6.5.0 — closes Demande 2
+     * of `BRIEF-MCPUI-2026-05-10.md`).
+     *
+     * The key comes from `getUiResourceStableKey(content)` — `content.id` if
+     * provided, else a content hash. The reporter fires every time the
+     * concurrent mount count crosses 2+ ; consumers decide what to do
+     * (`console.warn`, telemetry beacon, debug overlay, …). The renderer
+     * never deduplicates visually on its own.
+     */
+    onMountDuplicate?: (info: DuplicateMountInfo) => void;
+    /**
+     * When `true`, log duplicate mounts to `console.warn` from this instance
+     * even when the global `isDebugEnabled()` flag is off. Use to opt-in to
+     * console noise on a single suspect surface without flipping the global
+     * debug switch (v6.5.0).
+     */
+    debugDuplicateMounts?: boolean;
 }
 /**
  * Smart cell value renderer that handles markdown links and other formats

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;AAgEpE;;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;IAE/B;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAA;CAC5C;AAmJD;;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;AAkqCD;;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,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAA;AAG1C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAA;AAgEpE;;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;IAE/B;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAA;IAE3C;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAErD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAmJD;;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;AAkqCD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,uBAAuB,CA6IjE,CAAA"}

package/dist/components/UIResourceRenderer.js

@@ -1,9 +1,12 @@
-import { delegateEvents, createComponent, getNextElement, template, getNextMarker, insert, effect, style, className, setProperty, setAttribute, runHydrationEvents, memo, isServer, use, addEventListener, classList, setStyleProperty } from "solid-js/web";
+import { delegateEvents, createComponent, getNextElement, template, getNextMarker, spread, mergeProps, insert, effect, style, setAttribute, runHydrationEvents, setProperty, className, 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, onCleanup, createSignal, createEffect } from "solid-js";
+import { createMemo, onMount, onCleanup, For, Show, createSignal, createEffect } from "solid-js";
 import { validateComponent, getIframeSandbox, DEFAULT_RESOURCE_LIMITS } from "../services/validation.js";
 import { GenerativeUIErrorBoundary } from "./GenerativeUIErrorBoundary.js";
 import { markRenderStart, markRenderEnd, PERF_PREFIX } from "../utils/perf.js";
+import { isDebugEnabled } from "../utils/logger.js";
+import { getUiResourceStableKey } from "../utils/stable-key.js";
+import { _registerMount, _unregisterMount, getDuplicateMountReporter } from "../utils/duplicate-mount-registry.js";
 import { useTelemetry } from "../context/MCPUITelemetryContext.js";
 import { GridRenderer } from "./GridRenderer.js";
 import { FooterRenderer } from "./FooterRenderer.js";
@@ -1726,6 +1729,23 @@ const UIResourceRenderer = (props) => {
     };
   });
   const layoutData = layout();
+  const isLayoutContent = !("type" in props.content) || props.content.type === "composite";
+  const outerKey = createMemo(() => getUiResourceStableKey(props.content));
+  onMount(() => {
+    var _a, _b;
+    const key = outerKey();
+    const info = _registerMount(key);
+    if (info.count > 1) {
+      (_a = props.onMountDuplicate) == null ? void 0 : _a.call(props, info);
+      (_b = getDuplicateMountReporter()) == null ? void 0 : _b(info);
+      if (isDebugEnabled() || props.debugDuplicateMounts) {
+        console.warn("[mcp-ui] duplicate UIResourceRenderer mount", info);
+      }
+    }
+  });
+  onCleanup(() => {
+    _unregisterMount(outerKey());
+  });
   const renderComponent = (component, onError) => createComponent(ComponentRenderer, {
     component,
     onError,
@@ -1740,6 +1760,15 @@ const UIResourceRenderer = (props) => {
     renderComponent,
     get children() {
       var _el$232 = getNextElement(_tmpl$53), _el$233 = _el$232.firstChild, _el$234 = _el$233.nextSibling, [_el$235, _co$50] = getNextMarker(_el$234.nextSibling);
+      spread(_el$232, mergeProps({
+        get ["class"]() {
+          return `w-full ${props.class || ""}`;
+        }
+      }, () => isLayoutContent ? {
+        "data-mcp-ui-layout-id": outerKey()
+      } : {
+        "data-mcp-ui-component-id": outerKey()
+      }), false, true);
       insert(_el$233, createComponent(For, {
         get each() {
           return layoutData.components;
@@ -1758,7 +1787,15 @@ const UIResourceRenderer = (props) => {
               return props.toolbarVariant;
             }
           }));
-          effect((_$p) => style(_el$236, getGridStyleString(component), _$p));
+          effect((_p$) => {
+            var _v$43 = getGridStyleString(component), _v$44 = getUiResourceStableKey(component);
+            _p$.e = style(_el$236, _v$43, _p$.e);
+            _v$44 !== _p$.t && setAttribute(_el$236, "data-mcp-ui-component-id", _p$.t = _v$44);
+            return _p$;
+          }, {
+            e: void 0,
+            t: void 0
+          });
           return _el$236;
         })()
       }));
@@ -1774,15 +1811,8 @@ const UIResourceRenderer = (props) => {
           });
         }
       }), _el$235, _co$50);
-      effect((_p$) => {
-        var _v$43 = `w-full ${props.class || ""}`, _v$44 = gridContainerStyle();
-        _v$43 !== _p$.e && className(_el$232, _p$.e = _v$43);
-        _p$.t = style(_el$233, _v$44, _p$.t);
-        return _p$;
-      }, {
-        e: void 0,
-        t: void 0
-      });
+      effect((_$p) => style(_el$233, gridContainerStyle(), _$p));
+      runHydrationEvents();
       return _el$232;
     }
   });