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

package/CHANGELOG.md

@@ -5,6 +5,236 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [6.6.0] - 2026-05-21
+
+Sprint OpenData / macros — cf. `docs/briefs/ROADMAP-opendata-macro-mcpui.md`
+(decisions D1-D10 + R1-R4). Ships steps 1-5 of the execution order :
+`StreamingUIRenderer` parity, `MCPUIStringsProvider`, the
+`ConnectorDynamicResultV1` contract consumption, `PresentationFeedback`,
+and the opt-in connector adapters. The macro adapters are deferred to a
+later phase (they need a macro-run contract). Pairs with
+`@seed-ship/mcp-ui-spec@5.1.0`.
+
+### Added — opt-in connector adapters (`@seed-ship/mcp-ui-solid/adapters`) (D5 / D6)
+
+New dedicated subpath export — **never** imported by the core renderer
+path, so consumers that don't emit connector results pay nothing for it:
+
+```ts
+import { connectorResultToUILayout } from '@seed-ship/mcp-ui-solid/adapters'
+
+const layout = connectorResultToUILayout(connectorResult)
+```
+
+- `connectorResultToUILayout(result)` — assembles a `ConnectorDynamicResultV1`
+  (`primary` + `supplemental[]` + `actions`) into one `UILayout`. **Pure**
+  (D5) — deterministic, no side effects, safe to re-run after feedback.
+- `connectorActionsToActionGroup(actions)` — wraps connector actions into
+  an `action-group` `UIComponent`.
+- **Unknown `schemaVersion` never throws** (R2) : a usable-but-unversioned
+  envelope still renders, prefixed with a visible warning notice ; a truly
+  unreadable payload becomes an explicit degraded `UILayout` (a `text`
+  notice with id `connector-degraded`). Never a silent disappearance.
+
+**Scope note** : this ships the *connector* adapters. The *macro* adapters
+(`macroRunToScratchpadState`, `macroInterrogationToChatPromptConfig`) are
+deferred — they need a macro-run contract that the roadmap leaves to
+Phase 2.
+
+### Added — `PresentationFeedback` component (R3 / D9 / Phase 4)
+
+A new opt-in feedback widget — **distinct** from `FeedbackInline` :
+
+- `FeedbackInline` — was the *answer* good? (response quality)
+- `PresentationFeedback` — was the answer *shown well*? (layout / readability)
+
+They are separate components, separate exports, separate payloads — the
+two axes never collapse (cf. R3). `PresentationFeedback` collects a
+`verdict` (`readable` / `not_readable`) and, when not readable, problem
+tags + an optional preferred layout + a free-text comment, then emits a
+`ConnectorRenderFeedback` payload via `onSubmit`.
+
+- Stateless : the host persists the feedback and owns any re-render
+  (cf. D1 — adapter pure + host state). The component never mutates the
+  rendered result.
+- Best-effort : a rejected `onSubmit` promise is swallowed, the UI flips.
+- Localizable : all labels ship in English, overridable via the `labels`
+  prop (`DEFAULT_PRESENTATION_FEEDBACK_LABELS` exported).
+- `ConnectorRenderFeedback` / `ConnectorRenderProblem` /
+  `ConnectorPreferredLayout` types are re-exported from the package root
+  for convenience (defined in `@seed-ship/mcp-ui-spec`).
+
+### Added — `MCPUIStringsProvider` : i18n for the library's chrome (D2 / R4)
+
+MCP-UI hardcoded a handful of its own UI strings (the expand-button
+tooltip, the feedback acknowledgements…) — and they were an inconsistent
+FR/EN mix. New opt-in context to localize them :
+
+```tsx
+import { MCPUIStringsProvider } from '@seed-ship/mcp-ui-solid'
+
+<MCPUIStringsProvider strings={{ expand: 'Agrandir', feedbackUseful: 'Utile' }}>
+  <App />
+</MCPUIStringsProvider>
+```
+
+- `MCPUIStrings` — flat string map of the library's own "chrome" strings.
+  **Content** (table headers, chart titles, action labels) is NOT covered:
+  it comes from the payload, already localized by the producer.
+- `DEFAULT_MCPUI_STRINGS` — English defaults. A published library ships no
+  hardcoded non-English chrome.
+- `<MCPUIStringsProvider strings={...}>` — partial override; unset keys fall
+  back to the EN defaults.
+- `useMCPUIStrings()` — reads the active strings; returns the EN defaults
+  when no provider is mounted (every renderer works standalone).
+
+Wired consumers : `FeedbackInline` (button tooltips + acks),
+`ExpandableWrapper` (expand / copy / close chrome), `StreamingUIRenderer`
+(retry button). Component props that already carry a label
+(`FeedbackInline.positiveAck`, `ExpandableWrapper.copyLabel`) keep priority
+over the provider.
+
+**Behavior change** : `FeedbackInline`'s ack defaults were French
+(`'Merci !'`, `"Noté, on s'améliore"`) — they are now English
+(`'Thanks!'`, `"Noted — we'll improve"`). Consumers relying on the FR
+defaults pass a `<MCPUIStringsProvider>` with FR strings, or the
+`positiveAck` / `negativeAck` props. `ExpandableWrapper`'s default heading
+casing was also unified to `'Expanded view'` (it was inconsistently
+`'Expanded View'` for the heading vs `'Expanded view'` for the aria-label).
+
+### Changed — `StreamingUIRenderer` renders with full fidelity (Gap 1 / D3)
+
+`StreamingUIRenderer` previously rendered each streamed component through an
+inline simplified renderer (`StreamingComponentRenderer`) that only showed a
+type label, the title, and — for metrics — the value. A streamed `table` /
+`chart` / `map` did NOT render the real component.
+
+Each streamed `UIComponent` is now delegated to the real
+`<UIResourceRenderer>`. Streaming and static paths use the literal same
+renderer, so they cannot drift. Validation, telemetry, the error boundary
+and `errorMode` all come from `<UIResourceRenderer>` — the duplicated copies
+in the streaming path are deleted.
+
+- New `toolbarVariant` prop on `<StreamingUIRenderer>`, forwarded to streamed
+  components (parity with the static `<UIResourceRenderer toolbarVariant>`).
+- Delegation is a one-way value import — `UIResourceRenderer` never imports
+  `StreamingUIRenderer`, no cycle.
+- Progress bar, skeletons, arrival animation and metadata display unchanged.
+- The streamed component's grid `position` is normalized to full-width
+  before delegation: `StreamingUIRenderer` owns the 12-column layout,
+  `<UIResourceRenderer>` only renders the component.
+
+### Changed — `size-limit` budgets
+
+The "Streaming renderer" `size-limit` budget was raised from 30 KB to 1 MB.
+Post-D3 that entry's reachable graph equals the full renderer set, and
+`size-limit` measures the pre-built `dist/` including lazy `import()` chunks
+(leaflet, `@antv/g6`, chart.js) that are fetched on demand, not at import.
+The figure is a worst-case total, not eager load cost — the budget is
+generous headroom, since `size-limit` here is a regression guardrail and
+does not gate CI. The "Hooks only" and "Full bundle" entries are unchanged —
+their pre-existing overages predate this sprint.
+
+## [6.5.0] - 2026-05-05
+
+Closes Demande 1 + Demande 2 of `deposium_solid`'s
+`BRIEF-MCPUI-2026-05-10.md` (rescue-duplicate root-cause investigation).
+
+### Added — `getUiResourceStableKey(content)` helper
+
+New public function exported from the package root :
+
+```ts
+import { getUiResourceStableKey } from '@seed-ship/mcp-ui-solid'
+
+getUiResourceStableKey({ id: 'dashboard-q3', components: [...] })
+// → 'dashboard-q3'  (passthrough)
+
+getUiResourceStableKey({ type: 'chart', params: { ... } })
+// → 'a4f3b91'  (FNV-1a 32-bit, 7 chars base36)
+```
+
+If `content.id` is a non-empty string, the helper returns it verbatim.
+Otherwise it derives a deterministic hash from the content with `id` and
+`metadata.generatedAt` stripped — stable across renders for the same
+logical payload, sync, no peer dependency.
+
+This is the canonical implementation of the spec's "bare payload"
+fallback policy (cf. `mcp-ui-spec` README → §Runtime Payload Identity).
+Host apps that pre-process payloads before passing them to a renderer
+(e.g. wrapping a bare chart config into a layout) should reuse this
+helper instead of generating `Date.now()` or counter-based ids — those
+break `<For>` reconciliation and double-mount detection.
+
+### Added — opt-in duplicate-mount observability
+
+`<UIResourceRenderer>` now exposes two ways for consumers to detect
+when the same content key is mounted concurrently more than once :
+
+1. **Per-instance callback** :
+
+   ```tsx
+   <UIResourceRenderer
+     content={layout}
+     onMountDuplicate={({ key, count, firstMountedAt }) => {
+       console.warn('[app] duplicate mount', { key, count })
+     }}
+   />
+   ```
+
+2. **Module-level reporter** (app-wide telemetry) :
+
+   ```ts
+   import { setDuplicateMountReporter } from '@seed-ship/mcp-ui-solid'
+
+   setDuplicateMountReporter(({ key, count }) => {
+     telemetry.warn('mcp-ui.duplicate-mount', { key, count })
+   })
+   ```
+
+The new `debugDuplicateMounts` prop forces a `console.warn` from a
+single instance even when the global `setDebugMode()` flag is off —
+useful when you want to diagnose one suspect surface without flipping
+the global switch.
+
+**The renderer never deduplicates visually on its own.** Hiding a 2nd
+mount would mask parent-framework bugs and could remove legitimate
+co-mounts (drawer + main panel showing the same card). Consumers who
+want dedup implement it on top of the reported events.
+
+### Added — `data-mcp-ui-{layout|component}-id` DOM attributes
+
+Every `<UIResourceRenderer>` wrapper now carries a stable identity
+attribute :
+
+- The outer wrapper carries `data-mcp-ui-layout-id` when `content` is
+  a `UILayout` (composite), or `data-mcp-ui-component-id` when `content`
+  is a single `UIComponent`.
+- Each per-component wrapper inside a layout carries
+  `data-mcp-ui-component-id`.
+
+This enables CSS targeting, debug overlay tooling, and DOM-based
+double-mount detection without a wrapper :
+
+```js
+document.querySelectorAll('[data-mcp-ui-layout-id="dashboard-q3"]').length
+// → 2 (whoops — somewhere in the parent framework, this is mounted twice)
+```
+
+### Internal — no `Date.now()` in identity-bearing code paths
+
+Audit confirmed : every `Date.now()` call inside `mcp-ui-solid` is for
+telemetry timestamps (`ts: Date.now()`), cache TTLs, or download-filename
+fallbacks — none feed into a rendered DOM `id` or a key passed to
+`<For>`. The new `getUiResourceStableKey` helper preserves this
+invariant by hashing content rather than reading the clock.
+
+### Spec companion — `mcp-ui-spec@5.0.6`
+
+Documentation-only patch bump : the spec README now formalizes the
+runtime-payload identity contract (§Runtime Payload Identity) — `id`
+obligation, fallback policy, and pointer to `getUiResourceStableKey`.
+
 ## [6.4.0] - 2026-05-03
 
 Closes axe 3 of `deposium_solid`'s

package/README.md

@@ -5,6 +5,43 @@ SolidJS components + chat toolkit for MCP-generated UI. Part of the [MCP UI ecos
 [![npm version](https://img.shields.io/npm/v/@seed-ship/mcp-ui-solid.svg)](https://www.npmjs.com/package/@seed-ship/mcp-ui-solid)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+## What's New in v6.6.0
+
+Sprint OpenData / macros — `docs/briefs/ROADMAP-opendata-macro-mcpui.md`.
+
+- **`StreamingUIRenderer` renders with full fidelity** — each streamed
+  component is now delegated to the real `<UIResourceRenderer>`. A streamed
+  `table` / `chart` / `map` renders exactly like a static one (no more
+  simplified type-label placeholder). New `toolbarVariant` prop forwarded
+  to streamed components.
+- **`<MCPUIStringsProvider>`** — opt-in i18n for the library's own *chrome*
+  strings (expand tooltip, feedback acks…). English defaults; override
+  partially. Payload *content* is untouched — it stays the producer's job.
+
+  ```tsx
+  import { MCPUIStringsProvider } from '@seed-ship/mcp-ui-solid'
+  <MCPUIStringsProvider strings={{ expand: 'Agrandir' }}><App /></MCPUIStringsProvider>
+  ```
+- **`<PresentationFeedback>`** — a feedback widget for how a result was
+  *presented* (layout / readability), distinct from `FeedbackInline`
+  (response quality). Emits a `ConnectorRenderFeedback` payload; stateless
+  (the host persists + re-renders).
+- **`@seed-ship/mcp-ui-solid/adapters`** — new opt-in subpath.
+  `connectorResultToUILayout()` assembles a `ConnectorDynamicResultV1` into
+  a `UILayout`; `connectorActionsToActionGroup()` wraps connector actions.
+  Pure functions; an unknown `schemaVersion` degrades gracefully, never
+  throws.
+
+  ```ts
+  import { connectorResultToUILayout } from '@seed-ship/mcp-ui-solid/adapters'
+  const layout = connectorResultToUILayout(connectorResult)
+  ```
+
+> **Note** — `FeedbackInline`'s acknowledgement defaults changed from
+> French to English (`'Thanks!'`, `"Noted — we'll improve"`). Wrap your app
+> in `<MCPUIStringsProvider>` with French strings, or pass `positiveAck` /
+> `negativeAck`, to restore French.
+
 ## What's New in v5.2.0 (`mcp-ui-solid` only)
 
 - **`createChatPromptController()`** primitive — closes the v5.1.0 boilerplate. Owns resolver closure + `AbortSignal` wiring + re-entrance. Consumers write `bus.commands.handle('showChatPrompt', ctrl.handle)` + `<Show when={ctrl.activePrompt()}>{cfg => <ChatPrompt ... />}</Show>`. `PromptReplacedError` exported for `instanceof` checks.

package/dist/adapters/connector.cjs

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const schemas = require("../mcp-ui-spec/dist/schemas.cjs");
+const types = require("../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.cjs");
+function connectorActionsToActionGroup(actions, options = {}) {
+  return {
+    id: options.id ?? "connector-actions",
+    type: "action-group",
+    position: options.position ?? { colStart: 1, colSpan: 12 },
+    params: {
+      actions,
+      ...options.title ? { title: options.title } : {},
+      layout: options.layout ?? "horizontal",
+      gap: options.gap ?? "md"
+    }
+  };
+}
+const LenientResultSchema = types.object({
+  schemaVersion: types.string(),
+  connectorId: types.string().min(1),
+  toolName: types.string().min(1),
+  query: types.string(),
+  queryHash: types.string().optional(),
+  intent: types.string().optional(),
+  primary: types.record(types.unknown()),
+  supplemental: types.array(types.record(types.unknown())).optional(),
+  actions: types.array(types.record(types.unknown())).optional()
+});
+const DEFAULT_GRID = { columns: 12, gap: "1rem" };
+function withPosition(component) {
+  if (component && component.position) return component;
+  return { ...component, position: { colStart: 1, colSpan: 12 } };
+}
+function isLayoutShape(value) {
+  return Array.isArray(value.components);
+}
+function degradedTextComponent(id, message) {
+  return {
+    id,
+    type: "text",
+    position: { colStart: 1, colSpan: 12 },
+    params: { markdown: true, content: message }
+  };
+}
+function connectorResultToUILayout(result, options = {}) {
+  const strict = schemas.ConnectorDynamicResultV1Schema.safeParse(result);
+  if (!strict.success) {
+    const lenient = LenientResultSchema.safeParse(result);
+    if (!lenient.success) {
+      const version = result && typeof result === "object" ? result.schemaVersion : void 0;
+      return {
+        id: "connector-degraded",
+        components: [
+          degradedTextComponent(
+            "connector-degraded-notice",
+            `### Résultat non rendu
+
+Le résultat du connecteur n'a pas pu être interprété${typeof version === "string" ? ` (schéma : \`${version}\`)` : ""}. Cet état explicite remplace une disparition silencieuse du rendu.`
+          )
+        ],
+        grid: { ...DEFAULT_GRID }
+      };
+    }
+    const r2 = lenient.data;
+    const components2 = [
+      degradedTextComponent(
+        "connector-version-warning",
+        `> ⚠ Schéma connecteur non reconnu (\`${r2.schemaVersion}\`, attendu \`${schemas.CONNECTOR_DYNAMIC_RESULT_V1}\`). Le rendu ci-dessous est en mode dégradé.`
+      ),
+      ...collectComponents(r2)
+    ];
+    return {
+      id: options.id ?? `connector-degraded-${r2.connectorId}`,
+      components: components2.map(withPosition),
+      grid: { ...DEFAULT_GRID }
+    };
+  }
+  const r = strict.data;
+  const components = collectComponents(r, options.actionsTitle).map(withPosition);
+  return {
+    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),
+    components,
+    grid: { ...DEFAULT_GRID }
+  };
+}
+function collectComponents(r, actionsTitle) {
+  const components = [];
+  if (isLayoutShape(r.primary)) {
+    const inner = r.primary.components ?? [];
+    components.push(...inner);
+  } else {
+    components.push(r.primary);
+  }
+  if (r.supplemental) {
+    components.push(...r.supplemental);
+  }
+  if (Array.isArray(r.actions) && r.actions.length > 0) {
+    components.push(
+      connectorActionsToActionGroup(r.actions, {
+        id: "connector-actions",
+        title: actionsTitle
+      })
+    );
+  }
+  return components;
+}
+function layoutId(connectorId, suffix) {
+  return `connector-${connectorId}-${suffix}`;
+}
+exports.connectorActionsToActionGroup = connectorActionsToActionGroup;
+exports.connectorResultToUILayout = connectorResultToUILayout;
+//# sourceMappingURL=connector.cjs.map

package/dist/adapters/connector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.cjs","sources":["../../src/adapters/connector.ts"],"sourcesContent":["/**\n * Connector adapters — `ConnectorDynamicResultV1` → MCP-UI render structures.\n *\n * @since v6.6.0 (D5 / D6 of ROADMAP-opendata-macro-mcpui)\n *\n * ## Opt-in, pure\n *\n * These adapters are published under the dedicated subpath\n * `@seed-ship/mcp-ui-solid/adapters` — they are NEVER imported by the core\n * renderer path, so a consumer that does not emit connector results pays\n * nothing for them.\n *\n * Every adapter here is a **pure function** (D5) : same input → same\n * output, no `fetch`, no `localStorage`, no global state, no clock, no\n * randomness. This is what lets a host re-run an adapter deterministically\n * after presentation feedback (D1) and replay fixtures in tests.\n *\n * ## Unknown schema version — never throw (R2)\n *\n * `connectorResultToUILayout()` never throws on the runtime render path.\n * A payload it cannot read becomes an explicit degraded `UILayout` (a\n * visible notice), never a silent disappearance and never an exception.\n */\n\nimport type { UIComponent, UILayout, GridPosition } from '../types'\nimport {\n  ConnectorDynamicResultV1Schema,\n  CONNECTOR_DYNAMIC_RESULT_V1,\n  type ConnectorAction,\n} from '@seed-ship/mcp-ui-spec'\nimport { z } from 'zod'\n\n// ─────────────────────────────────────────────────────────────\n// connectorActionsToActionGroup\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorActionsToActionGroupOptions {\n  /** Component id. Default `'connector-actions'`. */\n  id?: string\n  /** Optional heading shown above the buttons. */\n  title?: string\n  /** Button row layout. Default `'horizontal'`. */\n  layout?: 'horizontal' | 'vertical' | 'space-between' | 'end' | 'center'\n  /** Gap between buttons. Default `'md'`. */\n  gap?: 'none' | 'sm' | 'md' | 'lg'\n  /** Grid position. Default full-width. */\n  position?: GridPosition\n}\n\n/**\n * Wraps a connector's `actions` into an `action-group` `UIComponent`.\n *\n * `ConnectorAction` is the exact `action-group` action shape, so this is a\n * thin, pure envelope — no transformation of the actions themselves.\n */\nexport function connectorActionsToActionGroup(\n  actions: ConnectorAction[],\n  options: ConnectorActionsToActionGroupOptions = {}\n): UIComponent {\n  return {\n    id: options.id ?? 'connector-actions',\n    type: 'action-group',\n    position: options.position ?? { colStart: 1, colSpan: 12 },\n    params: {\n      actions,\n      ...(options.title ? { title: options.title } : {}),\n      layout: options.layout ?? 'horizontal',\n      gap: options.gap ?? 'md',\n    },\n  } as UIComponent\n}\n\n// ─────────────────────────────────────────────────────────────\n// connectorResultToUILayout\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorResultToUILayoutOptions {\n  /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */\n  id?: string\n  /** Heading for the actions `action-group`. */\n  actionsTitle?: string\n}\n\n/**\n * Lenient mirror of `ConnectorDynamicResultV1Schema` — `schemaVersion`\n * relaxed to any string. Used to tell apart \"unknown version but otherwise\n * a usable envelope\" (→ render with a warning, R2) from \"truly unreadable\"\n * (→ explicit error state).\n */\nconst LenientResultSchema = z.object({\n  schemaVersion: z.string(),\n  connectorId: z.string().min(1),\n  toolName: z.string().min(1),\n  query: z.string(),\n  queryHash: z.string().optional(),\n  intent: z.string().optional(),\n  primary: z.record(z.unknown()),\n  supplemental: z.array(z.record(z.unknown())).optional(),\n  actions: z.array(z.record(z.unknown())).optional(),\n})\n\nconst DEFAULT_GRID = { columns: 12, gap: '1rem' } as const\n\nfunction withPosition(component: UIComponent): UIComponent {\n  if (component && component.position) return component\n  return { ...component, position: { colStart: 1, colSpan: 12 } }\n}\n\n/** A component is a UILayout when it carries a `components` array. */\nfunction isLayoutShape(value: Record<string, unknown>): boolean {\n  return Array.isArray((value as { components?: unknown }).components)\n}\n\nfunction degradedTextComponent(id: string, message: string): UIComponent {\n  return {\n    id,\n    type: 'text',\n    position: { colStart: 1, colSpan: 12 },\n    params: { markdown: true, content: message },\n  } as UIComponent\n}\n\n/**\n * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :\n * `primary` + `supplemental[]` + (`actions` → an `action-group`).\n *\n * - When `primary` is itself a layout, its components are spread in.\n * - Raw data is never sacrificed — every supplied component is kept.\n * - Pure : no side effects, deterministic.\n *\n * ### Degraded behavior (R2)\n *\n * - Valid v1 payload → normal assembled layout.\n * - Unknown `schemaVersion` but an otherwise-usable envelope → the\n *   components are still rendered, prefixed with a visible warning notice.\n * - Unreadable payload → an explicit error `UILayout` (a single `text`\n *   notice). Never throws, never returns an empty layout silently.\n *\n * A degraded layout always has an `id` starting with `connector-degraded`,\n * so a host can detect it (e.g. for telemetry) without inspecting content.\n */\nexport function connectorResultToUILayout(\n  result: unknown,\n  options: ConnectorResultToUILayoutOptions = {}\n): UILayout {\n  const strict = ConnectorDynamicResultV1Schema.safeParse(result)\n\n  // ── Tier 3 : unreadable ───────────────────────────────────\n  if (!strict.success) {\n    const lenient = LenientResultSchema.safeParse(result)\n    if (!lenient.success) {\n      const version =\n        result && typeof result === 'object'\n          ? (result as { schemaVersion?: unknown }).schemaVersion\n          : undefined\n      return {\n        id: 'connector-degraded',\n        components: [\n          degradedTextComponent(\n            'connector-degraded-notice',\n            `### Résultat non rendu\\n\\nLe résultat du connecteur n'a pas pu être interprété${\n              typeof version === 'string' ? ` (schéma : \\`${version}\\`)` : ''\n            }. Cet état explicite remplace une disparition silencieuse du rendu.`\n          ),\n        ],\n        grid: { ...DEFAULT_GRID },\n      }\n    }\n    // ── Tier 2 : usable envelope, unknown version ───────────\n    const r = lenient.data\n    const components: UIComponent[] = [\n      degradedTextComponent(\n        'connector-version-warning',\n        `> ⚠ Schéma connecteur non reconnu (\\`${r.schemaVersion}\\`, attendu \\`${CONNECTOR_DYNAMIC_RESULT_V1}\\`). Le rendu ci-dessous est en mode dégradé.`\n      ),\n      ...collectComponents(r),\n    ]\n    return {\n      id: options.id ?? `connector-degraded-${r.connectorId}`,\n      components: components.map(withPosition),\n      grid: { ...DEFAULT_GRID },\n    }\n  }\n\n  // ── Tier 1 : valid v1 ─────────────────────────────────────\n  const r = strict.data\n  const components = collectComponents(r, options.actionsTitle).map(withPosition)\n  return {\n    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),\n    components,\n    grid: { ...DEFAULT_GRID },\n  }\n}\n\n/**\n * Flattens `primary` + `supplemental` + `actions` into a component list.\n * Shared by the valid and degraded-but-usable paths.\n */\nfunction collectComponents(\n  r: {\n    primary: Record<string, unknown>\n    supplemental?: Record<string, unknown>[]\n    actions?: unknown[]\n  },\n  actionsTitle?: string\n): UIComponent[] {\n  const components: UIComponent[] = []\n\n  if (isLayoutShape(r.primary)) {\n    const inner = (r.primary as { components?: UIComponent[] }).components ?? []\n    components.push(...inner)\n  } else {\n    components.push(r.primary as unknown as UIComponent)\n  }\n\n  if (r.supplemental) {\n    components.push(...(r.supplemental as unknown as UIComponent[]))\n  }\n\n  if (Array.isArray(r.actions) && r.actions.length > 0) {\n    components.push(\n      connectorActionsToActionGroup(r.actions as ConnectorAction[], {\n        id: 'connector-actions',\n        title: actionsTitle,\n      })\n    )\n  }\n\n  return components\n}\n\nfunction layoutId(connectorId: string, suffix: string): string {\n  return `connector-${connectorId}-${suffix}`\n}\n"],"names":["z.object","z.string","z.record","z.unknown","z.array","ConnectorDynamicResultV1Schema","r","components","CONNECTOR_DYNAMIC_RESULT_V1"],"mappings":"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"}

package/dist/adapters/connector.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Connector adapters — `ConnectorDynamicResultV1` → MCP-UI render structures.
+ *
+ * @since v6.6.0 (D5 / D6 of ROADMAP-opendata-macro-mcpui)
+ *
+ * ## Opt-in, pure
+ *
+ * These adapters are published under the dedicated subpath
+ * `@seed-ship/mcp-ui-solid/adapters` — they are NEVER imported by the core
+ * renderer path, so a consumer that does not emit connector results pays
+ * nothing for them.
+ *
+ * Every adapter here is a **pure function** (D5) : same input → same
+ * output, no `fetch`, no `localStorage`, no global state, no clock, no
+ * randomness. This is what lets a host re-run an adapter deterministically
+ * after presentation feedback (D1) and replay fixtures in tests.
+ *
+ * ## Unknown schema version — never throw (R2)
+ *
+ * `connectorResultToUILayout()` never throws on the runtime render path.
+ * A payload it cannot read becomes an explicit degraded `UILayout` (a
+ * visible notice), never a silent disappearance and never an exception.
+ */
+import type { UIComponent, UILayout, GridPosition } from '../types';
+import { type ConnectorAction } from '@seed-ship/mcp-ui-spec';
+export interface ConnectorActionsToActionGroupOptions {
+    /** Component id. Default `'connector-actions'`. */
+    id?: string;
+    /** Optional heading shown above the buttons. */
+    title?: string;
+    /** Button row layout. Default `'horizontal'`. */
+    layout?: 'horizontal' | 'vertical' | 'space-between' | 'end' | 'center';
+    /** Gap between buttons. Default `'md'`. */
+    gap?: 'none' | 'sm' | 'md' | 'lg';
+    /** Grid position. Default full-width. */
+    position?: GridPosition;
+}
+/**
+ * Wraps a connector's `actions` into an `action-group` `UIComponent`.
+ *
+ * `ConnectorAction` is the exact `action-group` action shape, so this is a
+ * thin, pure envelope — no transformation of the actions themselves.
+ */
+export declare function connectorActionsToActionGroup(actions: ConnectorAction[], options?: ConnectorActionsToActionGroupOptions): UIComponent;
+export interface ConnectorResultToUILayoutOptions {
+    /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */
+    id?: string;
+    /** Heading for the actions `action-group`. */
+    actionsTitle?: string;
+}
+/**
+ * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :
+ * `primary` + `supplemental[]` + (`actions` → an `action-group`).
+ *
+ * - When `primary` is itself a layout, its components are spread in.
+ * - Raw data is never sacrificed — every supplied component is kept.
+ * - Pure : no side effects, deterministic.
+ *
+ * ### Degraded behavior (R2)
+ *
+ * - Valid v1 payload → normal assembled layout.
+ * - Unknown `schemaVersion` but an otherwise-usable envelope → the
+ *   components are still rendered, prefixed with a visible warning notice.
+ * - Unreadable payload → an explicit error `UILayout` (a single `text`
+ *   notice). Never throws, never returns an empty layout silently.
+ *
+ * A degraded layout always has an `id` starting with `connector-degraded`,
+ * so a host can detect it (e.g. for telemetry) without inspecting content.
+ */
+export declare function connectorResultToUILayout(result: unknown, options?: ConnectorResultToUILayoutOptions): UILayout;
+//# sourceMappingURL=connector.d.ts.map

package/dist/adapters/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/adapters/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAA;AAO/B,MAAM,WAAW,oCAAoC;IACnD,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAA;IACvE,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACjC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,GAAE,oCAAyC,GACjD,WAAW,CAYb;AAMD,MAAM,WAAW,gCAAgC;IAC/C,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAyCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,gCAAqC,GAC7C,QAAQ,CAgDV"}

package/dist/adapters/connector.js

@@ -0,0 +1,112 @@
+import { ConnectorDynamicResultV1Schema, CONNECTOR_DYNAMIC_RESULT_V1 } from "../mcp-ui-spec/dist/schemas.js";
+import { object as objectType, array as arrayType, record as recordType, string as stringType, unknown as unknownType } from "../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js";
+function connectorActionsToActionGroup(actions, options = {}) {
+  return {
+    id: options.id ?? "connector-actions",
+    type: "action-group",
+    position: options.position ?? { colStart: 1, colSpan: 12 },
+    params: {
+      actions,
+      ...options.title ? { title: options.title } : {},
+      layout: options.layout ?? "horizontal",
+      gap: options.gap ?? "md"
+    }
+  };
+}
+const LenientResultSchema = objectType({
+  schemaVersion: stringType(),
+  connectorId: stringType().min(1),
+  toolName: stringType().min(1),
+  query: stringType(),
+  queryHash: stringType().optional(),
+  intent: stringType().optional(),
+  primary: recordType(unknownType()),
+  supplemental: arrayType(recordType(unknownType())).optional(),
+  actions: arrayType(recordType(unknownType())).optional()
+});
+const DEFAULT_GRID = { columns: 12, gap: "1rem" };
+function withPosition(component) {
+  if (component && component.position) return component;
+  return { ...component, position: { colStart: 1, colSpan: 12 } };
+}
+function isLayoutShape(value) {
+  return Array.isArray(value.components);
+}
+function degradedTextComponent(id, message) {
+  return {
+    id,
+    type: "text",
+    position: { colStart: 1, colSpan: 12 },
+    params: { markdown: true, content: message }
+  };
+}
+function connectorResultToUILayout(result, options = {}) {
+  const strict = ConnectorDynamicResultV1Schema.safeParse(result);
+  if (!strict.success) {
+    const lenient = LenientResultSchema.safeParse(result);
+    if (!lenient.success) {
+      const version = result && typeof result === "object" ? result.schemaVersion : void 0;
+      return {
+        id: "connector-degraded",
+        components: [
+          degradedTextComponent(
+            "connector-degraded-notice",
+            `### Résultat non rendu
+
+Le résultat du connecteur n'a pas pu être interprété${typeof version === "string" ? ` (schéma : \`${version}\`)` : ""}. Cet état explicite remplace une disparition silencieuse du rendu.`
+          )
+        ],
+        grid: { ...DEFAULT_GRID }
+      };
+    }
+    const r2 = lenient.data;
+    const components2 = [
+      degradedTextComponent(
+        "connector-version-warning",
+        `> ⚠ Schéma connecteur non reconnu (\`${r2.schemaVersion}\`, attendu \`${CONNECTOR_DYNAMIC_RESULT_V1}\`). Le rendu ci-dessous est en mode dégradé.`
+      ),
+      ...collectComponents(r2)
+    ];
+    return {
+      id: options.id ?? `connector-degraded-${r2.connectorId}`,
+      components: components2.map(withPosition),
+      grid: { ...DEFAULT_GRID }
+    };
+  }
+  const r = strict.data;
+  const components = collectComponents(r, options.actionsTitle).map(withPosition);
+  return {
+    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),
+    components,
+    grid: { ...DEFAULT_GRID }
+  };
+}
+function collectComponents(r, actionsTitle) {
+  const components = [];
+  if (isLayoutShape(r.primary)) {
+    const inner = r.primary.components ?? [];
+    components.push(...inner);
+  } else {
+    components.push(r.primary);
+  }
+  if (r.supplemental) {
+    components.push(...r.supplemental);
+  }
+  if (Array.isArray(r.actions) && r.actions.length > 0) {
+    components.push(
+      connectorActionsToActionGroup(r.actions, {
+        id: "connector-actions",
+        title: actionsTitle
+      })
+    );
+  }
+  return components;
+}
+function layoutId(connectorId, suffix) {
+  return `connector-${connectorId}-${suffix}`;
+}
+export {
+  connectorActionsToActionGroup,
+  connectorResultToUILayout
+};
+//# sourceMappingURL=connector.js.map

package/dist/adapters/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sources":["../../src/adapters/connector.ts"],"sourcesContent":["/**\n * Connector adapters — `ConnectorDynamicResultV1` → MCP-UI render structures.\n *\n * @since v6.6.0 (D5 / D6 of ROADMAP-opendata-macro-mcpui)\n *\n * ## Opt-in, pure\n *\n * These adapters are published under the dedicated subpath\n * `@seed-ship/mcp-ui-solid/adapters` — they are NEVER imported by the core\n * renderer path, so a consumer that does not emit connector results pays\n * nothing for them.\n *\n * Every adapter here is a **pure function** (D5) : same input → same\n * output, no `fetch`, no `localStorage`, no global state, no clock, no\n * randomness. This is what lets a host re-run an adapter deterministically\n * after presentation feedback (D1) and replay fixtures in tests.\n *\n * ## Unknown schema version — never throw (R2)\n *\n * `connectorResultToUILayout()` never throws on the runtime render path.\n * A payload it cannot read becomes an explicit degraded `UILayout` (a\n * visible notice), never a silent disappearance and never an exception.\n */\n\nimport type { UIComponent, UILayout, GridPosition } from '../types'\nimport {\n  ConnectorDynamicResultV1Schema,\n  CONNECTOR_DYNAMIC_RESULT_V1,\n  type ConnectorAction,\n} from '@seed-ship/mcp-ui-spec'\nimport { z } from 'zod'\n\n// ─────────────────────────────────────────────────────────────\n// connectorActionsToActionGroup\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorActionsToActionGroupOptions {\n  /** Component id. Default `'connector-actions'`. */\n  id?: string\n  /** Optional heading shown above the buttons. */\n  title?: string\n  /** Button row layout. Default `'horizontal'`. */\n  layout?: 'horizontal' | 'vertical' | 'space-between' | 'end' | 'center'\n  /** Gap between buttons. Default `'md'`. */\n  gap?: 'none' | 'sm' | 'md' | 'lg'\n  /** Grid position. Default full-width. */\n  position?: GridPosition\n}\n\n/**\n * Wraps a connector's `actions` into an `action-group` `UIComponent`.\n *\n * `ConnectorAction` is the exact `action-group` action shape, so this is a\n * thin, pure envelope — no transformation of the actions themselves.\n */\nexport function connectorActionsToActionGroup(\n  actions: ConnectorAction[],\n  options: ConnectorActionsToActionGroupOptions = {}\n): UIComponent {\n  return {\n    id: options.id ?? 'connector-actions',\n    type: 'action-group',\n    position: options.position ?? { colStart: 1, colSpan: 12 },\n    params: {\n      actions,\n      ...(options.title ? { title: options.title } : {}),\n      layout: options.layout ?? 'horizontal',\n      gap: options.gap ?? 'md',\n    },\n  } as UIComponent\n}\n\n// ─────────────────────────────────────────────────────────────\n// connectorResultToUILayout\n// ─────────────────────────────────────────────────────────────\n\nexport interface ConnectorResultToUILayoutOptions {\n  /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */\n  id?: string\n  /** Heading for the actions `action-group`. */\n  actionsTitle?: string\n}\n\n/**\n * Lenient mirror of `ConnectorDynamicResultV1Schema` — `schemaVersion`\n * relaxed to any string. Used to tell apart \"unknown version but otherwise\n * a usable envelope\" (→ render with a warning, R2) from \"truly unreadable\"\n * (→ explicit error state).\n */\nconst LenientResultSchema = z.object({\n  schemaVersion: z.string(),\n  connectorId: z.string().min(1),\n  toolName: z.string().min(1),\n  query: z.string(),\n  queryHash: z.string().optional(),\n  intent: z.string().optional(),\n  primary: z.record(z.unknown()),\n  supplemental: z.array(z.record(z.unknown())).optional(),\n  actions: z.array(z.record(z.unknown())).optional(),\n})\n\nconst DEFAULT_GRID = { columns: 12, gap: '1rem' } as const\n\nfunction withPosition(component: UIComponent): UIComponent {\n  if (component && component.position) return component\n  return { ...component, position: { colStart: 1, colSpan: 12 } }\n}\n\n/** A component is a UILayout when it carries a `components` array. */\nfunction isLayoutShape(value: Record<string, unknown>): boolean {\n  return Array.isArray((value as { components?: unknown }).components)\n}\n\nfunction degradedTextComponent(id: string, message: string): UIComponent {\n  return {\n    id,\n    type: 'text',\n    position: { colStart: 1, colSpan: 12 },\n    params: { markdown: true, content: message },\n  } as UIComponent\n}\n\n/**\n * Assembles a `ConnectorDynamicResultV1` into a single `UILayout` :\n * `primary` + `supplemental[]` + (`actions` → an `action-group`).\n *\n * - When `primary` is itself a layout, its components are spread in.\n * - Raw data is never sacrificed — every supplied component is kept.\n * - Pure : no side effects, deterministic.\n *\n * ### Degraded behavior (R2)\n *\n * - Valid v1 payload → normal assembled layout.\n * - Unknown `schemaVersion` but an otherwise-usable envelope → the\n *   components are still rendered, prefixed with a visible warning notice.\n * - Unreadable payload → an explicit error `UILayout` (a single `text`\n *   notice). Never throws, never returns an empty layout silently.\n *\n * A degraded layout always has an `id` starting with `connector-degraded`,\n * so a host can detect it (e.g. for telemetry) without inspecting content.\n */\nexport function connectorResultToUILayout(\n  result: unknown,\n  options: ConnectorResultToUILayoutOptions = {}\n): UILayout {\n  const strict = ConnectorDynamicResultV1Schema.safeParse(result)\n\n  // ── Tier 3 : unreadable ───────────────────────────────────\n  if (!strict.success) {\n    const lenient = LenientResultSchema.safeParse(result)\n    if (!lenient.success) {\n      const version =\n        result && typeof result === 'object'\n          ? (result as { schemaVersion?: unknown }).schemaVersion\n          : undefined\n      return {\n        id: 'connector-degraded',\n        components: [\n          degradedTextComponent(\n            'connector-degraded-notice',\n            `### Résultat non rendu\\n\\nLe résultat du connecteur n'a pas pu être interprété${\n              typeof version === 'string' ? ` (schéma : \\`${version}\\`)` : ''\n            }. Cet état explicite remplace une disparition silencieuse du rendu.`\n          ),\n        ],\n        grid: { ...DEFAULT_GRID },\n      }\n    }\n    // ── Tier 2 : usable envelope, unknown version ───────────\n    const r = lenient.data\n    const components: UIComponent[] = [\n      degradedTextComponent(\n        'connector-version-warning',\n        `> ⚠ Schéma connecteur non reconnu (\\`${r.schemaVersion}\\`, attendu \\`${CONNECTOR_DYNAMIC_RESULT_V1}\\`). Le rendu ci-dessous est en mode dégradé.`\n      ),\n      ...collectComponents(r),\n    ]\n    return {\n      id: options.id ?? `connector-degraded-${r.connectorId}`,\n      components: components.map(withPosition),\n      grid: { ...DEFAULT_GRID },\n    }\n  }\n\n  // ── Tier 1 : valid v1 ─────────────────────────────────────\n  const r = strict.data\n  const components = collectComponents(r, options.actionsTitle).map(withPosition)\n  return {\n    id: options.id ?? layoutId(r.connectorId, r.queryHash ?? r.toolName),\n    components,\n    grid: { ...DEFAULT_GRID },\n  }\n}\n\n/**\n * Flattens `primary` + `supplemental` + `actions` into a component list.\n * Shared by the valid and degraded-but-usable paths.\n */\nfunction collectComponents(\n  r: {\n    primary: Record<string, unknown>\n    supplemental?: Record<string, unknown>[]\n    actions?: unknown[]\n  },\n  actionsTitle?: string\n): UIComponent[] {\n  const components: UIComponent[] = []\n\n  if (isLayoutShape(r.primary)) {\n    const inner = (r.primary as { components?: UIComponent[] }).components ?? []\n    components.push(...inner)\n  } else {\n    components.push(r.primary as unknown as UIComponent)\n  }\n\n  if (r.supplemental) {\n    components.push(...(r.supplemental as unknown as UIComponent[]))\n  }\n\n  if (Array.isArray(r.actions) && r.actions.length > 0) {\n    components.push(\n      connectorActionsToActionGroup(r.actions as ConnectorAction[], {\n        id: 'connector-actions',\n        title: actionsTitle,\n      })\n    )\n  }\n\n  return components\n}\n\nfunction layoutId(connectorId: string, suffix: string): string {\n  return `connector-${connectorId}-${suffix}`\n}\n"],"names":["z.object","z.string","z.record","z.unknown","z.array","r","components"],"mappings":"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"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @seed-ship/mcp-ui-solid/adapters
+ *
+ * Opt-in, pure adapters that turn connector / macro contracts into MCP-UI
+ * render structures. Published as a dedicated subpath so the core renderer
+ * path never depends on them.
+ *
+ * @example
+ * ```ts
+ * import { connectorResultToUILayout } from '@seed-ship/mcp-ui-solid/adapters'
+ *
+ * const layout = connectorResultToUILayout(connectorResult)
+ * // → <UIResourceRenderer content={layout} />
+ * ```
+ */
+export { connectorResultToUILayout, connectorActionsToActionGroup, } from './connector';
+export type { ConnectorResultToUILayoutOptions, ConnectorActionsToActionGroupOptions, } from './connector';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,aAAa,CAAA"}