@web-ppt/edit-core 0.5.0-beta.1 → 0.5.0-beta.7

package/dist/chart-design.js

@@ -0,0 +1,361 @@
+import { queryChartData as q, chartProjection as K } from "@web-ppt/edit-core/chart";
+import { renderChartXml as G } from "@web-ppt/core/chart-edit";
+import { findXmlAttribute as Y, createXmlElement as W, xmlElementChildren as F, parseXmlTree as Z, setXmlAttribute as S, removeXmlChild as w, insertXmlChildUnchecked as d, serializeXmlTree as U, createXmlText as J, cloneXmlNodeWithNamespaceClosure as y } from "@web-ppt/edit-core/xml";
+function Q(e, t, o) {
+  if (!e || typeof e != "object" || Object.getPrototypeOf(e) !== Object.prototype && Object.getPrototypeOf(e) !== null)
+    throw new Error(`${o} 必须是纯数据对象`);
+  const r = Array.isArray(t) ? new Set(t) : t;
+  for (const a of Reflect.ownKeys(e)) {
+    const n = Object.getOwnPropertyDescriptor(e, a);
+    if (typeof a != "string" || !r.has(a) || !(n != null && n.enumerable) || !("value" in n))
+      throw new Error(`${o} 包含不可序列化或未知字段：${String(a)}`);
+  }
+}
+function tt(e, t) {
+  if (!Array.isArray(e) || Object.getPrototypeOf(e) !== Array.prototype)
+    throw new Error(`${t} 必须是纯数据数组`);
+  const o = Reflect.ownKeys(e);
+  if (o.length !== e.length + 1 || o[o.length - 1] !== "length")
+    throw new Error(`${t} 必须是没有附加字段的稠密数组`);
+  for (let r = 0; r < e.length; r++) {
+    const a = String(r), n = Object.getOwnPropertyDescriptor(e, a);
+    if (o[r] !== a || !(n != null && n.enumerable) || !("value" in n))
+      throw new Error(`${t}[${r}] 必须是可序列化的数据项`);
+  }
+}
+const M = Symbol.for("@web-ppt/edit-core/extensions/v1"), V = Symbol.for("@web-ppt/edit-core/extensions-generation/v1"), I = Symbol.for("@web-ppt/edit-core/extensions-listeners/v1"), et = /^[a-z][a-z0-9-]{0,63}$/;
+function R() {
+  const e = globalThis;
+  return e[I] ?? (e[I] = { documents: /* @__PURE__ */ new WeakMap(), pending: /* @__PURE__ */ new Map(), active: /* @__PURE__ */ new Set(), resolvers: /* @__PURE__ */ new WeakMap() });
+}
+function rt(e) {
+  if (!et.test(e))
+    throw new Error(`编辑扩展命名空间无效：${e}`);
+}
+function ot() {
+  const e = globalThis;
+  return e[M] ?? (e[M] = /* @__PURE__ */ new Map());
+}
+function nt(e, t) {
+  var a;
+  rt(e), ot().set(e, t);
+  const o = globalThis;
+  o[V] = (o[V] ?? 0) + 1;
+  const r = new Set(R().pending.get(e));
+  if (t.migrate) for (const n of R().active) r.add(n);
+  R().pending.delete(e);
+  for (const n of r ?? [])
+    try {
+      n(e);
+    } catch (l) {
+      (a = globalThis.reportError) == null || a.call(globalThis, l);
+    }
+}
+const lt = "http://schemas.openxmlformats.org/drawingml/2006/chart", at = "http://purl.oclc.org/ooxml", it = `${at}/drawingml/chart`, st = (e, t, o) => e === t || e === o, ct = (e) => st(e, lt, it);
+function ft(e) {
+  return { child: (r, a) => r && e(r.namespaceUri) ? F(r).find((n) => n.namespaceUri === r.namespaceUri && n.localName === a) ?? null : null, children: (r, a) => r && e(r.namespaceUri) ? F(r).filter((n) => n.namespaceUri === r.namespaceUri && (!a || n.localName === a)) : [] };
+}
+const ut = ft(ct), C = (e, t) => {
+  var o;
+  return e ? ((o = Y(e, { localName: t, namespaceUri: null })) == null ? void 0 : o.value) ?? null : null;
+};
+function v(e, t, o = []) {
+  return W(e.prefix ? `${e.prefix}:${t}` : t, {
+    attributes: o,
+    selfClosing: !1
+  });
+}
+const D = {
+  barChart: "bar",
+  bar3DChart: "bar",
+  lineChart: "line",
+  line3DChart: "line",
+  pieChart: "pie",
+  pie3DChart: "pie",
+  doughnutChart: "doughnut",
+  areaChart: "area",
+  area3DChart: "area",
+  scatterChart: "scatter",
+  bubbleChart: "bubble",
+  radarChart: "radar",
+  stockChart: "stock",
+  ofPieChart: "ofPie",
+  surfaceChart: "surface",
+  surface3DChart: "surface"
+}, pt = 2e4, { child: u, children: b } = ut, dt = {
+  bar: "barChart",
+  line: "lineChart",
+  area: "areaChart",
+  pie: "pieChart",
+  doughnut: "doughnutChart",
+  radar: "radarChart",
+  scatter: "scatterChart",
+  bubble: "bubbleChart"
+}, k = (e) => e === "pie" || e === "doughnut", z = (e) => e === "scatter" || e === "bubble", s = (e, t, o) => {
+  const r = v(e, t, o === void 0 ? [] : [["val", o]]);
+  return d(e, r), r;
+}, x = (e, t, o) => {
+  const r = v(e, t);
+  return d(e, r, b(e).find((a) => o.includes(a.localName)) ?? null), r;
+}, E = (e, t, o) => {
+  const r = u(e, t) ?? s(e, t);
+  S(r, "val", o);
+}, m = (e, t, o = []) => {
+  var n;
+  const r = (n = e.namespaceUri) != null && n.includes("purl.oclc.org") ? "http://purl.oclc.org/ooxml/drawingml/main" : "http://schemas.openxmlformats.org/drawingml/2006/main", a = W(`a:${t}`, { attributes: [["xmlns:a", r], ...o] });
+  return d(e, a), a;
+};
+function ht(e, t, o) {
+  const r = s(t, "ser");
+  for (const n of ["idx", "order", "tx", "spPr"]) {
+    const l = u(e, n);
+    l && d(r, y(l, r));
+  }
+  if (o === "line" || o === "radar" || o === "scatter") {
+    const n = u(e, "marker");
+    n && d(r, y(n, r));
+  }
+  for (const n of ["dPt", "dLbls"]) for (const l of b(e, n)) d(r, y(l, r));
+  if (!k(o) && o !== "radar") for (const n of ["trendline", "errBars"])
+    for (const l of b(e, n)) d(r, y(l, r));
+  for (const n of z(o) ? ["xVal", "yVal", "bubbleSize"] : ["cat", "val"]) {
+    if (n === "bubbleSize" && o !== "bubble") continue;
+    const l = u(e, n);
+    if (l) d(r, y(l, r));
+    else if (n === "bubbleSize") {
+      const i = s(r, n), f = s(i, "numLit"), c = u(u(e, "yVal"), "numRef"), p = u(c, "numCache") ?? u(u(e, "yVal"), "numLit"), h = Number(C(u(p, "ptCount"), "val")) || 0;
+      if (!Number.isInteger(h) || h < 0 || h > pt) throw new Error("气泡数据点数量无效");
+      s(f, "ptCount", String(h));
+      for (let g = 0; g < h; g++) {
+        const O = v(f, "pt", [["idx", String(g)]]);
+        d(f, O), d(s(O, "v"), J("1"));
+      }
+    }
+  }
+  (o === "line" || o === "scatter") && s(r, "smooth", "0");
+  const a = u(e, "extLst");
+  return a && d(r, y(a, r)), r;
+}
+function bt(e, t) {
+  const o = b(e).filter((l) => D[l.localName]);
+  if (!o.length) throw new Error("图表没有可编辑绘图区");
+  const r = t.type;
+  if (!r) return o;
+  if (o.some((l) => z(D[l.localName]) !== z(r))) throw new Error("类别图与 XY 图的数据轴不同，需要先提供对应的数据");
+  const a = o.flatMap((l) => b(l, "ser"));
+  if (r === "pie" && a.length > 1) throw new Error("饼图只支持一个数据系列");
+  const n = v(e, dt[r]);
+  d(e, n, o[0] ?? null), r === "bar" && s(n, "barDir", t.horizontal ? "bar" : "col"), (r === "bar" || r === "line" || r === "area") && s(
+    n,
+    "grouping",
+    B(r, t.grouping)
+  ), r === "radar" && s(n, "radarStyle", "marker"), r === "scatter" && s(n, "scatterStyle", "lineMarker"), s(n, "varyColors", k(r) ? "1" : "0");
+  for (const l of a) ht(l, n, r);
+  if (t.labels !== void 0 && s(s(n, "dLbls"), "showVal", t.labels ? "1" : "0"), r === "doughnut" && s(n, "holeSize", "50"), r === "bar" && t.grouping && t.grouping !== "standard" && s(n, "overlap", "100"), k(r))
+    for (const l of b(e).filter((i) => i.localName.endsWith("Ax"))) w(e, l);
+  else {
+    const l = mt(e, r, t.horizontal === !0);
+    for (const i of l) s(n, "axId", C(u(i, "axId"), "val"));
+  }
+  for (const l of o) w(e, l);
+  return [n];
+}
+const B = (e, t) => t && t !== "standard" ? t : e === "bar" ? "clustered" : "standard";
+function mt(e, t, o) {
+  const r = b(e).filter((n) => n.localName.endsWith("Ax")), a = [];
+  for (const [n, l] of [z(t) ? "valAx" : "catAx", "valAx"].entries()) {
+    let i = r.find((f) => !a.includes(f) && (f.localName === l || l === "catAx" && f.localName === "dateAx"));
+    i || (i = x(e, l, ["dTable", "spPr", "extLst"]), s(i, "axId", String(1001 + n)), s(s(i, "scaling"), "orientation", "minMax"), s(i, "delete", "0"), s(i, "axPos", "b"), s(i, "crossAx", "0"), s(i, "crosses", "autoZero"), l === "catAx" && (s(i, "auto", "1"), s(i, "lblAlgn", "ctr"), s(i, "lblOffset", "100"))), E(i, "axId", String(1001 + n)), E(i, "crossAx", String(n ? 1001 : 1002)), E(i, "axPos", n === 0 === (t === "bar" && o) ? "l" : "b"), a.push(i);
+  }
+  for (const n of r) a.includes(n) || w(e, n);
+  return a;
+}
+function X(e, t) {
+  let o = u(e, "spPr");
+  o || (o = v(e, "spPr"), d(
+    e,
+    o,
+    b(e).find((l) => e.localName === "dPt" ? l.localName === "extLst" : !["idx", "order", "tx"].includes(l.localName)) ?? null
+  ));
+  for (const l of [...o.children]) l.type === "element" && ["noFill", "solidFill", "gradFill", "blipFill", "pattFill", "grpFill", "ln"].includes(l.localName) && w(o, l);
+  const r = m(o, "solidFill"), a = m(o, "ln", [["w", "19050"]]);
+  m(r, "srgbClr", [["val", t.slice(1)]]), m(m(a, "solidFill"), "srgbClr", [["val", t.slice(1)]]), w(o, r), w(o, a);
+  const n = o.children.find((l) => l.type === "element" && ["effectLst", "effectDag", "scene3d", "sp3d", "extLst"].includes(l.localName)) ?? null;
+  d(o, r, n), d(o, a, n);
+}
+function P(e, t) {
+  const o = Z(e), r = u(o.root, "chart"), a = u(r, "plotArea");
+  if (!r || !a) throw new Error("经典图表绘图区缺失");
+  const n = bt(a, t);
+  if (!t.type) for (const i of n) {
+    const f = D[i.localName];
+    if (t.horizontal !== void 0 && f === "bar") {
+      E(i, "barDir", t.horizontal ? "bar" : "col");
+      const c = b(i, "axId").map((p) => C(p, "val"));
+      for (const p of b(a).filter((h) => c.includes(C(u(h, "axId"), "val"))))
+        E(p, "axPos", p.localName !== "valAx" === t.horizontal ? "l" : "b");
+    }
+    if (t.grouping !== void 0 && ["bar", "line", "area"].includes(f)) {
+      const c = u(i, "grouping") ?? x(i, "grouping", ["varyColors", "ser", "dLbls", "axId", "extLst"]);
+      if (S(c, "val", B(f, t.grouping)), f === "bar") {
+        const p = u(i, "overlap") ?? x(i, "overlap", ["serLines", "axId", "extLst"]);
+        S(p, "val", t.grouping === "standard" ? "0" : "100");
+      }
+    }
+  }
+  const l = t.palette;
+  if (l != null && l.length) {
+    let i = 0;
+    for (const f of n) for (const c of b(f, "ser")) {
+      const p = l[i++ % l.length];
+      if (X(c, p), ["pie", "doughnut", "ofPie"].includes(D[f.localName])) {
+        const h = u(c, "val"), g = u(u(h, "numRef"), "numCache") ?? u(h, "numLit");
+        for (const O of b(g, "pt")) {
+          const $ = C(O, "idx") ?? "0";
+          let T = b(c, "dPt").find((H) => C(u(H, "idx"), "val") === $);
+          T || (T = x(c, "dPt", ["dLbls", "cat", "val", "extLst"]), s(T, "idx", $)), X(T, l[Number($) % l.length] ?? p);
+        }
+      } else for (const h of b(c, "dPt")) X(h, p);
+    }
+  }
+  if (t.labels !== void 0 && !t.type) for (const i of n) {
+    const f = u(i, "dLbls") ?? x(i, "dLbls", [
+      "dropLines",
+      "hiLowLines",
+      "upDownBars",
+      "gapWidth",
+      "overlap",
+      "serLines",
+      "firstSliceAng",
+      "holeSize",
+      "bubble3D",
+      "bubbleScale",
+      "showNegBubbles",
+      "sizeRepresents",
+      "marker",
+      "smooth",
+      "axId",
+      "extLst"
+    ]), c = u(f, "showVal") ?? x(f, "showVal", ["showCatName", "showSerName", "showPercent", "showBubbleSize", "separator", "showLeaderLines", "leaderLines", "extLst"]);
+    S(c, "val", t.labels ? "1" : "0");
+  }
+  if (t.legend !== void 0) {
+    const i = u(r, "legend");
+    if (i && w(r, i), t.legend !== "none") {
+      const f = v(r, "legend");
+      d(r, f, b(r).find((c) => ["plotVisOnly", "dispBlanksAs", "showDLblsOverMax", "extLst"].includes(c.localName)) ?? null), s(f, "legendPos", { left: "l", right: "r", top: "t", bottom: "b" }[t.legend]), s(f, "overlay", "0");
+    }
+  }
+  if (t.title !== void 0) {
+    const i = u(r, "title");
+    i && w(r, i);
+    const f = u(r, "autoTitleDeleted") ?? x(r, "autoTitleDeleted", ["pivotFmts", "view3D", "floor", "sideWall", "backWall", "plotArea", "legend", "plotVisOnly", "extLst"]);
+    if (S(f, "val", t.title ? "0" : "1"), !t.title) return U(o);
+    const c = v(r, "title");
+    d(r, c, r.children[0] ?? null);
+    const p = s(s(c, "tx"), "rich");
+    m(p, "bodyPr"), m(p, "lstStyle");
+    const h = m(m(p, "p"), "r");
+    d(m(h, "t"), J(t.title)), s(c, "overlay", "0");
+  }
+  return U(o);
+}
+const gt = ["bar", "line", "area", "pie", "doughnut", "radar", "scatter", "bubble"], j = "chart-design", A = (e, t) => {
+  var o, r, a;
+  return (a = (r = (o = e.elements[t]) == null ? void 0 : o.ovr.extensions) == null ? void 0 : r[j]) == null ? void 0 : a.value;
+};
+function L(e, t) {
+  const o = q(e, t).binding;
+  if (o.mode === "readonly") throw new Error(o.reason ?? "图表只读");
+  return K(e, t);
+}
+function N(e) {
+  Q(e, ["type", "horizontal", "grouping", "palette", "legend", "labels", "title"], "图表样式");
+  const t = e;
+  if (t.type !== void 0 && !gt.includes(t.type)) throw new Error("图表类型无效");
+  for (const o of ["horizontal", "labels"]) if (t[o] !== void 0 && typeof t[o] != "boolean") throw new Error(`图表 ${o} 必须为布尔值`);
+  if (t.grouping !== void 0 && !["standard", "stacked", "percentStacked"].includes(t.grouping)) throw new Error("图表分组无效");
+  if (t.legend !== void 0 && !["none", "left", "right", "top", "bottom"].includes(t.legend)) throw new Error("图例位置无效");
+  if (t.title !== void 0 && (typeof t.title != "string" || t.title.length > 1e4 || /[\u0000-\u0008\u000b\u000c\u000e-\u001f\ud800-\udfff\ufffe\uffff]/u.test(t.title))) throw new Error("图表标题无效");
+  if (t.palette !== void 0 && (tt(t.palette, "图表配色"), !t.palette.length || t.palette.length > 32 || t.palette.some((o) => !/^#[\da-f]{6}$/i.test(o))))
+    throw new Error("图表配色需要 1–32 个十六进制颜色");
+  return { ...t, ...t.palette ? { palette: t.palette.map((o) => o.toUpperCase()) } : {} };
+}
+function wt(e, t) {
+  if (t.path[0] !== "elements" || t.path.length !== 6 || t.path[5] !== "value") throw new Error("图表样式补丁路径无效");
+  const o = L(e, t.path[1]);
+  if (t.op === "set") {
+    if (typeof t.value != "string" || t.value.length > 2e4) throw new Error("图表样式补丁值无效");
+    P(o.xml, N(JSON.parse(t.value)));
+  }
+}
+function xt(e, t, o) {
+  var i;
+  if (e.meta.readonly || ((i = e.elements[t.id]) == null ? void 0 : i.meta.editable) !== "frame") throw new Error("对象不允许修改图表样式");
+  const r = t.payload === null ? void 0 : JSON.stringify(N(t.payload)), a = L(e, t.id);
+  r !== void 0 && P(a.xml, JSON.parse(r));
+  const n = A(e, t.id), l = ["elements", t.id, "ovr", "extensions", j, "value"];
+  return n === r ? { forward: [], inverse: [] } : {
+    forward: [r === void 0 ? { op: "del", path: l, origin: o } : { op: "set", path: l, value: r, origin: o }],
+    inverse: [n === void 0 ? { op: "del", path: l, origin: o } : { op: "set", path: l, value: n, origin: o }]
+  };
+}
+function _(e, t) {
+  const o = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+  for (const a of Object.values(e.elements)) {
+    const n = A(e, a.id);
+    if (!n) continue;
+    const { part: l } = L(e, a.id);
+    if (!t[l]) throw new Error("生成图表缺少部件");
+    const i = r.get(l) ?? t[l];
+    r.set(l, i);
+    const f = P(i, N(JSON.parse(n)));
+    if (o.has(l) && o.get(l) !== f) throw new Error("共享图表不能设置不同样式");
+    o.set(l, f), t[l] = new TextEncoder().encode(f);
+  }
+}
+nt(j, {
+  command: xt,
+  validatePatch: wt,
+  project(e, t, o) {
+    const r = A(e, t);
+    if (!r || o.kind !== "group") return o;
+    const a = L(e, t);
+    return { ...o, children: G(P(a.xml, N(JSON.parse(r))), o.w, o.h, a.context) };
+  },
+  generateParts: _,
+  copyParts: _,
+  materializePackage(e, t, o, r) {
+    var l;
+    const a = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map();
+    for (const i of Object.values(e.elements)) {
+      const f = A(e, i.id);
+      if (!f) continue;
+      const { part: c } = L(e, i.id), p = t[c] ?? ((l = e.package) == null ? void 0 : l.parts[c]);
+      if (!p) throw new Error("图表缺少保存来源");
+      t[c] ?? (t[c] = p.slice());
+      const h = n.get(c) ?? r[c] ?? p;
+      n.set(c, h);
+      const g = P(h, N(JSON.parse(f)));
+      if (a.has(c) && a.get(c) !== g) throw new Error("共享图表不能设置不同样式");
+      a.set(c, g), r[c] = new TextEncoder().encode(g);
+    }
+  }
+});
+function vt(e, t) {
+  const o = A(e, t);
+  return o ? N(JSON.parse(o)) : {};
+}
+function St(e) {
+  return {
+    query: (t) => vt(e.doc, t),
+    set(t, o) {
+      return e.exec({ type: "Extension", namespace: j, id: t, payload: o });
+    }
+  };
+}
+export {
+  gt as CHART_TYPES,
+  St as createChartDesignEditor,
+  vt as queryChartDesign
+};

package/dist/chart-ex/index.d.ts

@@ -0,0 +1,15 @@
+import type { ChartExDataset } from '@web-ppt/core/chart-ex';
+import type { Editor, EditDoc, ElementId } from '@web-ppt/edit-core';
+export type { ChartExDataset } from '@web-ppt/core/chart-ex';
+export declare function listEditableChartEx(doc: EditDoc): {
+    id: string;
+    name: string;
+}[];
+export declare function queryChartExData(doc: EditDoc, id: ElementId): ChartExDataset[];
+export declare function createChartExEditor(editor: Pick<Editor, 'doc' | 'exec'>): {
+    query: (id: ElementId) => ChartExDataset[];
+    setCell(id: ElementId, dataId: string, dimension: number, level: number, point: number, value: string | number | null): void;
+    insertRow(id: ElementId, dataId: string, index: number): void;
+    removeRow(id: ElementId, dataId: string, index: number): void;
+    reset(id: ElementId): void;
+};

package/dist/chart-ex/workbook.d.ts

@@ -0,0 +1,6 @@
+import type { ChartExDataset } from '@web-ppt/core/chart-ex';
+/** 将修改数据放入独立工作表，原公式范围和其他图表的数据不会被行数变化覆盖。 */
+export declare function chartExWorkbook(bytes: Uint8Array, datasets: ChartExDataset[]): {
+    bytes: Uint8Array<ArrayBuffer>;
+    formula: (data: number, dimension: number) => string | undefined;
+};

package/dist/chart-ex/xml.d.ts

@@ -0,0 +1,14 @@
+import type { XmlElement } from '@web-ppt/edit-core/xml';
+import type { ChartExDataset } from '@web-ppt/core/chart-ex';
+export declare const CX = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+export declare const R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+export declare const children: (node: XmlElement | null, name?: string) => XmlElement[];
+export declare const child: (node: XmlElement | null, name: string) => XmlElement;
+export declare const attr: (node: XmlElement | null, name: string) => string | undefined;
+export declare const add: (parent: XmlElement, name: string, attrs?: readonly (readonly [string, string])[], value?: string) => XmlElement;
+export interface ChartExState {
+    data: ChartExDataset[];
+    rows: Record<string, (number | null)[]>;
+}
+export type DimensionFormula = (data: number, dimension: number) => string | undefined;
+export declare function writeChartExData(source: string, state: ChartExState, formula?: DimensionFormula): string;