superdoc 2.22.1-next.1 → 2.23.0-next.1

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.22.1-next.1",
+	superdocVersion: "2.23.0-next.1",
 	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.22.1-next.1",
+	superdocVersion: "2.23.0-next.1",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -31,6 +31,7 @@ import { BlocksAdapter, BlocksApi } from './blocks/blocks.js';
 import { TableLocator, TableMutationResult, TablesConvertFromTextInput, TablesMoveInput, TablesSplitInput, TablesConvertToTextInput, TablesSetLayoutInput, TablesInsertRowInput, TablesDeleteRowInput, TablesMoveRowInput, TablesSetRowHeightInput, TablesDistributeRowsInput, TablesSetRowOptionsInput, TablesInsertColumnInput, TablesDeleteColumnInput, TablesMoveColumnInput, TablesSetColumnWidthInput, TablesDistributeColumnsInput, TablesInsertCellInput, TablesDeleteCellInput, TablesMergeCellsInput, TablesUnmergeCellsInput, TablesSplitCellInput, TablesSetCellPropertiesInput, TablesSetCellTextInput, TablesSortInput, TablesSetAltTextInput, TablesSetStyleInput, TablesClearStyleInput, TablesSetStyleOptionInput, TablesSetBorderInput, TablesClearBorderInput, TablesApplyBorderPresetInput, TablesSetShadingInput, TablesClearShadingInput, TablesSetTablePaddingInput, TablesSetCellPaddingInput, TablesSetCellSpacingInput, TablesClearCellSpacingInput, TablesApplyStyleInput, TablesSetBordersInput, TablesSetTableOptionsInput, TablesApplyPresetInput, TablesGetInput, TablesGetOutput, TablesGetCellsInput, TablesGetCellsOutput, TablesGetPropertiesInput, TablesGetPropertiesOutput, TablesGetStylesInput, TablesGetStylesOutput, TablesSetDefaultStyleInput, TablesClearDefaultStyleInput } from './types/table-operations.types.js';
 import { TrackChangesAdapter, TrackChangesApi } from './track-changes/track-changes.js';
 import { MutationOptions, RichContentMutationOptions, WriteAdapter } from './write/write.js';
+import { OperationCancellation } from './write/operation-cancellation.js';
 import { SelectionMutationAdapter } from './selection-mutation.js';
 import { CapabilitiesAdapter, DocumentApiCapabilities, OperationCapabilityResolveInput, OperationCapabilityResolveResult } from './capabilities/capabilities.js';
 import { SDHtmlMarkdownSupportCheckInput, SDHtmlMarkdownSupportCheckResult } from './capabilities/html-markdown-support.js';
@@ -105,6 +106,8 @@ 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 } 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';
 export type { InlineRunPatch, InlineRunPatchKey, InlinePropertyStorage, InlinePropertyType, InlinePropertyCarrier, InlinePropertyRegistryEntry, UnderlinePatch, ShadingPatch, BorderPatch, FitTextPatch, LangPatch, RFontsPatch, EastAsianLayoutPatch, StylisticSetPatch, } from './format/inline-run-patch.js';
 export { INLINE_PROPERTY_REGISTRY, INLINE_PROPERTY_KEY_SET, INLINE_PROPERTY_BY_KEY, INLINE_PROPERTY_KEYS_BY_STORAGE, validateInlineRunPatch, buildInlineRunPatchSchema, } from './format/inline-run-patch.js';
@@ -251,7 +254,11 @@ export interface QueryApi {
 }
 export interface MutationsApi {
     preview(input: MutationsPreviewInput): Promise<MutationsPreviewOutput>;
-    apply(input: MutationsApplyInput): Promise<PlanReceipt>;
+    /**
+     * Apply an atomic plan. `options` is host-side cancellation and is not part
+     * of the plan payload.
+     */
+    apply(input: MutationsApplyInput, options?: OperationCancellation): Promise<PlanReceipt>;
 }
 export interface RangesApi {
     resolve(input: ResolveRangeInput): ResolveRangeOutput;
@@ -323,8 +330,9 @@ export interface DocumentApiSurface {
     /**
      * Extract all document content with stable IDs for RAG pipelines.
      * Returns blocks with full text, comments, and tracked changes.
+     * `options` cancels or deadlines the browser call. It is not an extract filter.
      */
-    extract(input: ExtractInput): ExtractResult;
+    extract(input: ExtractInput, options?: OperationCancellation): ExtractResult;
     /**
      * Clear all document body content, leaving a single empty paragraph.
      */
@@ -337,7 +345,7 @@ export interface DocumentApiSurface {
      * Insert content at a target location.
      * If target is omitted, inserts at the end of the document.
      */
-    insert(input: InsertInput, options?: RichContentMutationOptions): SDMutationReceipt;
+    insert(input: InsertInput, options?: RichContentMutationOptions & OperationCancellation): SDMutationReceipt;
     /**
      * Replace text at a target range.
      */

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

@@ -4,6 +4,7 @@ import { SDInsertInput } from '../types/structural-input.js';
 import { StoryLocator } from '../types/story.types.js';
 import { BlockNodeAddress } from '../types/base.js';
 import { Placement } from '../types/placement.js';
+import { OperationCancellation } from '../write/operation-cancellation.js';
 import { SelectionMutationAdapter } from '../selection-mutation.js';
 /** Content format for the text insert operation payload. */
 export type InsertContentType = 'text' | 'markdown' | 'html';
@@ -70,5 +71,5 @@ export declare function validateInsertInput(input: unknown): asserts input is In
  * @param options - Optional mutation options (changeMode, dryRun, expectedRevision).
  * @returns Receipt indicating success/failure and mutation metadata.
  */
-export declare function executeInsert(selectionAdapter: SelectionMutationAdapter, writeAdapter: WriteAdapter, input: InsertInput, options?: RichContentMutationOptions): SDMutationReceipt;
+export declare function executeInsert(selectionAdapter: SelectionMutationAdapter, writeAdapter: WriteAdapter, input: InsertInput, options?: RichContentMutationOptions & OperationCancellation): SDMutationReceipt;
 export {};

package/dist/document-api/src/write/operation-cancellation.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Host-side cancellation for browser `insert`, `mutations.apply`, and `extract`.
+ *
+ * `signal` and `timeoutMs` stay on the caller side. They are not serialized
+ * into the worker. An already-aborted signal or a `timeoutMs` of 0 finishes
+ * as {@link OperationCancellationError} `CANCELLED` before dispatch and does
+ * not change the document. Aborting after the worker has started the command
+ * does not roll it back: the call rejects as `INDETERMINATE` so the caller
+ * stops waiting, and must read the document before deciding whether to retry.
+ * Replacing the document or closing the editor also settles as `INDETERMINATE`.
+ */
+export interface OperationCancellation {
+    /** Abort before dispatch, or ask the host to cancel a command that has not started. */
+    signal?: AbortSignal;
+    /**
+     * Milliseconds from the call. `0` is already expired and does not dispatch.
+     * A positive deadline uses the same outcome rules as `signal`.
+     */
+    timeoutMs?: number;
+}
+export type OperationCancellationCode = 'CANCELLED' | 'INDETERMINATE';
+/**
+ * Machine-readable outcome for a cancellation that did not return the
+ * operation's normal receipt.
+ *
+ * `CANCELLED` means the command did not start and the document is unchanged.
+ * Retrying that same call is safe. `INDETERMINATE` means the call cannot
+ * prove whether a mutation committed. Read the current document before
+ * retrying. A resolved receipt means the work committed; do not retry it.
+ */
+export declare class OperationCancellationError extends Error {
+    readonly code: OperationCancellationCode;
+    readonly details?: {
+        cause?: string;
+    };
+    constructor(code: OperationCancellationCode, message: string, details?: {
+        cause?: string;
+    });
+}
+export declare function cancelledBeforeDispatch(): OperationCancellationError;
+export declare function indeterminateOperation(cause: 'replaced' | 'disposed' | 'in-flight'): OperationCancellationError;
+/**
+ * Reject a call that is already cancelled or whose deadline has already
+ * expired. Returns without effect when the caller did not ask for control.
+ */
+export declare function assertOperationCanStart(options?: OperationCancellation): void;
+/**
+ * Separate host-only cancellation fields from a value that will be
+ * structured-cloned into the worker. `AbortSignal` cannot cross that boundary.
+ */
+export declare function splitOperationCancellation(value: unknown): {
+    cancellation?: OperationCancellation;
+    rest: unknown;
+};

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

@@ -142,6 +142,8 @@ export type DocPartMetadata = {
  */
 export type SdtMetadata = FieldAnnotationMetadata | StructuredContentMetadata | DocumentSectionMetadata | DocPartMetadata;
 export declare const CONTRACTS_VERSION = "1.2.0";
+/** Match the cell painter's alignment footprint, including out-of-flow drawings. */
+export declare function tableCellAlignmentOffset(verticalAlign: string | undefined, contentHeight: number, flowHeight: number, measuredContentHeight: number): number;
 /** Unique identifier for a block in the document. Format: `${pos}-${type}`. */
 export type BlockId = string;
 /**

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

@@ -568,6 +568,8 @@ declare function incrementalLayoutComplete(previousBlocks: FlowBlock[], _previou
     fontCapabilities?: FontMeasureCapabilities;
 }, warmStart?: {
     footnoteReserveSeed?: FootnoteReserveSeed | null;
+    /** Per-open-document diagnostic lifetime, including cold relayouts. */
+    footnoteWarningOwner?: object;
     /** Host proved the authoritative note projection bundle was retained exactly. */
     noteMeasurePlaneRetainedExact?: true;
     /** Host proved this seed is an exact, geometry-equivalent subset of the current note plane. */

package/dist/superdoc.cjs

@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.22.1-next.1";
+		return "2.23.0-next.1";
 	} catch {
 		return "unknown";
 	}
@@ -46387,7 +46387,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.22.1-next.1";
+		this.version = "2.23.0-next.1";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -314,7 +314,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.22.1-next.1";
+		return "2.23.0-next.1";
 	} catch {
 		return "unknown";
 	}
@@ -46316,7 +46316,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.22.1-next.1";
+		this.version = "2.23.0-next.1";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];