@seed-ship/mcp-ui-solid 5.1.0 → 5.3.0

package/CHANGELOG.md

@@ -5,6 +5,103 @@ 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).
 
+## [5.3.0] - 2026-04-22
+
+### Added — A. `<ElicitationForm>` schema-driven renderer
+
+- **`<ElicitationForm event onAccept onCancel? onDecline? dismissLabel?>`** — thin wrapper over `<ChatPrompt>` + `elicitationToPromptConfig()` that accepts a spec-shaped `ElicitationEvent` (MCP 2025-06-18) and exposes a spec-shaped `onAccept(content)` callback whose payload is ready to send back as the `accept` outcome of an `elicitation/create` reply.
+- Inverse mapping owned here : single boolean → `{ propName: true }`, single enum → `{ propName: enumValue }` (numeric coerced when schema is `integer`/`number`), multi-property form → values map passed through unchanged.
+- Forward mapping (spec → ChatPromptConfig) reuses the existing `elicitationToPromptConfig` helper from v5.2.0 — same rules, same tests, no duplication.
+- `dismissLabel="Decline"` + `onDecline` lets you surface an explicit decline action distinct from passive cancel.
+- Type export : `ElicitationFormProps`.
+
+### Added — B. `useServerCapabilities()` hook + store
+
+- **`createServerCapabilitiesStore()`** factory + module singleton + **`<ServerCapabilitiesProvider>`** for multi-instance scoping (mirrors the v5.2.0 `scratchpad-store` pattern).
+- **`setServerCapabilities(info)`** — push the parsed MCP `initialize` response into the singleton from your transport adapter.
+- **`useServerCapabilities()`** — reactive accessor returning `{ info, capabilities, serverInfo, protocolVersion, hasCapability }`. Components can gate rendering on advertised capabilities (e.g. `<Show when={hasCapability('tools')}>`).
+- Type exports : `ServerCapabilities`, `ServerInitializeInfo`, `ServerCapabilitiesStoreHandle`.
+- Note : `elicitation` is a **client** capability per MCP spec 2025-06-18 — this store tracks **server** capabilities only. Gate `<ElicitationForm>` on your own client-side state, not on this store.
+
+### Added — C. Recipe : pseudo-elicit → spec adapter
+
+- New doc `docs/recipes/elicitation-pseudo-spec-adapter.md` — drop-in TypeScript adapter for consumer apps talking to MCP servers that ship a legacy "pseudo-elicit" payload inline with `tools/call` results (e.g. deposium_MCPs as of 2026-04). Adapter lives in the consumer app — mcp-ui stays vendor-agnostic by design.
+
+### Added — D. Recipe : `<FeedbackInline>` wiring
+
+- New doc `docs/recipes/feedback-inline-wiring.md` — concrete pattern for wiring `<FeedbackInline>.onSubmit` to a feedback HTTP endpoint, with the Deposium `POST /api/feedback` shape as a worked example. Mapping `'positive' | 'negative'` to the endpoint is direct.
+
+### Tests
+
+- New file : `components/ElicitationForm.test.tsx` (7 tests) — covers boolean/enum/numeric/multi-property accept paths, X-dismiss, confirm-cancel button, and `onDecline` precedence.
+- New file : `stores/server-capabilities-store.test.tsx` (10 tests) — factory isolation, derived accessors, singleton fallback, provider scoping, reactive update propagation.
+
+### Non-breaking
+
+- All additions are optional and additive. v5.2.0 consumers upgrade with zero code changes.
+
+### Aligned with deposium_MCPs
+
+- v5.3.0 closes the items in mcp-ui's court per the `mcp-ui ↔ deposium_MCPs alignment 2026-04-22` doc :
+  - Plan B B.3.5 unblock acknowledged (HTTP transport now bidirectional via SDK `StreamableHTTPServerTransport`).
+  - Pseudo-elicit confirmed as stable legacy ; consumer-side adapter pattern now documented.
+  - Feedback endpoint `POST /api/feedback` wire shape documented.
+  - `<ElicitationForm>` and `useServerCapabilities()` deferred items shipped.
+
+## [5.2.0] - 2026-04-22
+
+### Added — D1 multi-instance scratchpad store
+
+- **`createScratchpadStore()`** factory — returns an isolated `ScratchpadStoreHandle` (`dispatch`, `state`, `pinned`, `close`). Closes the v4.x known limitation that two `ScratchpadPanel` instances shared state.
+- **`ScratchpadStoreProvider`** + **`ScratchpadStoreContext`** — scope a store to a SolidJS subtree. Accepts an optional `store` prop; creates one internally otherwise.
+- **`useScratchpadState()` is now context-aware** — reads the provider's store when mounted inside one, falls back to the module singleton otherwise. Zero-breaking for v4.x single-instance consumers.
+- Type export : `ScratchpadStoreHandle`.
+
+### Added — D2 ChatPrompt controller primitive
+
+- **`createChatPromptController()`** — one primitive owning resolver closure + `AbortSignal` wiring + re-entrance policy. Consumers go from ~20 LOC of hand-threaded resolver to `bus.commands.handle('showChatPrompt', ctrl.handle)` + `<Show when={ctrl.activePrompt()}>{cfg => <ChatPrompt ... />}</Show>`.
+- **`PromptReplacedError`** — exported error class thrown when a new `showChatPrompt` arrives before the previous resolves. Use `instanceof` or `err.name === 'PromptReplacedError'`.
+- **`AbortSignal` honoured** — already-aborted signals reject synchronously with `DOMException('Prompt aborted', 'AbortError')` without showing UI. In-flight aborts reject + clear `activePrompt`.
+- **`ctrl.abort(reason?)`** — programmatic cancellation (route change, modal close, ...).
+- Type export : `ChatPromptController`.
+
+### Added — D5 per-message inline feedback
+
+- **`<FeedbackInline>`** — per-message thumbs up/down, non-blocking, many can coexist. Complements `ChatPrompt` (modal one-at-a-time) and `ScratchpadPanel` feedback section (structured, panel-side). Optimistic UI, best-effort persistence via consumer-owned `onSubmit(rating, context)`.
+- Type exports : `FeedbackInlineProps`, `FeedbackInlineContext`.
+
+### Added — D6 MCP elicitation handling
+
+- **`ChatEvents.onElicitation`** — new event for MCP `elicitation/create` requests (spec 2025-06-18). Symmetric to `onClarificationNeeded`.
+- **Types** : `ElicitationEvent`, `ElicitationRequestedSchema`, `ElicitationPropertySchema`.
+- **`elicitationToPromptConfig(event)`** — converts an MCP elicitation payload to a `ChatPromptConfig`. Smart mapping :
+  - Single `boolean` property → `type: 'confirm'`
+  - Single property with `enum` of ≤4 values → `type: 'choice'`
+  - Anything else → `type: 'form'` with per-property field-type inference
+  - Inferences : `string` → `text`, `string/format:email` → `email`, `string/format:date|date-time` → `date`, `number|integer` → `number`, `boolean` → `checkbox`, any `enum` → `select`.
+
+### Tests
+
+- **467 passing** (+29 vs v5.1.0).
+- New files : `stores/scratchpad-store.test.tsx` (7), `services/chat-prompt-controller.test.ts` (7), `components/FeedbackInline.test.tsx` (7).
+- Extended `services/chat-bus.test.ts` with 8 new elicitation tests.
+
+### Non-breaking
+
+- All additions are optional.
+- `scratchpad-store.ts` refactored to extract a factory; module singleton remains as default so `dispatchScratchpad` / `useScratchpadState` keep working identically.
+
+### Design rationale
+
+Full scope doc lives in the Deposium project : `docs/2026/r&d/mcpui-v5.2.0-scope.md`. It regroups v5.1.0 consensus carry-forward (D1, D2) with two new items arising from the MCP SDK audit 2026-04-14 (D5 feedback inline, D6 elicitation helper).
+
+### Deferred
+
+- `<ElicitationForm>` schema-driven form renderer — waiting for real Claude Desktop payloads.
+- `createChatPromptController` FIFO queue mode — YAGNI until a concrete need.
+- `useServerCapabilities()` hook — needs a second consumer + Phase B protocol align on `capabilities.extensions`.
+- OAuth client-side docs — add as a doc patch when Deposium moves to OAuth Resource Server.
+
 ## [5.1.0] - 2026-04-14
 
 ### Added — D4 custom choice rendering

package/README.md

@@ -5,13 +5,21 @@ 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 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.
+- **`createScratchpadStore()`** factory + `ScratchpadStoreProvider` + `ScratchpadStoreContext` — isolated scratchpad state per subtree. `useScratchpadState()` now context-aware with module-singleton fallback (zero-breaking for v4.x).
+- **`<FeedbackInline>`** — per-message thumbs up/down, non-blocking. Complements `ChatPrompt` (modal) and `ScratchpadPanel` feedback section (panel-side).
+- **`onElicitation` event + `elicitationToPromptConfig()` helper** — MCP `elicitation/create` (spec 2025-06-18) mapped to `ChatPromptConfig`. Smart mapping : single boolean → confirm, single enum ≤4 → choice, everything else → form with per-property field inference.
+- **29 new tests** (438 → 467). Scope doc : `docs/2026/r&d/mcpui-v5.2.0-scope.md` in the Deposium project.
+
 ## What's New in v5.1.0 (`mcp-ui-solid` only)
 
 - **`optionRenderer` render prop** on `ChoicePromptConfig` — take full control of option bodies (confidence badges, rich layouts). mcp-ui still wraps the returned JSX in its own `<button>` with `onClick` + focus handling. See `optionRenderer (v5.1.0)` tests in `ChatPrompt.test.tsx` for usage.
 - **Generic `ChoicePromptConfig<TMeta>`** — `ChoiceOption<TMeta>` flows through so your renderer closures get strongly-typed `option.metadata` without casting. Default `TMeta = Record<string, unknown>` keeps the non-generic shape valid for existing callers.
 - **`buttonClass?` + `containerClass?`** escape hatches on `ChoicePromptConfig` — Tailwind class extensions that append to mcp-ui's defaults for light cosmetic tweaks without writing a full renderer.
 - **`type="button"` on option buttons** — prevents accidental form submission when a `ChatPrompt` is nested inside an HTML `<form>`.
-- **`ChatPrompt` + `showChatPrompt` JSDoc rewritten** — explicitly states the consumer contract : no default handler, Promise wiring is host-side, `AbortSignal` rejects with `DOMException('AbortError')` per Web Platform convention, re-entrance policy is host-enforced. Full reference wiring example in the README below. A `createChatPromptController()` primitive landing in v5.2.0 will bundle all of this.
+- **`ChatPrompt` + `showChatPrompt` JSDoc rewritten** — explicitly states the consumer contract : no default handler, Promise wiring is host-side, `AbortSignal` rejects with `DOMException('AbortError')` per Web Platform convention, re-entrance policy is host-enforced. Now available as a one-call primitive via `createChatPromptController()` in v5.2.0.
 
 ## What's New in v5.0.0
 
@@ -417,18 +425,60 @@ Every `ChatPrompt` exchange ends in one of three outcomes:
 | Dismissed | Click the X icon, click Cancel (confirm type) | `true` | resolves |
 | Aborted | Host app rejects the Promise via `AbortSignal` | *(n/a — never resolves)* | rejects with `DOMException('AbortError')` |
 
-> **v5.1.0 note** — `showChatPrompt` has **no default handler** in mcp-ui.
-> The command name is declared on the bus, but every consumer wires its own
-> handler. The handler is responsible for threading the Promise resolver
-> through the SolidJS lifecycle AND for honouring the optional `AbortSignal`.
-> A `createChatPromptController()` primitive that bundles all of this will
-> land in v5.2.0 — see the v5.1.0 design doc.
+> **v5.2.0** — use `createChatPromptController()` (below). The manual pattern
+> documented after it is kept for context and for consumers who prefer full
+> control over the resolver lifecycle.
+
+#### Recommended — `createChatPromptController()` (v5.2.0)
+
+```tsx
+import { Show } from 'solid-js'
+import {
+  ChatPrompt,
+  useChatBus,
+  createChatPromptController,
+  PromptReplacedError,
+} from '@seed-ship/mcp-ui-solid'
+
+function HitlHost() {
+  const bus = useChatBus()
+  const ctrl = createChatPromptController()
+  bus.commands.handle('showChatPrompt', ctrl.handle)
+
+  return (
+    <Show when={ctrl.activePrompt()}>
+      {(cfg) => (
+        <ChatPrompt
+          config={cfg()}
+          onSubmit={ctrl.resolveActive}
+          onDismiss={ctrl.dismissActive}
+        />
+      )}
+    </Show>
+  )
+}
+```
+
+Caller-side, re-entrance and abort are standard :
+
+```ts
+try {
+  const response = await bus.commands.exec('showChatPrompt', config, ac.signal)
+  // ...
+} catch (err) {
+  if (err instanceof PromptReplacedError) return           // superseded by a newer prompt
+  if (err instanceof Error && err.name === 'AbortError') return  // navigation killed it
+  throw err
+}
+```
+
+`ctrl.abort(reason?)` is also available for programmatic cancellation
+(modal close, route change, ...).
 
-#### Wiring a handler yourself (v5.1.0)
+#### Manual wiring (v5.1.0 reference pattern)
 
-Until the v5.2.0 controller ships, here is the reference pattern every
-consumer should implement. It honours re-entrance (auto-reject the previous
-prompt) and `AbortSignal` (rejects with a Web-Platform `DOMException`):
+Equivalent to the controller above — useful if you want full control over
+the resolver closure, or if you're maintaining a v5.1.0 codebase :
 
 ```tsx
 import { createSignal } from 'solid-js'
@@ -513,8 +563,9 @@ try {
 }
 ```
 
-Once `createChatPromptController()` ships in v5.2.0 this boilerplate
-collapses to `bus.commands.handle('showChatPrompt', ctrl.handle)`.
+v5.2.0 collapses this to a single `createChatPromptController()` call — see
+above. Prefer the controller unless you have a reason to manage the
+lifecycle yourself.
 
 ### correlationId — host-propagated (v4.3.9)
 

package/dist/components/ElicitationForm.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const web = require("solid-js/web");
+const ChatPrompt = require("./ChatPrompt.cjs");
+const chatBus = require("../services/chat-bus.cjs");
+const ElicitationForm = (props) => {
+  const config = () => chatBus.elicitationToPromptConfig(props.event);
+  const handleSubmit = (response) => {
+    var _a;
+    if (response.dismissed) {
+      (_a = props.onDecline ?? props.onCancel) == null ? void 0 : _a();
+      return;
+    }
+    props.onAccept(extractContent(response, props.event));
+  };
+  return web.createComponent(ChatPrompt.ChatPrompt, {
+    get config() {
+      return config();
+    },
+    get dismissLabel() {
+      return props.dismissLabel;
+    },
+    onSubmit: handleSubmit
+  });
+};
+function extractContent(response, event) {
+  if (typeof response.value !== "string") {
+    return response.value;
+  }
+  const propEntries = Object.entries(event.requestedSchema.properties);
+  if (propEntries.length === 1) {
+    const [name, schema] = propEntries[0];
+    return {
+      [name]: coerceScalar(response.value, schema)
+    };
+  }
+  console.warn("[MCP-UI] ElicitationForm: received string value for multi-property schema. Falling back to _value.");
+  return {
+    _value: response.value
+  };
+}
+function coerceScalar(value, schema) {
+  if (schema.type === "boolean") return true;
+  if (schema.type === "number" || schema.type === "integer") {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : value;
+  }
+  return value;
+}
+exports.ElicitationForm = ElicitationForm;
+//# sourceMappingURL=ElicitationForm.cjs.map

package/dist/components/ElicitationForm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElicitationForm.cjs","sources":["../../src/components/ElicitationForm.tsx"],"sourcesContent":["/**\n * ElicitationForm — schema-driven renderer for MCP `elicitation/create` requests\n *\n * @experimental\n * @since v5.3.0\n *\n * Thin wrapper over `<ChatPrompt>` + `elicitationToPromptConfig()` that\n * accepts a spec-shaped `ElicitationEvent` (MCP 2025-06-18) and exposes a\n * spec-shaped `onAccept(content)` callback whose payload is ready to send\n * back as the `accept` outcome of an `elicitation/create` reply.\n *\n * The mapping (boolean → confirm, single enum ≤4 → choice, else → form) is\n * delegated to the `elicitationToPromptConfig` helper — same rules, same\n * tests. This component owns the inverse mapping : extracting a spec-shaped\n * `Record<string, unknown>` from the `ChatPromptResponse`.\n *\n * ## Outcome semantics (per MCP spec 2025-06-18)\n *\n * | User action                           | Callback fired     | Payload                          |\n * |---------------------------------------|--------------------|----------------------------------|\n * | Submit form / pick choice / confirm   | `onAccept(content)`| `{ [propName]: value, ... }`     |\n * | X icon / Cancel button                | `onCancel()` *or* `onDecline()` if provided | none                |\n *\n * mcp-ui's `<ChatPrompt>` does not natively distinguish \"decline\" (explicit\n * refusal) from \"cancel\" (passive close). To surface a decline action,\n * pass `dismissLabel=\"Decline\"` and route the callback via `onDecline`.\n *\n * @example\n * ```tsx\n * bus.events.on('onElicitation', ({ elicitation }) => {\n *   render(() => (\n *     <ElicitationForm\n *       event={elicitation}\n *       onAccept={(content) => sendElicitationReply({ action: 'accept', content })}\n *       onCancel={() => sendElicitationReply({ action: 'cancel' })}\n *     />\n *   ), mountPoint)\n * })\n * ```\n */\n\nimport { Component } from 'solid-js'\nimport { ChatPrompt } from './ChatPrompt'\nimport { elicitationToPromptConfig } from '../services/chat-bus'\nimport type {\n  ChatPromptResponse,\n  ElicitationEvent,\n  ElicitationPropertySchema,\n} from '../types/chat-bus'\n\nexport interface ElicitationFormProps {\n  /** MCP `elicitation/create` request payload to render. */\n  event: ElicitationEvent\n  /**\n   * Called when user submits a valid response. `content` is keyed by the\n   * elicitation `requestedSchema.properties` names — ready to send back as\n   * the `accept` outcome of an `elicitation/create` reply.\n   */\n  onAccept: (content: Record<string, unknown>) => void\n  /** Called when user dismisses (X icon, confirm-cancel button). */\n  onCancel?: () => void\n  /**\n   * Optional explicit decline action. When provided, takes precedence over\n   * `onCancel` on dismiss. Pair with `dismissLabel=\"Decline\"` to surface as\n   * a decline action in the UI.\n   */\n  onDecline?: () => void\n  /** Label on the dismiss button (default: X icon). */\n  dismissLabel?: string\n}\n\n/**\n * @experimental\n * Schema-driven renderer for MCP `elicitation/create` requests.\n */\nexport const ElicitationForm: Component<ElicitationFormProps> = (props) => {\n  const config = () => elicitationToPromptConfig(props.event)\n\n  const handleSubmit = (response: ChatPromptResponse): void => {\n    if (response.dismissed) {\n      ;(props.onDecline ?? props.onCancel)?.()\n      return\n    }\n    props.onAccept(extractContent(response, props.event))\n  }\n\n  return <ChatPrompt config={config()} dismissLabel={props.dismissLabel} onSubmit={handleSubmit} />\n}\n\nfunction extractContent(\n  response: ChatPromptResponse,\n  event: ElicitationEvent\n): Record<string, unknown> {\n  // Form: response.value is already a Record keyed by property names.\n  if (typeof response.value !== 'string') {\n    return response.value\n  }\n\n  const propEntries = Object.entries(event.requestedSchema.properties)\n\n  // Single-property cases (boolean confirm or single enum choice).\n  if (propEntries.length === 1) {\n    const [name, schema] = propEntries[0]\n    return { [name]: coerceScalar(response.value, schema) }\n  }\n\n  // Multi-property string response — shouldn't happen since the helper\n  // routes multi-prop schemas to 'form'. Fall back gracefully.\n  console.warn(\n    '[MCP-UI] ElicitationForm: received string value for multi-property schema. Falling back to _value.'\n  )\n  return { _value: response.value }\n}\n\nfunction coerceScalar(value: string, schema: ElicitationPropertySchema): unknown {\n  // Confirm always emits the literal 'confirmed' on accept (cancel path is\n  // trapped earlier by `dismissed: true`). Map to boolean true.\n  if (schema.type === 'boolean') return true\n\n  if (schema.type === 'number' || schema.type === 'integer') {\n    const n = Number(value)\n    return Number.isFinite(n) ? n : value\n  }\n\n  return value\n}\n"],"names":["ElicitationForm","props","config","elicitationToPromptConfig","event","handleSubmit","response","dismissed","onDecline","onCancel","onAccept","extractContent","_$createComponent","ChatPrompt","dismissLabel","onSubmit","value","propEntries","Object","entries","requestedSchema","properties","length","name","schema","coerceScalar","console","warn","_value","type","n","Number","isFinite"],"mappings":";;;;;AA2EO,MAAMA,kBAAoDC,CAAAA,UAAU;AACzE,QAAMC,SAASA,MAAMC,kCAA0BF,MAAMG,KAAK;AAE1D,QAAMC,eAAeA,CAACC,aAAuC;;AAC3D,QAAIA,SAASC,WAAW;AACrB,OAACN,WAAMO,aAAaP,MAAMQ,aAAzBR;AACF;AAAA,IACF;AACAA,UAAMS,SAASC,eAAeL,UAAUL,MAAMG,KAAK,CAAC;AAAA,EACtD;AAEA,SAAAQ,IAAAA,gBAAQC,WAAAA,YAAU;AAAA,IAAA,IAACX,SAAM;AAAA,aAAEA,OAAAA;AAAAA,IAAQ;AAAA,IAAA,IAAEY,eAAY;AAAA,aAAEb,MAAMa;AAAAA,IAAY;AAAA,IAAEC,UAAUV;AAAAA,EAAAA,CAAY;AAC/F;AAEA,SAASM,eACPL,UACAF,OACyB;AAEzB,MAAI,OAAOE,SAASU,UAAU,UAAU;AACtC,WAAOV,SAASU;AAAAA,EAClB;AAEA,QAAMC,cAAcC,OAAOC,QAAQf,MAAMgB,gBAAgBC,UAAU;AAGnE,MAAIJ,YAAYK,WAAW,GAAG;AAC5B,UAAM,CAACC,MAAMC,MAAM,IAAIP,YAAY,CAAC;AACpC,WAAO;AAAA,MAAE,CAACM,IAAI,GAAGE,aAAanB,SAASU,OAAOQ,MAAM;AAAA,IAAA;AAAA,EACtD;AAIAE,UAAQC,KACN,oGACF;AACA,SAAO;AAAA,IAAEC,QAAQtB,SAASU;AAAAA,EAAAA;AAC5B;AAEA,SAASS,aAAaT,OAAeQ,QAA4C;AAG/E,MAAIA,OAAOK,SAAS,UAAW,QAAO;AAEtC,MAAIL,OAAOK,SAAS,YAAYL,OAAOK,SAAS,WAAW;AACzD,UAAMC,IAAIC,OAAOf,KAAK;AACtB,WAAOe,OAAOC,SAASF,CAAC,IAAIA,IAAId;AAAAA,EAClC;AAEA,SAAOA;AACT;;"}

package/dist/components/ElicitationForm.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ElicitationForm — schema-driven renderer for MCP `elicitation/create` requests
+ *
+ * @experimental
+ * @since v5.3.0
+ *
+ * Thin wrapper over `<ChatPrompt>` + `elicitationToPromptConfig()` that
+ * accepts a spec-shaped `ElicitationEvent` (MCP 2025-06-18) and exposes a
+ * spec-shaped `onAccept(content)` callback whose payload is ready to send
+ * back as the `accept` outcome of an `elicitation/create` reply.
+ *
+ * The mapping (boolean → confirm, single enum ≤4 → choice, else → form) is
+ * delegated to the `elicitationToPromptConfig` helper — same rules, same
+ * tests. This component owns the inverse mapping : extracting a spec-shaped
+ * `Record<string, unknown>` from the `ChatPromptResponse`.
+ *
+ * ## Outcome semantics (per MCP spec 2025-06-18)
+ *
+ * | User action                           | Callback fired     | Payload                          |
+ * |---------------------------------------|--------------------|----------------------------------|
+ * | Submit form / pick choice / confirm   | `onAccept(content)`| `{ [propName]: value, ... }`     |
+ * | X icon / Cancel button                | `onCancel()` *or* `onDecline()` if provided | none                |
+ *
+ * mcp-ui's `<ChatPrompt>` does not natively distinguish "decline" (explicit
+ * refusal) from "cancel" (passive close). To surface a decline action,
+ * pass `dismissLabel="Decline"` and route the callback via `onDecline`.
+ *
+ * @example
+ * ```tsx
+ * bus.events.on('onElicitation', ({ elicitation }) => {
+ *   render(() => (
+ *     <ElicitationForm
+ *       event={elicitation}
+ *       onAccept={(content) => sendElicitationReply({ action: 'accept', content })}
+ *       onCancel={() => sendElicitationReply({ action: 'cancel' })}
+ *     />
+ *   ), mountPoint)
+ * })
+ * ```
+ */
+import { Component } from 'solid-js';
+import type { ElicitationEvent } from '../types/chat-bus';
+export interface ElicitationFormProps {
+    /** MCP `elicitation/create` request payload to render. */
+    event: ElicitationEvent;
+    /**
+     * Called when user submits a valid response. `content` is keyed by the
+     * elicitation `requestedSchema.properties` names — ready to send back as
+     * the `accept` outcome of an `elicitation/create` reply.
+     */
+    onAccept: (content: Record<string, unknown>) => void;
+    /** Called when user dismisses (X icon, confirm-cancel button). */
+    onCancel?: () => void;
+    /**
+     * Optional explicit decline action. When provided, takes precedence over
+     * `onCancel` on dismiss. Pair with `dismissLabel="Decline"` to surface as
+     * a decline action in the UI.
+     */
+    onDecline?: () => void;
+    /** Label on the dismiss button (default: X icon). */
+    dismissLabel?: string;
+}
+/**
+ * @experimental
+ * Schema-driven renderer for MCP `elicitation/create` requests.
+ */
+export declare const ElicitationForm: Component<ElicitationFormProps>;
+//# sourceMappingURL=ElicitationForm.d.ts.map

package/dist/components/ElicitationForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElicitationForm.d.ts","sourceRoot":"","sources":["../../src/components/ElicitationForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAGpC,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,KAAK,EAAE,gBAAgB,CAAA;IACvB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACpD,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,oBAAoB,CAY3D,CAAA"}

package/dist/components/ElicitationForm.js

@@ -0,0 +1,51 @@
+import { createComponent } from "solid-js/web";
+import { ChatPrompt } from "./ChatPrompt.js";
+import { elicitationToPromptConfig } from "../services/chat-bus.js";
+const ElicitationForm = (props) => {
+  const config = () => elicitationToPromptConfig(props.event);
+  const handleSubmit = (response) => {
+    var _a;
+    if (response.dismissed) {
+      (_a = props.onDecline ?? props.onCancel) == null ? void 0 : _a();
+      return;
+    }
+    props.onAccept(extractContent(response, props.event));
+  };
+  return createComponent(ChatPrompt, {
+    get config() {
+      return config();
+    },
+    get dismissLabel() {
+      return props.dismissLabel;
+    },
+    onSubmit: handleSubmit
+  });
+};
+function extractContent(response, event) {
+  if (typeof response.value !== "string") {
+    return response.value;
+  }
+  const propEntries = Object.entries(event.requestedSchema.properties);
+  if (propEntries.length === 1) {
+    const [name, schema] = propEntries[0];
+    return {
+      [name]: coerceScalar(response.value, schema)
+    };
+  }
+  console.warn("[MCP-UI] ElicitationForm: received string value for multi-property schema. Falling back to _value.");
+  return {
+    _value: response.value
+  };
+}
+function coerceScalar(value, schema) {
+  if (schema.type === "boolean") return true;
+  if (schema.type === "number" || schema.type === "integer") {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : value;
+  }
+  return value;
+}
+export {
+  ElicitationForm
+};
+//# sourceMappingURL=ElicitationForm.js.map

package/dist/components/ElicitationForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElicitationForm.js","sources":["../../src/components/ElicitationForm.tsx"],"sourcesContent":["/**\n * ElicitationForm — schema-driven renderer for MCP `elicitation/create` requests\n *\n * @experimental\n * @since v5.3.0\n *\n * Thin wrapper over `<ChatPrompt>` + `elicitationToPromptConfig()` that\n * accepts a spec-shaped `ElicitationEvent` (MCP 2025-06-18) and exposes a\n * spec-shaped `onAccept(content)` callback whose payload is ready to send\n * back as the `accept` outcome of an `elicitation/create` reply.\n *\n * The mapping (boolean → confirm, single enum ≤4 → choice, else → form) is\n * delegated to the `elicitationToPromptConfig` helper — same rules, same\n * tests. This component owns the inverse mapping : extracting a spec-shaped\n * `Record<string, unknown>` from the `ChatPromptResponse`.\n *\n * ## Outcome semantics (per MCP spec 2025-06-18)\n *\n * | User action                           | Callback fired     | Payload                          |\n * |---------------------------------------|--------------------|----------------------------------|\n * | Submit form / pick choice / confirm   | `onAccept(content)`| `{ [propName]: value, ... }`     |\n * | X icon / Cancel button                | `onCancel()` *or* `onDecline()` if provided | none                |\n *\n * mcp-ui's `<ChatPrompt>` does not natively distinguish \"decline\" (explicit\n * refusal) from \"cancel\" (passive close). To surface a decline action,\n * pass `dismissLabel=\"Decline\"` and route the callback via `onDecline`.\n *\n * @example\n * ```tsx\n * bus.events.on('onElicitation', ({ elicitation }) => {\n *   render(() => (\n *     <ElicitationForm\n *       event={elicitation}\n *       onAccept={(content) => sendElicitationReply({ action: 'accept', content })}\n *       onCancel={() => sendElicitationReply({ action: 'cancel' })}\n *     />\n *   ), mountPoint)\n * })\n * ```\n */\n\nimport { Component } from 'solid-js'\nimport { ChatPrompt } from './ChatPrompt'\nimport { elicitationToPromptConfig } from '../services/chat-bus'\nimport type {\n  ChatPromptResponse,\n  ElicitationEvent,\n  ElicitationPropertySchema,\n} from '../types/chat-bus'\n\nexport interface ElicitationFormProps {\n  /** MCP `elicitation/create` request payload to render. */\n  event: ElicitationEvent\n  /**\n   * Called when user submits a valid response. `content` is keyed by the\n   * elicitation `requestedSchema.properties` names — ready to send back as\n   * the `accept` outcome of an `elicitation/create` reply.\n   */\n  onAccept: (content: Record<string, unknown>) => void\n  /** Called when user dismisses (X icon, confirm-cancel button). */\n  onCancel?: () => void\n  /**\n   * Optional explicit decline action. When provided, takes precedence over\n   * `onCancel` on dismiss. Pair with `dismissLabel=\"Decline\"` to surface as\n   * a decline action in the UI.\n   */\n  onDecline?: () => void\n  /** Label on the dismiss button (default: X icon). */\n  dismissLabel?: string\n}\n\n/**\n * @experimental\n * Schema-driven renderer for MCP `elicitation/create` requests.\n */\nexport const ElicitationForm: Component<ElicitationFormProps> = (props) => {\n  const config = () => elicitationToPromptConfig(props.event)\n\n  const handleSubmit = (response: ChatPromptResponse): void => {\n    if (response.dismissed) {\n      ;(props.onDecline ?? props.onCancel)?.()\n      return\n    }\n    props.onAccept(extractContent(response, props.event))\n  }\n\n  return <ChatPrompt config={config()} dismissLabel={props.dismissLabel} onSubmit={handleSubmit} />\n}\n\nfunction extractContent(\n  response: ChatPromptResponse,\n  event: ElicitationEvent\n): Record<string, unknown> {\n  // Form: response.value is already a Record keyed by property names.\n  if (typeof response.value !== 'string') {\n    return response.value\n  }\n\n  const propEntries = Object.entries(event.requestedSchema.properties)\n\n  // Single-property cases (boolean confirm or single enum choice).\n  if (propEntries.length === 1) {\n    const [name, schema] = propEntries[0]\n    return { [name]: coerceScalar(response.value, schema) }\n  }\n\n  // Multi-property string response — shouldn't happen since the helper\n  // routes multi-prop schemas to 'form'. Fall back gracefully.\n  console.warn(\n    '[MCP-UI] ElicitationForm: received string value for multi-property schema. Falling back to _value.'\n  )\n  return { _value: response.value }\n}\n\nfunction coerceScalar(value: string, schema: ElicitationPropertySchema): unknown {\n  // Confirm always emits the literal 'confirmed' on accept (cancel path is\n  // trapped earlier by `dismissed: true`). Map to boolean true.\n  if (schema.type === 'boolean') return true\n\n  if (schema.type === 'number' || schema.type === 'integer') {\n    const n = Number(value)\n    return Number.isFinite(n) ? n : value\n  }\n\n  return value\n}\n"],"names":["ElicitationForm","props","config","elicitationToPromptConfig","event","handleSubmit","response","dismissed","onDecline","onCancel","onAccept","extractContent","_$createComponent","ChatPrompt","dismissLabel","onSubmit","value","propEntries","Object","entries","requestedSchema","properties","length","name","schema","coerceScalar","console","warn","_value","type","n","Number","isFinite"],"mappings":";;;AA2EO,MAAMA,kBAAoDC,CAAAA,UAAU;AACzE,QAAMC,SAASA,MAAMC,0BAA0BF,MAAMG,KAAK;AAE1D,QAAMC,eAAeA,CAACC,aAAuC;;AAC3D,QAAIA,SAASC,WAAW;AACrB,OAACN,WAAMO,aAAaP,MAAMQ,aAAzBR;AACF;AAAA,IACF;AACAA,UAAMS,SAASC,eAAeL,UAAUL,MAAMG,KAAK,CAAC;AAAA,EACtD;AAEA,SAAAQ,gBAAQC,YAAU;AAAA,IAAA,IAACX,SAAM;AAAA,aAAEA,OAAAA;AAAAA,IAAQ;AAAA,IAAA,IAAEY,eAAY;AAAA,aAAEb,MAAMa;AAAAA,IAAY;AAAA,IAAEC,UAAUV;AAAAA,EAAAA,CAAY;AAC/F;AAEA,SAASM,eACPL,UACAF,OACyB;AAEzB,MAAI,OAAOE,SAASU,UAAU,UAAU;AACtC,WAAOV,SAASU;AAAAA,EAClB;AAEA,QAAMC,cAAcC,OAAOC,QAAQf,MAAMgB,gBAAgBC,UAAU;AAGnE,MAAIJ,YAAYK,WAAW,GAAG;AAC5B,UAAM,CAACC,MAAMC,MAAM,IAAIP,YAAY,CAAC;AACpC,WAAO;AAAA,MAAE,CAACM,IAAI,GAAGE,aAAanB,SAASU,OAAOQ,MAAM;AAAA,IAAA;AAAA,EACtD;AAIAE,UAAQC,KACN,oGACF;AACA,SAAO;AAAA,IAAEC,QAAQtB,SAASU;AAAAA,EAAAA;AAC5B;AAEA,SAASS,aAAaT,OAAeQ,QAA4C;AAG/E,MAAIA,OAAOK,SAAS,UAAW,QAAO;AAEtC,MAAIL,OAAOK,SAAS,YAAYL,OAAOK,SAAS,WAAW;AACzD,UAAMC,IAAIC,OAAOf,KAAK;AACtB,WAAOe,OAAOC,SAASF,CAAC,IAAIA,IAAId;AAAAA,EAClC;AAEA,SAAOA;AACT;"}

package/dist/components/FeedbackInline.cjs

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const web = require("solid-js/web");
+const solidJs = require("solid-js");
+var _tmpl$ = /* @__PURE__ */ web.template(`<button type=button class="p-1 rounded hover:bg-green-500/10 text-deposium-slate-500 hover:text-green-500 transition-colors"title=Utile aria-label="Mark response as useful"data-feedback-inline-rating=positive><svg class="w-3.5 h-3.5"fill=none stroke=currentColor viewBox="0 0 24 24"><path stroke-linecap=round stroke-linejoin=round stroke-width=2 d="M14 9V5a3 3 0 00-3-3l-4 9v11h11.28a2 2 0 002-1.7l1.38-9a2 2 0 00-2-2.3H14z M3 15v7">`), _tmpl$2 = /* @__PURE__ */ web.template(`<button type=button class="p-1 rounded hover:bg-red-500/10 text-deposium-slate-500 hover:text-red-500 transition-colors"title="Pas utile"aria-label="Mark response as not useful"data-feedback-inline-rating=negative><svg class="w-3.5 h-3.5"fill=none stroke=currentColor viewBox="0 0 24 24"><path stroke-linecap=round stroke-linejoin=round stroke-width=2 d="M10 15v4a3 3 0 003 3l4-9V2H5.72a2 2 0 00-2 1.7l-1.38 9a2 2 0 002 2.3H10z M21 4v7">`), _tmpl$3 = /* @__PURE__ */ web.template(`<div>`), _tmpl$4 = /* @__PURE__ */ web.template(`<span class="text-[11px] text-deposium-slate-500">`);
+const FeedbackInline = (props) => {
+  const [rating, setRating] = solidJs.createSignal(null);
+  const handle = (value) => {
+    if (rating() !== null) return;
+    setRating(value);
+    try {
+      const result = props.onSubmit(value, props.context);
+      if (result && typeof result.catch === "function") {
+        ;
+        result.catch(() => {
+        });
+      }
+    } catch {
+    }
+  };
+  return (() => {
+    var _el$ = web.getNextElement(_tmpl$3);
+    web.insert(_el$, web.createComponent(solidJs.Show, {
+      get when() {
+        return rating() === null;
+      },
+      get fallback() {
+        return (() => {
+          var _el$4 = web.getNextElement(_tmpl$4);
+          web.insert(_el$4, (() => {
+            var _c$ = web.memo(() => rating() === "positive");
+            return () => _c$() ? props.positiveAck ?? "Merci !" : props.negativeAck ?? "Noté, on s'améliore";
+          })());
+          return _el$4;
+        })();
+      },
+      get children() {
+        return [(() => {
+          var _el$2 = web.getNextElement(_tmpl$);
+          _el$2.$$click = () => handle("positive");
+          web.runHydrationEvents();
+          return _el$2;
+        })(), (() => {
+          var _el$3 = web.getNextElement(_tmpl$2);
+          _el$3.$$click = () => handle("negative");
+          web.runHydrationEvents();
+          return _el$3;
+        })()];
+      }
+    }));
+    web.effect(() => web.className(_el$, `flex items-center gap-1 ${props.class ?? ""}`.trim()));
+    return _el$;
+  })();
+};
+web.delegateEvents(["click"]);
+exports.FeedbackInline = FeedbackInline;
+//# sourceMappingURL=FeedbackInline.cjs.map

package/dist/components/FeedbackInline.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackInline.cjs","sources":["../../src/components/FeedbackInline.tsx"],"sourcesContent":["/**\n * FeedbackInline — per-message inline feedback (thumbs up/down)\n *\n * @experimental\n * @since v5.2.0\n *\n * A small, non-blocking per-message feedback primitive. Sits next to an\n * assistant message, captures a rating, calls back to the consumer for\n * persistence. Best-effort by design — no retry UX, no revision UX.\n *\n * ## When to use vs other feedback primitives\n *\n * - **`FeedbackInline`** (this) → per-message thumb-up/down, non-blocking,\n *   many can coexist.\n * - **`ChatPrompt` (type=choice)** → modal, one-at-a-time above the input,\n *   used when the agent needs a blocking answer.\n * - **`ScratchpadPanel` feedback section** → structured feedback bound to a\n *   scratchpad turn, panel-side.\n *\n * ## Persistence is the consumer's job\n *\n * The component flips to \"submitted\" state *optimistically* on click and\n * calls `onSubmit(rating, context)`. Network failures do not revert the UI —\n * feedback is best-effort. If you need stricter semantics (offline retry,\n * revision, ...) wrap this in your own component.\n *\n * @example\n * ```tsx\n * <FeedbackInline\n *   messageHash={msg.hash}\n *   context={{ intent: msg.intent, confidenceBand: msg.band }}\n *   onSubmit={(rating, ctx) =>\n *     fetch('/api/feedback', {\n *       method: 'POST',\n *       headers: { 'Content-Type': 'application/json' },\n *       body: JSON.stringify({ message_hash: msg.hash, rating, ...ctx }),\n *     })\n *   }\n * />\n * ```\n */\n\nimport { Component, Show, createSignal } from 'solid-js'\n\nexport interface FeedbackInlineContext {\n  intent?: string\n  confidenceBand?: string\n  tags?: string[]\n  [key: string]: unknown\n}\n\nexport interface FeedbackInlineProps {\n  /** Stable identifier for the message being rated. */\n  messageHash?: string\n  /**\n   * Called on click. Consumer is responsible for persistence (HTTP, store,\n   * localStorage). Return value ignored.\n   */\n  onSubmit: (rating: 'positive' | 'negative', context?: FeedbackInlineContext) => void | Promise<void>\n  /** Extra context forwarded to `onSubmit`. */\n  context?: FeedbackInlineContext\n  /** Ack text shown after positive rating. Default: 'Merci !' */\n  positiveAck?: string\n  /** Ack text shown after negative rating. Default: \"Noté, on s'améliore\" */\n  negativeAck?: string\n  /** Extra Tailwind classes on the container. */\n  class?: string\n}\n\n/**\n * @experimental\n * Per-message inline feedback (thumbs up/down). Non-blocking.\n */\nexport const FeedbackInline: Component<FeedbackInlineProps> = (props) => {\n  const [rating, setRating] = createSignal<'positive' | 'negative' | null>(null)\n\n  const handle = (value: 'positive' | 'negative') => {\n    if (rating() !== null) return // already submitted, final state\n    setRating(value)\n    try {\n      // Fire-and-forget. If the consumer returns a Promise that rejects,\n      // swallow it — feedback is best-effort by design.\n      const result = props.onSubmit(value, props.context)\n      if (result && typeof (result as Promise<void>).catch === 'function') {\n        ;(result as Promise<void>).catch(() => {\n          /* non-blocking */\n        })\n      }\n    } catch {\n      /* non-blocking */\n    }\n  }\n\n  return (\n    <div class={`flex items-center gap-1 ${props.class ?? ''}`.trim()}>\n      <Show\n        when={rating() === null}\n        fallback={\n          <span class=\"text-[11px] text-deposium-slate-500\">\n            {rating() === 'positive'\n              ? (props.positiveAck ?? 'Merci !')\n              : (props.negativeAck ?? \"Noté, on s'améliore\")}\n          </span>\n        }\n      >\n        <button\n          type=\"button\"\n          onClick={() => handle('positive')}\n          class=\"p-1 rounded hover:bg-green-500/10 text-deposium-slate-500 hover:text-green-500 transition-colors\"\n          title=\"Utile\"\n          aria-label=\"Mark response as useful\"\n          data-feedback-inline-rating=\"positive\"\n        >\n          <svg class=\"w-3.5 h-3.5\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n            <path\n              stroke-linecap=\"round\"\n              stroke-linejoin=\"round\"\n              stroke-width=\"2\"\n              d=\"M14 9V5a3 3 0 00-3-3l-4 9v11h11.28a2 2 0 002-1.7l1.38-9a2 2 0 00-2-2.3H14z M3 15v7\"\n            />\n          </svg>\n        </button>\n        <button\n          type=\"button\"\n          onClick={() => handle('negative')}\n          class=\"p-1 rounded hover:bg-red-500/10 text-deposium-slate-500 hover:text-red-500 transition-colors\"\n          title=\"Pas utile\"\n          aria-label=\"Mark response as not useful\"\n          data-feedback-inline-rating=\"negative\"\n        >\n          <svg class=\"w-3.5 h-3.5\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n            <path\n              stroke-linecap=\"round\"\n              stroke-linejoin=\"round\"\n              stroke-width=\"2\"\n              d=\"M10 15v4a3 3 0 003 3l4-9V2H5.72a2 2 0 00-2 1.7l-1.38 9a2 2 0 002 2.3H10z M21 4v7\"\n            />\n          </svg>\n        </button>\n      </Show>\n    </div>\n  )\n}\n"],"names":["FeedbackInline","props","rating","setRating","createSignal","handle","value","result","onSubmit","context","catch","_el$","_$getNextElement","_tmpl$3","_$insert","_$createComponent","Show","when","fallback","_el$4","_tmpl$4","_c$","_$memo","positiveAck","negativeAck","children","_el$2","_tmpl$","$$click","_$runHydrationEvents","_el$3","_tmpl$2","_$effect","_$className","class","trim","_$delegateEvents"],"mappings":";;;;;AAyEO,MAAMA,iBAAkDC,CAAAA,UAAU;AACvE,QAAM,CAACC,QAAQC,SAAS,IAAIC,QAAAA,aAA6C,IAAI;AAE7E,QAAMC,SAASA,CAACC,UAAmC;AACjD,QAAIJ,OAAAA,MAAa,KAAM;AACvBC,cAAUG,KAAK;AACf,QAAI;AAGF,YAAMC,SAASN,MAAMO,SAASF,OAAOL,MAAMQ,OAAO;AAClD,UAAIF,UAAU,OAAQA,OAAyBG,UAAU,YAAY;AACnE;AAAEH,eAAyBG,MAAM,MAAM;AAAA,QACrC,CACD;AAAA,MACH;AAAA,IACF,QAAQ;AAAA,IACN;AAAA,EAEJ;AAEA,UAAA,MAAA;AAAA,QAAAC,OAAAC,IAAAA,eAAAC,OAAA;AAAAC,eAAAH,MAAAI,IAAAA,gBAEKC,cAAI;AAAA,MAAA,IACHC,OAAI;AAAA,eAAEf,aAAa;AAAA,MAAI;AAAA,MAAA,IACvBgB,WAAQ;AAAA,gBAAA,MAAA;AAAA,cAAAC,QAAAP,IAAAA,eAAAQ,OAAA;AAAAN,cAAAA,OAAAK,QAAA,MAAA;AAAA,gBAAAE,MAAAC,IAAAA,KAAA,MAEHpB,OAAAA,MAAa,UAAU;AAAA,mBAAA,MAAvBmB,IAAAA,IACIpB,MAAMsB,eAAe,YACrBtB,MAAMuB,eAAe;AAAA,UAAsB,IAAA;AAAA,iBAAAL;AAAAA,QAAA,GAAA;AAAA,MAAA;AAAA,MAAA,IAAAM,WAAA;AAAA,eAAA,EAAA,MAAA;AAAA,cAAAC,QAAAd,IAAAA,eAAAe,MAAA;AAAAD,gBAAAE,UAMzC,MAAMvB,OAAO,UAAU;AAACwB,iCAAAA;AAAA,iBAAAH;AAAAA,QAAA,GAAA,IAAA,MAAA;AAAA,cAAAI,QAAAlB,IAAAA,eAAAmB,OAAA;AAAAD,gBAAAF,UAiBxB,MAAMvB,OAAO,UAAU;AAACwB,iCAAAA;AAAA,iBAAAC;AAAAA,QAAA,IAAA;AAAA,MAAA;AAAA,IAAA,CAAA,CAAA;AAAAE,QAAAA,OAAA,MAAAC,IAAAA,UAAAtB,MA9B3B,2BAA2BV,MAAMiC,SAAS,EAAE,GAAGC,KAAAA,CAAM,CAAA;AAAA,WAAAxB;AAAAA,EAAA,GAAA;AAgDrE;AAACyB,IAAAA,eAAA,CAAA,OAAA,CAAA;;"}

package/dist/components/FeedbackInline.d.ts

@@ -0,0 +1,71 @@
+/**
+ * FeedbackInline — per-message inline feedback (thumbs up/down)
+ *
+ * @experimental
+ * @since v5.2.0
+ *
+ * A small, non-blocking per-message feedback primitive. Sits next to an
+ * assistant message, captures a rating, calls back to the consumer for
+ * persistence. Best-effort by design — no retry UX, no revision UX.
+ *
+ * ## When to use vs other feedback primitives
+ *
+ * - **`FeedbackInline`** (this) → per-message thumb-up/down, non-blocking,
+ *   many can coexist.
+ * - **`ChatPrompt` (type=choice)** → modal, one-at-a-time above the input,
+ *   used when the agent needs a blocking answer.
+ * - **`ScratchpadPanel` feedback section** → structured feedback bound to a
+ *   scratchpad turn, panel-side.
+ *
+ * ## Persistence is the consumer's job
+ *
+ * The component flips to "submitted" state *optimistically* on click and
+ * calls `onSubmit(rating, context)`. Network failures do not revert the UI —
+ * feedback is best-effort. If you need stricter semantics (offline retry,
+ * revision, ...) wrap this in your own component.
+ *
+ * @example
+ * ```tsx
+ * <FeedbackInline
+ *   messageHash={msg.hash}
+ *   context={{ intent: msg.intent, confidenceBand: msg.band }}
+ *   onSubmit={(rating, ctx) =>
+ *     fetch('/api/feedback', {
+ *       method: 'POST',
+ *       headers: { 'Content-Type': 'application/json' },
+ *       body: JSON.stringify({ message_hash: msg.hash, rating, ...ctx }),
+ *     })
+ *   }
+ * />
+ * ```
+ */
+import { Component } from 'solid-js';
+export interface FeedbackInlineContext {
+    intent?: string;
+    confidenceBand?: string;
+    tags?: string[];
+    [key: string]: unknown;
+}
+export interface FeedbackInlineProps {
+    /** Stable identifier for the message being rated. */
+    messageHash?: string;
+    /**
+     * Called on click. Consumer is responsible for persistence (HTTP, store,
+     * localStorage). Return value ignored.
+     */
+    onSubmit: (rating: 'positive' | 'negative', context?: FeedbackInlineContext) => void | Promise<void>;
+    /** Extra context forwarded to `onSubmit`. */
+    context?: FeedbackInlineContext;
+    /** Ack text shown after positive rating. Default: 'Merci !' */
+    positiveAck?: string;
+    /** Ack text shown after negative rating. Default: "Noté, on s'améliore" */
+    negativeAck?: string;
+    /** Extra Tailwind classes on the container. */
+    class?: string;
+}
+/**
+ * @experimental
+ * Per-message inline feedback (thumbs up/down). Non-blocking.
+ */
+export declare const FeedbackInline: Component<FeedbackInlineProps>;
+//# sourceMappingURL=FeedbackInline.d.ts.map

package/dist/components/FeedbackInline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackInline.d.ts","sourceRoot":"","sources":["../../src/components/FeedbackInline.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,SAAS,EAAsB,MAAM,UAAU,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpG,6CAA6C;IAC7C,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,CAAC,mBAAmB,CAqEzD,CAAA"}

package/dist/components/FeedbackInline.js

@@ -0,0 +1,57 @@
+import { delegateEvents, getNextElement, template, insert, createComponent, runHydrationEvents, memo, effect, className } from "solid-js/web";
+import { createSignal, Show } from "solid-js";
+var _tmpl$ = /* @__PURE__ */ template(`<button type=button class="p-1 rounded hover:bg-green-500/10 text-deposium-slate-500 hover:text-green-500 transition-colors"title=Utile aria-label="Mark response as useful"data-feedback-inline-rating=positive><svg class="w-3.5 h-3.5"fill=none stroke=currentColor viewBox="0 0 24 24"><path stroke-linecap=round stroke-linejoin=round stroke-width=2 d="M14 9V5a3 3 0 00-3-3l-4 9v11h11.28a2 2 0 002-1.7l1.38-9a2 2 0 00-2-2.3H14z M3 15v7">`), _tmpl$2 = /* @__PURE__ */ template(`<button type=button class="p-1 rounded hover:bg-red-500/10 text-deposium-slate-500 hover:text-red-500 transition-colors"title="Pas utile"aria-label="Mark response as not useful"data-feedback-inline-rating=negative><svg class="w-3.5 h-3.5"fill=none stroke=currentColor viewBox="0 0 24 24"><path stroke-linecap=round stroke-linejoin=round stroke-width=2 d="M10 15v4a3 3 0 003 3l4-9V2H5.72a2 2 0 00-2 1.7l-1.38 9a2 2 0 002 2.3H10z M21 4v7">`), _tmpl$3 = /* @__PURE__ */ template(`<div>`), _tmpl$4 = /* @__PURE__ */ template(`<span class="text-[11px] text-deposium-slate-500">`);
+const FeedbackInline = (props) => {
+  const [rating, setRating] = createSignal(null);
+  const handle = (value) => {
+    if (rating() !== null) return;
+    setRating(value);
+    try {
+      const result = props.onSubmit(value, props.context);
+      if (result && typeof result.catch === "function") {
+        ;
+        result.catch(() => {
+        });
+      }
+    } catch {
+    }
+  };
+  return (() => {
+    var _el$ = getNextElement(_tmpl$3);
+    insert(_el$, createComponent(Show, {
+      get when() {
+        return rating() === null;
+      },
+      get fallback() {
+        return (() => {
+          var _el$4 = getNextElement(_tmpl$4);
+          insert(_el$4, (() => {
+            var _c$ = memo(() => rating() === "positive");
+            return () => _c$() ? props.positiveAck ?? "Merci !" : props.negativeAck ?? "Noté, on s'améliore";
+          })());
+          return _el$4;
+        })();
+      },
+      get children() {
+        return [(() => {
+          var _el$2 = getNextElement(_tmpl$);
+          _el$2.$$click = () => handle("positive");
+          runHydrationEvents();
+          return _el$2;
+        })(), (() => {
+          var _el$3 = getNextElement(_tmpl$2);
+          _el$3.$$click = () => handle("negative");
+          runHydrationEvents();
+          return _el$3;
+        })()];
+      }
+    }));
+    effect(() => className(_el$, `flex items-center gap-1 ${props.class ?? ""}`.trim()));
+    return _el$;
+  })();
+};
+delegateEvents(["click"]);
+export {
+  FeedbackInline
+};
+//# sourceMappingURL=FeedbackInline.js.map