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

package/dist/insertion-invariants.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc, ElementRecord } from './types';
+/** 结构 Patch 是公开 JSON seam；内嵌 OOXML 闭包不能依赖命令曾经正确地产生过它。 */
+export declare function assertElementInsertionSource(doc: EditDoc, record: ElementRecord): void;
+/** 每个宿主 part 只建一次索引，避免多图片页面的全局模型校验退化成 O(n²)。 */
+export declare function assertActiveRelationshipTargets(doc: EditDoc): void;

package/dist/layout-assets.d.ts

@@ -0,0 +1,10 @@
+import type { Slide } from '@web-ppt/core';
+import type { EditDoc } from './types';
+interface LayoutAsset {
+    readonly mime: string;
+    readonly data: Uint8Array;
+}
+/** 只兑现 Schema 的资源槽；普通字符串即使形似内部 token 也必须逐字保留。 */
+export declare function hydrateLayoutSlideAssets(doc: EditDoc, slide: Slide, assets: readonly LayoutAsset[]): Slide;
+export declare function releaseLayoutAssetCache(doc: EditDoc): void;
+export {};

package/dist/layout-projection.d.ts

@@ -0,0 +1,24 @@
+import type { GeomSpec, ShapeCreationDefaults, Slide, SlideElement, TableCreationDefaults, TextBody } from '@web-ppt/core';
+import type { EditDoc, ElementId, SlideId } from './types';
+export declare function resolvedLayoutSlide(doc: EditDoc, slideId: SlideId): Slide | null;
+export declare function releaseLayoutProjectionCache(doc: EditDoc): void;
+export declare function changedLayout(doc: EditDoc, slideId: SlideId): import("@web-ppt/core").SlideLayoutTemplate | undefined;
+export declare function currentShapeDefaults(doc: EditDoc, slideId: SlideId): ShapeCreationDefaults | undefined;
+export declare function currentTableDefaults(doc: EditDoc, slideId: SlideId): TableCreationDefaults | undefined;
+/** 页面级 showMasterSp=false 必须继续压过新关系指向的版式/母版。 */
+export declare function projectedLayoutElements(doc: EditDoc, slideId: SlideId): SlideElement[];
+export declare function projectionContentIds(doc: EditDoc, slideId: SlideId): ElementId[];
+/** 目标没有宿主且来源变换本来只靠旧版式继承时，保存必须把有效 frame 降级为页面直设。 */
+export declare function layoutFallbackElementIds(doc: EditDoc, slideId: SlideId): ElementId[];
+/** 预设几何可由语义重建；继承 custGeom 由保存层从来源版式逐节点复制。 */
+export declare function layoutFallbackGeometry(record: EditDoc['elements'][string]): GeomSpec | undefined;
+/** 整页 SVG 可混入没有 EditDoc 身份的目标版式静态节点；DOM 绑定按同一投影序列跳过它们。 */
+export declare function projectedSlideElementIds(doc: EditDoc, slideId: SlideId): Array<ElementId | null>;
+/** 尚无 slide 内容节点的目标占位符只供 edit interaction layer 提示，不进入业务渲染。 */
+export declare function unboundLayoutPlaceholders(doc: EditDoc, slideId: SlideId): SlideElement[];
+export declare function rebasedElementBase(doc: EditDoc, slideId: SlideId, record: EditDoc['elements'][string]): {
+    base: SlideElement;
+    geom?: GeomSpec;
+};
+/** 文字命令从当前版式的重基值起步，不能把旧版式有效值烘进首次覆盖。 */
+export declare function rebasedTextBase(doc: EditDoc, slideId: SlideId, id: ElementId): TextBody | null;

package/dist/layout-text-rebase.d.ts

@@ -0,0 +1,3 @@
+import type { TextBody } from '@web-ppt/core';
+/** 仅替换没有页面直设位的字段；页面文字内容和 run 身份始终留在 source。 */
+export declare function rebaseLayoutText(source: TextBody | null, target: TextBody | null): TextBody | null;

package/dist/model-invariants.d.ts

@@ -0,0 +1,5 @@
+import type { EditDoc, ElementId } from './types';
+/** 全局模型已在 Editor 构造时验证；事务只需重验其 patch 能影响的元素不变量。 */
+export declare function validateEditElements(doc: EditDoc, ids: Iterable<ElementId>): void;
+/** 在编辑会话入口验证全局结构；命令提交只需验证自己可能改变的局部不变量。 */
+export declare function validateEditDoc(doc: EditDoc): void;

package/dist/notes-part.d.ts

@@ -0,0 +1,2 @@
+/** notesSlide 允许非规范文件名；只约束它必须位于 notesSlides 目录且是 XML part。 */
+export declare const isNotesPart: (part: string) => boolean;

package/dist/opc/bytes.d.ts

@@ -0,0 +1 @@
+export declare function equalBytes(left: Uint8Array, right: Uint8Array): boolean;

package/dist/opc/crc32.d.ts

@@ -0,0 +1 @@
+export declare function crc32(bytes: Uint8Array): number;

package/dist/opc/index.d.ts

@@ -0,0 +1,3 @@
+/** ZIP 扫描与压缩只在保存时需要，独立入口避免增加常驻编辑模型体积。 */
+export { disposeOpcPackage, patchOpcPackage } from './patch';
+export type { OpcFallbackReason, OpcPartChanges, OpcPatchResult, OpcSaveMode } from './types';

package/dist/opc/package-owner.d.ts

@@ -0,0 +1,4 @@
+import type { OpcPackage } from '@web-ppt/core';
+/** 返回可释放、但仍能 structuredClone 的纯数据句柄。 */
+export declare function createOwnedPackage(bytes: Uint8Array, parts: Readonly<Record<string, Uint8Array>>, assets?: OpcPackage['assets']): OpcPackage;
+export declare function releaseOwnedPackage(pkg: OpcPackage): void;

package/dist/opc/patch.d.ts

@@ -0,0 +1,6 @@
+import type { OpcPackage } from '@web-ppt/core';
+import type { OpcPartChanges, OpcPatchResult } from './types';
+/** 释放脱离 EditDoc 单独持有的保存结果；原始解析包仍由 Presentation.dispose() 释放。 */
+export declare function disposeOpcPackage(pkg: OpcPackage): void;
+/** 在原 OPC 包上应用 part 级修改；空修改必须保持整包字节身份。 */
+export declare function patchOpcPackage(source: OpcPackage, changes: OpcPartChanges): OpcPatchResult;

package/dist/opc/types.d.ts

@@ -0,0 +1,12 @@
+import type { OpcPackage } from '@web-ppt/core';
+export type OpcPartChanges = Readonly<Record<string, Uint8Array | null>>;
+export type OpcSaveMode = 'identity' | 'passthrough' | 'repacked';
+export type OpcFallbackReason = 'archive-comment' | 'data-descriptor' | 'encrypted-entry' | 'legacy-filename' | 'multi-disk' | 'unsupported-compression' | 'zip64';
+export interface OpcPatchResult {
+    readonly bytes: Uint8Array;
+    readonly package: OpcPackage;
+    readonly mode: OpcSaveMode;
+    readonly fallbackReason: OpcFallbackReason | null;
+    readonly preservedEntries: number;
+    readonly rewrittenEntries: number;
+}

package/dist/opc/zip.d.ts

@@ -0,0 +1,28 @@
+import type { OpcFallbackReason } from './types';
+export interface ZipEntry {
+    readonly name: string;
+    readonly flags: number;
+    readonly method: number;
+    readonly compressedSize: number;
+    readonly uncompressedSize: number;
+    readonly localOffset: number;
+    readonly localRaw: Uint8Array;
+    readonly centralRaw: Uint8Array;
+}
+export interface ZipArchive {
+    readonly entries: readonly ZipEntry[];
+}
+export interface RewrittenZip {
+    readonly bytes: Uint8Array;
+    readonly preservedEntries: number;
+    readonly rewrittenEntries: number;
+}
+export declare class ZipPassthroughUnsupported extends Error {
+    readonly reason: OpcFallbackReason;
+    constructor(reason: OpcFallbackReason, message: string);
+}
+/** 读取标准单磁盘中央目录；不支持的特性后续由上层选择整包重压。 */
+export declare function parseZipArchive(bytes: Uint8Array): ZipArchive;
+export declare function rewriteZipArchive(archive: ZipArchive, changes: ReadonlyMap<string, Uint8Array | null>): RewrittenZip;
+/** 不支持直通时从已解压 part 确定性重建；不复用任何可能含不兼容语义的 ZIP 元数据。 */
+export declare function repackZipParts(parts: Readonly<Record<string, Uint8Array>>, changes: ReadonlyMap<string, Uint8Array | null>): RewrittenZip;

package/dist/opc-owner-protocol.d.ts

@@ -0,0 +1,5 @@
+import type { OpcPackage } from '@web-ppt/core';
+/** 仅供保存包所有者与 EditDoc 共享；dispose 必须保持非枚举，避免破坏 structuredClone。 */
+export interface OwnedOpcPackage extends OpcPackage {
+    dispose?: () => void;
+}

package/dist/opc.js

@@ -0,0 +1,5 @@
+import { d as c, p as e } from "./patch-DO8497wO.js";
+export {
+  c as disposeOpcPackage,
+  e as patchOpcPackage
+};

package/dist/paragraph-properties.d.ts

@@ -0,0 +1,4 @@
+import type { TextRange } from './commands/types';
+import type { EditDoc, ParagraphPropertiesState, TableCellAddress } from './types';
+/** 工具栏只查询 headless 文档；DOM 选区只是把范围传进来。 */
+export declare function queryParaProps(doc: EditDoc, id: string, range: TextRange, cell?: TableCellAddress): ParagraphPropertiesState;

package/dist/paragraph-property-schema.d.ts

@@ -0,0 +1,4 @@
+import type { ParagraphPropertyOverrides } from './types';
+export declare const PARAGRAPH_PROPERTY_FIELDS: readonly ["align", "lineHeight", "spaceBefore", "spaceAfter", "marginLeft", "indent"];
+export declare const PARAGRAPH_ALIGNMENTS: readonly ["left", "center", "right", "justify"];
+export declare function assertParagraphPropertyOverrides(value: ParagraphPropertyOverrides, label: string): void;

package/dist/patch-DO8497wO.js

@@ -0,0 +1,322 @@
+import { deflateSync as j } from "fflate";
+function N(t, n) {
+  return t.length === n.length && t.every((e, r) => e === n[r]);
+}
+const q = new Uint8Array(), X = Object.freeze(/* @__PURE__ */ Object.create(null)), y = Object.freeze(/* @__PURE__ */ Object.create(null));
+function H(t, n, e = y) {
+  let r = t, o = n, s = e, i = !1;
+  const a = {
+    format: "pptx",
+    get bytes() {
+      return r;
+    },
+    get parts() {
+      return o;
+    },
+    get assets() {
+      return s;
+    },
+    get disposed() {
+      return i;
+    }
+  };
+  return Object.defineProperty(a, "dispose", {
+    value: () => {
+      r = q, o = X, s = y, i = !0;
+    }
+  }), Object.freeze(a);
+}
+function J(t) {
+  var n;
+  (n = t.dispose) == null || n.call(t);
+}
+const D = new Uint32Array(256);
+for (let t = 0; t < 256; t++) {
+  let n = t;
+  for (let e = 0; e < 8; e++) n = n & 1 ? 3988292384 ^ n >>> 1 : n >>> 1;
+  D[t] = n >>> 0;
+}
+function _(t) {
+  let n = 4294967295;
+  for (const e of t) n = D[(n ^ e) & 255] ^ n >>> 8;
+  return (n ^ 4294967295) >>> 0;
+}
+const M = 33639248, C = 101010256, G = 67324752, K = 101075792, Q = 117853008, L = 1, tt = new TextDecoder("utf-8", { fatal: !0 }), et = new TextEncoder(), nt = /* @__PURE__ */ new Set([
+  "7z",
+  "aac",
+  "avi",
+  "eot",
+  "gif",
+  "gz",
+  "jpeg",
+  "jpg",
+  "m4a",
+  "m4v",
+  "mov",
+  "mp3",
+  "mp4",
+  "mpeg",
+  "mpg",
+  "ogg",
+  "otf",
+  "png",
+  "ttf",
+  "webm",
+  "webp",
+  "woff",
+  "woff2",
+  "zip"
+]), Y = (t, n) => t < n ? -1 : t > n ? 1 : 0;
+class p extends Error {
+  constructor(n, e) {
+    super(e), this.reason = n, this.name = "ZipPassthroughUnsupported";
+  }
+}
+const m = (t) => new DataView(t.buffer, t.byteOffset, t.byteLength);
+function Z(t, n, e, r) {
+  if (!Number.isSafeInteger(n) || !Number.isSafeInteger(e) || n < 0 || e < 0 || n + e > t.length)
+    throw new Error(`ZIP ${r} 超出文件边界`);
+}
+function rt(t) {
+  if (t.length < 22) throw new Error("ZIP 缺少 EOCD");
+  const n = m(t), e = Math.max(0, t.length - 22 - 65535);
+  for (let r = t.length - 22; r >= e; r--) {
+    if (n.getUint32(r, !0) !== C) continue;
+    const o = n.getUint16(r + 20, !0);
+    if (r + 22 + o === t.length) return r;
+  }
+  throw new Error("ZIP 缺少有效 EOCD");
+}
+function ot(t, n) {
+  if (!(n & 2048) && t.some((e) => e >= 128))
+    throw new p("legacy-filename", "ZIP 使用非 UTF-8 文件名，不能安全映射 OPC part");
+  try {
+    return tt.decode(t);
+  } catch {
+    throw new Error("ZIP 文件名不是有效 UTF-8");
+  }
+}
+function T(t, n, e, r, o) {
+  Z(t, n, e, o);
+  const s = m(t), i = n + e;
+  let a = n;
+  for (; a < i; ) {
+    if (a + 4 > i) throw new Error(`ZIP ${o} 字段头不完整`);
+    const h = s.getUint16(a, !0), d = s.getUint16(a + 2, !0);
+    if (a + 4 + d > i) throw new Error(`ZIP ${o} 字段超出 extra 边界`);
+    if (h === r) return !0;
+    a += 4 + d;
+  }
+  return !1;
+}
+function st(t) {
+  const n = rt(t), e = m(t), r = e.getUint16(n + 4, !0), o = e.getUint16(n + 6, !0), s = e.getUint16(n + 8, !0), i = e.getUint16(n + 10, !0), a = e.getUint32(n + 12, !0), h = e.getUint32(n + 16, !0), d = e.getUint16(n + 20, !0);
+  if (n >= 20 && e.getUint32(n - 20, !0) === Q)
+    throw new p("zip64", "ZIP64 定位器不支持直通");
+  if (r || o || s !== i)
+    throw new p("multi-disk", "ZIP 多磁盘格式不支持直通");
+  if (i === 65535 || a === 4294967295 || h === 4294967295)
+    throw new p("zip64", "ZIP64 不支持直通");
+  if (d)
+    throw new p("archive-comment", "带存档注释的 ZIP 不支持直通");
+  Z(t, h, a, "中央目录");
+  const U = [], l = /* @__PURE__ */ new Set();
+  let c = h;
+  for (let u = 0; u < i; u++) {
+    if (Z(t, c, 46, "中央目录条目"), e.getUint32(c, !0) !== M) throw new Error("ZIP 中央目录签名错误");
+    const f = e.getUint16(c + 8, !0), w = e.getUint16(c + 10, !0), P = e.getUint32(c + 20, !0), I = e.getUint32(c + 24, !0), S = e.getUint16(c + 28, !0), R = e.getUint16(c + 30, !0), V = e.getUint16(c + 32, !0), $ = e.getUint16(c + 34, !0), g = e.getUint32(c + 42, !0), z = 46 + S + R + V;
+    if (Z(t, c, z, "中央目录条目"), P === 4294967295 || I === 4294967295 || g === 4294967295 || $ === 65535)
+      throw new p("zip64", "ZIP64 条目不支持直通");
+    if ($) throw new p("multi-disk", "跨磁盘 ZIP 条目不支持直通");
+    if (f & 1) throw new p("encrypted-entry", "ZIP 加密条目不支持直通");
+    if (f & 8)
+      throw new p("data-descriptor", "ZIP 数据描述符不支持直通");
+    if (w !== 0 && w !== 8)
+      throw new p("unsupported-compression", `ZIP 压缩方法 ${w} 不支持直通`);
+    const x = t.subarray(c + 46, c + 46 + S);
+    if (T(
+      t,
+      c + 46 + S,
+      R,
+      L,
+      `中央目录 extra ${u + 1}`
+    ))
+      throw new p("zip64", "ZIP64 中央目录 extra 不支持直通");
+    const E = ot(x, f);
+    if (l.has(E)) throw new Error(`ZIP 存在重复条目：${E}`);
+    if (l.add(E), Z(t, g, 30, `本地头 ${E}`), e.getUint32(g, !0) !== G) throw new Error(`ZIP 本地头签名错误：${E}`);
+    const A = e.getUint16(g + 6, !0), O = e.getUint16(g + 8, !0);
+    if (A & 1)
+      throw new p("encrypted-entry", "ZIP 本地头声明加密，不支持直通");
+    if (A & 8)
+      throw new p("data-descriptor", "ZIP 本地头使用数据描述符，不支持直通");
+    if (O !== 0 && O !== 8)
+      throw new p(
+        "unsupported-compression",
+        `ZIP 本地头压缩方法 ${O} 不支持直通`
+      );
+    if (A !== f || O !== w || e.getUint32(g + 14, !0) !== e.getUint32(c + 16, !0) || e.getUint32(g + 18, !0) !== P || e.getUint32(g + 22, !0) !== I)
+      throw new Error(`ZIP 本地头与中央目录元数据不一致：${E}`);
+    const v = e.getUint16(g + 26, !0), b = e.getUint16(g + 28, !0);
+    if (T(
+      t,
+      g + 30 + v,
+      b,
+      L,
+      `本地头 extra ${E}`
+    ))
+      throw new p("zip64", "ZIP64 本地头 extra 不支持直通");
+    const k = 30 + v + b + P;
+    Z(t, g, k, `本地条目 ${E}`);
+    const W = t.subarray(g + 30, g + 30 + v);
+    if (!N(W, x)) throw new Error(`ZIP 本地头与中央目录名称不一致：${E}`);
+    U.push({
+      name: E,
+      flags: f,
+      method: w,
+      compressedSize: P,
+      uncompressedSize: I,
+      localOffset: g,
+      localRaw: t.subarray(g, g + k),
+      centralRaw: t.subarray(c, c + z)
+    }), c += z;
+  }
+  if (c !== h + a) throw new Error("ZIP 中央目录包含未识别记录");
+  if (c !== n)
+    throw c + 4 <= t.length && e.getUint32(c, !0) === K ? new p("zip64", "ZIP64 EOCD 记录不支持直通") : new Error("ZIP 中央目录与 EOCD 之间存在未识别记录");
+  return { entries: U };
+}
+function B(t) {
+  const n = t.reduce((o, s) => o + s.length, 0), e = new Uint8Array(n);
+  let r = 0;
+  for (const o of t)
+    e.set(o, r), r += o.length;
+  return e;
+}
+function ct(t, n) {
+  if (n.length > 4294967295) throw new Error(`OPC part 过大，需要 ZIP64：${t.name}`);
+  const e = t.method === 8 ? j(n, { level: 6 }) : n;
+  if (e.length > 4294967295) throw new Error(`OPC part 压缩后过大，需要 ZIP64：${t.name}`);
+  const r = t.localRaw.length - t.compressedSize, o = new Uint8Array(r + e.length);
+  o.set(t.localRaw.subarray(0, r)), o.set(e, r);
+  const s = m(o), i = _(n);
+  return s.setUint32(14, i, !0), s.setUint32(18, e.length, !0), s.setUint32(22, n.length, !0), { bytes: o, checksum: i, compressedSize: e.length, uncompressedSize: n.length };
+}
+function it(t, n, e) {
+  const r = t.centralRaw.slice(), o = m(r);
+  return n && (o.setUint32(16, n.checksum, !0), o.setUint32(20, n.compressedSize, !0), o.setUint32(24, n.uncompressedSize, !0)), o.setUint32(42, e, !0), r;
+}
+function lt(t, n) {
+  const e = [], r = [];
+  let o = 0, s = 0, i = 0;
+  const a = new Set(t.entries.map((f) => f.name));
+  for (const f of t.entries) {
+    const w = n.get(f.name);
+    if (w === null) {
+      i++;
+      continue;
+    }
+    const P = w ? ct(f, w) : null, I = (P == null ? void 0 : P.bytes) ?? f.localRaw;
+    e.push(I), r.push(it(f, P, o)), o += I.length, w ? i++ : s++;
+  }
+  const h = [...n].filter(([f, w]) => !a.has(f) && w !== null).sort(([f], [w]) => Y(f, w));
+  for (const [f, w] of h) {
+    const P = F(f, w, o);
+    e.push(P.local), r.push(P.central), o += P.local.length, i++;
+  }
+  const d = e.length;
+  if (d > 65535) throw new Error("保存结果需要 ZIP64 条目计数，当前不支持");
+  const U = o, l = r.reduce((f, w) => f + w.length, 0);
+  if (U > 4294967295 || l > 4294967295)
+    throw new Error("保存结果需要 ZIP64 偏移，当前不支持");
+  const c = new Uint8Array(22), u = m(c);
+  return u.setUint32(0, C, !0), u.setUint16(8, d, !0), u.setUint16(10, d, !0), u.setUint32(12, l, !0), u.setUint32(16, U, !0), { bytes: B([...e, ...r, c]), preservedEntries: s, rewrittenEntries: i };
+}
+function ut(t, n) {
+  const e = Object.keys(t), r = new Set(e), o = e.filter((l) => n.get(l) !== null);
+  if (o.push(...[...n].filter(([l, c]) => !r.has(l) && c !== null).map(([l]) => l).sort(Y)), o.length > 65535) throw new Error("重压结果需要 ZIP64 条目计数，当前不支持");
+  const s = [], i = [];
+  let a = 0;
+  for (const l of o) {
+    const c = n.get(l) ?? t[l];
+    if (!c) throw new Error(`重压时缺少 OPC part：${l}`);
+    const u = F(l, c, a);
+    s.push(u.local), i.push(u.central), a += u.local.length;
+  }
+  const h = i.reduce((l, c) => l + c.length, 0);
+  if (a > 4294967295 || h > 4294967295) throw new Error("重压结果需要 ZIP64 偏移，当前不支持");
+  const d = new Uint8Array(22), U = m(d);
+  return U.setUint32(0, C, !0), U.setUint16(8, o.length, !0), U.setUint16(10, o.length, !0), U.setUint32(12, h, !0), U.setUint32(16, a, !0), {
+    bytes: B([...s, ...i, d]),
+    preservedEntries: 0,
+    rewrittenEntries: o.length
+  };
+}
+function F(t, n, e) {
+  if (n.length > 4294967295) throw new Error(`OPC part 过大，需要 ZIP64：${t}`);
+  const r = et.encode(t);
+  if (r.length > 65535) throw new Error(`OPC part 路径过长：${t.slice(0, 80)}`);
+  const o = t.slice(t.lastIndexOf(".") + 1).toLowerCase(), s = nt.has(o) ? null : j(n, { level: 6 }), i = s !== null && s.length < n.length, a = i ? 8 : 0, h = i ? s : n;
+  if (h.length > 4294967295) throw new Error(`OPC part 压缩后过大，需要 ZIP64：${t}`);
+  const d = _(n), U = new Uint8Array(30 + r.length + h.length), l = m(U);
+  l.setUint32(0, G, !0), l.setUint16(4, 20, !0), l.setUint16(6, 2048, !0), l.setUint16(8, a, !0), l.setUint16(12, 33, !0), l.setUint32(14, d, !0), l.setUint32(18, h.length, !0), l.setUint32(22, n.length, !0), l.setUint16(26, r.length, !0), U.set(r, 30), U.set(h, 30 + r.length);
+  const c = new Uint8Array(46 + r.length), u = m(c);
+  return u.setUint32(0, M, !0), u.setUint16(4, 798, !0), u.setUint16(6, 20, !0), u.setUint16(8, 2048, !0), u.setUint16(10, a, !0), u.setUint16(14, 33, !0), u.setUint32(16, d, !0), u.setUint32(20, h.length, !0), u.setUint32(24, n.length, !0), u.setUint16(28, r.length, !0), u.setUint32(42, e, !0), c.set(r, 46), { local: U, central: c };
+}
+function at(t, n) {
+  const e = /* @__PURE__ */ new Map();
+  for (const [r, o] of Object.entries(n)) {
+    ft(r);
+    const s = t.parts[r];
+    o === null ? s && e.set(r, null) : (!s || !N(s, o)) && e.set(r, o.slice());
+  }
+  return e;
+}
+function ft(t) {
+  const n = t.split("/");
+  if (!t || t.startsWith("/") || t.endsWith("/") || t.includes("\\") || n.some((e) => !e || e === "." || e === ".."))
+    throw new Error(`非法 OPC part 路径：${t}`);
+}
+function wt(t, n, e) {
+  const r = /* @__PURE__ */ Object.create(null);
+  for (const [s, i] of Object.entries(t.parts))
+    e.get(s) !== null && (r[s] = e.get(s) ?? i);
+  for (const [s, i] of e) i !== null && (r[s] = i);
+  Object.freeze(r);
+  const o = Object.freeze(Object.fromEntries(Object.entries(t.assets ?? {}).filter(([, s]) => !!s.sourcePart && !!r[s.sourcePart] && !e.has(s.sourcePart))));
+  return H(n, r, o);
+}
+function gt(t) {
+  J(t);
+}
+function pt(t, n) {
+  if (t.disposed) throw new Error("OPC 原包已释放，不能保存");
+  const e = at(t, n);
+  if (e.size) {
+    let r, o = null;
+    try {
+      r = lt(st(t.bytes), e);
+    } catch (s) {
+      if (!(s instanceof p)) throw s;
+      o = s.reason, r = ut(t.parts, e);
+    }
+    return {
+      ...r,
+      package: wt(t, r.bytes, e),
+      mode: o ? "repacked" : "passthrough",
+      fallbackReason: o
+    };
+  }
+  return {
+    bytes: t.bytes,
+    package: t,
+    mode: "identity",
+    fallbackReason: null,
+    preservedEntries: Object.keys(t.parts).length,
+    rewrittenEntries: 0
+  };
+}
+export {
+  gt as d,
+  pt as p
+};

package/dist/projection.d.ts

@@ -0,0 +1,19 @@
+import type { Slide, SlideElement } from '@web-ppt/core';
+import type { EditDoc, ElementId, ProjectionInvalidation, SlideId } from './types';
+/** 文档换包或释放后，投影不能继续持有旧资源 URL 与整页 Schema。 */
+export declare function releaseProjectionCache(doc: EditDoc): void;
+export declare function effectiveElement(doc: EditDoc, id: ElementId): SlideElement;
+export declare function toSlide(doc: EditDoc, id: SlideId): Slide;
+export declare function slideOfElement(doc: EditDoc, id: ElementId): SlideId;
+/** 元素变化会沿组祖先传播到所属页；无需扫描或比较整份文档。 */
+export declare function invalidateElement(doc: EditDoc, id: ElementId): ProjectionInvalidation;
+export declare function invalidateSlide(doc: EditDoc, id: SlideId): ProjectionInvalidation;
+/** 备注属于页面数据但不参与 SVG；只清投影缓存，不把画布视图列为脏页。 */
+export declare function invalidateSlideData(doc: EditDoc, id: SlideId): ProjectionInvalidation;
+/** 页面树 patch 发生在页面存在性变化之前，不能要求目标页已经在模型中。 */
+export declare function invalidateSlideStructure(doc: EditDoc, id: SlideId, elements: readonly ElementId[]): ProjectionInvalidation;
+/** 页序变化只改变动态字段；沿字段父链失效，避免框架订阅者收到整段页尾的元素更新。 */
+export declare function invalidateSlideSequence(doc: EditDoc, start: number): ProjectionInvalidation;
+/** 结构 patch 的根可能尚不存在；以外部父节点失效并清掉整棵树的旧投影缓存。 */
+export declare function invalidateElementStructure(doc: EditDoc, ids: readonly ElementId[], parent: SlideId | ElementId): ProjectionInvalidation;
+export declare function invalidateAll(doc: EditDoc): ProjectionInvalidation;

package/dist/recovery-identity.d.ts

@@ -0,0 +1,35 @@
+import type { Patch } from './commands/types';
+import type { EditDoc, EditIdentity } from './types';
+export declare function assertRecoveryIdentity(value: unknown, prefix: string, sequence: number): asserts value is EditIdentity;
+export interface RecoveryIdentityFloor {
+    nextSlide: number;
+    nextElement: number;
+    readonly nextSpid: Map<string, number>;
+    readonly checkedSpidSources: Set<string>;
+    readonly createdParts: Set<string>;
+    readonly knownElements: Map<string, string | null>;
+    readonly owningParts: Map<string, string | null>;
+    readonly knownSlides: Map<string, string>;
+    readonly occupiedSlideParts: Set<string>;
+    readonly usedPresentationSlideIds: Set<number>;
+    readonly usedPresentationRelationships: Set<string>;
+    readonly allowedNotesBindings: Map<string, Set<string>>;
+    readonly currentNotesBindings: Map<string, string | null>;
+    readonly occupiedNotesParts: Set<string>;
+    readonly inheritedSources: Map<string, Set<string>>;
+    readonly slideIdPattern: RegExp;
+    readonly elementIdPattern: RegExp;
+    readonly rowIdPattern: RegExp;
+    nextSlidePart?: number;
+    nextNotesPart?: number;
+    nextPresentationSlideId?: number;
+    nextPresentationRelationship?: number;
+    minimumNewSlidePart?: number;
+    minimumNewPresentationSlideId?: number;
+    minimumNewPresentationRelationship?: number;
+    minimumNewNotesPart?: number;
+    checkedSlideSource: boolean;
+    checkedNotesSource: boolean;
+}
+export declare function createRecoveryIdentityFloor(doc: EditDoc): RecoveryIdentityFloor;
+export declare function assertRecoveryIdentityFloor(doc: EditDoc, floor: RecoveryIdentityFloor, next: EditIdentity, patches: readonly Patch[], sequence: number): void;

package/dist/recovery-types.d.ts

@@ -0,0 +1,30 @@
+import type { EditIdentity } from './types';
+import type { Patch, Selection } from './commands/types';
+export type RecoveryFrameSource = 'transaction' | 'undo' | 'redo' | 'selection' | 'savepoint';
+/** Patch 里的 blob URL 会被保留 token 取代；这里保存 token 可重绑的原包身份或字节。 */
+export interface RecoveryAssetReference {
+    readonly url: string;
+    readonly mime: string;
+    readonly sourcePart?: string;
+    /** 无原包 part 的派生资源才内联；普通源图片不会把字节重复写进每帧。 */
+    readonly data?: string;
+}
+/** 一帧只描述已经生效的结果；资源 URL 已 token 化，存储层不需要理解命令或历史内部状态。 */
+export interface RecoveryFrame {
+    readonly version: 1;
+    readonly sequence: number;
+    readonly source: RecoveryFrameSource;
+    readonly patches: Patch[];
+    readonly assets?: readonly RecoveryAssetReference[];
+    readonly identity: EditIdentity;
+    readonly selection: Selection;
+    readonly dirty: boolean;
+    readonly label: string;
+    readonly time: number;
+}
+export type RecoverySubscriber = (frame: RecoveryFrame) => void;
+export interface RecoveryRestoreResult {
+    readonly selection: Selection;
+    readonly dirty: boolean;
+    readonly sequence: number;
+}

package/dist/recovery.d.ts

@@ -0,0 +1,28 @@
+import type { Patch, Selection } from './commands/types';
+import type { RecoveryFrame, RecoveryFrameSource, RecoveryRestoreResult, RecoverySubscriber } from './recovery-types';
+import type { EditDoc, EditIdentity } from './types';
+export declare const EDITOR_RECOVERY_VERSION: 1;
+export declare function cloneRecoveryFrame(frame: RecoveryFrame): RecoveryFrame;
+/** 只应在新解析文档建立 Editor 前调用；成功时一次性交换模型，失败时目标保持原样。 */
+export declare function restoreRecoveryFrames(doc: EditDoc, frames: readonly RecoveryFrame[]): RecoveryRestoreResult;
+interface EmitRecoveryFrame {
+    readonly source: RecoveryFrameSource;
+    readonly patches: readonly Patch[];
+    readonly doc: EditDoc;
+    readonly identity: EditIdentity;
+    readonly selection: Selection;
+    readonly dirty: boolean;
+    readonly label: string;
+    readonly time: number;
+}
+/** 序号在调用观察者前分配；同步重入编辑也不会颠倒日志因果顺序。 */
+export declare class RecoveryJournal {
+    private readonly subscribers;
+    private readonly pending;
+    private dispatching;
+    private sequence;
+    constructor(sequence?: number);
+    subscribe(subscriber: RecoverySubscriber): () => void;
+    emit(input: EmitRecoveryFrame): void;
+}
+export {};

package/dist/run-links.d.ts

@@ -0,0 +1,3 @@
+import type { TextRange } from './commands/types';
+import type { EditDoc, RunLinkState, TableCellAddress } from './types';
+export declare function queryRunLink(doc: EditDoc, id: string, range: TextRange, cell?: TableCellAddress): RunLinkState;

package/dist/run-properties.d.ts

@@ -0,0 +1,4 @@
+import type { TextRange } from './commands/types';
+import type { EditDoc, RunPropertiesState, TableCellAddress } from './types';
+/** 面板与框架适配层只从 headless 文档查询，不把格式真相藏进 DOM。 */
+export declare function queryRunProps(doc: EditDoc, id: string, range: TextRange, cell?: TableCellAddress): RunPropertiesState;

package/dist/run-property-schema.d.ts

@@ -0,0 +1,3 @@
+import type { RunPropertyOverrides } from './types';
+export declare const RUN_PROPERTY_FIELDS: readonly ["font", "size", "b", "i", "u", "strike", "link"];
+export declare function assertRunPropertyOverrides(value: unknown, label: string, allowEmpty?: boolean): asserts value is RunPropertyOverrides;

package/dist/save/animation.d.ts

@@ -0,0 +1,6 @@
+import type { EditAnimationStep, EditDoc, SlideRecord } from '../types';
+import type { XmlDocument } from '../xml/types';
+/** 删除对象必须保留式清理所有已知/未知行为和 build 对该 spid 的引用。 */
+export declare function removeSlideAnimationTargets(document: XmlDocument, sourceSpids: readonly number[]): void;
+/** bldLst 按 spid/grpId 描述图表/SmartArt build，不依赖 cTn id；本票只替换 tnLst。 */
+export declare function patchSlideAnimations(document: XmlDocument, doc: EditDoc, record: SlideRecord, steps: readonly EditAnimationStep[]): void;

package/dist/save/background-image.d.ts

@@ -0,0 +1,8 @@
+import type { Fill } from '@web-ppt/core';
+import type { XmlElement } from '../xml/types';
+type ImageFill = Extract<Fill, {
+    type: 'image';
+}>;
+/** 已有 blipFill 原位修改，未知属性、效果和扩展不因编辑已知字段而丢失。 */
+export declare function patchBackgroundImageFill(properties: XmlElement, image: ImageFill, relationshipId: string, preserveSourceDpi: boolean): void;
+export {};

package/dist/save/clipboard-parts.d.ts

@@ -0,0 +1,11 @@
+import { relationshipPartFor } from '../clipboard-source';
+import type { EditDoc, ElementInsertionRelationship, ElementInsertionResource } from '../types';
+export interface MediaPackageParts {
+    readonly relationships: Map<string, ElementInsertionRelationship[]>;
+    readonly resources: Map<string, ElementInsertionResource>;
+}
+export declare function mediaPackageParts(doc: EditDoc): MediaPackageParts;
+export declare function patchRelationshipPart(source: Uint8Array | undefined, relationships: readonly ElementInsertionRelationship[]): Uint8Array;
+export declare function patchContentTypes(source: Uint8Array | undefined, resources: readonly ElementInsertionResource[]): Uint8Array;
+export declare function resourceBytes(resource: ElementInsertionResource): Uint8Array;
+export { relationshipPartFor };

package/dist/save/drawing-color.d.ts

@@ -0,0 +1,2 @@
+import type { XmlElement } from '../xml/types';
+export declare function appendDrawingColor(parent: XmlElement, value: string): void;