superdoc 2.13.0-next.1 → 2.13.0-next.2

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.13.0-next.1",
+	superdocVersion: "2.13.0-next.2",
 	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.13.0-next.1",
+	superdocVersion: "2.13.0-next.2",
 	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-registry.d.ts

@@ -2012,7 +2012,7 @@ export type InvokeRequest<T extends OperationId> = OperationRegistry[T]['options
 /**
  * Typed invoke result, narrowed by operationId.
  */
-export type InvokeResult<T extends OperationId> = OperationRegistry[T]['output'];
+export type InvokeResult<T extends OperationId> = T extends 'mutations.preview' | 'mutations.apply' ? Promise<OperationRegistry[T]['output']> : T extends 'plan.execute' ? OperationRegistry[T]['output'] | Promise<OperationRegistry[T]['output']> : OperationRegistry[T]['output'];
 /**
  * Loose invoke request for dynamic callers who don't know the operation at compile time.
  * Invalid inputs will produce adapter-level errors, not input-validation errors.

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

@@ -36,7 +36,7 @@ import { CapabilitiesAdapter, DocumentApiCapabilities } from './capabilities/cap
 import { SDHtmlMarkdownSupportCheckInput, SDHtmlMarkdownSupportCheckResult } from './capabilities/html-markdown-support.js';
 import { OperationId } from './contract/types.js';
 import { DynamicInvokeRequest, InvokeRequest, InvokeResult } from './contract/operation-registry.js';
-import { PlanApi } from './plan/plan.js';
+import { PlanApi, PlanExecuteResult } from './plan/plan.js';
 import { HistoryAdapter, HistoryApi } from './history/history.js';
 import { DiffAdapter, DiffApi } from './diff/diff.js';
 import { ExportAdapter, ExportApi } from './export/export.js';
@@ -242,8 +242,8 @@ export interface QueryApi {
     match(input: QueryMatchInput | TextSelector | NodeSelector): QueryMatchOutput;
 }
 export interface MutationsApi {
-    preview(input: MutationsPreviewInput): MutationsPreviewOutput;
-    apply(input: MutationsApplyInput): PlanReceipt;
+    preview(input: MutationsPreviewInput): Promise<MutationsPreviewOutput>;
+    apply(input: MutationsApplyInput): Promise<PlanReceipt>;
 }
 export interface RangesApi {
     resolve(input: ResolveRangeInput): ResolveRangeOutput;
@@ -255,8 +255,8 @@ export interface QueryAdapter {
     match(input: QueryMatchInput): QueryMatchOutput;
 }
 export interface MutationsAdapter {
-    preview(input: MutationsPreviewInput): MutationsPreviewOutput;
-    apply(input: MutationsApplyInput): PlanReceipt;
+    preview(input: MutationsPreviewInput): Promise<MutationsPreviewOutput>;
+    apply(input: MutationsApplyInput): Promise<PlanReceipt>;
 }
 /**
  * The Document API interface for querying and inspecting document nodes.
@@ -460,7 +460,7 @@ export interface DocumentApi {
     /**
      * Throughput-oriented batch executor with stepwise operation semantics.
      */
-    plan: PlanApi;
+    plan: PlanApi<PlanExecuteResult | Promise<PlanExecuteResult>>;
     /**
      * Snapshot-based document comparison and replay.
      */

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

@@ -1,7 +1,8 @@
 import { OperationId } from '../contract/types.js';
 import { OperationRegistry } from '../contract/operation-registry.js';
 import { DocumentApi } from '../index.js';
-type TypedDispatchHandler<K extends OperationId> = OperationRegistry[K]['options'] extends never ? (input: OperationRegistry[K]['input']) => OperationRegistry[K]['output'] : (input: OperationRegistry[K]['input'], options?: OperationRegistry[K]['options']) => OperationRegistry[K]['output'];
+type DispatchOutput<K extends OperationId> = K extends 'mutations.preview' | 'mutations.apply' ? Promise<OperationRegistry[K]['output']> : K extends 'plan.execute' ? OperationRegistry[K]['output'] | Promise<OperationRegistry[K]['output']> : OperationRegistry[K]['output'];
+type TypedDispatchHandler<K extends OperationId> = OperationRegistry[K]['options'] extends never ? (input: OperationRegistry[K]['input']) => DispatchOutput<K> : (input: OperationRegistry[K]['input'], options?: OperationRegistry[K]['options']) => DispatchOutput<K>;
 export type TypedDispatchTable = {
     [K in OperationId]: TypedDispatchHandler<K>;
 };

package/dist/document-api/src/types/mutation-plan.types.d.ts

@@ -66,6 +66,10 @@ export type TextRewriteStep = {
     where: StepWhere;
     args: {
         replacement: ReplacementPayload;
+        /** Interpret positional `$1`…`$99` and `$&` tokens for regex matches. */
+        replacementMode?: 'literal' | 'regex-template';
+        /** Preserve the matched text's casing pattern instead of using replacement casing verbatim. */
+        caseHandling?: 'exact' | 'preserve-match';
         /**
          * Style policy for the replacement text.
          * When omitted, defaults to preserve mode:
@@ -157,10 +161,18 @@ export type MutationsPreviewInput = {
     atomic: true;
     changeMode: ChangeMode;
     steps: MutationStep[];
+    /** Optional page over verbose resolved-target details. Defaults to the first 100 targets. */
+    detail?: {
+        offset?: number;
+        limit?: number;
+    };
 };
 /** Maximum number of steps per mutation plan. */
 export declare const MAX_PLAN_STEPS = 200;
-/** Maximum total resolved targets across all steps in a plan. */
+/**
+ * @deprecated Historical compatibility metadata. Text replacement no longer
+ * enforces this value; callers must not treat it as a supported target limit.
+ */
 export declare const MAX_PLAN_RESOLVED_TARGETS = 500;
 export type StepEffect = 'changed' | 'noop' | 'error' | 'assert_passed' | 'assert_failed';
 /** Resolution for a single-block (range) target. */
@@ -189,9 +201,14 @@ export type SelectionStepResolution = {
 };
 export type TextStepData = {
     domain: 'text';
-    resolutions: TextStepResolution[];
-    spanResolutions?: SpanStepResolution[];
-    selectionResolutions?: SelectionStepResolution[];
+    /** Exact number of targets selected from the step's input revision. */
+    matchedCount: number;
+    /** Exact number of targets whose content changed. */
+    changedCount: number;
+    /** Exact number of targets already equal to their requested replacement. */
+    noopCount: number;
+    /** Exact number of tracked-change identities authored by this step. */
+    trackedChangeCount: number;
 };
 export type AssertStepData = {
     domain: 'assert';
@@ -247,7 +264,14 @@ export type PreviewFailure = {
 export type StepPreview = {
     stepId: string;
     op: string;
+    /** Exact number of targets resolved for this step. */
+    matchCount?: number;
     resolutions?: TextStepResolution[];
+    detailPage?: {
+        offset: number;
+        limit: number;
+        returned: number;
+    };
     spanResolutions?: SpanStepResolution[];
     selectionResolutions?: SelectionStepResolution[];
     style?: unknown;

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.13.0-next.1";
+		return "2.13.0-next.2";
 	} catch {
 		return "unknown";
 	}
@@ -45356,7 +45356,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.13.0-next.1";
+		this.version = "2.13.0-next.2";
 		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.13.0-next.1";
+		return "2.13.0-next.2";
 	} catch {
 		return "unknown";
 	}
@@ -45287,7 +45287,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.13.0-next.1";
+		this.version = "2.13.0-next.2";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];