@seed-ship/mcp-ui-solid 4.2.0 → 4.2.2

package/CHANGELOG.md

@@ -5,6 +5,34 @@ 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).
 
+## [4.2.2] - 2026-04-11
+
+### Added — Prefilled Forms with Source Indicators
+
+#### Form field prefill (`prefill`, `source`, `displayHint`, `muted`)
+- **`prefill`** — pre-populated value on form fields (string or string[] for multi-select)
+- **`source`** — how the value was obtained: `detected`, `inferred`, `default`, `user`
+- **`displayHint`** — human-readable caption below the field (e.g. "Rhône — déduit de Lyon")
+- **`muted`** — reduced opacity styling, clears on focus/click for seamless editing
+- Source badges: checkmark for detected, link for inferred, pencil for user-provided
+- Backward-compatible — fields without prefill render exactly as before
+
+#### Auto-submit countdown (`autoSubmitDelay`)
+- When all required fields are prefilled, shows "Submit in Ns..." with cancel button
+- Any user interaction cancels the countdown
+- Server controls via `autoSubmitDelay` (1000–30000ms) on form params
+
+#### EmbeddedFormSection (scratchpad forms)
+- Initializes `formData` with `field.prefill` values (was always `{}`)
+- Re-applies prefill on streaming SSE updates without overwriting user edits
+- Full auto-submit countdown support
+
+### Changed
+- `@seed-ship/mcp-ui-spec` bumped to 3.1.0 (new schema fields)
+- `FormFieldSchema` adds `prefill`, `displayHint`, `source`, `muted`
+- `FormComponentParamsSchema` adds `autoSubmitDelay`
+- `PrefillSourceSchema` and `PrefillSource` type exported
+
 ## [4.0.0] - 2026-04-07
 
 ### Added — Data Verification Layer (anti-hallucination)

package/README.md

@@ -5,6 +5,44 @@ 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 v4.2
+
+- **Prefilled Forms** — Fields render with pre-populated values + source indicators (detected/inferred/default/user)
+- **Source badges** — Visual cues showing how each value was obtained (checkmark, link, pencil icons)
+- **Muted fields** — High-confidence prefills display with reduced opacity, activate on focus/click
+- **Display hints** — Caption below prefilled fields (e.g. "Rhône — déduit de Lyon")
+- **Auto-submit countdown** — When all required fields are prefilled, optional countdown with cancel
+
+### Prefilled Form Example
+
+```tsx
+// SSE payload — server sends prefill + source on each field
+{
+  fields: [
+    {
+      name: 'departement', type: 'select',
+      options: [{ value: '69', label: 'Rhône' }, ...],
+      prefill: '69',
+      displayHint: 'Rhône — déduit de Lyon',
+      source: 'inferred',
+      muted: true,
+    },
+    {
+      name: 'commune', type: 'text',
+      prefill: 'Lyon',
+      source: 'detected',
+      muted: true,
+    },
+    {
+      name: 'type_bien', type: 'select',
+      options: [{ value: '', label: 'Tous' }, ...],
+      // No prefill — user must choose
+    },
+  ],
+  autoSubmitDelay: 3000, // optional countdown
+}
+```
+
 ## What's New in v4.0.0
 
 - **Data Verification Layer** - Anti-hallucination: `validateAgainstSource()` detects ~90% of numerical hallucinations, zero LLM cost, <1ms