superdoc 2.4.0-next.35 → 2.4.0-next.37

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var 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.35",
+	superdocVersion: "2.4.0-next.37",
 	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

@@ -18,7 +18,7 @@ var 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.35",
+	superdocVersion: "2.4.0-next.37",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/types/track-changes.types.d.ts

@@ -457,6 +457,16 @@ export interface TrackChangeNavigationTarget {
     blockId: string;
     role: 'primary' | 'move-source' | 'move-destination' | 'formatting-carrier' | 'structural-carrier';
 }
+export interface TrackChangeCustomAttribute {
+    /** Source-qualified attribute name, preserving the prefix used by the carrier. */
+    name: string;
+    /** Resolved extension namespace URI. */
+    namespaceUri: string;
+    /** Attribute local name without its namespace prefix. */
+    localName: string;
+    /** Decoded XML attribute value. */
+    value: string;
+}
 export interface TrackChangeInfo {
     address: TrackedChangeAddress;
     /** Stable SuperDoc logical tracked-change id (spec §3 / §4). */
@@ -569,6 +579,11 @@ export interface TrackChangeInfo {
      * tracked changes. Absent when the change is standalone.
      */
     overlap?: TrackChangeOverlapInfo;
+    /**
+     * Unknown extension attributes attached to contributing OOXML revision carriers.
+     * Exact duplicates are removed in document order; conflicting values are retained.
+     */
+    readonly customAttributes?: readonly TrackChangeCustomAttribute[];
 }
 export interface TrackChangesListQuery {
     limit?: number;
@@ -694,6 +709,8 @@ export interface TrackChangeDomain {
      * stack without an extra `trackChanges.get` round trip.
      */
     overlap?: TrackChangeOverlapInfo;
+    /** Unknown extension attributes attached to the contributing OOXML revision carriers. */
+    readonly customAttributes?: readonly TrackChangeCustomAttribute[];
 }
 /**
  * Standardized discovery output for `trackChanges.list`.

package/dist/superdoc.cjs

@@ -5737,6 +5737,7 @@ function useComment(params) {
 	const trackedChangeLabel = (0, vue.ref)(params.trackedChangeLabel || null);
 	const trackedChangeDetailLines = (0, vue.ref)(params.trackedChangeDetailLines || null);
 	const trackedChangeImagePreview = (0, vue.ref)(params.trackedChangeImagePreview || null);
+	const customAttributes = (0, vue.ref)(params.customAttributes ?? null);
 	const resolvedTime = (0, vue.ref)(params.resolvedTime || null);
 	const resolvedById = (0, vue.ref)(params.resolvedById || null);
 	const resolvedByEmail = (0, vue.ref)(params.resolvedByEmail || null);
@@ -5974,6 +5975,7 @@ function useComment(params) {
 			trackedChangeLabel: trackedChangeLabel.value,
 			trackedChangeDetailLines: trackedChangeDetailLines.value,
 			trackedChangeImagePreview: trackedChangeImagePreview.value,
+			customAttributes: customAttributes.value,
 			deletedText: deletedText.value,
 			resolvedTime: resolvedTime.value,
 			resolvedById: resolvedById.value,
@@ -6024,6 +6026,7 @@ function useComment(params) {
 		trackedChangeLabel,
 		trackedChangeDetailLines,
 		trackedChangeImagePreview,
+		customAttributes,
 		resolvedTime,
 		resolvedById,
 		resolvedByEmail,
@@ -7089,6 +7092,20 @@ var trackedChangeDetailLinesEqual = (a, b) => {
 	if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
 	return a.every((line, index) => shallowEqual(line, b[index]));
 };
+var normalizeTrackedChangeCustomAttributes = (attributes) => {
+	if (!Array.isArray(attributes)) return null;
+	return attributes.filter((attribute) => attribute && typeof attribute === "object").map((attribute) => ({
+		name: typeof attribute.name === "string" ? attribute.name : "",
+		namespaceUri: typeof attribute.namespaceUri === "string" ? attribute.namespaceUri : "",
+		localName: typeof attribute.localName === "string" ? attribute.localName : "",
+		value: typeof attribute.value === "string" ? attribute.value : ""
+	})).filter((attribute) => attribute.name && attribute.namespaceUri && attribute.localName);
+};
+var trackedChangeCustomAttributesEqual = (left, right) => {
+	if (left === right) return true;
+	if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) return false;
+	return left.every((attribute, index) => shallowEqual(attribute, right[index]));
+};
 var normalizeTrackedChangeImagePreview = (preview) => {
 	if (!preview || typeof preview !== "object") return null;
 	const src = typeof preview.src === "string" ? preview.src : null;
@@ -7815,12 +7832,14 @@ var useCommentsStore = defineStore("comments", () => {
 			documentId: params?.documentId ?? null
 		});
 		try {
-			const { event, changeId, trackedChangeText, trackedChangeType, trackedChangeDisplayType, semanticColorKey, semanticColor, deletedText, trackedChangeLabel, trackedChangeDetailLines, trackedChangeImagePreview, authorId, authorEmail, authorImage, date, author: authorName, importedAuthor, documentId, coords, trackedChangeStory, trackedChangeStoryKind, trackedChangeStoryLabel, trackedChangeAnchorKey, trackedChangeCanonicalId, trackedChangePositionAliases, importedId } = params;
+			const { event, changeId, trackedChangeText, trackedChangeType, trackedChangeDisplayType, semanticColorKey, semanticColor, deletedText, trackedChangeLabel, trackedChangeDetailLines, trackedChangeImagePreview, customAttributes, authorId, authorEmail, authorImage, date, author: authorName, importedAuthor, documentId, coords, trackedChangeStory, trackedChangeStoryKind, trackedChangeStoryLabel, trackedChangeAnchorKey, trackedChangeCanonicalId, trackedChangePositionAliases, importedId } = params;
 			const normalizedChangeId = changeId != null ? String(changeId) : null;
 			const normalizedTrackedChangeCanonicalId = trackedChangeCanonicalId != null ? String(trackedChangeCanonicalId) : null;
 			const hasTrackedChangePositionAliases = Object.prototype.hasOwnProperty.call(params, "trackedChangePositionAliases");
 			const normalizedTrackedChangePositionAliases = hasTrackedChangePositionAliases ? normalizeTrackedChangePositionAliases(trackedChangePositionAliases) : void 0;
 			const hasImportedId = Object.prototype.hasOwnProperty.call(params, "importedId");
+			const hasCustomAttributes = Object.prototype.hasOwnProperty.call(params, "customAttributes");
+			const normalizedCustomAttributes = hasCustomAttributes ? normalizeTrackedChangeCustomAttributes(customAttributes) : void 0;
 			const normalizedImportedId = hasImportedId ? importedId != null ? String(importedId) : null : void 0;
 			const normalizedDocumentId = documentId != null ? String(documentId) : null;
 			if (!(trackedChangeDisplayType === "tableInsert" || trackedChangeDisplayType === "tableDelete") && normalizedChangeId) {
@@ -7864,6 +7883,7 @@ var useCommentsStore = defineStore("comments", () => {
 				trackedChangeLabel: normalizedTrackedChangeLabel,
 				trackedChangeDetailLines: normalizedTrackedChangeDetailLines,
 				trackedChangeImagePreview: normalizedTrackedChangeImagePreview,
+				...hasCustomAttributes ? { customAttributes: normalizedCustomAttributes } : {},
 				createdTime: date,
 				creatorId: authorId ?? null,
 				creatorName: authorName,
@@ -7979,6 +7999,10 @@ var useCommentsStore = defineStore("comments", () => {
 					target.trackedChangeDetailLines = normalizedTrackedChangeDetailLines;
 					didChange = true;
 				}
+				if (hasCustomAttributes && target && !trackedChangeCustomAttributesEqual(target.customAttributes, normalizedCustomAttributes)) {
+					target.customAttributes = normalizedCustomAttributes;
+					didChange = true;
+				}
 				return applyStoryMetadata(target) || didChange;
 			};
 			const updateExistingTrackedChange = (trackedComment) => {
@@ -8673,6 +8697,7 @@ var useCommentsStore = defineStore("comments", () => {
 			trackedChangeLabel: typeof params.trackedChangeLabel === "string" && params.trackedChangeLabel.length > 0 ? params.trackedChangeLabel : null,
 			trackedChangeDetailLines: normalizeTrackedChangeDetailLines(params.trackedChangeDetailLines),
 			trackedChangeImagePreview: normalizeTrackedChangeImagePreview(params.trackedChangeImagePreview),
+			...Object.prototype.hasOwnProperty.call(params, "customAttributes") ? { customAttributes: normalizeTrackedChangeCustomAttributes(params.customAttributes) } : {},
 			createdTime: params.date,
 			creatorId: params.authorId ?? null,
 			creatorName: params.author,
@@ -43235,7 +43260,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.35";
+		this.version = "2.4.0-next.37";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -5736,6 +5736,7 @@ function useComment(params) {
 	const trackedChangeLabel = ref(params.trackedChangeLabel || null);
 	const trackedChangeDetailLines = ref(params.trackedChangeDetailLines || null);
 	const trackedChangeImagePreview = ref(params.trackedChangeImagePreview || null);
+	const customAttributes = ref(params.customAttributes ?? null);
 	const resolvedTime = ref(params.resolvedTime || null);
 	const resolvedById = ref(params.resolvedById || null);
 	const resolvedByEmail = ref(params.resolvedByEmail || null);
@@ -5973,6 +5974,7 @@ function useComment(params) {
 			trackedChangeLabel: trackedChangeLabel.value,
 			trackedChangeDetailLines: trackedChangeDetailLines.value,
 			trackedChangeImagePreview: trackedChangeImagePreview.value,
+			customAttributes: customAttributes.value,
 			deletedText: deletedText.value,
 			resolvedTime: resolvedTime.value,
 			resolvedById: resolvedById.value,
@@ -6023,6 +6025,7 @@ function useComment(params) {
 		trackedChangeLabel,
 		trackedChangeDetailLines,
 		trackedChangeImagePreview,
+		customAttributes,
 		resolvedTime,
 		resolvedById,
 		resolvedByEmail,
@@ -7088,6 +7091,20 @@ var trackedChangeDetailLinesEqual = (a, b) => {
 	if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
 	return a.every((line, index) => shallowEqual(line, b[index]));
 };
+var normalizeTrackedChangeCustomAttributes = (attributes) => {
+	if (!Array.isArray(attributes)) return null;
+	return attributes.filter((attribute) => attribute && typeof attribute === "object").map((attribute) => ({
+		name: typeof attribute.name === "string" ? attribute.name : "",
+		namespaceUri: typeof attribute.namespaceUri === "string" ? attribute.namespaceUri : "",
+		localName: typeof attribute.localName === "string" ? attribute.localName : "",
+		value: typeof attribute.value === "string" ? attribute.value : ""
+	})).filter((attribute) => attribute.name && attribute.namespaceUri && attribute.localName);
+};
+var trackedChangeCustomAttributesEqual = (left, right) => {
+	if (left === right) return true;
+	if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) return false;
+	return left.every((attribute, index) => shallowEqual(attribute, right[index]));
+};
 var normalizeTrackedChangeImagePreview = (preview) => {
 	if (!preview || typeof preview !== "object") return null;
 	const src = typeof preview.src === "string" ? preview.src : null;
@@ -7814,12 +7831,14 @@ var useCommentsStore = defineStore("comments", () => {
 			documentId: params?.documentId ?? null
 		});
 		try {
-			const { event, changeId, trackedChangeText, trackedChangeType, trackedChangeDisplayType, semanticColorKey, semanticColor, deletedText, trackedChangeLabel, trackedChangeDetailLines, trackedChangeImagePreview, authorId, authorEmail, authorImage, date, author: authorName, importedAuthor, documentId, coords, trackedChangeStory, trackedChangeStoryKind, trackedChangeStoryLabel, trackedChangeAnchorKey, trackedChangeCanonicalId, trackedChangePositionAliases, importedId } = params;
+			const { event, changeId, trackedChangeText, trackedChangeType, trackedChangeDisplayType, semanticColorKey, semanticColor, deletedText, trackedChangeLabel, trackedChangeDetailLines, trackedChangeImagePreview, customAttributes, authorId, authorEmail, authorImage, date, author: authorName, importedAuthor, documentId, coords, trackedChangeStory, trackedChangeStoryKind, trackedChangeStoryLabel, trackedChangeAnchorKey, trackedChangeCanonicalId, trackedChangePositionAliases, importedId } = params;
 			const normalizedChangeId = changeId != null ? String(changeId) : null;
 			const normalizedTrackedChangeCanonicalId = trackedChangeCanonicalId != null ? String(trackedChangeCanonicalId) : null;
 			const hasTrackedChangePositionAliases = Object.prototype.hasOwnProperty.call(params, "trackedChangePositionAliases");
 			const normalizedTrackedChangePositionAliases = hasTrackedChangePositionAliases ? normalizeTrackedChangePositionAliases(trackedChangePositionAliases) : void 0;
 			const hasImportedId = Object.prototype.hasOwnProperty.call(params, "importedId");
+			const hasCustomAttributes = Object.prototype.hasOwnProperty.call(params, "customAttributes");
+			const normalizedCustomAttributes = hasCustomAttributes ? normalizeTrackedChangeCustomAttributes(customAttributes) : void 0;
 			const normalizedImportedId = hasImportedId ? importedId != null ? String(importedId) : null : void 0;
 			const normalizedDocumentId = documentId != null ? String(documentId) : null;
 			if (!(trackedChangeDisplayType === "tableInsert" || trackedChangeDisplayType === "tableDelete") && normalizedChangeId) {
@@ -7863,6 +7882,7 @@ var useCommentsStore = defineStore("comments", () => {
 				trackedChangeLabel: normalizedTrackedChangeLabel,
 				trackedChangeDetailLines: normalizedTrackedChangeDetailLines,
 				trackedChangeImagePreview: normalizedTrackedChangeImagePreview,
+				...hasCustomAttributes ? { customAttributes: normalizedCustomAttributes } : {},
 				createdTime: date,
 				creatorId: authorId ?? null,
 				creatorName: authorName,
@@ -7978,6 +7998,10 @@ var useCommentsStore = defineStore("comments", () => {
 					target.trackedChangeDetailLines = normalizedTrackedChangeDetailLines;
 					didChange = true;
 				}
+				if (hasCustomAttributes && target && !trackedChangeCustomAttributesEqual(target.customAttributes, normalizedCustomAttributes)) {
+					target.customAttributes = normalizedCustomAttributes;
+					didChange = true;
+				}
 				return applyStoryMetadata(target) || didChange;
 			};
 			const updateExistingTrackedChange = (trackedComment) => {
@@ -8672,6 +8696,7 @@ var useCommentsStore = defineStore("comments", () => {
 			trackedChangeLabel: typeof params.trackedChangeLabel === "string" && params.trackedChangeLabel.length > 0 ? params.trackedChangeLabel : null,
 			trackedChangeDetailLines: normalizeTrackedChangeDetailLines(params.trackedChangeDetailLines),
 			trackedChangeImagePreview: normalizeTrackedChangeImagePreview(params.trackedChangeImagePreview),
+			...Object.prototype.hasOwnProperty.call(params, "customAttributes") ? { customAttributes: normalizeTrackedChangeCustomAttributes(params.customAttributes) } : {},
 			createdTime: params.date,
 			creatorId: params.authorId ?? null,
 			creatorName: params.author,
@@ -43168,7 +43193,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.35";
+		this.version = "2.4.0-next.37";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];