@pixerate/editor 0.50.0 → 0.52.0

package/dist/chart/index.js

@@ -14,8 +14,9 @@ import {
   CHART_OOXML_RELATIONSHIP,
   chartFormatToCode,
   chartFromOoxml,
-  chartToOoxml
-} from "../chunk-GJBIVWB2.js";
+  chartToOoxml,
+  readZip
+} from "../chunk-UAW5FEMD.js";
 import {
   CHART_COLOR_SCHEMES,
   CHART_DATE_STEPS,
@@ -128,6 +129,127 @@ import {
 } from "../chunk-664LQYFJ.js";
 import "../chunk-QVZZGT4X.js";
 
+// src/chart/raster.ts
+var CHART_RASTER_MAX_SIZE = 1024;
+function chartRasterSize(width, height, scale = 2, maxSize = CHART_RASTER_MAX_SIZE) {
+  if (!(width > 0) || !(height > 0)) throw new Error(`A chart image needs a positive width and height; got ${width} \xD7 ${height}.`);
+  const factor = Math.min(scale > 0 ? scale : 1, maxSize / Math.max(width, height));
+  return { width: Math.max(1, Math.round(width * factor)), height: Math.max(1, Math.round(height * factor)), scale: factor };
+}
+function closingParen(text, open2) {
+  let depth = 0;
+  for (let i = open2; i < text.length; i++) {
+    if (text[i] === "(") depth++;
+    else if (text[i] === ")" && --depth === 0) return i + 1;
+  }
+  return -1;
+}
+function substituteVars(value, lookup, depth = 0) {
+  let out = "";
+  let i = 0;
+  for (let at = value.indexOf("var(", i); at !== -1; at = value.indexOf("var(", i)) {
+    const end = closingParen(value, at + 3);
+    if (end === -1) break;
+    const inner = value.slice(at + 4, end - 1);
+    let comma = -1;
+    for (let j = 0, d = 0; j < inner.length; j++) {
+      if (inner[j] === "(") d++;
+      else if (inner[j] === ")") d--;
+      else if (inner[j] === "," && d === 0) {
+        comma = j;
+        break;
+      }
+    }
+    const name = (comma === -1 ? inner : inner.slice(0, comma)).trim();
+    const fallback = comma === -1 ? "" : inner.slice(comma + 1).trim();
+    const found = lookup(name).trim();
+    const resolved = found || fallback;
+    out += value.slice(i, at) + (depth < 8 && resolved.includes("var(") ? substituteVars(resolved, lookup, depth + 1) : resolved);
+    i = end;
+  }
+  return out + value.slice(i);
+}
+var PAINT_ATTRIBUTE = /(\s)([\w:-]+)="([^"]*)"/g;
+function resolveChartSvgPaints(svg, options = {}) {
+  const doc = globalThis.document;
+  const scope = options.scope ?? doc?.documentElement ?? null;
+  const view = scope?.ownerDocument?.defaultView ?? globalThis;
+  let computed;
+  const style = () => {
+    if (computed === void 0) computed = scope && typeof view?.getComputedStyle === "function" ? view.getComputedStyle(scope) : null;
+    return computed;
+  };
+  const lookup = options.lookup ?? ((name) => style()?.getPropertyValue(name) ?? "");
+  return svg.replace(PAINT_ATTRIBUTE, (match, space, name, raw) => {
+    let value = raw;
+    if (value.includes("var(")) value = substituteVars(value.replace(/&quot;/g, '"'), lookup).replace(/"/g, "&quot;");
+    if (/currentcolor/i.test(value)) value = value.replace(/currentcolor/gi, style()?.color || "#000000");
+    if (name === "font-family" && /^(inherit|unset|initial)$/i.test(value.trim())) value = (style()?.fontFamily || "sans-serif").replace(/"/g, "'");
+    if (value === raw) return match;
+    return value.trim() ? `${space}${name}="${value}"` : "";
+  });
+}
+var NO_DOM = 'Rasterizing a chart needs a browser DOM (document, Image and a 2D canvas). Outside a browser, render SVG with chartToSvg (or render_chart with format "svg") and convert it with an SVG renderer, or pass your own rasterize option to createChartToolProvider.';
+async function svgToPngDataUrl(svg, options) {
+  const doc = options.document ?? globalThis.document;
+  const ImageCtor = doc?.defaultView?.Image ?? globalThis.Image;
+  if (!doc || typeof doc.createElement !== "function" || !ImageCtor) throw new Error(NO_DOM);
+  const size = chartRasterSize(options.width, options.height, options.scale, options.maxSize);
+  const canvas = doc.createElement("canvas");
+  canvas.width = size.width;
+  canvas.height = size.height;
+  let context = null;
+  try {
+    context = canvas.getContext("2d");
+  } catch {
+    context = null;
+  }
+  if (!context) throw new Error(NO_DOM);
+  const drawable = resolveChartSvgPaints(svg, options);
+  const image = new ImageCtor();
+  await new Promise((resolve2, reject) => {
+    image.onload = () => resolve2();
+    image.onerror = () => reject(new Error("The chart SVG could not be loaded as an image; check that it is a complete <svg> document with the SVG namespace."));
+    image.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(drawable)}`;
+  });
+  const background = options.background ?? "#ffffff";
+  if (background !== "transparent") {
+    context.fillStyle = background;
+    context.fillRect(0, 0, size.width, size.height);
+  }
+  context.drawImage(image, 0, 0, size.width, size.height);
+  const url = canvas.toDataURL("image/png");
+  if (!url.startsWith("data:image/png")) throw new Error("This canvas cannot export PNG (toDataURL returned no image).");
+  return { url, width: size.width, height: size.height };
+}
+async function rasterizeChartSvg(svg, options) {
+  const { url, width, height } = await svgToPngDataUrl(svg, options);
+  return { data: url.slice(url.indexOf(",") + 1), mimeType: "image/png", width, height };
+}
+function createChartRasterizer(options = {}) {
+  const doc = options.document ?? globalThis.document;
+  if (!doc || typeof doc.createElement !== "function") return void 0;
+  return (svg, size) => rasterizeChartSvg(svg, { ...options, ...size });
+}
+function chartFileName(spec, extension) {
+  const base = (spec.title ?? "").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "").slice(0, 60);
+  return `${base || "chart"}.${extension}`;
+}
+async function downloadChartPng(spec, options = {}) {
+  const { width = 800, height = 450, filename = chartFileName(spec, "png"), theme, ...raster } = options;
+  const svg = chartToSvg(spec, { width, height, theme });
+  const { url, width: w, height: h } = await svgToPngDataUrl(svg, { ...raster, width, height });
+  const doc = raster.document ?? globalThis.document;
+  const link = doc.createElement("a");
+  link.href = url;
+  link.download = filename;
+  link.style.display = "none";
+  doc.body?.appendChild(link);
+  link.click();
+  link.remove();
+  return { data: url.slice(url.indexOf(",") + 1), mimeType: "image/png", width: w, height: h, filename };
+}
+
 // src/chart/recommend.ts
 var blank = (c) => c === null || c === void 0 || String(c).trim() === "";
 var isText = (c) => blank(c) || parseChartValue(c) === void 0;
@@ -763,6 +885,7 @@ function chartHitTest(scene, point, measure = (t, s, w = 400) => t.length * s *
 }
 
 // src/chart/tools.ts
+var RENDER_CHART_INSTRUCTIONS = 'Draws the chart without changing it so you can check how it looks: SVG text by default, or a PNG image with format "png" when the host can rasterize. Returns the layout warnings (hidden or thinned labels, dropped markers) alongside. An image costs tokens, so render after a batch of edits rather than after each one, and use it to check what text cannot tell you: overlapping or cut-off labels, a crowded legend, unreadable colours, whether the chart reads at the given size. For values, ids and warnings alone, get_chart is cheaper.';
 var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
 var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
 var WRITE_IDEMPOTENT = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
@@ -817,21 +940,36 @@ function createChartToolProvider(controller, options = {}) {
   const renderChart = {
     name: "render_chart",
     title: "Render the chart",
-    description: 'Draws the chart without changing it, to check it visually: SVG text by default, or a PNG image (format "png") when the host can rasterize. Look for overlapping or hidden labels; get_chart lists layout warnings without a render.',
+    description: RENDER_CHART_INSTRUCTIONS,
     inputSchema: {
       type: "object",
-      properties: { width: WIDTH, height: HEIGHT, format: { type: "string", enum: ["svg", "png"], description: "svg (default) or png (only when the host supports it)." } },
+      properties: {
+        width: WIDTH,
+        height: HEIGHT,
+        format: { type: "string", enum: ["svg", "png"], description: "svg (default): the SVG document as text. png: an image to look at (only when the host can rasterize; costs image tokens)." }
+      },
       additionalProperties: false
     },
     annotations: { title: "Render the chart", ...READ },
     handler: async ({ width = size.width, height = size.height, format = "svg" }) => {
-      const svg = chartToSvg(controller.toJSON(), { width, height });
+      const json = controller.toJSON();
+      const scene = layoutChart(json, { width, height, selection: null });
+      const svg = chartSceneToSvg(scene, { ariaLabel: json.title || void 0, description: describeChart(json) });
+      const warnings = scene.warnings;
       if (format === "png") {
-        if (!options.rasterize) fail2('This host cannot rasterize charts; call render_chart with format "svg".');
+        if (!options.rasterize) fail2('This host cannot rasterize charts; call render_chart with format "svg", or get_chart for the layout warnings.');
         const image = await options.rasterize(svg, { width, height });
-        return { content: [{ type: "image", data: image.data, mimeType: image.mimeType }], structuredContent: { width, height, mimeType: image.mimeType } };
+        const info = { width, height, mimeType: image.mimeType, warnings };
+        const note = warnings.length ? `Layout warnings: ${warnings.map((w) => w.message).join(" ")}` : "No layout warnings.";
+        return {
+          content: [
+            { type: "image", data: image.data, mimeType: image.mimeType },
+            { type: "text", text: `Chart at ${width} \xD7 ${height}. ${note}` }
+          ],
+          structuredContent: info
+        };
       }
-      return { svg, width, height };
+      return { svg, width, height, warnings };
     }
   };
   const checkColors = {
@@ -1666,6 +1804,306 @@ var ChartDirector = class {
     }
   }
 };
+
+// src/chart/office-files.ts
+var OfficeChartsError = class extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "OfficeChartsError";
+  }
+};
+var CHARTEX_NS = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+var STRICT_CHART_NS = "http://purl.oclc.org/ooxml/drawingml/chart";
+var dirname = (path) => path.slice(0, path.lastIndexOf("/") + 1);
+function resolvePartPath(baseDir, target) {
+  const out = [];
+  for (const segment of (target.startsWith("/") ? target.slice(1) : baseDir + target).split("/")) {
+    if (segment === "" || segment === ".") continue;
+    if (segment === "..") out.pop();
+    else out.push(segment);
+  }
+  return out.join("/");
+}
+var relsPathFor = (partPath) => `${dirname(partPath)}_rels/${partPath.slice(dirname(partPath).length)}.rels`;
+function elements(root, localName) {
+  return Array.from(root.getElementsByTagNameNS("*", localName));
+}
+function relId(el, localName = "id") {
+  for (const a of Array.from(el.attributes)) {
+    if (a.localName === localName && (a.namespaceURI?.includes("relationships") || a.prefix === "r")) return a.value;
+  }
+  return void 0;
+}
+var firstChild = (el, localName) => el ? Array.from(el.children ?? el.childNodes).find((n) => n.nodeType === 1 && n.localName === localName) : void 0;
+async function readXml(r, path) {
+  const entry = r.zip.get(path) ?? r.zip.entries.find((e) => e.name.toLowerCase() === path.toLowerCase());
+  if (!entry) return null;
+  const doc = new r.Parser().parseFromString(await r.zip.readText(entry), "application/xml");
+  return doc.getElementsByTagName("parsererror").length ? null : doc;
+}
+async function readRels(r, partPath) {
+  const rels = /* @__PURE__ */ new Map();
+  const doc = await readXml(r, relsPathFor(partPath));
+  if (!doc) return rels;
+  for (const rel of elements(doc, "Relationship")) {
+    const id = rel.getAttribute("Id");
+    if (!id) continue;
+    const target = rel.getAttribute("Target") ?? "";
+    const external = rel.getAttribute("TargetMode")?.toLowerCase() === "external";
+    rels.set(id, { type: rel.getAttribute("Type") ?? "", target: external ? target : resolvePartPath(dirname(partPath), target), external });
+  }
+  return rels;
+}
+var isChartRef = (el) => el.localName === "chart" && (el.namespaceURI === CHART_OOXML_NS || el.namespaceURI === STRICT_CHART_NS || el.namespaceURI === CHARTEX_NS);
+function frameName(ref) {
+  for (let el = ref.parentElement; el; el = el.parentElement) {
+    if (el.localName === "graphicFrame") {
+      const nv = elements(el, "cNvPr")[0];
+      return nv?.getAttribute("name") || void 0;
+    }
+  }
+  return void 0;
+}
+async function chartsInPart(r, root, rels, place) {
+  for (const ref of elements(root, "chart")) {
+    if (r.charts.length >= r.max) return;
+    if (!isChartRef(ref)) continue;
+    const rel = rels.get(relId(ref) ?? "");
+    if (!rel || rel.external || r.seen.has(rel.target)) continue;
+    const entry = r.zip.get(rel.target);
+    if (!entry) continue;
+    r.seen.add(rel.target);
+    const read = chartFromOoxml(await r.zip.readText(entry), { DOMParser: r.Parser });
+    const name = frameName(ref);
+    r.charts.push({
+      id: `chart-${r.charts.length + 1}`,
+      path: rel.target,
+      partKind: ref.namespaceURI === CHARTEX_NS ? "chartex" : "chart",
+      ...place(ref),
+      ...name ? { name } : {},
+      title: read.spec.title,
+      spec: read.spec,
+      issues: read.issues.map((i) => i.message),
+      unsupported: read.unsupported,
+      lossless: read.lossless
+    });
+  }
+}
+function columnName(index) {
+  let name = "";
+  for (let n = index + 1; n > 0; n = Math.floor((n - 1) / 26)) name = String.fromCharCode(65 + (n - 1) % 26) + name;
+  return name;
+}
+function anchorCell(marker) {
+  const col = Number(firstChild(marker, "col")?.textContent);
+  const row = Number(firstChild(marker, "row")?.textContent);
+  return Number.isInteger(col) && Number.isInteger(row) && col >= 0 && row >= 0 ? `${columnName(col)}${row + 1}` : void 0;
+}
+function drawingPlace(ref) {
+  for (let el = ref.parentElement; el; el = el.parentElement) {
+    if (el.localName === "twoCellAnchor" || el.localName === "oneCellAnchor") {
+      const anchor = anchorCell(firstChild(el, "from"));
+      const to = el.localName === "twoCellAnchor" ? anchorCell(firstChild(el, "to")) : void 0;
+      return { ...anchor ? { anchor } : {}, ...anchor && to ? { range: `${anchor}:${to}` } : {} };
+    }
+    if (el.localName === "absoluteAnchor") return {};
+  }
+  return {};
+}
+async function readMainPart(r) {
+  const rootRels = await readRels(r, "");
+  const main = [...rootRels.values()].find((rel) => /\/officeDocument$/.test(rel.type) && !rel.external);
+  const doc = main ? await readXml(r, main.target) : null;
+  if (!main || !doc) throw new OfficeChartsError("This is not an Office file: _rels/.rels names no main part (expected an .xlsx, .pptx or .docx file).");
+  return { path: main.target, doc };
+}
+async function readXlsx(r, main) {
+  const rels = await readRels(r, main.path);
+  for (const sheet of elements(main.doc, "sheet")) {
+    const rel = rels.get(relId(sheet) ?? "");
+    if (!rel || rel.external) continue;
+    const doc = await readXml(r, rel.target);
+    if (!doc) continue;
+    const sheetName = sheet.getAttribute("name") ?? rel.target;
+    const sheetRels = await readRels(r, rel.target);
+    for (const drawingRef of elements(doc, "drawing")) {
+      const drawingRel = sheetRels.get(relId(drawingRef) ?? "");
+      if (!drawingRel || drawingRel.external) continue;
+      const drawing = await readXml(r, drawingRel.target);
+      if (!drawing) continue;
+      const drawingRels = await readRels(r, drawingRel.target);
+      await chartsInPart(r, drawing, drawingRels, (ref) => ({ sheet: sheetName, ...drawingPlace(ref) }));
+    }
+  }
+}
+async function readPptx(r, main) {
+  const rels = await readRels(r, main.path);
+  const slides = elements(main.doc, "sldId");
+  for (let i = 0; i < slides.length; i++) {
+    const rel = rels.get(relId(slides[i]) ?? "");
+    if (!rel || rel.external) continue;
+    const doc = await readXml(r, rel.target);
+    if (!doc) continue;
+    await chartsInPart(r, doc, await readRels(r, rel.target), () => ({ slide: i + 1 }));
+  }
+}
+async function readDocx(r, main) {
+  await chartsInPart(r, main.doc, await readRels(r, main.path), () => ({}));
+}
+async function open(bytes, options) {
+  const Parser = options.DOMParser ?? globalThis.DOMParser;
+  if (!Parser) throw new OfficeChartsError("Reading Office files needs a DOMParser. In Node, pass one (e.g. from jsdom or @xmldom/xmldom) as { DOMParser }.");
+  let zip;
+  try {
+    zip = await readZip(bytes, options);
+  } catch (error) {
+    throw new OfficeChartsError(`This is not an Office file: ${error.message}`, { cause: error });
+  }
+  const r = { zip, Parser, max: options.maxCharts ?? 500, charts: [], seen: /* @__PURE__ */ new Set() };
+  const main = await readMainPart(r);
+  const root = main.doc.documentElement.localName;
+  const format = root === "workbook" ? "xlsx" : root === "presentation" ? "pptx" : root === "document" ? "docx" : void 0;
+  if (!format) throw new OfficeChartsError(`The main part ${main.path} is a <${root}>; expected an Excel workbook, PowerPoint presentation or Word document.`);
+  return { r, main, format };
+}
+var READERS = { xlsx: readXlsx, pptx: readPptx, docx: readDocx };
+async function extractOfficeCharts(bytes, options = {}) {
+  const { r, main, format } = await open(bytes, options);
+  await READERS[format](r, main);
+  return { format, charts: r.charts };
+}
+async function extractAs(format, bytes, options) {
+  const result = await extractOfficeCharts(bytes, options);
+  if (result.format !== format) throw new OfficeChartsError(`This is a .${result.format} file, not a .${format} file.`);
+  return result.charts;
+}
+var extractXlsxCharts = (bytes, options = {}) => extractAs("xlsx", bytes, options);
+var extractPptxCharts = (bytes, options = {}) => extractAs("pptx", bytes, options);
+var extractDocxCharts = (bytes, options = {}) => extractAs("docx", bytes, options);
+function describeOfficeChartPlace(chart) {
+  if (chart.sheet !== void 0) return chart.anchor ? `${chart.sheet}!${chart.anchor}` : chart.sheet;
+  if (chart.slide !== void 0) return `Slide ${chart.slide}`;
+  return "Document";
+}
+
+// src/chart/file-tools.ts
+var READ2 = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var DESTRUCTIVE2 = { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false };
+var fail3 = (message) => {
+  throw new Error(message);
+};
+function fromBase64(data) {
+  const clean = data.replace(/^data:[^,]*,/, "").replace(/\s+/g, "");
+  let binary;
+  try {
+    binary = atob(clean);
+  } catch {
+    return fail3('"data" is not valid base64. Pass the whole .xlsx, .pptx or .docx file encoded as base64 (a data: URL prefix is fine).');
+  }
+  const out = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) out[i] = binary.charCodeAt(i);
+  return out;
+}
+function chartSummary(chart) {
+  return {
+    id: chart.id,
+    place: describeOfficeChartPlace(chart),
+    ...chart.sheet !== void 0 ? { sheet: chart.sheet } : {},
+    ...chart.slide !== void 0 ? { slide: chart.slide } : {},
+    ...chart.anchor ? { anchor: chart.anchor } : {},
+    ...chart.range ? { range: chart.range } : {},
+    ...chart.name ? { name: chart.name } : {},
+    path: chart.path,
+    partKind: chart.partKind,
+    title: chart.title,
+    type: chart.spec.type,
+    series: chart.spec.series.map((s) => s.name),
+    categories: chart.spec.categories.length,
+    issues: chart.issues,
+    unsupported: chart.unsupported,
+    lossless: chart.lossless
+  };
+}
+function createOfficeChartToolProvider(options = {}) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  const readOnlyReason = () => {
+    const r = typeof options.readOnly === "function" ? options.readOnly() : options.readOnly;
+    if (!r) return null;
+    return typeof r === "string" ? r : "This chart is read-only.";
+  };
+  const source = options.files ? { file: { type: "string", description: "Name of an open file, as list_open_files returns it." } } : { data: { type: "string", description: "The whole .xlsx, .pptx or .docx file as base64 (a data: URL prefix is allowed)." } };
+  const sourceKey = options.files ? "file" : "data";
+  const read = (args) => {
+    if (!options.files) return extractOfficeCharts(fromBase64(String(args.data)), { DOMParser: options.DOMParser });
+    const files = options.files();
+    const file = files.find((f) => f.name === args.file);
+    if (!file) return fail3(`There is no open file "${String(args.file)}"; expected one of ${files.map((f) => JSON.stringify(f.name)).join(", ") || "(none; ask the user to open an .xlsx, .pptx or .docx file)"}.`);
+    let result = cache.get(file);
+    if (!result) {
+      result = extractOfficeCharts(file.data, { DOMParser: options.DOMParser });
+      cache.set(file, result);
+      result.catch(() => cache.delete(file));
+    }
+    return result;
+  };
+  const chartById = async (args) => {
+    const { charts } = await read(args);
+    const chart = charts.find((c) => c.id === args.chartId);
+    if (!chart) fail3(`There is no chart "${String(args.chartId)}" in this file; expected one of ${charts.map((c) => `"${c.id}" (${describeOfficeChartPlace(c)})`).join(", ") || "(none: the file has no charts)"}.`);
+    return chart;
+  };
+  const CHART_ID = { type: "string", description: 'Chart id from list_file_charts, e.g. "chart-1".' };
+  const listOpenFiles = {
+    name: "list_open_files",
+    title: "List open files",
+    description: "Lists the Office files the user opened that charts can be read from. Returns their names and sizes in bytes.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: "List open files", ...READ2 },
+    handler: () => ({ files: (options.files?.() ?? []).map((f) => ({ name: f.name, bytes: f.data.byteLength })) })
+  };
+  const listCharts = {
+    name: "list_file_charts",
+    title: "List the charts in an Office file",
+    description: "Reads an Excel workbook, PowerPoint deck or Word document and lists its charts in file order: id, where it sits (sheet name and anchor cell, or slide number), title, type, series names, number of categories, read problems, features the chart editor cannot hold, and whether it reads losslessly. Pass an id to get_file_chart or load_file_chart.",
+    inputSchema: { type: "object", properties: { ...source }, required: [sourceKey], additionalProperties: false },
+    annotations: { title: "List the charts in an Office file", ...READ2 },
+    handler: async (args) => {
+      const result = await read(args);
+      return { format: result.format, charts: result.charts.map(chartSummary) };
+    }
+  };
+  const getChart = {
+    name: "get_file_chart",
+    title: "Get a chart from an Office file",
+    description: "Returns one chart of an Office file with its full chart spec (data, axes, series styles), where it sits and its read problems.",
+    inputSchema: { type: "object", properties: { ...source, chartId: CHART_ID }, required: [sourceKey, "chartId"], additionalProperties: false },
+    annotations: { title: "Get a chart from an Office file", ...READ2 },
+    handler: async (args) => {
+      const chart = await chartById(args);
+      return { ...chartSummary(chart), spec: chart.spec };
+    }
+  };
+  const loadChart = {
+    name: "load_file_chart",
+    title: "Load a chart from an Office file",
+    description: "Replaces the chart in the editor with a chart from an Office file, as one undo step. Returns the new spec, read problems and features the editor could not keep.",
+    inputSchema: { type: "object", properties: { ...source, chartId: CHART_ID }, required: [sourceKey, "chartId"], additionalProperties: false },
+    annotations: { title: "Load a chart from an Office file", ...DESTRUCTIVE2 },
+    handler: async (args) => {
+      const reason = readOnlyReason();
+      if (reason) fail3(reason);
+      const chart = await chartById(args);
+      const result = options.controller.update({ ...chart.spec }, { label: "Load chart from file" });
+      if (!result.ok) fail3(result.message ?? "The chart could not be loaded.");
+      return { id: chart.id, place: describeOfficeChartPlace(chart), spec: options.controller.toJSON(), issues: chart.issues, unsupported: chart.unsupported, lossless: chart.lossless };
+    }
+  };
+  return {
+    id: options.id ?? "office-charts",
+    ...options.namespace ? { namespace: options.namespace } : {},
+    tools: () => [...options.files ? [listOpenFiles] : [], listCharts, getChart, ...options.controller && !readOnlyReason() ? [loadChart] : []]
+  };
+}
 export {
   CHART_AXIS_KINDS,
   CHART_COLOR_SCHEMES,
@@ -1683,6 +2121,7 @@ export {
   CHART_ORIENTATIONS,
   CHART_PALETTE_SHADES,
   CHART_PRESENCE_COLORS,
+  CHART_RASTER_MAX_SIZE,
   CHART_SERIES_TYPES,
   CHART_STACKINGS,
   CHART_TRENDLINE_TYPES,
@@ -1698,6 +2137,8 @@ export {
   MAX_CHART_DATA_LABELS,
   MAX_CHART_LINE_POINTS,
   MAX_CHART_MARKERS,
+  OfficeChartsError,
+  RENDER_CHART_INSTRUCTIONS,
   analyzeChartTable,
   blendChartScenes,
   canDragChartPoint,
@@ -1712,6 +2153,7 @@ export {
   chartDateLabels,
   chartDateToSerial,
   chartFamily,
+  chartFileName,
   chartFormatToCode,
   chartFromMermaid,
   chartFromOoxml,
@@ -1725,6 +2167,7 @@ export {
   chartPointColor,
   chartPresetPatch,
   chartQuantile,
+  chartRasterSize,
   chartRgbToHex,
   chartRgbToOklab,
   chartSceneToDomSpec,
@@ -1751,16 +2194,24 @@ export {
   contrastingTextColor,
   createChartCommands,
   createChartController,
+  createChartRasterizer,
   createChartSpec,
   createChartToolProvider,
   createInstantChartClock,
+  createOfficeChartToolProvider,
   cyclePaletteColor,
   decimateChartPoints,
   defaultChartAxis,
   describeChart,
   describeChartSelection,
+  describeOfficeChartPlace,
+  downloadChartPng,
   easeChartTween,
   estimateChartTextWidth,
+  extractDocxCharts,
+  extractOfficeCharts,
+  extractPptxCharts,
+  extractXlsxCharts,
   findMermaidCharts,
   fitChartTrendline,
   formatChartDate,
@@ -1784,9 +2235,11 @@ export {
   parseChartValue,
   parsePartialChartJson,
   planChartCommand,
+  rasterizeChartSvg,
   realChartClock,
   recommendChartTypes,
   recommendForShape,
+  resolveChartSvgPaints,
   sameChartSelection,
   shadeChartColor,
   simulateChartVision,