@seed-ship/mcp-ui-solid 6.19.1 → 6.20.0

package/dist/utils/degraded-projections.js

@@ -1,3 +1,21 @@
+import { formatMCPUIString } from "./format-string.js";
+const DEGRADED_PROJECTION_LABELS = {
+  source: "Source",
+  target: "Target",
+  label: "Label",
+  node: "Node",
+  type: "Type",
+  lat: "Lat",
+  lng: "Lng",
+  info: "Info",
+  marker: "marker",
+  feature: "feature",
+  series: "Series {n}"
+};
+const withLabels = (labels) => ({
+  ...DEGRADED_PROJECTION_LABELS,
+  ...labels
+});
 const MAX_PROJECTED_ROWS = 200;
 function cell(value) {
   if (value == null) return "";
@@ -10,11 +28,12 @@ function cell(value) {
   }
   return String(value);
 }
-function graphToDegradedTable(params) {
+function graphToDegradedTable(params, labels) {
+  const l = withLabels(labels);
   const edges = params.edges ?? [];
   if (edges.length > 0) {
     return {
-      columns: ["Source", "Target", "Label"],
+      columns: [l.source, l.target, l.label],
       rows: edges.slice(0, MAX_PROJECTED_ROWS).map((e) => {
         const label = [e.weight != null ? String(e.weight) : "", e.label ?? ""].filter(Boolean).join(" · ");
         return [cell(e.source), cell(e.target), label];
@@ -23,7 +42,7 @@ function graphToDegradedTable(params) {
   }
   const nodes = params.nodes ?? [];
   return {
-    columns: ["Node", "Label"],
+    columns: [l.node, l.label],
     rows: nodes.slice(0, MAX_PROJECTED_ROWS).map((n) => [cell(n.id), cell(n.label ?? n.id)])
   };
 }
@@ -35,13 +54,14 @@ function firstLngLat(coords) {
   }
   return null;
 }
-function mapToDegradedTable(params) {
+function mapToDegradedTable(params, labels) {
   var _a, _b, _c, _d;
+  const l = withLabels(labels);
   const rows = [];
   for (const m of params.markers ?? []) {
     const lat = Array.isArray(m.position) ? m.position[0] : (_a = m.position) == null ? void 0 : _a.lat;
     const lng = Array.isArray(m.position) ? m.position[1] : (_b = m.position) == null ? void 0 : _b.lng;
-    rows.push(["marker", cell(lat), cell(lng), cell(m.tooltip ?? m.popup ?? "")]);
+    rows.push([l.marker, cell(lat), cell(lng), cell(m.tooltip ?? m.popup ?? "")]);
   }
   const fc = params.geojson;
   const features = Array.isArray(fc == null ? void 0 : fc.features) ? fc.features : [];
@@ -50,29 +70,33 @@ function mapToDegradedTable(params) {
     const props = f.properties ?? {};
     const propSummary = Object.keys(props).slice(0, 3).map((k) => `${k}=${cell(props[k])}`).join(", ");
     rows.push([
-      cell(((_d = f.geometry) == null ? void 0 : _d.type) ?? "feature"),
+      cell(((_d = f.geometry) == null ? void 0 : _d.type) ?? l.feature),
       ll ? cell(ll[1]) : "",
       ll ? cell(ll[0]) : "",
       propSummary
     ]);
   }
   return {
-    columns: ["Type", "Lat", "Lng", "Info"],
+    columns: [l.type, l.lat, l.lng, l.info],
     rows: rows.slice(0, MAX_PROJECTED_ROWS)
   };
 }
-function chartToDegradedTable(params) {
+function chartToDegradedTable(params, labels) {
   var _a, _b;
+  const l = withLabels(labels);
   const datasets = ((_a = params.data) == null ? void 0 : _a.datasets) ?? [];
-  const labels = ((_b = params.data) == null ? void 0 : _b.labels) ?? [];
-  const rowCount = Math.max(labels.length, ...datasets.map((d) => {
+  const dataLabels = ((_b = params.data) == null ? void 0 : _b.labels) ?? [];
+  const rowCount = Math.max(dataLabels.length, ...datasets.map((d) => {
     var _a2;
     return ((_a2 = d.data) == null ? void 0 : _a2.length) ?? 0;
   }), 0);
-  const columns = ["", ...datasets.map((d, i) => d.label ?? `Series ${i + 1}`)];
+  const columns = [
+    "",
+    ...datasets.map((d, i) => d.label ?? formatMCPUIString(l.series, { n: i + 1 }))
+  ];
   const rows = [];
   for (let r = 0; r < Math.min(rowCount, MAX_PROJECTED_ROWS); r++) {
-    rows.push([cell(labels[r] ?? r + 1), ...datasets.map((d) => {
+    rows.push([cell(dataLabels[r] ?? r + 1), ...datasets.map((d) => {
       var _a2;
       return cell((_a2 = d.data) == null ? void 0 : _a2[r]);
     })]);
@@ -80,6 +104,7 @@ function chartToDegradedTable(params) {
   return { columns, rows };
 }
 export {
+  DEGRADED_PROJECTION_LABELS,
   chartToDegradedTable,
   graphToDegradedTable,
   mapToDegradedTable

package/dist/utils/degraded-projections.js.map

@@ -1 +1 @@
-{"version":3,"file":"degraded-projections.js","sources":["../../src/utils/degraded-projections.ts"],"sourcesContent":["/**\n * Degraded-fallback projections (audit 2026-05-30, P2.5).\n *\n * Pure functions that turn a heavy renderer's params into a flat\n * `{ columns, rows }` table for `<DegradedFallback>` — the middle rung of\n * the fallback ladder shown when the native render (G6 / Leaflet / Chart.js)\n * is unavailable or throws. No peer deps, no side effects, fully testable.\n *\n * These are best-effort views: they surface the underlying data so the user\n * isn't left with a blank space, not faithful reproductions of the chart/\n * map/graph.\n */\n\nexport interface DegradedTable {\n  columns: string[];\n  rows: Array<Array<string | number>>;\n}\n\nconst MAX_PROJECTED_ROWS = 200;\n\n/** Compact a value to a single table cell string. */\nfunction cell(value: unknown): string {\n  if (value == null) return '';\n  if (typeof value === 'object') {\n    try {\n      return JSON.stringify(value);\n    } catch {\n      return String(value);\n    }\n  }\n  return String(value);\n}\n\n// ─── Graph ───────────────────────────────────────────────────────────────\n\n/**\n * Graph → edge table when edges exist (Source / Target / Label), else a\n * node list (Node / Label). The graph renderer can therefore degrade to a\n * readable relationship listing instead of a blank canvas.\n */\nexport function graphToDegradedTable(params: {\n  nodes?: Array<{ id: string; label?: string }>;\n  edges?: Array<{ source: string; target: string; label?: string; weight?: number }>;\n}): DegradedTable {\n  const edges = params.edges ?? [];\n  if (edges.length > 0) {\n    return {\n      columns: ['Source', 'Target', 'Label'],\n      rows: edges.slice(0, MAX_PROJECTED_ROWS).map((e) => {\n        const label = [e.weight != null ? String(e.weight) : '', e.label ?? '']\n          .filter(Boolean)\n          .join(' · ');\n        return [cell(e.source), cell(e.target), label];\n      }),\n    };\n  }\n  const nodes = params.nodes ?? [];\n  return {\n    columns: ['Node', 'Label'],\n    rows: nodes.slice(0, MAX_PROJECTED_ROWS).map((n) => [cell(n.id), cell(n.label ?? n.id)]),\n  };\n}\n\n// ─── Map ───────────────────────────────────────────────────────────────────\n\ninterface GeoJSONLikeFeature {\n  geometry?: { type?: string; coordinates?: unknown } | null;\n  properties?: Record<string, unknown> | null;\n}\n\n/** Pull a representative `[lng, lat]` pair out of a geometry's coordinates. */\nfunction firstLngLat(coords: unknown): [number, number] | null {\n  let c: unknown = coords;\n  // Descend nested arrays until we reach a [number, number, ...] position.\n  while (Array.isArray(c) && Array.isArray(c[0])) c = c[0];\n  if (Array.isArray(c) && typeof c[0] === 'number' && typeof c[1] === 'number') {\n    return [c[0], c[1]];\n  }\n  return null;\n}\n\n/**\n * Map → a coordinate table. Markers become Lat/Lng/Label rows; GeoJSON\n * features become Type / Lat / Lng (+ a compact properties summary). So a\n * map that can't paint still lists where its points are.\n */\nexport function mapToDegradedTable(params: {\n  markers?: Array<{\n    position: [number, number] | { lat: number; lng: number };\n    tooltip?: string;\n    popup?: string;\n  }>;\n  geojson?: unknown;\n}): DegradedTable {\n  const rows: Array<Array<string | number>> = [];\n\n  for (const m of params.markers ?? []) {\n    const lat = Array.isArray(m.position) ? m.position[0] : m.position?.lat;\n    const lng = Array.isArray(m.position) ? m.position[1] : m.position?.lng;\n    rows.push(['marker', cell(lat), cell(lng), cell(m.tooltip ?? m.popup ?? '')]);\n  }\n\n  const fc = params.geojson as { features?: GeoJSONLikeFeature[] } | undefined;\n  const features = Array.isArray(fc?.features) ? fc!.features : [];\n  for (const f of features) {\n    const ll = firstLngLat(f.geometry?.coordinates);\n    const props = f.properties ?? {};\n    const propSummary = Object.keys(props)\n      .slice(0, 3)\n      .map((k) => `${k}=${cell(props[k])}`)\n      .join(', ');\n    rows.push([\n      cell(f.geometry?.type ?? 'feature'),\n      ll ? cell(ll[1]) : '',\n      ll ? cell(ll[0]) : '',\n      propSummary,\n    ]);\n  }\n\n  return {\n    columns: ['Type', 'Lat', 'Lng', 'Info'],\n    rows: rows.slice(0, MAX_PROJECTED_ROWS),\n  };\n}\n\n// ─── Chart ───────────────────────────────────────────────────────────────\n\n/**\n * Chart → a series table: one row per label, one column per dataset. So a\n * chart that can't draw still shows its numbers. Point/object data (scatter,\n * bubble, time series) is stringified per cell.\n */\nexport function chartToDegradedTable(params: {\n  data?: {\n    labels?: Array<string | number>;\n    datasets?: Array<{ label?: string; data?: unknown[] }>;\n  };\n}): DegradedTable {\n  const datasets = params.data?.datasets ?? [];\n  const labels = params.data?.labels ?? [];\n  const rowCount = Math.max(labels.length, ...datasets.map((d) => d.data?.length ?? 0), 0);\n\n  const columns = ['', ...datasets.map((d, i) => d.label ?? `Series ${i + 1}`)];\n  const rows: Array<Array<string | number>> = [];\n  for (let r = 0; r < Math.min(rowCount, MAX_PROJECTED_ROWS); r++) {\n    rows.push([cell(labels[r] ?? r + 1), ...datasets.map((d) => cell(d.data?.[r]))]);\n  }\n  return { columns, rows };\n}\n"],"names":["_a"],"mappings":"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"}
+{"version":3,"file":"degraded-projections.js","sources":["../../src/utils/degraded-projections.ts"],"sourcesContent":["/**\n * Degraded-fallback projections (audit 2026-05-30, P2.5).\n *\n * Pure functions that turn a heavy renderer's params into a flat\n * `{ columns, rows }` table for `<DegradedFallback>` — the middle rung of\n * the fallback ladder shown when the native render (G6 / Leaflet / Chart.js)\n * is unavailable or throws. No peer deps, no side effects, fully testable.\n *\n * These are best-effort views: they surface the underlying data so the user\n * isn't left with a blank space, not faithful reproductions of the chart/\n * map/graph.\n */\n\nimport { formatMCPUIString } from './format-string';\n\n/**\n * Column headers and series names of the degraded tables.\n *\n * The projections are pure helpers with no access to `MCPUIStrings`, so the\n * wording is injected: each function takes an optional trailing `labels`\n * partial, and the renderers feed it from `useMCPUIStrings()`. Left out, the\n * English defaults below apply — the pre-v6.20.0 behaviour.\n *\n * @since v6.20.0\n */\nexport interface DegradedProjectionLabels {\n  /** Graph edge table — source column. */\n  source: string;\n  /** Graph edge table — target column. */\n  target: string;\n  /** Graph edge / node table — label column. */\n  label: string;\n  /** Graph node table — node id column. */\n  node: string;\n  /** Map table — feature type column. */\n  type: string;\n  /** Map table — latitude column. */\n  lat: string;\n  /** Map table — longitude column. */\n  lng: string;\n  /** Map table — property summary column. */\n  info: string;\n  /** Map table — `Type` cell of a marker row (v6.20.0, 6th pass). */\n  marker: string;\n  /** Map table — `Type` cell of a GeoJSON feature without a geometry type (v6.20.0). */\n  feature: string;\n  /** Chart table — fallback dataset name. Template — `{n}`. */\n  series: string;\n}\n\n/** English defaults for {@link DegradedProjectionLabels}. */\nexport const DEGRADED_PROJECTION_LABELS: DegradedProjectionLabels = {\n  source: 'Source',\n  target: 'Target',\n  label: 'Label',\n  node: 'Node',\n  type: 'Type',\n  lat: 'Lat',\n  lng: 'Lng',\n  info: 'Info',\n  marker: 'marker',\n  feature: 'feature',\n  series: 'Series {n}',\n};\n\nconst withLabels = (labels?: Partial<DegradedProjectionLabels>): DegradedProjectionLabels => ({\n  ...DEGRADED_PROJECTION_LABELS,\n  ...labels,\n});\n\nexport interface DegradedTable {\n  columns: string[];\n  rows: Array<Array<string | number>>;\n}\n\nconst MAX_PROJECTED_ROWS = 200;\n\n/** Compact a value to a single table cell string. */\nfunction cell(value: unknown): string {\n  if (value == null) return '';\n  if (typeof value === 'object') {\n    try {\n      return JSON.stringify(value);\n    } catch {\n      return String(value);\n    }\n  }\n  return String(value);\n}\n\n// ─── Graph ───────────────────────────────────────────────────────────────\n\n/**\n * Graph → edge table when edges exist (Source / Target / Label), else a\n * node list (Node / Label). The graph renderer can therefore degrade to a\n * readable relationship listing instead of a blank canvas.\n */\nexport function graphToDegradedTable(params: {\n  nodes?: Array<{ id: string; label?: string }>;\n  edges?: Array<{ source: string; target: string; label?: string; weight?: number }>;\n}, labels?: Partial<DegradedProjectionLabels>): DegradedTable {\n  const l = withLabels(labels);\n  const edges = params.edges ?? [];\n  if (edges.length > 0) {\n    return {\n      columns: [l.source, l.target, l.label],\n      rows: edges.slice(0, MAX_PROJECTED_ROWS).map((e) => {\n        const label = [e.weight != null ? String(e.weight) : '', e.label ?? '']\n          .filter(Boolean)\n          .join(' · ');\n        return [cell(e.source), cell(e.target), label];\n      }),\n    };\n  }\n  const nodes = params.nodes ?? [];\n  return {\n    columns: [l.node, l.label],\n    rows: nodes.slice(0, MAX_PROJECTED_ROWS).map((n) => [cell(n.id), cell(n.label ?? n.id)]),\n  };\n}\n\n// ─── Map ───────────────────────────────────────────────────────────────────\n\ninterface GeoJSONLikeFeature {\n  geometry?: { type?: string; coordinates?: unknown } | null;\n  properties?: Record<string, unknown> | null;\n}\n\n/** Pull a representative `[lng, lat]` pair out of a geometry's coordinates. */\nfunction firstLngLat(coords: unknown): [number, number] | null {\n  let c: unknown = coords;\n  // Descend nested arrays until we reach a [number, number, ...] position.\n  while (Array.isArray(c) && Array.isArray(c[0])) c = c[0];\n  if (Array.isArray(c) && typeof c[0] === 'number' && typeof c[1] === 'number') {\n    return [c[0], c[1]];\n  }\n  return null;\n}\n\n/**\n * Map → a coordinate table. Markers become Lat/Lng/Label rows; GeoJSON\n * features become Type / Lat / Lng (+ a compact properties summary). So a\n * map that can't paint still lists where its points are.\n */\nexport function mapToDegradedTable(params: {\n  markers?: Array<{\n    position: [number, number] | { lat: number; lng: number };\n    tooltip?: string;\n    popup?: string;\n  }>;\n  geojson?: unknown;\n}, labels?: Partial<DegradedProjectionLabels>): DegradedTable {\n  const l = withLabels(labels);\n  const rows: Array<Array<string | number>> = [];\n\n  for (const m of params.markers ?? []) {\n    const lat = Array.isArray(m.position) ? m.position[0] : m.position?.lat;\n    const lng = Array.isArray(m.position) ? m.position[1] : m.position?.lng;\n    rows.push([l.marker, cell(lat), cell(lng), cell(m.tooltip ?? m.popup ?? '')]);\n  }\n\n  const fc = params.geojson as { features?: GeoJSONLikeFeature[] } | undefined;\n  const features = Array.isArray(fc?.features) ? fc!.features : [];\n  for (const f of features) {\n    const ll = firstLngLat(f.geometry?.coordinates);\n    const props = f.properties ?? {};\n    const propSummary = Object.keys(props)\n      .slice(0, 3)\n      .map((k) => `${k}=${cell(props[k])}`)\n      .join(', ');\n    rows.push([\n      cell(f.geometry?.type ?? l.feature),\n      ll ? cell(ll[1]) : '',\n      ll ? cell(ll[0]) : '',\n      propSummary,\n    ]);\n  }\n\n  return {\n    columns: [l.type, l.lat, l.lng, l.info],\n    rows: rows.slice(0, MAX_PROJECTED_ROWS),\n  };\n}\n\n// ─── Chart ───────────────────────────────────────────────────────────────\n\n/**\n * Chart → a series table: one row per label, one column per dataset. So a\n * chart that can't draw still shows its numbers. Point/object data (scatter,\n * bubble, time series) is stringified per cell.\n */\nexport function chartToDegradedTable(params: {\n  data?: {\n    labels?: Array<string | number>;\n    datasets?: Array<{ label?: string; data?: unknown[] }>;\n  };\n}, labels?: Partial<DegradedProjectionLabels>): DegradedTable {\n  const l = withLabels(labels);\n  const datasets = params.data?.datasets ?? [];\n  const dataLabels = params.data?.labels ?? [];\n  const rowCount = Math.max(dataLabels.length, ...datasets.map((d) => d.data?.length ?? 0), 0);\n\n  const columns = [\n    '',\n    ...datasets.map((d, i) => d.label ?? formatMCPUIString(l.series, { n: i + 1 })),\n  ];\n  const rows: Array<Array<string | number>> = [];\n  for (let r = 0; r < Math.min(rowCount, MAX_PROJECTED_ROWS); r++) {\n    rows.push([cell(dataLabels[r] ?? r + 1), ...datasets.map((d) => cell(d.data?.[r]))]);\n  }\n  return { columns, rows };\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/utils/format-string.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function formatMCPUIString(template, vars) {
+  return template.replace(
+    /\{(\w+)\}/g,
+    (match, name) => Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : match
+  );
+}
+exports.formatMCPUIString = formatMCPUIString;
+//# sourceMappingURL=format-string.cjs.map

package/dist/utils/format-string.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-string.cjs","sources":["../../src/utils/format-string.ts"],"sourcesContent":["/**\n * `formatMCPUIString` — the chrome-string template helper, runtime-free.\n *\n * @since v6.20.0 (extracted from `MCPUIStringsContext` so the pure adapters\n * under `src/adapters` can interpolate their own message templates without\n * importing `solid-js`). `MCPUIStringsContext` re-exports it, so every\n * existing import path — including the root barrel — keeps working.\n *\n * This module imports nothing. It must stay that way: `src/adapters/*` is\n * published as a dedicated subpath that never pulls in the renderer.\n */\n\n/**\n * Substitutes `{name}` placeholders in a chrome string template.\n *\n * Only the keys present in `vars` are replaced; an unknown placeholder is\n * left verbatim so a mistyped or locale-specific template degrades to\n * visible text rather than to `undefined`.\n *\n * @example\n * ```ts\n * formatMCPUIString('Sort by {column}', { column: 'Revenue' }) // 'Sort by Revenue'\n * formatMCPUIString('Export CSV ({count} rows)', { count: 42 }) // 'Export CSV (42 rows)'\n * ```\n */\nexport function formatMCPUIString(\n  template: string,\n  vars: Record<string, string | number>\n): string {\n  return template.replace(/\\{(\\w+)\\}/g, (match, name: string) =>\n    Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : match\n  )\n}\n"],"names":[],"mappings":";;AAyBO,SAAS,kBACd,UACA,MACQ;AACR,SAAO,SAAS;AAAA,IAAQ;AAAA,IAAc,CAAC,OAAO,SAC5C,OAAO,UAAU,eAAe,KAAK,MAAM,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,IAAI;AAAA,EAAA;AAE5E;;"}

package/dist/utils/format-string.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `formatMCPUIString` — the chrome-string template helper, runtime-free.
+ *
+ * @since v6.20.0 (extracted from `MCPUIStringsContext` so the pure adapters
+ * under `src/adapters` can interpolate their own message templates without
+ * importing `solid-js`). `MCPUIStringsContext` re-exports it, so every
+ * existing import path — including the root barrel — keeps working.
+ *
+ * This module imports nothing. It must stay that way: `src/adapters/*` is
+ * published as a dedicated subpath that never pulls in the renderer.
+ */
+/**
+ * Substitutes `{name}` placeholders in a chrome string template.
+ *
+ * Only the keys present in `vars` are replaced; an unknown placeholder is
+ * left verbatim so a mistyped or locale-specific template degrades to
+ * visible text rather than to `undefined`.
+ *
+ * @example
+ * ```ts
+ * formatMCPUIString('Sort by {column}', { column: 'Revenue' }) // 'Sort by Revenue'
+ * formatMCPUIString('Export CSV ({count} rows)', { count: 42 }) // 'Export CSV (42 rows)'
+ * ```
+ */
+export declare function formatMCPUIString(template: string, vars: Record<string, string | number>): string;
+//# sourceMappingURL=format-string.d.ts.map

package/dist/utils/format-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-string.d.ts","sourceRoot":"","sources":["../../src/utils/format-string.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACpC,MAAM,CAIR"}

package/dist/utils/format-string.js

@@ -0,0 +1,10 @@
+function formatMCPUIString(template, vars) {
+  return template.replace(
+    /\{(\w+)\}/g,
+    (match, name) => Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : match
+  );
+}
+export {
+  formatMCPUIString
+};
+//# sourceMappingURL=format-string.js.map

package/dist/utils/format-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-string.js","sources":["../../src/utils/format-string.ts"],"sourcesContent":["/**\n * `formatMCPUIString` — the chrome-string template helper, runtime-free.\n *\n * @since v6.20.0 (extracted from `MCPUIStringsContext` so the pure adapters\n * under `src/adapters` can interpolate their own message templates without\n * importing `solid-js`). `MCPUIStringsContext` re-exports it, so every\n * existing import path — including the root barrel — keeps working.\n *\n * This module imports nothing. It must stay that way: `src/adapters/*` is\n * published as a dedicated subpath that never pulls in the renderer.\n */\n\n/**\n * Substitutes `{name}` placeholders in a chrome string template.\n *\n * Only the keys present in `vars` are replaced; an unknown placeholder is\n * left verbatim so a mistyped or locale-specific template degrades to\n * visible text rather than to `undefined`.\n *\n * @example\n * ```ts\n * formatMCPUIString('Sort by {column}', { column: 'Revenue' }) // 'Sort by Revenue'\n * formatMCPUIString('Export CSV ({count} rows)', { count: 42 }) // 'Export CSV (42 rows)'\n * ```\n */\nexport function formatMCPUIString(\n  template: string,\n  vars: Record<string, string | number>\n): string {\n  return template.replace(/\\{(\\w+)\\}/g, (match, name: string) =>\n    Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : match\n  )\n}\n"],"names":[],"mappings":"AAyBO,SAAS,kBACd,UACA,MACQ;AACR,SAAO,SAAS;AAAA,IAAQ;AAAA,IAAc,CAAC,OAAO,SAC5C,OAAO,UAAU,eAAe,KAAK,MAAM,IAAI,IAAI,OAAO,KAAK,IAAI,CAAC,IAAI;AAAA,EAAA;AAE5E;"}

package/dist/validation.cjs

@@ -2,9 +2,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const validation = require("./services/validation.cjs");
 exports.DEFAULT_RESOURCE_LIMITS = validation.DEFAULT_RESOURCE_LIMITS;
+exports.DEFAULT_VALIDATION_MESSAGES = validation.DEFAULT_VALIDATION_MESSAGES;
 exports.sanitizeString = validation.sanitizeString;
 exports.validateChartComponent = validation.validateChartComponent;
 exports.validateComponent = validation.validateComponent;
+exports.validateFieldValue = validation.validateFieldValue;
+exports.validateFormData = validation.validateFormData;
 exports.validateGridPosition = validation.validateGridPosition;
 exports.validateIframeDomain = validation.validateIframeDomain;
 exports.validateLayout = validation.validateLayout;

package/dist/validation.cjs.map

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

package/dist/validation.d.cts

@@ -9,6 +9,7 @@
  * import { validateLayout } from '@seed-ship/mcp-ui-solid/validation'
  * ```
  */
-export { validateComponent, validateLayout, validateGridPosition, validateChartComponent, validateTableComponent, validatePayloadSize, validateIframeDomain, sanitizeString, DEFAULT_RESOURCE_LIMITS, } from './services/validation';
+export { validateComponent, validateLayout, validateGridPosition, validateChartComponent, validateTableComponent, validatePayloadSize, validateIframeDomain, sanitizeString, DEFAULT_RESOURCE_LIMITS, validateFieldValue, validateFormData, DEFAULT_VALIDATION_MESSAGES, } from './services/validation';
+export type { FormValidationMessages } from './services/validation';
 export type { UIComponent, UILayout, GridPosition, ComponentType, ChartComponentParams, TableComponentParams, MetricComponentParams, TextComponentParams, ValidationResult, ResourceLimits, } from './types';
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts

@@ -9,6 +9,7 @@
  * import { validateLayout } from '@seed-ship/mcp-ui-solid/validation'
  * ```
  */
-export { validateComponent, validateLayout, validateGridPosition, validateChartComponent, validateTableComponent, validatePayloadSize, validateIframeDomain, sanitizeString, DEFAULT_RESOURCE_LIMITS, } from './services/validation';
+export { validateComponent, validateLayout, validateGridPosition, validateChartComponent, validateTableComponent, validatePayloadSize, validateIframeDomain, sanitizeString, DEFAULT_RESOURCE_LIMITS, validateFieldValue, validateFormData, DEFAULT_VALIDATION_MESSAGES, } from './services/validation';
+export type { FormValidationMessages } from './services/validation';
 export type { UIComponent, UILayout, GridPosition, ComponentType, ChartComponentParams, TableComponentParams, MetricComponentParams, TextComponentParams, ValidationResult, ResourceLimits, } from './types';
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAG9B,YAAY,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAA"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EAEvB,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAGnE,YAAY,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAA"}

package/dist/validation.js

@@ -1,9 +1,12 @@
-import { DEFAULT_RESOURCE_LIMITS, sanitizeString, validateChartComponent, validateComponent, validateGridPosition, validateIframeDomain, validateLayout, validatePayloadSize, validateTableComponent } from "./services/validation.js";
+import { DEFAULT_RESOURCE_LIMITS, DEFAULT_VALIDATION_MESSAGES, sanitizeString, validateChartComponent, validateComponent, validateFieldValue, validateFormData, validateGridPosition, validateIframeDomain, validateLayout, validatePayloadSize, validateTableComponent } from "./services/validation.js";
 export {
   DEFAULT_RESOURCE_LIMITS,
+  DEFAULT_VALIDATION_MESSAGES,
   sanitizeString,
   validateChartComponent,
   validateComponent,
+  validateFieldValue,
+  validateFormData,
   validateGridPosition,
   validateIframeDomain,
   validateLayout,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-ship/mcp-ui-solid",
-  "version": "6.19.1",
+  "version": "6.20.0",
   "description": "SolidJS components for rendering MCP-generated UI resources",
   "type": "module",
   "files": [

package/src/adapters/connector.ts

@@ -29,6 +29,7 @@ import {
   type ConnectorAction,
 } from '@seed-ship/mcp-ui-spec'
 import { z } from 'zod'
+import { formatMCPUIString } from '../utils/format-string'
 
 // ─────────────────────────────────────────────────────────────
 // connectorActionsToActionGroup
@@ -74,11 +75,57 @@ export function connectorActionsToActionGroup(
 // connectorResultToUILayout
 // ─────────────────────────────────────────────────────────────
 
+/**
+ * The visible wording of the two degraded states (R2).
+ *
+ * These paragraphs are rendered as `text` components, so unlike the payload
+ * they are the LIBRARY's own chrome. They cannot go through
+ * `MCPUIStrings` — the adapters are runtime-free and never import
+ * `solid-js` — so a host localizes them through
+ * `ConnectorResultToUILayoutOptions.messages` instead.
+ *
+ * Every field is a template resolved with `formatMCPUIString`.
+ *
+ * @since v6.20.0 — the defaults used to be hardcoded French.
+ */
+export interface ConnectorAdapterMessages {
+  /**
+   * Unreadable payload (tier 3). Template — `{versionSuffix}` is
+   * `degradedVersionSuffix` when the payload carried a string
+   * `schemaVersion`, and `''` otherwise.
+   */
+  degradedNotice: string
+  /** Inserted into `degradedNotice`. Template — `{version}`. */
+  degradedVersionSuffix: string
+  /**
+   * Usable envelope, unknown version (tier 2). Template — `{version}` = the
+   * version read, `{expected}` = `CONNECTOR_DYNAMIC_RESULT_V1`.
+   */
+  versionWarning: string
+}
+
+/** English defaults for {@link ConnectorAdapterMessages}. */
+export const DEFAULT_CONNECTOR_MESSAGES: ConnectorAdapterMessages = {
+  degradedNotice:
+    '### Result not rendered\n\nThe connector result could not be interpreted{versionSuffix}. This explicit state replaces a silent disappearance of the rendering.',
+  degradedVersionSuffix: ' (schema: `{version}`)',
+  versionWarning:
+    '> \u26A0 Unrecognized connector schema (`{version}`, expected `{expected}`). The rendering below is in degraded mode.',
+}
+
 export interface ConnectorResultToUILayoutOptions {
   /** Layout id. Default derived from `connectorId` + `queryHash` / `toolName`. */
   id?: string
   /** Heading for the actions `action-group`. */
   actionsTitle?: string
+  /**
+   * Partial override of the degraded-state wording, merged over
+   * {@link DEFAULT_CONNECTOR_MESSAGES}. Hosts that render in another
+   * language pass their own paragraphs here.
+   *
+   * @since v6.20.0
+   */
+  messages?: Partial<ConnectorAdapterMessages>
 }
 
 /**
@@ -144,6 +191,7 @@ export function connectorResultToUILayout(
   options: ConnectorResultToUILayoutOptions = {}
 ): UILayout {
   const strict = ConnectorDynamicResultV1Schema.safeParse(result)
+  const messages: ConnectorAdapterMessages = { ...DEFAULT_CONNECTOR_MESSAGES, ...options.messages }
 
   // ── Tier 3 : unreadable ───────────────────────────────────
   if (!strict.success) {
@@ -158,9 +206,12 @@ export function connectorResultToUILayout(
         components: [
           degradedTextComponent(
             'connector-degraded-notice',
-            `### Résultat non rendu\n\nLe 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.`
+            formatMCPUIString(messages.degradedNotice, {
+              versionSuffix:
+                typeof version === 'string'
+                  ? formatMCPUIString(messages.degradedVersionSuffix, { version })
+                  : '',
+            })
           ),
         ],
         grid: { ...DEFAULT_GRID },
@@ -171,7 +222,10 @@ export function connectorResultToUILayout(
     const components: UIComponent[] = [
       degradedTextComponent(
         'connector-version-warning',
-        `> ⚠ Schéma connecteur non reconnu (\`${r.schemaVersion}\`, attendu \`${CONNECTOR_DYNAMIC_RESULT_V1}\`). Le rendu ci-dessous est en mode dégradé.`
+        formatMCPUIString(messages.versionWarning, {
+          version: r.schemaVersion,
+          expected: CONNECTOR_DYNAMIC_RESULT_V1,
+        })
       ),
       ...collectComponents(r),
     ]

package/src/adapters/index.ts

@@ -14,13 +14,23 @@
  * ```
  */
 
-export { connectorResultToUILayout, connectorActionsToActionGroup } from './connector';
+export {
+  connectorResultToUILayout,
+  connectorActionsToActionGroup,
+  DEFAULT_CONNECTOR_MESSAGES,
+} from './connector';
 export type {
   ConnectorResultToUILayoutOptions,
   ConnectorActionsToActionGroupOptions,
+  ConnectorAdapterMessages,
 } from './connector';
 
-export { macroRunToScratchpadState, macroInterrogationToChatPromptConfig } from './macro-run';
+export {
+  macroRunToScratchpadState,
+  macroInterrogationToChatPromptConfig,
+  DEFAULT_MACRO_RUN_MESSAGES,
+} from './macro-run';
+export type { MacroRunAdapterMessages, MacroRunAdapterOptions } from './macro-run';
 
 export {
   createComparisonLayout,

package/src/adapters/macro-run.ts

@@ -174,7 +174,59 @@ function resultSectionType(componentType: unknown): ScratchpadSection['type'] {
   }
 }
 
-function buildError(run: MacroRunV1): ScratchpadState['error'] | undefined {
+/**
+ * The English wording this adapter produces on its own — section titles and
+ * the fallbacks used when the run (or the interrogation) carries none.
+ *
+ * The adapter is runtime-free by contract: no `solid-js`, no
+ * `MCPUIStringsContext`. Hosts that render in another language pass a
+ * partial override through `MacroRunAdapterOptions.messages`, exactly like
+ * `ConnectorResultToUILayoutOptions.messages`.
+ *
+ * @since v6.20.0
+ */
+export interface MacroRunAdapterMessages {
+  /** Title of the always-present `agent_card` section. */
+  agentSectionTitle: string;
+  /** Title of the `stepper` / `split_stepper` section. */
+  progressSectionTitle: string;
+  /** Title of each result section. */
+  resultSectionTitle: string;
+  /** Error message of an aborted run that carries no `error`. */
+  runAborted: string;
+  /** Error message of a failed run that carries no `error`. */
+  runFailed: string;
+  /** Prompt body of an elicitation with no usable schema and no message. */
+  confirmDefault: string;
+}
+
+/** English defaults for {@link MacroRunAdapterMessages}. */
+export const DEFAULT_MACRO_RUN_MESSAGES: MacroRunAdapterMessages = {
+  agentSectionTitle: 'Agent',
+  progressSectionTitle: 'Progress',
+  resultSectionTitle: 'Result',
+  runAborted: 'Macro run aborted.',
+  runFailed: 'Macro run failed.',
+  confirmDefault: 'Please confirm to continue.',
+};
+
+/** Options shared by the MacroRun adapters. @since v6.20.0 */
+export interface MacroRunAdapterOptions {
+  /**
+   * Partial override of the adapter's own wording, merged over
+   * {@link DEFAULT_MACRO_RUN_MESSAGES}.
+   */
+  messages?: Partial<MacroRunAdapterMessages>;
+}
+
+const withMessages = (
+  options: MacroRunAdapterOptions = {}
+): MacroRunAdapterMessages => ({ ...DEFAULT_MACRO_RUN_MESSAGES, ...options.messages });
+
+function buildError(
+  run: MacroRunV1,
+  messages: MacroRunAdapterMessages
+): ScratchpadState['error'] | undefined {
   if (run.status !== 'failed' && run.status !== 'aborted') return undefined;
   const aborted = run.status === 'aborted';
   if (run.error) {
@@ -187,7 +239,7 @@ function buildError(run: MacroRunV1): ScratchpadState['error'] | undefined {
     return err;
   }
   return {
-    message: aborted ? 'Macro run aborted.' : 'Macro run failed.',
+    message: aborted ? messages.runAborted : messages.runFailed,
     retryable: false,
   };
 }
@@ -209,13 +261,17 @@ function buildError(run: MacroRunV1): ScratchpadState['error'] | undefined {
  *
  * Pure: no fetch, no SSE, no persistence. The host owns all wiring.
  */
-export function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState {
+export function macroRunToScratchpadState(
+  run: MacroRunV1,
+  options: MacroRunAdapterOptions = {}
+): ScratchpadState {
+  const messages = withMessages(options);
   const sections: ScratchpadSection[] = [];
 
   // 1. Agent card — always present.
   sections.push({
     id: 'macro-agent',
-    title: 'Agent',
+    title: messages.agentSectionTitle,
     type: 'agent_card',
     content: buildAgentCard(run),
     editable: false,
@@ -229,7 +285,7 @@ export function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState {
       hasParallel
         ? {
             id: 'macro-split-stepper',
-            title: 'Progress',
+            title: messages.progressSectionTitle,
             type: 'split_stepper',
             content: buildSplitStepperContent(run.steps),
             editable: false,
@@ -237,7 +293,7 @@ export function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState {
           }
         : {
             id: 'macro-stepper',
-            title: 'Progress',
+            title: messages.progressSectionTitle,
             type: 'stepper',
             content: buildStepperContent(run.steps),
             editable: false,
@@ -252,7 +308,7 @@ export function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState {
       id: 'macro-prompt',
       title: run.pendingInterrogation.title,
       type: 'prompt',
-      content: macroInterrogationToChatPromptConfig(run.pendingInterrogation),
+      content: macroInterrogationToChatPromptConfig(run.pendingInterrogation, options),
       editable: false,
       source: 'agent',
     });
@@ -265,7 +321,7 @@ export function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState {
   results.forEach((component, index) => {
     sections.push({
       id: `macro-result-${String(component?.id ?? index)}`,
-      title: 'Result',
+      title: messages.resultSectionTitle,
       type: resultSectionType(component?.type),
       content: component,
       editable: false,
@@ -282,7 +338,7 @@ export function macroRunToScratchpadState(run: MacroRunV1): ScratchpadState {
     status: RUN_STATUS_TO_SCRATCHPAD[run.status],
   };
 
-  const error = buildError(run);
+  const error = buildError(run, messages);
   if (error) state.error = error;
 
   return state;
@@ -311,7 +367,11 @@ function isElicitationSchema(value: unknown): value is ElicitationRequestedSchem
  * {@link macroRunToScratchpadState} (which calls it for an embedded
  * `pendingInterrogation`).
  */
-export function macroInterrogationToChatPromptConfig(q: MacroInterrogationV1): ChatPromptConfig {
+export function macroInterrogationToChatPromptConfig(
+  q: MacroInterrogationV1,
+  options: MacroRunAdapterOptions = {}
+): ChatPromptConfig {
+  const messages = withMessages(options);
   switch (q.kind) {
     case 'choice': {
       const options: ChoiceOption[] = (q.options ?? []).map((o) => {
@@ -355,7 +415,7 @@ export function macroInterrogationToChatPromptConfig(q: MacroInterrogationV1): C
       return {
         type: 'confirm',
         title: q.title,
-        config: { message: q.message ?? 'Please confirm to continue.' },
+        config: { message: q.message ?? messages.confirmDefault },
       };
     }
   }

package/src/components/ActionGroupRenderer.tsx

@@ -7,6 +7,7 @@ import { Component, For, Show } from 'solid-js'
 import type { UIComponent, ActionGroupParams, ActionComponentParams } from '../types'
 import { useAction } from '../hooks/useAction'
 import { safeUrl } from '../utils/safe-url'
+import { useMCPUIStrings } from '../context/MCPUIStringsContext'
 
 export interface ActionGroupRendererProps {
   /**
@@ -147,6 +148,7 @@ const ActionButton: Component<{
  * ```
  */
 export const ActionGroupRenderer: Component<ActionGroupRendererProps> = (props) => {
+  const strings = useMCPUIStrings()
   const params = () => props.params || (props.component?.params as ActionGroupParams) || { actions: [] }
 
   const layoutClass = () => {
@@ -181,7 +183,7 @@ export const ActionGroupRenderer: Component<ActionGroupRendererProps> = (props)
     <div
       class={`${layoutClass()} ${gapClass()} ${params()?.fullWidth ? 'w-full' : ''}`}
       role="group"
-      aria-label={params()?.label || 'Action group'}
+      aria-label={params()?.label || strings.actionGroupLabel}
     >
       <For each={params()?.actions || []}>
         {(action, index) => <ActionButton action={action} index={index()} />}