superdoc 2.28.0-next.13 → 2.28.0-next.15

package/dist/chunks/{create-super-doc-ui-B6Va_J_0.es.js → create-super-doc-ui-BRahDsch.es.js}

@@ -5774,6 +5774,43 @@ function mutationCommittedEventChangedDocument(event) {
 	if (receipt && typeof receipt === "object" && receipt.status === "NO_OP") return false;
 	return true;
 }
+function readTxId(value) {
+	return typeof value === "string" && value.length > 0 ? value : null;
+}
+function documentChangeScope(stories) {
+	return Array.isArray(stories) && stories.length > 0 ? {
+		kind: "known",
+		stories
+	} : { kind: "unknown" };
+}
+function documentChangeFromHostEvent(event) {
+	if (event.type === "collaboration:remote-changed") return {
+		cause: "remote",
+		changeTag: null,
+		txId: null,
+		scope: { kind: "unknown" }
+	};
+	if (event.type !== "mutation:committed") return null;
+	if (event.origin === "history") {
+		const result = isPlainObject(event.result) ? event.result : null;
+		if (!result || result.noop === true) return null;
+		const history = isPlainObject(result.history) ? result.history : null;
+		return {
+			cause: event.direction === "redo" ? "redo" : "undo",
+			changeTag: null,
+			txId: readTxId(history?.txId),
+			scope: documentChangeScope(result.affectedStories)
+		};
+	}
+	if (!mutationCommittedEventChangedDocument(event)) return null;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : {};
+	return {
+		cause: event.cause === "user" ? "user" : "api",
+		changeTag: typeof receipt.changeTag === "string" ? receipt.changeTag : null,
+		txId: readTxId(receipt.txId),
+		scope: documentChangeScope(receipt.affectedStories)
+	};
+}
 function commandResultSucceeded(result) {
 	if (result === false) return false;
 	if (result && typeof result === "object" && result.success === false) return false;
@@ -10195,6 +10232,25 @@ function createSuperDocUI(options) {
 	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	let scheduleActiveSearchRefresh = () => {};
+	const documentChangeListeners = /* @__PURE__ */ new Set();
+	let documentChangeEpoch = 0;
+	let documentChangeSeq = 0;
+	const startDocumentChangeEpoch = () => {
+		documentChangeEpoch += 1;
+		documentChangeSeq = 0;
+	};
+	const publishDocumentChange = (event) => {
+		if (documentChangeListeners.size === 0) return;
+		const facts = documentChangeFromHostEvent(event);
+		if (!facts) return;
+		documentChangeSeq += 1;
+		const change = {
+			documentEpoch: `document-${documentChangeEpoch}`,
+			seq: documentChangeSeq,
+			...facts
+		};
+		for (const listener of Array.from(documentChangeListeners)) safeCall(() => listener(change), void 0);
+	};
 	const syncHostEventsSubscription = () => {
 		const host = getEditor()?.host;
 		const events = host?.events;
@@ -10213,6 +10269,8 @@ function createSuperDocUI(options) {
 		try {
 			const off = hostMethod(next, "subscribe")?.((event) => {
 				const type = event?.type;
+				if (type === "collaboration:document-replaced") startDocumentChangeEpoch();
+				publishDocumentChange(event);
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
 				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
@@ -13764,8 +13822,14 @@ function createSuperDocUI(options) {
 			} catch {
 				return;
 			}
+		},
+		onChange: (listener) => {
+			if (disposed) return () => {};
+			documentChangeListeners.add(listener);
+			return () => documentChangeListeners.delete(listener);
 		}
 	};
+	documentResetHooks.push(startDocumentChangeEpoch);
 	const resolveVisibleHost = () => {
 		if (typeof HTMLElement === "undefined") return null;
 		const mountContainer = (getEditor()?.mount)?.container;
@@ -15246,6 +15310,11 @@ function createSuperDocUI(options) {
 		const scopeUnsubs = [];
 		return {
 			decorations: createDecorationsHandle((handle) => scopeUnsubs.push(() => handle.dispose())),
+			document: { onChange: (listener) => {
+				const unsub = documentHandle.onChange(listener);
+				scopeUnsubs.push(unsub);
+				return unsub;
+			} },
 			select: (selector, equality) => {
 				const sub = select(selector, equality);
 				return {
@@ -15332,6 +15401,7 @@ function createSuperDocUI(options) {
 		painterCaptureEpoch += 1;
 		painterCommandDoc = null;
 		painterModeListeners.clear();
+		documentChangeListeners.clear();
 		searchRequestGeneration += 1;
 		customCommands.clear();
 	};

package/dist/chunks/{create-super-doc-ui-8dttPeGi.cjs → create-super-doc-ui-CFlvn2wr.cjs}

@@ -5775,6 +5775,43 @@ function mutationCommittedEventChangedDocument(event) {
 	if (receipt && typeof receipt === "object" && receipt.status === "NO_OP") return false;
 	return true;
 }
+function readTxId(value) {
+	return typeof value === "string" && value.length > 0 ? value : null;
+}
+function documentChangeScope(stories) {
+	return Array.isArray(stories) && stories.length > 0 ? {
+		kind: "known",
+		stories
+	} : { kind: "unknown" };
+}
+function documentChangeFromHostEvent(event) {
+	if (event.type === "collaboration:remote-changed") return {
+		cause: "remote",
+		changeTag: null,
+		txId: null,
+		scope: { kind: "unknown" }
+	};
+	if (event.type !== "mutation:committed") return null;
+	if (event.origin === "history") {
+		const result = isPlainObject(event.result) ? event.result : null;
+		if (!result || result.noop === true) return null;
+		const history = isPlainObject(result.history) ? result.history : null;
+		return {
+			cause: event.direction === "redo" ? "redo" : "undo",
+			changeTag: null,
+			txId: readTxId(history?.txId),
+			scope: documentChangeScope(result.affectedStories)
+		};
+	}
+	if (!mutationCommittedEventChangedDocument(event)) return null;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : {};
+	return {
+		cause: event.cause === "user" ? "user" : "api",
+		changeTag: typeof receipt.changeTag === "string" ? receipt.changeTag : null,
+		txId: readTxId(receipt.txId),
+		scope: documentChangeScope(receipt.affectedStories)
+	};
+}
 function commandResultSucceeded(result) {
 	if (result === false) return false;
 	if (result && typeof result === "object" && result.success === false) return false;
@@ -10196,6 +10233,25 @@ function createSuperDocUI(options) {
 	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	let scheduleActiveSearchRefresh = () => {};
+	const documentChangeListeners = /* @__PURE__ */ new Set();
+	let documentChangeEpoch = 0;
+	let documentChangeSeq = 0;
+	const startDocumentChangeEpoch = () => {
+		documentChangeEpoch += 1;
+		documentChangeSeq = 0;
+	};
+	const publishDocumentChange = (event) => {
+		if (documentChangeListeners.size === 0) return;
+		const facts = documentChangeFromHostEvent(event);
+		if (!facts) return;
+		documentChangeSeq += 1;
+		const change = {
+			documentEpoch: `document-${documentChangeEpoch}`,
+			seq: documentChangeSeq,
+			...facts
+		};
+		for (const listener of Array.from(documentChangeListeners)) safeCall(() => listener(change), void 0);
+	};
 	const syncHostEventsSubscription = () => {
 		const host = getEditor()?.host;
 		const events = host?.events;
@@ -10214,6 +10270,8 @@ function createSuperDocUI(options) {
 		try {
 			const off = hostMethod(next, "subscribe")?.((event) => {
 				const type = event?.type;
+				if (type === "collaboration:document-replaced") startDocumentChangeEpoch();
+				publishDocumentChange(event);
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
 				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
@@ -13765,8 +13823,14 @@ function createSuperDocUI(options) {
 			} catch {
 				return;
 			}
+		},
+		onChange: (listener) => {
+			if (disposed) return () => {};
+			documentChangeListeners.add(listener);
+			return () => documentChangeListeners.delete(listener);
 		}
 	};
+	documentResetHooks.push(startDocumentChangeEpoch);
 	const resolveVisibleHost = () => {
 		if (typeof HTMLElement === "undefined") return null;
 		const mountContainer = (getEditor()?.mount)?.container;
@@ -15247,6 +15311,11 @@ function createSuperDocUI(options) {
 		const scopeUnsubs = [];
 		return {
 			decorations: createDecorationsHandle((handle) => scopeUnsubs.push(() => handle.dispose())),
+			document: { onChange: (listener) => {
+				const unsub = documentHandle.onChange(listener);
+				scopeUnsubs.push(unsub);
+				return unsub;
+			} },
 			select: (selector, equality) => {
 				const sub = select(selector, equality);
 				return {
@@ -15333,6 +15402,7 @@ function createSuperDocUI(options) {
 		painterCaptureEpoch += 1;
 		painterCommandDoc = null;
 		painterModeListeners.clear();
+		documentChangeListeners.clear();
 		searchRequestGeneration += 1;
 		customCommands.clear();
 	};

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.13",
+	superdocVersion: "2.28.0-next.15",
 	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.13",
+	superdocVersion: "2.28.0-next.15",
 	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/clipboard.d.ts

@@ -138,7 +138,11 @@ export interface SDPasteBlockSdt {
     lockMode?: 'unlocked' | 'sdtLocked' | 'contentLocked' | 'sdtContentLocked';
     multiline?: boolean;
 }
-export type SDPasteInline = SDPasteLeafInline | SDPasteSdtInline | {
+export type SDPasteInline = {
+    kind: 'math';
+    omml: string;
+    sourcePath?: readonly (string | number)[];
+} | SDPasteLeafInline | SDPasteSdtInline | {
     kind: 'hyperlink';
     target: {
         kind: 'external';

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

@@ -1525,6 +1525,7 @@ export type SectionPageBorderSide = {
 };
 export type SectionPageBorders = {
     offsetFrom: 'page';
+    display?: 'allPages' | 'firstPage';
     top?: SectionPageBorderSide;
     right?: SectionPageBorderSide;
     bottom?: SectionPageBorderSide;
@@ -2971,7 +2972,7 @@ export declare const extractHeaderFooterSpace: (margins?: PageMargins | null) =>
 };
 export type { ResolvedLayout, ResolvedPage, ResolvedPaintItem, ResolvedGroupItem, ResolvedFragmentItem, ResolvedParagraphContent, ResolvedTextLineItem, ResolvedDropCapItem, ResolvedListMarkerItem, ResolvedTableItem, ResolvedImageItem, ResolvedDrawingItem, ResolvedHeaderFooterPage, ResolvedHeaderFooterLayout, } from './resolved-layout.js';
 export { isResolvedTableItem, isResolvedImageItem, isResolvedDrawingItem } from './resolved-layout.js';
-export { PAGE_BREAK_DELETION_ANCHOR_ATTR, DELETED_PAGE_BREAK_LABEL, isPageBreakDeletionAnchorRun, expandRunsForInlineNewlines, isBodyNoteReferenceRun, isZeroWidthMarkerRun, hasZeroWidthMarkerSpan, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
+export { PAGE_BREAK_DELETION_ANCHOR_ATTR, DELETED_PAGE_BREAK_LABEL, isPageBreakDeletionAnchorRun, expandRunsForInlineNewlines, isBodyNoteReferenceRun, isZeroWidthMarkerRun, isGeneratedFieldResultRun, hasZeroWidthMarkerSpan, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
 export { INLINE_OBJECT_REPLACEMENT_CHARACTER, flattenParagraphVisibleText, mapVisibleRangeToRunSlices, type ParagraphVisibleRunSlice, } from './paragraph-visible-text.js';
 export { inlineBoxStyleSignature, isFiniteNonNegativeInteger, normalizeInlineBoxLogicalSides, type InlineBoxLogicalSides, type ResolvedInlineBoxLogicalSides, } from './inline-box.js';
 export { INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES, PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, isValidIncrementalDependencyOwnerVersion, isValidNonFlowingPageRelativeAnchorDependencyProof, isValidPageCheckpointDependencyCertificate, type IncrementalDependencyCertificateClass, type IncrementalDependencyOwnerVersion, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyCertificate, type PageCheckpointDependencyClass, } from './incremental-dependency.js';

package/dist/layout-engine/contracts/src/run-helpers.d.ts

@@ -12,6 +12,7 @@ export declare const NOTE_LABEL_MARKER_ATTR = "data-v2-note-label";
 export declare function isBodyNoteReferenceRun(run: Run): boolean;
 export declare function isZeroWidthMarkerRun(run: Run): boolean;
 export declare function hasZeroWidthMarkerSpan(run: Run): boolean;
+export declare function isGeneratedFieldResultRun(run: Run): boolean;
 /** Synthetic note-band or appended-endnote label keyed to its source note. */
 export declare function isNoteLabelRun(run: Run): boolean;
 /** Numbered marker text whose measurement identity can use digit capabilities. */

package/dist/layout-engine/layout-bridge/src/marker-run-key.d.ts

@@ -0,0 +1,2 @@
+import { WordLayoutMarker } from '../../contracts/src/index.js';
+export declare const markerRunMeasureKey: (run: WordLayoutMarker["run"] | undefined) => string;

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

@@ -99,6 +99,7 @@ export type PaginatorOptions = {
     }): Page;
     onNewPage?: (state: PageState | undefined, options?: {
         applyPendingSection: boolean;
+        replaceCurrentPage: boolean;
     }) => void;
     shouldStopBeforeNewPage?: (input: {
         completedPageIndex: number;

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

@@ -46,7 +46,7 @@ export interface TableInfo {
  * Word applies these flags when a table has no explicit w:tblLook element.
  */
 export declare const DEFAULT_TBL_LOOK: TableLookProperties;
-export declare function resolveRunProperties(params: OoxmlResolverParams, inlineRpr: RunProperties | null | undefined, resolvedPpr: ParagraphProperties | null | undefined, tableInfo?: TableInfo | null | undefined, isListNumber?: boolean, numberingDefinedInline?: boolean): RunProperties;
+export declare function resolveRunProperties(params: OoxmlResolverParams, inlineRpr: RunProperties | null | undefined, resolvedPpr: ParagraphProperties | null | undefined, tableInfo?: TableInfo | null | undefined, isListNumber?: boolean): RunProperties;
 export declare function resolveParagraphProperties(params: OoxmlResolverParams, inlineProps: ParagraphProperties | null | undefined, tableInfo: TableInfo | null | undefined): ParagraphProperties;
 export declare function resolveStyleChain<T extends PropertyObject>(propertyType: 'paragraphProperties' | 'runProperties' | 'tableProperties', params: OoxmlResolverParams, styleId: string | undefined, followBasedOnChain?: boolean): T;
 export declare function getNumberingProperties<T extends ParagraphProperties | RunProperties>(propertyType: 'paragraphProperties' | 'runProperties', params: OoxmlResolverParams, ilvl: number, numId: number, tries?: number): T;

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