superdoc 2.4.0-next.8 → 2.4.0-next.9

package/dist/chunks/{create-super-doc-ui-sMXbYzhs.cjs → create-super-doc-ui-ByvmsAAG.cjs}

@@ -8229,10 +8229,14 @@ function createSuperDocUI(options) {
 			const op = commentsApi?.create;
 			if (typeof op !== "function") return failedReceipt("comments.create is unavailable.");
 			const fallback = failedReceipt("comments.create failed.");
-			return safeCall(() => settleWorkflowReceipt(op.call(commentsApi, {
-				target: capture.target ?? capture.selectionTarget,
-				text: input.text
-			}), fallback), fallback);
+			return safeCall(() => {
+				const target = capture && typeof capture === "object" ? capture.target ?? capture.selectionTarget : null;
+				if (target == null) return failedReceipt("A range selection is required to comment.", "NO_SELECTION");
+				return settleWorkflowReceipt(op.call(commentsApi, {
+					target,
+					text: input.text
+				}), fallback);
+			}, fallback);
 		},
 		createFromSelection: (input) => {
 			const refusal = commentWriteRefusal();
@@ -8264,6 +8268,18 @@ function createSuperDocUI(options) {
 				text: input.text
 			}), fallback), fallback);
 		},
+		edit: (commentId, input) => {
+			const refusal = commentWriteRefusal();
+			if (refusal) return refusal;
+			const commentsApi = getDoc()?.comments;
+			const op = commentsApi?.patch;
+			if (typeof op !== "function") return failedReceipt("comments.patch is unavailable.");
+			const fallback = failedReceipt("comments.patch failed.");
+			return safeCall(() => settleWorkflowReceipt(op.call(commentsApi, {
+				commentId,
+				text: input.text
+			}), fallback), fallback);
+		},
 		resolve: (commentId) => patchCommentStatus(commentId, "resolved"),
 		reopen: (commentId) => patchCommentStatus(commentId, "active"),
 		delete: (commentId) => {

package/dist/chunks/{create-super-doc-ui-BquF8bnZ.es.js → create-super-doc-ui-DBXOhHdW.es.js}

@@ -8007,10 +8007,14 @@ function createSuperDocUI(options) {
 			const op = commentsApi?.create;
 			if (typeof op !== "function") return failedReceipt("comments.create is unavailable.");
 			const fallback = failedReceipt("comments.create failed.");
-			return safeCall(() => settleWorkflowReceipt(op.call(commentsApi, {
-				target: capture.target ?? capture.selectionTarget,
-				text: input.text
-			}), fallback), fallback);
+			return safeCall(() => {
+				const target = capture && typeof capture === "object" ? capture.target ?? capture.selectionTarget : null;
+				if (target == null) return failedReceipt("A range selection is required to comment.", "NO_SELECTION");
+				return settleWorkflowReceipt(op.call(commentsApi, {
+					target,
+					text: input.text
+				}), fallback);
+			}, fallback);
 		},
 		createFromSelection: (input) => {
 			const refusal = commentWriteRefusal();
@@ -8042,6 +8046,18 @@ function createSuperDocUI(options) {
 				text: input.text
 			}), fallback), fallback);
 		},
+		edit: (commentId, input) => {
+			const refusal = commentWriteRefusal();
+			if (refusal) return refusal;
+			const commentsApi = getDoc()?.comments;
+			const op = commentsApi?.patch;
+			if (typeof op !== "function") return failedReceipt("comments.patch is unavailable.");
+			const fallback = failedReceipt("comments.patch failed.");
+			return safeCall(() => settleWorkflowReceipt(op.call(commentsApi, {
+				commentId,
+				text: input.text
+			}), fallback), fallback);
+		},
 		resolve: (commentId) => patchCommentStatus(commentId, "resolved"),
 		reopen: (commentId) => patchCommentStatus(commentId, "active"),
 		delete: (commentId) => {

package/dist/collaboration-upgrade-engine.cjs

@@ -7,7 +7,7 @@ const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, __superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.8",
+	superdocVersion: "2.4.0-next.9",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -6,7 +6,7 @@ const COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.8",
+	superdocVersion: "2.4.0-next.9",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/public/ui-react.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-1Y-nnZJ3.cjs");
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-sMXbYzhs.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-ByvmsAAG.cjs");
 let react = require("react");
 var SuperDocUIContext = (0, react.createContext)(null);
 function disposeOwnedUi(ref) {

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BquF8bnZ.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DBXOhHdW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 var SuperDocUIContext = createContext(null);
 function disposeOwnedUi(ref) {

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-sMXbYzhs.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-ByvmsAAG.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BquF8bnZ.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DBXOhHdW.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc/src/public/ui/types.d.ts

@@ -837,7 +837,19 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
     list(query?: CommentsListQuery): readonly CommentInfo[];
     /** Resolve a single comment by id from the best-known loaded state. */
     getById(commentId: string): CommentInfo | null;
-    /** Create a comment from a frozen selection capture. */
+    /**
+     * Create a comment from a frozen selection capture.
+     *
+     * A capture carrying neither `target` nor `selectionTarget` fails closed with
+     * the same `NO_SELECTION` receipt {@link createFromSelection} mints for an
+     * empty selection, because both describe the same user-visible mistake:
+     * commenting with nothing selected. A capture that *has* a target which no
+     * longer resolves is a different failure, and keeps the Document API's own
+     * receipt so the reason stays specific.
+     *
+     * `capturedAt` is provenance for the consumer, not an expiry. A capture stays
+     * usable while its target resolves; elapsed time alone never invalidates it.
+     */
     createFromCapture(capture: CommentAnchorCapture, input: {
         text: string;
     }): WorkflowReceipt;
@@ -853,6 +865,18 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
     reply(commentId: string, input: {
         text: string;
     }): WorkflowReceipt;
+    /**
+     * Replace a comment's body text through the Document API
+     * (`comments.patch({ commentId, text })`).
+     *
+     * Gated by the comments `readOnly` policy like every other comment write.
+     * `allowResolve` is deliberately NOT consulted: that policy forbids only the
+     * resolve/reopen transition, and an application that may not resolve threads
+     * can still let an author correct their own wording.
+     */
+    edit(commentId: string, input: {
+        text: string;
+    }): WorkflowReceipt;
     /** Mark a comment resolved. */
     resolve(commentId: string): WorkflowReceipt;
     /** Reopen a resolved comment. */

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-DP8RUPW-.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-DqY4aSMf.cjs");
 const require_uuid = require("./chunks/uuid-CFp0WGVU.cjs");
 const require_jszip = require("./chunks/jszip-Cs9JBLlJ.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-sMXbYzhs.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-ByvmsAAG.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-CZ1Nl59K.cjs");
 const require_constants = require("./chunks/constants-D7TNtyJd.cjs");
 let vue = require("vue");
@@ -39357,7 +39357,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.8";
+		this.version = "2.4.0-next.9";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4_default();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -3,7 +3,7 @@ import { t as blank_default } from "./chunks/blank-docx-XRX6Ker2.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-Bt2s0X0a.es.js";
 import { t as v4_default } from "./chunks/uuid-B2Sqk-3p.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-C8srOKAO.es.js";
-import { a as createV2ReviewMutationReconciler, c as DOM_CLASS_NAMES, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, s as composeAuthorColorResolver, t as createSuperDocUI } from "./chunks/create-super-doc-ui-BquF8bnZ.es.js";
+import { a as createV2ReviewMutationReconciler, c as DOM_CLASS_NAMES, i as isV2EditableTextMutationEvent, o as getV2TrackedChangeMutationImpact, s as composeAuthorColorResolver, t as createSuperDocUI } from "./chunks/create-super-doc-ui-DBXOhHdW.es.js";
 import { t as __plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-DSMAhhwD.es.js";
 import { n as PDF_TO_CSS_UNITS } from "./chunks/constants-BfH0br5u.es.js";
 import * as Vue from "vue";
@@ -39290,7 +39290,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.8";
+		this.version = "2.4.0-next.9";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4_default();
 		this.colors = this.config.colors ?? [];