@web-ppt/edit-core 0.5.0-beta.2 → 0.5.0

package/dist/appearance.js

@@ -0,0 +1,301 @@
+import { effectiveElement as Z } from "@web-ppt/edit-core";
+function C(t, o, e) {
+  if (!t || typeof t != "object" || Object.getPrototypeOf(t) !== Object.prototype && Object.getPrototypeOf(t) !== null)
+    throw new Error(`${e} 必须是纯数据对象`);
+  const r = Array.isArray(o) ? new Set(o) : o;
+  for (const n of Reflect.ownKeys(t)) {
+    const a = Object.getOwnPropertyDescriptor(t, n);
+    if (typeof n != "string" || !r.has(n) || !(a != null && a.enumerable) || !("value" in a))
+      throw new Error(`${e} 包含不可序列化或未知字段：${String(n)}`);
+  }
+}
+const K = [
+  "pct5",
+  "pct10",
+  "pct20",
+  "pct25",
+  "pct30",
+  "pct40",
+  "pct50",
+  "pct60",
+  "pct70",
+  "pct75",
+  "pct80",
+  "pct90",
+  "ltHorz",
+  "horz",
+  "dkHorz",
+  "ltVert",
+  "vert",
+  "dkVert",
+  "ltUpDiag",
+  "upDiag",
+  "ltDnDiag",
+  "dnDiag",
+  "smGrid",
+  "lgGrid",
+  "cross",
+  "diagCross",
+  "trellis",
+  "wave"
+];
+new Set(K);
+function I(t, o) {
+  if (typeof t != "string") throw new Error(`${o} 必须是颜色字符串`);
+  if (/^#[0-9a-f]{6}$/i.test(t)) return;
+  const e = /^(rgb|rgba)\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(?:,\s*(\d+(?:\.\d+)?|\.\d+)\s*)?\)$/i.exec(t);
+  if (!e) throw new Error(`${o} 必须是 #RRGGBB、rgb() 或 rgba()`);
+  const r = e[5];
+  if (e[1].toLowerCase() === "rgb" != (r === void 0))
+    throw new Error(`${o} 的 rgb/rgba 参数数量不匹配`);
+  const n = e.slice(2, 5).map(Number), a = r === void 0 ? 1 : Number(r);
+  if (n.some((s) => !Number.isFinite(s) || s < 0 || s > 255) || !Number.isFinite(a) || a < 0 || a > 1)
+    throw new Error(`${o} 的通道超出范围`);
+}
+function J(t) {
+  var a;
+  const o = (a = /^#([0-9a-f]{6})$/i.exec(t)) == null ? void 0 : a[1];
+  if (o)
+    return `rgb(${[0, 2, 4].map((m) => Number.parseInt(o.slice(m, m + 2), 16)).join(",")})`;
+  const e = /^(rgb|rgba)\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*(?:,\s*(\d+(?:\.\d+)?|\.\d+)\s*)?\)$/i.exec(t), r = e.slice(2, 5).map(Number), n = e[1].toLowerCase() === "rgba" ? Math.round(Number(e[5]) * 1e3) / 1e3 : 1;
+  return n >= 1 ? `rgb(${r.join(",")})` : `rgba(${r.join(",")},${n})`;
+}
+const y = "http://schemas.openxmlformats.org/drawingml/2006/main", j = "http://schemas.openxmlformats.org/presentationml/2006/main", k = Symbol.for("@web-ppt/edit-core/extensions/v1"), F = Symbol.for("@web-ppt/edit-core/extensions-generation/v1"), T = Symbol.for("@web-ppt/edit-core/extensions-listeners/v1"), Q = /^[a-z][a-z0-9-]{0,63}$/;
+function z() {
+  const t = globalThis;
+  return t[T] ?? (t[T] = { documents: /* @__PURE__ */ new WeakMap(), pending: /* @__PURE__ */ new Map(), active: /* @__PURE__ */ new Set(), resolvers: /* @__PURE__ */ new WeakMap() });
+}
+function tt(t) {
+  if (!Q.test(t))
+    throw new Error(`编辑扩展命名空间无效：${t}`);
+}
+function ot() {
+  const t = globalThis;
+  return t[k] ?? (t[k] = /* @__PURE__ */ new Map());
+}
+function rt(t, o) {
+  var n;
+  tt(t), ot().set(t, o);
+  const e = globalThis;
+  e[F] = (e[F] ?? 0) + 1;
+  const r = new Set(z().pending.get(t));
+  if (o.migrate) for (const a of z().active) r.add(a);
+  z().pending.delete(t);
+  for (const a of r ?? [])
+    try {
+      a(t);
+    } catch (s) {
+      (n = globalThis.reportError) == null || n.call(globalThis, s);
+    }
+}
+const et = [
+  "legacyMatte",
+  "legacyPlastic",
+  "legacyMetal",
+  "legacyWireframe",
+  "matte",
+  "plastic",
+  "metal",
+  "warmMatte",
+  "translucentPowder",
+  "powder",
+  "dkEdge",
+  "softEdge",
+  "clear",
+  "flat",
+  "softmetal"
+], R = ["extrusion", "bevelTop", "bevelBottom", "bevelTopWidth", "bevelBottomWidth", "contourWidth"], X = ["extrusionColor", "contourColor"], O = ["rotX", "rotY", "rotZ"], S = (t, o, e) => typeof t == "number" && Number.isFinite(t) && t >= o && t <= e;
+function x(t) {
+  C(t, ["alpha", "grayscale", "duotone"], "图片效果");
+  const o = t, e = {};
+  if ("alpha" in o) {
+    if (!S(o.alpha, 0, 1)) throw new Error("图片不透明度必须在 0–1 之间");
+    e.alpha = Math.round(o.alpha * 1e5) / 1e5;
+  }
+  if ("grayscale" in o) {
+    if (typeof o.grayscale != "boolean") throw new Error("图片灰度开关必须是布尔值");
+    e.grayscale = o.grayscale;
+  }
+  if ("duotone" in o) {
+    if (!Array.isArray(o.duotone) || o.duotone.length !== 2) throw new Error("双色调需要暗部和亮部两种颜色");
+    e.duotone = o.duotone.map((r) => {
+      I(r, "双色调颜色");
+      const n = J(r);
+      if (n.startsWith("rgba")) throw new Error("双色调颜色必须不透明");
+      return n;
+    });
+  }
+  return e;
+}
+function M(t) {
+  C(t, [...R, ...X, ...O, "material", "camera", "fieldOfView", "zoom", "z", "lightRig", "lightDirection"], "立体效果");
+  const o = t, e = {};
+  for (const r of R) if (r in o) {
+    if (!S(o[r], 0, 2147483647 / 9525)) throw new Error("立体尺寸超出 DrawingML 范围");
+    e[r] = Math.round(o[r] * 9525) / 9525;
+  }
+  for (const r of O) if (r in o) {
+    if (!S(o[r], -360, 360)) throw new Error("立体旋转必须在 ±360° 之间");
+    e[r] = (Math.round(o[r] * 6e4) % 216e5 + 216e5) % 216e5 / 6e4;
+  }
+  for (const r of X) r in o && (I(o[r], "立体颜色"), e[r] = J(o[r]));
+  if ("material" in o) {
+    if (!et.includes(o.material)) throw new Error("未知立体材质");
+    e.material = o.material;
+  }
+  for (const r of ["camera", "lightRig", "lightDirection"]) if (r in o) {
+    if (typeof o[r] != "string" || !/^[a-zA-Z][a-zA-Z0-9]{0,63}$/.test(o[r])) throw new Error("三维场景预设名称无效");
+    e[r] = o[r];
+  }
+  for (const [r, n, a, s] of [["fieldOfView", 0, 180, 6e4], ["zoom", 1e-5, 1e3, 1e5], ["z", -2147483647 / 9525, 2147483647 / 9525, 9525]]) if (r in o) {
+    if (!S(o[r], n, a)) throw new Error("三维相机参数超出范围");
+    e[r] = Math.round(o[r] * s) / s;
+  }
+  return e;
+}
+function it(t) {
+  if (Object.keys(t).length)
+    return {
+      camera: "orthographicFront",
+      lightRig: "threePt",
+      lightDirection: "t",
+      ...t,
+      ...t.bevelTop !== void 0 ? { bevelTopWidth: t.bevelTopWidth ?? t.bevelTop } : {},
+      ...t.bevelBottom !== void 0 ? { bevelBottomWidth: t.bevelBottomWidth ?? t.bevelBottom } : {},
+      ...t.bevelTopWidth !== void 0 && t.bevelTop === void 0 ? { bevelTop: 4 } : {},
+      ...t.bevelBottomWidth !== void 0 && t.bevelBottom === void 0 ? { bevelBottom: 4 } : {},
+      ...O.some((o) => o in t) ? { rotX: t.rotX ?? 0, rotY: t.rotY ?? 0, rotZ: t.rotZ ?? 0 } : {}
+    };
+}
+function L(t) {
+  return { ...t };
+}
+function nt(t, o) {
+  var r;
+  const e = (r = t.filter) == null ? void 0 : r.replace(/grayscale\(1\)(?: contrast\(1\.1\))?\s*/g, "").trim();
+  return {
+    ...t,
+    alpha: o.alpha ?? 1,
+    duotone: o.duotone ? [...o.duotone] : void 0,
+    filter: [o.grayscale ? "grayscale(1)" : "", e].filter(Boolean).join(" ") || void 0
+  };
+}
+function V(t) {
+  var o;
+  return {
+    ...t.alpha !== void 0 ? { alpha: t.alpha } : {},
+    ...(o = t.filter) != null && o.includes("grayscale(1)") ? { grayscale: !0 } : {},
+    ...t.duotone ? { duotone: t.duotone } : {}
+  };
+}
+function at(t, o, e, r) {
+  var D;
+  const {
+    findXmlChild: n,
+    xmlElementChildren: a,
+    removeXmlChild: s,
+    insertXmlChildUnchecked: m,
+    setXmlAttribute: u,
+    insertXmlInOrder: b,
+    locateElementHost: E,
+    namespacedElement: N,
+    appendDrawingColor: P
+  } = r, v = (f, i, c = y) => n(f, { localName: i, namespaceUri: c }), w = (f) => String(Math.round(f * 9525));
+  function g(f, i, c = {}) {
+    const d = N(f, y, i);
+    for (const [h, p] of Object.entries(c)) u(d, h, p);
+    return m(f, d, v(f, "extLst")), d;
+  }
+  function U(f, i) {
+    const c = v(f, "blipFill", j), d = c && v(c, "blip");
+    if (!d) throw new Error("图片缺少可写回的 blip");
+    for (const h of a(d))
+      h.namespaceUri === y && ["alphaModFix", "grayscl", "duotone"].includes(h.localName) && s(d, h);
+    if (i.alpha !== void 0 && i.alpha < 1 && g(d, "alphaModFix", { amt: String(Math.round(i.alpha * 1e5)) }), i.grayscale && g(d, "grayscl"), i.duotone) {
+      const h = g(d, "duotone");
+      i.duotone.forEach((p) => P(h, p));
+    }
+  }
+  function Y(f, i) {
+    const c = v(f, "spPr", j);
+    if (!c) throw new Error("立体形状缺少 spPr");
+    for (const q of ["scene3d", "sp3d"]) {
+      const $ = v(c, q);
+      $ && s(c, $);
+    }
+    if (!Object.keys(i).length) return;
+    const d = N(c, y, "scene3d");
+    b(c, d);
+    const h = g(d, "camera", { prst: i.camera ?? "orthographicFront" });
+    i.fieldOfView !== void 0 && u(h, "fov", String(Math.round(i.fieldOfView * 6e4))), i.zoom !== void 0 && u(h, "zoom", String(Math.round(i.zoom * 1e5))), (i.rotX !== void 0 || i.rotY !== void 0 || i.rotZ !== void 0) && g(h, "rot", {
+      lat: String(Math.round((i.rotX ?? 0) * 6e4)),
+      lon: String(Math.round((i.rotY ?? 0) * 6e4)),
+      rev: String(Math.round((i.rotZ ?? 0) * 6e4))
+    }), g(d, "lightRig", { rig: i.lightRig ?? "threePt", dir: i.lightDirection ?? "t" });
+    const p = N(c, y, "sp3d");
+    b(c, p), i.extrusion !== void 0 && u(p, "extrusionH", w(i.extrusion)), i.z !== void 0 && u(p, "z", w(i.z)), i.contourWidth !== void 0 && u(p, "contourW", w(i.contourWidth)), i.material && u(p, "prstMaterial", i.material), (i.bevelTop !== void 0 || i.bevelTopWidth !== void 0) && g(p, "bevelT", { w: w(i.bevelTopWidth ?? i.bevelTop ?? 0), h: w(i.bevelTop ?? 4), prst: "circle" }), (i.bevelBottom !== void 0 || i.bevelBottomWidth !== void 0) && g(p, "bevelB", { w: w(i.bevelBottomWidth ?? i.bevelBottom ?? 0), h: w(i.bevelBottom ?? 4), prst: "circle" }), i.extrusionColor && P(g(p, "extrusionClr"), i.extrusionColor), i.contourColor && P(g(p, "contourClr"), i.contourColor);
+  }
+  const l = (D = o.ovr.extensions) == null ? void 0 : D.appearance, W = o.src.kind === "image" && ((l == null ? void 0 : l.picture) !== void 0 || e), A = o.src.kind === "shape" && ((l == null ? void 0 : l.scene) !== void 0 || e && o.src.scene3d);
+  if (!W && !A) return;
+  const { host: B } = E(t, o);
+  W && o.src.kind === "image" && U(B, (l == null ? void 0 : l.picture) !== void 0 ? x(JSON.parse(l.picture)) : V(o.src)), A && Y(B, (l == null ? void 0 : l.scene) !== void 0 ? M(JSON.parse(l.scene)) : L(o.src.scene3d));
+}
+const H = (t, o) => {
+  var e, r;
+  return ((r = (e = t.elements[o]) == null ? void 0 : e.ovr.extensions) == null ? void 0 : r.appearance) ?? {};
+};
+function _(t, o) {
+  var n;
+  const e = o.path[5], r = t.elements[o.path[1]];
+  if (o.path.length !== 6 || !["picture", "scene"].includes(e) || r.src.kind !== (e === "picture" ? "image" : "shape") || (n = r.src.editInfo) != null && n.requiresOriginal)
+    throw new Error("外观补丁目标或字段无效");
+  if (o.op === "set") {
+    if (typeof o.value != "string" || o.value.length > 4096) throw new Error("外观补丁值无效");
+    (e === "picture" ? x : M)(JSON.parse(o.value));
+  }
+}
+function st(t, o, e) {
+  const r = o.payload;
+  if (C(r, ["type", "id", (r == null ? void 0 : r.type) === "SetPictureFx" ? "effects" : "scene"], "外观命令"), !["SetPictureFx", "SetScene3D"].includes(r.type) || r.id !== o.id) throw new Error("外观命令身份无效");
+  const n = t.elements[r.id];
+  if (!n || t.meta.readonly || n.meta.locked || n.meta.editable !== "full") throw new Error("目标不允许修改外观");
+  const a = r.type === "SetPictureFx" ? "picture" : "scene", s = r.type === "SetPictureFx" ? r.effects : r.scene, m = ["elements", r.id, "ovr", "extensions", "appearance", a], u = H(t, r.id)[a], b = s === null ? void 0 : JSON.stringify(
+    r.type === "SetPictureFx" ? x(s) : M(s)
+  ), E = b === void 0 ? { op: "del", path: m, origin: e } : { op: "set", path: m, value: b, origin: e };
+  return _(t, E), b === u ? { forward: [], inverse: [] } : { forward: [E], inverse: [u === void 0 ? { op: "del", path: m, origin: e } : { op: "set", path: m, value: u, origin: e }] };
+}
+let G = !1;
+function lt() {
+  G || (rt("appearance", {
+    command: st,
+    validatePatch: _,
+    materialize: at,
+    supportsGenerated: (t) => t.kind === "shape" || t.kind === "image" && (!t.filter || t.filter === "grayscale(1)"),
+    project(t, o, e) {
+      const r = H(t, o);
+      return r.picture !== void 0 && e.kind === "image" ? nt(e, x(JSON.parse(r.picture))) : r.scene !== void 0 && e.kind === "shape" ? { ...e, scene3d: it(M(JSON.parse(r.scene))) } : e;
+    }
+  }), G = !0);
+}
+function dt(t) {
+  return lt(), { exec(o) {
+    return t.exec({ type: "Extension", namespace: "appearance", id: o.id, payload: o });
+  } };
+}
+function pt(t, o) {
+  const e = Z(t, o);
+  if (e.kind !== "image") throw new Error("图片效果查询需要图片");
+  return structuredClone(V(e));
+}
+function ut(t, o) {
+  const e = Z(t, o);
+  if (e.kind !== "shape") throw new Error("立体效果查询需要形状");
+  return structuredClone(L(e.scene3d));
+}
+export {
+  et as SCENE_MATERIALS,
+  dt as createAppearanceEditor,
+  pt as queryPictureFx,
+  ut as queryScene3D,
+  lt as registerAppearanceEditing
+};

package/dist/cfb/index.d.ts

@@ -0,0 +1,5 @@
+export { isCompoundFile, readCompoundFile } from './read';
+export type { CompoundFile, CompoundEntry } from './read';
+export { writeCompoundFile } from './write';
+export declare function patchCompoundFile(bytes: Uint8Array, streams: Readonly<Record<string, Uint8Array>>): Uint8Array;
+export declare function createCompoundFile(streams: Readonly<Record<string, Uint8Array>>): Uint8Array;

package/dist/cfb/read.d.ts

@@ -0,0 +1,16 @@
+export declare const END = 4294967294, FREE = 4294967295, LIMIT: number;
+export declare const view: (bytes: Uint8Array) => DataView<ArrayBufferLike>;
+export declare const isCompoundFile: (bytes: Uint8Array) => boolean;
+export interface CompoundEntry {
+    path: string;
+    name: string;
+    type: number;
+    raw: Uint8Array;
+    bytes?: Uint8Array;
+}
+export interface CompoundFile {
+    entries: CompoundEntry[];
+    header: Uint8Array;
+}
+/** 写回需要保留目录索引、存储层级及 CLSID，不能复用只按流名读取的 PPT 解析器。 */
+export declare function readCompoundFile(bytes: Uint8Array): CompoundFile;

package/dist/cfb/write.d.ts

@@ -0,0 +1,3 @@
+import type { CompoundFile } from './read';
+/** 统一输出 v3；重排扇区但保留目录身份、树指针、CLSID 和未知元数据。 */
+export declare function writeCompoundFile(file: CompoundFile): Uint8Array;

package/dist/cfb.js

@@ -0,0 +1,208 @@
+const F = (l) => new DataView(l.buffer, l.byteOffset, l.byteLength), j = (l) => [208, 207, 17, 224, 161, 177, 26, 225].every((o, i) => l[i] === o);
+function x(l) {
+  var R;
+  if (!j(l) || l.length < 512 || l.length > 268435456) throw new Error("CFB 文件无效或超限");
+  const o = l.slice(0, 512), i = F(o), A = i.getUint16(26, !0), f = i.getUint16(30, !0);
+  if (i.getUint16(28, !0) !== 65534 || !(A === 3 && f === 9 || A === 4 && f === 12) || i.getUint16(32, !0) !== 6 || i.getUint32(56, !0) !== 4096) throw new Error("CFB 扇区格式无效");
+  const n = 2 ** f, U = Math.floor(l.length / n) - 1;
+  if (l.length % n) throw new Error("CFB 扇区被截断");
+  const w = (e) => {
+    if (e >= U) throw new Error("CFB 扇区越界");
+    return l.subarray((e + 1) * n, (e + 2) * n);
+  }, c = [], u = /* @__PURE__ */ new Set();
+  for (let e = 0; e < 109; e++) {
+    const r = i.getUint32(76 + e * 4, !0);
+    r !== 4294967295 && c.push(r);
+  }
+  let g = i.getUint32(68, !0);
+  const I = i.getUint32(72, !0);
+  if (I > U) throw new Error("CFB DIFAT 数量无效");
+  for (let e = 0; e < I; e++) {
+    if (u.has(g)) throw new Error("CFB DIFAT 循环");
+    u.add(g);
+    const r = F(w(g));
+    for (let a = 0; a < n / 4 - 1; a++) {
+      const h = r.getUint32(a * 4, !0);
+      h !== 4294967295 && c.push(h);
+    }
+    g = r.getUint32(n - 4, !0);
+  }
+  if (I && g !== 4294967294 || c.length !== i.getUint32(44, !0)) throw new Error("CFB FAT 数量无效");
+  const b = [];
+  for (const e of c) {
+    if (u.has(e)) throw new Error("CFB FAT 扇区重叠");
+    u.add(e);
+    const r = F(w(e));
+    for (let a = 0; a < n; a += 4) b.push(r.getUint32(a, !0));
+  }
+  const T = (e, r, a) => {
+    const h = [], p = /* @__PURE__ */ new Set();
+    for (let B = e; B !== 4294967294; ) {
+      if (B >= a || B >= r.length || p.has(B)) throw new Error("CFB 链循环或越界");
+      p.add(B), h.push(B), B = r[B];
+    }
+    return h;
+  }, d = (e, r) => {
+    if (r === 0) return new Uint8Array();
+    const a = T(e, b, U), h = a.length * n;
+    if (r !== void 0 && (r > h || h - r >= n)) throw new Error("CFB 流长度与链不符");
+    const p = new Uint8Array(r ?? h);
+    return a.forEach((B, v) => p.set(w(B).subarray(0, Math.min(n, p.length - v * n)), v * n)), p;
+  }, m = d(i.getUint32(48, !0));
+  if (m.length > 16 * 1024 * 1024) throw new Error("CFB 目录超限");
+  const E = [];
+  for (let e = 0; e < m.length; e += 128) {
+    const r = m.slice(e, e + 128), a = F(r), h = r[66], p = a.getUint16(64, !0);
+    if (h && (![1, 2, 5].includes(h) || p < 2 || p > 64 || p % 2 || a.getUint16(p - 2, !0))) throw new Error("CFB 目录项无效");
+    let B = "";
+    for (let v = 0; h && v < p - 2; v += 2) B += String.fromCharCode(a.getUint16(v, !0));
+    E.push({ path: "", name: B, type: h, raw: r });
+  }
+  if (((R = E[0]) == null ? void 0 : R.type) !== 5) throw new Error("CFB 缺少根存储");
+  const M = /* @__PURE__ */ new Set([0]), C = [{ id: F(E[0].raw).getUint32(76, !0), parent: "", depth: 0 }];
+  for (; C.length; ) {
+    const { id: e, parent: r, depth: a } = C.pop();
+    if (e === 4294967295) continue;
+    const h = E[e];
+    if (!h || ![1, 2].includes(h.type) || M.has(e) || a > 64 || /[\/\0]/.test(h.name)) throw new Error("CFB 目录层级无效");
+    M.add(e), h.path = r + h.name;
+    const p = F(h.raw);
+    C.push({ id: p.getUint32(68, !0), parent: r, depth: a }, { id: p.getUint32(72, !0), parent: r, depth: a }), h.type === 1 && C.push({ id: p.getUint32(76, !0), parent: h.path + "/", depth: a + 1 });
+  }
+  if (E.some((e, r) => e.type && !M.has(r))) throw new Error("CFB 目录包含孤立节点");
+  const N = (e) => {
+    const r = F(e.raw), a = r.getUint32(120, !0) + (A === 4 ? r.getUint32(124, !0) * 2 ** 32 : 0);
+    if (a > 268435456) throw new Error("CFB 流超限");
+    return a;
+  }, t = d(F(E[0].raw).getUint32(116, !0), N(E[0])), s = d(i.getUint32(60, !0), i.getUint32(64, !0) * n), y = [];
+  for (let e = 0; e < s.length; e += 4) y.push(F(s).getUint32(e, !0));
+  let D = 0;
+  for (const e of E) if (e.type === 2) {
+    const r = N(e), a = F(e.raw).getUint32(116, !0);
+    if ((D += r) > 268435456) throw new Error("CFB 流总量超限");
+    if (r >= 4096 || r === 0) e.bytes = d(a, r);
+    else {
+      const h = T(a, y, Math.ceil(t.length / 64));
+      if (h.length !== Math.ceil(r / 64)) throw new Error("CFB 小流长度无效");
+      e.bytes = new Uint8Array(r), h.forEach((p, B) => e.bytes.set(t.subarray(p * 64, p * 64 + Math.min(64, r - B * 64)), B * 64));
+    }
+  }
+  return { entries: E, header: o };
+}
+function S(l) {
+  var N;
+  const o = l.entries.map((t) => ({ ...t, raw: t.raw.slice() }));
+  if (((N = o[0]) == null ? void 0 : N.type) !== 5) throw new Error("CFB 缺少根存储");
+  const i = [], A = [], f = [], n = [];
+  let U = 0;
+  const w = (t) => {
+    const s = t.length ? n.length : 4294967294;
+    for (let y = 0; y < t.length; y += 512) {
+      if ((U += 512) > 268435456) throw new Error("CFB 写入超限");
+      const D = new Uint8Array(512);
+      D.set(t.subarray(y, y + 512)), n.push(D), f.push(y + 512 < t.length ? n.length : 4294967294);
+    }
+    return s;
+  };
+  for (const t of o) if (t.type === 2) {
+    const s = t.bytes ?? new Uint8Array(), y = F(t.raw);
+    if (y.setUint32(120, s.length, !0), y.setUint32(124, 0, !0), s.length >= 4096 || !s.length) y.setUint32(116, w(s), !0);
+    else {
+      y.setUint32(116, i.length, !0);
+      for (let D = 0; D < s.length; D += 64) {
+        const R = new Uint8Array(64);
+        R.set(s.subarray(D, D + 64)), i.push(R), A.push(D + 64 < s.length ? i.length : 4294967294);
+      }
+    }
+  }
+  const c = new Uint8Array(i.length * 64);
+  i.forEach((t, s) => c.set(t, s * 64));
+  const u = F(o[0].raw);
+  u.setUint32(116, w(c), !0), u.setUint32(120, c.length, !0), u.setUint32(124, 0, !0);
+  const g = new Uint8Array(Math.ceil(A.length / 128) * 512).fill(255);
+  A.forEach((t, s) => F(g).setUint32(s * 4, t, !0));
+  const I = w(g), b = new Uint8Array(Math.ceil(o.length / 4) * 512);
+  o.forEach((t, s) => b.set(t.raw, s * 128));
+  const T = w(b), d = n.length;
+  let m = 0, E = 0;
+  for (; ; ) {
+    const t = Math.ceil((d + m + E) / 128), s = Math.max(0, Math.ceil((t - 109) / 127));
+    if (t === m && s === E) break;
+    m = t, E = s;
+  }
+  const M = new Uint8Array((1 + d + m + E) * 512);
+  if (M.length > 268435456) throw new Error("CFB 写入超限");
+  M.set(l.header.subarray(0, 512));
+  const C = F(M.subarray(0, 512));
+  M.set([208, 207, 17, 224, 161, 177, 26, 225]), C.setUint16(24, 62, !0), C.setUint16(26, 3, !0), C.setUint16(28, 65534, !0), C.setUint16(30, 9, !0), C.setUint16(32, 6, !0), M.fill(0, 34, 44), C.setUint32(44, m, !0), C.setUint32(48, T, !0), C.setUint32(56, 4096, !0), C.setUint32(60, I, !0), C.setUint32(64, g.length / 512, !0), C.setUint32(68, E ? d + m : 4294967294, !0), C.setUint32(72, E, !0);
+  for (let t = 0; t < 109; t++) C.setUint32(76 + t * 4, t < m ? d + t : 4294967295, !0);
+  n.forEach((t, s) => M.set(t, (s + 1) * 512));
+  for (let t = 0; t < m; t++) f.push(4294967293);
+  for (let t = 0; t < E; t++) f.push(4294967292);
+  M.fill(255, (d + 1) * 512), f.forEach((t, s) => F(M).setUint32((d + 1) * 512 + s * 4, t, !0));
+  for (let t = 0; t < E; t++) {
+    const s = F(M.subarray((d + m + t + 1) * 512));
+    for (let y = 0; y < 127; y++) {
+      const D = 109 + t * 127 + y;
+      s.setUint32(y * 4, D < m ? d + D : 4294967295, !0);
+    }
+    s.setUint32(508, t + 1 < E ? d + m + t + 1 : 4294967294, !0);
+  }
+  return M;
+}
+function k(l, o) {
+  const i = x(l);
+  for (const [A, f] of Object.entries(o)) {
+    const n = i.entries.find((U) => U.path === A && U.type === 2);
+    if (!n) throw new Error(`CFB 流不存在：${A}`);
+    n.bytes = f;
+  }
+  return S(i);
+}
+const L = (l) => l.split("").map((o) => {
+  const i = o.toUpperCase();
+  return i.length === 1 ? i : o;
+}).join("");
+function O(l) {
+  const o = [], i = /* @__PURE__ */ new Map(), A = (f, n, U, w) => {
+    if (!f || f.length > 31 || /[\\/:!\0]/.test(f)) throw new Error("CFB 流名称无效");
+    const c = new Uint8Array(128), u = F(c);
+    for (let g = 0; g < f.length; g++) u.setUint16(g * 2, f.charCodeAt(g), !0);
+    u.setUint16(64, (f.length + 1) * 2, !0), c[66] = U, c[67] = 1;
+    for (const g of [68, 72, 76]) u.setUint32(g, 4294967295, !0);
+    return u.setUint32(116, U === 1 ? 0 : 4294967294, !0), o.push({ name: f, path: n, type: U, raw: c, bytes: w }), o.length - 1;
+  };
+  A("Root Entry", "", 5);
+  for (const [f, n] of Object.entries(l).sort(([U], [w]) => U < w ? -1 : U > w ? 1 : 0)) {
+    const U = f.split("/");
+    let w = 0, c = "";
+    U.forEach((u, g) => {
+      const I = i.get(w) ?? [], b = g === U.length - 1, T = I.find((d) => L(o[d].name) === L(u));
+      if (T !== void 0) {
+        if (b || o[T].type !== 1) throw new Error("CFB 路径冲突");
+        w = T;
+      } else {
+        const d = A(u, c + u, b ? 2 : 1, b ? n : void 0);
+        I.push(d), i.set(w, I), w = d;
+      }
+      c += u + "/";
+    });
+  }
+  for (const [f, n] of i) {
+    n.sort((c, u) => o[c].name.length - o[u].name.length || (L(o[c].name) < L(o[u].name) ? -1 : 1));
+    const U = Math.floor(Math.log2(n.length + 1)), w = (c, u, g = 0) => {
+      if (c >= u) return 4294967295;
+      const I = c + u >>> 1, b = n[I], T = F(o[b].raw);
+      return o[b].raw[67] = g === U ? 0 : 1, T.setUint32(68, w(c, I, g + 1), !0), T.setUint32(72, w(I + 1, u, g + 1), !0), b;
+    };
+    F(o[f].raw).setUint32(76, w(0, n.length), !0);
+  }
+  return S({ entries: o, header: new Uint8Array(512) });
+}
+export {
+  O as createCompoundFile,
+  j as isCompoundFile,
+  k as patchCompoundFile,
+  x as readCompoundFile,
+  S as writeCompoundFile
+};

package/dist/change-classification.d.ts

@@ -1,8 +1,8 @@
 import type { Patch } from './commands/types';
-import type { ElementId, SlideId } from './types';
-export declare function patchElements(patches: readonly Patch[]): Set<ElementId>;
+import type { EditDoc, ElementId, SlideId } from './types';
+export declare function patchElements(patches: readonly Patch[], dirtyElements?: ReadonlySet<ElementId>): Set<ElementId>;
 export declare function affectsSlideSequence(patches: readonly Patch[]): boolean;
-export declare function renderPatchSlides(patches: readonly Patch[]): Set<SlideId>;
+export declare function renderPatchSlides(doc: EditDoc, patches: readonly Patch[], dirtySlides?: ReadonlySet<SlideId>): Set<SlideId>;
 export declare function renderPatchElements(patches: readonly Patch[], dirtyElements?: ReadonlySet<ElementId>): Set<ElementId>;
 export declare function reorderedPatchElements(patches: readonly Patch[]): Set<ElementId>;
 export declare function panePatchElements(patches: readonly Patch[]): Set<ElementId>;

package/dist/chart/category-binding.d.ts

@@ -0,0 +1,4 @@
+import type { ChartSeries, ChartFormulaBinding } from './types';
+export type CategoryOrientation = NonNullable<ChartFormulaBinding['hierarchy']>['orientation'];
+/** 墓碑系列仍保存类别矩阵的定义，删空系列后才能继续编辑和重建。 */
+export declare const categoryHierarchyBinding: (series: Readonly<Record<string, Pick<ChartSeries, "bindings">>>) => ChartFormulaBinding | undefined;

package/dist/chart/category-commands.d.ts

@@ -0,0 +1,23 @@
+import type { ExtensionPatch } from '../commands/types';
+import type { ChartCategory, ChartDatasetState, ChartPointId } from './types';
+import type { EditDoc } from '../types';
+export type CategoryPayload = {
+    op: 'set-category-label';
+    pointId: ChartPointId;
+    label: string;
+} | {
+    op: 'set-category-path';
+    pointId: ChartPointId;
+    levels: readonly (string | null)[];
+};
+export declare function categoryCommandPatches(doc: EditDoc, id: string, state: ChartDatasetState, payload: CategoryPayload, origin: string): {
+    forward: ExtensionPatch[];
+    inverse: ExtensionPatch[];
+};
+export declare function previousCategoryId(state: ChartDatasetState, id: ChartPointId): ChartPointId | null;
+export declare function assertCategoryCapacity(state: ChartDatasetState): void;
+export declare function categoryLevelOverride(doc: EditDoc, id: string, categoryId: string, level: number): string | null | undefined;
+export declare function categoryLevelPatches(doc: EditDoc, id: string, category: ChartCategory, levels: readonly (string | null)[], origin: string, previousId?: ChartPointId | null): {
+    forward: ExtensionPatch[];
+    inverse: ExtensionPatch[];
+};

package/dist/chart/category-levels.d.ts

@@ -0,0 +1,14 @@
+import type { XmlElement } from '@web-ppt/edit-core/xml';
+import type { ChartCategory, ChartDatasetState, ChartFormulaBinding, ChartPointId } from './types';
+import type { CategoryOrientation } from './category-binding';
+export declare function readCategoryLevels(holder: XmlElement | null, valueFormula: string | null, storedOrientation?: CategoryOrientation): {
+    readonly slots: Array<Array<string | null>>;
+    readonly count: number;
+    readonly hierarchy: NonNullable<ChartFormulaBinding['hierarchy']>;
+} | undefined;
+export declare function resizedCategoryFormula(binding: ChartFormulaBinding, count: number): string | null;
+/** 更高级别开始新组时，下级空槽不继承旧父组中的标签。 */
+export declare function resolvedCategoryLevels(categories: readonly ChartCategory[], depth: number): Array<Array<string | null>>;
+/** 以墓碑中的原生组首恢复跨度；并发删除相邻类别也不能把仍被使用的父组删掉。 */
+export declare function preserveCategorySpans(categories: readonly ChartDatasetState['categories'][ChartPointId][], depth: number): void;
+export declare function writeCategoryLevels(holder: XmlElement, categories: readonly ChartCategory[], binding: ChartFormulaBinding): void;

package/dist/chart/category-matrix.d.ts

@@ -0,0 +1,2 @@
+import type { ChartDatasetState } from './types';
+export declare function reconcileCategoryMatrix(state: ChartDatasetState): void;

package/dist/chart/category-value.d.ts

@@ -0,0 +1,2 @@
+/** 只有 JS/Excel/OOXML 往返词法完全不变时，类别标签才继续按数值写入。 */
+export declare function canonicalNumericCategories(values: readonly string[]): number[] | null;

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

@@ -0,0 +1,13 @@
+import type { ChartDatasetState } from './types';
+import type { WorkbookMap } from './workbook';
+export type CategoryWorkbookCell = {
+    readonly kind: 'string' | 'number';
+    readonly value: string | number | null;
+};
+type Values = Pick<ChartDatasetState, 'categories' | 'series'>;
+export declare function categoryWorkbookWrites(source: Values, planned: Values, parts: Readonly<Record<string, Uint8Array>>, map: WorkbookMap): {
+    sheet: string;
+    cells: Map<string, CategoryWorkbookCell>;
+} | undefined;
+export declare function assertCategoryWorkbookSource(state: Values, parts: Readonly<Record<string, Uint8Array>>, map: WorkbookMap): void;
+export {};

package/dist/chart/commands.d.ts

@@ -0,0 +1,28 @@
+import type { Editor } from '../editor';
+import type { ElementId } from '../types';
+import type { ChartPlotKind, ChartPointId, ChartSeriesId } from './types';
+type Editable = Pick<Editor, 'doc' | 'exec'>;
+export interface ChartDataEditor {
+    setSeriesName(chartId: ElementId, seriesId: ChartSeriesId, name: string): void;
+    setCategoryLabel(chartId: ElementId, pointId: ChartPointId, label: string): void;
+    setCategoryPath(chartId: ElementId, pointId: ChartPointId, levels: readonly (string | null)[]): void;
+    setCategoryLevel(chartId: ElementId, pointId: ChartPointId, level: number, value: string | null): void;
+    setValue(chartId: ElementId, seriesId: ChartSeriesId, pointId: ChartPointId, value: number | null): void;
+    setPoint(chartId: ElementId, seriesId: ChartSeriesId, pointId: ChartPointId, value: {
+        value?: number | null;
+        x?: number | null;
+        size?: number | null;
+    }): void;
+    addSeries(chartId: ElementId, name: string, plotKind?: ChartPlotKind): ChartSeriesId;
+    removeSeries(chartId: ElementId, seriesId: ChartSeriesId): void;
+    addCategory(chartId: ElementId, labelOrPath: string | readonly (string | null)[]): ChartPointId;
+    removeCategory(chartId: ElementId, pointId: ChartPointId): void;
+    addPoint(chartId: ElementId, seriesId: ChartSeriesId, value: {
+        value: number | null;
+        x?: number | null;
+        size?: number | null;
+    }): ChartPointId;
+    removePoint(chartId: ElementId, seriesId: ChartSeriesId, pointId: ChartPointId): void;
+}
+export declare function chartDataEditor(editor: Editable): ChartDataEditor;
+export {};

package/dist/chart/context.d.ts

@@ -0,0 +1,12 @@
+import { sourcePartBytes } from '@web-ppt/edit-core';
+import type { ChartEnv } from '@web-ppt/core';
+import type { EditDoc, ElementId } from '../types';
+export declare const chartSourceBytes: typeof sourcePartBytes;
+export type ChartRelationships = Record<string, {
+    type: string;
+    target: string;
+    external?: true;
+}>;
+export declare function chartRelationshipPart(part: string): string;
+export declare function chartRelationships(doc: EditDoc, part: string): ChartRelationships;
+export declare function chartRenderContext(doc: EditDoc, id: ElementId, part: string): ChartEnv;