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

package/dist/components/chart-missing-plugin.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Missing values in a Chart.js chart (v6.24.0) — everything the renderer adds
+ * to its Chart.js config when a payload says a value is MISSING (`null`).
+ *
+ * The rule: absence is never zero. Chart.js already keeps the slot of a `null`
+ * (no label dropped) and draws nothing for it; what it does not do is make the
+ * absence READABLE. A null bar is a zero-height bar that is skipped when
+ * drawn, a null line point is a hole the line may bridge (`spanGaps`), and the
+ * legend, tooltip and axis know nothing of either. This module supplies:
+ *
+ * - {@link createMissingValuesPlugin} — a PER-CHART plugin (never
+ *   `Chart.register`ed, so it can leak into no other chart) that outlines a
+ *   dashed stub where a bar should have been (not on stacked or overlaid
+ *   bars, whose baseline belongs to another series), and says "no data" on a
+ *   chart with nothing to draw;
+ * - {@link createMissingLegendGenerator} — marks a fully-missing series in the
+ *   legend;
+ * - {@link createTooltipLabel} — names a missing value, and appends the unit;
+ * - {@link withDatasetsNoGapSpan} — the shallow-cloned data with
+ *   `spanGaps: false`;
+ * - {@link applyUnitAxisTitle} — the unit as the value axis title.
+ *
+ * Runtime-free on purpose (no `solid-js`, no `chart.js` import): the renderer
+ * hands in the Chart.js pieces it loaded and the chrome strings (lazily, as
+ * getters, so a late locale change is honoured at draw time). Every function
+ * is defensive — a drawing hook that throws would blank the whole chart.
+ *
+ * Chart.js 4.5.1 facts this relies on (verified in `dist/chart.js`):
+ * - a bar whose parsed value is `null` gets `base = head = vScale.getBasePixel()`
+ *   and no `skip` flag (BarController.updateElements), and `BarController.draw`
+ *   skips it (`getParsed(i)[vScale.axis] !== null`) — so nothing is painted;
+ * - the bar element still carries its true index-axis thickness (`width` for a
+ *   vertical bar, `height` for a horizontal one).
+ */
+import type { MCPUIStrings } from '../context/MCPUIStringsContext';
+type Strings = Required<MCPUIStrings>;
+/** Length, in px along the value axis, of the dashed stub of a missing bar. */
+export declare const MISSING_BAR_STUB_LENGTH = 12;
+/** Stroke of the stub when the dataset names no border colour. */
+export declare const MISSING_BAR_FALLBACK_COLOR = "#9ca3af";
+/** Colour of the centred "no data" text. */
+export declare const NO_DATA_TEXT_COLOR = "#6b7280";
+/**
+ * The category of convention line a chart shows under its canvas:
+ * `'gaps'` (a line breaks), `'bars'` (a dashed outline stands in for the
+ * bar) or `'omitted'` (nothing is drawn: scatter, bubble, stacked bars).
+ */
+export type MissingNoteKind = 'gaps' | 'bars' | 'omitted';
+/**
+ * Whether a bar chart's bars are stacked or overlaid (`stacked` on either
+ * axis). A missing bar there has no slot of its own at the baseline — the
+ * baseline belongs to the series below — so no dashed outline is drawn.
+ */
+export declare function isStackedChart(options: any): boolean;
+/** Which convention note a chart gets: how ITS missing values are drawn. */
+export declare function missingNoteKind(chartType: string | undefined, options?: any): MissingNoteKind;
+/**
+ * Chart.js data with every dataset shallow-cloned and `spanGaps: false`, so a
+ * line breaks at a missing value instead of joining its neighbours. Never
+ * mutates its input; `labels` and every other key are carried by reference.
+ */
+export declare function withDatasetsNoGapSpan<D extends {
+    datasets?: unknown;
+}>(data: D): D;
+type LegendGenerator = (chart: any) => any[];
+/**
+ * Wraps a Chart.js legend label generator so a fully-missing dataset reads
+ * `"{series} (no data)"` (`strings.chartLegendNoData`). Every other item is
+ * passed through untouched.
+ */
+export declare function createMissingLegendGenerator(base: LegendGenerator, fullyMissing: readonly boolean[], getStrings: () => Strings): LegendGenerator;
+/** Whether a Chart.js tooltip item stands for a missing value. */
+export declare function isMissingTooltipItem(item: any): boolean;
+/**
+ * Tooltip `label` callback: names a missing value (`"{series}: Missing
+ * value"`) and, with a `unit`, appends it to a present one. Otherwise it is
+ * Chart.js's default composition (dataset label, `": "`, formatted value) —
+ * including its `mode: 'dataset'` branch, which prefixes the CATEGORY label
+ * instead, since every item of that tooltip belongs to the same dataset.
+ * Hence a regular function: Chart.js calls it with the tooltip as `this`.
+ *
+ * `unit` is left off scatter and bubble tooltips: their formatted value is the
+ * pair `(x, y)`, to which one unit does not belong.
+ */
+export declare function createTooltipLabel(getStrings: () => Strings, unit: string | undefined, chartType: string | undefined): (this: any, item: any) => string;
+/**
+ * Sets the chart's `unit` as the title of its value axis, in place on the
+ * `options` object the renderer just built (never on the payload's).
+ *
+ * Only bar, line, scatter and bubble have a value axis to title. The value
+ * axis is `y`, or `x` when the index axis is `y` (a horizontal bar or line).
+ * An existing `scales[axis].title` is the payload's own word and is kept; the
+ * rest of the scale config (a `timeAxis` block sets `scales.x`) is kept too.
+ */
+export declare function applyUnitAxisTitle(options: any, chartType: string | undefined, unit: string | undefined): void;
+export interface MissingValuesPluginOptions {
+    /** At least one dataset and every one of them has no observed value. */
+    allMissing: boolean;
+    /** Lazy: read at draw time. */
+    getNoDataText: () => string;
+    /** Lazy: `Chart.defaults.font.family`, when the build exposes it. */
+    getFontFamily?: () => string | undefined;
+}
+/**
+ * Draws a dashed outline stub for every missing bar of every visible,
+ * non-stacked bar dataset, so a missing value is a visible mark, not a bar
+ * that "is" zero.
+ *
+ * The stub sits on the value-axis base, as thick as the bar would have been,
+ * and runs {@link MISSING_BAR_STUB_LENGTH}px toward the middle of the chart
+ * area (up from a bottom baseline, down from a top one, right from a left
+ * one). Clipped to the chart area.
+ */
+export declare function drawMissingBarStubs(chart: any): void;
+/** Draws `text` centred in the chart area (a chart with nothing to plot). */
+export declare function drawNoDataText(chart: any, text: string, fontFamily?: string): void;
+/**
+ * The per-chart plugin object. Passed as `config.plugins = [plugin]`: Chart.js
+ * scopes it to that one chart. Both hooks swallow their own errors — a
+ * decoration must never take the chart down.
+ */
+export declare function createMissingValuesPlugin(options: MissingValuesPluginOptions): {
+    id: string;
+    afterDatasetsDraw(chart: any): void;
+};
+export {};
+//# sourceMappingURL=chart-missing-plugin.d.ts.map

package/dist/components/chart-missing-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-missing-plugin.d.ts","sourceRoot":"","sources":["../../src/components/chart-missing-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAInE,KAAK,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,YAAY,CAAC;AACpD,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAM5C;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAEpD;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,eAAe,CAI7F;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAWlF;AAID,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,SAAS,OAAO,EAAE,EAChC,UAAU,EAAE,MAAM,OAAO,GACxB,eAAe,CAcjB;AAID,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAWvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,OAAO,EACzB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,MAAM,CAgBlC;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI,CAYN;AAID,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,UAAU,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC1C;AAYD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CA+DpD;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAalF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B;;6BAGhD,GAAG;EAW/B"}

package/dist/components/chart-missing-plugin.js

@@ -0,0 +1,194 @@
+import { formatMCPUIString } from "../utils/format-string.js";
+import { isMissingChartValue } from "../utils/missing-value.js";
+const MISSING_BAR_STUB_LENGTH = 12;
+const MISSING_BAR_FALLBACK_COLOR = "#9ca3af";
+const NO_DATA_TEXT_COLOR = "#6b7280";
+const STUB_DASH = [4, 3];
+const POINT_CHART_TYPES = /* @__PURE__ */ new Set(["scatter", "bubble"]);
+function isStackedChart(options) {
+  var _a, _b, _c, _d;
+  return Boolean(((_b = (_a = options == null ? void 0 : options.scales) == null ? void 0 : _a.x) == null ? void 0 : _b.stacked) || ((_d = (_c = options == null ? void 0 : options.scales) == null ? void 0 : _c.y) == null ? void 0 : _d.stacked));
+}
+function missingNoteKind(chartType, options) {
+  if (chartType === "bar") return isStackedChart(options) ? "omitted" : "bars";
+  if (chartType === "scatter" || chartType === "bubble") return "omitted";
+  return "gaps";
+}
+function withDatasetsNoGapSpan(data) {
+  const datasets = Array.isArray(data == null ? void 0 : data.datasets) ? data.datasets : null;
+  if (!datasets) return data;
+  return {
+    ...data,
+    datasets: datasets.map(
+      (dataset) => dataset !== null && typeof dataset === "object" ? { ...dataset, spanGaps: false } : dataset
+    )
+  };
+}
+function createMissingLegendGenerator(base, fullyMissing, getStrings) {
+  return function generateLabels(chart) {
+    const items = base.call(this, chart);
+    if (!Array.isArray(items)) return items;
+    return items.map((item) => {
+      const index = item == null ? void 0 : item.datasetIndex;
+      if (typeof index !== "number" || !fullyMissing[index]) return item;
+      const text = typeof item.text === "string" ? item.text : String(item.text ?? "");
+      return {
+        ...item,
+        text: formatMCPUIString(getStrings().chartLegendNoData, { series: text })
+      };
+    });
+  };
+}
+function isMissingTooltipItem(item) {
+  var _a, _b, _c, _d;
+  if (item === null || item === void 0) return false;
+  if (item.raw === null || item.raw === void 0 || isMissingChartValue(item.raw)) return true;
+  const parsed = item.parsed;
+  if (parsed !== null && typeof parsed === "object") {
+    const chartType = (_b = (_a = item.chart) == null ? void 0 : _a.config) == null ? void 0 : _b.type;
+    const valueKey = chartType === "radar" ? "r" : ((_d = (_c = item.chart) == null ? void 0 : _c.options) == null ? void 0 : _d.indexAxis) === "y" ? "x" : "y";
+    if (valueKey in parsed && parsed[valueKey] === null) return true;
+  }
+  return false;
+}
+function createTooltipLabel(getStrings, unit, chartType) {
+  const applyUnit = unit !== void 0 && !POINT_CHART_TYPES.has(chartType ?? "");
+  return function label(item) {
+    var _a, _b;
+    const strings = getStrings();
+    const prefixLabel = ((_a = this == null ? void 0 : this.options) == null ? void 0 : _a.mode) === "dataset" ? item == null ? void 0 : item.label : (_b = item == null ? void 0 : item.dataset) == null ? void 0 : _b.label;
+    const prefix = typeof prefixLabel === "string" && prefixLabel !== "" ? `${prefixLabel}: ` : "";
+    if (isMissingTooltipItem(item)) return `${prefix}${strings.missingValue}`;
+    const formatted = item == null ? void 0 : item.formattedValue;
+    if (formatted === null || formatted === void 0) return prefix;
+    const value = applyUnit ? formatMCPUIString(strings.chartValueWithUnit, { value: formatted, unit }) : String(formatted);
+    return `${prefix}${value}`;
+  };
+}
+function applyUnitAxisTitle(options, chartType, unit) {
+  var _a, _b, _c;
+  if (unit === void 0) return;
+  if (chartType !== "bar" && chartType !== "line" && !POINT_CHART_TYPES.has(chartType ?? "")) {
+    return;
+  }
+  const horizontal = (chartType === "bar" || chartType === "line") && (options == null ? void 0 : options.indexAxis) === "y";
+  const axis = horizontal ? "x" : "y";
+  if (((_b = (_a = options.scales) == null ? void 0 : _a[axis]) == null ? void 0 : _b.title) !== void 0) return;
+  options.scales = {
+    ...options.scales,
+    [axis]: { ...(_c = options.scales) == null ? void 0 : _c[axis], title: { display: true, text: unit } }
+  };
+}
+function colorAt(color, index) {
+  if (typeof color === "string" && color !== "") return color;
+  if (Array.isArray(color) && color.length > 0) {
+    const picked = color[index % color.length];
+    return typeof picked === "string" && picked !== "" ? picked : void 0;
+  }
+  return void 0;
+}
+function drawMissingBarStubs(chart) {
+  var _a, _b;
+  const ctx = chart == null ? void 0 : chart.ctx;
+  const area = chart == null ? void 0 : chart.chartArea;
+  const datasets = (_a = chart == null ? void 0 : chart.data) == null ? void 0 : _a.datasets;
+  if (!ctx || !area || !Array.isArray(datasets)) return;
+  const left = area.left;
+  const top = area.top;
+  const right = area.right ?? left + (area.width ?? 0);
+  const bottom = area.bottom ?? top + (area.height ?? 0);
+  let saved = false;
+  datasets.forEach((dataset, datasetIndex) => {
+    var _a2, _b2, _c, _d, _e, _f, _g;
+    const meta = (_a2 = chart.getDatasetMeta) == null ? void 0 : _a2.call(chart, datasetIndex);
+    if (!meta) return;
+    const isBar = meta.type === "bar" || ((_c = (_b2 = meta.controller) == null ? void 0 : _b2.constructor) == null ? void 0 : _c.id) === "bar";
+    if (!isBar) return;
+    if (((_e = (_d = meta.vScale) == null ? void 0 : _d.options) == null ? void 0 : _e.stacked) || ((_g = (_f = meta.iScale) == null ? void 0 : _f.options) == null ? void 0 : _g.stacked)) return;
+    if (typeof chart.isDatasetVisible === "function" && !chart.isDatasetVisible(datasetIndex)) {
+      return;
+    }
+    const values = Array.isArray(dataset == null ? void 0 : dataset.data) ? dataset.data : [];
+    const elements = Array.isArray(meta.data) ? meta.data : [];
+    values.forEach((value, index) => {
+      var _a3;
+      if (!isMissingChartValue(value)) return;
+      const element = elements[index];
+      if (!element) return;
+      const props = ((_a3 = element.getProps) == null ? void 0 : _a3.call(element, ["x", "y", "base", "width", "height"], true)) ?? element;
+      const { x, y, base, width, height } = props;
+      if (![x, y, base].every((n) => Number.isFinite(n))) return;
+      const horizontal = element.horizontal === true;
+      const thickness = horizontal ? height : width;
+      if (!Number.isFinite(thickness) || thickness <= 0) return;
+      let rect;
+      if (horizontal) {
+        const dir = base < (left + right) / 2 ? 1 : -1;
+        rect = [Math.min(base, base + dir * MISSING_BAR_STUB_LENGTH), y - thickness / 2, MISSING_BAR_STUB_LENGTH, thickness];
+      } else {
+        const dir = base > (top + bottom) / 2 ? -1 : 1;
+        rect = [x - thickness / 2, Math.min(base, base + dir * MISSING_BAR_STUB_LENGTH), thickness, MISSING_BAR_STUB_LENGTH];
+      }
+      if (!saved) {
+        ctx.save();
+        ctx.beginPath();
+        ctx.rect(left, top, right - left, bottom - top);
+        ctx.clip();
+        saved = true;
+      }
+      ctx.strokeStyle = colorAt(dataset == null ? void 0 : dataset.borderColor, index) ?? MISSING_BAR_FALLBACK_COLOR;
+      ctx.lineWidth = 1;
+      ctx.setLineDash(STUB_DASH);
+      ctx.strokeRect(...rect);
+    });
+  });
+  if (saved) {
+    (_b = ctx.setLineDash) == null ? void 0 : _b.call(ctx, []);
+    ctx.restore();
+  }
+}
+function drawNoDataText(chart, text, fontFamily) {
+  const ctx = chart == null ? void 0 : chart.ctx;
+  const area = chart == null ? void 0 : chart.chartArea;
+  if (!ctx || !area || !text) return;
+  const cx = (area.left + (area.right ?? area.left + (area.width ?? 0))) / 2;
+  const cy = (area.top + (area.bottom ?? area.top + (area.height ?? 0))) / 2;
+  ctx.save();
+  ctx.font = `12px ${fontFamily || "sans-serif"}`;
+  ctx.fillStyle = NO_DATA_TEXT_COLOR;
+  ctx.textAlign = "center";
+  ctx.textBaseline = "middle";
+  ctx.fillText(text, cx, cy);
+  ctx.restore();
+}
+function createMissingValuesPlugin(options) {
+  return {
+    id: "mcpuiMissingValues",
+    afterDatasetsDraw(chart) {
+      var _a;
+      try {
+        drawMissingBarStubs(chart);
+        if (options.allMissing) {
+          drawNoDataText(chart, options.getNoDataText(), (_a = options.getFontFamily) == null ? void 0 : _a.call(options));
+        }
+      } catch {
+      }
+    }
+  };
+}
+export {
+  MISSING_BAR_FALLBACK_COLOR,
+  MISSING_BAR_STUB_LENGTH,
+  NO_DATA_TEXT_COLOR,
+  applyUnitAxisTitle,
+  createMissingLegendGenerator,
+  createMissingValuesPlugin,
+  createTooltipLabel,
+  drawMissingBarStubs,
+  drawNoDataText,
+  isMissingTooltipItem,
+  isStackedChart,
+  missingNoteKind,
+  withDatasetsNoGapSpan
+};
+//# sourceMappingURL=chart-missing-plugin.js.map

package/dist/components/chart-missing-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-missing-plugin.js","sources":["../../src/components/chart-missing-plugin.ts"],"sourcesContent":["/**\n * Missing values in a Chart.js chart (v6.24.0) — everything the renderer adds\n * to its Chart.js config when a payload says a value is MISSING (`null`).\n *\n * The rule: absence is never zero. Chart.js already keeps the slot of a `null`\n * (no label dropped) and draws nothing for it; what it does not do is make the\n * absence READABLE. A null bar is a zero-height bar that is skipped when\n * drawn, a null line point is a hole the line may bridge (`spanGaps`), and the\n * legend, tooltip and axis know nothing of either. This module supplies:\n *\n * - {@link createMissingValuesPlugin} — a PER-CHART plugin (never\n *   `Chart.register`ed, so it can leak into no other chart) that outlines a\n *   dashed stub where a bar should have been (not on stacked or overlaid\n *   bars, whose baseline belongs to another series), and says \"no data\" on a\n *   chart with nothing to draw;\n * - {@link createMissingLegendGenerator} — marks a fully-missing series in the\n *   legend;\n * - {@link createTooltipLabel} — names a missing value, and appends the unit;\n * - {@link withDatasetsNoGapSpan} — the shallow-cloned data with\n *   `spanGaps: false`;\n * - {@link applyUnitAxisTitle} — the unit as the value axis title.\n *\n * Runtime-free on purpose (no `solid-js`, no `chart.js` import): the renderer\n * hands in the Chart.js pieces it loaded and the chrome strings (lazily, as\n * getters, so a late locale change is honoured at draw time). Every function\n * is defensive — a drawing hook that throws would blank the whole chart.\n *\n * Chart.js 4.5.1 facts this relies on (verified in `dist/chart.js`):\n * - a bar whose parsed value is `null` gets `base = head = vScale.getBasePixel()`\n *   and no `skip` flag (BarController.updateElements), and `BarController.draw`\n *   skips it (`getParsed(i)[vScale.axis] !== null`) — so nothing is painted;\n * - the bar element still carries its true index-axis thickness (`width` for a\n *   vertical bar, `height` for a horizontal one).\n */\n\nimport type { MCPUIStrings } from '../context/MCPUIStringsContext';\nimport { formatMCPUIString } from '../utils/format-string';\nimport { isMissingChartValue } from '../utils/missing-value';\n\ntype Strings = Required<MCPUIStrings>;\n\n/** Length, in px along the value axis, of the dashed stub of a missing bar. */\nexport const MISSING_BAR_STUB_LENGTH = 12;\n/** Stroke of the stub when the dataset names no border colour. */\nexport const MISSING_BAR_FALLBACK_COLOR = '#9ca3af';\n/** Colour of the centred \"no data\" text. */\nexport const NO_DATA_TEXT_COLOR = '#6b7280';\nconst STUB_DASH = [4, 3];\n\n/** Chart types whose value axis is `y` and whose points are `{x, y}`. */\nconst POINT_CHART_TYPES = new Set(['scatter', 'bubble']);\n\n/**\n * The category of convention line a chart shows under its canvas:\n * `'gaps'` (a line breaks), `'bars'` (a dashed outline stands in for the\n * bar) or `'omitted'` (nothing is drawn: scatter, bubble, stacked bars).\n */\nexport type MissingNoteKind = 'gaps' | 'bars' | 'omitted';\n\n/**\n * Whether a bar chart's bars are stacked or overlaid (`stacked` on either\n * axis). A missing bar there has no slot of its own at the baseline — the\n * baseline belongs to the series below — so no dashed outline is drawn.\n */\nexport function isStackedChart(options: any): boolean {\n  return Boolean(options?.scales?.x?.stacked || options?.scales?.y?.stacked);\n}\n\n/** Which convention note a chart gets: how ITS missing values are drawn. */\nexport function missingNoteKind(chartType: string | undefined, options?: any): MissingNoteKind {\n  if (chartType === 'bar') return isStackedChart(options) ? 'omitted' : 'bars';\n  if (chartType === 'scatter' || chartType === 'bubble') return 'omitted';\n  return 'gaps';\n}\n\n// ─── Data ──────────────────────────────────────────────────────────────────\n\n/**\n * Chart.js data with every dataset shallow-cloned and `spanGaps: false`, so a\n * line breaks at a missing value instead of joining its neighbours. Never\n * mutates its input; `labels` and every other key are carried by reference.\n */\nexport function withDatasetsNoGapSpan<D extends { datasets?: unknown }>(data: D): D {\n  const datasets = Array.isArray(data?.datasets) ? data.datasets : null;\n  if (!datasets) return data;\n  return {\n    ...data,\n    datasets: datasets.map((dataset: unknown) =>\n      dataset !== null && typeof dataset === 'object'\n        ? { ...(dataset as object), spanGaps: false }\n        : dataset\n    ),\n  };\n}\n\n// ─── Legend ────────────────────────────────────────────────────────────────\n\ntype LegendGenerator = (chart: any) => any[];\n\n/**\n * Wraps a Chart.js legend label generator so a fully-missing dataset reads\n * `\"{series} (no data)\"` (`strings.chartLegendNoData`). Every other item is\n * passed through untouched.\n */\nexport function createMissingLegendGenerator(\n  base: LegendGenerator,\n  fullyMissing: readonly boolean[],\n  getStrings: () => Strings\n): LegendGenerator {\n  return function generateLabels(this: unknown, chart: any) {\n    const items = base.call(this, chart);\n    if (!Array.isArray(items)) return items;\n    return items.map((item) => {\n      const index = item?.datasetIndex;\n      if (typeof index !== 'number' || !fullyMissing[index]) return item;\n      const text = typeof item.text === 'string' ? item.text : String(item.text ?? '');\n      return {\n        ...item,\n        text: formatMCPUIString(getStrings().chartLegendNoData, { series: text }),\n      };\n    });\n  };\n}\n\n// ─── Tooltip ───────────────────────────────────────────────────────────────\n\n/** Whether a Chart.js tooltip item stands for a missing value. */\nexport function isMissingTooltipItem(item: any): boolean {\n  if (item === null || item === undefined) return false;\n  if (item.raw === null || item.raw === undefined || isMissingChartValue(item.raw)) return true;\n  const parsed = item.parsed;\n  if (parsed !== null && typeof parsed === 'object') {\n    const chartType = item.chart?.config?.type;\n    const valueKey =\n      chartType === 'radar' ? 'r' : item.chart?.options?.indexAxis === 'y' ? 'x' : 'y';\n    if (valueKey in parsed && parsed[valueKey] === null) return true;\n  }\n  return false;\n}\n\n/**\n * Tooltip `label` callback: names a missing value (`\"{series}: Missing\n * value\"`) and, with a `unit`, appends it to a present one. Otherwise it is\n * Chart.js's default composition (dataset label, `\": \"`, formatted value) —\n * including its `mode: 'dataset'` branch, which prefixes the CATEGORY label\n * instead, since every item of that tooltip belongs to the same dataset.\n * Hence a regular function: Chart.js calls it with the tooltip as `this`.\n *\n * `unit` is left off scatter and bubble tooltips: their formatted value is the\n * pair `(x, y)`, to which one unit does not belong.\n */\nexport function createTooltipLabel(\n  getStrings: () => Strings,\n  unit: string | undefined,\n  chartType: string | undefined\n): (this: any, item: any) => string {\n  const applyUnit = unit !== undefined && !POINT_CHART_TYPES.has(chartType ?? '');\n  return function label(this: any, item: any) {\n    const strings = getStrings();\n    const prefixLabel = this?.options?.mode === 'dataset' ? item?.label : item?.dataset?.label;\n    const prefix = typeof prefixLabel === 'string' && prefixLabel !== '' ? `${prefixLabel}: ` : '';\n\n    if (isMissingTooltipItem(item)) return `${prefix}${strings.missingValue}`;\n\n    const formatted = item?.formattedValue;\n    if (formatted === null || formatted === undefined) return prefix;\n    const value = applyUnit\n      ? formatMCPUIString(strings.chartValueWithUnit, { value: formatted, unit: unit as string })\n      : String(formatted);\n    return `${prefix}${value}`;\n  };\n}\n\n// ─── Axis ──────────────────────────────────────────────────────────────────\n\n/**\n * Sets the chart's `unit` as the title of its value axis, in place on the\n * `options` object the renderer just built (never on the payload's).\n *\n * Only bar, line, scatter and bubble have a value axis to title. The value\n * axis is `y`, or `x` when the index axis is `y` (a horizontal bar or line).\n * An existing `scales[axis].title` is the payload's own word and is kept; the\n * rest of the scale config (a `timeAxis` block sets `scales.x`) is kept too.\n */\nexport function applyUnitAxisTitle(\n  options: any,\n  chartType: string | undefined,\n  unit: string | undefined\n): void {\n  if (unit === undefined) return;\n  if (chartType !== 'bar' && chartType !== 'line' && !POINT_CHART_TYPES.has(chartType ?? '')) {\n    return;\n  }\n  const horizontal = (chartType === 'bar' || chartType === 'line') && options?.indexAxis === 'y';\n  const axis = horizontal ? 'x' : 'y';\n  if (options.scales?.[axis]?.title !== undefined) return;\n  options.scales = {\n    ...options.scales,\n    [axis]: { ...options.scales?.[axis], title: { display: true, text: unit } },\n  };\n}\n\n// ─── Plugin ────────────────────────────────────────────────────────────────\n\nexport interface MissingValuesPluginOptions {\n  /** At least one dataset and every one of them has no observed value. */\n  allMissing: boolean;\n  /** Lazy: read at draw time. */\n  getNoDataText: () => string;\n  /** Lazy: `Chart.defaults.font.family`, when the build exposes it. */\n  getFontFamily?: () => string | undefined;\n}\n\n/** A dataset colour for entry `index`, as a string, or `undefined`. */\nfunction colorAt(color: unknown, index: number): string | undefined {\n  if (typeof color === 'string' && color !== '') return color;\n  if (Array.isArray(color) && color.length > 0) {\n    const picked = color[index % color.length];\n    return typeof picked === 'string' && picked !== '' ? picked : undefined;\n  }\n  return undefined;\n}\n\n/**\n * Draws a dashed outline stub for every missing bar of every visible,\n * non-stacked bar dataset, so a missing value is a visible mark, not a bar\n * that \"is\" zero.\n *\n * The stub sits on the value-axis base, as thick as the bar would have been,\n * and runs {@link MISSING_BAR_STUB_LENGTH}px toward the middle of the chart\n * area (up from a bottom baseline, down from a top one, right from a left\n * one). Clipped to the chart area.\n */\nexport function drawMissingBarStubs(chart: any): void {\n  const ctx = chart?.ctx;\n  const area = chart?.chartArea;\n  const datasets = chart?.data?.datasets;\n  if (!ctx || !area || !Array.isArray(datasets)) return;\n\n  const left = area.left;\n  const top = area.top;\n  const right = area.right ?? left + (area.width ?? 0);\n  const bottom = area.bottom ?? top + (area.height ?? 0);\n\n  let saved = false;\n  datasets.forEach((dataset: any, datasetIndex: number) => {\n    const meta = chart.getDatasetMeta?.(datasetIndex);\n    if (!meta) return;\n    const isBar = meta.type === 'bar' || meta.controller?.constructor?.id === 'bar';\n    if (!isBar) return;\n    // Stacked or overlaid bars: the baseline under a missing segment is the\n    // series below, so an outline there would point at the wrong series.\n    if (meta.vScale?.options?.stacked || meta.iScale?.options?.stacked) return;\n    if (typeof chart.isDatasetVisible === 'function' && !chart.isDatasetVisible(datasetIndex)) {\n      return;\n    }\n    const values: unknown[] = Array.isArray(dataset?.data) ? dataset.data : [];\n    const elements: any[] = Array.isArray(meta.data) ? meta.data : [];\n\n    values.forEach((value, index) => {\n      if (!isMissingChartValue(value)) return;\n      const element = elements[index];\n      if (!element) return;\n      const props = element.getProps?.(['x', 'y', 'base', 'width', 'height'], true) ?? element;\n      const { x, y, base, width, height } = props;\n      if (![x, y, base].every((n) => Number.isFinite(n))) return;\n      const horizontal = element.horizontal === true;\n      const thickness = horizontal ? height : width;\n      if (!Number.isFinite(thickness) || thickness <= 0) return;\n\n      let rect: [number, number, number, number];\n      if (horizontal) {\n        const dir = base < (left + right) / 2 ? 1 : -1;\n        rect = [Math.min(base, base + dir * MISSING_BAR_STUB_LENGTH), y - thickness / 2, MISSING_BAR_STUB_LENGTH, thickness];\n      } else {\n        const dir = base > (top + bottom) / 2 ? -1 : 1;\n        rect = [x - thickness / 2, Math.min(base, base + dir * MISSING_BAR_STUB_LENGTH), thickness, MISSING_BAR_STUB_LENGTH];\n      }\n\n      if (!saved) {\n        ctx.save();\n        ctx.beginPath();\n        ctx.rect(left, top, right - left, bottom - top);\n        ctx.clip();\n        saved = true;\n      }\n      ctx.strokeStyle = colorAt(dataset?.borderColor, index) ?? MISSING_BAR_FALLBACK_COLOR;\n      ctx.lineWidth = 1;\n      ctx.setLineDash(STUB_DASH);\n      ctx.strokeRect(...rect);\n    });\n  });\n  if (saved) {\n    ctx.setLineDash?.([]);\n    ctx.restore();\n  }\n}\n\n/** Draws `text` centred in the chart area (a chart with nothing to plot). */\nexport function drawNoDataText(chart: any, text: string, fontFamily?: string): void {\n  const ctx = chart?.ctx;\n  const area = chart?.chartArea;\n  if (!ctx || !area || !text) return;\n  const cx = (area.left + (area.right ?? area.left + (area.width ?? 0))) / 2;\n  const cy = (area.top + (area.bottom ?? area.top + (area.height ?? 0))) / 2;\n  ctx.save();\n  ctx.font = `12px ${fontFamily || 'sans-serif'}`;\n  ctx.fillStyle = NO_DATA_TEXT_COLOR;\n  ctx.textAlign = 'center';\n  ctx.textBaseline = 'middle';\n  ctx.fillText(text, cx, cy);\n  ctx.restore();\n}\n\n/**\n * The per-chart plugin object. Passed as `config.plugins = [plugin]`: Chart.js\n * scopes it to that one chart. Both hooks swallow their own errors — a\n * decoration must never take the chart down.\n */\nexport function createMissingValuesPlugin(options: MissingValuesPluginOptions) {\n  return {\n    id: 'mcpuiMissingValues',\n    afterDatasetsDraw(chart: any) {\n      try {\n        drawMissingBarStubs(chart);\n        if (options.allMissing) {\n          drawNoDataText(chart, options.getNoDataText(), options.getFontFamily?.());\n        }\n      } catch {\n        // Cosmetic layer: never break the chart.\n      }\n    },\n  };\n}\n"],"names":["_a","_b"],"mappings":"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"}

package/dist/context/MCPUIConfigContext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"MCPUIConfigContext.cjs","sources":["../../src/context/MCPUIConfigContext.tsx"],"sourcesContent":["/**\n * MCPUIConfigContext — host-level rendering policy: the library's iframes\n * (v6.21.0) and, since v6.22.0, where a chart may capture the wheel.\n *\n * @since v6.21.0\n *\n * ## Why\n *\n * A host that serves `Cross-Origin-Embedder-Policy: credentialless` makes the\n * browser refuse every cross-origin iframe whose own document does not send a\n * COEP header — which is YouTube, Vimeo, Google Docs, Notion and nearly all of\n * `DEFAULT_IFRAME_DOMAINS`. The escape hatch is the boolean HTML attribute\n * `credentialless` on the `<iframe>` itself: the document then loads, but\n * without access to the cookies and storage of its own origin.\n *\n * That trade-off is free for a public video or chart and fatal for an\n * authenticated embed, so the library keys it on the distinction it already\n * makes: `TRUSTED_IFRAME_DOMAINS` (the hosts that receive `allow-same-origin`\n * because they need their own cookies) do NOT get the attribute; everything\n * else does. This context lets a host override that, add its own trusted\n * hosts, and control the \"open in a new tab\" fallback link.\n *\n * ## Scope — policy only, NOT strings\n *\n * Text lives in `MCPUIStrings` (`MCPUIStringsContext`). This context carries\n * only behavioural switches, and like the strings context every renderer works\n * standalone: with no provider mounted, `DEFAULT_MCPUI_CONFIG` applies.\n *\n * @example\n * ```tsx\n * import { MCPUIConfigProvider } from '@seed-ship/mcp-ui-solid'\n *\n * <MCPUIConfigProvider config={{ customTrustedIframeDomains: ['embed.acme.com'] }}>\n *   <App />\n * </MCPUIConfigProvider>\n * ```\n */\n\nimport { createContext, mergeProps, useContext, type JSX } from 'solid-js'\nimport type { IframePolicy } from '../types'\n\n/**\n * Host-level rendering policy. Every field has a default — a provider passes\n * a partial override.\n *\n * ## Why every field is optional\n *\n * This interface grows a key every time the library gains a policy switch,\n * and those releases are MINOR. Were the fields required, adding one would\n * break the build of any consumer holding a COMPLETE `MCPUIConfig` value —\n * a typed constant, a helper that returns one, or a direct\n * `<MCPUIConfigContext.Provider value={…}>` — because their object would\n * suddenly miss a key. Nothing about their behaviour changed; only `tsc`\n * would fail. Optional fields make each new key additive.\n *\n * The completeness guarantee moves from the type to the two values that\n * actually need it, exactly as `MCPUIStrings` does it:\n * `DEFAULT_MCPUI_CONFIG` is `Required<MCPUIConfig>`, so forgetting a default\n * is a compile error HERE, and {@link useMCPUIConfig} returns\n * `Required<MCPUIConfig>`, so every renderer still reads a fully resolved\n * value and never has to null-check a policy.\n */\nexport interface MCPUIConfig {\n  /**\n   * When the library puts the boolean `credentialless` attribute on an\n   * `<iframe>` it renders.\n   *\n   * - `'auto'` (default) — on every iframe whose host is NOT in\n   *   `TRUSTED_IFRAME_DOMAINS` (plus `customTrustedIframeDomains`). Those\n   *   hosts already ran without cookies, since their sandbox has no\n   *   `allow-same-origin`; the attribute is what unblocks them under COEP.\n   * - `'always'` — on every iframe, trusted hosts included. An authenticated\n   *   embed will then render its login screen.\n   * - `'never'` — never. The right value for a host that sends no COEP header\n   *   and does not want its embeds to lose their cookies.\n   *\n   * Chrome/Edge 110+ honour the attribute; Firefox ignores it (iframes stay\n   * blocked while the host sends COEP); Safari ignores the COEP value itself,\n   * so nothing is blocked there in the first place.\n   */\n  iframeCredentialless?: 'auto' | 'always' | 'never'\n\n  /**\n   * Extra hosts treated as trusted, on top of `TRUSTED_IFRAME_DOMAINS`:\n   * no `credentialless` attribute, and `allow-same-origin` in the sandbox.\n   * A subdomain of a listed host matches too.\n   *\n   * This only RECLASSIFIES a host the allow-list already accepts. To render an\n   * iframe whose host is outside `DEFAULT_IFRAME_DOMAINS`, add it to\n   * {@link MCPUIConfig.customIframeDomains} with `iframePolicy: 'extend'`.\n   */\n  customTrustedIframeDomains?: string[]\n\n  /**\n   * How `UIResourceRenderer` validates an `iframe` component's host:\n   * `'strict'` (default) accepts `DEFAULT_IFRAME_DOMAINS` only, `'extend'`\n   * also accepts {@link MCPUIConfig.customIframeDomains}.\n   */\n  iframePolicy?: IframePolicy\n\n  /**\n   * Extra hosts the allow-list accepts when `iframePolicy` is `'extend'`.\n   * Without this, a component pointing at an unlisted host is replaced by the\n   * validation card before any renderer runs.\n   */\n  customIframeDomains?: string[]\n\n  /**\n   * When the library renders an \"open in a new tab\" link under an embed\n   * (`strings.iframeOpenInNewTab`).\n   *\n   * A COEP-blocked iframe fires no event the parent page can observe, so\n   * without this the user sees an unexplained blank frame.\n   *\n   * - `'auto'` (default) — only when the page is cross-origin isolated\n   *   (`window.crossOriginIsolated`). That flag needs COOP `same-origin` AND\n   *   COEP, so a host that sends COEP alone still blocks embeds while the\n   *   flag is false: set `'always'` there. Read after mount, never during\n   *   render, so SSR markup and hydration agree.\n   * - `'always'` / `'never'` — unconditional.\n   */\n  iframeFallbackLink?: 'auto' | 'always' | 'never'\n\n  /**\n   * Where `ChartJSRenderer` enables wheel-zoom / drag-pan / pinch on a chart\n   * (through the optional `chartjs-plugin-zoom` peer dependency — absent, the\n   * chart renders exactly as it does without this setting).\n   *\n   * Hijacking the mouse wheel on a component sitting inline in a scrolling\n   * chat feed is hostile: the user scrolls the conversation and the chart eats\n   * the gesture. So zoom belongs to a surface that OWNS its viewport, which\n   * here is `ExpandableWrapper`'s fullscreen modal.\n   *\n   * - `'expanded'` (default) — only inside the fullscreen modal.\n   * - `'always'` — inline as well. For a host that lays charts out in a\n   *   dashboard rather than in a feed, where the wheel has nothing to steal.\n   * - `'never'` — off everywhere; the plugin is never registered.\n   *\n   * @since 6.22.0\n   */\n  chartZoom?: 'expanded' | 'always' | 'never'\n}\n\n/**\n * Defaults. Chosen so a host that sends no COEP header sees no change from\n * 6.20.0 apart from the fallback link, which `'auto'` keeps hidden there —\n * and, since 6.22.0, so no inline component ever captures the wheel\n * (`chartZoom: 'expanded'`).\n *\n * Typed `Required<MCPUIConfig>`: the interface's fields are optional so that\n * adding one stays backward compatible, and this annotation is what keeps a\n * new key from shipping without a default.\n */\nexport const DEFAULT_MCPUI_CONFIG: Required<MCPUIConfig> = {\n  iframeCredentialless: 'auto',\n  customTrustedIframeDomains: [],\n  iframePolicy: 'strict',\n  customIframeDomains: [],\n  iframeFallbackLink: 'auto',\n  chartZoom: 'expanded',\n}\n\n/**\n * Deliberately typed with the PARTIAL `MCPUIConfig`, not `Required<…>`: a\n * host that bypasses `MCPUIConfigProvider` and feeds this provider directly\n * may pass whichever keys it cares about, and `useMCPUIConfig` fills the\n * rest. Widening it this way only ever accepts more than before.\n */\nexport const MCPUIConfigContext = createContext<MCPUIConfig>(DEFAULT_MCPUI_CONFIG)\n\n/**\n * Reads the active host config, resolved: every key is present, whether it\n * came from the provider or from `DEFAULT_MCPUI_CONFIG`. Returns the defaults\n * outright when no `<MCPUIConfigProvider>` is mounted above.\n */\nexport function useMCPUIConfig(): Required<MCPUIConfig> {\n  return mergeProps(DEFAULT_MCPUI_CONFIG, useContext(MCPUIConfigContext))\n}\n\nexport interface MCPUIConfigProviderProps {\n  /**\n   * Partial override of the host config. Any key left unset falls back to\n   * `DEFAULT_MCPUI_CONFIG`.\n   */\n  config?: Partial<MCPUIConfig>\n  children: JSX.Element\n}\n\n/**\n * Provides the host config to every MCP-UI renderer below it.\n * Merges the partial `config` override over the defaults.\n */\nexport function MCPUIConfigProvider(props: MCPUIConfigProviderProps): JSX.Element {\n  // The function source keeps replacement `config` objects reactive while\n  // mergeProps fills any omitted key without taking a one-time snapshot.\n  const value = mergeProps(DEFAULT_MCPUI_CONFIG, () => props.config)\n  return (\n    <MCPUIConfigContext.Provider value={value}>\n      {props.children}\n    </MCPUIConfigContext.Provider>\n  )\n}\n"],"names":["DEFAULT_MCPUI_CONFIG","iframeCredentialless","customTrustedIframeDomains","iframePolicy","customIframeDomains","iframeFallbackLink","chartZoom","MCPUIConfigContext","createContext","useMCPUIConfig","mergeProps","useContext","MCPUIConfigProvider","props","value","config","_$createComponent","Provider","children"],"mappings":";;;;AAyJO,MAAMA,uBAA8C;AAAA,EACzDC,sBAAsB;AAAA,EACtBC,4BAA4B,CAAA;AAAA,EAC5BC,cAAc;AAAA,EACdC,qBAAqB,CAAA;AAAA,EACrBC,oBAAoB;AAAA,EACpBC,WAAW;AACb;AAQO,MAAMC,qBAAqBC,QAAAA,cAA2BR,oBAAoB;AAO1E,SAASS,iBAAwC;AACtD,SAAOC,mBAAWV,sBAAsBW,QAAAA,WAAWJ,kBAAkB,CAAC;AACxE;AAeO,SAASK,oBAAoBC,OAA8C;AAGhF,QAAMC,QAAQJ,QAAAA,WAAWV,sBAAsB,MAAMa,MAAME,MAAM;AACjE,SAAAC,IAAAA,gBACGT,mBAAmBU,UAAQ;AAAA,IAACH;AAAAA,IAAY,IAAAI,WAAA;AAAA,aACtCL,MAAMK;AAAAA,IAAQ;AAAA,EAAA,CAAA;AAGrB;;;;;"}
+{"version":3,"file":"MCPUIConfigContext.cjs","sources":["../../src/context/MCPUIConfigContext.tsx"],"sourcesContent":["/**\n * MCPUIConfigContext — host-level rendering policy: the library's iframes\n * (v6.21.0) and, since v6.22.0, where a chart may capture the wheel.\n *\n * @since v6.21.0\n *\n * ## Why\n *\n * A host that serves `Cross-Origin-Embedder-Policy: credentialless` makes the\n * browser refuse every cross-origin iframe whose own document does not send a\n * COEP header — which is YouTube, Vimeo, Google Docs, Notion and nearly all of\n * `DEFAULT_IFRAME_DOMAINS`. The escape hatch is the boolean HTML attribute\n * `credentialless` on the `<iframe>` itself: the document then loads, but\n * without access to the cookies and storage of its own origin.\n *\n * That trade-off is free for a public video or chart and fatal for an\n * authenticated embed, so the library keys it on the distinction it already\n * makes: `TRUSTED_IFRAME_DOMAINS` (the hosts that receive `allow-same-origin`\n * because they need their own cookies) do NOT get the attribute; everything\n * else does. This context lets a host override that, add its own trusted\n * hosts, and control the \"open in a new tab\" fallback link.\n *\n * ## Scope — policy only, NOT strings\n *\n * Text lives in `MCPUIStrings` (`MCPUIStringsContext`). This context carries\n * only behavioural switches, and like the strings context every renderer works\n * standalone: with no provider mounted, `DEFAULT_MCPUI_CONFIG` applies.\n *\n * @example\n * ```tsx\n * import { MCPUIConfigProvider } from '@seed-ship/mcp-ui-solid'\n *\n * <MCPUIConfigProvider config={{ customTrustedIframeDomains: ['embed.acme.com'] }}>\n *   <App />\n * </MCPUIConfigProvider>\n * ```\n */\n\nimport { createContext, mergeProps, useContext, type JSX } from 'solid-js'\nimport type { IframePolicy } from '../types'\n\n/**\n * Host-level rendering policy. Every field has a default — a provider passes\n * a partial override.\n *\n * ## Two names, because there are two jobs\n *\n * This type grows a key every time the library gains a policy switch, and\n * those releases are MINOR — so neither AUTHORING a config nor READING one\n * may break when a key appears. Those two demands pull in opposite\n * directions, and one name cannot serve both:\n *\n * - an author must be allowed to omit the new key, so the fields they write\n *   have to be OPTIONAL;\n * - a reader assigning `const p: IframePolicy = config.iframePolicy` must not\n *   suddenly face `undefined`, so the fields they read have to be REQUIRED.\n *\n * Hence {@link MCPUIConfigInput} (what a host writes — every field optional)\n * and {@link MCPUIConfig} (what the library hands back — every field\n * resolved). `MCPUIConfig` is derived from the input type, so the two can\n * never drift and a key is declared exactly once.\n *\n * Which one you name depends on the surface:\n *\n * - `<MCPUIConfigProvider config={…}>` takes `MCPUIConfigInput` — name that\n *   type for a partial you build, and it merges the rest;\n * - `<MCPUIConfigContext.Provider value={…}>` takes the RESOLVED\n *   `MCPUIConfig`, because that context is read as well as written, so a\n *   direct provider hands over `{ ...DEFAULT_MCPUI_CONFIG, ...mine }`;\n * - anything you RECEIVE is `MCPUIConfig`, which is what\n *   {@link useMCPUIConfig} returns.\n */\nexport interface MCPUIConfigInput {\n  /**\n   * When the library puts the boolean `credentialless` attribute on an\n   * `<iframe>` it renders.\n   *\n   * - `'auto'` (default) — on every iframe whose host is NOT in\n   *   `TRUSTED_IFRAME_DOMAINS` (plus `customTrustedIframeDomains`). Those\n   *   hosts already ran without cookies, since their sandbox has no\n   *   `allow-same-origin`; the attribute is what unblocks them under COEP.\n   * - `'always'` — on every iframe, trusted hosts included. An authenticated\n   *   embed will then render its login screen.\n   * - `'never'` — never. The right value for a host that sends no COEP header\n   *   and does not want its embeds to lose their cookies.\n   *\n   * Chrome/Edge 110+ honour the attribute; Firefox ignores it (iframes stay\n   * blocked while the host sends COEP); Safari ignores the COEP value itself,\n   * so nothing is blocked there in the first place.\n   */\n  iframeCredentialless?: 'auto' | 'always' | 'never'\n\n  /**\n   * Extra hosts treated as trusted, on top of `TRUSTED_IFRAME_DOMAINS`:\n   * no `credentialless` attribute, and `allow-same-origin` in the sandbox.\n   * A subdomain of a listed host matches too.\n   *\n   * This only RECLASSIFIES a host the allow-list already accepts. To render an\n   * iframe whose host is outside `DEFAULT_IFRAME_DOMAINS`, add it to\n   * {@link MCPUIConfigInput.customIframeDomains} with `iframePolicy: 'extend'`.\n   */\n  customTrustedIframeDomains?: string[]\n\n  /**\n   * How `UIResourceRenderer` validates an `iframe` component's host:\n   * `'strict'` (default) accepts `DEFAULT_IFRAME_DOMAINS` only, `'extend'`\n   * also accepts {@link MCPUIConfigInput.customIframeDomains}.\n   */\n  iframePolicy?: IframePolicy\n\n  /**\n   * Extra hosts the allow-list accepts when `iframePolicy` is `'extend'`.\n   * Without this, a component pointing at an unlisted host is replaced by the\n   * validation card before any renderer runs.\n   */\n  customIframeDomains?: string[]\n\n  /**\n   * When the library renders an \"open in a new tab\" link under an embed\n   * (`strings.iframeOpenInNewTab`).\n   *\n   * A COEP-blocked iframe fires no event the parent page can observe, so\n   * without this the user sees an unexplained blank frame.\n   *\n   * - `'auto'` (default) — only when the page is cross-origin isolated\n   *   (`window.crossOriginIsolated`). That flag needs COOP `same-origin` AND\n   *   COEP, so a host that sends COEP alone still blocks embeds while the\n   *   flag is false: set `'always'` there. Read after mount, never during\n   *   render, so SSR markup and hydration agree.\n   * - `'always'` / `'never'` — unconditional.\n   */\n  iframeFallbackLink?: 'auto' | 'always' | 'never'\n\n  /**\n   * Where `ChartJSRenderer` enables wheel-zoom / drag-pan / pinch on a chart\n   * (through the optional `chartjs-plugin-zoom` peer dependency — absent, the\n   * chart renders exactly as it does without this setting).\n   *\n   * Hijacking the mouse wheel on a component sitting inline in a scrolling\n   * chat feed is hostile: the user scrolls the conversation and the chart eats\n   * the gesture. So zoom belongs to a surface that OWNS its viewport, which\n   * here is `ExpandableWrapper`'s fullscreen modal.\n   *\n   * - `'expanded'` (default) — only inside the fullscreen modal.\n   * - `'always'` — inline as well. For a host that lays charts out in a\n   *   dashboard rather than in a feed, where the wheel has nothing to steal.\n   * - `'never'` — off everywhere; the plugin is never registered.\n   *\n   * @since 6.22.0\n   */\n  chartZoom?: 'expanded' | 'always' | 'never'\n}\n\n/**\n * The resolved host policy: every key present. This is what the library hands\n * back, so a reader never null-checks a policy.\n *\n * Extends `Required<`{@link MCPUIConfigInput}`>` rather than declaring the\n * fields again, so a key exists in exactly one place and the two views cannot\n * drift. It remains an interface so existing consumers can extend or augment\n * the public contract as they could before 6.22.0.\n */\nexport interface MCPUIConfig extends Required<MCPUIConfigInput> {}\n\n/**\n * Defaults. Chosen so a host that sends no COEP header sees no change from\n * 6.20.0 apart from the fallback link, which `'auto'` keeps hidden there —\n * and, since 6.22.0, so no inline component ever captures the wheel\n * (`chartZoom: 'expanded'`).\n *\n * Typed `MCPUIConfig` (i.e. resolved): that annotation is what stops a new\n * key from shipping without a default.\n */\nexport const DEFAULT_MCPUI_CONFIG: MCPUIConfig = {\n  iframeCredentialless: 'auto',\n  customTrustedIframeDomains: [],\n  iframePolicy: 'strict',\n  customIframeDomains: [],\n  iframeFallbackLink: 'auto',\n  chartZoom: 'expanded',\n}\n\n/**\n * Typed with the RESOLVED view, because this context is read as well as\n * written: it is exported, so a consumer may call\n * `useContext(MCPUIConfigContext)` directly, and typing it as the input view\n * would hand them `IframePolicy | undefined` — exactly the regression this\n * whole split exists to undo.\n *\n * The cost lands on the rarer side: a host feeding this context directly\n * passes a COMPLETE value, `{ ...DEFAULT_MCPUI_CONFIG, ...mine }`. Anyone who\n * wants to pass only the keys they care about uses `MCPUIConfigProvider`,\n * whose `config` prop takes `Partial<`{@link MCPUIConfig}`>` and does that\n * merge. That preserves optional properties added through declaration\n * merging; {@link MCPUIConfigInput} remains the unaugmented built-in input\n * shape a host can name for ordinary authored configs.\n */\nexport const MCPUIConfigContext = createContext<MCPUIConfig>(DEFAULT_MCPUI_CONFIG)\n\n/**\n * Reads the active host config, resolved: every key is present, whether it\n * came from the provider or from `DEFAULT_MCPUI_CONFIG`. Returns the defaults\n * outright when no `<MCPUIConfigProvider>` is mounted above.\n */\nexport function useMCPUIConfig(): MCPUIConfig {\n  return mergeProps(DEFAULT_MCPUI_CONFIG, useContext(MCPUIConfigContext))\n}\n\nexport interface MCPUIConfigProviderProps {\n  /**\n   * Partial override of the host config. Any key left unset falls back to\n   * `DEFAULT_MCPUI_CONFIG`.\n   */\n  config?: Partial<MCPUIConfig>\n  children: JSX.Element\n}\n\n/**\n * Provides the host config to every MCP-UI renderer below it.\n * Merges the partial `config` override over the defaults.\n */\nexport function MCPUIConfigProvider(props: MCPUIConfigProviderProps): JSX.Element {\n  // The function source keeps replacement `config` objects reactive while\n  // mergeProps fills any omitted key without taking a one-time snapshot.\n  const value = mergeProps(DEFAULT_MCPUI_CONFIG, () => props.config)\n  return (\n    <MCPUIConfigContext.Provider value={value}>\n      {props.children}\n    </MCPUIConfigContext.Provider>\n  )\n}\n"],"names":["DEFAULT_MCPUI_CONFIG","iframeCredentialless","customTrustedIframeDomains","iframePolicy","customIframeDomains","iframeFallbackLink","chartZoom","MCPUIConfigContext","createContext","useMCPUIConfig","mergeProps","useContext","MCPUIConfigProvider","props","value","config","_$createComponent","Provider","children"],"mappings":";;;;AA6KO,MAAMA,uBAAoC;AAAA,EAC/CC,sBAAsB;AAAA,EACtBC,4BAA4B,CAAA;AAAA,EAC5BC,cAAc;AAAA,EACdC,qBAAqB,CAAA;AAAA,EACrBC,oBAAoB;AAAA,EACpBC,WAAW;AACb;AAiBO,MAAMC,qBAAqBC,QAAAA,cAA2BR,oBAAoB;AAO1E,SAASS,iBAA8B;AAC5C,SAAOC,mBAAWV,sBAAsBW,QAAAA,WAAWJ,kBAAkB,CAAC;AACxE;AAeO,SAASK,oBAAoBC,OAA8C;AAGhF,QAAMC,QAAQJ,QAAAA,WAAWV,sBAAsB,MAAMa,MAAME,MAAM;AACjE,SAAAC,IAAAA,gBACGT,mBAAmBU,UAAQ;AAAA,IAACH;AAAAA,IAAY,IAAAI,WAAA;AAAA,aACtCL,MAAMK;AAAAA,IAAQ;AAAA,EAAA,CAAA;AAGrB;;;;;"}

package/dist/context/MCPUIConfigContext.d.ts

@@ -41,24 +41,34 @@ import type { IframePolicy } from '../types';
  * Host-level rendering policy. Every field has a default — a provider passes
  * a partial override.
  *
- * ## Why every field is optional
- *
- * This interface grows a key every time the library gains a policy switch,
- * and those releases are MINOR. Were the fields required, adding one would
- * break the build of any consumer holding a COMPLETE `MCPUIConfig` value —
- * a typed constant, a helper that returns one, or a direct
- * `<MCPUIConfigContext.Provider value={…}>` — because their object would
- * suddenly miss a key. Nothing about their behaviour changed; only `tsc`
- * would fail. Optional fields make each new key additive.
- *
- * The completeness guarantee moves from the type to the two values that
- * actually need it, exactly as `MCPUIStrings` does it:
- * `DEFAULT_MCPUI_CONFIG` is `Required<MCPUIConfig>`, so forgetting a default
- * is a compile error HERE, and {@link useMCPUIConfig} returns
- * `Required<MCPUIConfig>`, so every renderer still reads a fully resolved
- * value and never has to null-check a policy.
+ * ## Two names, because there are two jobs
+ *
+ * This type grows a key every time the library gains a policy switch, and
+ * those releases are MINOR — so neither AUTHORING a config nor READING one
+ * may break when a key appears. Those two demands pull in opposite
+ * directions, and one name cannot serve both:
+ *
+ * - an author must be allowed to omit the new key, so the fields they write
+ *   have to be OPTIONAL;
+ * - a reader assigning `const p: IframePolicy = config.iframePolicy` must not
+ *   suddenly face `undefined`, so the fields they read have to be REQUIRED.
+ *
+ * Hence {@link MCPUIConfigInput} (what a host writes — every field optional)
+ * and {@link MCPUIConfig} (what the library hands back — every field
+ * resolved). `MCPUIConfig` is derived from the input type, so the two can
+ * never drift and a key is declared exactly once.
+ *
+ * Which one you name depends on the surface:
+ *
+ * - `<MCPUIConfigProvider config={…}>` takes `MCPUIConfigInput` — name that
+ *   type for a partial you build, and it merges the rest;
+ * - `<MCPUIConfigContext.Provider value={…}>` takes the RESOLVED
+ *   `MCPUIConfig`, because that context is read as well as written, so a
+ *   direct provider hands over `{ ...DEFAULT_MCPUI_CONFIG, ...mine }`;
+ * - anything you RECEIVE is `MCPUIConfig`, which is what
+ *   {@link useMCPUIConfig} returns.
  */
-export interface MCPUIConfig {
+export interface MCPUIConfigInput {
     /**
      * When the library puts the boolean `credentialless` attribute on an
      * `<iframe>` it renders.
@@ -84,13 +94,13 @@ export interface MCPUIConfig {
      *
      * This only RECLASSIFIES a host the allow-list already accepts. To render an
      * iframe whose host is outside `DEFAULT_IFRAME_DOMAINS`, add it to
-     * {@link MCPUIConfig.customIframeDomains} with `iframePolicy: 'extend'`.
+     * {@link MCPUIConfigInput.customIframeDomains} with `iframePolicy: 'extend'`.
      */
     customTrustedIframeDomains?: string[];
     /**
      * How `UIResourceRenderer` validates an `iframe` component's host:
      * `'strict'` (default) accepts `DEFAULT_IFRAME_DOMAINS` only, `'extend'`
-     * also accepts {@link MCPUIConfig.customIframeDomains}.
+     * also accepts {@link MCPUIConfigInput.customIframeDomains}.
      */
     iframePolicy?: IframePolicy;
     /**
@@ -133,22 +143,41 @@ export interface MCPUIConfig {
      */
     chartZoom?: 'expanded' | 'always' | 'never';
 }
+/**
+ * The resolved host policy: every key present. This is what the library hands
+ * back, so a reader never null-checks a policy.
+ *
+ * Extends `Required<`{@link MCPUIConfigInput}`>` rather than declaring the
+ * fields again, so a key exists in exactly one place and the two views cannot
+ * drift. It remains an interface so existing consumers can extend or augment
+ * the public contract as they could before 6.22.0.
+ */
+export interface MCPUIConfig extends Required<MCPUIConfigInput> {
+}
 /**
  * Defaults. Chosen so a host that sends no COEP header sees no change from
  * 6.20.0 apart from the fallback link, which `'auto'` keeps hidden there —
  * and, since 6.22.0, so no inline component ever captures the wheel
  * (`chartZoom: 'expanded'`).
  *
- * Typed `Required<MCPUIConfig>`: the interface's fields are optional so that
- * adding one stays backward compatible, and this annotation is what keeps a
- * new key from shipping without a default.
+ * Typed `MCPUIConfig` (i.e. resolved): that annotation is what stops a new
+ * key from shipping without a default.
  */
-export declare const DEFAULT_MCPUI_CONFIG: Required<MCPUIConfig>;
+export declare const DEFAULT_MCPUI_CONFIG: MCPUIConfig;
 /**
- * Deliberately typed with the PARTIAL `MCPUIConfig`, not `Required<…>`: a
- * host that bypasses `MCPUIConfigProvider` and feeds this provider directly
- * may pass whichever keys it cares about, and `useMCPUIConfig` fills the
- * rest. Widening it this way only ever accepts more than before.
+ * Typed with the RESOLVED view, because this context is read as well as
+ * written: it is exported, so a consumer may call
+ * `useContext(MCPUIConfigContext)` directly, and typing it as the input view
+ * would hand them `IframePolicy | undefined` — exactly the regression this
+ * whole split exists to undo.
+ *
+ * The cost lands on the rarer side: a host feeding this context directly
+ * passes a COMPLETE value, `{ ...DEFAULT_MCPUI_CONFIG, ...mine }`. Anyone who
+ * wants to pass only the keys they care about uses `MCPUIConfigProvider`,
+ * whose `config` prop takes `Partial<`{@link MCPUIConfig}`>` and does that
+ * merge. That preserves optional properties added through declaration
+ * merging; {@link MCPUIConfigInput} remains the unaugmented built-in input
+ * shape a host can name for ordinary authored configs.
  */
 export declare const MCPUIConfigContext: import("solid-js").Context<MCPUIConfig>;
 /**
@@ -156,7 +185,7 @@ export declare const MCPUIConfigContext: import("solid-js").Context<MCPUIConfig>
  * came from the provider or from `DEFAULT_MCPUI_CONFIG`. Returns the defaults
  * outright when no `<MCPUIConfigProvider>` is mounted above.
  */
-export declare function useMCPUIConfig(): Required<MCPUIConfig>;
+export declare function useMCPUIConfig(): MCPUIConfig;
 export interface MCPUIConfigProviderProps {
     /**
      * Partial override of the host config. Any key left unset falls back to

package/dist/context/MCPUIConfigContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MCPUIConfigContext.d.ts","sourceRoot":"","sources":["../../src/context/MCPUIConfigContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAyC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;OAgBG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAElD;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IAErC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAE3B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE9B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAEhD;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAA;CAC5C;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAOtD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,yCAAmD,CAAA;AAElF;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAAC,WAAW,CAAC,CAEtD;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,GAAG,CAAC,OAAO,CAShF"}
+{"version":3,"file":"MCPUIConfigContext.d.ts","sourceRoot":"","sources":["../../src/context/MCPUIConfigContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAyC,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAElD;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAA;IAErC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAE3B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE9B;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IAEhD;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAA;CAC5C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;CAAG;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAOlC,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,yCAAmD,CAAA;AAElF;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAED,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,GAAG,CAAC,OAAO,CAShF"}

package/dist/context/MCPUIConfigContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"MCPUIConfigContext.js","sources":["../../src/context/MCPUIConfigContext.tsx"],"sourcesContent":["/**\n * MCPUIConfigContext — host-level rendering policy: the library's iframes\n * (v6.21.0) and, since v6.22.0, where a chart may capture the wheel.\n *\n * @since v6.21.0\n *\n * ## Why\n *\n * A host that serves `Cross-Origin-Embedder-Policy: credentialless` makes the\n * browser refuse every cross-origin iframe whose own document does not send a\n * COEP header — which is YouTube, Vimeo, Google Docs, Notion and nearly all of\n * `DEFAULT_IFRAME_DOMAINS`. The escape hatch is the boolean HTML attribute\n * `credentialless` on the `<iframe>` itself: the document then loads, but\n * without access to the cookies and storage of its own origin.\n *\n * That trade-off is free for a public video or chart and fatal for an\n * authenticated embed, so the library keys it on the distinction it already\n * makes: `TRUSTED_IFRAME_DOMAINS` (the hosts that receive `allow-same-origin`\n * because they need their own cookies) do NOT get the attribute; everything\n * else does. This context lets a host override that, add its own trusted\n * hosts, and control the \"open in a new tab\" fallback link.\n *\n * ## Scope — policy only, NOT strings\n *\n * Text lives in `MCPUIStrings` (`MCPUIStringsContext`). This context carries\n * only behavioural switches, and like the strings context every renderer works\n * standalone: with no provider mounted, `DEFAULT_MCPUI_CONFIG` applies.\n *\n * @example\n * ```tsx\n * import { MCPUIConfigProvider } from '@seed-ship/mcp-ui-solid'\n *\n * <MCPUIConfigProvider config={{ customTrustedIframeDomains: ['embed.acme.com'] }}>\n *   <App />\n * </MCPUIConfigProvider>\n * ```\n */\n\nimport { createContext, mergeProps, useContext, type JSX } from 'solid-js'\nimport type { IframePolicy } from '../types'\n\n/**\n * Host-level rendering policy. Every field has a default — a provider passes\n * a partial override.\n *\n * ## Why every field is optional\n *\n * This interface grows a key every time the library gains a policy switch,\n * and those releases are MINOR. Were the fields required, adding one would\n * break the build of any consumer holding a COMPLETE `MCPUIConfig` value —\n * a typed constant, a helper that returns one, or a direct\n * `<MCPUIConfigContext.Provider value={…}>` — because their object would\n * suddenly miss a key. Nothing about their behaviour changed; only `tsc`\n * would fail. Optional fields make each new key additive.\n *\n * The completeness guarantee moves from the type to the two values that\n * actually need it, exactly as `MCPUIStrings` does it:\n * `DEFAULT_MCPUI_CONFIG` is `Required<MCPUIConfig>`, so forgetting a default\n * is a compile error HERE, and {@link useMCPUIConfig} returns\n * `Required<MCPUIConfig>`, so every renderer still reads a fully resolved\n * value and never has to null-check a policy.\n */\nexport interface MCPUIConfig {\n  /**\n   * When the library puts the boolean `credentialless` attribute on an\n   * `<iframe>` it renders.\n   *\n   * - `'auto'` (default) — on every iframe whose host is NOT in\n   *   `TRUSTED_IFRAME_DOMAINS` (plus `customTrustedIframeDomains`). Those\n   *   hosts already ran without cookies, since their sandbox has no\n   *   `allow-same-origin`; the attribute is what unblocks them under COEP.\n   * - `'always'` — on every iframe, trusted hosts included. An authenticated\n   *   embed will then render its login screen.\n   * - `'never'` — never. The right value for a host that sends no COEP header\n   *   and does not want its embeds to lose their cookies.\n   *\n   * Chrome/Edge 110+ honour the attribute; Firefox ignores it (iframes stay\n   * blocked while the host sends COEP); Safari ignores the COEP value itself,\n   * so nothing is blocked there in the first place.\n   */\n  iframeCredentialless?: 'auto' | 'always' | 'never'\n\n  /**\n   * Extra hosts treated as trusted, on top of `TRUSTED_IFRAME_DOMAINS`:\n   * no `credentialless` attribute, and `allow-same-origin` in the sandbox.\n   * A subdomain of a listed host matches too.\n   *\n   * This only RECLASSIFIES a host the allow-list already accepts. To render an\n   * iframe whose host is outside `DEFAULT_IFRAME_DOMAINS`, add it to\n   * {@link MCPUIConfig.customIframeDomains} with `iframePolicy: 'extend'`.\n   */\n  customTrustedIframeDomains?: string[]\n\n  /**\n   * How `UIResourceRenderer` validates an `iframe` component's host:\n   * `'strict'` (default) accepts `DEFAULT_IFRAME_DOMAINS` only, `'extend'`\n   * also accepts {@link MCPUIConfig.customIframeDomains}.\n   */\n  iframePolicy?: IframePolicy\n\n  /**\n   * Extra hosts the allow-list accepts when `iframePolicy` is `'extend'`.\n   * Without this, a component pointing at an unlisted host is replaced by the\n   * validation card before any renderer runs.\n   */\n  customIframeDomains?: string[]\n\n  /**\n   * When the library renders an \"open in a new tab\" link under an embed\n   * (`strings.iframeOpenInNewTab`).\n   *\n   * A COEP-blocked iframe fires no event the parent page can observe, so\n   * without this the user sees an unexplained blank frame.\n   *\n   * - `'auto'` (default) — only when the page is cross-origin isolated\n   *   (`window.crossOriginIsolated`). That flag needs COOP `same-origin` AND\n   *   COEP, so a host that sends COEP alone still blocks embeds while the\n   *   flag is false: set `'always'` there. Read after mount, never during\n   *   render, so SSR markup and hydration agree.\n   * - `'always'` / `'never'` — unconditional.\n   */\n  iframeFallbackLink?: 'auto' | 'always' | 'never'\n\n  /**\n   * Where `ChartJSRenderer` enables wheel-zoom / drag-pan / pinch on a chart\n   * (through the optional `chartjs-plugin-zoom` peer dependency — absent, the\n   * chart renders exactly as it does without this setting).\n   *\n   * Hijacking the mouse wheel on a component sitting inline in a scrolling\n   * chat feed is hostile: the user scrolls the conversation and the chart eats\n   * the gesture. So zoom belongs to a surface that OWNS its viewport, which\n   * here is `ExpandableWrapper`'s fullscreen modal.\n   *\n   * - `'expanded'` (default) — only inside the fullscreen modal.\n   * - `'always'` — inline as well. For a host that lays charts out in a\n   *   dashboard rather than in a feed, where the wheel has nothing to steal.\n   * - `'never'` — off everywhere; the plugin is never registered.\n   *\n   * @since 6.22.0\n   */\n  chartZoom?: 'expanded' | 'always' | 'never'\n}\n\n/**\n * Defaults. Chosen so a host that sends no COEP header sees no change from\n * 6.20.0 apart from the fallback link, which `'auto'` keeps hidden there —\n * and, since 6.22.0, so no inline component ever captures the wheel\n * (`chartZoom: 'expanded'`).\n *\n * Typed `Required<MCPUIConfig>`: the interface's fields are optional so that\n * adding one stays backward compatible, and this annotation is what keeps a\n * new key from shipping without a default.\n */\nexport const DEFAULT_MCPUI_CONFIG: Required<MCPUIConfig> = {\n  iframeCredentialless: 'auto',\n  customTrustedIframeDomains: [],\n  iframePolicy: 'strict',\n  customIframeDomains: [],\n  iframeFallbackLink: 'auto',\n  chartZoom: 'expanded',\n}\n\n/**\n * Deliberately typed with the PARTIAL `MCPUIConfig`, not `Required<…>`: a\n * host that bypasses `MCPUIConfigProvider` and feeds this provider directly\n * may pass whichever keys it cares about, and `useMCPUIConfig` fills the\n * rest. Widening it this way only ever accepts more than before.\n */\nexport const MCPUIConfigContext = createContext<MCPUIConfig>(DEFAULT_MCPUI_CONFIG)\n\n/**\n * Reads the active host config, resolved: every key is present, whether it\n * came from the provider or from `DEFAULT_MCPUI_CONFIG`. Returns the defaults\n * outright when no `<MCPUIConfigProvider>` is mounted above.\n */\nexport function useMCPUIConfig(): Required<MCPUIConfig> {\n  return mergeProps(DEFAULT_MCPUI_CONFIG, useContext(MCPUIConfigContext))\n}\n\nexport interface MCPUIConfigProviderProps {\n  /**\n   * Partial override of the host config. Any key left unset falls back to\n   * `DEFAULT_MCPUI_CONFIG`.\n   */\n  config?: Partial<MCPUIConfig>\n  children: JSX.Element\n}\n\n/**\n * Provides the host config to every MCP-UI renderer below it.\n * Merges the partial `config` override over the defaults.\n */\nexport function MCPUIConfigProvider(props: MCPUIConfigProviderProps): JSX.Element {\n  // The function source keeps replacement `config` objects reactive while\n  // mergeProps fills any omitted key without taking a one-time snapshot.\n  const value = mergeProps(DEFAULT_MCPUI_CONFIG, () => props.config)\n  return (\n    <MCPUIConfigContext.Provider value={value}>\n      {props.children}\n    </MCPUIConfigContext.Provider>\n  )\n}\n"],"names":["DEFAULT_MCPUI_CONFIG","iframeCredentialless","customTrustedIframeDomains","iframePolicy","customIframeDomains","iframeFallbackLink","chartZoom","MCPUIConfigContext","createContext","useMCPUIConfig","mergeProps","useContext","MCPUIConfigProvider","props","value","config","_$createComponent","Provider","children"],"mappings":";;AAyJO,MAAMA,uBAA8C;AAAA,EACzDC,sBAAsB;AAAA,EACtBC,4BAA4B,CAAA;AAAA,EAC5BC,cAAc;AAAA,EACdC,qBAAqB,CAAA;AAAA,EACrBC,oBAAoB;AAAA,EACpBC,WAAW;AACb;AAQO,MAAMC,qBAAqBC,cAA2BR,oBAAoB;AAO1E,SAASS,iBAAwC;AACtD,SAAOC,WAAWV,sBAAsBW,WAAWJ,kBAAkB,CAAC;AACxE;AAeO,SAASK,oBAAoBC,OAA8C;AAGhF,QAAMC,QAAQJ,WAAWV,sBAAsB,MAAMa,MAAME,MAAM;AACjE,SAAAC,gBACGT,mBAAmBU,UAAQ;AAAA,IAACH;AAAAA,IAAY,IAAAI,WAAA;AAAA,aACtCL,MAAMK;AAAAA,IAAQ;AAAA,EAAA,CAAA;AAGrB;"}
+{"version":3,"file":"MCPUIConfigContext.js","sources":["../../src/context/MCPUIConfigContext.tsx"],"sourcesContent":["/**\n * MCPUIConfigContext — host-level rendering policy: the library's iframes\n * (v6.21.0) and, since v6.22.0, where a chart may capture the wheel.\n *\n * @since v6.21.0\n *\n * ## Why\n *\n * A host that serves `Cross-Origin-Embedder-Policy: credentialless` makes the\n * browser refuse every cross-origin iframe whose own document does not send a\n * COEP header — which is YouTube, Vimeo, Google Docs, Notion and nearly all of\n * `DEFAULT_IFRAME_DOMAINS`. The escape hatch is the boolean HTML attribute\n * `credentialless` on the `<iframe>` itself: the document then loads, but\n * without access to the cookies and storage of its own origin.\n *\n * That trade-off is free for a public video or chart and fatal for an\n * authenticated embed, so the library keys it on the distinction it already\n * makes: `TRUSTED_IFRAME_DOMAINS` (the hosts that receive `allow-same-origin`\n * because they need their own cookies) do NOT get the attribute; everything\n * else does. This context lets a host override that, add its own trusted\n * hosts, and control the \"open in a new tab\" fallback link.\n *\n * ## Scope — policy only, NOT strings\n *\n * Text lives in `MCPUIStrings` (`MCPUIStringsContext`). This context carries\n * only behavioural switches, and like the strings context every renderer works\n * standalone: with no provider mounted, `DEFAULT_MCPUI_CONFIG` applies.\n *\n * @example\n * ```tsx\n * import { MCPUIConfigProvider } from '@seed-ship/mcp-ui-solid'\n *\n * <MCPUIConfigProvider config={{ customTrustedIframeDomains: ['embed.acme.com'] }}>\n *   <App />\n * </MCPUIConfigProvider>\n * ```\n */\n\nimport { createContext, mergeProps, useContext, type JSX } from 'solid-js'\nimport type { IframePolicy } from '../types'\n\n/**\n * Host-level rendering policy. Every field has a default — a provider passes\n * a partial override.\n *\n * ## Two names, because there are two jobs\n *\n * This type grows a key every time the library gains a policy switch, and\n * those releases are MINOR — so neither AUTHORING a config nor READING one\n * may break when a key appears. Those two demands pull in opposite\n * directions, and one name cannot serve both:\n *\n * - an author must be allowed to omit the new key, so the fields they write\n *   have to be OPTIONAL;\n * - a reader assigning `const p: IframePolicy = config.iframePolicy` must not\n *   suddenly face `undefined`, so the fields they read have to be REQUIRED.\n *\n * Hence {@link MCPUIConfigInput} (what a host writes — every field optional)\n * and {@link MCPUIConfig} (what the library hands back — every field\n * resolved). `MCPUIConfig` is derived from the input type, so the two can\n * never drift and a key is declared exactly once.\n *\n * Which one you name depends on the surface:\n *\n * - `<MCPUIConfigProvider config={…}>` takes `MCPUIConfigInput` — name that\n *   type for a partial you build, and it merges the rest;\n * - `<MCPUIConfigContext.Provider value={…}>` takes the RESOLVED\n *   `MCPUIConfig`, because that context is read as well as written, so a\n *   direct provider hands over `{ ...DEFAULT_MCPUI_CONFIG, ...mine }`;\n * - anything you RECEIVE is `MCPUIConfig`, which is what\n *   {@link useMCPUIConfig} returns.\n */\nexport interface MCPUIConfigInput {\n  /**\n   * When the library puts the boolean `credentialless` attribute on an\n   * `<iframe>` it renders.\n   *\n   * - `'auto'` (default) — on every iframe whose host is NOT in\n   *   `TRUSTED_IFRAME_DOMAINS` (plus `customTrustedIframeDomains`). Those\n   *   hosts already ran without cookies, since their sandbox has no\n   *   `allow-same-origin`; the attribute is what unblocks them under COEP.\n   * - `'always'` — on every iframe, trusted hosts included. An authenticated\n   *   embed will then render its login screen.\n   * - `'never'` — never. The right value for a host that sends no COEP header\n   *   and does not want its embeds to lose their cookies.\n   *\n   * Chrome/Edge 110+ honour the attribute; Firefox ignores it (iframes stay\n   * blocked while the host sends COEP); Safari ignores the COEP value itself,\n   * so nothing is blocked there in the first place.\n   */\n  iframeCredentialless?: 'auto' | 'always' | 'never'\n\n  /**\n   * Extra hosts treated as trusted, on top of `TRUSTED_IFRAME_DOMAINS`:\n   * no `credentialless` attribute, and `allow-same-origin` in the sandbox.\n   * A subdomain of a listed host matches too.\n   *\n   * This only RECLASSIFIES a host the allow-list already accepts. To render an\n   * iframe whose host is outside `DEFAULT_IFRAME_DOMAINS`, add it to\n   * {@link MCPUIConfigInput.customIframeDomains} with `iframePolicy: 'extend'`.\n   */\n  customTrustedIframeDomains?: string[]\n\n  /**\n   * How `UIResourceRenderer` validates an `iframe` component's host:\n   * `'strict'` (default) accepts `DEFAULT_IFRAME_DOMAINS` only, `'extend'`\n   * also accepts {@link MCPUIConfigInput.customIframeDomains}.\n   */\n  iframePolicy?: IframePolicy\n\n  /**\n   * Extra hosts the allow-list accepts when `iframePolicy` is `'extend'`.\n   * Without this, a component pointing at an unlisted host is replaced by the\n   * validation card before any renderer runs.\n   */\n  customIframeDomains?: string[]\n\n  /**\n   * When the library renders an \"open in a new tab\" link under an embed\n   * (`strings.iframeOpenInNewTab`).\n   *\n   * A COEP-blocked iframe fires no event the parent page can observe, so\n   * without this the user sees an unexplained blank frame.\n   *\n   * - `'auto'` (default) — only when the page is cross-origin isolated\n   *   (`window.crossOriginIsolated`). That flag needs COOP `same-origin` AND\n   *   COEP, so a host that sends COEP alone still blocks embeds while the\n   *   flag is false: set `'always'` there. Read after mount, never during\n   *   render, so SSR markup and hydration agree.\n   * - `'always'` / `'never'` — unconditional.\n   */\n  iframeFallbackLink?: 'auto' | 'always' | 'never'\n\n  /**\n   * Where `ChartJSRenderer` enables wheel-zoom / drag-pan / pinch on a chart\n   * (through the optional `chartjs-plugin-zoom` peer dependency — absent, the\n   * chart renders exactly as it does without this setting).\n   *\n   * Hijacking the mouse wheel on a component sitting inline in a scrolling\n   * chat feed is hostile: the user scrolls the conversation and the chart eats\n   * the gesture. So zoom belongs to a surface that OWNS its viewport, which\n   * here is `ExpandableWrapper`'s fullscreen modal.\n   *\n   * - `'expanded'` (default) — only inside the fullscreen modal.\n   * - `'always'` — inline as well. For a host that lays charts out in a\n   *   dashboard rather than in a feed, where the wheel has nothing to steal.\n   * - `'never'` — off everywhere; the plugin is never registered.\n   *\n   * @since 6.22.0\n   */\n  chartZoom?: 'expanded' | 'always' | 'never'\n}\n\n/**\n * The resolved host policy: every key present. This is what the library hands\n * back, so a reader never null-checks a policy.\n *\n * Extends `Required<`{@link MCPUIConfigInput}`>` rather than declaring the\n * fields again, so a key exists in exactly one place and the two views cannot\n * drift. It remains an interface so existing consumers can extend or augment\n * the public contract as they could before 6.22.0.\n */\nexport interface MCPUIConfig extends Required<MCPUIConfigInput> {}\n\n/**\n * Defaults. Chosen so a host that sends no COEP header sees no change from\n * 6.20.0 apart from the fallback link, which `'auto'` keeps hidden there —\n * and, since 6.22.0, so no inline component ever captures the wheel\n * (`chartZoom: 'expanded'`).\n *\n * Typed `MCPUIConfig` (i.e. resolved): that annotation is what stops a new\n * key from shipping without a default.\n */\nexport const DEFAULT_MCPUI_CONFIG: MCPUIConfig = {\n  iframeCredentialless: 'auto',\n  customTrustedIframeDomains: [],\n  iframePolicy: 'strict',\n  customIframeDomains: [],\n  iframeFallbackLink: 'auto',\n  chartZoom: 'expanded',\n}\n\n/**\n * Typed with the RESOLVED view, because this context is read as well as\n * written: it is exported, so a consumer may call\n * `useContext(MCPUIConfigContext)` directly, and typing it as the input view\n * would hand them `IframePolicy | undefined` — exactly the regression this\n * whole split exists to undo.\n *\n * The cost lands on the rarer side: a host feeding this context directly\n * passes a COMPLETE value, `{ ...DEFAULT_MCPUI_CONFIG, ...mine }`. Anyone who\n * wants to pass only the keys they care about uses `MCPUIConfigProvider`,\n * whose `config` prop takes `Partial<`{@link MCPUIConfig}`>` and does that\n * merge. That preserves optional properties added through declaration\n * merging; {@link MCPUIConfigInput} remains the unaugmented built-in input\n * shape a host can name for ordinary authored configs.\n */\nexport const MCPUIConfigContext = createContext<MCPUIConfig>(DEFAULT_MCPUI_CONFIG)\n\n/**\n * Reads the active host config, resolved: every key is present, whether it\n * came from the provider or from `DEFAULT_MCPUI_CONFIG`. Returns the defaults\n * outright when no `<MCPUIConfigProvider>` is mounted above.\n */\nexport function useMCPUIConfig(): MCPUIConfig {\n  return mergeProps(DEFAULT_MCPUI_CONFIG, useContext(MCPUIConfigContext))\n}\n\nexport interface MCPUIConfigProviderProps {\n  /**\n   * Partial override of the host config. Any key left unset falls back to\n   * `DEFAULT_MCPUI_CONFIG`.\n   */\n  config?: Partial<MCPUIConfig>\n  children: JSX.Element\n}\n\n/**\n * Provides the host config to every MCP-UI renderer below it.\n * Merges the partial `config` override over the defaults.\n */\nexport function MCPUIConfigProvider(props: MCPUIConfigProviderProps): JSX.Element {\n  // The function source keeps replacement `config` objects reactive while\n  // mergeProps fills any omitted key without taking a one-time snapshot.\n  const value = mergeProps(DEFAULT_MCPUI_CONFIG, () => props.config)\n  return (\n    <MCPUIConfigContext.Provider value={value}>\n      {props.children}\n    </MCPUIConfigContext.Provider>\n  )\n}\n"],"names":["DEFAULT_MCPUI_CONFIG","iframeCredentialless","customTrustedIframeDomains","iframePolicy","customIframeDomains","iframeFallbackLink","chartZoom","MCPUIConfigContext","createContext","useMCPUIConfig","mergeProps","useContext","MCPUIConfigProvider","props","value","config","_$createComponent","Provider","children"],"mappings":";;AA6KO,MAAMA,uBAAoC;AAAA,EAC/CC,sBAAsB;AAAA,EACtBC,4BAA4B,CAAA;AAAA,EAC5BC,cAAc;AAAA,EACdC,qBAAqB,CAAA;AAAA,EACrBC,oBAAoB;AAAA,EACpBC,WAAW;AACb;AAiBO,MAAMC,qBAAqBC,cAA2BR,oBAAoB;AAO1E,SAASS,iBAA8B;AAC5C,SAAOC,WAAWV,sBAAsBW,WAAWJ,kBAAkB,CAAC;AACxE;AAeO,SAASK,oBAAoBC,OAA8C;AAGhF,QAAMC,QAAQJ,WAAWV,sBAAsB,MAAMa,MAAME,MAAM;AACjE,SAAAC,gBACGT,mBAAmBU,UAAQ;AAAA,IAACH;AAAAA,IAAY,IAAAI,WAAA;AAAA,aACtCL,MAAMK;AAAAA,IAAQ;AAAA,EAAA,CAAA;AAGrB;"}