superdoc 1.15.0 → 1.15.1-next.2

package/dist/chunks/{SuperConverter-BsXuivNG.cjs → SuperConverter-Byxnduvh.cjs}

@@ -33843,7 +33843,7 @@ var SuperConverter = class SuperConverter {
 	static getStoredSuperdocVersion(docx) {
 		return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
 	}
-	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.15.0") {
+	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.15.1-next.2") {
 		return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
 	}
 	static generateWordTimestamp() {

package/dist/chunks/{SuperConverter-Cv8wefny.es.js → SuperConverter-mYJUjRBF.es.js}

@@ -33829,7 +33829,7 @@ var SuperConverter = class SuperConverter {
 	static getStoredSuperdocVersion(docx) {
 		return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
 	}
-	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.15.0") {
+	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.15.1-next.2") {
 		return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
 	}
 	static generateWordTimestamp() {

package/dist/chunks/{src-PPicsAhf.cjs → src-BLs36rcx.cjs}

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require("./rolldown-runtime-Dp2H1eGw.cjs");
-const require_SuperConverter = require("./SuperConverter-BsXuivNG.cjs");
+const require_SuperConverter = require("./SuperConverter-Byxnduvh.cjs");
 const require_jszip = require("./jszip-DCT9QYaK.cjs");
 const require_uuid = require("./uuid-CHj_rjgt.cjs");
 const require_constants = require("./constants-CpniKo9Z.cjs");
@@ -243,7 +243,7 @@ var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 const COMMUNITY_LICENSE_KEY = "community-and-eval-agplv3";
 function getSuperdocVersion() {
 	try {
-		return "1.15.0";
+		return "1.15.1-next.2";
 	} catch {
 		return "unknown";
 	}
@@ -5083,7 +5083,7 @@ const LOWEST_INT32 = 1 << 31;
 const HIGHEST_INT32 = BITS31;
 const HIGHEST_UINT32 = BITS32;
 /* c8 ignore next */
-const isInteger = Number.isInteger || ((num) => typeof num === "number" && isFinite(num) && floor(num) === num);
+const isInteger$1 = Number.isInteger || ((num) => typeof num === "number" && isFinite(num) && floor(num) === num);
 const isNaN$1 = Number.isNaN;
 const parseInt$1 = Number.parseInt;
 const create$2 = () => /* @__PURE__ */ new Set();
@@ -5252,7 +5252,7 @@ const writeAny = (encoder, data) => {
 			writeVarString(encoder, data);
 			break;
 		case "number":
-			if (isInteger(data) && abs(data) <= 2147483647) {
+			if (isInteger$1(data) && abs(data) <= 2147483647) {
 				write$1(encoder, 125);
 				writeVarInt(encoder, data);
 			} else if (isFloat32(data)) {
@@ -17576,7 +17576,7 @@ var require_lodash = /* @__PURE__ */ require_rolldown_runtime.__commonJSMin(((ex
 				var tag = baseGetTag$1(value);
 				return tag == funcTag$2 || tag == genTag$1 || tag == asyncTag$1 || tag == proxyTag$1;
 			}
-			function isInteger$1(value) {
+			function isInteger$2(value) {
 				return typeof value == "number" && value == toInteger(value);
 			}
 			function isLength$1(value) {
@@ -17622,7 +17622,7 @@ var require_lodash = /* @__PURE__ */ require_rolldown_runtime.__commonJSMin(((ex
 			}
 			var isRegExp$1 = nodeIsRegExp ? baseUnary$1(nodeIsRegExp) : baseIsRegExp;
 			function isSafeInteger(value) {
-				return isInteger$1(value) && value >= -MAX_SAFE_INTEGER$3 && value <= MAX_SAFE_INTEGER$3;
+				return isInteger$2(value) && value >= -MAX_SAFE_INTEGER$3 && value <= MAX_SAFE_INTEGER$3;
 			}
 			var isSet = nodeIsSet ? baseUnary$1(nodeIsSet) : baseIsSet;
 			function isString(value) {
@@ -18548,7 +18548,7 @@ var require_lodash = /* @__PURE__ */ require_rolldown_runtime.__commonJSMin(((ex
 			lodash.isError = isError;
 			lodash.isFinite = isFinite$1;
 			lodash.isFunction = isFunction$1;
-			lodash.isInteger = isInteger$1;
+			lodash.isInteger = isInteger$2;
 			lodash.isLength = isLength$1;
 			lodash.isMap = isMap;
 			lodash.isMatch = isMatch$1;
@@ -20693,7 +20693,7 @@ const canUseDOM = () => {
 		return false;
 	}
 };
-var summaryVersion = "1.15.0";
+var summaryVersion = "1.15.1-next.2";
 var nodeKeys = [
 	"group",
 	"content",
@@ -21192,7 +21192,7 @@ const OPERATION_DEFINITIONS = {
 			supportsDryRun: true,
 			supportsTrackedMode: true,
 			possibleFailureCodes: ["INVALID_TARGET", "NO_OP"],
-			throws: T_NOT_FOUND_TRACKED
+			throws: [...T_NOT_FOUND_TRACKED, "INVALID_TARGET"]
 		}),
 		referenceDocPath: "insert.mdx",
 		referenceGroup: "core"
@@ -22102,6 +22102,29 @@ var capabilitiesOutputSchema = objectSchema({
 	operations: operationCapabilitiesSchema
 }, ["global", "operations"]);
 var strictEmptyObjectSchema = objectSchema({});
+var insertInputSchema = {
+	...objectSchema({
+		target: textAddressSchema,
+		text: { type: "string" },
+		blockId: {
+			type: "string",
+			description: "Block ID for block-relative targeting."
+		},
+		offset: {
+			type: "integer",
+			minimum: 0,
+			description: "Character offset within the block identified by blockId."
+		}
+	}, ["text"]),
+	allOf: [
+		{ not: { required: ["target", "blockId"] } },
+		{ not: { required: ["target", "offset"] } },
+		{
+			if: { required: ["offset"] },
+			then: { required: ["blockId"] }
+		}
+	]
+};
 var operationSchemas = {
 	find: {
 		input: findInputSchema,
@@ -22127,10 +22150,7 @@ var operationSchemas = {
 		output: documentInfoSchema
 	},
 	insert: {
-		input: objectSchema({
-			target: textAddressSchema,
-			text: { type: "string" }
-		}, ["text"]),
+		input: insertInputSchema,
 		output: textMutationResultSchemaFor("insert"),
 		success: textMutationSuccessSchema,
 		failure: textMutationFailureSchemaFor("insert")
@@ -22546,14 +22566,83 @@ function executeDelete(adapter, input, options) {
 		text: ""
 	}, options);
 }
+var DocumentApiValidationError = class DocumentApiValidationError extends Error {
+	constructor(code$1, message, details) {
+		super(message);
+		this.name = "DocumentApiValidationError";
+		this.code = code$1;
+		this.details = details;
+		Object.setPrototypeOf(this, DocumentApiValidationError.prototype);
+	}
+};
+var INSERT_INPUT_ALLOWED_KEYS = new Set([
+	"text",
+	"target",
+	"blockId",
+	"offset"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value != null && !Array.isArray(value);
+}
+function isInteger(value) {
+	return typeof value === "number" && Number.isInteger(value);
+}
+function isTextAddress(value) {
+	if (!isRecord(value)) return false;
+	if (value.kind !== "text") return false;
+	if (typeof value.blockId !== "string") return false;
+	const range = value.range;
+	if (!isRecord(range)) return false;
+	if (!isInteger(range.start) || !isInteger(range.end)) return false;
+	return range.start <= range.end;
+}
+function validateInsertInput(input) {
+	if (!isRecord(input)) throw new DocumentApiValidationError("INVALID_TARGET", "Insert input must be a non-null object.");
+	const inputObj = input;
+	if ("pos" in inputObj) throw new DocumentApiValidationError("INVALID_TARGET", "pos locator is not yet supported.", { field: "pos" });
+	for (const key$1 of Object.keys(inputObj)) if (!INSERT_INPUT_ALLOWED_KEYS.has(key$1)) throw new DocumentApiValidationError("INVALID_TARGET", `Unknown field "${key$1}" on insert input. Allowed fields: ${[...INSERT_INPUT_ALLOWED_KEYS].join(", ")}.`, { field: key$1 });
+	const { target, text, blockId, offset: offset$1 } = inputObj;
+	const hasTarget = target !== void 0;
+	const hasBlockId = blockId !== void 0;
+	const hasOffset = offset$1 !== void 0;
+	if (hasTarget && !isTextAddress(target)) throw new DocumentApiValidationError("INVALID_TARGET", "target must be a text address object.", {
+		field: "target",
+		value: target
+	});
+	if (typeof text !== "string") throw new DocumentApiValidationError("INVALID_TARGET", `text must be a string, got ${typeof text}.`, {
+		field: "text",
+		value: text
+	});
+	if (hasBlockId && typeof blockId !== "string") throw new DocumentApiValidationError("INVALID_TARGET", `blockId must be a string, got ${typeof blockId}.`, {
+		field: "blockId",
+		value: blockId
+	});
+	if (hasTarget && hasBlockId) throw new DocumentApiValidationError("INVALID_TARGET", "Cannot combine target with blockId. Use exactly one locator mode.", { fields: ["target", "blockId"] });
+	if (hasTarget && hasOffset) throw new DocumentApiValidationError("INVALID_TARGET", "Cannot combine target with offset. Use exactly one locator mode.", { fields: ["target", "offset"] });
+	if (hasOffset && !hasBlockId) throw new DocumentApiValidationError("INVALID_TARGET", "offset requires blockId.", { fields: ["offset", "blockId"] });
+	if (hasOffset) {
+		if (typeof offset$1 !== "number" || !Number.isInteger(offset$1) || offset$1 < 0) throw new DocumentApiValidationError("INVALID_TARGET", `offset must be a non-negative integer, got ${JSON.stringify(offset$1)}.`, {
+			field: "offset",
+			value: offset$1
+		});
+	}
+}
 function executeInsert(adapter, input, options) {
-	return executeWrite(adapter, input.target ? {
+	validateInsertInput(input);
+	const { target, blockId, offset: offset$1, text } = input;
+	if (blockId !== void 0) return executeWrite(adapter, {
 		kind: "insert",
-		target: input.target,
-		text: input.text
+		blockId,
+		offset: offset$1,
+		text
+	}, options);
+	return executeWrite(adapter, target ? {
+		kind: "insert",
+		target,
+		text
 	} : {
 		kind: "insert",
-		text: input.text
+		text
 	}, options);
 }
 function executeListsList(adapter, query) {
@@ -25874,6 +25963,28 @@ function validateWriteRequest(request, resolvedTarget) {
 	};
 	return null;
 }
+function normalizeInsertLocator(request) {
+	if (request.kind !== "insert") return request;
+	const hasBlockId = request.blockId !== void 0;
+	const hasOffset = request.offset !== void 0;
+	if (hasOffset && request.target) throw new DocumentApiAdapterError("INVALID_TARGET", "Cannot combine target with offset on insert request.", { fields: ["target", "offset"] });
+	if (hasOffset && !hasBlockId) throw new DocumentApiAdapterError("INVALID_TARGET", "offset requires blockId on insert request.", { fields: ["offset", "blockId"] });
+	if (!hasBlockId) return request;
+	if (request.target) throw new DocumentApiAdapterError("INVALID_TARGET", "Cannot combine target with blockId on insert request.", { fields: ["target", "blockId"] });
+	const effectiveOffset = request.offset ?? 0;
+	return {
+		kind: "insert",
+		target: {
+			kind: "text",
+			blockId: request.blockId,
+			range: {
+				start: effectiveOffset,
+				end: effectiveOffset
+			}
+		},
+		text: request.text
+	};
+}
 function resolveWriteTarget(editor, request) {
 	const requestedTarget = request.target;
 	if (request.kind === "insert" && !request.target) {
@@ -25961,9 +26072,10 @@ function toFailureReceipt(failure, resolvedTarget) {
 	};
 }
 function writeAdapter(editor, request, options) {
-	const resolvedTarget = resolveWriteTarget(editor, request);
-	if (!resolvedTarget) throw new DocumentApiAdapterError("TARGET_NOT_FOUND", "Mutation target could not be resolved.", { target: request.target });
-	const validationFailure = validateWriteRequest(request, resolvedTarget);
+	const normalizedRequest = normalizeInsertLocator(request);
+	const resolvedTarget = resolveWriteTarget(editor, normalizedRequest);
+	if (!resolvedTarget) throw new DocumentApiAdapterError("TARGET_NOT_FOUND", "Mutation target could not be resolved.", { target: normalizedRequest.target });
+	const validationFailure = validateWriteRequest(normalizedRequest, resolvedTarget);
 	if (validationFailure) return toFailureReceipt(validationFailure, resolvedTarget);
 	const mode = options?.changeMode ?? "direct";
 	if (options?.dryRun) {
@@ -25973,8 +26085,8 @@ function writeAdapter(editor, request, options) {
 			resolution: resolvedTarget.resolution
 		};
 	}
-	if (mode === "tracked") return applyTrackedWrite(editor, request, resolvedTarget);
-	return applyDirectWrite(editor, request, resolvedTarget);
+	if (mode === "tracked") return applyTrackedWrite(editor, normalizedRequest, resolvedTarget);
+	return applyDirectWrite(editor, normalizedRequest, resolvedTarget);
 }
 function getDocumentApiAdapters(editor) {
 	return {
@@ -27388,7 +27500,7 @@ var Editor = class Editor extends EventEmitter$1 {
 		return migrations.length > 0;
 	}
 	processCollaborationMigrations() {
-		console.debug("[checkVersionMigrations] Current editor version", "1.15.0");
+		console.debug("[checkVersionMigrations] Current editor version", "1.15.1-next.2");
 		if (!this.options.ydoc) return;
 		let docVersion = this.options.ydoc.getMap("meta").get("version");
 		if (!docVersion) docVersion = "initial";
@@ -89745,8 +89857,18 @@ function getItems(context, customItems = [], includeDefaultItems = true) {
 					action: async (editor$1) => {
 						const { view } = editor$1 ?? {};
 						if (!view) return;
-						view.dom.focus();
+						const savedFrom = view.state.selection.from;
+						const savedTo = view.state.selection.to;
+						view.focus();
 						const { html, text } = await readClipboardRaw();
+						if (view.state?.doc?.content) {
+							const { tr, doc: doc$2 } = view.state;
+							const maxPos = doc$2.content.size;
+							const safeFrom = Math.min(savedFrom, maxPos);
+							const safeTo = Math.min(savedTo, maxPos);
+							const SelectionType = view.state.selection.constructor;
+							if (typeof SelectionType.create === "function") view.dispatch(tr.setSelection(SelectionType.create(doc$2, safeFrom, safeTo)));
+						}
 						if (!(html ? require_SuperConverter.handleClipboardPaste({
 							editor: editor$1,
 							view

package/dist/chunks/{src-9JS9WrsR.es.js → src-CSEqymEk.es.js}

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, n as __esmMin, r as __export, t as __commonJSMin } from "./rolldown-runtime-B2q5OVn9.es.js";
-import { $ as TextSelection$1, A as findMark, At as Mark$1, B as defaultBlockAt$1, C as docxNumberingHelpers, Ct as TrackDeleteMarkName, D as posToDOMRect, Dt as DOMParser$1, E as isInTable, Et as carbonCopy, F as isMarkActive, Ft as getExtensionConfigField, G as createDocument, H as getNodeType, I as getMarkRange, J as NodeSelection, K as AllSelection, L as isTextSelection, M as isActive, Mt as Slice, N as isNodeActive, Nt as minMax, O as findChildren$1, Ot as DOMSerializer, P as getSchemaTypeNameByName, Pt as callOrGet, Q as SelectionRange, R as findParentNode, S as getResolvedParagraphProperties, St as getUnderlineCssString, T as CommandService, Tt as TrackInsertMarkName, U as cleanSchemaItem, V as getMarkType, W as getSchemaTypeByName, X as PluginKey, Y as Plugin, Z as Selection, _ as ListHelpers, _t as encodeMarksFromRPr, a as _getReferencedTableStyles, at as Transform, b as isList, bt as resolveRunProperties, c as processContent, ct as dropPoint, d as createCellBorders, dt as replaceStep$1, et as AddMarkStep, f as InputRule, ft as generateDocxRandomId, g as unflattenListsInHtml, gt as encodeCSSFromRPr, h as inputRulesPlugin, ht as encodeCSSFromPPr, it as ReplaceStep, j as getMarksFromSelection, jt as Schema$1, k as getActiveFormatting, kt as Fragment$1, l as createDocFromMarkdown, lt as joinPoint, m as htmlHandler, mt as decodeRPrFromMarks, n as kebabCase$1, nt as RemoveMarkStep, o as helpers_exports, ot as canJoin, p as handleClipboardPaste, pt as generateRandomSigned32BitIntStrId, q as EditorState, r as insertNewRelationship, rt as ReplaceAroundStep$1, s as updateDOMAttributes, st as canSplit, t as SuperConverter, tt as Mapping, u as createDocFromHTML, ut as liftTarget, v as changeListLevel, vt as resolveDocxFontFamily, w as generateOrderedListIndex, wt as TrackFormatMarkName, x as calculateResolvedParagraphProperties, xt as resolveTableCellProperties, y as updateNumberingProperties, yt as resolveParagraphProperties, z as findParentNodeClosestToPos } from "./SuperConverter-Cv8wefny.es.js";
+import { $ as TextSelection$1, A as findMark, At as Mark$1, B as defaultBlockAt$1, C as docxNumberingHelpers, Ct as TrackDeleteMarkName, D as posToDOMRect, Dt as DOMParser$1, E as isInTable, Et as carbonCopy, F as isMarkActive, Ft as getExtensionConfigField, G as createDocument, H as getNodeType, I as getMarkRange, J as NodeSelection, K as AllSelection, L as isTextSelection, M as isActive, Mt as Slice, N as isNodeActive, Nt as minMax, O as findChildren$1, Ot as DOMSerializer, P as getSchemaTypeNameByName, Pt as callOrGet, Q as SelectionRange, R as findParentNode, S as getResolvedParagraphProperties, St as getUnderlineCssString, T as CommandService, Tt as TrackInsertMarkName, U as cleanSchemaItem, V as getMarkType, W as getSchemaTypeByName, X as PluginKey, Y as Plugin, Z as Selection, _ as ListHelpers, _t as encodeMarksFromRPr, a as _getReferencedTableStyles, at as Transform, b as isList, bt as resolveRunProperties, c as processContent, ct as dropPoint, d as createCellBorders, dt as replaceStep$1, et as AddMarkStep, f as InputRule, ft as generateDocxRandomId, g as unflattenListsInHtml, gt as encodeCSSFromRPr, h as inputRulesPlugin, ht as encodeCSSFromPPr, it as ReplaceStep, j as getMarksFromSelection, jt as Schema$1, k as getActiveFormatting, kt as Fragment$1, l as createDocFromMarkdown, lt as joinPoint, m as htmlHandler, mt as decodeRPrFromMarks, n as kebabCase$1, nt as RemoveMarkStep, o as helpers_exports, ot as canJoin, p as handleClipboardPaste, pt as generateRandomSigned32BitIntStrId, q as EditorState, r as insertNewRelationship, rt as ReplaceAroundStep$1, s as updateDOMAttributes, st as canSplit, t as SuperConverter, tt as Mapping, u as createDocFromHTML, ut as liftTarget, v as changeListLevel, vt as resolveDocxFontFamily, w as generateOrderedListIndex, wt as TrackFormatMarkName, x as calculateResolvedParagraphProperties, xt as resolveTableCellProperties, y as updateNumberingProperties, yt as resolveParagraphProperties, z as findParentNodeClosestToPos } from "./SuperConverter-mYJUjRBF.es.js";
 import { a as init_dist$2, i as global, n as init_dist, o as Buffer$3, r as process$1, s as init_dist$1 } from "./jszip-ChlR43oI.es.js";
 import { t as v4_default } from "./uuid-2IzDu5nl.es.js";
 import { A as resolveOpcTargetPath, E as pixelsToTwips, F as twipsToLines, I as twipsToPixels, P as twipsToInches, _ as halfPointToPoints, c as convertSizeToCSS, k as ptToTwips, p as getArrayBufferFromUrl, t as COMMENT_FILE_BASENAMES, v as inchesToPixels, x as linesToTwips, y as inchesToTwips } from "./constants-DBKi0Amm.es.js";
@@ -242,7 +242,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "1.15.0";
+		return "1.15.1-next.2";
 	} catch {
 		return "unknown";
 	}
@@ -5072,7 +5072,7 @@ BIT31 - 1;
 const MAX_SAFE_INTEGER$2 = Number.MAX_SAFE_INTEGER;
 const MIN_SAFE_INTEGER = Number.MIN_SAFE_INTEGER;
 /* c8 ignore next */
-const isInteger = Number.isInteger || ((num) => typeof num === "number" && isFinite(num) && floor(num) === num);
+const isInteger$1 = Number.isInteger || ((num) => typeof num === "number" && isFinite(num) && floor(num) === num);
 Number.isNaN;
 Number.parseInt;
 const create$2 = () => /* @__PURE__ */ new Set();
@@ -5241,7 +5241,7 @@ const writeAny = (encoder, data) => {
 			writeVarString(encoder, data);
 			break;
 		case "number":
-			if (isInteger(data) && abs(data) <= 2147483647) {
+			if (isInteger$1(data) && abs(data) <= 2147483647) {
 				write$1(encoder, 125);
 				writeVarInt(encoder, data);
 			} else if (isFloat32(data)) {
@@ -17557,7 +17557,7 @@ var require_lodash = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 				var tag = baseGetTag$1(value);
 				return tag == funcTag$2 || tag == genTag$1 || tag == asyncTag$1 || tag == proxyTag$1;
 			}
-			function isInteger$1(value) {
+			function isInteger$2(value) {
 				return typeof value == "number" && value == toInteger(value);
 			}
 			function isLength$1(value) {
@@ -17603,7 +17603,7 @@ var require_lodash = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			}
 			var isRegExp$1 = nodeIsRegExp ? baseUnary$1(nodeIsRegExp) : baseIsRegExp;
 			function isSafeInteger(value) {
-				return isInteger$1(value) && value >= -MAX_SAFE_INTEGER$3 && value <= MAX_SAFE_INTEGER$3;
+				return isInteger$2(value) && value >= -MAX_SAFE_INTEGER$3 && value <= MAX_SAFE_INTEGER$3;
 			}
 			var isSet = nodeIsSet ? baseUnary$1(nodeIsSet) : baseIsSet;
 			function isString(value) {
@@ -18529,7 +18529,7 @@ var require_lodash = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 			lodash.isError = isError;
 			lodash.isFinite = isFinite$1;
 			lodash.isFunction = isFunction$1;
-			lodash.isInteger = isInteger$1;
+			lodash.isInteger = isInteger$2;
 			lodash.isLength = isLength$1;
 			lodash.isMap = isMap;
 			lodash.isMatch = isMatch$1;
@@ -20674,7 +20674,7 @@ const canUseDOM = () => {
 		return false;
 	}
 };
-var summaryVersion = "1.15.0";
+var summaryVersion = "1.15.1-next.2";
 var nodeKeys = [
 	"group",
 	"content",
@@ -21172,7 +21172,7 @@ const OPERATION_DEFINITIONS = {
 			supportsDryRun: true,
 			supportsTrackedMode: true,
 			possibleFailureCodes: ["INVALID_TARGET", "NO_OP"],
-			throws: T_NOT_FOUND_TRACKED
+			throws: [...T_NOT_FOUND_TRACKED, "INVALID_TARGET"]
 		}),
 		referenceDocPath: "insert.mdx",
 		referenceGroup: "core"
@@ -22081,13 +22081,23 @@ objectSchema({
 	operations: operationCapabilitiesSchema
 }, ["global", "operations"]);
 objectSchema({});
+({ ...objectSchema({
+	target: textAddressSchema,
+	text: { type: "string" },
+	blockId: {
+		type: "string",
+		description: "Block ID for block-relative targeting."
+	},
+	offset: {
+		type: "integer",
+		minimum: 0,
+		description: "Character offset within the block identified by blockId."
+	}
+}, ["text"]) });
 objectSchema({
 	nodeId: { type: "string" },
 	nodeType: { enum: [...blockNodeTypeValues] }
-}, ["nodeId"]), objectSchema({
-	target: textAddressSchema,
-	text: { type: "string" }
-}, ["text"]), textMutationResultSchemaFor("insert"), textMutationFailureSchemaFor("insert"), objectSchema({
+}, ["nodeId"]), textMutationResultSchemaFor("insert"), textMutationFailureSchemaFor("insert"), objectSchema({
 	target: textAddressSchema,
 	text: { type: "string" }
 }, ["target", "text"]), textMutationResultSchemaFor("replace"), textMutationFailureSchemaFor("replace"), objectSchema({ target: textAddressSchema }, ["target"]), textMutationResultSchemaFor("delete"), textMutationFailureSchemaFor("delete"), objectSchema({ target: textAddressSchema }, ["target"]), textMutationResultSchemaFor("format.bold"), textMutationFailureSchemaFor("format.bold"), objectSchema({ target: textAddressSchema }, ["target"]), textMutationResultSchemaFor("format.italic"), textMutationFailureSchemaFor("format.italic"), objectSchema({ target: textAddressSchema }, ["target"]), textMutationResultSchemaFor("format.underline"), textMutationFailureSchemaFor("format.underline"), objectSchema({ target: textAddressSchema }, ["target"]), textMutationResultSchemaFor("format.strikethrough"), textMutationFailureSchemaFor("format.strikethrough"), objectSchema({
@@ -22310,14 +22320,83 @@ function executeDelete(adapter, input, options) {
 		text: ""
 	}, options);
 }
+var DocumentApiValidationError = class DocumentApiValidationError extends Error {
+	constructor(code$1, message, details) {
+		super(message);
+		this.name = "DocumentApiValidationError";
+		this.code = code$1;
+		this.details = details;
+		Object.setPrototypeOf(this, DocumentApiValidationError.prototype);
+	}
+};
+var INSERT_INPUT_ALLOWED_KEYS = new Set([
+	"text",
+	"target",
+	"blockId",
+	"offset"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value != null && !Array.isArray(value);
+}
+function isInteger(value) {
+	return typeof value === "number" && Number.isInteger(value);
+}
+function isTextAddress(value) {
+	if (!isRecord(value)) return false;
+	if (value.kind !== "text") return false;
+	if (typeof value.blockId !== "string") return false;
+	const range = value.range;
+	if (!isRecord(range)) return false;
+	if (!isInteger(range.start) || !isInteger(range.end)) return false;
+	return range.start <= range.end;
+}
+function validateInsertInput(input) {
+	if (!isRecord(input)) throw new DocumentApiValidationError("INVALID_TARGET", "Insert input must be a non-null object.");
+	const inputObj = input;
+	if ("pos" in inputObj) throw new DocumentApiValidationError("INVALID_TARGET", "pos locator is not yet supported.", { field: "pos" });
+	for (const key$1 of Object.keys(inputObj)) if (!INSERT_INPUT_ALLOWED_KEYS.has(key$1)) throw new DocumentApiValidationError("INVALID_TARGET", `Unknown field "${key$1}" on insert input. Allowed fields: ${[...INSERT_INPUT_ALLOWED_KEYS].join(", ")}.`, { field: key$1 });
+	const { target, text, blockId, offset: offset$1 } = inputObj;
+	const hasTarget = target !== void 0;
+	const hasBlockId = blockId !== void 0;
+	const hasOffset = offset$1 !== void 0;
+	if (hasTarget && !isTextAddress(target)) throw new DocumentApiValidationError("INVALID_TARGET", "target must be a text address object.", {
+		field: "target",
+		value: target
+	});
+	if (typeof text !== "string") throw new DocumentApiValidationError("INVALID_TARGET", `text must be a string, got ${typeof text}.`, {
+		field: "text",
+		value: text
+	});
+	if (hasBlockId && typeof blockId !== "string") throw new DocumentApiValidationError("INVALID_TARGET", `blockId must be a string, got ${typeof blockId}.`, {
+		field: "blockId",
+		value: blockId
+	});
+	if (hasTarget && hasBlockId) throw new DocumentApiValidationError("INVALID_TARGET", "Cannot combine target with blockId. Use exactly one locator mode.", { fields: ["target", "blockId"] });
+	if (hasTarget && hasOffset) throw new DocumentApiValidationError("INVALID_TARGET", "Cannot combine target with offset. Use exactly one locator mode.", { fields: ["target", "offset"] });
+	if (hasOffset && !hasBlockId) throw new DocumentApiValidationError("INVALID_TARGET", "offset requires blockId.", { fields: ["offset", "blockId"] });
+	if (hasOffset) {
+		if (typeof offset$1 !== "number" || !Number.isInteger(offset$1) || offset$1 < 0) throw new DocumentApiValidationError("INVALID_TARGET", `offset must be a non-negative integer, got ${JSON.stringify(offset$1)}.`, {
+			field: "offset",
+			value: offset$1
+		});
+	}
+}
 function executeInsert(adapter, input, options) {
-	return executeWrite(adapter, input.target ? {
+	validateInsertInput(input);
+	const { target, blockId, offset: offset$1, text } = input;
+	if (blockId !== void 0) return executeWrite(adapter, {
 		kind: "insert",
-		target: input.target,
-		text: input.text
+		blockId,
+		offset: offset$1,
+		text
+	}, options);
+	return executeWrite(adapter, target ? {
+		kind: "insert",
+		target,
+		text
 	} : {
 		kind: "insert",
-		text: input.text
+		text
 	}, options);
 }
 function executeListsList(adapter, query) {
@@ -25638,6 +25717,28 @@ function validateWriteRequest(request, resolvedTarget) {
 	};
 	return null;
 }
+function normalizeInsertLocator(request) {
+	if (request.kind !== "insert") return request;
+	const hasBlockId = request.blockId !== void 0;
+	const hasOffset = request.offset !== void 0;
+	if (hasOffset && request.target) throw new DocumentApiAdapterError("INVALID_TARGET", "Cannot combine target with offset on insert request.", { fields: ["target", "offset"] });
+	if (hasOffset && !hasBlockId) throw new DocumentApiAdapterError("INVALID_TARGET", "offset requires blockId on insert request.", { fields: ["offset", "blockId"] });
+	if (!hasBlockId) return request;
+	if (request.target) throw new DocumentApiAdapterError("INVALID_TARGET", "Cannot combine target with blockId on insert request.", { fields: ["target", "blockId"] });
+	const effectiveOffset = request.offset ?? 0;
+	return {
+		kind: "insert",
+		target: {
+			kind: "text",
+			blockId: request.blockId,
+			range: {
+				start: effectiveOffset,
+				end: effectiveOffset
+			}
+		},
+		text: request.text
+	};
+}
 function resolveWriteTarget(editor, request) {
 	const requestedTarget = request.target;
 	if (request.kind === "insert" && !request.target) {
@@ -25725,9 +25826,10 @@ function toFailureReceipt(failure, resolvedTarget) {
 	};
 }
 function writeAdapter(editor, request, options) {
-	const resolvedTarget = resolveWriteTarget(editor, request);
-	if (!resolvedTarget) throw new DocumentApiAdapterError("TARGET_NOT_FOUND", "Mutation target could not be resolved.", { target: request.target });
-	const validationFailure = validateWriteRequest(request, resolvedTarget);
+	const normalizedRequest = normalizeInsertLocator(request);
+	const resolvedTarget = resolveWriteTarget(editor, normalizedRequest);
+	if (!resolvedTarget) throw new DocumentApiAdapterError("TARGET_NOT_FOUND", "Mutation target could not be resolved.", { target: normalizedRequest.target });
+	const validationFailure = validateWriteRequest(normalizedRequest, resolvedTarget);
 	if (validationFailure) return toFailureReceipt(validationFailure, resolvedTarget);
 	const mode = options?.changeMode ?? "direct";
 	if (options?.dryRun) {
@@ -25737,8 +25839,8 @@ function writeAdapter(editor, request, options) {
 			resolution: resolvedTarget.resolution
 		};
 	}
-	if (mode === "tracked") return applyTrackedWrite(editor, request, resolvedTarget);
-	return applyDirectWrite(editor, request, resolvedTarget);
+	if (mode === "tracked") return applyTrackedWrite(editor, normalizedRequest, resolvedTarget);
+	return applyDirectWrite(editor, normalizedRequest, resolvedTarget);
 }
 function getDocumentApiAdapters(editor) {
 	return {
@@ -27151,7 +27253,7 @@ var Editor = class Editor extends EventEmitter$1 {
 		return migrations.length > 0;
 	}
 	processCollaborationMigrations() {
-		console.debug("[checkVersionMigrations] Current editor version", "1.15.0");
+		console.debug("[checkVersionMigrations] Current editor version", "1.15.1-next.2");
 		if (!this.options.ydoc) return;
 		let docVersion = this.options.ydoc.getMap("meta").get("version");
 		if (!docVersion) docVersion = "initial";
@@ -89398,8 +89500,18 @@ function getItems(context, customItems = [], includeDefaultItems = true) {
 					action: async (editor$1) => {
 						const { view } = editor$1 ?? {};
 						if (!view) return;
-						view.dom.focus();
+						const savedFrom = view.state.selection.from;
+						const savedTo = view.state.selection.to;
+						view.focus();
 						const { html, text } = await readClipboardRaw();
+						if (view.state?.doc?.content) {
+							const { tr, doc: doc$2 } = view.state;
+							const maxPos = doc$2.content.size;
+							const safeFrom = Math.min(savedFrom, maxPos);
+							const safeTo = Math.min(savedTo, maxPos);
+							const SelectionType = view.state.selection.constructor;
+							if (typeof SelectionType.create === "function") view.dispatch(tr.setSelection(SelectionType.create(doc$2, safeFrom, safeTo)));
+						}
 						if (!(html ? handleClipboardPaste({
 							editor: editor$1,
 							view

package/dist/super-editor/converter.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../chunks/rolldown-runtime-Dp2H1eGw.cjs");
-const require_SuperConverter = require("../chunks/SuperConverter-BsXuivNG.cjs");
+const require_SuperConverter = require("../chunks/SuperConverter-Byxnduvh.cjs");
 require("../chunks/jszip-DCT9QYaK.cjs");
 require("../chunks/xml-js--DznO7Gk.cjs");
 require("../chunks/constants-CpniKo9Z.cjs");

package/dist/super-editor/converter.es.js

@@ -1,4 +1,4 @@
-import { t as SuperConverter } from "../chunks/SuperConverter-Cv8wefny.es.js";
+import { t as SuperConverter } from "../chunks/SuperConverter-mYJUjRBF.es.js";
 import "../chunks/jszip-ChlR43oI.es.js";
 import "../chunks/xml-js-DLE8mr0n.es.js";
 import "../chunks/constants-DBKi0Amm.es.js";

package/dist/super-editor/src/components/context-menu/menuItems.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menuItems.d.ts","sourceRoot":"","sources":["../../../../../../super-editor/src/components/context-menu/menuItems.js"],"names":[],"mappings":"AAoFA;;;;;;GAMG;AACH,kCALW,MAAM,6CAEN,OAAO,yBAyRjB"}
+{"version":3,"file":"menuItems.d.ts","sourceRoot":"","sources":["../../../../../../super-editor/src/components/context-menu/menuItems.js"],"names":[],"mappings":"AAoFA;;;;;;GAMG;AACH,kCALW,MAAM,6CAEN,OAAO,yBAgTjB"}

package/dist/super-editor/src/document-api-adapters/write-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-adapter.d.ts","sourceRoot":"","sources":["../../../../../super-editor/src/document-api-adapters/write-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,eAAe,EAGf,mBAAmB,EACnB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAiLhC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAwBlH"}
+{"version":3,"file":"write-adapter.d.ts","sourceRoot":"","sources":["../../../../../super-editor/src/document-api-adapters/write-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,eAAe,EAGf,mBAAmB,EACnB,YAAY,EACb,MAAM,wBAAwB,CAAC;AA8NhC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,mBAAmB,CA4BlH"}

package/dist/super-editor/src/extensions/table/table.d.ts

@@ -354,7 +354,7 @@ export type TableProperties = {
     /**
      * - Specifies whether the current table should allow other floating tables to overlap its extents when the tables are displayed in a document
      */
-    overlap?: "never" | "overlap" | undefined;
+    overlap?: "overlap" | "never" | undefined;
     /**
      * - Reference to table style ID
      */

package/dist/super-editor.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-Dp2H1eGw.cjs");
-const require_src = require("./chunks/src-PPicsAhf.cjs");
-const require_SuperConverter = require("./chunks/SuperConverter-BsXuivNG.cjs");
+const require_src = require("./chunks/src-BLs36rcx.cjs");
+const require_SuperConverter = require("./chunks/SuperConverter-Byxnduvh.cjs");
 require("./chunks/jszip-DCT9QYaK.cjs");
 require("./chunks/xml-js--DznO7Gk.cjs");
 require("./chunks/constants-CpniKo9Z.cjs");

package/dist/super-editor.es.js

@@ -1,5 +1,5 @@
-import { $ as getAllowedImageDimensions, Bt as isMarkType, Ht as isNodeType, Q as trackChangesHelpers_exports, Rt as defineMark, Vt as assertNodeType, X as getRichTextExtensions, Y as AIWriter_default, Z as getStarterExtensions, a as BasicUpload_default, at as CommentsPluginKey, c as Toolbar_default, et as SectionHelpers, i as SuperEditor_default, it as AnnotatorHelpers, n as SlashMenu, nt as Editor, o as ContextMenu_default, ot as TrackChangesBasePluginKey, r as SuperInput_default, rt as fieldAnnotationHelpers_exports, s as SuperToolbar, t as Extensions, tt as PresentationEditor, zt as defineNode } from "./chunks/src-9JS9WrsR.es.js";
-import { i as registeredHandlers, j as getMarksFromSelection, k as getActiveFormatting, o as helpers_exports, t as SuperConverter } from "./chunks/SuperConverter-Cv8wefny.es.js";
+import { $ as getAllowedImageDimensions, Bt as isMarkType, Ht as isNodeType, Q as trackChangesHelpers_exports, Rt as defineMark, Vt as assertNodeType, X as getRichTextExtensions, Y as AIWriter_default, Z as getStarterExtensions, a as BasicUpload_default, at as CommentsPluginKey, c as Toolbar_default, et as SectionHelpers, i as SuperEditor_default, it as AnnotatorHelpers, n as SlashMenu, nt as Editor, o as ContextMenu_default, ot as TrackChangesBasePluginKey, r as SuperInput_default, rt as fieldAnnotationHelpers_exports, s as SuperToolbar, t as Extensions, tt as PresentationEditor, zt as defineNode } from "./chunks/src-CSEqymEk.es.js";
+import { i as registeredHandlers, j as getMarksFromSelection, k as getActiveFormatting, o as helpers_exports, t as SuperConverter } from "./chunks/SuperConverter-mYJUjRBF.es.js";
 import "./chunks/jszip-ChlR43oI.es.js";
 import "./chunks/xml-js-DLE8mr0n.es.js";
 import "./chunks/constants-DBKi0Amm.es.js";