docxodus 12.2.0 → 12.3.0

package/dist/embed.bundle.js

@@ -2278,7 +2278,7 @@ function createMemoryHistoryStorage(maxBlobBytes = 256 * 1024 * 1024) {
     return `${reference.digest.value}:${reference.length}`;
   };
   const equalReference = (a, b) => a.length === b.length && a.digest.algorithm === b.digest.algorithm && a.digest.value === b.digest.value;
-  const equalHead = (a, b) => a === null || b === null ? a === b : a.revision === b.revision && equalReference(a.state, b.state);
+  const equalHead2 = (a, b) => a === null || b === null ? a === b : a.revision === b.revision && equalReference(a.state, b.state);
   return {
     async readBlob(reference) {
       return blobs.get(key(reference))?.slice() ?? null;
@@ -2300,7 +2300,7 @@ function createMemoryHistoryStorage(maxBlobBytes = 256 * 1024 * 1024) {
     async advanceHead(documentId, expected, state) {
       key(state);
       const current = heads.get(documentId) ?? null;
-      if (!equalHead(current, expected)) return null;
+      if (!equalHead2(current, expected)) return null;
       const revision = BigInt(current?.revision ?? "0") + 1n;
       if (revision > 9223372036854775807n) throw new RangeError("History revision exhausted.");
       const head = { revision: String(revision), state: copy(state) };
@@ -2320,6 +2320,590 @@ function createMemoryHistoryStorage(maxBlobBytes = 256 * 1024 * 1024) {
   };
 }
 
+// src/history-checkpoints.ts
+var HistoryCheckpoints = class _HistoryCheckpoints {
+  constructor(document2, journal) {
+    this.document = document2;
+    this.journal = journal;
+    this.current = null;
+    this.request = null;
+    this.running = false;
+    this.stale = false;
+  }
+  /** Pass an already captured view when opening its exact version in an editor (for example, after import). */
+  static async open(document2, journal, view) {
+    const controls = new _HistoryCheckpoints(document2, journal);
+    controls.request = structuredClone(await journal.read());
+    if (controls.request && controls.request.documentId !== document2.documentId)
+      throw new DocxHistoryError("InvalidRequest", "The pending checkpoint belongs to another document.");
+    controls.current = view === void 0 ? await document2.read() : structuredClone(view);
+    if (controls.current && controls.current.state.documentId !== document2.documentId)
+      throw new DocxHistoryError("InvalidRequest", "The captured view belongs to another document.");
+    return controls;
+  }
+  get view() {
+    return structuredClone(this.current);
+  }
+  get hasPending() {
+    return this.request !== null;
+  }
+  get needsRefresh() {
+    return this.stale;
+  }
+  async refresh() {
+    return this.exclusive(async () => {
+      this.current = await this.document.read();
+      this.stale = false;
+      return this.view;
+    });
+  }
+  async save(bytes, metadata) {
+    return this.start({
+      kind: "save",
+      head: this.current?.head ?? null,
+      bytes,
+      id: crypto.randomUUID(),
+      documentId: this.document.documentId,
+      metadata
+    });
+  }
+  async restore(target, metadata) {
+    if (!this.current) throw new DocxHistoryError("NotFound", "Save a checkpoint before restoring a version.");
+    return this.start({
+      kind: "restore",
+      head: this.current.head,
+      target,
+      id: crypto.randomUUID(),
+      documentId: this.document.documentId,
+      metadata
+    });
+  }
+  async retry() {
+    return this.exclusive(async () => {
+      if (!this.request) throw new DocxHistoryError("InvalidRequest", "There is no pending checkpoint.");
+      return this.publish();
+    });
+  }
+  async start(request) {
+    return this.exclusive(async () => {
+      if (this.request) throw new DocxHistoryError("PendingRequest", "Retry the pending checkpoint first.");
+      if (this.stale) throw new DocxHistoryError("StaleHead", "Refresh history before saving again.");
+      this.request = structuredClone(request);
+      return this.publish();
+    });
+  }
+  async publish() {
+    const intended = this.request;
+    const request = await this.journal.put(structuredClone(intended));
+    this.request = structuredClone(request);
+    if (request.id !== intended.id)
+      throw new DocxHistoryError("PendingRequest", "Another tab has a pending checkpoint. Retry it before saving your draft.");
+    let view;
+    try {
+      view = request.kind === "save" ? await this.document.createVersion(request.head, request.bytes, request.metadata, request.id) : await this.document.restoreVersion(request.head, request.target, request.metadata, request.id);
+    } catch (error) {
+      if (error instanceof DocxHistoryError && error.code === "StaleHead") {
+        this.stale = true;
+        await this.journal.remove(request.id);
+        this.request = null;
+      }
+      throw error;
+    }
+    this.current = view;
+    await this.journal.remove(request.id);
+    this.request = null;
+    return this.view;
+  }
+  async exclusive(action) {
+    if (this.running) throw new DocxHistoryError("Busy", "A history command is still running.");
+    this.running = true;
+    try {
+      return await action();
+    } finally {
+      this.running = false;
+    }
+  }
+};
+
+// src/history-indexeddb.ts
+async function openIndexedDbHistoryStore(name) {
+  const db = await new Promise((resolve, reject) => {
+    let blocked = false;
+    const request = indexedDB.open(name, 1);
+    request.onupgradeneeded = () => {
+      for (const store of ["blobs", "heads", "requests"]) request.result.createObjectStore(store);
+    };
+    request.onsuccess = () => {
+      if (blocked) request.result.close();
+      else resolve(request.result);
+    };
+    request.onerror = () => reject(request.error);
+    request.onblocked = () => {
+      blocked = true;
+      reject(new Error("Close other tabs using this history store, then try again."));
+    };
+  });
+  db.onversionchange = () => db.close();
+  function transaction(name2, mode, action) {
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(name2, mode);
+      let value;
+      tx.oncomplete = () => resolve(value);
+      tx.onabort = () => reject(tx.error ?? new Error("History storage transaction was aborted."));
+      try {
+        action(tx.objectStore(name2), (result) => {
+          value = result;
+        });
+      } catch (error) {
+        tx.abort();
+        reject(error);
+      }
+    });
+  }
+  const storage = {
+    readBlob(reference) {
+      const key = referenceKey(reference);
+      return transaction("blobs", "readonly", (store, result) => {
+        store.get(key).onsuccess = (event) => result(event.target.result ?? null);
+      });
+    },
+    async putBlob(reference, bytes) {
+      const key = referenceKey(reference);
+      const captured = bytes.slice();
+      if (captured.length !== reference.length) throw new DocxHistoryError("PayloadMismatch", "Stored document length does not match its reference.");
+      const hash = Array.from(
+        new Uint8Array(await crypto.subtle.digest("SHA-256", captured)),
+        (byte) => byte.toString(16).padStart(2, "0")
+      ).join("");
+      if (hash !== key.split(":")[0])
+        throw new DocxHistoryError("PayloadMismatch", "Stored document bytes do not match their reference.");
+      await transaction("blobs", "readwrite", (store, result) => {
+        store.put(captured, key);
+        result();
+      });
+    },
+    readHead(documentId) {
+      return transaction("heads", "readonly", (store, result) => {
+        store.get(documentId).onsuccess = (event) => result(event.target.result ?? null);
+      });
+    },
+    advanceHead(documentId, expected, state) {
+      referenceKey(state);
+      const captured = structuredClone({ expected, state });
+      if (expected) validateHead(expected);
+      const revision = BigInt(expected?.revision ?? "0") + 1n;
+      if (revision > 9223372036854775807n) throw new RangeError("History revision exhausted.");
+      return transaction("heads", "readwrite", (store, result) => {
+        store.get(documentId).onsuccess = (event) => {
+          const current = event.target.result ?? null;
+          if (!equalHead(current, captured.expected)) {
+            result(null);
+            return;
+          }
+          const head = { revision: String(revision), state: captured.state };
+          store.put(head, documentId);
+          result(head);
+        };
+      });
+    },
+    initializeHead(documentId, head) {
+      validateHead(head);
+      const captured = structuredClone(head);
+      return transaction("heads", "readwrite", (store, result) => {
+        store.get(documentId).onsuccess = (event) => {
+          const existing = event.target.result;
+          if (existing) {
+            result({ initialized: false, head: existing });
+            return;
+          }
+          store.put(captured, documentId);
+          result({ initialized: true, head: captured });
+        };
+      });
+    }
+  };
+  return {
+    storage,
+    journal(documentId) {
+      return {
+        read: () => transaction("requests", "readonly", (store, result) => {
+          store.get(documentId).onsuccess = (event) => result(event.target.result ?? null);
+        }),
+        put(request) {
+          if (request.documentId !== documentId) throw new Error("Checkpoint document identity does not match.");
+          const captured = structuredClone(request);
+          return transaction("requests", "readwrite", (store, result) => {
+            store.get(documentId).onsuccess = (event) => {
+              const existing = event.target.result;
+              if (existing) {
+                result(existing);
+                return;
+              }
+              store.put(captured, documentId);
+              result(captured);
+            };
+          });
+        },
+        remove(requestId) {
+          return transaction("requests", "readwrite", (store, result) => {
+            store.get(documentId).onsuccess = (event) => {
+              if (event.target.result?.id === requestId) store.delete(documentId);
+              result();
+            };
+          });
+        }
+      };
+    },
+    close: () => db.close()
+  };
+}
+function referenceKey(reference) {
+  if (reference.digest.algorithm !== "SHA-256" || !/^[a-f0-9]{64}$/.test(reference.digest.value) || !Number.isSafeInteger(reference.length) || reference.length < 0)
+    throw new DocxHistoryError("InvalidRequest", "Invalid history blob reference.");
+  return `${reference.digest.value}:${reference.length}`;
+}
+function validateHead(head) {
+  referenceKey(head.state);
+  if (typeof head.revision !== "string" || !/^[1-9][0-9]*$/.test(head.revision) || BigInt(head.revision) > 9223372036854775807n)
+    throw new DocxHistoryError("InvalidRequest", "Invalid history revision.");
+}
+function equalHead(a, b) {
+  return a === null || b === null ? a === b : a.revision === b.revision && a.state.length === b.state.length && a.state.digest.algorithm === b.state.digest.algorithm && a.state.digest.value === b.state.digest.value;
+}
+
+// src/history-controls.ts
+function mountHistoryControls(container, options) {
+  const pageSize = options.pageSize ?? 25;
+  if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) throw new RangeError("History page size must be 1\u2013100.");
+  if (options.checkpoints && options.checkpoints.document !== options.reader)
+    throw new Error("History controls and checkpoints must use the same document.");
+  return new HistoryPanel(container, options, pageSize);
+}
+var HistoryPanel = class {
+  constructor(container, options, pageSize) {
+    this.options = options;
+    this.pageSize = pageSize;
+    this.actions = /* @__PURE__ */ new Map();
+    this.events = new AbortController();
+    this.records = [];
+    this.next = null;
+    this.view = null;
+    this.active = null;
+    this.destroyed = false;
+    const doc = container.ownerDocument;
+    this.element = doc.createElement("section");
+    this.element.className = "dx-history";
+    this.element.setAttribute("aria-label", "Document history");
+    const style = doc.createElement("style");
+    style.textContent = HISTORY_CSS;
+    const title = doc.createElement("h2");
+    title.textContent = "Document history";
+    this.status = doc.createElement("p");
+    this.status.setAttribute("role", "status");
+    this.status.setAttribute("aria-live", "polite");
+    this.fieldset = doc.createElement("fieldset");
+    const legend = doc.createElement("legend");
+    legend.textContent = "Versions and checkpoints";
+    this.fieldset.append(legend);
+    this.element.append(style, title, this.status, this.fieldset);
+    container.append(this.element);
+    const note = doc.createElement("p");
+    note.textContent = options.checkpoints ? "Browse saved versions without changing your draft." : "Read-only history. Preview or download any saved version.";
+    this.fieldset.append(note);
+    this.button("refresh", "Refresh history", () => this.load(true));
+    this.button("latest", "Open latest", async () => this.preview(await options.reader.exportDocx(), "Latest saved version"));
+    this.versions = this.select("Version");
+    this.versions.size = 6;
+    this.detail = doc.createElement("p");
+    this.fieldset.append(this.detail);
+    this.versions.addEventListener("change", () => this.update(), { signal: this.events.signal });
+    this.button("preview", "Preview selected", async () => this.preview(await options.reader.exportDocx(this.selected().id), versionTitle(this.selected())));
+    this.button("download", "Download selected", async () => this.download(await options.reader.exportDocx(this.selected().id), `version-${this.selected().record.sequence}.docx`));
+    this.before = this.select("Compare from");
+    this.before.addEventListener("change", () => this.update(), { signal: this.events.signal });
+    const compareNote = doc.createElement("p");
+    compareNote.textContent = "Compare from this version to the selected version above.";
+    this.fieldset.append(compareNote);
+    this.button("compare", "Compare versions", async () => {
+      const before = this.records[Number(this.before.value)];
+      await this.preview(await options.reader.compareVersions(before.id, this.selected().id), "Comparison with tracked changes");
+    });
+    this.button("more", "Load older versions", async () => {
+      if (this.next) await this.page(this.next, false);
+    });
+    this.author = this.input("Your name", "text", options.author ?? "You");
+    this.label = this.input("Checkpoint name (optional)", "text");
+    this.author.parentElement.hidden = this.label.parentElement.hidden = !options.checkpoints;
+    this.button("save", "Save checkpoint", async () => {
+      const view = await options.checkpoints.save(await options.capture(), this.metadata());
+      await options.onCheckpoint?.(view, "save");
+      await this.load(false);
+      this.label.value = "";
+      this.status.textContent = "Checkpoint saved. Your draft remains open.";
+    });
+    this.button("restore", "Restore selected", async () => {
+      const version = this.selected();
+      if (!doc.defaultView?.confirm(`Restore ${versionTitle(version)} as a new checkpoint?
+
+Your current draft and all later versions will be kept.`)) {
+        this.status.textContent = "Restore canceled. Your draft and history are unchanged.";
+        return;
+      }
+      const view = await options.checkpoints.restore(version.id, this.metadata());
+      await options.onCheckpoint?.(view, "restore");
+      await this.load(false);
+      this.status.textContent = "Restored as a new checkpoint. Your draft and later versions are kept.";
+    });
+    const restoreNote = doc.createElement("p");
+    restoreNote.hidden = !options.checkpoints;
+    restoreNote.textContent = "Restore creates a new checkpoint. Open latest to preview it; your draft stays open.";
+    this.fieldset.append(restoreNote);
+    this.button("retry", "Retry checkpoint", async () => {
+      const view = await options.checkpoints.retry();
+      await options.onCheckpoint?.(view, "retry");
+      await this.load(false);
+      this.status.textContent = "Checkpoint recovered. Your draft remains open. Refresh history to check for newer versions.";
+    });
+    const sharing = this.disclosure("Download with history");
+    const sharingNote = doc.createElement("p");
+    sharingNote.textContent = "Includes retained drafts and collaboration proposals. Share this file only when you want to include that history. A DOCX download keeps existing Word comments and revisions, without external history.";
+    sharing.append(sharingNote);
+    this.button("archive", "Download .docxhistory", async () => this.download(await options.reader.exportHistoryArchive(), "docxhistory"), sharing);
+    const time = this.disclosure("Find a version by time");
+    const cutoff = this.input("Saved at or before (local time)", "datetime-local", "", time);
+    this.button("time", "Preview at time", async () => {
+      if (!cutoff.value) throw new DocxHistoryError("InvalidRequest", "Choose a date and time first.");
+      const sequence = await options.reader.resolveSequenceAtTime(new Date(cutoff.value).toISOString());
+      await this.preview(await options.reader.materialize(sequence), "Version at selected time");
+    }, time);
+    const activity = this.disclosure("Recorded collaboration");
+    const decisions = doc.createElement("ol");
+    let showOlderActivity = () => {
+    };
+    this.button("activity", "Load activity", async () => {
+      const { operations } = await options.reader.readOperationsSince(null);
+      const resolved = new Set(operations.filter((op) => op.record.status === "accepted").map((op) => op.input.request.resolves?.digest.value));
+      let shown = 0;
+      showOlderActivity = () => {
+        const page = operations.slice(Math.max(0, operations.length - shown - this.pageSize), operations.length - shown).reverse();
+        decisions.append(...page.map((op) => this.activityItem(op, resolved.has(op.id.digest.value))));
+        shown += page.length;
+        this.actions.get("activity-more").hidden = shown >= operations.length;
+      };
+      decisions.replaceChildren();
+      showOlderActivity();
+      this.status.textContent = operations.length ? "Recorded activity loaded." : "No recorded collaboration.";
+    }, activity);
+    activity.append(decisions);
+    this.button("activity-more", "Load older activity", async () => showOlderActivity(), activity);
+    this.actions.get("activity-more").hidden = true;
+    this.ready = this.run("Loading history", () => this.load(false));
+  }
+  refresh() {
+    return this.run("Loading history", () => this.load(true));
+  }
+  async destroy() {
+    this.destroyed = true;
+    this.events.abort();
+    this.element.remove();
+    await this.active?.catch(() => {
+    });
+  }
+  async load(refresh) {
+    this.view = this.options.checkpoints ? refresh ? await this.options.checkpoints.refresh() : this.options.checkpoints.view : await this.options.reader.read();
+    if (this.view) await this.page(this.view.version.id, true);
+    else {
+      this.records = [];
+      this.next = null;
+      this.versions.replaceChildren();
+      this.before.replaceChildren();
+    }
+    this.status.textContent = this.options.checkpoints?.hasPending ? "A checkpoint needs recovery. Retry it before saving more changes." : this.view ? "History loaded. Select a version to preview, download or restore." : "No checkpoints yet. Save your first checkpoint when you are ready.";
+  }
+  async page(cursor, reset) {
+    const page = await this.options.reader.listVersions(cursor, this.pageSize);
+    if (reset) {
+      this.records = [];
+      this.versions.replaceChildren();
+      this.before.replaceChildren();
+    }
+    const start2 = this.records.length;
+    this.records.push(...page.versions);
+    this.next = page.next;
+    for (let index = start2; index < this.records.length; index++) {
+      for (const select of [this.versions, this.before]) {
+        const option = select.ownerDocument.createElement("option");
+        option.value = String(index);
+        option.textContent = option.title = versionTitle(this.records[index]);
+        select.append(option);
+      }
+    }
+    if (reset) {
+      this.versions.value = "0";
+      this.before.value = this.records.length > 1 ? "1" : "0";
+    }
+  }
+  update() {
+    const hasVersion = this.records.length > 0;
+    const pending = this.options.checkpoints?.hasPending ?? false;
+    const stale = this.options.checkpoints?.needsRefresh ?? false;
+    for (const key of ["latest", "preview", "download", "archive", "time", "activity"]) this.actions.get(key).disabled = !hasVersion;
+    this.actions.get("more").hidden = !this.next;
+    this.actions.get("compare").disabled = !hasVersion || this.before.value === this.versions.value;
+    this.actions.get("save").hidden = !this.options.checkpoints || !this.options.capture;
+    this.actions.get("save").disabled = pending || stale;
+    this.actions.get("restore").hidden = !this.options.checkpoints;
+    this.actions.get("restore").disabled = !hasVersion || pending || stale;
+    this.actions.get("retry").hidden = !pending;
+    this.detail.textContent = hasVersion ? [
+      versionTitle(this.selected()),
+      this.selected().record.metadata.message,
+      this.selected().record.restoredFrom ? "Restored from an earlier version." : ""
+    ].filter(Boolean).join(" \u2014 ") : "";
+  }
+  selected() {
+    return this.records[Number(this.versions.value)];
+  }
+  activityItem(op, resolved) {
+    const doc = this.element.ownerDocument;
+    const item = doc.createElement("li");
+    const state = op.record.status === "accepted" ? "Accepted" : resolved ? "Conflict resolved" : "Conflict needs review";
+    const label = doc.createElement("p");
+    label.textContent = `${op.input.request.metadata.author} \xB7 ${state} \xB7 ${formatTime(op.input.request.metadata.createdAt)}`;
+    item.append(label);
+    const description = doc.createElement("p");
+    this.commandButton("View decision", async () => {
+      const decision = await this.options.reader.getOperation(op.id);
+      const { kind, metadata } = decision.input.request;
+      description.textContent = [
+        { text: "Text edit", package: "Document edit", discard: "Discarded proposal" }[kind],
+        metadata.label,
+        metadata.message,
+        decision.record.conflict
+      ].filter(Boolean).join(" \u2014 ");
+    }, item);
+    item.append(description);
+    this.commandButton("Download proposal", async () => {
+      await this.download(await this.options.reader.exportOperationProposal(op.id), `proposal-${op.record.revision}.docx`);
+    }, item);
+    return item;
+  }
+  metadata() {
+    return { author: this.author.value.trim() || "You", createdAt: (/* @__PURE__ */ new Date()).toISOString(), label: this.label.value.trim() || void 0 };
+  }
+  async preview(bytes, title) {
+    if (!this.destroyed) await this.options.preview(bytes, title);
+  }
+  async download(bytes, suffix) {
+    if (this.destroyed) return;
+    const stem = (this.options.documentName ?? "document").replace(/\.(docx|docxhistory)$/i, "");
+    const name = suffix === "docxhistory" ? `${stem}.docxhistory` : `${stem}-${suffix}`;
+    if (this.options.download) {
+      await this.options.download(bytes, name);
+      return;
+    }
+    const url = URL.createObjectURL(new Blob([bytes.slice()], { type: suffix === "docxhistory" ? "application/octet-stream" : "application/vnd.openxmlformats-officedocument.wordprocessingml.document" }));
+    const link = this.element.ownerDocument.createElement("a");
+    link.href = url;
+    link.download = name;
+    link.click();
+    setTimeout(() => URL.revokeObjectURL(url), 1e3);
+  }
+  async run(label, action) {
+    if (this.destroyed) throw new DocxHistoryError("Closed", "History controls are closed.");
+    if (this.active) throw new DocxHistoryError("Busy", "A history command is still running.");
+    this.fieldset.disabled = true;
+    this.element.setAttribute("aria-busy", "true");
+    this.status.textContent = `${label}\u2026`;
+    const work = Promise.resolve().then(action);
+    this.active = work;
+    try {
+      await work;
+      if (this.status.textContent === `${label}\u2026`) this.status.textContent = "Ready.";
+    } catch (error) {
+      if (!this.destroyed) this.status.textContent = historyControlError(error, this.options.checkpoints?.hasPending);
+      throw error;
+    } finally {
+      this.active = null;
+      if (!this.destroyed) {
+        this.fieldset.disabled = false;
+        this.element.setAttribute("aria-busy", "false");
+        this.update();
+      }
+    }
+  }
+  button(key, title, action, parent = this.fieldset) {
+    this.actions.set(key, this.commandButton(title, action, parent));
+  }
+  commandButton(title, action, parent) {
+    const button = parent.ownerDocument.createElement("button");
+    button.type = "button";
+    button.textContent = title;
+    button.addEventListener("click", () => {
+      void this.run(title, action).catch(() => {
+      });
+    }, { signal: this.events.signal });
+    parent.append(button);
+    return button;
+  }
+  select(title) {
+    const label = this.fieldset.ownerDocument.createElement("label");
+    label.textContent = title;
+    const select = label.ownerDocument.createElement("select");
+    select.setAttribute("aria-label", title);
+    label.append(select);
+    this.fieldset.append(label);
+    return select;
+  }
+  input(title, type, value = "", parent = this.fieldset) {
+    const label = parent.ownerDocument.createElement("label");
+    label.textContent = title;
+    const input = label.ownerDocument.createElement("input");
+    input.type = type;
+    input.value = value;
+    label.append(input);
+    parent.append(label);
+    return input;
+  }
+  disclosure(title) {
+    const details = this.fieldset.ownerDocument.createElement("details");
+    const summary = details.ownerDocument.createElement("summary");
+    summary.textContent = title;
+    details.append(summary);
+    this.fieldset.append(details);
+    return details;
+  }
+};
+function historyControlError(error, pending = false) {
+  const code = error instanceof DocxHistoryError ? error.code : "";
+  if (code === "StaleHead") return "A newer checkpoint exists. Your draft is safe. Refresh history, review the newer version, then save again.";
+  if (code === "ImportConflict") return "A different local history already exists. Open this file read-only to explore it.";
+  if (code === "InitializationUnsupported") return "This storage cannot import history. Open read-only or choose storage that supports importing.";
+  if (pending) return "The checkpoint could not be confirmed. Your draft is safe. Retry checkpoint to recover the original request.";
+  if (code === "ResourceLimit") return "This history file exceeds browser processing limits, which can apply even below 64 MiB. Your document is unchanged.";
+  if (code === "UnsupportedVersion") return "This history file uses an unsupported version. Open it with a newer app. Your document is unchanged.";
+  if (code === "InvalidManifest") return "This history file is damaged or incomplete. Choose another copy. Your document is unchanged.";
+  return `History could not be loaded. Your document is unchanged. ${error instanceof Error ? error.message : "Please try again."}`;
+}
+function versionTitle(version) {
+  const { metadata, sequence } = version.record;
+  return `${metadata.label || `Version ${BigInt(sequence) + 1n}`} \xB7 ${metadata.author} \xB7 ${formatTime(metadata.createdAt)}`;
+}
+function formatTime(value) {
+  const time = new Date(value);
+  return Number.isNaN(time.getTime()) ? value : time.toLocaleString();
+}
+var HISTORY_CSS = `
+.dx-history{font:14px/1.5 system-ui,sans-serif;color:#203047;background:#fff;border:1px solid #cbd5e1;border-radius:12px;padding:18px;min-width:0}
+.dx-history *{box-sizing:border-box}.dx-history h2{font-size:20px;margin:0 0 8px}.dx-history p{margin:8px 0;overflow-wrap:anywhere}
+.dx-history fieldset{border:0;padding:0;margin:0;min-width:0}.dx-history legend{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}
+.dx-history label{display:block;font-weight:600;margin:12px 0 6px}.dx-history input,.dx-history select{display:block;width:100%;max-width:100%;margin-top:4px;font:inherit;color:inherit;border:1px solid #94a3b8;border-radius:6px;padding:8px;background:#fff}
+.dx-history button{min-height:40px;margin:4px 6px 4px 0;padding:7px 12px;border:1px solid #94a3b8;border-radius:6px;background:#f8fafc;color:inherit;font:inherit;cursor:pointer}
+.dx-history button:disabled{opacity:.5;cursor:wait}.dx-history :focus-visible{outline:3px solid #2563eb;outline-offset:2px}.dx-history [hidden]{display:none}
+.dx-history details{margin-top:16px;border-top:1px solid #e2e8f0;padding-top:12px}.dx-history summary{cursor:pointer;font-weight:600;padding:4px 0}
+.dx-history [role=status]{min-height:42px}.dx-history ol{padding-left:22px}.dx-history option{padding:6px}
+`;
+
 // src/page-number-format.ts
 var ROMAN_ONES = ["", "i", "ii", "iii", "iv", "v", "vi", "vii", "viii", "ix"];
 var ROMAN_TENS = ["", "x", "xx", "xxx", "xl", "l", "lx", "lxx", "lxxx", "xc"];
@@ -15649,7 +16233,8 @@ var RibbonSurface = class {
       comments: this.options.comments,
       commentAuthor: this.author
     });
-    this.require("save").disabled = false;
+    const saveButton = this.control("save");
+    if (saveButton) saveButton.disabled = false;
     this.require("ribbon").setAttribute("aria-disabled", "false");
     this.setState("ready");
     this.setStatus(`Rendered in ${Math.round(performance.now() - started)} ms`);
@@ -18468,6 +19053,7 @@ export {
   DocxHistoryReader,
   DocxSession,
   EmptyParagraphMode,
+  HistoryCheckpoints,
   MAX_HISTORY_ARCHIVE_BYTES,
   PaginationEngine,
   PaginationMode,
@@ -18527,6 +19113,7 @@ export {
   getVersion,
   getWasmExports,
   hasAnnotations,
+  historyControlError,
   initialize,
   installHistoryStorageImports,
   isDeletion,
@@ -18534,11 +19121,13 @@ export {
   isInitialized,
   isInsertion,
   isMove,
+  mountHistoryControls,
   mountRibbon,
   navigateToPageCitation,
   openDocxHistory,
   openDocxHistoryArchive,
   openDocxSession2 as openDocxSession,
+  openIndexedDbHistoryStore,
   paginateHtml,
   parseSectionDimensions,
   projectAnnotationsOntoHtml,

package/dist/embed.d.ts

@@ -7,7 +7,7 @@
  * ```html
  * <div id="doc"></div>
  * <script type="module">
- *   import { createViewer } from "https://cdn.jsdelivr.net/npm/docxodus@12.1.0/dist/embed.bundle.js";
+ *   import { createViewer } from "https://cdn.jsdelivr.net/npm/docxodus@12.2.0/dist/embed.bundle.js";
  *   await createViewer("#doc", "./contract.docx");
  * </script>
  * ```