@coco-vexel/coco-office 0.0.0-stage → 1.0.1

package/dist/shared.cjs

@@ -0,0 +1,105 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/shared/index.ts
+var shared_exports = {};
+__export(shared_exports, {
+  InMemorySnapshotStorage: () => InMemorySnapshotStorage
+});
+module.exports = __toCommonJS(shared_exports);
+
+// src/shared/snapshot/in-memory.ts
+var _InMemorySnapshotStorage = class _InMemorySnapshotStorage {
+  constructor() {
+    /** 嵌套 Map:docId → (snapshotId → entry) */
+    __publicField(this, "store", /* @__PURE__ */ new Map());
+  }
+  getBucket(docId, createIfMissing) {
+    let bucket = this.store.get(docId);
+    if (!bucket && createIfMissing) {
+      bucket = /* @__PURE__ */ new Map();
+      this.store.set(docId, bucket);
+    }
+    return bucket;
+  }
+  async save(docId, id, payload, meta) {
+    const bucket = this.getBucket(docId, true);
+    bucket.set(id, { payload, pinned: (meta == null ? void 0 : meta.pinned) === true });
+  }
+  async load(docId, id) {
+    const bucket = this.getBucket(docId, false);
+    const entry = bucket == null ? void 0 : bucket.get(id);
+    if (!entry) {
+      throw new Error(`snapshot not found: docId=${docId} id=${id}`);
+    }
+    return entry.payload;
+  }
+  async delete(docId, id) {
+    var _a;
+    (_a = this.getBucket(docId, false)) == null ? void 0 : _a.delete(id);
+  }
+  async list(docId) {
+    const bucket = this.getBucket(docId, false);
+    if (!bucket) return [];
+    const infos = Array.from(bucket.values()).map((entry) => {
+      const base = entry.payload.info;
+      return entry.pinned ? __spreadProps(__spreadValues({}, base), { pinned: true }) : base;
+    });
+    return infos.sort((a, b) => {
+      const na = extractIdNum(a.id);
+      const nb = extractIdNum(b.id);
+      if (na !== null && nb !== null) return na - nb;
+      return a.id.localeCompare(b.id);
+    });
+  }
+  async clear(docId) {
+    this.store.delete(docId);
+  }
+};
+__name(_InMemorySnapshotStorage, "InMemorySnapshotStorage");
+var InMemorySnapshotStorage = _InMemorySnapshotStorage;
+function extractIdNum(id) {
+  const m = /^snap-(\d+)$/.exec(id);
+  return m ? Number(m[1]) : null;
+}
+__name(extractIdNum, "extractIdNum");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InMemorySnapshotStorage
+});
+//# sourceMappingURL=shared.cjs.map

package/dist/shared.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/index.ts","../src/shared/snapshot/in-memory.ts"],"sourcesContent":["export * from './snapshot/index.js';\n","/**\n * InMemorySnapshotStorage —— 默认实现,进程内 Map,刷新即失。\n *\n * 适用:测试 / CLI / 不要持久化的场景。宿主持久化请自行实现 SnapshotStorageAdapter\n * 并通过 `LoadOptions.snapshotStorage` 或 `WordDocument.setDefaultSnapshotStorage`\n * 注入(详见 docs/03.2 §8.5)。\n *\n * docId 命名空间隔离由嵌套 Map 实现:{ docId → { snapshotId → entry } }。\n *\n * **pinned 支持(#108,docs/03.2 §3.3)**:\n * - `save` 接受 `meta.pinned`,存进 entry 并在 `list` 的 SnapshotInfo 上还原\n * - `list` 里 `pinned === true` 的快照标志 SnapshotApi 的 FIFO 跳过它们\n */\nimport type { SnapshotInfo, SnapshotPayload, SnapshotStorageAdapter } from './types.js';\n\n/** Map 里的条目:payload + pinned bit(bit 与 payload 解耦,便于未来扩展 meta) */\ninterface StoredEntry {\n  payload: SnapshotPayload;\n  pinned: boolean;\n}\n\nexport class InMemorySnapshotStorage implements SnapshotStorageAdapter {\n  /** 嵌套 Map:docId → (snapshotId → entry) */\n  private readonly store = new Map<string, Map<string, StoredEntry>>();\n\n  private getBucket(docId: string, createIfMissing: boolean): Map<string, StoredEntry> | undefined {\n    let bucket = this.store.get(docId);\n    if (!bucket && createIfMissing) {\n      bucket = new Map();\n      this.store.set(docId, bucket);\n    }\n    return bucket;\n  }\n\n  async save(\n    docId: string,\n    id: string,\n    payload: SnapshotPayload,\n    meta?: { pinned?: boolean },\n  ): Promise<void> {\n    const bucket = this.getBucket(docId, true)!;\n    bucket.set(id, { payload, pinned: meta?.pinned === true });\n  }\n\n  async load(docId: string, id: string): Promise<SnapshotPayload> {\n    const bucket = this.getBucket(docId, false);\n    const entry = bucket?.get(id);\n    if (!entry) {\n      throw new Error(`snapshot not found: docId=${docId} id=${id}`);\n    }\n    return entry.payload;\n  }\n\n  async delete(docId: string, id: string): Promise<void> {\n    // 幂等:不存在时静默\n    this.getBucket(docId, false)?.delete(id);\n  }\n\n  async list(docId: string): Promise<SnapshotInfo[]> {\n    const bucket = this.getBucket(docId, false);\n    if (!bucket) return [];\n    // [契约遵守] 按 id 自增数字升序返回(snap-0, snap-1, ...);\n    // SnapshotStorageAdapter.list 契约要求,FIFO 淘汰依赖此顺序。\n    // 截取 suffix 数字比较,非数字走字典序回退。\n    // pinned 体现在 SnapshotInfo.pinned 字段(不参与排序,仅作为 FIFO 淘汰的筛选器)\n    const infos = Array.from(bucket.values()).map((entry) => {\n      // 重新构造 info 以携带 pinned(payload.info 来自 SnapshotApi,本 adapter 持有 pinned 真相)\n      const base = entry.payload.info;\n      return entry.pinned ? { ...base, pinned: true } : base;\n    });\n    return infos.sort((a, b) => {\n      const na = extractIdNum(a.id);\n      const nb = extractIdNum(b.id);\n      if (na !== null && nb !== null) return na - nb;\n      return a.id.localeCompare(b.id);\n    });\n  }\n\n  async clear(docId: string): Promise<void> {\n    this.store.delete(docId);\n  }\n}\n\n/** 从 'snap-123' 提取 123;非 'snap-\\d+' 模式返 null */\nfunction extractIdNum(id: string): number | null {\n  const m = /^snap-(\\d+)$/.exec(id);\n  return m ? Number(m[1]) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACqBO,IAAM,2BAAN,MAAM,yBAA0D;AAAA,EAAhE;AAEL;AAAA,wBAAiB,SAAQ,oBAAI,IAAsC;AAAA;AAAA,EAE3D,UAAU,OAAe,iBAAgE;AAC/F,QAAI,SAAS,KAAK,MAAM,IAAI,KAAK;AACjC,QAAI,CAAC,UAAU,iBAAiB;AAC9B,eAAS,oBAAI,IAAI;AACjB,WAAK,MAAM,IAAI,OAAO,MAAM;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,KACJ,OACA,IACA,SACA,MACe;AACf,UAAM,SAAS,KAAK,UAAU,OAAO,IAAI;AACzC,WAAO,IAAI,IAAI,EAAE,SAAS,SAAQ,6BAAM,YAAW,KAAK,CAAC;AAAA,EAC3D;AAAA,EAEA,MAAM,KAAK,OAAe,IAAsC;AAC9D,UAAM,SAAS,KAAK,UAAU,OAAO,KAAK;AAC1C,UAAM,QAAQ,iCAAQ,IAAI;AAC1B,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,MAAM,6BAA6B,KAAK,OAAO,EAAE,EAAE;AAAA,IAC/D;AACA,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,MAAM,OAAO,OAAe,IAA2B;AArDzD;AAuDI,eAAK,UAAU,OAAO,KAAK,MAA3B,mBAA8B,OAAO;AAAA,EACvC;AAAA,EAEA,MAAM,KAAK,OAAwC;AACjD,UAAM,SAAS,KAAK,UAAU,OAAO,KAAK;AAC1C,QAAI,CAAC,OAAQ,QAAO,CAAC;AAKrB,UAAM,QAAQ,MAAM,KAAK,OAAO,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU;AAEvD,YAAM,OAAO,MAAM,QAAQ;AAC3B,aAAO,MAAM,SAAS,iCAAK,OAAL,EAAW,QAAQ,KAAK,KAAI;AAAA,IACpD,CAAC;AACD,WAAO,MAAM,KAAK,CAAC,GAAG,MAAM;AAC1B,YAAM,KAAK,aAAa,EAAE,EAAE;AAC5B,YAAM,KAAK,aAAa,EAAE,EAAE;AAC5B,UAAI,OAAO,QAAQ,OAAO,KAAM,QAAO,KAAK;AAC5C,aAAO,EAAE,GAAG,cAAc,EAAE,EAAE;AAAA,IAChC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAM,OAA8B;AACxC,SAAK,MAAM,OAAO,KAAK;AAAA,EACzB;AACF;AA5DuE;AAAhE,IAAM,0BAAN;AA+DP,SAAS,aAAa,IAA2B;AAC/C,QAAM,IAAI,eAAe,KAAK,EAAE;AAChC,SAAO,IAAI,OAAO,EAAE,CAAC,CAAC,IAAI;AAC5B;AAHS;","names":[]}

package/dist/shared.d.cts

@@ -0,0 +1,31 @@
+import { S as SnapshotStorageAdapter, a as SnapshotPayload, b as SnapshotInfo } from './types-C2vQfM-b.cjs';
+export { C as ChangeLog } from './types-C2vQfM-b.cjs';
+
+/**
+ * InMemorySnapshotStorage —— 默认实现,进程内 Map,刷新即失。
+ *
+ * 适用:测试 / CLI / 不要持久化的场景。宿主持久化请自行实现 SnapshotStorageAdapter
+ * 并通过 `LoadOptions.snapshotStorage` 或 `WordDocument.setDefaultSnapshotStorage`
+ * 注入(详见 docs/03.2 §8.5)。
+ *
+ * docId 命名空间隔离由嵌套 Map 实现:{ docId → { snapshotId → entry } }。
+ *
+ * **pinned 支持(#108,docs/03.2 §3.3)**:
+ * - `save` 接受 `meta.pinned`,存进 entry 并在 `list` 的 SnapshotInfo 上还原
+ * - `list` 里 `pinned === true` 的快照标志 SnapshotApi 的 FIFO 跳过它们
+ */
+
+declare class InMemorySnapshotStorage implements SnapshotStorageAdapter {
+    /** 嵌套 Map:docId → (snapshotId → entry) */
+    private readonly store;
+    private getBucket;
+    save(docId: string, id: string, payload: SnapshotPayload, meta?: {
+        pinned?: boolean;
+    }): Promise<void>;
+    load(docId: string, id: string): Promise<SnapshotPayload>;
+    delete(docId: string, id: string): Promise<void>;
+    list(docId: string): Promise<SnapshotInfo[]>;
+    clear(docId: string): Promise<void>;
+}
+
+export { InMemorySnapshotStorage, SnapshotInfo, SnapshotPayload, SnapshotStorageAdapter };

package/dist/shared.d.ts

@@ -0,0 +1,31 @@
+import { S as SnapshotStorageAdapter, a as SnapshotPayload, b as SnapshotInfo } from './types-C2vQfM-b.js';
+export { C as ChangeLog } from './types-C2vQfM-b.js';
+
+/**
+ * InMemorySnapshotStorage —— 默认实现,进程内 Map,刷新即失。
+ *
+ * 适用:测试 / CLI / 不要持久化的场景。宿主持久化请自行实现 SnapshotStorageAdapter
+ * 并通过 `LoadOptions.snapshotStorage` 或 `WordDocument.setDefaultSnapshotStorage`
+ * 注入(详见 docs/03.2 §8.5)。
+ *
+ * docId 命名空间隔离由嵌套 Map 实现:{ docId → { snapshotId → entry } }。
+ *
+ * **pinned 支持(#108,docs/03.2 §3.3)**:
+ * - `save` 接受 `meta.pinned`,存进 entry 并在 `list` 的 SnapshotInfo 上还原
+ * - `list` 里 `pinned === true` 的快照标志 SnapshotApi 的 FIFO 跳过它们
+ */
+
+declare class InMemorySnapshotStorage implements SnapshotStorageAdapter {
+    /** 嵌套 Map:docId → (snapshotId → entry) */
+    private readonly store;
+    private getBucket;
+    save(docId: string, id: string, payload: SnapshotPayload, meta?: {
+        pinned?: boolean;
+    }): Promise<void>;
+    load(docId: string, id: string): Promise<SnapshotPayload>;
+    delete(docId: string, id: string): Promise<void>;
+    list(docId: string): Promise<SnapshotInfo[]>;
+    clear(docId: string): Promise<void>;
+}
+
+export { InMemorySnapshotStorage, SnapshotInfo, SnapshotPayload, SnapshotStorageAdapter };

package/dist/shared.js

@@ -0,0 +1,81 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/shared/snapshot/in-memory.ts
+var _InMemorySnapshotStorage = class _InMemorySnapshotStorage {
+  constructor() {
+    /** 嵌套 Map:docId → (snapshotId → entry) */
+    __publicField(this, "store", /* @__PURE__ */ new Map());
+  }
+  getBucket(docId, createIfMissing) {
+    let bucket = this.store.get(docId);
+    if (!bucket && createIfMissing) {
+      bucket = /* @__PURE__ */ new Map();
+      this.store.set(docId, bucket);
+    }
+    return bucket;
+  }
+  async save(docId, id, payload, meta) {
+    const bucket = this.getBucket(docId, true);
+    bucket.set(id, { payload, pinned: (meta == null ? void 0 : meta.pinned) === true });
+  }
+  async load(docId, id) {
+    const bucket = this.getBucket(docId, false);
+    const entry = bucket == null ? void 0 : bucket.get(id);
+    if (!entry) {
+      throw new Error(`snapshot not found: docId=${docId} id=${id}`);
+    }
+    return entry.payload;
+  }
+  async delete(docId, id) {
+    var _a;
+    (_a = this.getBucket(docId, false)) == null ? void 0 : _a.delete(id);
+  }
+  async list(docId) {
+    const bucket = this.getBucket(docId, false);
+    if (!bucket) return [];
+    const infos = Array.from(bucket.values()).map((entry) => {
+      const base = entry.payload.info;
+      return entry.pinned ? __spreadProps(__spreadValues({}, base), { pinned: true }) : base;
+    });
+    return infos.sort((a, b) => {
+      const na = extractIdNum(a.id);
+      const nb = extractIdNum(b.id);
+      if (na !== null && nb !== null) return na - nb;
+      return a.id.localeCompare(b.id);
+    });
+  }
+  async clear(docId) {
+    this.store.delete(docId);
+  }
+};
+__name(_InMemorySnapshotStorage, "InMemorySnapshotStorage");
+var InMemorySnapshotStorage = _InMemorySnapshotStorage;
+function extractIdNum(id) {
+  const m = /^snap-(\d+)$/.exec(id);
+  return m ? Number(m[1]) : null;
+}
+__name(extractIdNum, "extractIdNum");
+export {
+  InMemorySnapshotStorage
+};
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/snapshot/in-memory.ts"],"sourcesContent":["/**\n * InMemorySnapshotStorage —— 默认实现,进程内 Map,刷新即失。\n *\n * 适用:测试 / CLI / 不要持久化的场景。宿主持久化请自行实现 SnapshotStorageAdapter\n * 并通过 `LoadOptions.snapshotStorage` 或 `WordDocument.setDefaultSnapshotStorage`\n * 注入(详见 docs/03.2 §8.5)。\n *\n * docId 命名空间隔离由嵌套 Map 实现:{ docId → { snapshotId → entry } }。\n *\n * **pinned 支持(#108,docs/03.2 §3.3)**:\n * - `save` 接受 `meta.pinned`,存进 entry 并在 `list` 的 SnapshotInfo 上还原\n * - `list` 里 `pinned === true` 的快照标志 SnapshotApi 的 FIFO 跳过它们\n */\nimport type { SnapshotInfo, SnapshotPayload, SnapshotStorageAdapter } from './types.js';\n\n/** Map 里的条目:payload + pinned bit(bit 与 payload 解耦,便于未来扩展 meta) */\ninterface StoredEntry {\n  payload: SnapshotPayload;\n  pinned: boolean;\n}\n\nexport class InMemorySnapshotStorage implements SnapshotStorageAdapter {\n  /** 嵌套 Map:docId → (snapshotId → entry) */\n  private readonly store = new Map<string, Map<string, StoredEntry>>();\n\n  private getBucket(docId: string, createIfMissing: boolean): Map<string, StoredEntry> | undefined {\n    let bucket = this.store.get(docId);\n    if (!bucket && createIfMissing) {\n      bucket = new Map();\n      this.store.set(docId, bucket);\n    }\n    return bucket;\n  }\n\n  async save(\n    docId: string,\n    id: string,\n    payload: SnapshotPayload,\n    meta?: { pinned?: boolean },\n  ): Promise<void> {\n    const bucket = this.getBucket(docId, true)!;\n    bucket.set(id, { payload, pinned: meta?.pinned === true });\n  }\n\n  async load(docId: string, id: string): Promise<SnapshotPayload> {\n    const bucket = this.getBucket(docId, false);\n    const entry = bucket?.get(id);\n    if (!entry) {\n      throw new Error(`snapshot not found: docId=${docId} id=${id}`);\n    }\n    return entry.payload;\n  }\n\n  async delete(docId: string, id: string): Promise<void> {\n    // 幂等:不存在时静默\n    this.getBucket(docId, false)?.delete(id);\n  }\n\n  async list(docId: string): Promise<SnapshotInfo[]> {\n    const bucket = this.getBucket(docId, false);\n    if (!bucket) return [];\n    // [契约遵守] 按 id 自增数字升序返回(snap-0, snap-1, ...);\n    // SnapshotStorageAdapter.list 契约要求,FIFO 淘汰依赖此顺序。\n    // 截取 suffix 数字比较,非数字走字典序回退。\n    // pinned 体现在 SnapshotInfo.pinned 字段(不参与排序,仅作为 FIFO 淘汰的筛选器)\n    const infos = Array.from(bucket.values()).map((entry) => {\n      // 重新构造 info 以携带 pinned(payload.info 来自 SnapshotApi,本 adapter 持有 pinned 真相)\n      const base = entry.payload.info;\n      return entry.pinned ? { ...base, pinned: true } : base;\n    });\n    return infos.sort((a, b) => {\n      const na = extractIdNum(a.id);\n      const nb = extractIdNum(b.id);\n      if (na !== null && nb !== null) return na - nb;\n      return a.id.localeCompare(b.id);\n    });\n  }\n\n  async clear(docId: string): Promise<void> {\n    this.store.delete(docId);\n  }\n}\n\n/** 从 'snap-123' 提取 123;非 'snap-\\d+' 模式返 null */\nfunction extractIdNum(id: string): number | null {\n  const m = /^snap-(\\d+)$/.exec(id);\n  return m ? Number(m[1]) : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAqBO,IAAM,2BAAN,MAAM,yBAA0D;AAAA,EAAhE;AAEL;AAAA,wBAAiB,SAAQ,oBAAI,IAAsC;AAAA;AAAA,EAE3D,UAAU,OAAe,iBAAgE;AAC/F,QAAI,SAAS,KAAK,MAAM,IAAI,KAAK;AACjC,QAAI,CAAC,UAAU,iBAAiB;AAC9B,eAAS,oBAAI,IAAI;AACjB,WAAK,MAAM,IAAI,OAAO,MAAM;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,KACJ,OACA,IACA,SACA,MACe;AACf,UAAM,SAAS,KAAK,UAAU,OAAO,IAAI;AACzC,WAAO,IAAI,IAAI,EAAE,SAAS,SAAQ,6BAAM,YAAW,KAAK,CAAC;AAAA,EAC3D;AAAA,EAEA,MAAM,KAAK,OAAe,IAAsC;AAC9D,UAAM,SAAS,KAAK,UAAU,OAAO,KAAK;AAC1C,UAAM,QAAQ,iCAAQ,IAAI;AAC1B,QAAI,CAAC,OAAO;AACV,YAAM,IAAI,MAAM,6BAA6B,KAAK,OAAO,EAAE,EAAE;AAAA,IAC/D;AACA,WAAO,MAAM;AAAA,EACf;AAAA,EAEA,MAAM,OAAO,OAAe,IAA2B;AArDzD;AAuDI,eAAK,UAAU,OAAO,KAAK,MAA3B,mBAA8B,OAAO;AAAA,EACvC;AAAA,EAEA,MAAM,KAAK,OAAwC;AACjD,UAAM,SAAS,KAAK,UAAU,OAAO,KAAK;AAC1C,QAAI,CAAC,OAAQ,QAAO,CAAC;AAKrB,UAAM,QAAQ,MAAM,KAAK,OAAO,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU;AAEvD,YAAM,OAAO,MAAM,QAAQ;AAC3B,aAAO,MAAM,SAAS,iCAAK,OAAL,EAAW,QAAQ,KAAK,KAAI;AAAA,IACpD,CAAC;AACD,WAAO,MAAM,KAAK,CAAC,GAAG,MAAM;AAC1B,YAAM,KAAK,aAAa,EAAE,EAAE;AAC5B,YAAM,KAAK,aAAa,EAAE,EAAE;AAC5B,UAAI,OAAO,QAAQ,OAAO,KAAM,QAAO,KAAK;AAC5C,aAAO,EAAE,GAAG,cAAc,EAAE,EAAE;AAAA,IAChC,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAM,OAA8B;AACxC,SAAK,MAAM,OAAO,KAAK;AAAA,EACzB;AACF;AA5DuE;AAAhE,IAAM,0BAAN;AA+DP,SAAS,aAAa,IAA2B;AAC/C,QAAM,IAAI,eAAe,KAAK,EAAE;AAChC,SAAO,IAAI,OAAO,EAAE,CAAC,CAAC,IAAI;AAC5B;AAHS;","names":[]}

package/dist/types-BVkkdcfh.d.cts

@@ -0,0 +1,54 @@
+/**
+ * Package / Part 数据模型 —— CocoOffice 的 OOXML 统一内存表示。
+ *
+ * 设计背景:docs/01 §3.2(Package 抽象)、docs/03 §13.4(dirty 追踪)。
+ *
+ * 一个 Part 要么是 XML 类(`xmlDom` 有值、`bytes` 无值),
+ * 要么是二进制类(`bytes` 有值、`xmlDom` 无值)。
+ * 这种"择一"约束由 `createXmlPart` / `createBinaryPart` 工厂函数在构造期守住。
+ */
+/** OOXML Package 内的单一 Part:路径 + MIME contentType + payload + dirty 元信息 */
+interface Part {
+    /** Part 路径,相对包根,**无前导斜杠**。例:'word/document.xml' */
+    readonly path: string;
+    /**
+     * MIME content type。例:'application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml'
+     * 二进制 part 如图片:'image/png'
+     */
+    readonly contentType: string;
+    /**
+     * XML 类 part 的 DOM(slimdom Document 兼容 lib.dom Document)。
+     * 与 `bytes` 互斥 —— 仅择一赋值。
+     */
+    xmlDom?: Document;
+    /**
+     * 二进制 part 的字节(如图片、字体)。
+     * 与 `xmlDom` 互斥 —— 仅择一赋值。
+     */
+    bytes?: Uint8Array;
+    /**
+     * 装载时保留的原始字节。`_dirty === false` 时,`toZip` / `toFlatOpc` 直接复用此字节,零 serialize。
+     * 二进制 part 初始化时通常 === `bytes`。
+     * 装载后首次被改动(markDirty 置 true)前为只读快照。
+     */
+    _originalBytes?: Uint8Array;
+    /**
+     * 修改标记。
+     * - `false`:自装载以来未变更,输出时可复用 `_originalBytes`
+     * - `true`:已被改过,输出时需要重新序列化
+     *
+     * 由 Plan.apply 或外部工具通过 `markDirty(part)` 置 true;读操作不应改变它。
+     */
+    _dirty: boolean;
+}
+/**
+ * 归一化后的 Package:路径到 Part 的 Map。
+ *
+ * - 外部 API(zip / Flat OPC)经 adapter 归一到 Package,内部只面对这个形态
+ * - 同一 Package 内 path 唯一,由 Map 天然保证
+ */
+interface Package {
+    parts: Map<string, Part>;
+}
+
+export type { Part as P, Package as a };

package/dist/types-BVkkdcfh.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Package / Part 数据模型 —— CocoOffice 的 OOXML 统一内存表示。
+ *
+ * 设计背景:docs/01 §3.2(Package 抽象)、docs/03 §13.4(dirty 追踪)。
+ *
+ * 一个 Part 要么是 XML 类(`xmlDom` 有值、`bytes` 无值),
+ * 要么是二进制类(`bytes` 有值、`xmlDom` 无值)。
+ * 这种"择一"约束由 `createXmlPart` / `createBinaryPart` 工厂函数在构造期守住。
+ */
+/** OOXML Package 内的单一 Part:路径 + MIME contentType + payload + dirty 元信息 */
+interface Part {
+    /** Part 路径,相对包根,**无前导斜杠**。例:'word/document.xml' */
+    readonly path: string;
+    /**
+     * MIME content type。例:'application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml'
+     * 二进制 part 如图片:'image/png'
+     */
+    readonly contentType: string;
+    /**
+     * XML 类 part 的 DOM(slimdom Document 兼容 lib.dom Document)。
+     * 与 `bytes` 互斥 —— 仅择一赋值。
+     */
+    xmlDom?: Document;
+    /**
+     * 二进制 part 的字节(如图片、字体)。
+     * 与 `xmlDom` 互斥 —— 仅择一赋值。
+     */
+    bytes?: Uint8Array;
+    /**
+     * 装载时保留的原始字节。`_dirty === false` 时,`toZip` / `toFlatOpc` 直接复用此字节,零 serialize。
+     * 二进制 part 初始化时通常 === `bytes`。
+     * 装载后首次被改动(markDirty 置 true)前为只读快照。
+     */
+    _originalBytes?: Uint8Array;
+    /**
+     * 修改标记。
+     * - `false`:自装载以来未变更,输出时可复用 `_originalBytes`
+     * - `true`:已被改过,输出时需要重新序列化
+     *
+     * 由 Plan.apply 或外部工具通过 `markDirty(part)` 置 true;读操作不应改变它。
+     */
+    _dirty: boolean;
+}
+/**
+ * 归一化后的 Package:路径到 Part 的 Map。
+ *
+ * - 外部 API(zip / Flat OPC)经 adapter 归一到 Package,内部只面对这个形态
+ * - 同一 Package 内 path 唯一,由 Map 天然保证
+ */
+interface Package {
+    parts: Map<string, Part>;
+}
+
+export type { Part as P, Package as a };

package/dist/types-C2vQfM-b.d.cts

@@ -0,0 +1,102 @@
+/**
+ * 快照子系统 —— 与文档类型无关的存储层类型定义。
+ *
+ * 设计背景:docs/03.2-快照系统.md(尤其 §2 API 形态、§8 存储适配层)。
+ *
+ * 层次:
+ *   - 本文件:SnapshotInfo / ChangeLog / SnapshotPayload / SnapshotStorageAdapter
+ *   - `./in-memory.ts`:默认 InMemorySnapshotStorage 实现
+ *   - 后续 #21 在 WordDocument 上挂 SnapshotApi 子 API,消费本适配器
+ */
+/** 消费方通过 `wordDoc.snapshots.recordChange()` 累加的变更日志项 */
+interface ChangeLog {
+    /** 时间戳,Date.now() */
+    timestamp: number;
+    /** 工具名,例 'replace_paragraphs' */
+    toolName: string;
+    /** 工具自定义摘要(结构由消费方决定,可 JSON.stringify) */
+    summary?: unknown;
+}
+/** 快照元信息(`list` 只返回这些,不含 parts 字节) */
+interface SnapshotInfo {
+    /** 自增 id,'snap-0' / 'snap-1' / ... */
+    id: string;
+    /** 时间戳,Date.now() */
+    timestamp: number;
+    /** 用户提供的 take 原因 */
+    reason?: string;
+    /** 用户提供的 take 详细结构 */
+    details?: unknown;
+    /** 当前 OOXML Package 全部 parts 的稳定 SHA-256 指纹。旧快照可缺省。 */
+    contentHash?: string;
+    /** 逻辑去重域；仅同一 dedupeKey 的快照之间允许复用 id。 */
+    dedupeKey?: string;
+    /** take 时一次性吸入的主线程 changelog */
+    changesCaptured: ChangeLog[];
+    /**
+     * Pinned 标记(#108,docs/03.2 §3.3):true 时该快照不参与 FIFO 淘汰。
+     *
+     * - `undefined` / `false` 等价,均视为普通快照
+     * - 用于保护 `WordAgent.create` 的 session-start 快照不被 plugin 的
+     *   常规 take 挤掉
+     * - 向后兼容:旧 payload / 旧 adapter 未带该字段时视为未 pinned
+     */
+    pinned?: boolean;
+}
+/** 快照完整载荷(info + parts 字节) */
+interface SnapshotPayload {
+    info: SnapshotInfo;
+    parts: Array<{
+        path: string;
+        contentType: string;
+        bytes: Uint8Array;
+    }>;
+}
+/**
+ * 存储适配器接口。宿主(WPS 面板 / Electron main / 浏览器 / Node server)提供实现。
+ *
+ * **语义承诺**:
+ * - `save` / `load` 捆装 info + parts 为一次写入 / 一次读取
+ * - `list` **仅返 meta**(SnapshotInfo 数组),不加载 parts(避免大档进主线程)
+ * - `delete(docId, id)`:不存在时不抛错,幂等
+ * - `clear(docId)`:清除该 docId 下所有快照,不影响其它 docId
+ * - 所有方法 async(允许底层存储异步)
+ *
+ * **pinned 支持(#108)**:
+ * - `save` 接受可选 `meta.pinned`,adapter 需把该 bit 与 payload 一起持久化,
+ *   并在 `list` 返回的 `SnapshotInfo.pinned` 中还原
+ * - 不支持 pinned 的旧 adapter 仍然合法:`list` 返回的 `pinned`
+ *   默认为 `undefined`,被 SnapshotApi 视为未 pinned(向后兼容)
+ * - 具体的 "FIFO 淘汰时跳过 pinned" 逻辑在 **SnapshotApi 主线程侧**,
+ *   adapter 只负责存取该 bit
+ *
+ * SDK 不做:重试 / 超时 / 并发互斥。异常透传给消费方。
+ */
+interface SnapshotStorageAdapter {
+    /**
+     * 保存快照。
+     *
+     * @param meta - 可选;目前仅 `pinned`(#108),表示本快照不应被 FIFO 淘汰。
+     *   适配器应把 `pinned` 与 payload 一起持久化,并在 `list` 时体现在
+     *   `SnapshotInfo.pinned` 上。未实现 pinned 的旧 adapter 可忽略该参数。
+     */
+    save(docId: string, id: string, payload: SnapshotPayload, meta?: {
+        pinned?: boolean;
+    }): Promise<void>;
+    load(docId: string, id: string): Promise<SnapshotPayload>;
+    delete(docId: string, id: string): Promise<void>;
+    /**
+     * 列出某 docId 下所有快照元信息。
+     *
+     * **必须按 id 自增数字升序返回(snap-0, snap-1, ..., snap-N)**。
+     * SnapshotApi 的 FIFO 淘汰(按"最早快照"删)依赖该顺序;若 adapter 返回顺序与
+     * id 自增序不一致,FIFO 会淘汰错对象。
+     *
+     * `SnapshotInfo.pinned` 反映 adapter 保存时收到的 `meta.pinned`;未实现 pinned
+     * 的旧 adapter 不带该字段(视为未 pinned)。
+     */
+    list(docId: string): Promise<SnapshotInfo[]>;
+    clear(docId: string): Promise<void>;
+}
+
+export type { ChangeLog as C, SnapshotStorageAdapter as S, SnapshotPayload as a, SnapshotInfo as b };

package/dist/types-C2vQfM-b.d.ts

@@ -0,0 +1,102 @@
+/**
+ * 快照子系统 —— 与文档类型无关的存储层类型定义。
+ *
+ * 设计背景:docs/03.2-快照系统.md(尤其 §2 API 形态、§8 存储适配层)。
+ *
+ * 层次:
+ *   - 本文件:SnapshotInfo / ChangeLog / SnapshotPayload / SnapshotStorageAdapter
+ *   - `./in-memory.ts`:默认 InMemorySnapshotStorage 实现
+ *   - 后续 #21 在 WordDocument 上挂 SnapshotApi 子 API,消费本适配器
+ */
+/** 消费方通过 `wordDoc.snapshots.recordChange()` 累加的变更日志项 */
+interface ChangeLog {
+    /** 时间戳,Date.now() */
+    timestamp: number;
+    /** 工具名,例 'replace_paragraphs' */
+    toolName: string;
+    /** 工具自定义摘要(结构由消费方决定,可 JSON.stringify) */
+    summary?: unknown;
+}
+/** 快照元信息(`list` 只返回这些,不含 parts 字节) */
+interface SnapshotInfo {
+    /** 自增 id,'snap-0' / 'snap-1' / ... */
+    id: string;
+    /** 时间戳,Date.now() */
+    timestamp: number;
+    /** 用户提供的 take 原因 */
+    reason?: string;
+    /** 用户提供的 take 详细结构 */
+    details?: unknown;
+    /** 当前 OOXML Package 全部 parts 的稳定 SHA-256 指纹。旧快照可缺省。 */
+    contentHash?: string;
+    /** 逻辑去重域；仅同一 dedupeKey 的快照之间允许复用 id。 */
+    dedupeKey?: string;
+    /** take 时一次性吸入的主线程 changelog */
+    changesCaptured: ChangeLog[];
+    /**
+     * Pinned 标记(#108,docs/03.2 §3.3):true 时该快照不参与 FIFO 淘汰。
+     *
+     * - `undefined` / `false` 等价,均视为普通快照
+     * - 用于保护 `WordAgent.create` 的 session-start 快照不被 plugin 的
+     *   常规 take 挤掉
+     * - 向后兼容:旧 payload / 旧 adapter 未带该字段时视为未 pinned
+     */
+    pinned?: boolean;
+}
+/** 快照完整载荷(info + parts 字节) */
+interface SnapshotPayload {
+    info: SnapshotInfo;
+    parts: Array<{
+        path: string;
+        contentType: string;
+        bytes: Uint8Array;
+    }>;
+}
+/**
+ * 存储适配器接口。宿主(WPS 面板 / Electron main / 浏览器 / Node server)提供实现。
+ *
+ * **语义承诺**:
+ * - `save` / `load` 捆装 info + parts 为一次写入 / 一次读取
+ * - `list` **仅返 meta**(SnapshotInfo 数组),不加载 parts(避免大档进主线程)
+ * - `delete(docId, id)`:不存在时不抛错,幂等
+ * - `clear(docId)`:清除该 docId 下所有快照,不影响其它 docId
+ * - 所有方法 async(允许底层存储异步)
+ *
+ * **pinned 支持(#108)**:
+ * - `save` 接受可选 `meta.pinned`,adapter 需把该 bit 与 payload 一起持久化,
+ *   并在 `list` 返回的 `SnapshotInfo.pinned` 中还原
+ * - 不支持 pinned 的旧 adapter 仍然合法:`list` 返回的 `pinned`
+ *   默认为 `undefined`,被 SnapshotApi 视为未 pinned(向后兼容)
+ * - 具体的 "FIFO 淘汰时跳过 pinned" 逻辑在 **SnapshotApi 主线程侧**,
+ *   adapter 只负责存取该 bit
+ *
+ * SDK 不做:重试 / 超时 / 并发互斥。异常透传给消费方。
+ */
+interface SnapshotStorageAdapter {
+    /**
+     * 保存快照。
+     *
+     * @param meta - 可选;目前仅 `pinned`(#108),表示本快照不应被 FIFO 淘汰。
+     *   适配器应把 `pinned` 与 payload 一起持久化,并在 `list` 时体现在
+     *   `SnapshotInfo.pinned` 上。未实现 pinned 的旧 adapter 可忽略该参数。
+     */
+    save(docId: string, id: string, payload: SnapshotPayload, meta?: {
+        pinned?: boolean;
+    }): Promise<void>;
+    load(docId: string, id: string): Promise<SnapshotPayload>;
+    delete(docId: string, id: string): Promise<void>;
+    /**
+     * 列出某 docId 下所有快照元信息。
+     *
+     * **必须按 id 自增数字升序返回(snap-0, snap-1, ..., snap-N)**。
+     * SnapshotApi 的 FIFO 淘汰(按"最早快照"删)依赖该顺序;若 adapter 返回顺序与
+     * id 自增序不一致,FIFO 会淘汰错对象。
+     *
+     * `SnapshotInfo.pinned` 反映 adapter 保存时收到的 `meta.pinned`;未实现 pinned
+     * 的旧 adapter 不带该字段(视为未 pinned)。
+     */
+    list(docId: string): Promise<SnapshotInfo[]>;
+    clear(docId: string): Promise<void>;
+}
+
+export type { ChangeLog as C, SnapshotStorageAdapter as S, SnapshotPayload as a, SnapshotInfo as b };