superdoc 2.27.0-next.2 → 2.27.0-next.4

package/dist/chunks/{create-super-doc-ui-DK14sCrT.cjs → create-super-doc-ui-BWoeA7So.cjs}

@@ -1078,6 +1078,15 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/tracked-change-comment-lane.ts
+var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
+function isSyntheticTrackedChangeCommentLaneItem(item) {
+	if (!item || typeof item !== "object") return false;
+	const { id, commentId } = item;
+	const itemId = id ?? commentId;
+	return typeof itemId === "string" && itemId.startsWith(TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX);
+}
+//#endregion
 //#region src/public/ui/viewport-batch.ts
 /** No rendering or scrolling: read only geometry already acknowledged by the host. */
 async function readViewportBatch(input, read, generation, disposed) {
@@ -7607,9 +7616,26 @@ function createSuperDocUI(options) {
 		recompute();
 		return selection;
 	};
+	const realComments = (items) => items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item));
+	let lastWindowComments = null;
+	const realCommentsOfWindow = (window) => {
+		const items = window?.commentItems;
+		if (!Array.isArray(items)) return null;
+		const last = lastWindowComments;
+		if (last?.source === items && shallowEqual(last.rows, items)) return last.real;
+		lastWindowComments = {
+			source: items,
+			rows: [...items],
+			real: realComments(items)
+		};
+		return lastWindowComments.real;
+	};
 	const readCommentsDirectory = () => {
 		const listComments = hostMethod(getDoc()?.comments, "list");
-		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => {
+			const items = isPlainObject(raw) ? raw.items : void 0;
+			return Array.isArray(items) ? realComments(items) : [];
+		});
 	};
 	const readTrackChangesDirectory = (key = "trackChanges") => {
 		const token = contentToken();
@@ -7642,7 +7668,7 @@ function createSuperDocUI(options) {
 		const reviewWindow = getV2ReviewWindowSnapshot();
 		const hasWindowFeed = hasV2ReviewWindowFeed();
 		const catalog = !hasWindowFeed ? readCommentsDirectory() : null;
-		const windowItems = hasWindowFeed && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const windowItems = hasWindowFeed ? realCommentsOfWindow(reviewWindow) : null;
 		const value = hasWindowFeed ? windowItems : catalog.value;
 		const listStatus = hasWindowFeed ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
@@ -15124,6 +15150,12 @@ Object.defineProperty(exports, "isPlainObject", {
 		return isPlainObject;
 	}
 });
+Object.defineProperty(exports, "isSyntheticTrackedChangeCommentLaneItem", {
+	enumerable: true,
+	get: function() {
+		return isSyntheticTrackedChangeCommentLaneItem;
+	}
+});
 Object.defineProperty(exports, "isWorkflowRecordingEnabled", {
 	enumerable: true,
 	get: function() {

package/dist/chunks/{create-super-doc-ui-BCQ5RHxy.es.js → create-super-doc-ui-DqZk5WpX.es.js}

@@ -1078,6 +1078,15 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/tracked-change-comment-lane.ts
+var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
+function isSyntheticTrackedChangeCommentLaneItem(item) {
+	if (!item || typeof item !== "object") return false;
+	const { id, commentId } = item;
+	const itemId = id ?? commentId;
+	return typeof itemId === "string" && itemId.startsWith(TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX);
+}
+//#endregion
 //#region src/public/ui/viewport-batch.ts
 /** No rendering or scrolling: read only geometry already acknowledged by the host. */
 async function readViewportBatch(input, read, generation, disposed) {
@@ -7606,9 +7615,26 @@ function createSuperDocUI(options) {
 		recompute();
 		return selection;
 	};
+	const realComments = (items) => items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item));
+	let lastWindowComments = null;
+	const realCommentsOfWindow = (window) => {
+		const items = window?.commentItems;
+		if (!Array.isArray(items)) return null;
+		const last = lastWindowComments;
+		if (last?.source === items && shallowEqual(last.rows, items)) return last.real;
+		lastWindowComments = {
+			source: items,
+			rows: [...items],
+			real: realComments(items)
+		};
+		return lastWindowComments.real;
+	};
 	const readCommentsDirectory = () => {
 		const listComments = hostMethod(getDoc()?.comments, "list");
-		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => {
+			const items = isPlainObject(raw) ? raw.items : void 0;
+			return Array.isArray(items) ? realComments(items) : [];
+		});
 	};
 	const readTrackChangesDirectory = (key = "trackChanges") => {
 		const token = contentToken();
@@ -7641,7 +7667,7 @@ function createSuperDocUI(options) {
 		const reviewWindow = getV2ReviewWindowSnapshot();
 		const hasWindowFeed = hasV2ReviewWindowFeed();
 		const catalog = !hasWindowFeed ? readCommentsDirectory() : null;
-		const windowItems = hasWindowFeed && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const windowItems = hasWindowFeed ? realCommentsOfWindow(reviewWindow) : null;
 		const value = hasWindowFeed ? windowItems : catalog.value;
 		const listStatus = hasWindowFeed ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
@@ -15051,4 +15077,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { isWorkflowRecordingEnabled as _, registerFirstPartyCommandMutation as a, getV2TrackedChangeMutationImpact as c, resolveImageSrc as d, shallowEqual as f, getWorkflowRecording as g, createInteractionHistory as h, readFirstPartyPageNumbers as i, isPlainObject as l, closeInteractionHistory as m, executeFirstPartyCommandAsync as n, BUILT_IN_COMMAND_IDS as o, DOM_CLASS_NAMES as p, executeFirstPartyShortcutAsync as r, applyV2CommentInvalidationFromMutation as s, createSuperDocUI as t, createImageFilePicker as u, recordInteraction as v };
+export { getWorkflowRecording as _, registerFirstPartyCommandMutation as a, getV2TrackedChangeMutationImpact as c, resolveImageSrc as d, shallowEqual as f, createInteractionHistory as g, closeInteractionHistory as h, readFirstPartyPageNumbers as i, isPlainObject as l, DOM_CLASS_NAMES as m, executeFirstPartyCommandAsync as n, BUILT_IN_COMMAND_IDS as o, isSyntheticTrackedChangeCommentLaneItem as p, executeFirstPartyShortcutAsync as r, applyV2CommentInvalidationFromMutation as s, createSuperDocUI as t, createImageFilePicker as u, isWorkflowRecordingEnabled as v, recordInteraction as y };

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.27.0-next.2",
+	superdocVersion: "2.27.0-next.4",
 	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.27.0-next.2",
+	superdocVersion: "2.27.0-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/history/history.types.d.ts

@@ -43,12 +43,6 @@ export interface SDHistoryCollaborationMeta {
  * Result of a history.undo or history.redo action.
  * Mirrors PlanReceipt's revision shape for consistency.
  *
- * AIDEV-NOTE: this shape carries optional ref-effect
- * fields. v1 callers leave them undefined; v2 (`V2HistoryAdapter`) populates
- * them from the stored semantic delta of the undone/redone transaction so
- * callers' held refs stay accurate across history actions. Never make any
- * of the new fields required — v1 adapters MUST keep compiling unchanged.
- *
  * The shape also carries three optional collaboration fields:
  * `status`, `diagnosticCode`, and `collaboration`. v1 leaves them
  * undefined; collaborative v2 sessions populate them so callers can react

package/dist/document-api/src/index.d.ts

@@ -169,7 +169,7 @@ export type { ParagraphsAdapter, ParagraphFormatApi, ParagraphStylesApi } from '
 export type { ParagraphTarget, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs/paragraphs.js';
 export { PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs/paragraphs.js';
 export type { BlockAddress, BlockRange, CanContinueReason, CanJoinReason, JoinDirection, ListInsertInput, ListItemAddress, ListItemInfo, ListKind, ListsAttachInput, ListsCanContinuePreviousInput, ListsCanContinuePreviousResult, ListsCanJoinInput, ListsCanJoinResult, ListsConvertToTextInput, ListsConvertToTextResult, ListsContinuePreviousInput, ListsCreateInput, ListsCreateResult, ListsDetachInput, ListsDetachResult, ListsDeleteInput, ListsDeleteResult, ListsFailureCode, ListsGetInput, ListsInsertResult, ListsJoinInput, ListsJoinResult, ListsListQuery, ListsListResult, ListsMutateItemResult, ListsSeparateInput, ListsSeparateResult, ListsMergeInput, ListsMergeResult, ListsSplitInput, ListsSplitResult, ListsSetLevelInput, ListsSetLevelRestartInput, ListsSetValueInput, ListTargetInput, MutationScope, LevelAlignment, TrailingCharacter, ListPresetId, ListPresetMarker, ListLevelTemplate, ListTemplate, ListsApplyTemplateInput, ListsApplyPresetInput, ListsCaptureTemplateInput, ListsCaptureTemplateResult, ListsCaptureTemplateSuccessResult, ListsSetLevelNumberingInput, ListsSetLevelBulletInput, ListsSetLevelPictureBulletInput, ListsSetLevelAlignmentInput, ListsSetLevelIndentsInput, ListsSetLevelTrailingCharacterInput, ListsSetLevelMarkerFontInput, ListsClearLevelOverridesInput, ListsSetTypeInput, ListStyle, ListLevelStyle, ListLevelLayout, ListsGetStyleInput, ListsGetStyleResult, ListsGetStyleSuccessResult, ListsApplyStyleInput, ListsRestartAtInput, ListsSetLevelNumberStyleInput, ListsSetLevelTextInput, ListsSetLevelStartInput, ListsSetLevelLayoutInput, ListsGetStateInput, ListsGetStateResult, ListsApplyInput, ListsContinueV2Input, ListsRestartV2Input, ListsRemoveV2Input, } from './lists/lists.types.js';
-export { LIST_KINDS, LIST_INSERT_POSITIONS, JOIN_DIRECTIONS, MUTATION_SCOPES, LEVEL_ALIGNMENTS, TRAILING_CHARACTERS, LIST_PRESET_IDS, LIST_PRESET_MARKERS, } from './lists/lists.types.js';
+export { LIST_KINDS, LIST_INSERT_POSITIONS, JOIN_DIRECTIONS, MUTATION_SCOPES, LEVEL_ALIGNMENTS, TRAILING_CHARACTERS, LIST_PRESET_IDS, LIST_PRESET_MARKERS, LIST_CUSTOM_NUMBERING_FORMATS, } from './lists/lists.types.js';
 export type { CreateSectionBreakInput, CreateSectionBreakResult, DocumentMutationResult, SectionAddress, SectionBorderSpec, SectionBreakCreateLocation, SectionBreakRepresentation, SectionBreakType, SectionColumns, SectionDirection, SectionDomain, SectionHeaderFooterKind, SectionHeaderFooterMargins, SectionHeaderFooterRefs, SectionHeaderFooterVariant, SectionInfo, SectionLineNumbering, SectionLineNumberRestart, SectionMutationResult, SectionOrientation, SectionPageBorders, SectionPageMargins, SectionPageNumbering, SectionPageNumberingChapterSeparator, SectionPageNumberingFormat, SectionPageSetup, SectionRangeDomain, SectionTargetInput, SectionVerticalAlign, SectionsClearHeaderFooterRefInput, SectionsClearPageBordersInput, SectionsGetInput, SectionsListQuery, SectionsListResult, SectionsSetBreakTypeInput, SectionsSetColumnsInput, SectionsSetHeaderFooterMarginsInput, SectionsSetHeaderFooterRefInput, SectionsSetLineNumberingInput, SectionsSetLinkToPreviousInput, SectionsSetOddEvenHeadersFootersInput, SectionsSetPageBordersInput, SectionsSetPageMarginsInput, SectionsSetPageNumberingInput, SectionsSetPageSetupInput, SectionsSetSectionDirectionInput, SectionsSetTitlePageInput, SectionsSetVerticalAlignInput, } from './sections/sections.types.js';
 export type { CommentsCreateReceipt, CommentsCreateInput, CommentCreateAttributionInput, CommentsPatchInput, CommentsDeleteInput, CommentsAdapter, CommentsApi, GetCommentInput, TrackedChangeCommentTarget, TrackedChangeCommentTargetSide, TextSearchCommentTarget, AddCommentInput, EditCommentInput, ReplyToCommentInput, MoveCommentInput, ResolveCommentInput, ReopenCommentInput, RemoveCommentInput, SetCommentInternalInput, GoToCommentInput, SetCommentActiveInput, } from './comments/comments.js';
 export { executeCommentsCreate, executeCommentsPatch, executeCommentsDelete, executeGetComment, executeListComments, } from './comments/comments.js';

package/dist/document-api/src/lists/lists.types.d.ts

@@ -206,10 +206,12 @@ export interface ListsConvertToTextInput {
     target: ListItemAddress;
     includeMarker?: boolean;
 }
+export declare const LIST_CUSTOM_NUMBERING_FORMATS: readonly ["01, 02, 03, ...", "001, 002, 003, ...", "0001, 0002, 0003, ..."];
 /** A captured snapshot of one level's formatting properties. */
 export interface ListLevelTemplate {
     level: number;
     numFmt?: string;
+    customFormat?: string;
     lvlText?: string;
     start?: number;
     alignment?: LevelAlignment;
@@ -274,6 +276,7 @@ export interface ListsSetLevelNumberingInput {
     target: ListItemAddress;
     level: number;
     numFmt: string;
+    customFormat?: string;
     lvlText: string;
     start?: number;
     /** Format numeric placeholders as decimal. False removes legal numbering; omit to preserve it. */

package/dist/layout-engine/contracts/src/direction-context.d.ts

@@ -197,8 +197,7 @@ export declare function getParagraphInlineDirection(attrs: {
  *
  * Prefers the resolved {@link TableDirectionContext} when present, falls
  * back to the legacy `tableProperties.rightToLeft` (or `bidiVisual` alias)
- * for compatibility. The AIDEV-NOTE on the fallback branch names the
- * retirement signal.
+ * for compatibility.
  *
  * Per ECMA-376 §17.4.1, `w:bidiVisual` affects only cell ordering and
  * table-visual properties. Cell paragraph inline direction is independent;

package/dist/layout-engine/contracts/src/resolved-layout.d.ts

@@ -111,8 +111,6 @@ export type ResolvedGroupItem = {
 /**
  * A resolved fragment wrapper item.
  * Carries positioning and metadata needed to create the fragment's DOM wrapper.
- * Inner content rendering is delegated to the Fragment-based render path via
- * fragmentIndex; see the compat-fallback note on that field.
  */
 export type ResolvedFragmentItem = {
     kind: 'fragment';
@@ -138,14 +136,6 @@ export type ResolvedFragmentItem = {
     fragment: Fragment;
     /** Block ID. Written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** ProseMirror start position for click-to-position mapping. */
     pmStart?: number;
@@ -280,14 +270,6 @@ export type ResolvedTableItem = {
     zIndex?: number;
     /** Block ID — written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** Source TableFragment back-pointer (see ResolvedFragmentItem.fragment). */
     fragment: Fragment;
@@ -357,14 +339,6 @@ export type ResolvedImageItem = {
     zIndex?: number;
     /** Block ID — written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** Source ImageFragment back-pointer (see ResolvedFragmentItem.fragment). */
     fragment: Fragment;
@@ -426,14 +400,6 @@ export type ResolvedDrawingItem = {
     zIndex?: number;
     /** Block ID — written to data-block-id. */
     blockId: string;
-    /**
-     * Index back into page.fragments.
-     *
-     * AIDEV-NOTE: compat-fallback. The painter currently reads inner content from
-     * Fragment via this index because ResolvedFragmentItem does not carry full
-     * content yet. Becomes unused once paint items are self-describing; do not
-     * promote this to a permanent API surface.
-     */
     fragmentIndex: number;
     /** Source DrawingFragment back-pointer (see ResolvedFragmentItem.fragment). */
     fragment: Fragment;

package/dist/layout-engine/layout-bridge/src/neutral-hit.d.ts

@@ -35,13 +35,6 @@ export type LayoutHit = {
     sourceAnchor?: SourceAnchor;
     /** Diagnostics for partially supported or rejected hits. */
     diagnostics?: LayoutHitDiagnostic[];
-    /**
-     * Legacy PM-shaped position hit.
-     *
-     * AIDEV-NOTE: compat-fallback - callers may still consume `pmPosition`.
-     * Retire once providers stop relying on PM positions to map this hit back to
-     * a document ref. Do not gate new editor-neutral behavior on this field.
-     */
     legacyPm?: PositionHit;
 };
 export type LayoutHitDiagnostic = {

package/dist/layout-engine/layout-engine/src/index.d.ts

@@ -302,7 +302,6 @@ export type LayoutDocumentContinuation = {
     }): Promise<LayoutContinuationBatch>;
     dispose(): void;
 };
-/** AIDEV-NOTE: The handle owns one live paginator; advancing never replays a stopped prefix. */
 export declare function createLayoutDocumentContinuation(blocks: FlowBlock[], measures: Measure[], options?: LayoutOptions, execution?: LayoutExecutionControl): LayoutDocumentContinuation;
 export type LayoutRangeBoundaryPolicy = 'conservative-context' | 'overscan' | 'degraded-on-incomplete-state';
 export type LayoutRangeExactness = 'exact' | 'pending-layout' | 'degraded-unsupported' | 'stale';

package/dist/layout-engine/painters/dom/src/features/inline-direction/run-direction.d.ts

@@ -26,9 +26,6 @@ export declare const RTL_DATE_LIKE_TOKEN_RE: RegExp;
  * FE70-FEFF Arabic-B). The block range covers Hebrew, Arabic, Syriac, NKo,
  * etc.; the Script properties add presentation forms without including
  * noncharacters (FDD0-FDEF) or the BOM (FEFF).
- *
- * AIDEV-NOTE: also used by editing/runtime mixed-bidi handling. Consolidating
- * crosses a layer boundary; tracked under SD-3169 follow-ups.
  */
 export declare const STRONG_RTL_CHAR_RE: RegExp;
 /**

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DK14sCrT.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWoeA7So.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 let use_sync_external_store_shim = require("use-sync-external-store/shim");

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BCQ5RHxy.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DqZk5WpX.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DK14sCrT.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWoeA7So.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BCQ5RHxy.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DqZk5WpX.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DK14sCrT.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWoeA7So.cjs");
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/public/ui.es.js

@@ -1,4 +1,4 @@
-import { f as shallowEqual, o as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BCQ5RHxy.es.js";
+import { f as shallowEqual, o as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DqZk5WpX.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {

package/dist/superdoc/src/core/v2-integration/v2-integration.d.ts

@@ -1,3 +1,4 @@
+import { isSyntheticTrackedChangeCommentLaneItem } from '../../helpers/tracked-change-comment-lane.js';
 /**
  * Replace the package loader before engine loading starts. The CDN entry uses
  * this seam to fetch the exact engine version from its public package URL.
@@ -9,11 +10,6 @@ export function configureDefaultV2IntegrationLoader(loader: () => Promise<unknow
 export function loadDefaultV2Integration(): Promise<void>;
 /** Load the engine for editor startup, preserving the fail-closed stub on failure. */
 export function loadDefaultV2IntegrationOrFallback(): Promise<void>;
-/**
- * @param {unknown} item
- * @returns {boolean}
- */
-export function isSyntheticTrackedChangeCommentLaneItem(item: unknown): boolean;
 /**
  * @param {{ trackedChange?: unknown, trackedChangeAnchorKey?: unknown } | null | undefined} row
  * @returns {boolean}
@@ -61,6 +57,7 @@ export function hasRealV2Integration(integration: SuperDocV2Integration | null |
  */
 /** Default version for the local stub integration (V1-compatible). */
 export const SUPERDOC_V2_INTEGRATION_VERSION: 1;
+export { isSyntheticTrackedChangeCommentLaneItem };
 export type SuperDocV2Integration = {
     /**
      * Integration contract version.

package/dist/superdoc/src/helpers/tracked-change-comment-lane.d.ts

@@ -0,0 +1 @@
+export declare function isSyntheticTrackedChangeCommentLaneItem(item: unknown): boolean;

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-74VwNCz7.cjs");
 const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DK14sCrT.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-BWoeA7So.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-BUdjGKyl.cjs");
@@ -260,7 +260,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.27.0-next.2";
+		return "2.27.0-next.4";
 	} catch {
 		return "unknown";
 	}
@@ -7087,19 +7087,8 @@ async function loadDefaultV2IntegrationOrFallback() {
 		console.error("[SuperDoc] DOCX Engine failed to load; using the stub.", error);
 	}
 }
-var V2_SYNTHETIC_TRACKED_CHANGE_COMMENT_ID_PREFIX = "tc-comment:";
 var V2_BODY_TRACKED_CHANGE_ANCHOR_PREFIX = "tc::body::";
 /**
-* @param {unknown} item
-* @returns {boolean}
-*/
-function isSyntheticTrackedChangeCommentLaneItem(item) {
-	if (!item || typeof item !== "object") return false;
-	const id = item.id ?? item.commentId;
-	if (typeof id !== "string") return false;
-	return id.startsWith(V2_SYNTHETIC_TRACKED_CHANGE_COMMENT_ID_PREFIX);
-}
-/**
 * @param {{ trackedChange?: unknown, trackedChangeAnchorKey?: unknown } | null | undefined} row
 * @returns {boolean}
 */
@@ -7165,7 +7154,7 @@ function createStubV2Integration() {
 		RulerComponent: null,
 		createGeometryPublisher: createStubGeometryPublisher,
 		createReviewWindowController: createStubReviewWindowController,
-		isSyntheticTrackedChangeCommentLaneItem,
+		isSyntheticTrackedChangeCommentLaneItem: require_create_super_doc_ui.isSyntheticTrackedChangeCommentLaneItem,
 		isV2SyntheticTrackedChangeRow
 	};
 }
@@ -9352,7 +9341,7 @@ var useCommentsStore = defineStore("comments", () => {
 		}
 		const documentId = superdoc?.activeEditor?.documentId ?? superdoc?.activeEditor?.options?.documentId ?? commentsAdapter.documentId ?? trackedChangesAdapter.documentId ?? null;
 		const document = documentId != null ? superdocStore.getDocument(String(documentId)) : null;
-		const mappedCommentInputs = commentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
+		const mappedCommentInputs = commentItems.filter((item) => !require_create_super_doc_ui.isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
 			fileId: documentId,
 			fileType: document?.type ?? null
 		})).filter(Boolean);
@@ -9885,7 +9874,7 @@ var useCommentsStore = defineStore("comments", () => {
 					...input.selection,
 					documentId: normalizedDocumentId
 				}
-			})) : effectiveCommentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
+			})) : effectiveCommentItems.filter((item) => !require_create_super_doc_ui.isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
 				fileId: normalizedDocumentId,
 				fileType
 			})).filter(Boolean);
@@ -9990,7 +9979,7 @@ var useCommentsStore = defineStore("comments", () => {
 		const incomingByCommentId = /* @__PURE__ */ new Map();
 		const trackedChangeSidecarParentByCommentId = /* @__PURE__ */ new Map();
 		const mappedInputs = [];
-		const candidateInputs = Array.isArray(preparedInputs) ? preparedInputs : items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => adapter.mapV2CommentToUseCommentInput(item, {
+		const candidateInputs = Array.isArray(preparedInputs) ? preparedInputs : items.filter((item) => !require_create_super_doc_ui.isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => adapter.mapV2CommentToUseCommentInput(item, {
 			fileId: effectiveDocumentId,
 			fileType
 		})).filter(Boolean);
@@ -46242,7 +46231,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.27.0-next.2";
+		this.version = "2.27.0-next.4";
 		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

@@ -1,6 +1,6 @@
 import { i as __toESM$2 } from "./chunks/rolldown-runtime-0pSA04fp.es.js";
 import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
-import { _ as isWorkflowRecordingEnabled, a as registerFirstPartyCommandMutation, c as getV2TrackedChangeMutationImpact, d as resolveImageSrc, g as getWorkflowRecording, h as createInteractionHistory, i as readFirstPartyPageNumbers, l as isPlainObject$1, m as closeInteractionHistory, n as executeFirstPartyCommandAsync, p as DOM_CLASS_NAMES, r as executeFirstPartyShortcutAsync, s as applyV2CommentInvalidationFromMutation, t as createSuperDocUI, u as createImageFilePicker, v as recordInteraction } from "./chunks/create-super-doc-ui-BCQ5RHxy.es.js";
+import { _ as getWorkflowRecording, a as registerFirstPartyCommandMutation, c as getV2TrackedChangeMutationImpact, d as resolveImageSrc, g as createInteractionHistory, h as closeInteractionHistory, i as readFirstPartyPageNumbers, l as isPlainObject$1, m as DOM_CLASS_NAMES, n as executeFirstPartyCommandAsync, p as isSyntheticTrackedChangeCommentLaneItem, r as executeFirstPartyShortcutAsync, s as applyV2CommentInvalidationFromMutation, t as createSuperDocUI, u as createImageFilePicker, v as isWorkflowRecordingEnabled, y as recordInteraction } from "./chunks/create-super-doc-ui-DqZk5WpX.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-DEIiXiH2.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { $ as vModelText, A as onActivated, B as renderSlot, C as isRef$1, D as normalizeClass, E as nextTick, F as openBlock, G as toRaw$2, H as resolveDynamicComponent, I as provide$1, J as unref, K as toRef, L as reactive, M as onDeactivated, N as onMounted, O as normalizeProps, P as onScopeDispose$1, Q as vModelSelect, R as ref, S as isReactive$1, T as mergeProps, U as shallowRef$1, V as resolveDirective, W as toDisplayString, X as useSlots, Y as useAttrs, Z as vModelCheckbox, _ as getCurrentInstance, a as computed$1, b as hasInjectionContext, c as createCommentVNode, d as createStaticVNode, et as watch$1, f as createTextVNode, g as effectScope, h as defineComponent, i as Transition, it as withModifiers, j as onBeforeUnmount, k as normalizeStyle, l as createElementBlock, m as defineAsyncComponent, n as Fragment, nt as withDirectives, o as createApp, p as createVNode, q as toRefs, r as Teleport, rt as withKeys, s as createBlock, t as _plugin_vue_export_helper_default, tt as withCtx, u as createElementVNode, v as getCurrentScope, w as markRaw, x as inject$1, y as h, z as renderList } from "./chunks/_plugin-vue_export-helper-7ZiLY07t.es.js";
@@ -258,7 +258,7 @@ var v_click_outside_default = {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.27.0-next.2";
+		return "2.27.0-next.4";
 	} catch {
 		return "unknown";
 	}
@@ -7085,19 +7085,8 @@ async function loadDefaultV2IntegrationOrFallback() {
 		console.error("[SuperDoc] DOCX Engine failed to load; using the stub.", error);
 	}
 }
-var V2_SYNTHETIC_TRACKED_CHANGE_COMMENT_ID_PREFIX = "tc-comment:";
 var V2_BODY_TRACKED_CHANGE_ANCHOR_PREFIX = "tc::body::";
 /**
-* @param {unknown} item
-* @returns {boolean}
-*/
-function isSyntheticTrackedChangeCommentLaneItem(item) {
-	if (!item || typeof item !== "object") return false;
-	const id = item.id ?? item.commentId;
-	if (typeof id !== "string") return false;
-	return id.startsWith(V2_SYNTHETIC_TRACKED_CHANGE_COMMENT_ID_PREFIX);
-}
-/**
 * @param {{ trackedChange?: unknown, trackedChangeAnchorKey?: unknown } | null | undefined} row
 * @returns {boolean}
 */
@@ -46172,7 +46161,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.27.0-next.2";
+		this.version = "2.27.0-next.4";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];