@seed-ship/mcp-ui-solid 6.23.0 → 6.24.0

package/dist/utils/degraded-projections.js

@@ -1,4 +1,5 @@
 import { formatMCPUIString } from "./format-string.js";
+import { isMissingChartValue } from "./missing-value.js";
 const DEGRADED_PROJECTION_LABELS = {
   source: "Source",
   target: "Target",
@@ -10,7 +11,8 @@ const DEGRADED_PROJECTION_LABELS = {
   info: "Info",
   marker: "marker",
   feature: "feature",
-  series: "Series {n}"
+  series: "Series {n}",
+  withUnit: "{label} ({unit})"
 };
 const withLabels = (labels) => ({
   ...DEGRADED_PROJECTION_LABELS,
@@ -84,6 +86,7 @@ function mapToDegradedTable(params, labels) {
 function chartToDegradedTable(params, labels) {
   var _a, _b;
   const l = withLabels(labels);
+  const unit = typeof params.unit === "string" && params.unit !== "" ? params.unit : void 0;
   const datasets = ((_a = params.data) == null ? void 0 : _a.datasets) ?? [];
   const dataLabels = ((_b = params.data) == null ? void 0 : _b.labels) ?? [];
   const rowCount = Math.max(dataLabels.length, ...datasets.map((d) => {
@@ -92,16 +95,29 @@ function chartToDegradedTable(params, labels) {
   }), 0);
   const columns = [
     "",
-    ...datasets.map((d, i) => d.label ?? formatMCPUIString(l.series, { n: i + 1 }))
+    ...datasets.map((d, i) => {
+      const name = d.label ?? formatMCPUIString(l.series, { n: i + 1 });
+      return unit === void 0 ? name : formatMCPUIString(l.withUnit ?? DEGRADED_PROJECTION_LABELS.withUnit, { label: name, unit });
+    })
   ];
   const rows = [];
+  const missing = [];
   for (let r = 0; r < Math.min(rowCount, MAX_PROJECTED_ROWS); r++) {
     rows.push([cell(dataLabels[r] ?? r + 1), ...datasets.map((d) => {
       var _a2;
       return cell((_a2 = d.data) == null ? void 0 : _a2[r]);
     })]);
+    missing.push([
+      false,
+      ...datasets.map((d) => {
+        var _a2, _b2;
+        if (r >= (((_a2 = d.data) == null ? void 0 : _a2.length) ?? 0)) return false;
+        const entry = (_b2 = d.data) == null ? void 0 : _b2[r];
+        return (entry === null || typeof entry !== "object") && isMissingChartValue(entry);
+      })
+    ]);
   }
-  return { columns, rows };
+  return { columns, rows, missing };
 }
 export {
   DEGRADED_PROJECTION_LABELS,

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\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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"}
+{"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';\nimport { isMissingChartValue } from './missing-value';\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   * Chart table — a dataset column header followed by the chart's `unit`.\n   * Template — `{label}`, `{unit}`. Only applied when the chart has a unit.\n   * Optional so that a complete labels table written for 6.20.0–6.23.0 still\n   * type-checks. @since v6.24.0\n   */\n  withUnit?: string;\n}\n\n/** English defaults for {@link DegradedProjectionLabels}. */\nexport const DEGRADED_PROJECTION_LABELS: Required<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  withUnit: '{label} ({unit})',\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\n/** A degraded chart table: its cells, plus which of them are missing values. */\nexport interface DegradedChartTable extends DegradedTable {\n  /** Same shape as `rows`; `true` for a dataset entry that is missing. @since v6.24.0 */\n  missing: boolean[][];\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 *\n * `missing` flags the cells whose dataset entry is a missing value (`null`\n * or non-finite) so the table can mark them instead of showing an empty\n * cell. A slot past the end of a shorter or empty dataset has no entry and is\n * not flagged; a point object keeps its JSON text (where a `\"y\":null` reads\n * as such) and is not flagged either. With a `unit`, dataset column headers\n * become `labels.withUnit`.\n */\nexport function chartToDegradedTable(params: {\n  unit?: string;\n  data?: {\n    labels?: Array<string | number>;\n    datasets?: Array<{ label?: string; data?: unknown[] }>;\n  };\n}, labels?: Partial<DegradedProjectionLabels>): DegradedChartTable {\n  const l = withLabels(labels);\n  const unit = typeof params.unit === 'string' && params.unit !== '' ? params.unit : undefined;\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) => {\n      const name = d.label ?? formatMCPUIString(l.series, { n: i + 1 });\n      return unit === undefined\n        ? name\n        : formatMCPUIString(l.withUnit ?? DEGRADED_PROJECTION_LABELS.withUnit, { label: name, unit });\n    }),\n  ];\n  const rows: Array<Array<string | number>> = [];\n  const missing: boolean[][] = [];\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    missing.push([\n      false,\n      ...datasets.map((d) => {\n        // Past the end of a shorter or empty dataset there is no entry, so\n        // nothing to flag (the cell stays empty, as before 6.24.0).\n        if (r >= (d.data?.length ?? 0)) return false;\n        const entry = d.data?.[r];\n        return (entry === null || typeof entry !== 'object') && isMissingChartValue(entry);\n      }),\n    ]);\n  }\n  return { columns, rows, missing };\n}\n"],"names":["_a","_b"],"mappings":"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"}

package/dist/utils/missing-value.cjs

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const MISSING_VALUE_MARKER = "-";
+const PART_TO_WHOLE_CHART_TYPES = /* @__PURE__ */ new Set([
+  "pie",
+  "doughnut",
+  "polarArea"
+]);
+function isMissingCellValue(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "object") return false;
+  const cleaned = stripUndefinedDebris(String(value)).trim();
+  return cleaned === "" || cleaned === MISSING_VALUE_MARKER || cleaned.toLowerCase() === "undefined";
+}
+function stripUndefinedDebris(value) {
+  return value.replace(/\s*[–-]\s*undefined\s*$/gi, "").replace(/^undefined\s*[–-]\s*/gi, "");
+}
+function isMissingChartValue(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "number") return !Number.isFinite(value);
+  if (typeof value === "object" && !Array.isArray(value)) {
+    const y = value.y;
+    return y === null || y === void 0 || typeof y === "number" && !Number.isFinite(y);
+  }
+  return false;
+}
+function summarizeChartMissing(params) {
+  var _a;
+  const datasets = Array.isArray((_a = params == null ? void 0 : params.data) == null ? void 0 : _a.datasets) ? params.data.datasets : [];
+  const fullyMissing = [];
+  const partiallyMissing = [];
+  let anyMissing = false;
+  let anyObserved = false;
+  for (const dataset of datasets) {
+    const data = Array.isArray(dataset == null ? void 0 : dataset.data) ? dataset.data : [];
+    let observed = 0;
+    let missing = 0;
+    for (const value of data) {
+      if (isMissingChartValue(value)) missing += 1;
+      else observed += 1;
+    }
+    fullyMissing.push(missing > 0 && observed === 0);
+    partiallyMissing.push(observed > 0 && missing > 0);
+    anyMissing || (anyMissing = missing > 0);
+    anyObserved || (anyObserved = observed > 0);
+  }
+  return {
+    hasMissing: anyMissing,
+    fullyMissing,
+    partiallyMissing,
+    allMissing: anyMissing && !anyObserved
+  };
+}
+exports.MISSING_VALUE_MARKER = MISSING_VALUE_MARKER;
+exports.PART_TO_WHOLE_CHART_TYPES = PART_TO_WHOLE_CHART_TYPES;
+exports.isMissingCellValue = isMissingCellValue;
+exports.isMissingChartValue = isMissingChartValue;
+exports.stripUndefinedDebris = stripUndefinedDebris;
+exports.summarizeChartMissing = summarizeChartMissing;
+//# sourceMappingURL=missing-value.cjs.map

package/dist/utils/missing-value.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-value.cjs","sources":["../../src/utils/missing-value.ts"],"sourcesContent":["/**\n * Missing values — one definition shared by tables, chart data views,\n * degraded projections, chart validation and the chart renderer.\n *\n * @since v6.24.0\n *\n * A missing value is a value the payload says EXISTS but was not observed:\n * `null` in a chart dataset (or as a point's `y`), `null` / `undefined` in a\n * table cell. It is not a zero, and it is not the absence of a row or of a\n * label: every view keeps its slot and marks it.\n *\n * Runtime-free on purpose (no `solid-js`): the pure projections in\n * `chart-data-table.ts` and `degraded-projections.ts`, and `validation.ts`\n * (published as the `/validation` subpath), import it.\n */\n\n/** The glyph a table cell shows for a missing value — `renderCellValue`'s historical `-`. */\nexport const MISSING_VALUE_MARKER = '-'\n\n/**\n * Chart types that encode a value as a share of a whole (or, for polar area,\n * as a wedge whose emptiness reads as zero). Chart.js parses a `null` share\n * as `0`, so these types refuse missing values instead of drawing them.\n */\nexport const PART_TO_WHOLE_CHART_TYPES: ReadonlySet<string> = new Set([\n  'pie',\n  'doughnut',\n  'polarArea',\n])\n\n/**\n * Whether a raw TABLE cell value is displayed as {@link MISSING_VALUE_MARKER}.\n *\n * Mirrors the rules `renderCellValue` applies before any formatting — `null`,\n * `undefined`, and a string that is empty or the word `undefined` once the\n * backend's `\"X – undefined\"` debris is stripped — plus the literal marker\n * itself (whitespace around it aside, which a table cell does not render),\n * since it looks identical on screen and so must read identically.\n *\n * Objects are never missing here: `renderCellValue` renders them (link,\n * name, or escaped JSON).\n */\nexport function isMissingCellValue(value: unknown): boolean {\n  if (value === null || value === undefined) return true\n  if (typeof value === 'object') return false\n  const cleaned = stripUndefinedDebris(String(value)).trim()\n  return cleaned === '' || cleaned === MISSING_VALUE_MARKER || cleaned.toLowerCase() === 'undefined'\n}\n\n/**\n * Removes the `\"Text – undefined\"` / `\"undefined – Text\"` debris some\n * backends concatenate. Shared with `renderCellValue` so both apply the very\n * same cleanup.\n */\nexport function stripUndefinedDebris(value: string): string {\n  return value.replace(/\\s*[–-]\\s*undefined\\s*$/gi, '').replace(/^undefined\\s*[–-]\\s*/gi, '')\n}\n\n/**\n * Whether one CHART data entry is missing: `null` / `undefined`, a non-finite\n * number (Chart.js parses those to `null` too), or a point whose `y` is.\n */\nexport function isMissingChartValue(value: unknown): boolean {\n  if (value === null || value === undefined) return true\n  if (typeof value === 'number') return !Number.isFinite(value)\n  if (typeof value === 'object' && !Array.isArray(value)) {\n    const y = (value as { y?: unknown }).y\n    return y === null || y === undefined || (typeof y === 'number' && !Number.isFinite(y))\n  }\n  return false\n}\n\n/**\n * What a chart's missing values amount to.\n *\n * Only ENTRIES count: an explicit `null` (or non-finite number, or a point\n * whose `y` is one). A dataset with no entry at all (`data: []`) is not\n * \"missing\" — it is how 6.23.0 and earlier payloads said \"nothing yet\", e.g.\n * while streaming, and it keeps rendering exactly as it did then.\n */\nexport interface ChartMissingSummary {\n  /** At least one entry of one dataset is missing. */\n  hasMissing: boolean\n  /** Per dataset, in order: it has entries and every one of them is missing. */\n  fullyMissing: boolean[]\n  /**\n   * Per dataset, in order: at least one observed value AND at least one\n   * missing entry — the series a reader actually sees broken.\n   */\n  partiallyMissing: boolean[]\n  /** Something is missing and no dataset has a single observed value: nothing to plot. */\n  allMissing: boolean\n}\n\ninterface ChartDataLike {\n  data?: {\n    datasets?: Array<{ data?: unknown[] } | null | undefined>\n  }\n}\n\n/** Summarises the missing values of a chart payload. Never throws on a malformed payload. */\nexport function summarizeChartMissing(params: ChartDataLike | null | undefined): ChartMissingSummary {\n  const datasets = Array.isArray(params?.data?.datasets) ? params.data.datasets : []\n  const fullyMissing: boolean[] = []\n  const partiallyMissing: boolean[] = []\n  let anyMissing = false\n  let anyObserved = false\n  for (const dataset of datasets) {\n    const data = Array.isArray(dataset?.data) ? dataset.data : []\n    let observed = 0\n    let missing = 0\n    for (const value of data) {\n      if (isMissingChartValue(value)) missing += 1\n      else observed += 1\n    }\n    fullyMissing.push(missing > 0 && observed === 0)\n    partiallyMissing.push(observed > 0 && missing > 0)\n    anyMissing ||= missing > 0\n    anyObserved ||= observed > 0\n  }\n  return {\n    hasMissing: anyMissing,\n    fullyMissing,\n    partiallyMissing,\n    allMissing: anyMissing && !anyObserved,\n  }\n}\n"],"names":[],"mappings":";;AAiBO,MAAM,uBAAuB;AAO7B,MAAM,gDAAqD,IAAI;AAAA,EACpE;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAcM,SAAS,mBAAmB,OAAyB;AAC1D,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,qBAAqB,OAAO,KAAK,CAAC,EAAE,KAAA;AACpD,SAAO,YAAY,MAAM,YAAY,wBAAwB,QAAQ,kBAAkB;AACzF;AAOO,SAAS,qBAAqB,OAAuB;AAC1D,SAAO,MAAM,QAAQ,6BAA6B,EAAE,EAAE,QAAQ,0BAA0B,EAAE;AAC5F;AAMO,SAAS,oBAAoB,OAAyB;AAC3D,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,iBAAiB,CAAC,OAAO,SAAS,KAAK;AAC5D,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACtD,UAAM,IAAK,MAA0B;AACrC,WAAO,MAAM,QAAQ,MAAM,UAAc,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC;AAAA,EACtF;AACA,SAAO;AACT;AA+BO,SAAS,sBAAsB,QAA+D;;AACnG,QAAM,WAAW,MAAM,SAAQ,sCAAQ,SAAR,mBAAc,QAAQ,IAAI,OAAO,KAAK,WAAW,CAAA;AAChF,QAAM,eAA0B,CAAA;AAChC,QAAM,mBAA8B,CAAA;AACpC,MAAI,aAAa;AACjB,MAAI,cAAc;AAClB,aAAW,WAAW,UAAU;AAC9B,UAAM,OAAO,MAAM,QAAQ,mCAAS,IAAI,IAAI,QAAQ,OAAO,CAAA;AAC3D,QAAI,WAAW;AACf,QAAI,UAAU;AACd,eAAW,SAAS,MAAM;AACxB,UAAI,oBAAoB,KAAK,EAAG,YAAW;AAAA,UACtC,aAAY;AAAA,IACnB;AACA,iBAAa,KAAK,UAAU,KAAK,aAAa,CAAC;AAC/C,qBAAiB,KAAK,WAAW,KAAK,UAAU,CAAC;AACjD,gCAAe,UAAU;AACzB,kCAAgB,WAAW;AAAA,EAC7B;AACA,SAAO;AAAA,IACL,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,IACA,YAAY,cAAc,CAAC;AAAA,EAAA;AAE/B;;;;;;;"}

package/dist/utils/missing-value.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Missing values — one definition shared by tables, chart data views,
+ * degraded projections, chart validation and the chart renderer.
+ *
+ * @since v6.24.0
+ *
+ * A missing value is a value the payload says EXISTS but was not observed:
+ * `null` in a chart dataset (or as a point's `y`), `null` / `undefined` in a
+ * table cell. It is not a zero, and it is not the absence of a row or of a
+ * label: every view keeps its slot and marks it.
+ *
+ * Runtime-free on purpose (no `solid-js`): the pure projections in
+ * `chart-data-table.ts` and `degraded-projections.ts`, and `validation.ts`
+ * (published as the `/validation` subpath), import it.
+ */
+/** The glyph a table cell shows for a missing value — `renderCellValue`'s historical `-`. */
+export declare const MISSING_VALUE_MARKER = "-";
+/**
+ * Chart types that encode a value as a share of a whole (or, for polar area,
+ * as a wedge whose emptiness reads as zero). Chart.js parses a `null` share
+ * as `0`, so these types refuse missing values instead of drawing them.
+ */
+export declare const PART_TO_WHOLE_CHART_TYPES: ReadonlySet<string>;
+/**
+ * Whether a raw TABLE cell value is displayed as {@link MISSING_VALUE_MARKER}.
+ *
+ * Mirrors the rules `renderCellValue` applies before any formatting — `null`,
+ * `undefined`, and a string that is empty or the word `undefined` once the
+ * backend's `"X – undefined"` debris is stripped — plus the literal marker
+ * itself (whitespace around it aside, which a table cell does not render),
+ * since it looks identical on screen and so must read identically.
+ *
+ * Objects are never missing here: `renderCellValue` renders them (link,
+ * name, or escaped JSON).
+ */
+export declare function isMissingCellValue(value: unknown): boolean;
+/**
+ * Removes the `"Text – undefined"` / `"undefined – Text"` debris some
+ * backends concatenate. Shared with `renderCellValue` so both apply the very
+ * same cleanup.
+ */
+export declare function stripUndefinedDebris(value: string): string;
+/**
+ * Whether one CHART data entry is missing: `null` / `undefined`, a non-finite
+ * number (Chart.js parses those to `null` too), or a point whose `y` is.
+ */
+export declare function isMissingChartValue(value: unknown): boolean;
+/**
+ * What a chart's missing values amount to.
+ *
+ * Only ENTRIES count: an explicit `null` (or non-finite number, or a point
+ * whose `y` is one). A dataset with no entry at all (`data: []`) is not
+ * "missing" — it is how 6.23.0 and earlier payloads said "nothing yet", e.g.
+ * while streaming, and it keeps rendering exactly as it did then.
+ */
+export interface ChartMissingSummary {
+    /** At least one entry of one dataset is missing. */
+    hasMissing: boolean;
+    /** Per dataset, in order: it has entries and every one of them is missing. */
+    fullyMissing: boolean[];
+    /**
+     * Per dataset, in order: at least one observed value AND at least one
+     * missing entry — the series a reader actually sees broken.
+     */
+    partiallyMissing: boolean[];
+    /** Something is missing and no dataset has a single observed value: nothing to plot. */
+    allMissing: boolean;
+}
+interface ChartDataLike {
+    data?: {
+        datasets?: Array<{
+            data?: unknown[];
+        } | null | undefined>;
+    };
+}
+/** Summarises the missing values of a chart payload. Never throws on a malformed payload. */
+export declare function summarizeChartMissing(params: ChartDataLike | null | undefined): ChartMissingSummary;
+export {};
+//# sourceMappingURL=missing-value.d.ts.map

package/dist/utils/missing-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-value.d.ts","sourceRoot":"","sources":["../../src/utils/missing-value.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAIxD,CAAA;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ3D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAA;IACnB,8EAA8E;IAC9E,YAAY,EAAE,OAAO,EAAE,CAAA;IACvB;;;OAGG;IACH,gBAAgB,EAAE,OAAO,EAAE,CAAA;IAC3B,wFAAwF;IACxF,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;SAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;KAC1D,CAAA;CACF;AAED,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,mBAAmB,CAyBnG"}

package/dist/utils/missing-value.js

@@ -0,0 +1,60 @@
+const MISSING_VALUE_MARKER = "-";
+const PART_TO_WHOLE_CHART_TYPES = /* @__PURE__ */ new Set([
+  "pie",
+  "doughnut",
+  "polarArea"
+]);
+function isMissingCellValue(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "object") return false;
+  const cleaned = stripUndefinedDebris(String(value)).trim();
+  return cleaned === "" || cleaned === MISSING_VALUE_MARKER || cleaned.toLowerCase() === "undefined";
+}
+function stripUndefinedDebris(value) {
+  return value.replace(/\s*[–-]\s*undefined\s*$/gi, "").replace(/^undefined\s*[–-]\s*/gi, "");
+}
+function isMissingChartValue(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "number") return !Number.isFinite(value);
+  if (typeof value === "object" && !Array.isArray(value)) {
+    const y = value.y;
+    return y === null || y === void 0 || typeof y === "number" && !Number.isFinite(y);
+  }
+  return false;
+}
+function summarizeChartMissing(params) {
+  var _a;
+  const datasets = Array.isArray((_a = params == null ? void 0 : params.data) == null ? void 0 : _a.datasets) ? params.data.datasets : [];
+  const fullyMissing = [];
+  const partiallyMissing = [];
+  let anyMissing = false;
+  let anyObserved = false;
+  for (const dataset of datasets) {
+    const data = Array.isArray(dataset == null ? void 0 : dataset.data) ? dataset.data : [];
+    let observed = 0;
+    let missing = 0;
+    for (const value of data) {
+      if (isMissingChartValue(value)) missing += 1;
+      else observed += 1;
+    }
+    fullyMissing.push(missing > 0 && observed === 0);
+    partiallyMissing.push(observed > 0 && missing > 0);
+    anyMissing || (anyMissing = missing > 0);
+    anyObserved || (anyObserved = observed > 0);
+  }
+  return {
+    hasMissing: anyMissing,
+    fullyMissing,
+    partiallyMissing,
+    allMissing: anyMissing && !anyObserved
+  };
+}
+export {
+  MISSING_VALUE_MARKER,
+  PART_TO_WHOLE_CHART_TYPES,
+  isMissingCellValue,
+  isMissingChartValue,
+  stripUndefinedDebris,
+  summarizeChartMissing
+};
+//# sourceMappingURL=missing-value.js.map

package/dist/utils/missing-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-value.js","sources":["../../src/utils/missing-value.ts"],"sourcesContent":["/**\n * Missing values — one definition shared by tables, chart data views,\n * degraded projections, chart validation and the chart renderer.\n *\n * @since v6.24.0\n *\n * A missing value is a value the payload says EXISTS but was not observed:\n * `null` in a chart dataset (or as a point's `y`), `null` / `undefined` in a\n * table cell. It is not a zero, and it is not the absence of a row or of a\n * label: every view keeps its slot and marks it.\n *\n * Runtime-free on purpose (no `solid-js`): the pure projections in\n * `chart-data-table.ts` and `degraded-projections.ts`, and `validation.ts`\n * (published as the `/validation` subpath), import it.\n */\n\n/** The glyph a table cell shows for a missing value — `renderCellValue`'s historical `-`. */\nexport const MISSING_VALUE_MARKER = '-'\n\n/**\n * Chart types that encode a value as a share of a whole (or, for polar area,\n * as a wedge whose emptiness reads as zero). Chart.js parses a `null` share\n * as `0`, so these types refuse missing values instead of drawing them.\n */\nexport const PART_TO_WHOLE_CHART_TYPES: ReadonlySet<string> = new Set([\n  'pie',\n  'doughnut',\n  'polarArea',\n])\n\n/**\n * Whether a raw TABLE cell value is displayed as {@link MISSING_VALUE_MARKER}.\n *\n * Mirrors the rules `renderCellValue` applies before any formatting — `null`,\n * `undefined`, and a string that is empty or the word `undefined` once the\n * backend's `\"X – undefined\"` debris is stripped — plus the literal marker\n * itself (whitespace around it aside, which a table cell does not render),\n * since it looks identical on screen and so must read identically.\n *\n * Objects are never missing here: `renderCellValue` renders them (link,\n * name, or escaped JSON).\n */\nexport function isMissingCellValue(value: unknown): boolean {\n  if (value === null || value === undefined) return true\n  if (typeof value === 'object') return false\n  const cleaned = stripUndefinedDebris(String(value)).trim()\n  return cleaned === '' || cleaned === MISSING_VALUE_MARKER || cleaned.toLowerCase() === 'undefined'\n}\n\n/**\n * Removes the `\"Text – undefined\"` / `\"undefined – Text\"` debris some\n * backends concatenate. Shared with `renderCellValue` so both apply the very\n * same cleanup.\n */\nexport function stripUndefinedDebris(value: string): string {\n  return value.replace(/\\s*[–-]\\s*undefined\\s*$/gi, '').replace(/^undefined\\s*[–-]\\s*/gi, '')\n}\n\n/**\n * Whether one CHART data entry is missing: `null` / `undefined`, a non-finite\n * number (Chart.js parses those to `null` too), or a point whose `y` is.\n */\nexport function isMissingChartValue(value: unknown): boolean {\n  if (value === null || value === undefined) return true\n  if (typeof value === 'number') return !Number.isFinite(value)\n  if (typeof value === 'object' && !Array.isArray(value)) {\n    const y = (value as { y?: unknown }).y\n    return y === null || y === undefined || (typeof y === 'number' && !Number.isFinite(y))\n  }\n  return false\n}\n\n/**\n * What a chart's missing values amount to.\n *\n * Only ENTRIES count: an explicit `null` (or non-finite number, or a point\n * whose `y` is one). A dataset with no entry at all (`data: []`) is not\n * \"missing\" — it is how 6.23.0 and earlier payloads said \"nothing yet\", e.g.\n * while streaming, and it keeps rendering exactly as it did then.\n */\nexport interface ChartMissingSummary {\n  /** At least one entry of one dataset is missing. */\n  hasMissing: boolean\n  /** Per dataset, in order: it has entries and every one of them is missing. */\n  fullyMissing: boolean[]\n  /**\n   * Per dataset, in order: at least one observed value AND at least one\n   * missing entry — the series a reader actually sees broken.\n   */\n  partiallyMissing: boolean[]\n  /** Something is missing and no dataset has a single observed value: nothing to plot. */\n  allMissing: boolean\n}\n\ninterface ChartDataLike {\n  data?: {\n    datasets?: Array<{ data?: unknown[] } | null | undefined>\n  }\n}\n\n/** Summarises the missing values of a chart payload. Never throws on a malformed payload. */\nexport function summarizeChartMissing(params: ChartDataLike | null | undefined): ChartMissingSummary {\n  const datasets = Array.isArray(params?.data?.datasets) ? params.data.datasets : []\n  const fullyMissing: boolean[] = []\n  const partiallyMissing: boolean[] = []\n  let anyMissing = false\n  let anyObserved = false\n  for (const dataset of datasets) {\n    const data = Array.isArray(dataset?.data) ? dataset.data : []\n    let observed = 0\n    let missing = 0\n    for (const value of data) {\n      if (isMissingChartValue(value)) missing += 1\n      else observed += 1\n    }\n    fullyMissing.push(missing > 0 && observed === 0)\n    partiallyMissing.push(observed > 0 && missing > 0)\n    anyMissing ||= missing > 0\n    anyObserved ||= observed > 0\n  }\n  return {\n    hasMissing: anyMissing,\n    fullyMissing,\n    partiallyMissing,\n    allMissing: anyMissing && !anyObserved,\n  }\n}\n"],"names":[],"mappings":"AAiBO,MAAM,uBAAuB;AAO7B,MAAM,gDAAqD,IAAI;AAAA,EACpE;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAcM,SAAS,mBAAmB,OAAyB;AAC1D,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,qBAAqB,OAAO,KAAK,CAAC,EAAE,KAAA;AACpD,SAAO,YAAY,MAAM,YAAY,wBAAwB,QAAQ,kBAAkB;AACzF;AAOO,SAAS,qBAAqB,OAAuB;AAC1D,SAAO,MAAM,QAAQ,6BAA6B,EAAE,EAAE,QAAQ,0BAA0B,EAAE;AAC5F;AAMO,SAAS,oBAAoB,OAAyB;AAC3D,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,UAAU,iBAAiB,CAAC,OAAO,SAAS,KAAK;AAC5D,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACtD,UAAM,IAAK,MAA0B;AACrC,WAAO,MAAM,QAAQ,MAAM,UAAc,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC;AAAA,EACtF;AACA,SAAO;AACT;AA+BO,SAAS,sBAAsB,QAA+D;AApF9F;AAqFL,QAAM,WAAW,MAAM,SAAQ,sCAAQ,SAAR,mBAAc,QAAQ,IAAI,OAAO,KAAK,WAAW,CAAA;AAChF,QAAM,eAA0B,CAAA;AAChC,QAAM,mBAA8B,CAAA;AACpC,MAAI,aAAa;AACjB,MAAI,cAAc;AAClB,aAAW,WAAW,UAAU;AAC9B,UAAM,OAAO,MAAM,QAAQ,mCAAS,IAAI,IAAI,QAAQ,OAAO,CAAA;AAC3D,QAAI,WAAW;AACf,QAAI,UAAU;AACd,eAAW,SAAS,MAAM;AACxB,UAAI,oBAAoB,KAAK,EAAG,YAAW;AAAA,UACtC,aAAY;AAAA,IACnB;AACA,iBAAa,KAAK,UAAU,KAAK,aAAa,CAAC;AAC/C,qBAAiB,KAAK,WAAW,KAAK,UAAU,CAAC;AACjD,gCAAe,UAAU;AACzB,kCAAgB,WAAW;AAAA,EAC7B;AACA,SAAO;AAAA,IACL,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,IACA,YAAY,cAAc,CAAC;AAAA,EAAA;AAE/B;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-ship/mcp-ui-solid",
-  "version": "6.23.0",
+  "version": "6.24.0",
   "description": "SolidJS components for rendering MCP-generated UI resources",
   "type": "module",
   "files": [
@@ -229,7 +229,7 @@
     }
   },
   "dependencies": {
-    "@seed-ship/mcp-ui-spec": "^5.6.0",
+    "@seed-ship/mcp-ui-spec": "^5.7.0",
     "@types/dompurify": "^3.0.5",
     "dompurify": "^3.4.12",
     "marked": "^16.3.0",
@@ -289,7 +289,7 @@
     "test:watch": "vitest",
     "test:browser": "vitest --mode browser",
     "lint": "eslint src",
-    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.contracts.json",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.contracts.json && tsc --noEmit -p tsconfig.examples.json",
     "clean": "rm -rf dist",
     "size": "size-limit",
     "size:analyze": "size-limit --why"

package/src/components/ChartJSRenderer.tsx

@@ -32,7 +32,17 @@ import type { Accessor, JSX } from 'solid-js';
 import type { UIComponent, ChartComponentParams } from '../types';
 import { ExpandableWrapper, useExpanded } from './ExpandableWrapper';
 import { DegradedFallback } from './DegradedFallback';
+import { MissingValueLegend, MissingValueMark } from './MissingValue';
 import { chartToDataTable } from './chart-data-table';
+import {
+  applyUnitAxisTitle,
+  createMissingLegendGenerator,
+  createMissingValuesPlugin,
+  createTooltipLabel,
+  missingNoteKind,
+  withDatasetsNoGapSpan,
+} from './chart-missing-plugin';
+import { PART_TO_WHOLE_CHART_TYPES, summarizeChartMissing } from '../utils/missing-value';
 import { useTelemetry } from '../context/MCPUITelemetryContext';
 import { useMCPUIConfig } from '../context/MCPUIConfigContext';
 import { formatMCPUIString, useMCPUIStrings } from '../context/MCPUIStringsContext';
@@ -320,9 +330,51 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
       point: strings.chartTablePoint,
       label: strings.degradedColLabel,
       seriesName: strings.degradedSeries,
+      withUnit: strings.chartLabelWithUnit,
     })
   );
+  // Absence is never zero: which entries are missing, and which series have
+  // nothing at all. Drives the notes, the plugin, the legend and the guard.
+  const missingSummary = createMemo(() => summarizeChartMissing(params()));
+  const unit = () => {
+    const value = params().unit;
+    return typeof value === 'string' && value !== '' ? value : undefined;
+  };
+  const anyMissingCell = () => tableData().missing.some((row) => row.some(Boolean));
+  // Never for a part-to-whole chart: it refuses missing values outright (the
+  // render effect turns it into the data table), so no convention applies —
+  // and the async guard must not leave a wrong note in the SSR markup.
+  const notesShown = () =>
+    missingSummary().hasMissing &&
+    !PART_TO_WHOLE_CHART_TYPES.has(params().type) &&
+    activeView() === 'chart' &&
+    !error();
+  const noteKind = () => missingNoteKind(params().type, params().options);
+  // The convention line explains a mark the reader can SEE: every missing bar
+  // gets a dashed stub, but a line or a scatter only shows an absence inside a
+  // series that still has values — a series with no value at all draws
+  // nothing, and the "no data" line alone covers it.
+  const conventionNoteShown = () =>
+    noteKind() === 'bars'
+      ? missingSummary().hasMissing
+      : missingSummary().partiallyMissing.some(Boolean);
+  // The series the chart has no data for, as a locale-aware list.
+  const noDataSeries = () => {
+    const names = (params().data?.datasets ?? [])
+      .map((dataset, index) =>
+        missingSummary().fullyMissing[index]
+          ? dataset?.label || formatMCPUIString(strings.degradedSeries, { n: index + 1 })
+          : null
+      )
+      .filter((name): name is string => name !== null);
+    try {
+      return new Intl.ListFormat(strings.locale, { type: 'conjunction' }).format(names);
+    } catch {
+      return names.join(', ');
+    }
+  };
   const descriptionId = createUniqueId();
+  const notesId = createUniqueId();
   const title = () => params().title || strings.chartView;
 
   // v6.1.0 — export visibility :
@@ -456,6 +508,8 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
     // plugin options at construction and the plugin only hooks charts created
     // after it was registered).
     const chartParams = params();
+    const chartMissing = missingSummary();
+    const chartUnit = unit();
     const zoom = zoomOptions();
     const version = ++renderVersion;
 
@@ -474,6 +528,14 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
         chartInstance = null;
       }
 
+      // A share of a whole cannot be missing: Chart.js parses `null` as 0 and
+      // would draw it as a zero slice. Validation rejects this earlier; this
+      // is the guard for a host that bypassed it. Thrown here so the catch
+      // below shows the data table (with the missing cells marked).
+      if (chartMissing.hasMissing && PART_TO_WHOLE_CHART_TYPES.has(chartParams.type)) {
+        throw new Error(strings.chartMissingUnsupported);
+      }
+
       // Build options, merging time-axis config if present (v3.1.0)
       const hostZoomOptions = chartParams.options?.plugins?.zoom;
       const baseOptions: any = {
@@ -517,12 +579,69 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
         };
       }
 
-      // Create new chart
-      chartInstance = new Chart(canvasRef, {
+      // Unit (v6.24.0): value-axis title and tooltip suffix. Both are no-ops
+      // on a payload without a unit.
+      applyUnitAxisTitle(baseOptions, chartParams.type, chartUnit);
+
+      const chartConfig: any = {
         type: chartParams.type,
         data: chartParams.data,
         options: baseOptions,
-      });
+      };
+
+      if (chartUnit !== undefined || chartMissing.hasMissing) {
+        const tooltip = baseOptions.plugins.tooltip;
+        // `tooltip: false` (or `null`) is Chart.js's per-chart plugin opt-out:
+        // the payload turned tooltips off, and adding a callback object here
+        // would turn them back on. A host-supplied label callback is the
+        // host's word too. Both are left exactly as written.
+        if (tooltip !== false && tooltip !== null && !tooltip?.callbacks?.label) {
+          baseOptions.plugins.tooltip = {
+            ...tooltip,
+            callbacks: {
+              ...tooltip?.callbacks,
+              label: createTooltipLabel(() => strings, chartUnit, chartParams.type),
+            },
+          };
+        }
+      }
+
+      if (chartMissing.hasMissing) {
+        // A line must break at a missing value, not join its neighbours.
+        chartConfig.data = withDatasetsNoGapSpan(chartParams.data);
+
+        // Legend of a fully-missing series: "{series} (no data)". Dataset
+        // legends only — pie-like legends list categories, not series.
+        const defaultGenerate =
+          baseOptions.plugins.legend?.labels?.generateLabels ??
+          Chart?.defaults?.plugins?.legend?.labels?.generateLabels;
+        if (typeof defaultGenerate === 'function') {
+          baseOptions.plugins.legend = {
+            ...baseOptions.plugins.legend,
+            labels: {
+              ...baseOptions.plugins.legend?.labels,
+              generateLabels: createMissingLegendGenerator(
+                defaultGenerate,
+                chartMissing.fullyMissing,
+                () => strings
+              ),
+            },
+          };
+        }
+
+        // Per-chart plugin (never `Chart.register`): the dashed stub of a
+        // missing bar, and "no data" on a chart with nothing to plot.
+        chartConfig.plugins = [
+          createMissingValuesPlugin({
+            allMissing: chartMissing.allMissing,
+            getNoDataText: () => strings.chartNoData,
+            getFontFamily: () => Chart?.defaults?.font?.family,
+          }),
+        ];
+      }
+
+      // Create new chart
+      chartInstance = new Chart(canvasRef, chartConfig);
 
       // A freshly built chart always sits on its initial viewport, so the
       // reset control goes away until the user zooms again.
@@ -761,12 +880,17 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
               </thead>
               <tbody>
                 <For each={tableData().rows}>
-                  {(row) => (
+                  {(row, rowIndex) => (
                     <tr class="border-t border-gray-100 dark:border-gray-700">
                       <For each={tableData().columns}>
                         {(_column, index) => (
                           <td class="px-3 py-2 text-gray-700 dark:text-gray-300">
-                            {String(row[index()] ?? '')}
+                            <Show
+                              when={tableData().missing[rowIndex()]?.[index()]}
+                              fallback={String(row[index()] ?? '')}
+                            >
+                              <MissingValueMark />
+                            </Show>
                           </td>
                         )}
                       </For>
@@ -786,6 +910,9 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
               </tbody>
             </table>
           </div>
+          <Show when={anyMissingCell()}>
+            <MissingValueLegend class="mt-2" />
+          </Show>
         </Show>
 
         <div
@@ -802,7 +929,7 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
             ref={canvasRef}
             role="img"
             aria-label={title()}
-            aria-describedby={descriptionId}
+            aria-describedby={notesShown() ? `${descriptionId} ${notesId}` : descriptionId}
             aria-hidden={activeView() !== 'chart' || Boolean(error())}
           />
           <Show when={isLoading() && activeView() === 'chart'}>
@@ -814,6 +941,32 @@ export const ChartJSRenderer: Component<ChartJSRendererProps> = (props) => {
             </div>
           </Show>
         </div>
+
+        {/* Missing values (v6.24.0): how THIS chart type shows them, and which
+            series have no data at all. Linked from the canvas, so a screen
+            reader hears the convention with the chart. */}
+        <Show when={notesShown()}>
+          <div
+            data-mcp-chart-notes=""
+            id={notesId}
+            class="mt-2 space-y-0.5 text-xs text-gray-600 dark:text-gray-400"
+          >
+            <Show when={conventionNoteShown()}>
+              <p data-mcp-chart-note={noteKind()}>
+                {noteKind() === 'bars'
+                  ? strings.chartMissingBars
+                  : noteKind() === 'omitted'
+                    ? strings.chartMissingPoints
+                    : strings.chartMissingGaps}
+              </p>
+            </Show>
+            <Show when={missingSummary().fullyMissing.some(Boolean)}>
+              <p data-mcp-chart-note="no-data">
+                {formatMCPUIString(strings.chartSeriesNoData, { series: noDataSeries() })}
+              </p>
+            </Show>
+          </div>
+        </Show>
           </div>
         )}
       />