@portabletext/plugin-sdk-value 8.0.5 → 8.1.0

package/dist/index.js

@@ -1,16 +1,17 @@
 import { c } from "react/compiler-runtime";
-import { editDocument, getDocumentState, subscribeDocumentEvents, useApplyDocumentActions, useEditDocument, usePresenceForDocument, useReportPresence, useSanityInstance } from "@sanity/sdk-react";
+import { editDocument, getDocumentState, subscribeDocumentEvents, useApplyDocumentActions, useCommentActions, useComments, useEditDocument, usePresenceForDocument, useReportPresence, useSanityInstance } from "@sanity/sdk-react";
 import { PortableTextEditable, useEditor, useEditorSelector } from "@portabletext/editor";
-import { getSelection } from "@portabletext/editor/selectors";
+import { getSelectedTextBlocks, getSelection } from "@portabletext/editor/selectors";
 import { isEqualSelections } from "@portabletext/editor/utils";
 import { useState } from "react";
 import { applyAll } from "@portabletext/patches";
 import { diffValue } from "@sanity/diff-patch";
-import { parsePath } from "@sanity/json-match";
+import { parsePath, stringifyPath } from "@sanity/json-match";
 import { useActorRef } from "@xstate/react";
 import { fromCallback, setup } from "xstate";
 import rawDebug from "debug";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { DIFF_DELETE, DIFF_EQUAL, DIFF_INSERT, applyPatches, cleanupEfficiency, makeDiff, makePatches } from "@sanity/diff-match-patch";
 /**
 * Reduces a selection to a caret at its focus point.
 *
@@ -125,7 +126,15 @@ const debug = {
 	push: createDebugger("push"),
 	remote: createDebugger("remote"),
 	repair: createDebugger("repair")
-}, ARRAYIFY_ERROR_MESSAGE = "Unexpected path format from diffValue output. Please report this issue.";
+};
+function normalizeDocumentHandle(handle) {
+	let { source, ...normalizedHandle } = handle;
+	return normalizedHandle.resource !== void 0 || source === void 0 ? normalizedHandle : {
+		...normalizedHandle,
+		resource: source
+	};
+}
+const ARRAYIFY_ERROR_MESSAGE = "Unexpected path format from diffValue output. Please report this issue.";
 function* getSegments(node) {
 	node.base && (yield* getSegments(node.base)), node.segment.type !== "This" && (yield node.segment);
 }
@@ -227,11 +236,11 @@ function convertPatchesToSanity(patches, options) {
 		}
 	});
 }
-function segmentsEqual(a, b) {
+function segmentsEqual$1(a, b) {
 	return typeof a == "string" || typeof a == "number" ? a === b : typeof b == "string" || typeof b == "number" || Array.isArray(a) || Array.isArray(b) ? !1 : a._key === b._key;
 }
-function pathsEqual(a, b) {
-	return a.length === b.length && a.every((segment, index) => segmentsEqual(segment, b[index]));
+function pathsEqual$1(a, b) {
+	return a.length === b.length && a.every((segment, index) => segmentsEqual$1(segment, b[index]));
 }
 /**
 * The editor engine can only resolve keyed/indexed segments against the
@@ -256,7 +265,7 @@ function findSidecarArrayPath(path) {
 	}
 	return null;
 }
-function getValueAtPath(value, path) {
+function getValueAtPath$1(value, path) {
 	let current = value;
 	for (let segment of path) {
 		if (current == null) return;
@@ -290,10 +299,10 @@ function toEngineSafePatches(patches, targetValue) {
 			safe.push(patch);
 			continue;
 		}
-		sidecarPaths.some((existing) => pathsEqual(existing, sidecarPath)) || sidecarPaths.push(sidecarPath);
+		sidecarPaths.some((existing) => pathsEqual$1(existing, sidecarPath)) || sidecarPaths.push(sidecarPath);
 	}
 	for (let sidecarPath of sidecarPaths) {
-		let value = getValueAtPath(targetValue, sidecarPath);
+		let value = getValueAtPath$1(targetValue, sidecarPath);
 		safe.push(value === void 0 ? {
 			type: "unset",
 			path: sidecarPath,
@@ -318,7 +327,7 @@ function toEngineSafePatches(patches, targetValue) {
 function filterInsertsMissingFromRemoteValue(patches, remoteValue) {
 	return patches.flatMap((patch) => {
 		if (patch.type !== "insert") return [patch];
-		let parentValue = getValueAtPath(remoteValue, patch.path.slice(0, -1));
+		let parentValue = getValueAtPath$1(remoteValue, patch.path.slice(0, -1));
 		if (!Array.isArray(parentValue)) return [patch];
 		let items = patch.items.filter((item) => {
 			let itemKey = getKey(item);
@@ -355,7 +364,7 @@ function toMergeableMarkDefsPatches(patches, getCurrentValue) {
 		if (patch.type !== "set" || patch.path.at(-1) !== "markDefs" || !Array.isArray(patch.value)) return [patch];
 		let currentValue = getCurrentValue();
 		if (!currentValue) return [patch];
-		let root = currentValue, storeMarkDefs = getValueAtPath(root, patch.path), storeBlock = getValueAtPath(root, patch.path.slice(0, -1));
+		let root = currentValue, storeMarkDefs = getValueAtPath$1(root, patch.path), storeBlock = getValueAtPath$1(root, patch.path.slice(0, -1));
 		if (!Array.isArray(storeMarkDefs) || typeof storeBlock != "object" || !storeBlock) return [patch];
 		let local = patch.value, store = storeMarkDefs;
 		if (local.some((item) => item._key === void 0)) return [patch];
@@ -407,8 +416,8 @@ function canApplyToValue(patch, value) {
 	switch (patch.type) {
 		case "unset":
 		case "insert":
-		case "diffMatchPatch": return getValueAtPath(root, patch.path) !== void 0;
-		case "set": return patch.path.length === 0 || getValueAtPath(root, patch.path.slice(0, -1)) !== void 0;
+		case "diffMatchPatch": return getValueAtPath$1(root, patch.path) !== void 0;
+		case "set": return patch.path.length === 0 || getValueAtPath$1(root, patch.path.slice(0, -1)) !== void 0;
 		default: return !0;
 	}
 }
@@ -440,7 +449,7 @@ function scopeRemotePatches(patches, fieldPath) {
 	let prefix = arrayifyPath(fieldPath), converted = convertPatches(patches), scoped = [];
 	for (let patch of converted) {
 		let overlap = Math.min(patch.path.length, prefix.length), touchesField = !0;
-		for (let index = 0; index < overlap; index++) if (!segmentsEqual(patch.path[index], prefix[index])) {
+		for (let index = 0; index < overlap; index++) if (!segmentsEqual$1(patch.path[index], prefix[index])) {
 			touchesField = !1;
 			break;
 		}
@@ -691,14 +700,12 @@ function getPublishedDocumentId(id) {
 * @public
 */
 function SDKValuePlugin(props) {
-	let $ = c(20), { documentId, documentType, path } = props, setSdkValue = useEditDocument(props), instance = useSanityInstance(props), applyActions = useApplyDocumentActions(), t0;
-	$[0] !== documentId || $[1] !== documentType || $[2] !== instance || $[3] !== path ? (t0 = getDocumentState(instance, {
+	let $ = c(15), normalizedProps = normalizeDocumentHandle(props), { documentId, documentType, path } = normalizedProps, setSdkValue = useEditDocument(normalizedProps), instance = useSanityInstance(), applyActions = useApplyDocumentActions(), { getCurrent, subscribe } = getDocumentState(instance, {
 		documentId,
 		documentType,
 		path
-	}), $[0] = documentId, $[1] = documentType, $[2] = instance, $[3] = path, $[4] = t0) : t0 = $[4];
-	let { getCurrent, subscribe } = t0, t1;
-	$[5] !== documentId || $[6] !== instance || $[7] !== path ? (t1 = (callback) => subscribeDocumentEvents(instance, { eventHandler: (event) => {
+	}), t0;
+	$[0] !== documentId || $[1] !== instance || $[2] !== path ? (t0 = (callback) => subscribeDocumentEvents(instance, { eventHandler: (event) => {
 		let candidate = event;
 		if (!isRemotePatchesEvent(candidate) || candidate.origin !== "remote" || getPublishedDocumentId(candidate.documentId) !== getPublishedDocumentId(documentId)) return;
 		let patches;
@@ -708,9 +715,9 @@ function SDKValuePlugin(props) {
 			return;
 		}
 		patches && patches.length > 0 && callback(patches);
-	} }), $[5] = documentId, $[6] = instance, $[7] = path, $[8] = t1) : t1 = $[8];
-	let onRemotePatches = t1, t2;
-	$[9] !== applyActions || $[10] !== documentId || $[11] !== documentType || $[12] !== path ? (t2 = (patches_0) => {
+	} }), $[0] = documentId, $[1] = instance, $[2] = path, $[3] = t0) : t0 = $[3];
+	let onRemotePatches = t0, t1;
+	$[4] !== applyActions || $[5] !== documentId || $[6] !== documentType || $[7] !== path ? (t1 = (patches_0) => {
 		let sanityPatches = convertPatchesToSanity(patches_0, { prefix: path }), action = {
 			...editDocument({
 				documentId,
@@ -719,15 +726,15 @@ function SDKValuePlugin(props) {
 			preserveOperations: !0
 		};
 		applyActions(action);
-	}, $[9] = applyActions, $[10] = documentId, $[11] = documentType, $[12] = path, $[13] = t2) : t2 = $[13];
-	let pushPatches = t2, t3;
-	return $[14] !== getCurrent || $[15] !== onRemotePatches || $[16] !== pushPatches || $[17] !== setSdkValue || $[18] !== subscribe ? (t3 = /* @__PURE__ */ jsx(ValueSyncPlugin, {
+	}, $[4] = applyActions, $[5] = documentId, $[6] = documentType, $[7] = path, $[8] = t1) : t1 = $[8];
+	let pushPatches = t1, t2;
+	return $[9] !== getCurrent || $[10] !== onRemotePatches || $[11] !== pushPatches || $[12] !== setSdkValue || $[13] !== subscribe ? (t2 = /* @__PURE__ */ jsx(ValueSyncPlugin, {
 		getRemoteValue: getCurrent,
 		pushValue: setSdkValue,
 		onRemoteValueChange: subscribe,
 		onRemotePatches,
 		pushPatches
-	}), $[14] = getCurrent, $[15] = onRemotePatches, $[16] = pushPatches, $[17] = setSdkValue, $[18] = subscribe, $[19] = t3) : t3 = $[19], t3;
+	}), $[9] = getCurrent, $[10] = onRemotePatches, $[11] = pushPatches, $[12] = setSdkValue, $[13] = subscribe, $[14] = t2) : t2 = $[14], t2;
 }
 /**
 * NOTE: You are probably looking for SDKValuePlugin instead of this.
@@ -775,14 +782,16 @@ function ValueSyncPlugin(props) {
 * @public
 */
 function SDKPresencePlugin(props) {
-	let $ = c(7), handle, path;
-	$[0] === props ? (handle = $[1], path = $[2]) : ({path, ...handle} = props, $[0] = props, $[1] = handle, $[2] = path);
-	let selection = useLocalSelection(), fieldPath = useFieldPath(path), t0;
-	return $[3] !== fieldPath || $[4] !== handle || $[5] !== selection ? (t0 = {
+	let $ = c(9), t0;
+	$[0] === props ? t0 = $[1] : (t0 = normalizeDocumentHandle(props), $[0] = props, $[1] = t0);
+	let handle, path;
+	$[2] === t0 ? (handle = $[3], path = $[4]) : ({path, ...handle} = t0, $[2] = t0, $[3] = handle, $[4] = path);
+	let selection = useLocalSelection(), fieldPath = useFieldPath(path), t1;
+	return $[5] !== fieldPath || $[6] !== handle || $[7] !== selection ? (t1 = {
 		...handle,
 		path: fieldPath,
 		selection
-	}, $[3] = fieldPath, $[4] = handle, $[5] = selection, $[6] = t0) : t0 = $[6], useReportPresence(t0), null;
+	}, $[5] = fieldPath, $[6] = handle, $[7] = selection, $[8] = t1) : t1 = $[8], useReportPresence(t1), null;
 }
 /**
 * Other people's carets in a Portable Text field, as range decorations.
@@ -799,23 +808,25 @@ function SDKPresencePlugin(props) {
 * @public
 */
 function useSDKPresenceCursors(options) {
-	let $ = c(12), handle, path, renderCursor;
-	$[0] === options ? (handle = $[1], path = $[2], renderCursor = $[3]) : ({path, renderCursor, ...handle} = options, $[0] = options, $[1] = handle, $[2] = path, $[3] = renderCursor);
-	let fieldPath = useFieldPath(path), t0;
-	$[4] !== fieldPath || $[5] !== handle ? (t0 = {
+	let $ = c(14), t0;
+	$[0] === options ? t0 = $[1] : (t0 = normalizeDocumentHandle(options), $[0] = options, $[1] = t0);
+	let handle, path, renderCursor;
+	$[2] === t0 ? (handle = $[3], path = $[4], renderCursor = $[5]) : ({path, renderCursor, ...handle} = t0, $[2] = t0, $[3] = handle, $[4] = path, $[5] = renderCursor);
+	let fieldPath = useFieldPath(path), t1;
+	$[6] !== fieldPath || $[7] !== handle ? (t1 = {
 		...handle,
 		path: fieldPath,
 		excludeVersions: !0
-	}, $[4] = fieldPath, $[5] = handle, $[6] = t0) : t0 = $[6];
-	let { presence } = usePresenceForDocument(t0), t1;
-	$[7] === presence ? t1 = $[8] : (t1 = presence.flatMap(_temp), $[7] = presence, $[8] = t1);
-	let cursors = t1, t2;
-	return $[9] !== cursors || $[10] !== renderCursor ? (t2 = {
+	}, $[6] = fieldPath, $[7] = handle, $[8] = t1) : t1 = $[8];
+	let { presence } = usePresenceForDocument(t1), t2;
+	$[9] === presence ? t2 = $[10] : (t2 = presence.flatMap(_temp$1), $[9] = presence, $[10] = t2);
+	let cursors = t2, t3;
+	return $[11] !== cursors || $[12] !== renderCursor ? (t3 = {
 		cursors,
 		renderCursor
-	}, $[9] = cursors, $[10] = renderCursor, $[11] = t2) : t2 = $[11], useRemoteCursors(t2);
+	}, $[11] = cursors, $[12] = renderCursor, $[13] = t3) : t3 = $[13], useRemoteCursors(t3);
 }
-function _temp(participant) {
+function _temp$1(participant) {
 	return participant.selection ? [{
 		sessionId: participant.sessionId,
 		selection: participant.selection,
@@ -832,6 +843,339 @@ function useFieldPath(path) {
 	return $[0] === path ? t0 = $[1] : (t0 = arrayifyPath(path), $[0] = path, $[1] = t0), t0;
 }
 /**
+* How the Studio stores an inline comment's anchor: per Portable Text block the
+* selection touches, the block's entire plain text with these two private-use
+* characters inserted where the selection starts and ends. Text rather than
+* offsets, so the anchor can be re-found after the text around it changes.
+*/
+const COMMENT_INDICATORS = ["", ""], COMMENT_INDICATORS_REGEX = RegExp(`[${COMMENT_INDICATORS.join("")}]`, "g");
+function isTextBlock(node) {
+	return typeof node == "object" && !!node && Array.isArray(node.children) && typeof node._key == "string";
+}
+function isSpan$1(child) {
+	return child._type === "span" && typeof child.text == "string";
+}
+function getValueAtPath(value, path) {
+	let current = value;
+	for (let segment of path) {
+		if (typeof current != "object" || !current) return;
+		if (typeof segment == "string") current = current[segment];
+		else if (typeof segment == "number") current = Array.isArray(current) ? current[segment] : void 0;
+		else if (isKeyedSegment$1(segment)) current = Array.isArray(current) ? current.find((item) => typeof item == "object" && !!item && item._key === segment._key) : void 0;
+		else return;
+	}
+	return current;
+}
+function isKeyedSegment$1(segment) {
+	return typeof segment == "object" && !!segment && "_key" in segment;
+}
+function toPlainTextWithChildSeparators(block) {
+	return block.children.map((child) => isSpan$1(child) ? (child.text ?? "").replaceAll("", " ") : "").join("");
+}
+function diffText(current, next) {
+	let diff = makeDiff(current, next), diffs = cleanupEfficiency(diff);
+	return {
+		patches: makePatches(current, diffs, { margin: 15 }),
+		levenshtein: diffsLevenshtein(diffs)
+	};
+}
+function diffApply(current, patches) {
+	return applyPatches(patches, current, {
+		allowExceedingIndices: !0,
+		margin: 15
+	})[0];
+}
+/**
+* Finds each stored anchor in the current editor value.
+*
+* A direct port of the Studio's `buildRangeDecorationSelectionsFromComments`,
+* minus its Studio-only inputs. The stored text is diffed against the block's
+* current text, so an anchor survives edits around it and inside it up to a
+* similarity threshold. An anchor whose text is gone, or changed beyond
+* recognition, is dropped rather than drawn somewhere wrong.
+*
+* Live tracking while the user types is not this function's job: the editor's
+* `RangeDecoration.onMoved` does that. This runs when comments load or change.
+*/
+function resolveCommentSelections(options) {
+	let { value, comments } = options, anchored = [];
+	for (let { commentId, relativePath, selection } of comments) for (let selectionMember of selection.value) {
+		let container = relativePath.length > 0 ? getValueAtPath(value, relativePath) : value, matchedBlock = Array.isArray(container) ? container.find((block) => isTextBlock(block) && block._key === selectionMember._key) : void 0;
+		if (!matchedBlock || !isTextBlock(matchedBlock)) continue;
+		let selectionText = selectionMember.text.replaceAll(COMMENT_INDICATORS_REGEX, ""), textWithChildSeparators = toPlainTextWithChildSeparators(matchedBlock), { patches } = diffText(selectionText, selectionMember.text), diffedText = diffApply(textWithChildSeparators, patches), startIndex = diffedText.indexOf(COMMENT_INDICATORS[0]), endIndex = diffedText.replaceAll(COMMENT_INDICATORS[0], "").indexOf(COMMENT_INDICATORS[1]), textWithoutCommentTags = diffedText.replaceAll(COMMENT_INDICATORS_REGEX, "");
+		if (startIndex === -1 || endIndex === -1) continue;
+		let oldCommentedText = selectionMember.text.slice(selectionMember.text.indexOf(COMMENT_INDICATORS[0]) + 1, selectionMember.text.indexOf(COMMENT_INDICATORS[1])), newCommentedText = textWithoutCommentTags.slice(startIndex, endIndex), { levenshtein } = diffText(newCommentedText, oldCommentedText), threshold = Math.round(newCommentedText.length + oldCommentedText.length / 2);
+		if (newCommentedText.length === 0 || levenshtein > threshold || startIndex + 1 === endIndex) continue;
+		let childIndexAnchor = 0, anchorOffset = 0, childIndexFocus = 0, focusOffset = 0;
+		for (let i = 0; i < textWithoutCommentTags.length && (textWithoutCommentTags[i] === "" && (i <= startIndex && (anchorOffset = -1, childIndexAnchor++), focusOffset = -1, childIndexFocus++), i < startIndex && anchorOffset++, i < startIndex + newCommentedText.length && focusOffset++, i !== startIndex + newCommentedText.length); i++);
+		anchored.push({
+			commentId,
+			selection: {
+				anchor: {
+					path: [
+						...relativePath,
+						{ _key: matchedBlock._key },
+						"children",
+						{ _key: matchedBlock.children[childIndexAnchor]._key }
+					],
+					offset: anchorOffset
+				},
+				focus: {
+					path: [
+						...relativePath,
+						{ _key: matchedBlock._key },
+						"children",
+						{ _key: matchedBlock.children[childIndexFocus]._key }
+					],
+					offset: focusOffset
+				}
+			}
+		});
+	}
+	return anchored;
+}
+function diffsLevenshtein(diffs) {
+	let levenshtein = 0, insertions = 0, deletions = 0;
+	for (let [op, data] of diffs) switch (op) {
+		case DIFF_INSERT:
+			insertions += data.length;
+			break;
+		case DIFF_DELETE:
+			deletions += data.length;
+			break;
+		case DIFF_EQUAL: levenshtein += Math.max(insertions, deletions), insertions = 0, deletions = 0;
+	}
+	return levenshtein += Math.max(insertions, deletions), levenshtein;
+}
+/**
+* Reduces a comment's stored field path to a path inside this editor.
+*
+* `undefined` means the comment belongs to some other editor: a different
+* field, a sibling container, or a stored path that does not parse. Skipping
+* those is what lets several editors on one document each decorate only their
+* own comments.
+*/
+function relativeCommentPath(basePath, fieldPath) {
+	let parsed;
+	try {
+		parsed = arrayifyPath(fieldPath);
+	} catch {
+		return;
+	}
+	if (!(parsed.length < basePath.length)) {
+		for (let i = 0; i < basePath.length; i++) if (!segmentsEqual(basePath[i], parsed[i])) return;
+		return parsed.slice(basePath.length);
+	}
+}
+function segmentsEqual(a, b) {
+	return isKeyedSegment$1(a) && isKeyedSegment$1(b) ? a._key === b._key : a === b;
+}
+/**
+* Turns the current editor selection into the stored comment anchor.
+*
+* Per selected block, the block's entire plain text with the selection
+* boundaries marked by the two indicator characters. The write-time mirror of
+* `resolveCommentSelections`, and deliberately built the way the Studio builds
+* it so a comment written here re-anchors there and back.
+*
+* Returns `null` when there is nothing commentable: a collapsed selection,
+* no selected text, or a selection spanning blocks from different containing
+* arrays, which a single stored path cannot describe.
+*/
+function buildStoredSelection(options) {
+	let { selection, selectedBlocks } = options;
+	if (!selection || selectedBlocks.length === 0) return null;
+	let [start, end] = selection.backward ? [selection.focus, selection.anchor] : [selection.anchor, selection.focus], containerPath = selectedBlocks[0].path.slice(0, -1);
+	if (!selectedBlocks.every((selected) => pathsEqual(selected.path.slice(0, -1), containerPath))) return null;
+	let selectedCharacters = 0, value = selectedBlocks.map((selected, index) => {
+		let isFirst = index === 0, isLast = index === selectedBlocks.length - 1, plain = plainText(selected.node), from = isFirst ? plainOffset(selected.node, start.path, start.offset) : 0, to = isLast ? plainOffset(selected.node, end.path, end.offset) : plain.length;
+		return selectedCharacters += Math.max(0, to - from), {
+			_key: selected.node._key,
+			text: `${plain.slice(0, from)}${COMMENT_INDICATORS[0]}${plain.slice(from, to)}${COMMENT_INDICATORS[1]}${plain.slice(to)}`
+		};
+	});
+	return selectedCharacters === 0 ? null : {
+		containerPath,
+		selection: {
+			type: "text",
+			value
+		}
+	};
+}
+function plainText(block) {
+	return block.children.map((child) => isSpan(child) ? child.text ?? "" : "").join("");
+}
+/**
+* Converts a selection point into an offset within the block's plain text: the
+* text of every span before the point's child, plus the offset inside it. A
+* point whose child is not in this block clamps to the block edge, which is
+* where a cross-block selection boundary lands.
+*/
+function plainOffset(block, pointPath, offset) {
+	let childSegment = pointPath[pointPath.length - 1];
+	if (!isKeyedSegment(childSegment)) return offset;
+	let total = 0;
+	for (let child of block.children) {
+		if (child._key === childSegment._key) return total + (isSpan(child) ? offset : 0);
+		isSpan(child) && (total += (child.text ?? "").length);
+	}
+	return total;
+}
+function isSpan(child) {
+	return child._type === "span" && typeof child.text == "string";
+}
+function isKeyedSegment(segment) {
+	return typeof segment == "object" && !!segment && "_key" in segment;
+}
+function pathsEqual(a, b) {
+	return a.length === b.length && a.every((segment, index) => {
+		let other = b[index];
+		return isKeyedSegment(segment) && isKeyedSegment(other) ? segment._key === other._key : segment === other;
+	});
+}
+const NO_MOVES = {};
+/**
+* Anchors count as unchanged when every comment still sits at the same spot,
+* so resolving on each editor emission only re-renders when a highlight
+* actually needs to draw somewhere else.
+*/
+function sameAnchors(a, b) {
+	return a.length === b.length && a.every((anchor, index) => {
+		let other = b[index];
+		return anchor.commentId === other.commentId && samePoint(anchor.selection.anchor, other.selection.anchor) && samePoint(anchor.selection.focus, other.selection.focus);
+	});
+}
+function samePoint(a, b) {
+	return a.offset !== b.offset || a.path.length !== b.path.length ? !1 : a.path.every((segment, index) => {
+		let other = b.path[index];
+		return typeof segment == "object" && segment && typeof other == "object" && other ? segment._key === other._key : segment === other;
+	});
+}
+/**
+* Inline comment highlights for a Portable Text field, as range decorations.
+*
+* Pass the result to `<PortableTextEditable rangeDecorations={...} />`. Each
+* thread's first comment that carries a text anchor on this field gets one
+* decoration. Highlights stay put while the local user types, and a highlight
+* whose text has been deleted or rewritten beyond recognition is dropped
+* rather than drawn on the wrong words.
+*
+* Suspends while the document's comments load, like every SDK read hook.
+*
+* Resolved threads draw nothing: this mirrors the Studio, where resolving a
+* thread removes its highlight from the text.
+*
+* @public
+*/
+function useSDKCommentDecorations(options) {
+	let $ = c(19), handle, path, renderDecoration;
+	$[0] === options ? (handle = $[1], path = $[2], renderDecoration = $[3]) : ({path, renderDecoration, ...handle} = options, $[0] = options, $[1] = handle, $[2] = path, $[3] = renderDecoration);
+	let editor = useEditor(), t0;
+	$[4] === handle ? t0 = $[5] : (t0 = { ...handle }, $[4] = handle, $[5] = t0);
+	let { comments } = useComments(t0), t1;
+	if ($[6] !== comments || $[7] !== path) {
+		let basePath = arrayifyPath(path);
+		t1 = comments.flatMap((comment) => {
+			if (comment.parentCommentId || !comment.selection || comment.status !== "open") return [];
+			let relativePath = relativeCommentPath(basePath, comment.fieldPath);
+			return relativePath === void 0 ? [] : [{
+				comment,
+				relativePath,
+				selection: comment.selection
+			}];
+		}), $[6] = comments, $[7] = path, $[8] = t1;
+	} else t1 = $[8];
+	let inline = t1, t2;
+	$[9] === inline ? t2 = $[10] : (t2 = (snapshot) => resolveCommentSelections({
+		value: snapshot.context.value,
+		comments: inline.map(_temp)
+	}), $[9] = inline, $[10] = t2);
+	let anchored = useEditorSelector(editor, t2, sameAnchors), t3;
+	$[11] === Symbol.for("react.memo_cache_sentinel") ? (t3 = {}, $[11] = t3) : t3 = $[11];
+	let t4;
+	$[12] === inline ? t4 = $[13] : (t4 = {
+		forComments: inline,
+		selections: t3
+	}, $[12] = inline, $[13] = t4);
+	let [moved, setMoved] = useState(t4), movedSelections = moved.forComments === inline ? moved.selections : NO_MOVES, t5;
+	if ($[14] !== anchored || $[15] !== inline || $[16] !== movedSelections || $[17] !== renderDecoration) {
+		let commentsById = new Map(inline.map(_temp2));
+		t5 = anchored.flatMap((anchor) => {
+			let comment_2 = commentsById.get(anchor.commentId);
+			if (!comment_2) return [];
+			let movedSelection = movedSelections[anchor.commentId], selection_0 = movedSelection === void 0 ? anchor.selection : movedSelection;
+			return selection_0 === null ? [] : [{
+				component: renderDecoration(comment_2),
+				selection: selection_0,
+				onMoved: (t6) => {
+					let { newSelection } = t6;
+					setMoved((previous) => ({
+						forComments: inline,
+						selections: {
+							...previous.forComments === inline ? previous.selections : {},
+							[anchor.commentId]: newSelection
+						}
+					}));
+				},
+				payload: { commentId: anchor.commentId }
+			}];
+		}), $[14] = anchored, $[15] = inline, $[16] = movedSelections, $[17] = renderDecoration, $[18] = t5;
+	} else t5 = $[18];
+	return t5;
+}
+function _temp2(t0) {
+	let { comment: comment_1 } = t0;
+	return [comment_1.id, comment_1];
+}
+function _temp(t0) {
+	let { comment: comment_0, relativePath: relativePath_0, selection } = t0;
+	return {
+		commentId: comment_0.id,
+		relativePath: relativePath_0,
+		selection
+	};
+}
+/** Reports the selection when it can take a comment, `null` otherwise. */
+function getCommentableSelection(snapshot) {
+	let selection = getSelection(snapshot);
+	return buildStoredSelection({
+		selection,
+		selectedBlocks: getSelectedTextBlocks(snapshot)
+	}) ? selection : null;
+}
+/**
+* Lets the app author inline comments on a Portable Text field.
+*
+* The plugin captures the selection and writes the comment; the composer UI is
+* the app's, the same split the Studio and Canvas use. Comments are written in
+* the shape the Studio stores, so a thread started here shows up there.
+*
+* @public
+*/
+function useSDKCommentAuthoring(options) {
+	let $ = c(11), handle, path;
+	$[0] === options ? (handle = $[1], path = $[2]) : ({path, ...handle} = options, $[0] = options, $[1] = handle, $[2] = path);
+	let editor = useEditor(), { createComment } = useCommentActions(), commentableSelection = useEditorSelector(editor, getCommentableSelection, isEqualSelections), t0;
+	$[3] !== createComment || $[4] !== editor || $[5] !== handle || $[6] !== path ? (t0 = (t1) => {
+		let { message, commentId } = t1, snapshot = editor.getSnapshot(), built = buildStoredSelection({
+			selection: getSelection(snapshot),
+			selectedBlocks: getSelectedTextBlocks(snapshot)
+		});
+		return built ? createComment({
+			...handle,
+			fieldPath: stringifyPath([...arrayifyPath(path), ...built.containerPath]),
+			selection: built.selection,
+			message,
+			...commentId === void 0 ? {} : { commentId }
+		}) : Promise.reject(/* @__PURE__ */ Error("Nothing commentable is selected, so there is nothing to anchor the comment to."));
+	}, $[3] = createComment, $[4] = editor, $[5] = handle, $[6] = path, $[7] = t0) : t0 = $[7];
+	let t1;
+	return $[8] !== commentableSelection || $[9] !== t0 ? (t1 = {
+		commentableSelection,
+		createInlineComment: t0
+	}, $[8] = commentableSelection, $[9] = t0, $[10] = t1) : t1 = $[10], t1;
+}
+/**
 * Mid-tone hues, so a caret stays legible whether the app is light or dark. This
 * package cannot read the app's theme, so it does not try.
 */
@@ -977,16 +1321,15 @@ function SDKPortableTextEditable(props) {
 * @internal
 */
 function splitEditableProps(props) {
-	let { documentId, documentType, projectId, dataset, resource, resourceName, source, liveEdit, perspective, path, renderCursor, rangeDecorations, ...editableProps } = props;
+	let normalizedProps = normalizeDocumentHandle(props), { documentId, documentType, projectId, dataset, resource, resourceName, liveEdit, perspective, path, renderCursor, rangeDecorations, ...editableProps } = normalizedProps;
 	return {
 		handle: {
 			documentId,
 			documentType,
 			..."projectId" in props && { projectId },
 			..."dataset" in props && { dataset },
-			..."resource" in props && { resource },
+			..."resource" in normalizedProps && { resource },
 			..."resourceName" in props && { resourceName },
-			..."source" in props && { source },
 			..."liveEdit" in props && { liveEdit },
 			..."perspective" in props && { perspective }
 		},
@@ -1021,6 +1364,6 @@ function resolveCursorRenderer(renderCursor) {
 function mergePresenceDecorations(rangeDecorations, cursors, drawCursors) {
 	return drawCursors ? [...rangeDecorations ?? [], ...cursors] : rangeDecorations;
 }
-export { SDKPortableTextEditable, SDKPresencePlugin, SDKValuePlugin, ValueSyncPlugin, useSDKPresenceCursors };
+export { SDKPortableTextEditable, SDKPresencePlugin, SDKValuePlugin, ValueSyncPlugin, useSDKCommentAuthoring, useSDKCommentDecorations, useSDKPresenceCursors };
 
 //# sourceMappingURL=index.js.map