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

package/dist/utils/math-markdown.js

@@ -0,0 +1,240 @@
+import { Marked, Renderer } from "marked";
+import { escapeHtml } from "./escape-html.js";
+import { canSanitizeHtml, sanitizeHtml } from "./sanitize-html.js";
+const MATH_MARKDOWN_LIMITS = {
+  sourceLength: 1e5,
+  expressionLength: 4096,
+  expressionCount: 128
+};
+const MATH_TAGS = [
+  "math",
+  "semantics",
+  "mrow",
+  "mi",
+  "mo",
+  "mn",
+  "mtext",
+  "mspace",
+  "ms",
+  "msup",
+  "msub",
+  "msubsup",
+  "mfrac",
+  "msqrt",
+  "mroot",
+  "mtable",
+  "mtr",
+  "mtd",
+  "mover",
+  "munder",
+  "munderover",
+  "mpadded",
+  "mphantom",
+  "mstyle",
+  "menclose"
+];
+const MATH_ATTRS = [
+  "xmlns",
+  "display",
+  "class",
+  "mathvariant",
+  "stretchy",
+  "fence",
+  "separator",
+  "lspace",
+  "rspace",
+  "accent",
+  "accentunder",
+  "columnalign",
+  "rowalign",
+  "columnspacing",
+  "rowspacing",
+  "columnlines",
+  "rowlines",
+  "frame",
+  "notation",
+  "width",
+  "height",
+  "depth",
+  "voffset",
+  "scriptlevel",
+  "displaystyle"
+];
+const STRICT_MATHML_CONFIG = {
+  ALLOWED_TAGS: [...MATH_TAGS, "span"],
+  ALLOWED_ATTR: [...MATH_ATTRS],
+  FORBID_TAGS: ["annotation", "annotation-xml", "style", "a"],
+  // DOMPurify normally keeps the text of forbidden tags. TeX annotations can
+  // be large and duplicate the accessible MathML, so remove their subtree.
+  ADD_FORBID_CONTENTS: ["annotation", "annotation-xml"],
+  FORBID_ATTR: ["style"]
+};
+const CELL_MARKDOWN_TAGS = [
+  "a",
+  "strong",
+  "em",
+  "b",
+  "i",
+  "code",
+  "span",
+  "br",
+  "button",
+  "svg",
+  "path",
+  "p",
+  "ul",
+  "ol",
+  "li",
+  "pre",
+  "blockquote",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  ...MATH_TAGS
+];
+const FINAL_PROFILES = {
+  prose: {
+    ADD_TAGS: [...MATH_TAGS],
+    ADD_ATTR: [...MATH_ATTRS, "target", "rel"],
+    FORBID_TAGS: ["annotation", "annotation-xml", "style", "form", "textarea", "select", "button", "iframe", "object", "embed"],
+    ADD_FORBID_CONTENTS: ["annotation", "annotation-xml"],
+    FORBID_ATTR: ["style"]
+  },
+  cellMarkdown: {
+    ALLOWED_TAGS: CELL_MARKDOWN_TAGS,
+    ALLOWED_ATTR: [
+      "href",
+      "target",
+      "rel",
+      "class",
+      "data-citation-page",
+      "data-citation-source",
+      "data-citation-doc",
+      "data-citation-verified",
+      "title",
+      "fill",
+      "stroke",
+      "viewBox",
+      "stroke-linecap",
+      "stroke-linejoin",
+      "stroke-width",
+      "d",
+      ...MATH_ATTRS
+    ],
+    FORBID_TAGS: ["annotation", "annotation-xml", "style"],
+    ADD_FORBID_CONTENTS: ["annotation", "annotation-xml"],
+    FORBID_ATTR: ["style"]
+  }
+};
+function isCurrencyLike(raw, tex, following) {
+  var _a, _b, _c;
+  if (/^\$\s|\s\$$/.test(raw)) return true;
+  if (/^\d+(?:[.,]\d+)?-\s*$/.test(tex)) return true;
+  if (/^\d/.test(tex) && /^\d/.test(following)) return true;
+  const amount = (_a = /^\d+(?:[.,]\d{1,2})?(?=$|[\s,;:!?()[\]+*/-])/.exec(tex)) == null ? void 0 : _a[0];
+  if (!amount) return false;
+  const trailing = tex.slice(amount.length);
+  if (!trailing) return false;
+  const hasUnmatchedOpeningParen = (((_b = trailing.match(/\(/g)) == null ? void 0 : _b.length) ?? 0) > (((_c = trailing.match(/\)/g)) == null ? void 0 : _c.length) ?? 0);
+  const containsTexCommand = /\\[A-Za-z]+/.test(trailing);
+  if (hasUnmatchedOpeningParen && !containsTexCommand) return true;
+  const closerLooksLikeLaterOpener = /^(?![\s,.;:!?)}\]])(?:\\[^\n]|[^\\\n$])+\$(?!\$)/.test(following);
+  return closerLooksLikeLaterOpener;
+}
+const CELL_LINK_ATTRIBUTES = 'target="_blank" rel="noopener noreferrer" class="text-blue-600 dark:text-blue-400 hover:underline"';
+function cellLinkExtension() {
+  return {
+    renderer: {
+      link(token) {
+        const anchor = Renderer.prototype.link.call(this, token);
+        return anchor.replace("<a ", `<a ${CELL_LINK_ATTRIBUTES} `);
+      }
+    }
+  };
+}
+function mathExtension(renderer) {
+  let count = 0;
+  const token = (raw, tex, displayMode) => ({
+    type: displayMode ? "mcpDisplayMath" : "mcpInlineMath",
+    raw,
+    tex,
+    displayMode,
+    render: ++count <= MATH_MARKDOWN_LIMITS.expressionCount && tex.length <= MATH_MARKDOWN_LIMITS.expressionLength
+  });
+  return {
+    extensions: [
+      {
+        name: "mcpDisplayMath",
+        level: "block",
+        start(src) {
+          const index = src.indexOf("$$");
+          return index < 0 ? void 0 : index;
+        },
+        tokenizer(src) {
+          const match = /^\$\$\s*\n?([\s\S]+?)\n?\s*\$\$(?:\n|$)/.exec(src);
+          if (!match) return void 0;
+          return token(match[0], match[1], true);
+        },
+        renderer(tokenValue) {
+          return renderToken(tokenValue, renderer);
+        }
+      },
+      {
+        name: "mcpInlineMath",
+        level: "inline",
+        start(src) {
+          const index = src.indexOf("$");
+          return index < 0 ? void 0 : index;
+        },
+        tokenizer(src) {
+          const match = /^\$(?!\$)((?:\\[^\n]|[^\\\n$])+?)\$(?!\$)/.exec(src);
+          if (!match || isCurrencyLike(match[0], match[1], src.slice(match[0].length))) return void 0;
+          return token(match[0], match[1], false);
+        },
+        renderer(tokenValue) {
+          return renderToken(tokenValue, renderer);
+        }
+      }
+    ]
+  };
+}
+function renderToken(token, renderer) {
+  if (!token.render) return escapeHtml(token.raw);
+  try {
+    const rendered = renderer(token.tex, { displayMode: token.displayMode });
+    if (!rendered) return escapeHtml(token.raw);
+    return sanitizeHtml(rendered, STRICT_MATHML_CONFIG);
+  } catch {
+    return escapeHtml(token.raw);
+  }
+}
+function parseMathMarkdown(source, renderer, profile, transformText) {
+  const input = source === null || source === void 0 ? "" : String(source);
+  if (!canSanitizeHtml()) return escapeHtml(input);
+  if (input.length > MATH_MARKDOWN_LIMITS.sourceLength) return escapeHtml(input);
+  const textRenderer = transformText ? {
+    renderer: {
+      text(token) {
+        if ("tokens" in token && token.tokens) {
+          return this.parser.parseInline(token.tokens);
+        }
+        const safeText = Renderer.prototype.text.call(this, token);
+        return transformText(safeText);
+      }
+    }
+  } : void 0;
+  const extensions = [mathExtension(renderer)];
+  if (profile === "cellMarkdown") extensions.push(cellLinkExtension());
+  if (textRenderer) extensions.push(textRenderer);
+  const parser = new Marked({ gfm: true }, ...extensions);
+  const parsed = parser.parse(input, { async: false });
+  return sanitizeHtml(parsed, FINAL_PROFILES[profile]);
+}
+export {
+  MATH_MARKDOWN_LIMITS,
+  parseMathMarkdown
+};
+//# sourceMappingURL=math-markdown.js.map

package/dist/utils/math-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-markdown.js","sources":["../../src/utils/math-markdown.ts"],"sourcesContent":["import type { Config } from 'dompurify'\nimport { Marked, Renderer, type MarkedExtension, type Tokens } from 'marked'\nimport type { MathRenderer } from '../context/MCPUIMathContext'\nimport { escapeHtml } from './escape-html'\nimport { canSanitizeHtml, sanitizeHtml } from './sanitize-html'\n\nexport type MathMarkdownProfile = 'prose' | 'cellMarkdown'\nexport type MarkdownTextTransform = (escapedText: string) => string\n\nexport const MATH_MARKDOWN_LIMITS = {\n  sourceLength: 100_000,\n  expressionLength: 4_096,\n  expressionCount: 128,\n} as const\n\nconst MATH_TAGS = [\n  'math', 'semantics', 'mrow', 'mi', 'mo', 'mn', 'mtext', 'mspace', 'ms',\n  'msup', 'msub', 'msubsup', 'mfrac', 'msqrt', 'mroot', 'mtable', 'mtr',\n  'mtd', 'mover', 'munder', 'munderover', 'mpadded', 'mphantom', 'mstyle', 'menclose',\n] as const\n\nconst MATH_ATTRS = [\n  'xmlns', 'display', 'class', 'mathvariant', 'stretchy', 'fence', 'separator',\n  'lspace', 'rspace', 'accent', 'accentunder', 'columnalign', 'rowalign',\n  'columnspacing', 'rowspacing', 'columnlines', 'rowlines', 'frame', 'notation',\n  'width', 'height', 'depth', 'voffset', 'scriptlevel', 'displaystyle',\n] as const\n\nconst STRICT_MATHML_CONFIG = {\n  ALLOWED_TAGS: [...MATH_TAGS, 'span'],\n  ALLOWED_ATTR: [...MATH_ATTRS],\n  FORBID_TAGS: ['annotation', 'annotation-xml', 'style', 'a'],\n  // DOMPurify normally keeps the text of forbidden tags. TeX annotations can\n  // be large and duplicate the accessible MathML, so remove their subtree.\n  ADD_FORBID_CONTENTS: ['annotation', 'annotation-xml'],\n  FORBID_ATTR: ['style'],\n} as Config\n\nconst CELL_MARKDOWN_TAGS = [\n  'a', 'strong', 'em', 'b', 'i', 'code', 'span', 'br', 'button', 'svg', 'path',\n  'p', 'ul', 'ol', 'li', 'pre', 'blockquote', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',\n  ...MATH_TAGS,\n]\n\nconst FINAL_PROFILES: Record<MathMarkdownProfile, Config> = {\n  prose: {\n    ADD_TAGS: [...MATH_TAGS],\n    ADD_ATTR: [...MATH_ATTRS, 'target', 'rel'],\n    FORBID_TAGS: ['annotation', 'annotation-xml', 'style', 'form', 'textarea', 'select', 'button', 'iframe', 'object', 'embed'],\n    ADD_FORBID_CONTENTS: ['annotation', 'annotation-xml'],\n    FORBID_ATTR: ['style'],\n  } as Config,\n  cellMarkdown: {\n    ALLOWED_TAGS: CELL_MARKDOWN_TAGS,\n    ALLOWED_ATTR: [\n      'href', 'target', 'rel', 'class', 'data-citation-page', 'data-citation-source',\n      'data-citation-doc', 'data-citation-verified', 'title', 'fill', 'stroke',\n      'viewBox', 'stroke-linecap', 'stroke-linejoin', 'stroke-width', 'd',\n      ...MATH_ATTRS,\n    ],\n    FORBID_TAGS: ['annotation', 'annotation-xml', 'style'],\n    ADD_FORBID_CONTENTS: ['annotation', 'annotation-xml'],\n    FORBID_ATTR: ['style'],\n  } as Config,\n}\n\ninterface MathToken extends Tokens.Generic {\n  type: 'mcpDisplayMath' | 'mcpInlineMath'\n  raw: string\n  tex: string\n  displayMode: boolean\n  render: boolean\n}\n\nfunction isCurrencyLike(raw: string, tex: string, following: string): boolean {\n  if (/^\\$\\s|\\s\\$$/.test(raw)) return true\n  if (/^\\d+(?:[.,]\\d+)?-\\s*$/.test(tex)) return true\n  if (/^\\d/.test(tex) && /^\\d/.test(following)) return true\n\n  // A currency opener can otherwise pair with the opening delimiter of a\n  // later expression (\"$5 then ($x$)\"). Reinterpret that first candidate\n  // only when it starts with a bounded numeric amount and its apparent closer\n  // is immediately followed by a complete later inline body. This deliberately\n  // leaves inherently ambiguous standalone forms ($5$, $2 + 3$, $2\\pi$) as\n  // math and does not depend on the prose between the two delimiters.\n  const amount = /^\\d+(?:[.,]\\d{1,2})?(?=$|[\\s,;:!?()[\\]+*/-])/.exec(tex)?.[0]\n  if (!amount) return false\n\n  // A standalone numeric token is valid math even when followed by prose or\n  // another expression (\"$5$, then $x$\"). Reassignment requires content\n  // beyond the amount itself.\n  const trailing = tex.slice(amount.length)\n  if (!trailing) return false\n\n  // During streaming, the later formula may not have closed yet. An unmatched\n  // opening parenthesis before its dollar is sufficient structural evidence\n  // that the numeric dollar was currency; otherwise a permissive renderer can\n  // briefly flash \"5 then (\" as math.\n  const hasUnmatchedOpeningParen = (trailing.match(/\\(/g)?.length ?? 0) > (trailing.match(/\\)/g)?.length ?? 0)\n  const containsTexCommand = /\\\\[A-Za-z]+/.test(trailing)\n  if (hasUnmatchedOpeningParen && !containsTexCommand) return true\n\n  const closerLooksLikeLaterOpener = /^(?![\\s,.;:!?)}\\]])(?:\\\\[^\\n]|[^\\\\\\n$])+\\$(?!\\$)/.test(following)\n  return closerLooksLikeLaterOpener\n}\n\nconst CELL_LINK_ATTRIBUTES = 'target=\"_blank\" rel=\"noopener noreferrer\" class=\"text-blue-600 dark:text-blue-400 hover:underline\"'\n\nfunction cellLinkExtension(): MarkedExtension {\n  return {\n    renderer: {\n      link(this: Renderer, token: Tokens.Link): string {\n        // Marked owns escaping of the destination, title and nested label\n        // tokens. Only inject fixed attributes into its already-safe anchor.\n        const anchor = Renderer.prototype.link.call(this, token) as string\n        return anchor.replace('<a ', `<a ${CELL_LINK_ATTRIBUTES} `)\n      },\n    },\n  }\n}\n\nfunction mathExtension(renderer: MathRenderer): MarkedExtension {\n  let count = 0\n  const token = (raw: string, tex: string, displayMode: boolean): MathToken => ({\n    type: displayMode ? 'mcpDisplayMath' : 'mcpInlineMath',\n    raw,\n    tex,\n    displayMode,\n    render: ++count <= MATH_MARKDOWN_LIMITS.expressionCount && tex.length <= MATH_MARKDOWN_LIMITS.expressionLength,\n  })\n\n  return {\n    extensions: [\n      {\n        name: 'mcpDisplayMath',\n        level: 'block',\n        start(src) {\n          const index = src.indexOf('$$')\n          return index < 0 ? undefined : index\n        },\n        tokenizer(src) {\n          const match = /^\\$\\$\\s*\\n?([\\s\\S]+?)\\n?\\s*\\$\\$(?:\\n|$)/.exec(src)\n          if (!match) return undefined\n          return token(match[0], match[1], true)\n        },\n        renderer(tokenValue) {\n          return renderToken(tokenValue as MathToken, renderer)\n        },\n      },\n      {\n        name: 'mcpInlineMath',\n        level: 'inline',\n        start(src) {\n          const index = src.indexOf('$')\n          return index < 0 ? undefined : index\n        },\n        tokenizer(src) {\n          const match = /^\\$(?!\\$)((?:\\\\[^\\n]|[^\\\\\\n$])+?)\\$(?!\\$)/.exec(src)\n          if (!match || isCurrencyLike(match[0], match[1], src.slice(match[0].length))) return undefined\n          return token(match[0], match[1], false)\n        },\n        renderer(tokenValue) {\n          return renderToken(tokenValue as MathToken, renderer)\n        },\n      },\n    ],\n  }\n}\n\nfunction renderToken(token: MathToken, renderer: MathRenderer): string {\n  if (!token.render) return escapeHtml(token.raw)\n  try {\n    const rendered = renderer(token.tex, { displayMode: token.displayMode })\n    if (!rendered) return escapeHtml(token.raw)\n    return sanitizeHtml(rendered, STRICT_MATHML_CONFIG)\n  } catch {\n    return escapeHtml(token.raw)\n  }\n}\n\n/**\n * Parse Markdown with isolated, bounded math support and sanitize the complete\n * result for its final sink. The optional transform sees escaped ordinary text\n * tokens only. Math, code, raw HTML and link destinations never pass through\n * it, so citation syntax cannot corrupt TeX optional arguments or attributes.\n */\nexport function parseMathMarkdown(\n  source: string,\n  renderer: MathRenderer,\n  profile: MathMarkdownProfile,\n  transformText?: MarkdownTextTransform,\n): string {\n  const input = source === null || source === undefined ? '' : String(source)\n  if (!canSanitizeHtml()) return escapeHtml(input)\n  if (input.length > MATH_MARKDOWN_LIMITS.sourceLength) return escapeHtml(input)\n\n  const textRenderer = transformText\n    ? {\n        renderer: {\n          text(this: Renderer, token: Tokens.Text | Tokens.Escape): string {\n            // Block text tokens (notably list-item text) can own already\n            // tokenized inline children. Recurse first so math and code keep\n            // their own renderers; leaf text callbacks run as parsing descends.\n            if ('tokens' in token && token.tokens) {\n              return this.parser.parseInline(token.tokens)\n            }\n            // Delegate entity handling and nested token rendering to Marked's\n            // own renderer. `escapeHtml` is deliberately not equivalent: it\n            // turns source `&amp;` into visible `&amp;` by double-escaping it.\n            const safeText = Renderer.prototype.text.call(this, token)\n            return transformText(safeText as string)\n          },\n        },\n      }\n    : undefined\n  const extensions = [mathExtension(renderer)]\n  if (profile === 'cellMarkdown') extensions.push(cellLinkExtension())\n  if (textRenderer) extensions.push(textRenderer)\n  const parser = new Marked({ gfm: true }, ...extensions)\n  const parsed = parser.parse(input, { async: false }) as string\n  return sanitizeHtml(parsed, FINAL_PROFILES[profile])\n}\n"],"names":[],"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.22.0",
+  "version": "6.24.0",
   "description": "SolidJS components for rendering MCP-generated UI resources",
   "type": "module",
   "files": [
@@ -44,6 +44,9 @@
       ],
       "plugins/duckdb": [
         "./dist/plugins/duckdb.d.ts"
+      ],
+      "plugins/katex": [
+        "./dist/plugins/katex.d.ts"
       ]
     }
   },
@@ -147,6 +150,17 @@
         "default": "./dist/plugins/duckdb.cjs"
       }
     },
+    "./plugins/katex": {
+      "solid": "./src/plugins/katex.ts",
+      "import": {
+        "types": "./dist/plugins/katex.d.ts",
+        "default": "./dist/plugins/katex.js"
+      },
+      "require": {
+        "types": "./dist/plugins/katex.d.cts",
+        "default": "./dist/plugins/katex.cjs"
+      }
+    },
     "./src/*": "./src/*"
   },
   "_size-limit-note": "size-limit is a regression guardrail, not a hard cap — it flags accidental bundle bloat. It measures the pre-built dist/index.js and sums the FULL graph reachable from each entry, including lazy import() chunks (leaflet, @antv/g6, chart.js) a consumer fetches on demand, NOT at import time — so the figures are worst-case totals, not eager load cost. Since v6.6.0 the 'Streaming renderer' entry delegates to UIResourceRenderer (Gap 1 parity), so its graph equals the full renderer set; its budget is set to 1 MB (generous headroom — the real eager cost is far lower). The 'Hooks only' and 'Full bundle' limits are pre-existing and unchanged by v6.6.0. size-limit is informational only — it does not gate CI.",
@@ -176,6 +190,7 @@
     "chart.js": "^4.0.0",
     "chartjs-plugin-zoom": "^2.0.0",
     "highlight.js": "^11.9.0",
+    "katex": "0.18.4",
     "leaflet": "^1.9.4",
     "leaflet.markercluster": "^1.5.0",
     "protomaps-leaflet": "^4.0.0",
@@ -197,6 +212,9 @@
     "highlight.js": {
       "optional": true
     },
+    "katex": {
+      "optional": true
+    },
     "leaflet": {
       "optional": true
     },
@@ -211,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",
@@ -232,6 +250,7 @@
     "chart.js": "^4.5.1",
     "eslint": "^8.56.0",
     "jsdom": "^27.2.0",
+    "katex": "0.18.4",
     "leaflet.markercluster": "^1.5.3",
     "size-limit": "^12.0.0",
     "solid-js": "^1.9.11",
@@ -262,7 +281,7 @@
   },
   "scripts": {
     "build": "vite build && pnpm build:types",
-    "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist --composite false && pnpm build:types:copy",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist --composite false && pnpm build:types:copy && cp dist/plugins/katex.d.ts dist/plugins/katex.d.cts",
     "build:types:copy": "printf \"export * from './components/index';\\nexport { default } from './components/index';\\n\" > dist/components.d.ts && printf \"export * from './hooks/index';\\n\" > dist/hooks.d.ts && printf \"export * from './types/index';\\n\" > dist/types.d.ts && printf \"export * from './adapters/index';\\n\" > dist/adapters.d.ts && pnpm build:types:cts",
     "build:types:cts": "cp dist/index.d.ts dist/index.d.cts && cp dist/components.d.ts dist/components.d.cts 2>/dev/null || true && cp dist/hooks.d.ts dist/hooks.d.cts 2>/dev/null || true && cp dist/types.d.ts dist/types.d.cts 2>/dev/null || true && cp dist/validation.d.ts dist/validation.d.cts 2>/dev/null || true && cp dist/types-export.d.ts dist/types-export.d.cts 2>/dev/null || true && cp dist/adapters.d.ts dist/adapters.d.cts 2>/dev/null || true && cp dist/adapters/presentation.d.ts dist/adapters/presentation.d.cts 2>/dev/null || true && cp dist/plugins/duckdb.d.ts dist/plugins/duckdb.d.cts 2>/dev/null || true",
     "dev": "vite build --watch",
@@ -270,7 +289,7 @@
     "test:watch": "vitest",
     "test:browser": "vitest --mode browser",
     "lint": "eslint src",
-    "typecheck": "tsc --noEmit",
+    "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"