@harbour-enterprises/superdoc 1.17.0-next.10 → 1.17.0-next.12

package/dist/chunks/{SuperConverter-CqDsHOKA.es.js → SuperConverter-B8jWQriR.es.js}

@@ -33839,7 +33839,7 @@ var SuperConverter = class SuperConverter {
 	static getStoredSuperdocVersion(docx) {
 		return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
 	}
-	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.17.0-next.10") {
+	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.17.0-next.12") {
 		return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
 	}
 	static generateWordTimestamp() {

package/dist/chunks/{SuperConverter-BQs6tZ2x.cjs → SuperConverter-BSNvGA-_.cjs}

@@ -33853,7 +33853,7 @@ var SuperConverter = class SuperConverter {
 	static getStoredSuperdocVersion(docx) {
 		return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
 	}
-	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.17.0-next.10") {
+	static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.17.0-next.12") {
 		return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
 	}
 	static generateWordTimestamp() {

package/dist/chunks/{src-C4SehkH8.es.js → src-BI6hYDgO.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-CqDsHOKA.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-B8jWQriR.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";
@@ -260,7 +260,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "1.17.0-next.10";
+		return "1.17.0-next.12";
 	} catch {
 		return "unknown";
 	}
@@ -20715,7 +20715,7 @@ const canUseDOM = () => {
 		return false;
 	}
 };
-var summaryVersion = "1.17.0-next.10";
+var summaryVersion = "1.17.0-next.12";
 var nodeKeys = [
 	"group",
 	"content",
@@ -21093,6 +21093,13 @@ const BLOCK_NODE_TYPES = [
 	"image",
 	"sdt"
 ];
+const DELETABLE_BLOCK_NODE_TYPES = [
+	"paragraph",
+	"heading",
+	"listItem",
+	"table",
+	"sdt"
+];
 const INLINE_NODE_TYPES = [
 	"run",
 	"bookmark",
@@ -21281,6 +21288,27 @@ const OPERATION_DEFINITIONS = {
 		referenceDocPath: "delete.mdx",
 		referenceGroup: "core"
 	},
+	"blocks.delete": {
+		memberPath: "blocks.delete",
+		description: "Delete an entire block node (paragraph, heading, list item, table, image, or sdt) deterministically.",
+		requiresDocumentContext: true,
+		metadata: mutationOperation({
+			idempotency: "conditional",
+			supportsDryRun: true,
+			supportsTrackedMode: false,
+			possibleFailureCodes: NONE_FAILURES,
+			throws: [
+				"TARGET_NOT_FOUND",
+				"AMBIGUOUS_TARGET",
+				"CAPABILITY_UNAVAILABLE",
+				"INVALID_TARGET",
+				"INVALID_INPUT",
+				"INTERNAL_ERROR"
+			]
+		}),
+		referenceDocPath: "blocks/delete.mdx",
+		referenceGroup: "blocks"
+	},
 	"format.apply": {
 		memberPath: "format.apply",
 		description: "Apply explicit inline style changes (bold, italic, underline, strike) to the target range using boolean patch semantics.",
@@ -21855,6 +21883,7 @@ function ref$1(name) {
 }
 var nodeTypeValues = NODE_TYPES;
 var blockNodeTypeValues = BLOCK_NODE_TYPES;
+var deletableBlockNodeTypeValues = DELETABLE_BLOCK_NODE_TYPES;
 var inlineNodeTypeValues = INLINE_NODE_TYPES;
 objectSchema({
 	start: { type: "integer" },
@@ -21891,6 +21920,14 @@ objectSchema({
 	"kind",
 	"nodeType",
 	"nodeId"
+]), objectSchema({
+	kind: { const: "block" },
+	nodeType: { enum: [...deletableBlockNodeTypeValues] },
+	nodeId: { type: "string" }
+}, [
+	"kind",
+	"nodeType",
+	"nodeId"
 ]), objectSchema({
 	kind: { const: "block" },
 	nodeType: { const: "paragraph" },
@@ -22042,6 +22079,7 @@ ref$1("TargetKind");
 var textAddressSchema = ref$1("TextAddress");
 var textTargetSchema = ref$1("TextTarget");
 var blockNodeAddressSchema = ref$1("BlockNodeAddress");
+var deletableBlockNodeAddressSchema = ref$1("DeletableBlockNodeAddress");
 var paragraphAddressSchema = ref$1("ParagraphAddress");
 var headingAddressSchema = ref$1("HeadingAddress");
 var listItemAddressSchema = ref$1("ListItemAddress");
@@ -22412,6 +22450,7 @@ discoveryResultSchema(discoveryItemSchema({
 }, ["address", "type"]));
 var capabilityReasonsSchema = arraySchema({ enum: [
 	"COMMAND_UNAVAILABLE",
+	"HELPER_UNAVAILABLE",
 	"OPERATION_UNAVAILABLE",
 	"TRACKED_MODE_UNAVAILABLE",
 	"DRY_RUN_UNAVAILABLE",
@@ -22501,7 +22540,13 @@ objectSchema({
 }, ["target", "value"]), textMutationResultSchemaFor("format.color"), textMutationFailureSchemaFor("format.color"), objectSchema({
 	target: textAddressSchema,
 	alignment: { oneOf: [{ enum: [...ALIGNMENTS] }, { type: "null" }] }
-}, ["target", "alignment"]), textMutationResultSchemaFor("format.align"), textMutationFailureSchemaFor("format.align"), objectSchema({
+}, ["target", "alignment"]), textMutationResultSchemaFor("format.align"), textMutationFailureSchemaFor("format.align"), objectSchema({ target: deletableBlockNodeAddressSchema }, ["target"]), objectSchema({
+	success: { const: true },
+	deleted: deletableBlockNodeAddressSchema
+}, ["success", "deleted"]), objectSchema({
+	success: { const: true },
+	deleted: deletableBlockNodeAddressSchema
+}, ["success", "deleted"]), preApplyFailureResultSchemaFor("blocks.delete"), objectSchema({
 	at: { oneOf: [
 		objectSchema({ kind: { const: "documentStart" } }, ["kind"]),
 		objectSchema({ kind: { const: "documentEnd" } }, ["kind"]),
@@ -22679,6 +22724,11 @@ var GROUP_METADATA = {
 		description: "Primary read and write operations.",
 		pagePath: "core/index.mdx"
 	},
+	blocks: {
+		title: "Blocks",
+		description: "Block-level structural operations.",
+		pagePath: "blocks/index.mdx"
+	},
 	capabilities: {
 		title: "Capabilities",
 		description: "Runtime support discovery for capability-aware branching.",
@@ -22727,6 +22777,7 @@ Object.keys(GROUP_METADATA).map((key$1) => ({
 }));
 const CAPABILITY_REASON_CODES = [
 	"COMMAND_UNAVAILABLE",
+	"HELPER_UNAVAILABLE",
 	"OPERATION_UNAVAILABLE",
 	"TRACKED_MODE_UNAVAILABLE",
 	"DRY_RUN_UNAVAILABLE",
@@ -23024,6 +23075,27 @@ function executeCreateHeading(adapter, input, options) {
 	validateCreateLocation(normalized.at, "create.heading");
 	return adapter.heading(normalized, normalizeMutationOptions(options));
 }
+var SUPPORTED_DELETE_NODE_TYPES = new Set(DELETABLE_BLOCK_NODE_TYPES);
+var REJECTED_DELETE_NODE_TYPES = new Set(["tableRow", "tableCell"]);
+function validateBlocksDeleteInput(input) {
+	if (!input || typeof input !== "object") throw new DocumentApiValidationError("INVALID_INPUT", "blocks.delete requires an input object.", { fields: ["input"] });
+	if (!input.target) throw new DocumentApiValidationError("INVALID_INPUT", "blocks.delete requires a target.", { fields: ["target"] });
+	if (input.target.kind !== "block") throw new DocumentApiValidationError("INVALID_INPUT", "blocks.delete target must have kind \"block\".", { fields: ["target.kind"] });
+	if (!input.target.nodeId || typeof input.target.nodeId !== "string") throw new DocumentApiValidationError("INVALID_INPUT", "blocks.delete target requires a nodeId string.", { fields: ["target.nodeId"] });
+	const { nodeType } = input.target;
+	if (REJECTED_DELETE_NODE_TYPES.has(nodeType)) throw new DocumentApiValidationError("INVALID_TARGET", `blocks.delete does not support "${nodeType}" targets. Table row/column operations are out of scope.`, {
+		fields: ["target.nodeType"],
+		nodeType
+	});
+	if (!SUPPORTED_DELETE_NODE_TYPES.has(nodeType)) throw new DocumentApiValidationError("INVALID_TARGET", `blocks.delete does not support "${nodeType}" targets.`, {
+		fields: ["target.nodeType"],
+		nodeType
+	});
+}
+function executeBlocksDelete(adapter, input, options) {
+	validateBlocksDeleteInput(input);
+	return adapter.delete(input, normalizeMutationOptions(options));
+}
 function executeTrackChangesList(adapter, input) {
 	return adapter.list(input);
 }
@@ -23067,6 +23139,7 @@ function buildDispatchTable(api) {
 		insert: (input, options) => api.insert(input, options),
 		replace: (input, options) => api.replace(input, options),
 		delete: (input, options) => api.delete(input, options),
+		"blocks.delete": (input, options) => api.blocks.delete(input, options),
 		"format.apply": (input, options) => api.format.apply(input, options),
 		"format.fontSize": (input, options) => api.format.fontSize(input, options),
 		"format.fontFamily": (input, options) => api.format.fontFamily(input, options),
@@ -23192,6 +23265,9 @@ function createDocumentApi(adapters) {
 				return executeTrackChangesDecide(adapters.trackChanges, input, options);
 			}
 		},
+		blocks: { delete(input, options) {
+			return executeBlocksDelete(adapters.blocks, input, options);
+		} },
 		create: {
 			paragraph(input, options) {
 				return executeCreateParagraph(adapters.create, input, options);
@@ -23276,6 +23352,7 @@ var REQUIRED_COMMANDS = {
 	"lists.outdent": ["setTextSelection", "decreaseListIndent"],
 	"lists.restart": ["setTextSelection", "restartNumbering"],
 	"lists.exit": ["exitListItemAt"],
+	"blocks.delete": ["deleteBlockNodeById"],
 	"comments.create": [
 		"addComment",
 		"setTextSelection",
@@ -23304,6 +23381,12 @@ function hasAllCommands(editor, operationId) {
 	if (!required || required.length === 0) return true;
 	return required.every((command$1) => hasCommand(editor, command$1));
 }
+var REQUIRED_HELPERS = { "blocks.delete": (editor) => typeof editor.helpers?.blockNode?.getBlockNodeById === "function" };
+function hasRequiredHelpers(editor, operationId) {
+	const check = REQUIRED_HELPERS[operationId];
+	if (!check) return true;
+	return check(editor);
+}
 function hasMarkCapability(editor, markName) {
 	return Boolean(editor.schema?.marks?.[markName]);
 }
@@ -23349,7 +23432,7 @@ function pushReason(reasons, reason) {
 function isOperationAvailable(editor, operationId) {
 	if (operationId === "format.apply") return MARK_KEYS.some((key$1) => hasMarkCapability(editor, STYLE_MARK_SCHEMA_NAMES[key$1] ?? key$1));
 	if (INLINE_FORMAT_OPERATIONS.has(operationId)) return hasAllCommands(editor, operationId) && hasMarkCapability(editor, "textStyle");
-	return hasAllCommands(editor, operationId);
+	return hasAllCommands(editor, operationId) && hasRequiredHelpers(editor, operationId);
 }
 function isCommandBackedAvailability(operationId) {
 	return !isMarkBackedOperation(operationId) && !INLINE_FORMAT_OPERATIONS.has(operationId);
@@ -23363,7 +23446,10 @@ function buildOperationCapabilities(editor) {
 		const dryRun = metadata.supportsDryRun && available;
 		const reasons = [];
 		if (!available) {
-			if (isCommandBackedAvailability(operationId)) pushReason(reasons, "COMMAND_UNAVAILABLE");
+			if (isCommandBackedAvailability(operationId)) {
+				if (!hasAllCommands(editor, operationId)) pushReason(reasons, "COMMAND_UNAVAILABLE");
+				if (!hasRequiredHelpers(editor, operationId)) pushReason(reasons, "HELPER_UNAVAILABLE");
+			}
 			pushReason(reasons, "OPERATION_UNAVAILABLE");
 		}
 		if (metadata.supportsTrackedMode && !tracked) pushReason(reasons, "TRACKED_MODE_UNAVAILABLE");
@@ -23853,13 +23939,21 @@ function buildBlockIndex(editor) {
 	});
 	return {
 		candidates,
-		byId
+		byId,
+		ambiguous
 	};
 }
 function findBlockById(index, address) {
 	if (address.kind !== "block") return void 0;
 	return index.byId.get(`${address.nodeType}:${address.nodeId}`);
 }
+function findBlockByIdStrict(index, address) {
+	const key$1 = `${address.nodeType}:${address.nodeId}`;
+	if (index.ambiguous.has(key$1)) throw new DocumentApiAdapterError("AMBIGUOUS_TARGET", `Multiple blocks share key "${key$1}".`, { target: address });
+	const candidate = index.byId.get(key$1);
+	if (!candidate) throw new DocumentApiAdapterError("TARGET_NOT_FOUND", `Block "${key$1}" was not found.`, { target: address });
+	return candidate;
+}
 function isTextBlockCandidate(candidate) {
 	const node = candidate.node;
 	return Boolean(node?.inlineContent || node?.isTextblock);
@@ -25325,7 +25419,8 @@ function buildAssertIndex(doc$2) {
 	});
 	return {
 		candidates,
-		byId
+		byId,
+		ambiguous
 	};
 }
 function resolveAssertScope(index, select, within$1) {
@@ -26595,6 +26690,51 @@ function createCommentsWrapper(editor) {
 		list: (query) => listCommentsHandler(editor, query)
 	};
 }
+var SUPPORTED_NODE_TYPES = new Set(DELETABLE_BLOCK_NODE_TYPES);
+var REJECTED_NODE_TYPES = new Set(["tableRow", "tableCell"]);
+function validateTargetNodeType(nodeType) {
+	if (REJECTED_NODE_TYPES.has(nodeType)) throw new DocumentApiAdapterError("INVALID_TARGET", `blocks.delete does not support "${nodeType}" targets. Table row/column operations are out of scope.`, { nodeType });
+	if (!SUPPORTED_NODE_TYPES.has(nodeType)) throw new DocumentApiAdapterError("INVALID_TARGET", `blocks.delete does not support "${nodeType}" targets.`, { nodeType });
+}
+function resolveSdBlockId(candidate) {
+	const sdBlockId = candidate.node.attrs?.sdBlockId;
+	if (typeof sdBlockId === "string" && sdBlockId.length > 0) return sdBlockId;
+	throw new DocumentApiAdapterError("INTERNAL_ERROR", "Resolved block candidate is missing sdBlockId attribute. This indicates a schema/extension invariant violation.", { attrs: candidate.node.attrs });
+}
+function validateCommandLayerUniqueness(editor, sdBlockId) {
+	const getBlockNodeById = editor.helpers?.blockNode?.getBlockNodeById;
+	if (typeof getBlockNodeById !== "function") throw new DocumentApiAdapterError("CAPABILITY_UNAVAILABLE", "blocks.delete requires the blockNode helper to be registered.", { reason: "missing_helper" });
+	const matches = getBlockNodeById(sdBlockId);
+	if (!matches || Array.isArray(matches) && matches.length === 0) throw new DocumentApiAdapterError("TARGET_NOT_FOUND", `Block with sdBlockId "${sdBlockId}" was not found at the command layer.`, { sdBlockId });
+	if (Array.isArray(matches) && matches.length > 1) throw new DocumentApiAdapterError("AMBIGUOUS_TARGET", `Multiple blocks share sdBlockId "${sdBlockId}" at the command layer.`, {
+		sdBlockId,
+		count: matches.length
+	});
+}
+function blocksDeleteWrapper(editor, input, options) {
+	rejectTrackedMode("blocks.delete", options);
+	const candidate = findBlockByIdStrict(getBlockIndex(editor), input.target);
+	validateTargetNodeType(candidate.nodeType);
+	const sdBlockId = resolveSdBlockId(candidate);
+	const deleteBlockNodeById = requireEditorCommand(editor.commands?.deleteBlockNodeById, "blocks.delete");
+	validateCommandLayerUniqueness(editor, sdBlockId);
+	if (options?.dryRun) return {
+		success: true,
+		deleted: input.target
+	};
+	if (executeDomainCommand(editor, () => {
+		const didApply = deleteBlockNodeById(sdBlockId);
+		if (didApply) clearIndexCache(editor);
+		return didApply;
+	}, { expectedRevision: options?.expectedRevision }).steps[0]?.effect !== "changed") throw new DocumentApiAdapterError("INTERNAL_ERROR", "blocks.delete command returned false despite passing all pre-apply checks. This is an internal invariant violation.", {
+		sdBlockId,
+		target: input.target
+	});
+	return {
+		success: true,
+		deleted: input.target
+	};
+}
 var DERIVED_ID_LENGTH = 24;
 function getRawTrackedMarks(editor) {
 	try {
@@ -28826,6 +28966,7 @@ function getDocumentApiAdapters(editor) {
 			acceptAll: (input, options) => trackChangesAcceptAllWrapper(editor, input, options),
 			rejectAll: (input, options) => trackChangesRejectAllWrapper(editor, input, options)
 		},
+		blocks: { delete: (input, options) => blocksDeleteWrapper(editor, input, options) },
 		create: {
 			paragraph: (input, options) => createParagraphWrapper(editor, input, options),
 			heading: (input, options) => createHeadingWrapper(editor, input, options)
@@ -30216,7 +30357,7 @@ var Editor = class Editor extends EventEmitter$1 {
 		return migrations.length > 0;
 	}
 	processCollaborationMigrations() {
-		console.debug("[checkVersionMigrations] Current editor version", "1.17.0-next.10");
+		console.debug("[checkVersionMigrations] Current editor version", "1.17.0-next.12");
 		if (!this.options.ydoc) return;
 		let docVersion = this.options.ydoc.getMap("meta").get("version");
 		if (!docVersion) docVersion = "initial";