superdoc 2.28.0-next.9 → 2.29.0-next.1

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/index.d.ts

@@ -109,7 +109,7 @@ export type { GetMarkdownAdapter, GetMarkdownInput } from './get-markdown/get-ma
 export type { GetHtmlAdapter, GetHtmlInput } from './get-html/get-html.js';
 export type { InfoAdapter, InfoInput } from './info/info.js';
 export type { ExtractAdapter, ExtractInput } from './extract/extract.js';
-export type { WriteAdapter, WriteRequest, RichContentMutationOptions, TrackedTextMutationOptions, TextMutationOptions, } from './write/write.js';
+export type { WriteAdapter, WriteRequest, RichContentMutationOptions, TrackedAttribution, TrackedTextMutationOptions, TextMutationOptions, } from './write/write.js';
 export type { OperationCancellation, OperationCancellationCode } from './write/operation-cancellation.js';
 export { OperationCancellationError, assertOperationCanStart, indeterminateOperation, splitOperationCancellation, } from './write/operation-cancellation.js';
 export type { FormatInlineAliasApi, FormatInlineAliasInput, FormatBoldInput, FormatItalicInput, FormatRangeInput, FormatUnderlineInput, FormatStrikethroughInput, StyleApplyInput, StyleApplyOptions, } from './format/format.js';

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

@@ -1,100 +1,100 @@
-import { MutationOptions } from '../write/write.js';
+import { TextMutationOptions } from '../write/write.js';
 import { ListInsertInput, ListsGetInput, ListsInsertResult, ListsListQuery, ListsListResult, ListsMutateItemResult, ListTargetInput, ListItemInfo, ListsCreateInput, ListsCreateResult, ListsAttachInput, ListsDetachInput, ListsDetachResult, ListsDeleteInput, ListsDeleteResult, ListsJoinInput, ListsJoinResult, ListsCanJoinInput, ListsCanJoinResult, ListsSeparateInput, ListsSeparateResult, ListsMergeInput, ListsMergeResult, ListsSplitInput, ListsSplitResult, ListsSetLevelInput, ListsSetValueInput, ListsContinuePreviousInput, ListsCanContinuePreviousInput, ListsCanContinuePreviousResult, ListsSetLevelRestartInput, ListsConvertToTextInput, ListsConvertToTextResult, ListsApplyTemplateInput, ListsApplyPresetInput, ListsCaptureTemplateInput, ListsCaptureTemplateResult, ListsSetLevelNumberingInput, ListsSetLevelBulletInput, ListsSetLevelPictureBulletInput, ListsSetLevelAlignmentInput, ListsSetLevelIndentsInput, ListsSetLevelTrailingCharacterInput, ListsSetLevelMarkerFontInput, ListsClearLevelOverridesInput, ListsSetTypeInput, ListsGetStyleInput, ListsGetStyleResult, ListsApplyStyleInput, ListsRestartAtInput, ListsSetLevelNumberStyleInput, ListsSetLevelTextInput, ListsSetLevelStartInput, ListsSetLevelLayoutInput, ListsGetStateInput, ListsGetStateResult, ListsApplyInput, ListsContinueV2Input, ListsRestartV2Input, ListsRemoveV2Input } from './lists.types.js';
 export type { ListInsertInput, ListsGetInput, ListsInsertResult, ListsListQuery, ListsListResult, ListsMutateItemResult, ListTargetInput, ListItemInfo, ListsCreateInput, ListsCreateResult, ListsAttachInput, ListsDetachInput, ListsDetachResult, ListsDeleteInput, ListsDeleteResult, ListsJoinInput, ListsJoinResult, ListsCanJoinInput, ListsCanJoinResult, ListsSeparateInput, ListsSeparateResult, ListsMergeInput, ListsMergeResult, ListsSplitInput, ListsSplitResult, ListsSetLevelInput, ListsSetValueInput, ListsContinuePreviousInput, ListsCanContinuePreviousInput, ListsCanContinuePreviousResult, ListsSetLevelRestartInput, ListsConvertToTextInput, ListsConvertToTextResult, ListsApplyTemplateInput, ListsApplyPresetInput, ListsCaptureTemplateInput, ListsCaptureTemplateResult, ListsSetLevelNumberingInput, ListsSetLevelBulletInput, ListsSetLevelPictureBulletInput, ListsSetLevelAlignmentInput, ListsSetLevelIndentsInput, ListsSetLevelTrailingCharacterInput, ListsSetLevelMarkerFontInput, ListsClearLevelOverridesInput, ListsSetTypeInput, ListsGetStyleInput, ListsGetStyleResult, ListsApplyStyleInput, ListsRestartAtInput, ListsSetLevelNumberStyleInput, ListsSetLevelTextInput, ListsSetLevelStartInput, ListsSetLevelLayoutInput, ListsBlockTarget, ListsGetStateInput, ListsGetStateResult, ListsApplyInput, ListsContinueV2Input, ListsRestartV2Input, ListsRemoveV2Input, } from './lists.types.js';
 export interface ListsAdapter {
     list(query?: ListsListQuery): ListsListResult;
     get(input: ListsGetInput): ListItemInfo;
-    insert(input: ListInsertInput, options?: MutationOptions): ListsInsertResult;
-    indent(input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-    outdent(input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-    create(input: ListsCreateInput, options?: MutationOptions): ListsCreateResult;
-    attach(input: ListsAttachInput, options?: MutationOptions): ListsMutateItemResult;
-    detach(input: ListsDetachInput, options?: MutationOptions): ListsDetachResult;
-    delete(input: ListsDeleteInput, options?: MutationOptions): ListsDeleteResult;
-    join(input: ListsJoinInput, options?: MutationOptions): ListsJoinResult;
+    insert(input: ListInsertInput, options?: TextMutationOptions): ListsInsertResult;
+    indent(input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+    outdent(input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+    create(input: ListsCreateInput, options?: TextMutationOptions): ListsCreateResult;
+    attach(input: ListsAttachInput, options?: TextMutationOptions): ListsMutateItemResult;
+    detach(input: ListsDetachInput, options?: TextMutationOptions): ListsDetachResult;
+    delete(input: ListsDeleteInput, options?: TextMutationOptions): ListsDeleteResult;
+    join(input: ListsJoinInput, options?: TextMutationOptions): ListsJoinResult;
     canJoin(input: ListsCanJoinInput): ListsCanJoinResult;
-    separate(input: ListsSeparateInput, options?: MutationOptions): ListsSeparateResult;
-    merge(input: ListsMergeInput, options?: MutationOptions): ListsMergeResult;
-    split(input: ListsSplitInput, options?: MutationOptions): ListsSplitResult;
-    setLevel(input: ListsSetLevelInput, options?: MutationOptions): ListsMutateItemResult;
-    setValue(input: ListsSetValueInput, options?: MutationOptions): ListsMutateItemResult;
-    continuePrevious(input: ListsContinuePreviousInput, options?: MutationOptions): ListsMutateItemResult;
+    separate(input: ListsSeparateInput, options?: TextMutationOptions): ListsSeparateResult;
+    merge(input: ListsMergeInput, options?: TextMutationOptions): ListsMergeResult;
+    split(input: ListsSplitInput, options?: TextMutationOptions): ListsSplitResult;
+    setLevel(input: ListsSetLevelInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setValue(input: ListsSetValueInput, options?: TextMutationOptions): ListsMutateItemResult;
+    continuePrevious(input: ListsContinuePreviousInput, options?: TextMutationOptions): ListsMutateItemResult;
     canContinuePrevious(input: ListsCanContinuePreviousInput): ListsCanContinuePreviousResult;
-    setLevelRestart(input: ListsSetLevelRestartInput, options?: MutationOptions): ListsMutateItemResult;
-    convertToText(input: ListsConvertToTextInput, options?: MutationOptions): ListsConvertToTextResult;
-    applyTemplate(input: ListsApplyTemplateInput, options?: MutationOptions): ListsMutateItemResult;
-    applyPreset(input: ListsApplyPresetInput, options?: MutationOptions): ListsMutateItemResult;
+    setLevelRestart(input: ListsSetLevelRestartInput, options?: TextMutationOptions): ListsMutateItemResult;
+    convertToText(input: ListsConvertToTextInput, options?: TextMutationOptions): ListsConvertToTextResult;
+    applyTemplate(input: ListsApplyTemplateInput, options?: TextMutationOptions): ListsMutateItemResult;
+    applyPreset(input: ListsApplyPresetInput, options?: TextMutationOptions): ListsMutateItemResult;
     captureTemplate(input: ListsCaptureTemplateInput): ListsCaptureTemplateResult;
-    setLevelNumbering(input: ListsSetLevelNumberingInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelBullet(input: ListsSetLevelBulletInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelPictureBullet(input: ListsSetLevelPictureBulletInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelAlignment(input: ListsSetLevelAlignmentInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelIndents(input: ListsSetLevelIndentsInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelTrailingCharacter(input: ListsSetLevelTrailingCharacterInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelMarkerFont(input: ListsSetLevelMarkerFontInput, options?: MutationOptions): ListsMutateItemResult;
-    clearLevelOverrides(input: ListsClearLevelOverridesInput, options?: MutationOptions): ListsMutateItemResult;
-    setType(input: ListsSetTypeInput, options?: MutationOptions): ListsMutateItemResult;
+    setLevelNumbering(input: ListsSetLevelNumberingInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelBullet(input: ListsSetLevelBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelPictureBullet(input: ListsSetLevelPictureBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelAlignment(input: ListsSetLevelAlignmentInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelIndents(input: ListsSetLevelIndentsInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelTrailingCharacter(input: ListsSetLevelTrailingCharacterInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelMarkerFont(input: ListsSetLevelMarkerFontInput, options?: TextMutationOptions): ListsMutateItemResult;
+    clearLevelOverrides(input: ListsClearLevelOverridesInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setType(input: ListsSetTypeInput, options?: TextMutationOptions): ListsMutateItemResult;
     getStyle(input: ListsGetStyleInput): ListsGetStyleResult;
-    applyStyle(input: ListsApplyStyleInput, options?: MutationOptions): ListsMutateItemResult;
-    restartAt(input: ListsRestartAtInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelNumberStyle(input: ListsSetLevelNumberStyleInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelText(input: ListsSetLevelTextInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelStart(input: ListsSetLevelStartInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelLayout(input: ListsSetLevelLayoutInput, options?: MutationOptions): ListsMutateItemResult;
+    applyStyle(input: ListsApplyStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+    restartAt(input: ListsRestartAtInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelNumberStyle(input: ListsSetLevelNumberStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelText(input: ListsSetLevelTextInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelStart(input: ListsSetLevelStartInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelLayout(input: ListsSetLevelLayoutInput, options?: TextMutationOptions): ListsMutateItemResult;
     getState?(input: ListsGetStateInput): ListsGetStateResult;
-    apply?(input: ListsApplyInput, options?: MutationOptions): ListsMutateItemResult;
-    continue?(input: ListsContinueV2Input, options?: MutationOptions): ListsMutateItemResult;
-    restart?(input: ListsRestartV2Input, options?: MutationOptions): ListsMutateItemResult;
-    remove?(input: ListsRemoveV2Input, options?: MutationOptions): ListsMutateItemResult;
+    apply?(input: ListsApplyInput, options?: TextMutationOptions): ListsMutateItemResult;
+    continue?(input: ListsContinueV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    restart?(input: ListsRestartV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    remove?(input: ListsRemoveV2Input, options?: TextMutationOptions): ListsMutateItemResult;
 }
 export interface ListsApi extends ListsAdapter {
     getState(input: ListsGetStateInput): ListsGetStateResult;
-    apply(input: ListsApplyInput, options?: MutationOptions): ListsMutateItemResult;
-    continue(input: ListsContinueV2Input, options?: MutationOptions): ListsMutateItemResult;
-    restart(input: ListsRestartV2Input, options?: MutationOptions): ListsMutateItemResult;
-    remove(input: ListsRemoveV2Input, options?: MutationOptions): ListsMutateItemResult;
+    apply(input: ListsApplyInput, options?: TextMutationOptions): ListsMutateItemResult;
+    continue(input: ListsContinueV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    restart(input: ListsRestartV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    remove(input: ListsRemoveV2Input, options?: TextMutationOptions): ListsMutateItemResult;
 }
 export declare function executeListsList(adapter: ListsAdapter, query?: ListsListQuery): ListsListResult;
 export declare function executeListsGet(adapter: ListsAdapter, input: ListsGetInput): ListItemInfo;
-export declare function executeListsInsert(adapter: ListsAdapter, input: ListInsertInput, options?: MutationOptions): ListsInsertResult;
-export declare function executeListsIndent(adapter: ListsAdapter, input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsOutdent(adapter: ListsAdapter, input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsCreate(adapter: ListsAdapter, input: ListsCreateInput, options?: MutationOptions): ListsCreateResult;
-export declare function executeListsAttach(adapter: ListsAdapter, input: ListsAttachInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsDetach(adapter: ListsAdapter, input: ListsDetachInput, options?: MutationOptions): ListsDetachResult;
-export declare function executeListsDelete(adapter: ListsAdapter, input: ListsDeleteInput, options?: MutationOptions): ListsDeleteResult;
-export declare function executeListsJoin(adapter: ListsAdapter, input: ListsJoinInput, options?: MutationOptions): ListsJoinResult;
+export declare function executeListsInsert(adapter: ListsAdapter, input: ListInsertInput, options?: TextMutationOptions): ListsInsertResult;
+export declare function executeListsIndent(adapter: ListsAdapter, input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsOutdent(adapter: ListsAdapter, input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsCreate(adapter: ListsAdapter, input: ListsCreateInput, options?: TextMutationOptions): ListsCreateResult;
+export declare function executeListsAttach(adapter: ListsAdapter, input: ListsAttachInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsDetach(adapter: ListsAdapter, input: ListsDetachInput, options?: TextMutationOptions): ListsDetachResult;
+export declare function executeListsDelete(adapter: ListsAdapter, input: ListsDeleteInput, options?: TextMutationOptions): ListsDeleteResult;
+export declare function executeListsJoin(adapter: ListsAdapter, input: ListsJoinInput, options?: TextMutationOptions): ListsJoinResult;
 export declare function executeListsCanJoin(adapter: ListsAdapter, input: ListsCanJoinInput): ListsCanJoinResult;
-export declare function executeListsSeparate(adapter: ListsAdapter, input: ListsSeparateInput, options?: MutationOptions): ListsSeparateResult;
-export declare function executeListsMerge(adapter: ListsAdapter, input: ListsMergeInput, options?: MutationOptions): ListsMergeResult;
-export declare function executeListsSplit(adapter: ListsAdapter, input: ListsSplitInput, options?: MutationOptions): ListsSplitResult;
-export declare function executeListsSetLevel(adapter: ListsAdapter, input: ListsSetLevelInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetValue(adapter: ListsAdapter, input: ListsSetValueInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsContinuePrevious(adapter: ListsAdapter, input: ListsContinuePreviousInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsSeparate(adapter: ListsAdapter, input: ListsSeparateInput, options?: TextMutationOptions): ListsSeparateResult;
+export declare function executeListsMerge(adapter: ListsAdapter, input: ListsMergeInput, options?: TextMutationOptions): ListsMergeResult;
+export declare function executeListsSplit(adapter: ListsAdapter, input: ListsSplitInput, options?: TextMutationOptions): ListsSplitResult;
+export declare function executeListsSetLevel(adapter: ListsAdapter, input: ListsSetLevelInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetValue(adapter: ListsAdapter, input: ListsSetValueInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsContinuePrevious(adapter: ListsAdapter, input: ListsContinuePreviousInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsCanContinuePrevious(adapter: ListsAdapter, input: ListsCanContinuePreviousInput): ListsCanContinuePreviousResult;
-export declare function executeListsSetLevelRestart(adapter: ListsAdapter, input: ListsSetLevelRestartInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsConvertToText(adapter: ListsAdapter, input: ListsConvertToTextInput, options?: MutationOptions): ListsConvertToTextResult;
-export declare function executeListsApplyTemplate(adapter: ListsAdapter, input: ListsApplyTemplateInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsApplyPreset(adapter: ListsAdapter, input: ListsApplyPresetInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelRestart(adapter: ListsAdapter, input: ListsSetLevelRestartInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsConvertToText(adapter: ListsAdapter, input: ListsConvertToTextInput, options?: TextMutationOptions): ListsConvertToTextResult;
+export declare function executeListsApplyTemplate(adapter: ListsAdapter, input: ListsApplyTemplateInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsApplyPreset(adapter: ListsAdapter, input: ListsApplyPresetInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsCaptureTemplate(adapter: ListsAdapter, input: ListsCaptureTemplateInput): ListsCaptureTemplateResult;
-export declare function executeListsSetLevelNumbering(adapter: ListsAdapter, input: ListsSetLevelNumberingInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelBullet(adapter: ListsAdapter, input: ListsSetLevelBulletInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelPictureBullet(adapter: ListsAdapter, input: ListsSetLevelPictureBulletInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelAlignment(adapter: ListsAdapter, input: ListsSetLevelAlignmentInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelIndents(adapter: ListsAdapter, input: ListsSetLevelIndentsInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelTrailingCharacter(adapter: ListsAdapter, input: ListsSetLevelTrailingCharacterInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelMarkerFont(adapter: ListsAdapter, input: ListsSetLevelMarkerFontInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsClearLevelOverrides(adapter: ListsAdapter, input: ListsClearLevelOverridesInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetType(adapter: ListsAdapter, input: ListsSetTypeInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelNumbering(adapter: ListsAdapter, input: ListsSetLevelNumberingInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelBullet(adapter: ListsAdapter, input: ListsSetLevelBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelPictureBullet(adapter: ListsAdapter, input: ListsSetLevelPictureBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelAlignment(adapter: ListsAdapter, input: ListsSetLevelAlignmentInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelIndents(adapter: ListsAdapter, input: ListsSetLevelIndentsInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelTrailingCharacter(adapter: ListsAdapter, input: ListsSetLevelTrailingCharacterInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelMarkerFont(adapter: ListsAdapter, input: ListsSetLevelMarkerFontInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsClearLevelOverrides(adapter: ListsAdapter, input: ListsClearLevelOverridesInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetType(adapter: ListsAdapter, input: ListsSetTypeInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsGetStyle(adapter: ListsAdapter, input: ListsGetStyleInput): ListsGetStyleResult;
-export declare function executeListsApplyStyle(adapter: ListsAdapter, input: ListsApplyStyleInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsRestartAt(adapter: ListsAdapter, input: ListsRestartAtInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelNumberStyle(adapter: ListsAdapter, input: ListsSetLevelNumberStyleInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelText(adapter: ListsAdapter, input: ListsSetLevelTextInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelStart(adapter: ListsAdapter, input: ListsSetLevelStartInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelLayout(adapter: ListsAdapter, input: ListsSetLevelLayoutInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsApplyStyle(adapter: ListsAdapter, input: ListsApplyStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsRestartAt(adapter: ListsAdapter, input: ListsRestartAtInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelNumberStyle(adapter: ListsAdapter, input: ListsSetLevelNumberStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelText(adapter: ListsAdapter, input: ListsSetLevelTextInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelStart(adapter: ListsAdapter, input: ListsSetLevelStartInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelLayout(adapter: ListsAdapter, input: ListsSetLevelLayoutInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsGetState(adapter: ListsAdapter, input: ListsGetStateInput): ListsGetStateResult;
-export declare function executeListsApply(adapter: ListsAdapter, input: ListsApplyInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsContinueV2(adapter: ListsAdapter, input: ListsContinueV2Input, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsRestartV2(adapter: ListsAdapter, input: ListsRestartV2Input, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsRemoveV2(adapter: ListsAdapter, input: ListsRemoveV2Input, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsApply(adapter: ListsAdapter, input: ListsApplyInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsContinueV2(adapter: ListsAdapter, input: ListsContinueV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsRestartV2(adapter: ListsAdapter, input: ListsRestartV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsRemoveV2(adapter: ListsAdapter, input: ListsRemoveV2Input, options?: TextMutationOptions): ListsMutateItemResult;

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/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/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;
 }
@@ -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/document-api/src/write/write.d.ts

@@ -42,23 +42,24 @@ export interface MutationOptions extends RevisionGuardOptions {
      */
     dryRun?: boolean;
 }
-export interface RichContentMutationOptions extends MutationOptions {
-    author?: never;
-    date?: never;
-    /** Guard returned by `doc.capabilities.check` for an exact rich write. */
-    supportCheck?: SDHtmlMarkdownCheckGuard;
-}
-/** Display-only attribution for one tracked plain-text or inline-format mutation. */
-export interface TrackedTextMutationOptions extends MutationOptions {
-    changeMode: 'tracked';
+/** Display-only attribution for one tracked mutation. */
+export interface TrackedAttribution {
     author?: {
         name: string;
     };
     /** ISO 8601 UTC revision timestamp. Omitted values use the transaction time. */
     date?: string;
 }
+export interface RichContentMutationOptions extends MutationOptions, TrackedAttribution {
+    /** Guard returned by `doc.capabilities.check` for an exact rich write. */
+    supportCheck?: SDHtmlMarkdownCheckGuard;
+}
+export interface TrackedTextMutationOptions extends MutationOptions, TrackedAttribution {
+    changeMode: 'tracked';
+}
 export type TextMutationOptions = MutationOptions | TrackedTextMutationOptions;
 export declare function normalizeTextMutationOptions(options?: RichContentMutationOptions | TextMutationOptions): RichContentMutationOptions | TrackedTextMutationOptions;
+export declare function normalizeRichMutationOptions(options: (MutationOptions & TrackedAttribution & Partial<RichContentMutationOptions>) | undefined, supportCheckOperation?: 'insert' | 'replace'): RichContentMutationOptions;
 /**
  * Text insertion request: target-less insert at document end.
  *

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. */
@@ -1525,6 +1526,7 @@ export type SectionPageBorderSide = {
 };
 export type SectionPageBorders = {
     offsetFrom: 'page';
+    display?: 'allPages' | 'firstPage';
     top?: SectionPageBorderSide;
     right?: SectionPageBorderSide;
     bottom?: SectionPageBorderSide;
@@ -1894,6 +1896,7 @@ export type WordLayoutMarker = {
      */
     trackedChange?: MarkerTrackedChange;
 };
+export declare const markerRunSignature: (run: WordLayoutMarker["run"] | undefined) => string;
 /**
  * Word layout configuration for list items created via input rules.
  *
@@ -2404,6 +2407,7 @@ export type ImageMeasure = {
 };
 export type DrawingMeasure = {
     kind: 'drawing';
+    inlineDrawing?: boolean;
     drawingKind: DrawingKind;
     width: number;
     height: number;
@@ -2971,7 +2975,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/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/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/painters/dom/src/page-content.d.ts

@@ -5,7 +5,7 @@ import { BetweenBorderInfo } from './paragraph/borders/index.js';
 import { PageStyles } from './styles.js';
 import { TableFragmentPatchResult } from './table/renderTableFragment.js';
 import { DerivedRunTextPlane } from './derived-run-text-plane.js';
-export declare function refreshPageBreakReviewPlacements(state: PageDomState, page: ResolvedPage, recordChangedRoot?: (root: HTMLElement) => void): void;
+export declare function refreshPageBreakReviewPlacements(state: PageDomState, page: ResolvedPage, recordChangedRoot?: (root: HTMLElement) => void, beforePlacementChange?: () => void): void;
 export type FragmentDomState = {
     key: string;
     signature: string;

package/dist/layout-engine/painters/dom/src/persistent-page-surface.d.ts

@@ -72,6 +72,8 @@ export type DomPainterPersistentPageInput = {
     documentBackground?: DocumentBackground | null;
     derivedRunTextPlane?: DerivedRunTextPlane | null;
     captureSnapshot?: boolean;
+    beforePageContentChange?: (pageIndex: number) => void;
+    onPageContentRetained?: (pageIndex: number) => void;
 };
 /** Shell registry entry: the persistent page root and its geometry/style reuse key. */
 export type PersistentShellEntry = {

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-B4c55pFy.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-0OA8hCNb.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-C4Ka5Ph3.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Duf65d0b.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-B4c55pFy.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-0OA8hCNb.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-C4Ka5Ph3.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Duf65d0b.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-B4c55pFy.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-0OA8hCNb.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-C4Ka5Ph3.es.js";
+import { m as shallowEqual, s as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-Duf65d0b.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;