superdoc 2.28.0 → 2.29.0-next.2

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

@@ -2976,7 +2976,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, 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 { runVisibleLength, splitsSurrogatePair, 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';
 export * as Engines from './engines/index.js';

package/dist/layout-engine/contracts/src/paragraph-visible-text.d.ts

@@ -1,10 +1,12 @@
-import { ParagraphBlock } from './index.js';
+import { ParagraphBlock, Run } from './index.js';
 export declare const INLINE_OBJECT_REPLACEMENT_CHARACTER = "\uFFFC";
 export type ParagraphVisibleRunSlice = {
     runIndex: number;
     fromChar: number;
     toChar: number;
 };
+export declare const runVisibleLength: (run: Run) => number;
+export declare const splitsSurrogatePair: (text: string, offset: number) => boolean;
 /**
  * Flattens a paragraph into Document API visible-text coordinates.
  *

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