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

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;"}