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

package/dist/index.cjs

@@ -41,6 +41,8 @@ const AutocompleteFormField = require("./components/AutocompleteFormField.cjs");
 const GraphRenderer = require("./components/GraphRenderer.cjs");
 const logger = require("./utils/logger.cjs");
 const perf = require("./utils/perf.cjs");
+const stableKey = require("./utils/stable-key.cjs");
+const duplicateMountRegistry = require("./utils/duplicate-mount-registry.cjs");
 const MCPUITelemetryContext = require("./context/MCPUITelemetryContext.cjs");
 const telemetry = require("./services/telemetry.cjs");
 const useStreamingUI = require("./hooks/useStreamingUI.cjs");
@@ -110,6 +112,8 @@ exports.setDebugMode = logger.setDebugMode;
 exports.PERF_PREFIX = perf.PERF_PREFIX;
 exports.markRenderEnd = perf.markRenderEnd;
 exports.markRenderStart = perf.markRenderStart;
+exports.getUiResourceStableKey = stableKey.getUiResourceStableKey;
+exports.setDuplicateMountReporter = duplicateMountRegistry.setDuplicateMountReporter;
 exports.MCPUITelemetryContext = MCPUITelemetryContext.MCPUITelemetryContext;
 exports.MCPUITelemetryProvider = MCPUITelemetryContext.MCPUITelemetryProvider;
 exports.useTelemetry = MCPUITelemetryContext.useTelemetry;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.cts

@@ -61,6 +61,9 @@ export type { CitationEntry } from './types';
 export { GraphRenderer, isG6Available, graphToMermaid, graphToJSON } from './components/GraphRenderer';
 export { setDebugMode, isDebugEnabled } from './utils/logger';
 export { markRenderStart, markRenderEnd, PERF_PREFIX } from './utils/perf';
+export { getUiResourceStableKey } from './utils/stable-key';
+export { setDuplicateMountReporter } from './utils/duplicate-mount-registry';
+export type { DuplicateMountInfo, DuplicateMountReporter, } from './utils/duplicate-mount-registry';
 export { MCPUITelemetryProvider, MCPUITelemetryContext, useTelemetry, } from './context/MCPUITelemetryContext';
 export type { MCPUITelemetryProviderProps } from './context/MCPUITelemetryContext';
 export { createTelemetryDispatcher } from './services/telemetry';

package/dist/index.d.ts

@@ -61,6 +61,9 @@ export type { CitationEntry } from './types';
 export { GraphRenderer, isG6Available, graphToMermaid, graphToJSON } from './components/GraphRenderer';
 export { setDebugMode, isDebugEnabled } from './utils/logger';
 export { markRenderStart, markRenderEnd, PERF_PREFIX } from './utils/perf';
+export { getUiResourceStableKey } from './utils/stable-key';
+export { setDuplicateMountReporter } from './utils/duplicate-mount-registry';
+export type { DuplicateMountInfo, DuplicateMountReporter, } from './utils/duplicate-mount-registry';
 export { MCPUITelemetryProvider, MCPUITelemetryContext, useTelemetry, } from './context/MCPUITelemetryContext';
 export type { MCPUITelemetryProviderProps } from './context/MCPUITelemetryContext';
 export { createTelemetryDispatcher } from './services/telemetry';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -39,6 +39,8 @@ import { AutocompleteFormField } from "./components/AutocompleteFormField.js";
 import { GraphRenderer, graphToJSON, graphToMermaid, isG6Available } from "./components/GraphRenderer.js";
 import { isDebugEnabled, setDebugMode } from "./utils/logger.js";
 import { PERF_PREFIX, markRenderEnd, markRenderStart } from "./utils/perf.js";
+import { getUiResourceStableKey } from "./utils/stable-key.js";
+import { setDuplicateMountReporter } from "./utils/duplicate-mount-registry.js";
 import { MCPUITelemetryContext, MCPUITelemetryProvider, useTelemetry } from "./context/MCPUITelemetryContext.js";
 import { createTelemetryDispatcher } from "./services/telemetry.js";
 import { useStreamingUI } from "./hooks/useStreamingUI.js";
@@ -119,6 +121,7 @@ export {
   elicitationToPromptConfig,
   evaluateCondition,
   getIframeSandbox,
+  getUiResourceStableKey,
   graphToJSON,
   graphToMermaid,
   isDebugEnabled,
@@ -128,6 +131,7 @@ export {
   mergeScratchpadSections,
   renderCellValue,
   setDebugMode,
+  setDuplicateMountReporter,
   setServerCapabilities,
   useAction,
   useAutocomplete,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/utils/duplicate-mount-registry.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const registry = /* @__PURE__ */ new Map();
+let moduleReporter = null;
+function setDuplicateMountReporter(reporter) {
+  moduleReporter = reporter;
+}
+function getDuplicateMountReporter() {
+  return moduleReporter;
+}
+function _registerMount(key) {
+  const entry = registry.get(key) ?? { count: 0, firstMountedAt: Date.now() };
+  entry.count += 1;
+  registry.set(key, entry);
+  return { key, count: entry.count, firstMountedAt: entry.firstMountedAt };
+}
+function _unregisterMount(key) {
+  const entry = registry.get(key);
+  if (!entry) return;
+  entry.count -= 1;
+  if (entry.count <= 0) registry.delete(key);
+}
+exports._registerMount = _registerMount;
+exports._unregisterMount = _unregisterMount;
+exports.getDuplicateMountReporter = getDuplicateMountReporter;
+exports.setDuplicateMountReporter = setDuplicateMountReporter;
+//# sourceMappingURL=duplicate-mount-registry.cjs.map

package/dist/utils/duplicate-mount-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-mount-registry.cjs","sources":["../../src/utils/duplicate-mount-registry.ts"],"sourcesContent":["/**\n * Opt-in duplicate-mount registry (v6.5.0).\n *\n * Tracks how many times each `getUiResourceStableKey()` has been mounted\n * concurrently across all `<UIResourceRenderer>` instances. When the same\n * key is mounted more than once, registered reporters fire so consumers\n * can detect double-render bugs in their parent framework.\n *\n * **Opt-in by design** : the registry is always populated (cheap), but\n * notifications only fire when a consumer has wired one of the two opt-in\n * paths :\n *   - module-level `setDuplicateMountReporter(fn)` (app-wide telemetry)\n *   - per-instance `<UIResourceRenderer onMountDuplicate={fn}>` prop\n *\n * **What this does NOT do** : visual deduplication. The renderer never\n * hides or replaces a duplicate mount automatically — that would mask\n * parent-framework bugs and could remove legitimate co-mounts (e.g. drawer\n * + main panel showing the same card). Consumers who want dedup implement\n * it on top of the reported events.\n */\n\nexport interface DuplicateMountInfo {\n  /** Stable key from `getUiResourceStableKey(content)`. */\n  key: string\n  /**\n   * Current concurrent mount count. The reporter fires whenever this\n   * crosses 2 (i.e. on the 2nd, 3rd, etc. mount of the same key while\n   * earlier mounts are still alive).\n   */\n  count: number\n  /** `Date.now()` of the FIRST mount of this key (telemetry, not identity). */\n  firstMountedAt: number\n}\n\nexport type DuplicateMountReporter = (info: DuplicateMountInfo) => void\n\nconst registry = new Map<string, { count: number; firstMountedAt: number }>()\nlet moduleReporter: DuplicateMountReporter | null = null\n\n/**\n * Wire a module-level reporter for duplicate mount events. Pass `null` to\n * unwire. Only one module reporter at a time (replaces any previous one).\n *\n * @example\n * ```ts\n * import { setDuplicateMountReporter } from '@seed-ship/mcp-ui-solid'\n *\n * setDuplicateMountReporter(({ key, count }) => {\n *   telemetry.warn('mcp-ui.duplicate-mount', { key, count })\n * })\n * ```\n */\nexport function setDuplicateMountReporter(reporter: DuplicateMountReporter | null): void {\n  moduleReporter = reporter\n}\n\n/**\n * Internal — read by `<UIResourceRenderer>` to dispatch on mount. Not part\n * of the public API.\n *\n * @internal\n */\nexport function getDuplicateMountReporter(): DuplicateMountReporter | null {\n  return moduleReporter\n}\n\n/**\n * Internal — registers a mount for `key` and returns the resulting state.\n * The caller decides whether to surface a notification based on `count > 1`.\n *\n * @internal\n */\nexport function _registerMount(key: string): DuplicateMountInfo {\n  const entry = registry.get(key) ?? { count: 0, firstMountedAt: Date.now() }\n  entry.count += 1\n  registry.set(key, entry)\n  return { key, count: entry.count, firstMountedAt: entry.firstMountedAt }\n}\n\n/**\n * Internal — undoes a prior `_registerMount(key)`. Removes the entry when\n * the count reaches zero so the registry never leaks across mount/unmount\n * cycles of unique keys.\n *\n * @internal\n */\nexport function _unregisterMount(key: string): void {\n  const entry = registry.get(key)\n  if (!entry) return\n  entry.count -= 1\n  if (entry.count <= 0) registry.delete(key)\n}\n\n/**\n * Internal — clears the registry and unwires any module reporter. Used by\n * tests to ensure isolation between cases.\n *\n * @internal\n */\nexport function _resetRegistry(): void {\n  registry.clear()\n  moduleReporter = null\n}\n\n/**\n * Internal — read the current count for a key (0 if not mounted). Useful\n * for tests and for consumers building their own debug overlays.\n *\n * @internal\n */\nexport function _getMountCount(key: string): number {\n  return registry.get(key)?.count ?? 0\n}\n"],"names":[],"mappings":";;AAoCA,MAAM,+BAAe,IAAA;AACrB,IAAI,iBAAgD;AAe7C,SAAS,0BAA0B,UAA+C;AACvF,mBAAiB;AACnB;AAQO,SAAS,4BAA2D;AACzE,SAAO;AACT;AAQO,SAAS,eAAe,KAAiC;AAC9D,QAAM,QAAQ,SAAS,IAAI,GAAG,KAAK,EAAE,OAAO,GAAG,gBAAgB,KAAK,IAAA,EAAI;AACxE,QAAM,SAAS;AACf,WAAS,IAAI,KAAK,KAAK;AACvB,SAAO,EAAE,KAAK,OAAO,MAAM,OAAO,gBAAgB,MAAM,eAAA;AAC1D;AASO,SAAS,iBAAiB,KAAmB;AAClD,QAAM,QAAQ,SAAS,IAAI,GAAG;AAC9B,MAAI,CAAC,MAAO;AACZ,QAAM,SAAS;AACf,MAAI,MAAM,SAAS,EAAG,UAAS,OAAO,GAAG;AAC3C;;;;;"}

package/dist/utils/duplicate-mount-registry.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Opt-in duplicate-mount registry (v6.5.0).
+ *
+ * Tracks how many times each `getUiResourceStableKey()` has been mounted
+ * concurrently across all `<UIResourceRenderer>` instances. When the same
+ * key is mounted more than once, registered reporters fire so consumers
+ * can detect double-render bugs in their parent framework.
+ *
+ * **Opt-in by design** : the registry is always populated (cheap), but
+ * notifications only fire when a consumer has wired one of the two opt-in
+ * paths :
+ *   - module-level `setDuplicateMountReporter(fn)` (app-wide telemetry)
+ *   - per-instance `<UIResourceRenderer onMountDuplicate={fn}>` prop
+ *
+ * **What this does NOT do** : visual deduplication. The renderer never
+ * hides or replaces a duplicate mount automatically — that would mask
+ * parent-framework bugs and could remove legitimate co-mounts (e.g. drawer
+ * + main panel showing the same card). Consumers who want dedup implement
+ * it on top of the reported events.
+ */
+export interface DuplicateMountInfo {
+    /** Stable key from `getUiResourceStableKey(content)`. */
+    key: string;
+    /**
+     * Current concurrent mount count. The reporter fires whenever this
+     * crosses 2 (i.e. on the 2nd, 3rd, etc. mount of the same key while
+     * earlier mounts are still alive).
+     */
+    count: number;
+    /** `Date.now()` of the FIRST mount of this key (telemetry, not identity). */
+    firstMountedAt: number;
+}
+export type DuplicateMountReporter = (info: DuplicateMountInfo) => void;
+/**
+ * Wire a module-level reporter for duplicate mount events. Pass `null` to
+ * unwire. Only one module reporter at a time (replaces any previous one).
+ *
+ * @example
+ * ```ts
+ * import { setDuplicateMountReporter } from '@seed-ship/mcp-ui-solid'
+ *
+ * setDuplicateMountReporter(({ key, count }) => {
+ *   telemetry.warn('mcp-ui.duplicate-mount', { key, count })
+ * })
+ * ```
+ */
+export declare function setDuplicateMountReporter(reporter: DuplicateMountReporter | null): void;
+/**
+ * Internal — read by `<UIResourceRenderer>` to dispatch on mount. Not part
+ * of the public API.
+ *
+ * @internal
+ */
+export declare function getDuplicateMountReporter(): DuplicateMountReporter | null;
+/**
+ * Internal — registers a mount for `key` and returns the resulting state.
+ * The caller decides whether to surface a notification based on `count > 1`.
+ *
+ * @internal
+ */
+export declare function _registerMount(key: string): DuplicateMountInfo;
+/**
+ * Internal — undoes a prior `_registerMount(key)`. Removes the entry when
+ * the count reaches zero so the registry never leaks across mount/unmount
+ * cycles of unique keys.
+ *
+ * @internal
+ */
+export declare function _unregisterMount(key: string): void;
+/**
+ * Internal — clears the registry and unwires any module reporter. Used by
+ * tests to ensure isolation between cases.
+ *
+ * @internal
+ */
+export declare function _resetRegistry(): void;
+/**
+ * Internal — read the current count for a key (0 if not mounted). Useful
+ * for tests and for consumers building their own debug overlays.
+ *
+ * @internal
+ */
+export declare function _getMountCount(key: string): number;
+//# sourceMappingURL=duplicate-mount-registry.d.ts.map

package/dist/utils/duplicate-mount-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-mount-registry.d.ts","sourceRoot":"","sources":["../../src/utils/duplicate-mount-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAA;AAKvE;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,sBAAsB,GAAG,IAAI,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAK9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/utils/duplicate-mount-registry.js

@@ -0,0 +1,27 @@
+const registry = /* @__PURE__ */ new Map();
+let moduleReporter = null;
+function setDuplicateMountReporter(reporter) {
+  moduleReporter = reporter;
+}
+function getDuplicateMountReporter() {
+  return moduleReporter;
+}
+function _registerMount(key) {
+  const entry = registry.get(key) ?? { count: 0, firstMountedAt: Date.now() };
+  entry.count += 1;
+  registry.set(key, entry);
+  return { key, count: entry.count, firstMountedAt: entry.firstMountedAt };
+}
+function _unregisterMount(key) {
+  const entry = registry.get(key);
+  if (!entry) return;
+  entry.count -= 1;
+  if (entry.count <= 0) registry.delete(key);
+}
+export {
+  _registerMount,
+  _unregisterMount,
+  getDuplicateMountReporter,
+  setDuplicateMountReporter
+};
+//# sourceMappingURL=duplicate-mount-registry.js.map

package/dist/utils/duplicate-mount-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-mount-registry.js","sources":["../../src/utils/duplicate-mount-registry.ts"],"sourcesContent":["/**\n * Opt-in duplicate-mount registry (v6.5.0).\n *\n * Tracks how many times each `getUiResourceStableKey()` has been mounted\n * concurrently across all `<UIResourceRenderer>` instances. When the same\n * key is mounted more than once, registered reporters fire so consumers\n * can detect double-render bugs in their parent framework.\n *\n * **Opt-in by design** : the registry is always populated (cheap), but\n * notifications only fire when a consumer has wired one of the two opt-in\n * paths :\n *   - module-level `setDuplicateMountReporter(fn)` (app-wide telemetry)\n *   - per-instance `<UIResourceRenderer onMountDuplicate={fn}>` prop\n *\n * **What this does NOT do** : visual deduplication. The renderer never\n * hides or replaces a duplicate mount automatically — that would mask\n * parent-framework bugs and could remove legitimate co-mounts (e.g. drawer\n * + main panel showing the same card). Consumers who want dedup implement\n * it on top of the reported events.\n */\n\nexport interface DuplicateMountInfo {\n  /** Stable key from `getUiResourceStableKey(content)`. */\n  key: string\n  /**\n   * Current concurrent mount count. The reporter fires whenever this\n   * crosses 2 (i.e. on the 2nd, 3rd, etc. mount of the same key while\n   * earlier mounts are still alive).\n   */\n  count: number\n  /** `Date.now()` of the FIRST mount of this key (telemetry, not identity). */\n  firstMountedAt: number\n}\n\nexport type DuplicateMountReporter = (info: DuplicateMountInfo) => void\n\nconst registry = new Map<string, { count: number; firstMountedAt: number }>()\nlet moduleReporter: DuplicateMountReporter | null = null\n\n/**\n * Wire a module-level reporter for duplicate mount events. Pass `null` to\n * unwire. Only one module reporter at a time (replaces any previous one).\n *\n * @example\n * ```ts\n * import { setDuplicateMountReporter } from '@seed-ship/mcp-ui-solid'\n *\n * setDuplicateMountReporter(({ key, count }) => {\n *   telemetry.warn('mcp-ui.duplicate-mount', { key, count })\n * })\n * ```\n */\nexport function setDuplicateMountReporter(reporter: DuplicateMountReporter | null): void {\n  moduleReporter = reporter\n}\n\n/**\n * Internal — read by `<UIResourceRenderer>` to dispatch on mount. Not part\n * of the public API.\n *\n * @internal\n */\nexport function getDuplicateMountReporter(): DuplicateMountReporter | null {\n  return moduleReporter\n}\n\n/**\n * Internal — registers a mount for `key` and returns the resulting state.\n * The caller decides whether to surface a notification based on `count > 1`.\n *\n * @internal\n */\nexport function _registerMount(key: string): DuplicateMountInfo {\n  const entry = registry.get(key) ?? { count: 0, firstMountedAt: Date.now() }\n  entry.count += 1\n  registry.set(key, entry)\n  return { key, count: entry.count, firstMountedAt: entry.firstMountedAt }\n}\n\n/**\n * Internal — undoes a prior `_registerMount(key)`. Removes the entry when\n * the count reaches zero so the registry never leaks across mount/unmount\n * cycles of unique keys.\n *\n * @internal\n */\nexport function _unregisterMount(key: string): void {\n  const entry = registry.get(key)\n  if (!entry) return\n  entry.count -= 1\n  if (entry.count <= 0) registry.delete(key)\n}\n\n/**\n * Internal — clears the registry and unwires any module reporter. Used by\n * tests to ensure isolation between cases.\n *\n * @internal\n */\nexport function _resetRegistry(): void {\n  registry.clear()\n  moduleReporter = null\n}\n\n/**\n * Internal — read the current count for a key (0 if not mounted). Useful\n * for tests and for consumers building their own debug overlays.\n *\n * @internal\n */\nexport function _getMountCount(key: string): number {\n  return registry.get(key)?.count ?? 0\n}\n"],"names":[],"mappings":"AAoCA,MAAM,+BAAe,IAAA;AACrB,IAAI,iBAAgD;AAe7C,SAAS,0BAA0B,UAA+C;AACvF,mBAAiB;AACnB;AAQO,SAAS,4BAA2D;AACzE,SAAO;AACT;AAQO,SAAS,eAAe,KAAiC;AAC9D,QAAM,QAAQ,SAAS,IAAI,GAAG,KAAK,EAAE,OAAO,GAAG,gBAAgB,KAAK,IAAA,EAAI;AACxE,QAAM,SAAS;AACf,WAAS,IAAI,KAAK,KAAK;AACvB,SAAO,EAAE,KAAK,OAAO,MAAM,OAAO,gBAAgB,MAAM,eAAA;AAC1D;AASO,SAAS,iBAAiB,KAAmB;AAClD,QAAM,QAAQ,SAAS,IAAI,GAAG;AAC9B,MAAI,CAAC,MAAO;AACZ,QAAM,SAAS;AACf,MAAI,MAAM,SAAS,EAAG,UAAS,OAAO,GAAG;AAC3C;"}

package/dist/utils/stable-key.cjs

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const FNV_OFFSET_BASIS = 2166136261;
+const FNV_PRIME = 16777619;
+function fnv1a(str) {
+  let hash = FNV_OFFSET_BASIS;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = Math.imul(hash, FNV_PRIME);
+  }
+  return (hash >>> 0).toString(36).padStart(7, "0");
+}
+function stableStringify(value) {
+  if (value === void 0) return "undefined";
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) {
+    return "[" + value.map(stableStringify).join(",") + "]";
+  }
+  const obj = value;
+  const keys = Object.keys(obj).sort().filter((k) => obj[k] !== void 0);
+  return "{" + keys.map((k) => JSON.stringify(k) + ":" + stableStringify(obj[k])).join(",") + "}";
+}
+function normalizeForHash(input) {
+  if (!input || typeof input !== "object") return input;
+  const { id: _id, ...rest } = input;
+  if (rest.metadata && typeof rest.metadata === "object" && !Array.isArray(rest.metadata)) {
+    const meta = rest.metadata;
+    const { generatedAt: _t, ...metaRest } = meta;
+    rest.metadata = Object.keys(metaRest).length > 0 ? metaRest : void 0;
+  }
+  return rest;
+}
+function getUiResourceStableKey(input) {
+  if (input && typeof input === "object") {
+    const id = input.id;
+    if (typeof id === "string" && id.length > 0) return id;
+  }
+  return fnv1a(stableStringify(normalizeForHash(input)));
+}
+exports.getUiResourceStableKey = getUiResourceStableKey;
+//# sourceMappingURL=stable-key.cjs.map

package/dist/utils/stable-key.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-key.cjs","sources":["../../src/utils/stable-key.ts"],"sourcesContent":["/**\n * Stable identity key for UIResource payloads (v6.5.0).\n *\n * Consumers need a way to derive a deterministic key from a layout/component\n * payload — for `<For>` keys, dedup detection, telemetry correlation, etc.\n *\n * Spec semantics : `UILayout.id` and `UIComponent.id` are obligatoires for\n * any well-formed payload. When they are present and non-empty, this helper\n * returns them as-is. When they are missing (e.g. consumer passing a \"bare\"\n * chart payload `{ type: 'chart', params: {...} }` without wrapping it in\n * a layout), the helper derives a stable key from the *content* — never\n * from a timestamp or counter.\n *\n * The hash is FNV-1a 32-bit on a deterministically stringified form of the\n * payload (sorted keys, undefined entries skipped). This is intentionally\n * synchronous and dependency-free so consumers can call it inside a Solid\n * memo or render function without ceremony.\n */\n\nconst FNV_OFFSET_BASIS = 0x811c9dc5\nconst FNV_PRIME = 0x01000193\n\nfunction fnv1a(str: string): string {\n  let hash = FNV_OFFSET_BASIS\n  for (let i = 0; i < str.length; i++) {\n    hash ^= str.charCodeAt(i)\n    hash = Math.imul(hash, FNV_PRIME)\n  }\n  return (hash >>> 0).toString(36).padStart(7, '0')\n}\n\n/**\n * Deterministic JSON-like serialization. Object keys are sorted ; entries\n * with `undefined` values are skipped (mirroring `JSON.stringify` semantics\n * but with a stable order). Used as the input to `fnv1a()`.\n */\nfunction stableStringify(value: unknown): string {\n  if (value === undefined) return 'undefined'\n  if (value === null || typeof value !== 'object') return JSON.stringify(value)\n  if (Array.isArray(value)) {\n    return '[' + value.map(stableStringify).join(',') + ']'\n  }\n  const obj = value as Record<string, unknown>\n  const keys = Object.keys(obj)\n    .sort()\n    .filter((k) => obj[k] !== undefined)\n  return (\n    '{' +\n    keys.map((k) => JSON.stringify(k) + ':' + stableStringify(obj[k])).join(',') +\n    '}'\n  )\n}\n\n/**\n * Strip fields that should NOT contribute to identity :\n *   - top-level `id` : we're computing the absent identity\n *   - `metadata.generatedAt` : timestamp of generation, not of identity\n */\nfunction normalizeForHash(input: unknown): unknown {\n  if (!input || typeof input !== 'object') return input\n  const { id: _id, ...rest } = input as Record<string, unknown>\n  void _id\n  if (rest.metadata && typeof rest.metadata === 'object' && !Array.isArray(rest.metadata)) {\n    const meta = rest.metadata as Record<string, unknown>\n    const { generatedAt: _t, ...metaRest } = meta\n    void _t\n    rest.metadata = Object.keys(metaRest).length > 0 ? metaRest : undefined\n  }\n  return rest\n}\n\n/**\n * Returns a stable identity key for a UIResource payload.\n *\n * - If `input.id` is a non-empty string, returns it verbatim. This is the\n *   path taken by well-formed payloads (cf. spec §Identity).\n * - Otherwise, returns a 7-char base36 FNV-1a hash of the normalized\n *   content. Stable across renders, identical for structurally identical\n *   payloads.\n *\n * The hash is NOT cryptographic ; it's a dedup/correlation key. Collisions\n * are theoretically possible but vanishingly rare for the payload shapes\n * MCP-UI emits in practice.\n */\nexport function getUiResourceStableKey(input: unknown): string {\n  if (input && typeof input === 'object') {\n    const id = (input as { id?: unknown }).id\n    if (typeof id === 'string' && id.length > 0) return id\n  }\n  return fnv1a(stableStringify(normalizeForHash(input)))\n}\n"],"names":[],"mappings":";;AAmBA,MAAM,mBAAmB;AACzB,MAAM,YAAY;AAElB,SAAS,MAAM,KAAqB;AAClC,MAAI,OAAO;AACX,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,YAAQ,IAAI,WAAW,CAAC;AACxB,WAAO,KAAK,KAAK,MAAM,SAAS;AAAA,EAClC;AACA,UAAQ,SAAS,GAAG,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAClD;AAOA,SAAS,gBAAgB,OAAwB;AAC/C,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,KAAK;AAC5E,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,MAAM,IAAI,eAAe,EAAE,KAAK,GAAG,IAAI;AAAA,EACtD;AACA,QAAM,MAAM;AACZ,QAAM,OAAO,OAAO,KAAK,GAAG,EACzB,KAAA,EACA,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,MAAS;AACrC,SACE,MACA,KAAK,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,IAAI,MAAM,gBAAgB,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAC3E;AAEJ;AAOA,SAAS,iBAAiB,OAAyB;AACjD,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,EAAE,IAAI,KAAK,GAAG,SAAS;AAE7B,MAAI,KAAK,YAAY,OAAO,KAAK,aAAa,YAAY,CAAC,MAAM,QAAQ,KAAK,QAAQ,GAAG;AACvF,UAAM,OAAO,KAAK;AAClB,UAAM,EAAE,aAAa,IAAI,GAAG,aAAa;AAEzC,SAAK,WAAW,OAAO,KAAK,QAAQ,EAAE,SAAS,IAAI,WAAW;AAAA,EAChE;AACA,SAAO;AACT;AAeO,SAAS,uBAAuB,OAAwB;AAC7D,MAAI,SAAS,OAAO,UAAU,UAAU;AACtC,UAAM,KAAM,MAA2B;AACvC,QAAI,OAAO,OAAO,YAAY,GAAG,SAAS,EAAG,QAAO;AAAA,EACtD;AACA,SAAO,MAAM,gBAAgB,iBAAiB,KAAK,CAAC,CAAC;AACvD;;"}

package/dist/utils/stable-key.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Stable identity key for UIResource payloads (v6.5.0).
+ *
+ * Consumers need a way to derive a deterministic key from a layout/component
+ * payload — for `<For>` keys, dedup detection, telemetry correlation, etc.
+ *
+ * Spec semantics : `UILayout.id` and `UIComponent.id` are obligatoires for
+ * any well-formed payload. When they are present and non-empty, this helper
+ * returns them as-is. When they are missing (e.g. consumer passing a "bare"
+ * chart payload `{ type: 'chart', params: {...} }` without wrapping it in
+ * a layout), the helper derives a stable key from the *content* — never
+ * from a timestamp or counter.
+ *
+ * The hash is FNV-1a 32-bit on a deterministically stringified form of the
+ * payload (sorted keys, undefined entries skipped). This is intentionally
+ * synchronous and dependency-free so consumers can call it inside a Solid
+ * memo or render function without ceremony.
+ */
+/**
+ * Returns a stable identity key for a UIResource payload.
+ *
+ * - If `input.id` is a non-empty string, returns it verbatim. This is the
+ *   path taken by well-formed payloads (cf. spec §Identity).
+ * - Otherwise, returns a 7-char base36 FNV-1a hash of the normalized
+ *   content. Stable across renders, identical for structurally identical
+ *   payloads.
+ *
+ * The hash is NOT cryptographic ; it's a dedup/correlation key. Collisions
+ * are theoretically possible but vanishingly rare for the payload shapes
+ * MCP-UI emits in practice.
+ */
+export declare function getUiResourceStableKey(input: unknown): string;
+//# sourceMappingURL=stable-key.d.ts.map

package/dist/utils/stable-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-key.d.ts","sourceRoot":"","sources":["../../src/utils/stable-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAsDH;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM7D"}

package/dist/utils/stable-key.js

@@ -0,0 +1,41 @@
+const FNV_OFFSET_BASIS = 2166136261;
+const FNV_PRIME = 16777619;
+function fnv1a(str) {
+  let hash = FNV_OFFSET_BASIS;
+  for (let i = 0; i < str.length; i++) {
+    hash ^= str.charCodeAt(i);
+    hash = Math.imul(hash, FNV_PRIME);
+  }
+  return (hash >>> 0).toString(36).padStart(7, "0");
+}
+function stableStringify(value) {
+  if (value === void 0) return "undefined";
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) {
+    return "[" + value.map(stableStringify).join(",") + "]";
+  }
+  const obj = value;
+  const keys = Object.keys(obj).sort().filter((k) => obj[k] !== void 0);
+  return "{" + keys.map((k) => JSON.stringify(k) + ":" + stableStringify(obj[k])).join(",") + "}";
+}
+function normalizeForHash(input) {
+  if (!input || typeof input !== "object") return input;
+  const { id: _id, ...rest } = input;
+  if (rest.metadata && typeof rest.metadata === "object" && !Array.isArray(rest.metadata)) {
+    const meta = rest.metadata;
+    const { generatedAt: _t, ...metaRest } = meta;
+    rest.metadata = Object.keys(metaRest).length > 0 ? metaRest : void 0;
+  }
+  return rest;
+}
+function getUiResourceStableKey(input) {
+  if (input && typeof input === "object") {
+    const id = input.id;
+    if (typeof id === "string" && id.length > 0) return id;
+  }
+  return fnv1a(stableStringify(normalizeForHash(input)));
+}
+export {
+  getUiResourceStableKey
+};
+//# sourceMappingURL=stable-key.js.map

package/dist/utils/stable-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-key.js","sources":["../../src/utils/stable-key.ts"],"sourcesContent":["/**\n * Stable identity key for UIResource payloads (v6.5.0).\n *\n * Consumers need a way to derive a deterministic key from a layout/component\n * payload — for `<For>` keys, dedup detection, telemetry correlation, etc.\n *\n * Spec semantics : `UILayout.id` and `UIComponent.id` are obligatoires for\n * any well-formed payload. When they are present and non-empty, this helper\n * returns them as-is. When they are missing (e.g. consumer passing a \"bare\"\n * chart payload `{ type: 'chart', params: {...} }` without wrapping it in\n * a layout), the helper derives a stable key from the *content* — never\n * from a timestamp or counter.\n *\n * The hash is FNV-1a 32-bit on a deterministically stringified form of the\n * payload (sorted keys, undefined entries skipped). This is intentionally\n * synchronous and dependency-free so consumers can call it inside a Solid\n * memo or render function without ceremony.\n */\n\nconst FNV_OFFSET_BASIS = 0x811c9dc5\nconst FNV_PRIME = 0x01000193\n\nfunction fnv1a(str: string): string {\n  let hash = FNV_OFFSET_BASIS\n  for (let i = 0; i < str.length; i++) {\n    hash ^= str.charCodeAt(i)\n    hash = Math.imul(hash, FNV_PRIME)\n  }\n  return (hash >>> 0).toString(36).padStart(7, '0')\n}\n\n/**\n * Deterministic JSON-like serialization. Object keys are sorted ; entries\n * with `undefined` values are skipped (mirroring `JSON.stringify` semantics\n * but with a stable order). Used as the input to `fnv1a()`.\n */\nfunction stableStringify(value: unknown): string {\n  if (value === undefined) return 'undefined'\n  if (value === null || typeof value !== 'object') return JSON.stringify(value)\n  if (Array.isArray(value)) {\n    return '[' + value.map(stableStringify).join(',') + ']'\n  }\n  const obj = value as Record<string, unknown>\n  const keys = Object.keys(obj)\n    .sort()\n    .filter((k) => obj[k] !== undefined)\n  return (\n    '{' +\n    keys.map((k) => JSON.stringify(k) + ':' + stableStringify(obj[k])).join(',') +\n    '}'\n  )\n}\n\n/**\n * Strip fields that should NOT contribute to identity :\n *   - top-level `id` : we're computing the absent identity\n *   - `metadata.generatedAt` : timestamp of generation, not of identity\n */\nfunction normalizeForHash(input: unknown): unknown {\n  if (!input || typeof input !== 'object') return input\n  const { id: _id, ...rest } = input as Record<string, unknown>\n  void _id\n  if (rest.metadata && typeof rest.metadata === 'object' && !Array.isArray(rest.metadata)) {\n    const meta = rest.metadata as Record<string, unknown>\n    const { generatedAt: _t, ...metaRest } = meta\n    void _t\n    rest.metadata = Object.keys(metaRest).length > 0 ? metaRest : undefined\n  }\n  return rest\n}\n\n/**\n * Returns a stable identity key for a UIResource payload.\n *\n * - If `input.id` is a non-empty string, returns it verbatim. This is the\n *   path taken by well-formed payloads (cf. spec §Identity).\n * - Otherwise, returns a 7-char base36 FNV-1a hash of the normalized\n *   content. Stable across renders, identical for structurally identical\n *   payloads.\n *\n * The hash is NOT cryptographic ; it's a dedup/correlation key. Collisions\n * are theoretically possible but vanishingly rare for the payload shapes\n * MCP-UI emits in practice.\n */\nexport function getUiResourceStableKey(input: unknown): string {\n  if (input && typeof input === 'object') {\n    const id = (input as { id?: unknown }).id\n    if (typeof id === 'string' && id.length > 0) return id\n  }\n  return fnv1a(stableStringify(normalizeForHash(input)))\n}\n"],"names":[],"mappings":"AAmBA,MAAM,mBAAmB;AACzB,MAAM,YAAY;AAElB,SAAS,MAAM,KAAqB;AAClC,MAAI,OAAO;AACX,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,YAAQ,IAAI,WAAW,CAAC;AACxB,WAAO,KAAK,KAAK,MAAM,SAAS;AAAA,EAClC;AACA,UAAQ,SAAS,GAAG,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAClD;AAOA,SAAS,gBAAgB,OAAwB;AAC/C,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,KAAK;AAC5E,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,MAAM,IAAI,eAAe,EAAE,KAAK,GAAG,IAAI;AAAA,EACtD;AACA,QAAM,MAAM;AACZ,QAAM,OAAO,OAAO,KAAK,GAAG,EACzB,KAAA,EACA,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,MAAS;AACrC,SACE,MACA,KAAK,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,IAAI,MAAM,gBAAgB,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAC3E;AAEJ;AAOA,SAAS,iBAAiB,OAAyB;AACjD,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,EAAE,IAAI,KAAK,GAAG,SAAS;AAE7B,MAAI,KAAK,YAAY,OAAO,KAAK,aAAa,YAAY,CAAC,MAAM,QAAQ,KAAK,QAAQ,GAAG;AACvF,UAAM,OAAO,KAAK;AAClB,UAAM,EAAE,aAAa,IAAI,GAAG,aAAa;AAEzC,SAAK,WAAW,OAAO,KAAK,QAAQ,EAAE,SAAS,IAAI,WAAW;AAAA,EAChE;AACA,SAAO;AACT;AAeO,SAAS,uBAAuB,OAAwB;AAC7D,MAAI,SAAS,OAAO,UAAU,UAAU;AACtC,UAAM,KAAM,MAA2B;AACvC,QAAI,OAAO,OAAO,YAAY,GAAG,SAAS,EAAG,QAAO;AAAA,EACtD;AACA,SAAO,MAAM,gBAAgB,iBAAiB,KAAK,CAAC,CAAC;AACvD;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-ship/mcp-ui-solid",
-  "version": "6.4.0",
+  "version": "6.5.0",
   "description": "SolidJS components for rendering MCP-generated UI resources",
   "type": "module",
   "main": "./dist/index.cjs",

package/src/components/UIResourceRenderer.identity.test.tsx

@@ -0,0 +1,161 @@
+/**
+ * v6.5.0 — Identity stability + opt-in observability for <UIResourceRenderer>.
+ *
+ * Coverage targets :
+ *   1. Layout content gets `data-mcp-ui-layout-id` from layout.id
+ *   2. Layout content without id falls back to a content hash
+ *   3. Single-component content gets `data-mcp-ui-component-id` (no layout id)
+ *   4. Each rendered child carries `data-mcp-ui-component-id`
+ *   5. `onMountDuplicate` callback fires on the 2nd concurrent mount
+ *   6. Module-level reporter (`setDuplicateMountReporter`) fires on duplicate
+ *   7. Single mount fires no duplicate notification
+ *   8. Cleanup on unmount allows the same key to be re-mounted without warn
+ */
+
+import { describe, it, expect, beforeEach, vi } from 'vitest'
+import { render, cleanup } from '@solidjs/testing-library'
+import { UIResourceRenderer } from './UIResourceRenderer'
+import {
+  setDuplicateMountReporter,
+  _resetRegistry,
+  _getMountCount,
+} from '../utils/duplicate-mount-registry'
+import { getUiResourceStableKey } from '../utils/stable-key'
+
+const SIMPLE_TEXT_COMPONENT = {
+  id: 'text-comp-1',
+  type: 'text' as const,
+  position: { colStart: 1, colSpan: 12 },
+  params: { content: 'Hello' },
+}
+
+const SIMPLE_LAYOUT = {
+  id: 'layout-1',
+  components: [SIMPLE_TEXT_COMPONENT],
+  grid: { columns: 12, gap: '1rem' },
+}
+
+describe('UIResourceRenderer identity (v6.5.0)', () => {
+  beforeEach(() => {
+    cleanup()
+    _resetRegistry()
+  })
+
+  it('layout content emits data-mcp-ui-layout-id from layout.id', () => {
+    const { container } = render(() => <UIResourceRenderer content={SIMPLE_LAYOUT} />)
+    const wrapper = container.querySelector('[data-mcp-ui-layout-id="layout-1"]')
+    expect(wrapper).toBeTruthy()
+  })
+
+  it('layout without id falls back to a content hash', () => {
+    const bareLayout = {
+      components: [SIMPLE_TEXT_COMPONENT],
+      grid: { columns: 12, gap: '1rem' },
+    } as any
+    const expectedKey = getUiResourceStableKey(bareLayout)
+    const { container } = render(() => <UIResourceRenderer content={bareLayout} />)
+    const wrapper = container.querySelector(`[data-mcp-ui-layout-id="${expectedKey}"]`)
+    expect(wrapper).toBeTruthy()
+    // Hash form (FNV-1a base36) is 7 chars
+    expect(expectedKey).toMatch(/^[a-z0-9]{7}$/)
+  })
+
+  it('single-component content emits data-mcp-ui-component-id (no layout id)', () => {
+    const { container } = render(() => <UIResourceRenderer content={SIMPLE_TEXT_COMPONENT} />)
+    expect(container.querySelector('[data-mcp-ui-layout-id]')).toBeNull()
+    const wrappers = container.querySelectorAll('[data-mcp-ui-component-id="text-comp-1"]')
+    // Outer wrapper + inner per-component wrapper both carry the id
+    expect(wrappers.length).toBeGreaterThanOrEqual(1)
+  })
+
+  it('each child component wrapper inside a layout carries data-mcp-ui-component-id', () => {
+    const layout = {
+      id: 'multi',
+      components: [
+        { id: 'comp-a', type: 'text', position: { colStart: 1, colSpan: 6 }, params: { content: 'A' } },
+        { id: 'comp-b', type: 'text', position: { colStart: 7, colSpan: 6 }, params: { content: 'B' } },
+      ],
+      grid: { columns: 12, gap: '1rem' },
+    } as any
+    const { container } = render(() => <UIResourceRenderer content={layout} />)
+    expect(container.querySelector('[data-mcp-ui-component-id="comp-a"]')).toBeTruthy()
+    expect(container.querySelector('[data-mcp-ui-component-id="comp-b"]')).toBeTruthy()
+  })
+
+  it('fires onMountDuplicate on the 2nd concurrent mount of the same key', () => {
+    const onDup = vi.fn()
+    render(() => (
+      <>
+        <UIResourceRenderer content={SIMPLE_LAYOUT} onMountDuplicate={onDup} />
+        <UIResourceRenderer content={SIMPLE_LAYOUT} onMountDuplicate={onDup} />
+      </>
+    ))
+    // Only the 2nd mount triggers the callback (count crosses 2)
+    expect(onDup).toHaveBeenCalledTimes(1)
+    expect(onDup).toHaveBeenCalledWith(
+      expect.objectContaining({ key: 'layout-1', count: 2 })
+    )
+  })
+
+  it('does NOT fire onMountDuplicate on a single mount', () => {
+    const onDup = vi.fn()
+    render(() => <UIResourceRenderer content={SIMPLE_LAYOUT} onMountDuplicate={onDup} />)
+    expect(onDup).not.toHaveBeenCalled()
+  })
+
+  it('module-level setDuplicateMountReporter fires on the 2nd mount', () => {
+    const reporter = vi.fn()
+    setDuplicateMountReporter(reporter)
+    render(() => (
+      <>
+        <UIResourceRenderer content={SIMPLE_LAYOUT} />
+        <UIResourceRenderer content={SIMPLE_LAYOUT} />
+      </>
+    ))
+    expect(reporter).toHaveBeenCalledTimes(1)
+    expect(reporter).toHaveBeenCalledWith(
+      expect.objectContaining({ key: 'layout-1', count: 2 })
+    )
+  })
+
+  it('mounts unique-key payloads independently (no false positives)', () => {
+    const onDup = vi.fn()
+    const reporter = vi.fn()
+    setDuplicateMountReporter(reporter)
+    const a = { ...SIMPLE_LAYOUT, id: 'layout-A' }
+    const b = { ...SIMPLE_LAYOUT, id: 'layout-B' }
+    render(() => (
+      <>
+        <UIResourceRenderer content={a} onMountDuplicate={onDup} />
+        <UIResourceRenderer content={b} onMountDuplicate={onDup} />
+      </>
+    ))
+    expect(onDup).not.toHaveBeenCalled()
+    expect(reporter).not.toHaveBeenCalled()
+  })
+
+  it('cleanup unregisters the mount so the registry never leaks', () => {
+    const { unmount } = render(() => <UIResourceRenderer content={SIMPLE_LAYOUT} />)
+    expect(_getMountCount('layout-1')).toBe(1)
+    unmount()
+    expect(_getMountCount('layout-1')).toBe(0)
+  })
+
+  it('debugDuplicateMounts prop forces a console.warn even when global debug off', () => {
+    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    try {
+      render(() => (
+        <>
+          <UIResourceRenderer content={SIMPLE_LAYOUT} debugDuplicateMounts />
+          <UIResourceRenderer content={SIMPLE_LAYOUT} debugDuplicateMounts />
+        </>
+      ))
+      expect(warnSpy).toHaveBeenCalledWith(
+        '[mcp-ui] duplicate UIResourceRenderer mount',
+        expect.objectContaining({ key: 'layout-1', count: 2 })
+      )
+    } finally {
+      warnSpy.mockRestore()
+    }
+  })
+})