superdoc 2.16.1-next.2 → 2.16.1-next.3

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.16.1-next.2",
+	superdocVersion: "2.16.1-next.3",
 	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.16.1-next.2",
+	superdocVersion: "2.16.1-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/clear-content/clear-content.d.ts

@@ -1,5 +1,5 @@
 import { Receipt } from '../types/receipt.js';
-import { RevisionGuardOptions } from '../write/write.js';
+import { MutationOptions } from '../write/write.js';
 export type ClearContentInput = Record<string, never>;
 /**
  * Engine-specific adapter that clears all document body content.
@@ -8,18 +8,14 @@ export interface ClearContentAdapter {
     /**
      * Clear the document body, replacing all content with a single empty paragraph.
      */
-    clearContent(input: ClearContentInput, options?: RevisionGuardOptions): Receipt;
+    clearContent(input: ClearContentInput, options?: MutationOptions): Receipt;
 }
 /**
  * Execute a clearContent operation through the provided adapter.
  *
- * clearContent is a destructive reset: tracked mode and dry run are not
- * meaningful, so this accepts {@link RevisionGuardOptions} rather than
- * `MutationOptions`.
- *
  * @param adapter - Engine-specific clear-content adapter.
  * @param input - Canonical clear-content input (empty object).
- * @param options - Optional revision guard options.
+ * @param options - Optional change mode, preview and revision guard options.
  * @returns A Receipt indicating success or NO_OP if already empty.
  */
-export declare function executeClearContent(adapter: ClearContentAdapter, input: ClearContentInput, options?: RevisionGuardOptions): Receipt;
+export declare function executeClearContent(adapter: ClearContentAdapter, input: ClearContentInput, options?: MutationOptions): Receipt;

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -1689,7 +1689,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly 'create.image': {
         readonly memberPath: "create.image";
         readonly description: "Insert a new image at the target position.";
-        readonly expectedResult: "Returns a CreateImageResult with the new image address. Tracked-mode results include `trackedChangeRefs` pointing at the tracked insertion review entity.";
+        readonly expectedResult: "Returns a CreateImageResult with the new image address. Tracked-mode results include `trackedChangeRefs` pointing at the tracked insertion review entity. When the target is an inherited or missing header/footer slot, Word-compatible ownership materialization applies immediately; review controls the inserted image.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "create/image.mdx";

package/dist/document-api/src/contract/operation-registry.d.ts

@@ -138,7 +138,7 @@ export interface OperationRegistry extends FormatInlineAliasOperationRegistry {
     };
     clearContent: {
         input: ClearContentInput;
-        options: RevisionGuardOptions;
+        options: MutationOptions;
         output: Receipt;
     };
     insert: {

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

@@ -111,4 +111,6 @@ export type DiffChangeMode = 'direct' | 'tracked';
 /** Options for `diff.apply`. Omitted `changeMode` applies story content directly. */
 export interface DiffApplyOptions {
     changeMode?: DiffChangeMode;
+    /** Requires the current document revision; a mismatch fails before any diff operation applies. */
+    expectedRevision?: string;
 }

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

@@ -34,7 +34,7 @@ export interface HyperlinkSpec {
     tooltip?: string;
     /** Link target frame (_blank, _self, etc.). */
     target?: string;
-    /** Relationship attribute string. */
+    /** Browser relationship tokens kept for the current editing session; not persisted in DOCX or reviewed by Word. */
     rel?: string;
 }
 /**
@@ -49,15 +49,17 @@ export interface HyperlinkPatch {
     docLocation?: string | null;
     tooltip?: string | null;
     target?: string | null;
+    /** Session-only browser relationship tokens. Null or an empty string clears them; omission preserves them. */
     rel?: string | null;
 }
-/** All readable hyperlink properties: faithfully reports document state. */
+/** Native hyperlink properties and browser metadata for the current editing session. */
 export interface HyperlinkReadProperties {
     href?: string;
     anchor?: string;
     docLocation?: string;
     tooltip?: string;
     target?: string;
+    /** Browser relationship tokens for this session. A fresh DOCX open does not restore them. */
     rel?: string;
 }
 /** Domain payload for discovery items in hyperlinks.list. */

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

@@ -30,7 +30,7 @@ import { CreateAdapter, CreateApi } from './create/create.js';
 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, RevisionGuardOptions, RichContentMutationOptions, WriteAdapter } from './write/write.js';
+import { MutationOptions, RichContentMutationOptions, WriteAdapter } from './write/write.js';
 import { SelectionMutationAdapter } from './selection-mutation.js';
 import { CapabilitiesAdapter, DocumentApiCapabilities } from './capabilities/capabilities.js';
 import { SDHtmlMarkdownSupportCheckInput, SDHtmlMarkdownSupportCheckResult } from './capabilities/html-markdown-support.js';
@@ -326,7 +326,7 @@ export interface DocumentApi {
     /**
      * Clear all document body content, leaving a single empty paragraph.
      */
-    clearContent(input: ClearContentInput, options?: RevisionGuardOptions): Receipt;
+    clearContent(input: ClearContentInput, options?: MutationOptions): Receipt;
     /**
      * Comment operations.
      */

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

@@ -8,9 +8,8 @@ export type ChangeMode = 'direct' | 'tracked';
  * Shared semantic validation for the `changeMode` mutation option.
  *
  * Error-code policy (v2-tracked-change-decision-error-contract plan, WS3):
- *   - A `changeMode` value of the wrong *type* is a malformed shape and is left
- *     to upstream structural/schema validation (which surfaces
- *     `VALIDATION_ERROR`). This validator does not touch non-string values.
+ *   - A `changeMode` value of the wrong type is a malformed shape and surfaces
+ *     `VALIDATION_ERROR`, including dynamic calls without upstream schema validation.
  *   - A `changeMode` *string* outside the accepted enum is a semantic option
  *     error and fails closed with `INVALID_INPUT`, not the generic
  *     `VALIDATION_ERROR`. This keeps semantic option failures distinct from

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.16.1-next.2";
+		return "2.16.1-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -45690,7 +45690,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.16.1-next.2";
+		this.version = "2.16.1-next.3";
 		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

@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.16.1-next.2";
+		return "2.16.1-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -45621,7 +45621,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.16.1-next.2";
+		this.version = "2.16.1-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];