superdoc 2.28.0-next.17 → 2.28.0-next.19

package/dist/chunks/{create-super-doc-ui-CAfcpwSS.es.js → create-super-doc-ui-BEB7RtD6.es.js}

@@ -6716,9 +6716,19 @@ function createSuperDocUI(options) {
 		if (seeded > 0) dirtyHosts.add(host);
 		else if (revision === 0) dirtyHosts.delete(host);
 	};
-	const hasLocalDocumentMutation = () => {
+	const savedPoint = () => {
 		const host = getHost();
+		return {
+			host,
+			isDirty: hostMethod(host, "isDirty"),
+			getDocumentVersion: hostMethod(host, "getDocumentVersion"),
+			markSaved: hostMethod(host, "markSaved")
+		};
+	};
+	const hasLocalDocumentMutation = () => {
+		const { host, isDirty } = savedPoint();
 		if (!host) return false;
+		if (isDirty) return Boolean(safeCall(() => isDirty(), false));
 		seedLocalDocumentMutation(host);
 		return dirtyHosts.has(host);
 	};
@@ -8129,6 +8139,33 @@ function createSuperDocUI(options) {
 			sizeOptions: DEFAULT_FONT_SIZE_OPTIONS
 		};
 	};
+	const EMPTY_HISTORY = {
+		canUndo: false,
+		canRedo: false,
+		undoDepth: 0,
+		redoDepth: 0
+	};
+	let historySlice = EMPTY_HISTORY;
+	let historySource = null;
+	const computeHistory = () => {
+		const source = getEditCommands();
+		if (source !== historySource) {
+			historySource = source;
+			historySlice = EMPTY_HISTORY;
+		}
+		const getSnapshot = hostMethod(source, "getSnapshot");
+		const snapshot = getSnapshot ? safeCall(() => getSnapshot(), null) : null;
+		const { undoDepth, redoDepth } = (isPlainObject(snapshot) && isPlainObject(snapshot.history) ? snapshot.history : null) ?? {};
+		if (typeof undoDepth !== "number" || typeof redoDepth !== "number") return historySlice;
+		const next = {
+			canUndo: undoDepth > 0,
+			canRedo: redoDepth > 0,
+			undoDepth,
+			redoDepth
+		};
+		if (!shallowEqual(next, historySlice)) historySlice = next;
+		return historySlice;
+	};
 	let zoomFitWidth;
 	const computeZoom = () => {
 		const getZoomState = hostMethod(superdoc, "getZoomState");
@@ -9941,6 +9978,7 @@ function createSuperDocUI(options) {
 			trackChanges: measure("trackChanges", () => computeTrackChanges(selection)),
 			contentControls: measure("contentControls", () => computeContentControls(selection)),
 			zoom: measure("zoom", computeZoom),
+			history: measure("history", computeHistory),
 			fonts: measure("fonts", computeFonts),
 			styles: measure("styles", () => computeStyles(selection))
 		};
@@ -10289,10 +10327,13 @@ function createSuperDocUI(options) {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
 				}
 				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
-				if ((type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event)) && host && !dirtyHosts.has(host)) {
+				const documentEdited = type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event);
+				if (documentEdited && host && hostMethod(host, "isDirty")) recompute("document-dirty");
+				else if (documentEdited && host && !dirtyHosts.has(host)) {
 					dirtyHosts.add(host);
 					recompute("document-dirty");
 				}
+				if (type === "document:saved-point-changed") recompute("document-dirty");
 				if (type === "collaboration:document-replaced" && host) {
 					dirtyHosts.delete(host);
 					hostSeededMutationRevision.delete(host);
@@ -13779,6 +13820,7 @@ function createSuperDocUI(options) {
 		getFamilyOptions: () => state.fonts.options,
 		getSizeOptions: () => state.fonts.sizeOptions
 	};
+	const history = snapshotHandle(sliceHandle((s) => s.history));
 	const zoomSnap = snapshotHandle(sliceHandle((s) => s.zoom));
 	const zoom = {
 		get: zoomSnap.get,
@@ -13844,6 +13886,23 @@ function createSuperDocUI(options) {
 			if (disposed) return () => {};
 			documentChangeListeners.add(listener);
 			return () => documentChangeListeners.delete(listener);
+		},
+		getVersion: () => {
+			const { getDocumentVersion } = savedPoint();
+			const version = getDocumentVersion ? safeCall(() => getDocumentVersion(), null) : null;
+			return typeof version === "string" ? version : null;
+		},
+		markClean: (version) => {
+			const { markSaved } = savedPoint();
+			if (!markSaved) return {
+				ok: false,
+				reason: "unavailable"
+			};
+			const result = safeCall(() => markSaved(version), null);
+			return isPlainObject(result) && result.ok === true ? { ok: true } : {
+				ok: false,
+				reason: isPlainObject(result) && result.reason === "document-changed" ? "document-changed" : "unavailable"
+			};
 		}
 	};
 	const resolveVisibleHost = () => {
@@ -15435,6 +15494,7 @@ function createSuperDocUI(options) {
 		bookmarks,
 		fonts,
 		zoom,
+		history,
 		document: documentHandle,
 		viewport,
 		decorations,
@@ -15656,4 +15716,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { closeInteractionHistory as _, registerFirstPartyCommandMutation as a, isWorkflowRecordingEnabled as b, applyV2CommentInvalidationFromMutation as c, isPlainObject as d, createImageFilePicker as f, DOM_CLASS_NAMES as g, isSyntheticTrackedChangeCommentLaneItem as h, readFirstPartyPageNumbers as i, getV2TrackedChangeMutationImpact as l, shallowEqual as m, executeFirstPartyCommandAsync as n, isRecord as o, resolveImageSrc as p, executeFirstPartyShortcutAsync as r, BUILT_IN_COMMAND_IDS as s, createSuperDocUI as t, mutationCommittedEventChangedDocument as u, createInteractionHistory as v, recordInteraction as x, getWorkflowRecording as y };
+export { recordInteraction as S, DOM_CLASS_NAMES as _, registerFirstPartyCommandMutation as a, getWorkflowRecording as b, getCommandDescriptor as c, mutationCommittedEventChangedDocument as d, isPlainObject as f, isSyntheticTrackedChangeCommentLaneItem as g, shallowEqual as h, readFirstPartyPageNumbers as i, applyV2CommentInvalidationFromMutation as l, resolveImageSrc as m, executeFirstPartyCommandAsync as n, isRecord as o, createImageFilePicker as p, executeFirstPartyShortcutAsync as r, BUILT_IN_COMMAND_IDS as s, createSuperDocUI as t, getV2TrackedChangeMutationImpact as u, closeInteractionHistory as v, isWorkflowRecordingEnabled as x, createInteractionHistory as y };

package/dist/chunks/{create-super-doc-ui-CXdsObDZ.cjs → create-super-doc-ui-DNe9BmHD.cjs}

@@ -6717,9 +6717,19 @@ function createSuperDocUI(options) {
 		if (seeded > 0) dirtyHosts.add(host);
 		else if (revision === 0) dirtyHosts.delete(host);
 	};
-	const hasLocalDocumentMutation = () => {
+	const savedPoint = () => {
 		const host = getHost();
+		return {
+			host,
+			isDirty: hostMethod(host, "isDirty"),
+			getDocumentVersion: hostMethod(host, "getDocumentVersion"),
+			markSaved: hostMethod(host, "markSaved")
+		};
+	};
+	const hasLocalDocumentMutation = () => {
+		const { host, isDirty } = savedPoint();
 		if (!host) return false;
+		if (isDirty) return Boolean(safeCall(() => isDirty(), false));
 		seedLocalDocumentMutation(host);
 		return dirtyHosts.has(host);
 	};
@@ -8130,6 +8140,33 @@ function createSuperDocUI(options) {
 			sizeOptions: DEFAULT_FONT_SIZE_OPTIONS
 		};
 	};
+	const EMPTY_HISTORY = {
+		canUndo: false,
+		canRedo: false,
+		undoDepth: 0,
+		redoDepth: 0
+	};
+	let historySlice = EMPTY_HISTORY;
+	let historySource = null;
+	const computeHistory = () => {
+		const source = getEditCommands();
+		if (source !== historySource) {
+			historySource = source;
+			historySlice = EMPTY_HISTORY;
+		}
+		const getSnapshot = hostMethod(source, "getSnapshot");
+		const snapshot = getSnapshot ? safeCall(() => getSnapshot(), null) : null;
+		const { undoDepth, redoDepth } = (isPlainObject(snapshot) && isPlainObject(snapshot.history) ? snapshot.history : null) ?? {};
+		if (typeof undoDepth !== "number" || typeof redoDepth !== "number") return historySlice;
+		const next = {
+			canUndo: undoDepth > 0,
+			canRedo: redoDepth > 0,
+			undoDepth,
+			redoDepth
+		};
+		if (!shallowEqual(next, historySlice)) historySlice = next;
+		return historySlice;
+	};
 	let zoomFitWidth;
 	const computeZoom = () => {
 		const getZoomState = hostMethod(superdoc, "getZoomState");
@@ -9942,6 +9979,7 @@ function createSuperDocUI(options) {
 			trackChanges: measure("trackChanges", () => computeTrackChanges(selection)),
 			contentControls: measure("contentControls", () => computeContentControls(selection)),
 			zoom: measure("zoom", computeZoom),
+			history: measure("history", computeHistory),
 			fonts: measure("fonts", computeFonts),
 			styles: measure("styles", () => computeStyles(selection))
 		};
@@ -10290,10 +10328,13 @@ function createSuperDocUI(options) {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
 				}
 				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
-				if ((type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event)) && host && !dirtyHosts.has(host)) {
+				const documentEdited = type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event);
+				if (documentEdited && host && hostMethod(host, "isDirty")) recompute("document-dirty");
+				else if (documentEdited && host && !dirtyHosts.has(host)) {
 					dirtyHosts.add(host);
 					recompute("document-dirty");
 				}
+				if (type === "document:saved-point-changed") recompute("document-dirty");
 				if (type === "collaboration:document-replaced" && host) {
 					dirtyHosts.delete(host);
 					hostSeededMutationRevision.delete(host);
@@ -13780,6 +13821,7 @@ function createSuperDocUI(options) {
 		getFamilyOptions: () => state.fonts.options,
 		getSizeOptions: () => state.fonts.sizeOptions
 	};
+	const history = snapshotHandle(sliceHandle((s) => s.history));
 	const zoomSnap = snapshotHandle(sliceHandle((s) => s.zoom));
 	const zoom = {
 		get: zoomSnap.get,
@@ -13845,6 +13887,23 @@ function createSuperDocUI(options) {
 			if (disposed) return () => {};
 			documentChangeListeners.add(listener);
 			return () => documentChangeListeners.delete(listener);
+		},
+		getVersion: () => {
+			const { getDocumentVersion } = savedPoint();
+			const version = getDocumentVersion ? safeCall(() => getDocumentVersion(), null) : null;
+			return typeof version === "string" ? version : null;
+		},
+		markClean: (version) => {
+			const { markSaved } = savedPoint();
+			if (!markSaved) return {
+				ok: false,
+				reason: "unavailable"
+			};
+			const result = safeCall(() => markSaved(version), null);
+			return isPlainObject(result) && result.ok === true ? { ok: true } : {
+				ok: false,
+				reason: isPlainObject(result) && result.reason === "document-changed" ? "document-changed" : "unavailable"
+			};
 		}
 	};
 	const resolveVisibleHost = () => {
@@ -15436,6 +15495,7 @@ function createSuperDocUI(options) {
 		bookmarks,
 		fonts,
 		zoom,
+		history,
 		document: documentHandle,
 		viewport,
 		decorations,
@@ -15711,6 +15771,12 @@ Object.defineProperty(exports, "executeFirstPartyShortcutAsync", {
 		return executeFirstPartyShortcutAsync;
 	}
 });
+Object.defineProperty(exports, "getCommandDescriptor", {
+	enumerable: true,
+	get: function() {
+		return getCommandDescriptor;
+	}
+});
 Object.defineProperty(exports, "getV2TrackedChangeMutationImpact", {
 	enumerable: true,
 	get: function() {

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.28.0-next.17",
+	superdocVersion: "2.28.0-next.19",
 	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.28.0-next.17",
+	superdocVersion: "2.28.0-next.19",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -2829,7 +2829,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly 'footnotes.insert': {
         readonly memberPath: "footnotes.insert";
         readonly description: "Insert a new footnote or endnote at a target location or the current selection.";
-        readonly expectedResult: "Returns a FootnoteMutationResult indicating success with the footnote address or a failure.";
+        readonly expectedResult: string;
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "footnotes/insert.mdx";

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

@@ -214,6 +214,7 @@ export interface ListLevelTemplate {
     customFormat?: string;
     lvlText?: string;
     start?: number;
+    lvlRestart?: number;
     alignment?: LevelAlignment;
     indents?: {
         left?: number;

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

@@ -1,4 +1,4 @@
-import { BlockNodeAddress, ChangeMode, ReceiptFailure } from '../types/index.js';
+import { BlockNodeAddress, ChangeMode, ReceiptFailure, TrackedChangeAddress } from '../types/index.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 export type SectionAddress = {
     kind: 'section';
@@ -111,6 +111,7 @@ export interface SectionsGetInput {
 export type SectionsListResult = DiscoveryOutput<SectionDomain>;
 export interface SectionMutationSuccessResult {
     success: true;
+    dryRun?: boolean;
     section: SectionAddress;
     /** Committed review-aware content mode; omitted for dry runs, no-ops and non-reviewable settings. */
     appliedChangeMode?: ChangeMode;
@@ -126,11 +127,14 @@ export type SectionMutationResult = SectionMutationSuccessResult | SectionMutati
  */
 export interface DocumentMutationSuccessResult {
     success: true;
+    dryRun?: boolean;
+    changed?: boolean;
 }
 export type DocumentMutationResult = DocumentMutationSuccessResult | SectionMutationFailureResult;
 export interface CreateSectionBreakSuccessResult {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
+    trackedChangeRefs?: TrackedChangeAddress[];
     section: SectionAddress;
     /**
      * Present only when the break is represented as a dedicated paragraph.

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

@@ -145,6 +145,7 @@ export type ReceiptSuccess = {
     /** Temporary-preview lifecycle and caller tag, also delivered through mutation events. */
     temporary?: import('./temporary-mutation.js').TemporaryMutationMetadata;
     success: true;
+    status?: 'NO_OP';
     /** Whether a successful request changed the document; false represents a no-op commit. */
     changed?: boolean;
     /** Tracked changes authored by this mutation. */

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

@@ -564,6 +564,7 @@ export type RenderPlaceholder = {
  */
 export type ImageRun = {
     kind: 'image';
+    inlineDrawingId?: string;
     /** Image source URL (data URI or external URL). */
     src: string;
     /** Image width in pixels. */
@@ -2406,6 +2407,7 @@ export type ImageMeasure = {
 };
 export type DrawingMeasure = {
     kind: 'drawing';
+    inlineDrawing?: boolean;
     drawingKind: DrawingKind;
     width: number;
     height: number;

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

@@ -213,3 +213,4 @@ export declare function pmPosToCharOffset(block: FlowBlock, line: Line, pmPos: n
 export declare function pmPosToVisualCharOffset(block: FlowBlock, line: Line, pmPos: number): number;
 export { measureVisualBidiFragment, type MeasuredVisualBidiFragment } from './neutral-segment-geometry.js';
 export { measuredVisualBidiCaretX, measuredVisualBidiOffsetAtX, measuredVisualBidiRangeBands, isMeasuredVisualBidiLineCurrent, type MeasuredVisualBidiLine, } from './visual-bidi-geometry.js';
+export { placeInlineDrawings } from './place-inline-drawings.js';

package/dist/layout-engine/layout-bridge/src/place-inline-drawings.d.ts

@@ -0,0 +1,9 @@
+import { FlowBlock, Layout, Measure } from '../../contracts/src/index.js';
+export declare function placeInlineDrawings(layout: Layout, blocks: FlowBlock[], measures: Measure[], blockIndexById?: ReadonlyMap<string, number>, retainedPages?: {
+    prefixEndPageIndex?: number;
+    tail?: {
+        startPageIndex: number;
+        endPageIndexExclusive: number;
+        blockIdRewrites?: ReadonlyMap<string, string> | null;
+    };
+}): Layout;

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

@@ -9,6 +9,7 @@ import { PageState } from './paginator.js';
  * callbacks for positioning the drawing fragment on the current page/column.
  */
 export type DrawingLayoutContext = {
+    inlineParagraphBound?: boolean;
     /** The drawing block to layout */
     block: DrawingBlock;
     /** Measured dimensions and geometry data for the drawing */
@@ -57,4 +58,4 @@ export type DrawingLayoutContext = {
  * - Anchored drawings (`block.anchor?.isAnchored === true`) are skipped
  * - They are positioned via the paragraph anchoring pre-pass
  */
-export declare function layoutDrawingBlock({ block, measure, columns, ensurePage, advanceColumn, columnX, textboxContentMeasures, }: DrawingLayoutContext): void;
+export declare function layoutDrawingBlock({ block, measure, columns, ensurePage, advanceColumn, columnX, textboxContentMeasures, inlineParagraphBound, }: DrawingLayoutContext): void;

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-CXdsObDZ.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNe9BmHD.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-CAfcpwSS.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BEB7RtD6.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-CXdsObDZ.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNe9BmHD.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-CAfcpwSS.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-BEB7RtD6.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-CXdsObDZ.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNe9BmHD.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 { m as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-CAfcpwSS.es.js";
+import { h as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-BEB7RtD6.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {