@pixerate/editor 0.51.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,
@@ -135,9 +136,9 @@ function chartRasterSize(width, height, scale = 2, maxSize = CHART_RASTER_MAX_SI
   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, open) {
+function closingParen(text, open2) {
   let depth = 0;
-  for (let i = open; i < text.length; i++) {
+  for (let i = open2; i < text.length; i++) {
     if (text[i] === "(") depth++;
     else if (text[i] === ")" && --depth === 0) return i + 1;
   }
@@ -1803,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,
@@ -1836,6 +2137,7 @@ export {
   MAX_CHART_DATA_LABELS,
   MAX_CHART_LINE_POINTS,
   MAX_CHART_MARKERS,
+  OfficeChartsError,
   RENDER_CHART_INSTRUCTIONS,
   analyzeChartTable,
   blendChartScenes,
@@ -1896,14 +2198,20 @@ export {
   createChartSpec,
   createChartToolProvider,
   createInstantChartClock,
+  createOfficeChartToolProvider,
   cyclePaletteColor,
   decimateChartPoints,
   defaultChartAxis,
   describeChart,
   describeChartSelection,
+  describeOfficeChartPlace,
   downloadChartPng,
   easeChartTween,
   estimateChartTextWidth,
+  extractDocxCharts,
+  extractOfficeCharts,
+  extractPptxCharts,
+  extractXlsxCharts,
   findMermaidCharts,
   fitChartTrendline,
   formatChartDate,