superdoc 2.28.0-next.16 → 2.28.0-next.18

package/dist/chunks/{create-super-doc-ui-DfSPIhxs.cjs → create-super-doc-ui-DOnTWcx7.cjs}

@@ -2651,6 +2651,16 @@ function isPlainObject(value) {
 }
 //#endregion
 //#region src/helpers/v2-review-mutation-impact.ts
+function mutationCommittedEventChangedVisibleContent(event) {
+	if (event.dryRun === true) return false;
+	if (isPlainObject(event.result) && event.result.noop === true) return false;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : null;
+	if (receipt?.changed === false || receipt?.noop === true || receipt?.status === "NO_OP") return false;
+	return true;
+}
+function mutationCommittedEventChangedDocument(event) {
+	return event.cause !== "preview" && mutationCommittedEventChangedVisibleContent(event);
+}
 /**
 * Classify the tracked-change identities carried by a v2 mutation event.
 *
@@ -5763,18 +5773,6 @@ function commandResultFromOperationResult(result) {
 function isSuccessfulReceipt(result) {
 	return Boolean(result) && typeof result === "object" && result.success === true;
 }
-/**
-* The host also emits `mutation:committed` for previews and no-op receipts;
-* those events must not mark the document as having unsaved edits.
-*/
-function mutationCommittedEventChangedDocument(event) {
-	if (event.dryRun === true) return false;
-	const receipt = event.receipt;
-	if (receipt && typeof receipt === "object" && receipt.changed === false) return false;
-	if (receipt && typeof receipt === "object" && receipt.noop === true) return false;
-	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;
 }
@@ -6719,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);
 	};
@@ -10288,14 +10296,17 @@ function createSuperDocUI(options) {
 				const type = event?.type;
 				if (host) publishDocumentChange(host, event);
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
-				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
+				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed") {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
 				}
-				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(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)) {
+				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
+				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);
@@ -10327,6 +10338,7 @@ function createSuperDocUI(options) {
 					if (impact?.allResolved) {
 						replaceTrackedChangeItemsInCache([]);
 						publishAllTrackedChangesResolved(event.receipt);
+						if (event.cause === "preview") invalidateDocumentContent();
 						return;
 					}
 					if (impact?.removedIds.size) markPostDecisionTrackChanges(new Set(impact.removedIds), event.receipt);
@@ -10336,7 +10348,10 @@ function createSuperDocUI(options) {
 						scheduleTypingDocumentContentInvalidation();
 						return;
 					}
-					if (impact?.removedIds.size && impact.upsertIds.size === 0) return;
+					if (impact?.removedIds.size && impact.upsertIds.size === 0) {
+						if (event.cause === "preview") invalidateDocumentContent();
+						return;
+					}
 					if (isStandaloneDocumentMutation || type === "collaboration:remote-changed" || type === "mutation:committed" && !isTypingBurst) schedulePostPaintContentRefresh();
 					const remoteCommentsPartChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedPartUris) && event.changedPartUris.some((partUri) => typeof partUri === "string" && COMMENTS_CATALOG_PART_URIS.has(partUri));
 					const loadedCommentAnchorsMayHaveChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0 && commentsCatalogMayHaveRows();
@@ -13843,6 +13858,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 = () => {
@@ -15745,6 +15777,12 @@ Object.defineProperty(exports, "isWorkflowRecordingEnabled", {
 		return isWorkflowRecordingEnabled;
 	}
 });
+Object.defineProperty(exports, "mutationCommittedEventChangedDocument", {
+	enumerable: true,
+	get: function() {
+		return mutationCommittedEventChangedDocument;
+	}
+});
 Object.defineProperty(exports, "readFirstPartyPageNumbers", {
 	enumerable: true,
 	get: function() {

package/dist/chunks/{create-super-doc-ui-J7aMU_wd.es.js → create-super-doc-ui-gI3fiM_P.es.js}

@@ -2650,6 +2650,16 @@ function isPlainObject(value) {
 }
 //#endregion
 //#region src/helpers/v2-review-mutation-impact.ts
+function mutationCommittedEventChangedVisibleContent(event) {
+	if (event.dryRun === true) return false;
+	if (isPlainObject(event.result) && event.result.noop === true) return false;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : null;
+	if (receipt?.changed === false || receipt?.noop === true || receipt?.status === "NO_OP") return false;
+	return true;
+}
+function mutationCommittedEventChangedDocument(event) {
+	return event.cause !== "preview" && mutationCommittedEventChangedVisibleContent(event);
+}
 /**
 * Classify the tracked-change identities carried by a v2 mutation event.
 *
@@ -5762,18 +5772,6 @@ function commandResultFromOperationResult(result) {
 function isSuccessfulReceipt(result) {
 	return Boolean(result) && typeof result === "object" && result.success === true;
 }
-/**
-* The host also emits `mutation:committed` for previews and no-op receipts;
-* those events must not mark the document as having unsaved edits.
-*/
-function mutationCommittedEventChangedDocument(event) {
-	if (event.dryRun === true) return false;
-	const receipt = event.receipt;
-	if (receipt && typeof receipt === "object" && receipt.changed === false) return false;
-	if (receipt && typeof receipt === "object" && receipt.noop === true) return false;
-	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;
 }
@@ -6718,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);
 	};
@@ -10287,14 +10295,17 @@ function createSuperDocUI(options) {
 				const type = event?.type;
 				if (host) publishDocumentChange(host, event);
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
-				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
+				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed") {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
 				}
-				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(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)) {
+				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
+				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);
@@ -10326,6 +10337,7 @@ function createSuperDocUI(options) {
 					if (impact?.allResolved) {
 						replaceTrackedChangeItemsInCache([]);
 						publishAllTrackedChangesResolved(event.receipt);
+						if (event.cause === "preview") invalidateDocumentContent();
 						return;
 					}
 					if (impact?.removedIds.size) markPostDecisionTrackChanges(new Set(impact.removedIds), event.receipt);
@@ -10335,7 +10347,10 @@ function createSuperDocUI(options) {
 						scheduleTypingDocumentContentInvalidation();
 						return;
 					}
-					if (impact?.removedIds.size && impact.upsertIds.size === 0) return;
+					if (impact?.removedIds.size && impact.upsertIds.size === 0) {
+						if (event.cause === "preview") invalidateDocumentContent();
+						return;
+					}
 					if (isStandaloneDocumentMutation || type === "collaboration:remote-changed" || type === "mutation:committed" && !isTypingBurst) schedulePostPaintContentRefresh();
 					const remoteCommentsPartChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedPartUris) && event.changedPartUris.some((partUri) => typeof partUri === "string" && COMMENTS_CATALOG_PART_URIS.has(partUri));
 					const loadedCommentAnchorsMayHaveChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0 && commentsCatalogMayHaveRows();
@@ -13842,6 +13857,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 = () => {
@@ -15654,4 +15686,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { createInteractionHistory as _, registerFirstPartyCommandMutation as a, recordInteraction as b, applyV2CommentInvalidationFromMutation as c, createImageFilePicker as d, resolveImageSrc as f, closeInteractionHistory as g, DOM_CLASS_NAMES as h, readFirstPartyPageNumbers as i, getV2TrackedChangeMutationImpact as l, isSyntheticTrackedChangeCommentLaneItem as m, executeFirstPartyCommandAsync as n, isRecord as o, shallowEqual as p, executeFirstPartyShortcutAsync as r, BUILT_IN_COMMAND_IDS as s, createSuperDocUI as t, isPlainObject as u, getWorkflowRecording as v, isWorkflowRecordingEnabled as y };
+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 };

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.16",
+	superdocVersion: "2.28.0-next.18",
 	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.16",
+	superdocVersion: "2.28.0-next.18",
 	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";
@@ -3726,7 +3726,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly find: {
         readonly memberPath: "find";
         readonly description: "Search the document for text or node matches using SDM/1 selectors. Returns discovery-grade results: for mutation targeting, use query.match instead.";
-        readonly expectedResult: "Returns an SDFindResult envelope ({ total, limit, offset, items }). Each item is an SDNodeResult ({ node, address }). Text hits contain only the matched text; use getNode or getNodeById for the full containing node. Node selectors return full node projections.";
+        readonly expectedResult: "Returns an SDFindResult envelope ({ total, limit, offset, items }). Each item is an SDNodeResult ({ node, address }). Text hits contain only the matched text; use getNode or getNodeById for the full containing node. Node selectors return full node projections. Bookmark selectors return the bookmarks of the searched story in document order: each address is an inline bookmark address whose anchor spans the bookmark range, and each node is an ext.bookmark node whose bookmark.address resolves through bookmarks.get.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "find.mdx";

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

@@ -15,7 +15,7 @@ export type ReceiptFailureCode = 'NO_OP' | 'INVALID_TARGET' | 'TARGET_NOT_FOUND'
 export type TextRangeRejectionReason = 'text-range-in-sdt' | 'text-range-in-field' | 'text-range-in-unsupported-tracked-wrapper';
 /** Content-control creation keeps its existing top-level failure code. */
 export type ContentControlCreationRejectionReason = 'content-control-unsupported-inline-structure' | 'content-control-shared-run-boundary';
-export type DocumentApiRejectionReason = TextRangeRejectionReason | ContentControlCreationRejectionReason;
+export type DocumentApiRejectionReason = TextRangeRejectionReason | ContentControlCreationRejectionReason | 'paragraph-mark-already-deleted';
 export interface DocumentApiRejectionDetails extends Record<string, unknown> {
     reason: DocumentApiRejectionReason;
 }

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-DfSPIhxs.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DOnTWcx7.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-J7aMU_wd.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-gI3fiM_P.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-DfSPIhxs.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DOnTWcx7.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-J7aMU_wd.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-gI3fiM_P.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-DfSPIhxs.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DOnTWcx7.cjs");
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {
@@ -9,7 +9,8 @@ function getDocumentApiRejectionReason(details) {
 		case "text-range-in-field":
 		case "text-range-in-unsupported-tracked-wrapper":
 		case "content-control-unsupported-inline-structure":
-		case "content-control-shared-run-boundary": return details.reason;
+		case "content-control-shared-run-boundary":
+		case "paragraph-mark-already-deleted": return details.reason;
 		default: return;
 	}
 }

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-J7aMU_wd.es.js";
+import { m as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-gI3fiM_P.es.js";
 //#region ../document-api/src/types/receipt.ts
 /** Read a known failure.details.reason without assuming every failure has one. */
 function getDocumentApiRejectionReason(details) {
@@ -8,7 +8,8 @@ function getDocumentApiRejectionReason(details) {
 		case "text-range-in-field":
 		case "text-range-in-unsupported-tracked-wrapper":
 		case "content-control-unsupported-inline-structure":
-		case "content-control-shared-run-boundary": return details.reason;
+		case "content-control-shared-run-boundary":
+		case "paragraph-mark-already-deleted": return details.reason;
 		default: return;
 	}
 }

package/dist/shared/font-system/src/resolver.d.ts

@@ -146,7 +146,7 @@ export declare class FontResolver {
     /**
      * Resolve a CSS font-family value for MEASURE and PAINT: swap the primary family to its
      * physical substitute and keep the original fallbacks. "Calibri, sans-serif" ->
-     * "Carlito, sans-serif"; "Calibri" -> "Carlito". An unmapped value is returned unchanged.
+     * "Carlito, sans-serif"; "Calibri" -> "Carlito". Quotes primary names when required by CSS syntax.
      */
     resolvePhysicalFamily(cssFontFamily: string): string;
     /**
@@ -160,8 +160,8 @@ export declare class FontResolver {
     /**
      * Face-aware CSS-stack variant for MEASURE and PAINT - the face-scoped counterpart of
      * {@link resolvePhysicalFamily}. Swaps the primary family to its substitute when this exact face is
-     * real or docfonts authorizes a synthetic source face. Otherwise returns the value unchanged
-     * (logical family + its fallbacks), so a missing face is never faux-styled by accident. Measure and
+     * real or docfonts authorizes a synthetic source face. Otherwise keeps the logical family and its
+     * fallbacks, quoting primary names when required by CSS syntax. Measure and
      * paint MUST call this with the same face key, or text is measured in one face and painted in another.
      */
     resolvePhysicalFamilyForFace(cssFontFamily: string, face: FaceKey, hasFace: HasFace): string;