@superdoc-dev/cli 0.12.0-next.1 → 0.12.0-next.5

package/dist/index.js

@@ -2368,7 +2368,7 @@ More content with **bold** and *italic*.`
     },
     "format.paragraph.setAlignment": {
       memberPath: "format.paragraph.setAlignment",
-      description: "Set paragraph alignment (justification) on a paragraph-like block.",
+      description: "Set visual paragraph alignment on a paragraph-like block. For RTL paragraphs, left/right are translated to Word-compatible stored justification values.",
       expectedResult: "Returns a ParagraphMutationResult; reports NO_OP if the alignment already matches.",
       requiresDocumentContext: true,
       metadata: mutationOperation({
@@ -10405,10 +10405,13 @@ var init_schemas = __esm(() => {
       failure: paragraphMutationFailureSchemaFor("format.paragraph.resetDirectFormatting")
     },
     "format.paragraph.setAlignment": {
-      input: objectSchema({ target: paragraphTargetSchema, alignment: { enum: [...PARAGRAPH_ALIGNMENTS] } }, [
-        "target",
-        "alignment"
-      ]),
+      input: objectSchema({
+        target: paragraphTargetSchema,
+        alignment: {
+          enum: [...PARAGRAPH_ALIGNMENTS],
+          description: "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
+        }
+      }, ["target", "alignment"]),
       output: paragraphMutationResultSchemaFor("format.paragraph.setAlignment"),
       success: paragraphMutationSuccessSchema,
       failure: paragraphMutationFailureSchemaFor("format.paragraph.setAlignment")
@@ -29179,6 +29182,212 @@ var init_y_websocket = __esm(() => {
   };
 });
 
+// src/lib/collaboration/diagnostics.ts
+function isSensitiveDiagnosticKey(key) {
+  const normalized = key.toLowerCase().replace(/[^a-z0-9]/g, "");
+  if (!normalized)
+    return false;
+  return normalized === "key" || normalized === "apikey" || normalized === "authorization" || normalized.includes("token") || normalized.includes("auth") || normalized.includes("secret") || normalized.includes("password") || normalized.includes("credential");
+}
+function sanitizeUrlCandidate(value) {
+  try {
+    const parsed = new URL(value);
+    for (const key of Array.from(parsed.searchParams.keys())) {
+      if (isSensitiveDiagnosticKey(key)) {
+        parsed.searchParams.set(key, REDACTED);
+      }
+    }
+    return parsed.toString();
+  } catch {
+    return value;
+  }
+}
+function sanitizeDiagnosticString(value) {
+  const withSanitizedUrls = value.replace(/\b(?:wss?|https?):\/\/[^\s"'<>]+/gi, sanitizeUrlCandidate);
+  return withSanitizedUrls.replace(/([?&])([^=&#\s"']+)=([^&#\s"']*)/g, (match, prefix, key) => {
+    let decodedKey;
+    try {
+      decodedKey = decodeURIComponent(key.replace(/\+/g, " "));
+    } catch {
+      decodedKey = key;
+    }
+    if (!isSensitiveDiagnosticKey(decodedKey))
+      return match;
+    return `${prefix}${key}=${REDACTED}`;
+  });
+}
+function summarizeError(error) {
+  return {
+    name: sanitizeDiagnosticString(error.name),
+    message: sanitizeDiagnosticString(error.message)
+  };
+}
+function isRecord4(value) {
+  return !!value && typeof value === "object";
+}
+function summarizeEventLike(value) {
+  if ("code" in value && "reason" in value && "wasClean" in value) {
+    return {
+      code: typeof value.code === "number" ? value.code : undefined,
+      reason: sanitizeDiagnosticString(String(value.reason ?? "")),
+      wasClean: Boolean(value.wasClean)
+    };
+  }
+  if ("message" in value && "type" in value) {
+    return {
+      type: sanitizeDiagnosticString(String(value.type ?? "")),
+      message: sanitizeDiagnosticString(String(value.message ?? ""))
+    };
+  }
+  return null;
+}
+function sanitizeDiagnosticValue(value, depth = 0) {
+  if (value == null)
+    return value;
+  if (typeof value === "string")
+    return sanitizeDiagnosticString(value);
+  if (typeof value === "number" || typeof value === "boolean")
+    return value;
+  if (typeof value === "bigint")
+    return value.toString();
+  if (value instanceof Error)
+    return summarizeError(value);
+  if (depth >= MAX_OBJECT_DEPTH)
+    return "[Truncated]";
+  if (Array.isArray(value)) {
+    return value.map((entry) => sanitizeDiagnosticValue(entry, depth + 1));
+  }
+  if (!isRecord4(value)) {
+    return Object.prototype.toString.call(value);
+  }
+  const eventSummary = summarizeEventLike(value);
+  if (eventSummary)
+    return eventSummary;
+  const output = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (typeof entry === "function" || typeof entry === "symbol" || typeof entry === "undefined")
+      continue;
+    output[key] = sanitizeDiagnosticValue(entry, depth + 1);
+  }
+  return output;
+}
+function sanitizeProviderState(provider) {
+  const record = provider;
+  return sanitizeDiagnosticValue({
+    synced: record.synced,
+    isSynced: record.isSynced,
+    status: record.status,
+    wsconnected: record.wsconnected,
+    wsconnecting: record.wsconnecting,
+    shouldConnect: record.shouldConnect
+  });
+}
+function firstUsefulArg(args2) {
+  return args2[0];
+}
+function attachProviderDiagnostics(provider, context) {
+  const eventCounts = {};
+  const cleanup = [];
+  let lastStatus;
+  let lastConnectionError;
+  let lastConnectionClose;
+  let lastClose;
+  let lastDisconnect;
+  let lastAuthenticationFailed;
+  let detached = false;
+  const capture = (eventName, args2) => {
+    eventCounts[eventName] = (eventCounts[eventName] ?? 0) + 1;
+    const payload = firstUsefulArg(args2);
+    if (eventName === "connection-close" && payload == null)
+      return;
+    const sanitizedPayload = sanitizeDiagnosticValue(payload);
+    switch (eventName) {
+      case "status":
+        lastStatus = sanitizedPayload;
+        break;
+      case "connection-error":
+        lastConnectionError = sanitizedPayload;
+        break;
+      case "connection-close":
+        lastConnectionClose = sanitizedPayload;
+        break;
+      case "close":
+        lastClose = sanitizedPayload;
+        break;
+      case "disconnect":
+        lastDisconnect = sanitizedPayload;
+        break;
+      case "authenticationFailed":
+        lastAuthenticationFailed = sanitizedPayload;
+        break;
+    }
+  };
+  const subscribe3 = (eventName) => {
+    if (!provider.on)
+      return;
+    try {
+      const handler = (...args2) => capture(eventName, args2);
+      provider.on(eventName, handler);
+      cleanup.push(() => {
+        try {
+          provider.off?.(eventName, handler);
+        } catch {}
+      });
+    } catch {}
+  };
+  for (const eventName of [
+    "status",
+    "sync",
+    "synced",
+    "connection-error",
+    "connection-close",
+    "close",
+    "disconnect",
+    "authenticationFailed",
+    "authenticated"
+  ]) {
+    subscribe3(eventName);
+  }
+  return {
+    toTimeoutDetails(providerForSnapshot, timeoutMs, elapsedMs) {
+      const details = {
+        timeoutMs,
+        elapsedMs,
+        providerType: context.providerType,
+        url: sanitizeDiagnosticString(context.url),
+        documentId: sanitizeDiagnosticString(context.documentId),
+        tokenEnvConfigured: context.tokenEnvConfigured,
+        authTokenResolved: context.authTokenResolved,
+        paramsKeys: [...context.paramsKeys],
+        eventCounts: { ...eventCounts },
+        providerState: sanitizeProviderState(providerForSnapshot)
+      };
+      if (lastStatus !== undefined)
+        details.lastStatus = lastStatus;
+      if (lastConnectionError !== undefined)
+        details.lastConnectionError = lastConnectionError;
+      if (lastConnectionClose !== undefined)
+        details.lastConnectionClose = lastConnectionClose;
+      if (lastClose !== undefined)
+        details.lastClose = lastClose;
+      if (lastDisconnect !== undefined)
+        details.lastDisconnect = lastDisconnect;
+      if (lastAuthenticationFailed !== undefined)
+        details.lastAuthenticationFailed = lastAuthenticationFailed;
+      return details;
+    },
+    detach() {
+      if (detached)
+        return;
+      detached = true;
+      for (const run of cleanup.splice(0)) {
+        run();
+      }
+    }
+  };
+}
+var REDACTED = "[REDACTED]", MAX_OBJECT_DEPTH = 5;
+
 // ../../node_modules/.pnpm/@liveblocks+core@3.15.5_@types+json-schema@7.0.15/node_modules/@liveblocks/core/dist/index.js
 function error(msg) {
   if (false) {} else {
@@ -42343,10 +42552,11 @@ var init_liveblocks = __esm(() => {
 function isSynced(provider) {
   return provider.synced === true || provider.isSynced === true;
 }
-function waitForProviderSync(provider, timeoutMs) {
+function waitForProviderSync(provider, timeoutMs, diagnostics) {
   if (isSynced(provider))
     return Promise.resolve();
   return new Promise((resolve, reject) => {
+    const startedAt = Date.now();
     let settled = false;
     const cleanup = [];
     const finish = (error3) => {
@@ -42374,8 +42584,9 @@ function waitForProviderSync(provider, timeoutMs) {
       cleanup.push(() => provider.off?.("sync", onSync));
     }
     const timer = setTimeout(() => {
+      const elapsedMs = Date.now() - startedAt;
       finish(new CliError("COLLABORATION_SYNC_TIMEOUT", `Collaboration sync timed out after ${timeoutMs}ms.`, {
-        timeoutMs
+        ...diagnostics?.toTimeoutDetails(provider, timeoutMs, elapsedMs) ?? { timeoutMs }
       }));
     }, timeoutMs);
     cleanup.push(() => clearTimeout(timer));
@@ -42412,11 +42623,20 @@ function createWebSocketRuntime(profile) {
       preserveConnection: false
     });
   }
+  const diagnostics = attachProviderDiagnostics(provider, {
+    providerType: profile.providerType,
+    url: profile.url,
+    documentId: profile.documentId,
+    tokenEnvConfigured: Boolean(profile.tokenEnv),
+    authTokenResolved: Boolean(token),
+    paramsKeys: Object.keys(profile.params ?? {})
+  });
   return {
     ydoc,
     provider,
-    waitForSync: () => waitForProviderSync(provider, syncTimeoutMs),
+    waitForSync: () => waitForProviderSync(provider, syncTimeoutMs, diagnostics),
     dispose() {
+      diagnostics?.detach();
       provider.disconnect?.();
       provider.destroy?.();
       ydoc.destroy();
@@ -66558,7 +66778,7 @@ var init_remark_gfm_BhnWr3yf_es = __esm(() => {
   emptyOptions2 = {};
 });
 
-// ../../packages/superdoc/dist/chunks/SuperConverter-SvCYq2KK.es.js
+// ../../packages/superdoc/dist/chunks/SuperConverter-UqLu6KQU.es.js
 function getExtensionConfigField(extension$1, field, context = { name: "" }) {
   const fieldValue = extension$1.config[field];
   if (typeof fieldValue === "function")
@@ -67413,28 +67633,28 @@ function assertTargetPresent2(target, operationName) {
   if (target === undefined || target === null)
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} requires a target.`);
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value != null && !Array.isArray(value);
 }
 function isInteger3(value) {
   return typeof value === "number" && Number.isInteger(value);
 }
 function isTextAddress2(value) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return false;
   if (value.kind !== "text")
     return false;
   if (typeof value.blockId !== "string")
     return false;
   const range = value.range;
-  if (!isRecord4(range))
+  if (!isRecord5(range))
     return false;
   if (!isInteger3(range.start) || !isInteger3(range.end))
     return false;
   return range.start <= range.end;
 }
 function isTextTarget2(value) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return false;
   if (value.kind !== "text")
     return false;
@@ -67442,12 +67662,12 @@ function isTextTarget2(value) {
   if (!Array.isArray(segments) || segments.length === 0)
     return false;
   for (const seg of segments) {
-    if (!isRecord4(seg))
+    if (!isRecord5(seg))
       return false;
     if (typeof seg.blockId !== "string")
       return false;
     const range = seg.range;
-    if (!isRecord4(range))
+    if (!isRecord5(range))
       return false;
     if (!isInteger3(range.start) || !isInteger3(range.end))
       return false;
@@ -67457,7 +67677,7 @@ function isTextTarget2(value) {
   return true;
 }
 function isBlockNodeAddress2(value) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return false;
   if (value.kind !== "block")
     return false;
@@ -67475,7 +67695,7 @@ function assertNoUnknownFields3(input, allowlist, operationName) {
 function validateNestingPolicyValue2(value) {
   if (value === undefined)
     return;
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_INPUT", `nestingPolicy must be an object, got ${typeof value}.`, {
       field: "nestingPolicy",
       value
@@ -67504,7 +67724,7 @@ function runAttributeCarrier2(runPropertyKey) {
   };
 }
 function isObjectPatch2(value) {
-  return isRecord4(value) && !Array.isArray(value);
+  return isRecord5(value) && !Array.isArray(value);
 }
 function assertNonEmptyObject2(value, propertyKey) {
   if (Object.keys(value).length === 0)
@@ -67694,12 +67914,12 @@ function executeWrite2(adapter, request, options) {
   return adapter.write(request, normalizeMutationOptions2(options));
 }
 function assertParagraphTarget2(input, operation) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operation} input must be a non-null object.`);
   const { target } = input;
   if (target === undefined || target === null)
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operation} requires a target.`);
-  if (!isRecord4(target))
+  if (!isRecord5(target))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operation} target must be an object.`, { field: "target" });
   if (target.kind !== "block")
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operation} target.kind must be 'block'.`, {
@@ -68191,7 +68411,7 @@ function validateValue2(path2, value, schema) {
   }
 }
 function validateObjectValue2(path2, value, children) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${path2} must be a non-null object, got ${typeof value}.`, {
       field: path2,
       value
@@ -68219,13 +68439,13 @@ function validateArrayValue2(path2, value, itemSchema) {
     validateValue2(`${path2}[${i$1}]`, value[i$1], itemSchema);
 }
 function validateStylesApplyInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "styles.apply input must be a non-null object.");
   assertNoUnknownFields$1(input, INPUT_ALLOWED_KEYS2);
   const { target, patch } = input;
   if (target === undefined || target === null)
     throw new DocumentApiValidationError2("INVALID_TARGET", "styles.apply requires a target object.");
-  if (!isRecord4(target))
+  if (!isRecord5(target))
     throw new DocumentApiValidationError2("INVALID_TARGET", "target must be a non-null object.", {
       field: "target",
       value: target
@@ -68244,7 +68464,7 @@ function validateStylesApplyInput2(input) {
   const channel = target.channel;
   if (patch === undefined || patch === null)
     throw new DocumentApiValidationError2("INVALID_INPUT", "styles.apply requires a patch object.");
-  if (!isRecord4(patch))
+  if (!isRecord5(patch))
     throw new DocumentApiValidationError2("INVALID_INPUT", "patch must be a non-null object.", {
       field: "patch",
       value: patch
@@ -68283,7 +68503,7 @@ function validateStylesApplyInput2(input) {
 function validateStylesApplyOptions2(options) {
   if (options === undefined || options === null)
     return;
-  if (!isRecord4(options))
+  if (!isRecord5(options))
     throw new DocumentApiValidationError2("INVALID_INPUT", "styles.apply options must be a non-null object.");
   for (const key of Object.keys(options))
     if (!OPTIONS_ALLOWED_KEYS2.has(key))
@@ -69137,7 +69357,7 @@ function derivePropertyStateFromDirect2(direct) {
   }
 }
 function isSelectionEdgeNodeAddress2(value) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return false;
   if (value.kind !== "block")
     return false;
@@ -69148,7 +69368,7 @@ function isSelectionEdgeNodeAddress2(value) {
   return true;
 }
 function isSelectionPoint2(value) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return false;
   if (value.kind === "text")
     return typeof value.blockId === "string" && value.blockId !== "" && isInteger3(value.offset) && value.offset >= 0;
@@ -69157,7 +69377,7 @@ function isSelectionPoint2(value) {
   return false;
 }
 function isSelectionTarget2(value) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return false;
   if (value.kind !== "selection")
     return false;
@@ -69173,7 +69393,7 @@ function validateStoryLocator2(value, field) {
     });
 }
 function validateAnchor2(value, fieldName) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${fieldName} must be a non-null object.`, { field: fieldName });
   if (typeof value.kind !== "string" || !VALID_ANCHOR_KINDS2.has(value.kind))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${fieldName}.kind must be "document", "point", or "ref", got ${JSON.stringify(value.kind)}.`, {
@@ -69210,7 +69430,7 @@ function validateAnchor2(value, fieldName) {
   }
 }
 function validateResolveRangeInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "ranges.resolve input must be a non-null object.");
   assertNoUnknownFields3(input, RESOLVE_RANGE_ALLOWED_KEYS2, "ranges.resolve");
   if (input.start === undefined)
@@ -69233,7 +69453,7 @@ function executeResolveRange2(adapter, input) {
 function validateSelectionCurrentInput2(input) {
   if (input === undefined)
     return;
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "selection.current input must be a non-null object.");
   assertNoUnknownFields3(input, SELECTION_CURRENT_ALLOWED_KEYS2, "selection.current");
   if (input.includeText !== undefined && typeof input.includeText !== "boolean")
@@ -69250,7 +69470,7 @@ function executeMarkdownToFragment2(adapter, input) {
   return adapter.markdownToFragment(input);
 }
 function validateCreateCommentInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "comments.create input must be a non-null object.");
   assertNoUnknownFields3(input, CREATE_COMMENT_ALLOWED_KEYS2, "comments.create");
   const { target, text: text$2, parentCommentId } = input;
@@ -69280,7 +69500,7 @@ function validateCreateCommentInput2(input) {
     });
 }
 function validatePatchCommentInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "comments.patch input must be a non-null object.");
   assertNoUnknownFields3(input, PATCH_COMMENT_ALLOWED_KEYS2, "comments.patch");
   const { commentId, target } = input;
@@ -69356,7 +69576,7 @@ function executeCommentsPatch2(adapter, input, options) {
   throw new DocumentApiValidationError2("INTERNAL_ERROR", "comments.patch: no mutation field matched after validation. This is a bug.");
 }
 function validateCommentIdInput2(input, operationName) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} input must be a non-null object.`);
   if (typeof input.commentId !== "string" || input.commentId.length === 0)
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} commentId must be a non-empty string.`, {
@@ -69373,7 +69593,7 @@ function executeGetComment2(adapter, input) {
   return adapter.get(input);
 }
 function executeListComments2(adapter, query2) {
-  if (query2 !== undefined && !isRecord4(query2))
+  if (query2 !== undefined && !isRecord5(query2))
     throw new DocumentApiValidationError2("INVALID_INPUT", "comments.list query must be an object if provided.");
   return adapter.list(query2);
 }
@@ -69399,7 +69619,7 @@ function validateTargetLocator$1(input, operation) {
     });
 }
 function validateStyleApplyInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "format.apply input must be a non-null object.");
   assertNoUnknownFields3(input, STYLE_APPLY_INPUT_ALLOWED_KEYS2, "format.apply");
   validateStoryLocator2(input.in, "in");
@@ -69435,7 +69655,7 @@ function normalizeInlineAliasValue2(key, value) {
 }
 function validateInlineAliasInput2(key, input) {
   const operation = `format.${key}`;
-  const candidate = isRecord4(input) ? input : {};
+  const candidate = isRecord5(input) ? input : {};
   assertNoUnknownFields3(candidate, INLINE_ALIAS_INPUT_ALLOWED_KEYS2, operation);
   validateStoryLocator2(candidate.in, "in");
   validateTargetLocator$1(candidate, operation);
@@ -69468,19 +69688,19 @@ function executeGet2(adapter, input) {
   return adapter.get(input);
 }
 function executeGetText2(adapter, input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "getText input must be a non-null object.");
   validateStoryLocator2(input.in, "in");
   return adapter.getText(input);
 }
 function executeGetMarkdown2(adapter, input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "getMarkdown input must be a non-null object.");
   validateStoryLocator2(input.in, "in");
   return adapter.getMarkdown(input);
 }
 function executeGetHtml2(adapter, input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "getHtml input must be a non-null object.");
   validateStoryLocator2(input.in, "in");
   return adapter.getHtml(input);
@@ -69495,7 +69715,7 @@ function executeClearContent2(adapter, input, options) {
   return adapter.clearContent(input, options);
 }
 function validateDeleteInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_TARGET", "Delete input must be a non-null object.");
   assertNoUnknownFields3(input, DELETE_INPUT_ALLOWED_KEYS2, "delete");
   validateStoryLocator2(input.in, "in");
@@ -69550,7 +69770,7 @@ function validateDocumentFragment2(fragment2) {
   if (nodes.length === 0)
     throw new DocumentApiValidationError2("INVALID_PAYLOAD", "Fragment must contain at least one node.");
   const first = nodes[0];
-  if (isRecord4(first) && typeof first.kind === "string") {
+  if (isRecord5(first) && typeof first.kind === "string") {
     validateSDFragment2(fragment2);
     return;
   }
@@ -69576,7 +69796,7 @@ function validateContentNode2(node3, seenIds) {
   validateContentByKind2(rec, kind, seenIds);
 }
 function assertPlainObject2(node3) {
-  if (!isRecord4(node3))
+  if (!isRecord5(node3))
     throw new DocumentApiValidationError2("INVALID_PAYLOAD", "Each node in a fragment must be a plain object.");
 }
 function assertKindField2(rec) {
@@ -69598,7 +69818,7 @@ function validatePayloadKeyMatchesKind2(rec, kind) {
     return;
   if (!(kind in rec))
     throw new DocumentApiValidationError2("INVALID_PAYLOAD", `Node with kind "${kind}" must have a "${kind}" payload key.`, { kind });
-  if (rec[kind] !== undefined && !isRecord4(rec[kind]))
+  if (rec[kind] !== undefined && !isRecord5(rec[kind]))
     throw new DocumentApiValidationError2("INVALID_PAYLOAD", `"${kind}" payload must be an object.`, { kind });
 }
 function collectAndCheckId2(rec, seenIds) {
@@ -69642,7 +69862,7 @@ function validateParagraphPayload2(rec, seenIds) {
   const payload = rec.paragraph;
   if (!payload)
     return;
-  if (payload.numbering != null && isRecord4(payload.numbering)) {
+  if (payload.numbering != null && isRecord5(payload.numbering)) {
     const numbering = payload.numbering;
     if (typeof numbering.level === "number") {
       const level = numbering.level;
@@ -69652,7 +69872,7 @@ function validateParagraphPayload2(rec, seenIds) {
   }
   if (Array.isArray(payload.tabs)) {
     for (const tab of payload.tabs)
-      if (isRecord4(tab)) {
+      if (isRecord5(tab)) {
         const pos = tab.position;
         if (typeof pos === "number" && pos <= 0)
           throw new DocumentApiValidationError2("INVALID_PAYLOAD", `paragraph.tabs position must be positive, got ${pos}.`, { field: "tabs.position" });
@@ -69722,7 +69942,7 @@ function validateListPayload2(rec, seenIds) {
   }
 }
 function rejectNumberingInsideListItem2(node3) {
-  if (!isRecord4(node3))
+  if (!isRecord5(node3))
     return;
   const rec = node3;
   const kind = rec.kind;
@@ -69762,9 +69982,9 @@ function validateTocPayload2(rec) {
   const payload = rec.toc;
   if (!payload)
     return;
-  const sourceConfig = isRecord4(payload.sourceConfig) ? payload.sourceConfig : undefined;
-  const displayConfig = isRecord4(payload.displayConfig) ? payload.displayConfig : undefined;
-  if (sourceConfig && isRecord4(sourceConfig.outlineLevels)) {
+  const sourceConfig = isRecord5(payload.sourceConfig) ? payload.sourceConfig : undefined;
+  const displayConfig = isRecord5(payload.displayConfig) ? payload.displayConfig : undefined;
+  if (sourceConfig && isRecord5(sourceConfig.outlineLevels)) {
     const range = sourceConfig.outlineLevels;
     const from4 = range.from;
     const to = range.to;
@@ -69775,7 +69995,7 @@ function validateTocPayload2(rec) {
     if (typeof from4 === "number" && typeof to === "number" && from4 > to)
       throw new DocumentApiValidationError2("INVALID_PAYLOAD", `TOC sourceConfig.outlineLevels.from (${from4}) must be <= to (${to}).`);
   }
-  if (sourceConfig && isRecord4(sourceConfig.tcFieldLevels)) {
+  if (sourceConfig && isRecord5(sourceConfig.tcFieldLevels)) {
     const range = sourceConfig.tcFieldLevels;
     const from4 = range.from;
     const to = range.to;
@@ -69787,7 +70007,7 @@ function validateTocPayload2(rec) {
       throw new DocumentApiValidationError2("INVALID_PAYLOAD", `TOC sourceConfig.tcFieldLevels.from (${from4}) must be <= to (${to}).`);
   }
   if (displayConfig) {
-    if (displayConfig.includePageNumbers === false && isRecord4(displayConfig.omitPageNumberLevels))
+    if (displayConfig.includePageNumbers === false && isRecord5(displayConfig.omitPageNumberLevels))
       throw new DocumentApiValidationError2("INVALID_PAYLOAD", "TOC cannot set displayConfig.includePageNumbers=false and also provide displayConfig.omitPageNumberLevels.");
     if (displayConfig.tabLeader !== undefined && displayConfig.separator !== undefined)
       throw new DocumentApiValidationError2("INVALID_PAYLOAD", "TOC cannot set both displayConfig.tabLeader and displayConfig.separator.");
@@ -69835,7 +70055,7 @@ function validateLegacyTopLevelNode2(node3) {
   validateLegacyNodeContent2(rec, type);
 }
 function assertLegacyNodeShape2(node3) {
-  if (!isRecord4(node3))
+  if (!isRecord5(node3))
     throw new DocumentApiValidationError2("INVALID_PAYLOAD", "Each node in a fragment must be a plain object.");
   const rec = node3;
   if (typeof rec.kind !== "string" && typeof rec.type !== "string")
@@ -69934,7 +70154,7 @@ function validateLegacyInlineArray2(content$2, parentType) {
     validateLegacyInlineContent2(item, parentType);
 }
 function validateLegacyInlineContent2(item, parentType) {
-  if (!isRecord4(item))
+  if (!isRecord5(item))
     throw new DocumentApiValidationError2("INVALID_PAYLOAD", `Each inline content item in ${parentType} must be a plain object.`);
   const itemType = item.type;
   if (itemType !== "text" && itemType !== "image")
@@ -70009,7 +70229,7 @@ function isStructuralInsertInput2(input) {
   return "content" in input && input.content !== undefined;
 }
 function validateInsertInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_TARGET", "Insert input must be a non-null object.");
   const hasValue = "value" in input && input.value !== undefined;
   const hasContent2 = "content" in input && input.content !== undefined;
@@ -70117,13 +70337,13 @@ function executeInsert2(selectionAdapter, writeAdapter, input, options) {
   }, options));
 }
 function validateListInput2(input, operationName) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} input must be a non-null object.`);
 }
 function validateListItemAddress2(value, field, operationName) {
   if (value === undefined || value === null)
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} requires a ${field}.`);
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} ${field} must be an object.`, {
       field,
       value
@@ -70149,7 +70369,7 @@ function validateListItemTarget2(input, operationName) {
   validateListItemAddress2(input.target, "target", operationName);
 }
 function validateBlockAddress2(value, field, operationName) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} ${field} must be an object.`, {
       field,
       value
@@ -70172,7 +70392,7 @@ function validateBlockAddress2(value, field, operationName) {
     });
 }
 function validateBlockAddressOrRange2(value, field, operationName) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} ${field} must be an object.`, {
       field,
       value
@@ -70235,7 +70455,7 @@ function optionalLevelsArray2(value, field, operationName) {
       });
 }
 function validateListLevelTemplate2(entry, path2, operationName) {
-  if (!isRecord4(entry))
+  if (!isRecord5(entry))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} ${path2} must be an object.`, {
       field: path2,
       value: entry
@@ -70270,7 +70490,7 @@ function validateListLevelTemplate2(entry, path2, operationName) {
   if (e.tabStopAt !== undefined && e.tabStopAt !== null)
     optionalNumber2(e.tabStopAt, `${path2}.tabStopAt`, operationName);
   if (e.indents !== undefined) {
-    if (!isRecord4(e.indents))
+    if (!isRecord5(e.indents))
       throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} ${path2}.indents must be an object.`, {
         field: `${path2}.indents`,
         value: e.indents
@@ -70282,7 +70502,7 @@ function validateListLevelTemplate2(entry, path2, operationName) {
   }
 }
 function validateListTemplate2(value, field, operationName) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} ${field} must be an object.`, {
       field,
       value
@@ -70313,7 +70533,7 @@ function validateListsCreateFields2(raw) {
       });
   }
   if (raw.sequence !== undefined) {
-    if (!isRecord4(raw.sequence))
+    if (!isRecord5(raw.sequence))
       throw new DocumentApiValidationError2("INVALID_INPUT", `${op} sequence must be an object.`, {
         field: "sequence",
         value: raw.sequence
@@ -70338,7 +70558,7 @@ function validateListsCreateFields2(raw) {
 }
 function executeListsList2(adapter, query2) {
   if (query2 !== undefined) {
-    if (!isRecord4(query2))
+    if (!isRecord5(query2))
       throw new DocumentApiValidationError2("INVALID_INPUT", "lists.list query must be an object if provided.");
     const q$1 = query2;
     if (q$1.kind !== undefined)
@@ -70348,7 +70568,7 @@ function executeListsList2(adapter, query2) {
     optionalInteger2(q$1.offset, "offset", "lists.list");
     optionalInteger2(q$1.ordinal, "ordinal", "lists.list");
     if (q$1.within !== undefined) {
-      if (!isRecord4(q$1.within))
+      if (!isRecord5(q$1.within))
         throw new DocumentApiValidationError2("INVALID_INPUT", "lists.list within must be an object.", {
           field: "within",
           value: q$1.within
@@ -70641,7 +70861,7 @@ function executeListsSetLevelStart2(adapter, input, options) {
 function executeListsSetLevelLayout2(adapter, input, options) {
   validateListItemTarget2(input, "lists.setLevelLayout");
   requireLevel2(input.level, "lists.setLevelLayout");
-  if (!isRecord4(input.layout))
+  if (!isRecord5(input.layout))
     throw new DocumentApiValidationError2("INVALID_INPUT", "lists.setLevelLayout layout must be an object.", {
       field: "layout",
       value: input.layout
@@ -70679,7 +70899,7 @@ function validateTargetLocator3(input, operation) {
     });
 }
 function validateReplaceInput2(input) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_TARGET", "Replace input must be a non-null object.");
   const hasText = "text" in input && input.text !== undefined;
   const hasContent2 = "content" in input && input.content !== undefined;
@@ -70804,7 +71024,7 @@ function validateCreateSectionBreakInput2(input) {
   }
 }
 function executeCreateParagraph2(adapter, input, options) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "create.paragraph input must be a non-null object.");
   validateStoryLocator2(input.in, "in");
   const normalized = {
@@ -70814,7 +71034,7 @@ function executeCreateParagraph2(adapter, input, options) {
   return adapter.paragraph(normalized, normalizeMutationOptions2(options));
 }
 function executeCreateHeading2(adapter, input, options) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "create.heading input must be a non-null object.");
   validateStoryLocator2(input.in, "in");
   if (!isInteger3(input.level) || !VALID_HEADING_LEVELS2.has(input.level))
@@ -70831,7 +71051,7 @@ function executeCreateHeading2(adapter, input, options) {
   return adapter.heading(normalized, normalizeMutationOptions2(options));
 }
 function executeCreateTable2(adapter, input, options) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", "create.table input must be a non-null object.");
   if (!isInteger3(input.rows) || input.rows < 1)
     throw new DocumentApiValidationError2("INVALID_INPUT", `create.table rows must be a positive integer, got ${JSON.stringify(input.rows)}.`, {
@@ -71645,17 +71865,17 @@ function assertBoolean$1(value, fieldName) {
     });
 }
 function assertSectionAddress$1(value, fieldName) {
-  if (!isRecord4(value) || value.kind !== "section" || typeof value.sectionId !== "string" || value.sectionId.length === 0)
+  if (!isRecord5(value) || value.kind !== "section" || typeof value.sectionId !== "string" || value.sectionId.length === 0)
     throw new DocumentApiValidationError2("INVALID_TARGET", `${fieldName} must be a section address.`, {
       field: fieldName,
       value
     });
 }
 function assertHeaderFooterSlotTarget2(input, operationName) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} input must be an object.`);
   const target = input.target;
-  if (!isRecord4(target) || target.kind !== "headerFooterSlot")
+  if (!isRecord5(target) || target.kind !== "headerFooterSlot")
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName}.target must be a headerFooterSlot address.`, {
       field: `${operationName}.target`,
       value: target
@@ -71665,10 +71885,10 @@ function assertHeaderFooterSlotTarget2(input, operationName) {
   assertOneOf$1(target.variant, `${operationName}.target.variant`, HEADER_FOOTER_VARIANTS$1);
 }
 function assertHeaderFooterPartTarget2(input, operationName) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} input must be an object.`);
   const target = input.target;
-  if (!isRecord4(target) || target.kind !== "headerFooterPart")
+  if (!isRecord5(target) || target.kind !== "headerFooterPart")
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName}.target must be a headerFooterPart address.`, {
       field: `${operationName}.target`,
       value: target
@@ -71720,14 +71940,14 @@ function executeHeaderFootersPartsDelete2(adapter, input, options) {
   return adapter.parts.delete(input, normalizeMutationOptions2(options));
 }
 function assertSectionAddress3(value, fieldName) {
-  if (!isRecord4(value) || value.kind !== "section" || typeof value.sectionId !== "string" || value.sectionId.length === 0)
+  if (!isRecord5(value) || value.kind !== "section" || typeof value.sectionId !== "string" || value.sectionId.length === 0)
     throw new DocumentApiValidationError2("INVALID_TARGET", `${fieldName} must be a section address.`, {
       field: fieldName,
       value
     });
 }
 function assertSectionTarget2(input, operationName) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} input must be an object.`);
   assertSectionAddress3(input.target, `${operationName}.target`);
 }
@@ -71779,7 +71999,7 @@ function hasAnyDefined2(value, keys$1) {
   return keys$1.some((key) => value[key] !== undefined);
 }
 function assertObject2(value, fieldName) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${fieldName} must be an object.`, {
       field: fieldName,
       value
@@ -72250,7 +72470,7 @@ function validateInsertionTarget2(target, operationName) {
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} target.anchor must have nodeType 'paragraph' and a string nodeId.`, { target });
 }
 function validateTocInput2(input, operationName) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} input must be a non-null object.`);
 }
 function executeTocList2(adapter, query2) {
@@ -72302,7 +72522,7 @@ function executeTocGetEntry2(adapter, input) {
   return adapter.getEntry(input);
 }
 function validateTocEditEntryPatch2(patch, operationName) {
-  if (!isRecord4(patch))
+  if (!isRecord5(patch))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} patch must be a non-null object.`, {
       field: "patch",
       value: patch
@@ -72340,16 +72560,16 @@ function executeTocEditEntry2(adapter, input, options) {
   return adapter.editEntry(input, normalizeMutationOptions2(options));
 }
 function isHyperlinkTarget2(value) {
-  if (!isRecord4(value))
+  if (!isRecord5(value))
     return false;
   if (value.kind !== "inline" || value.nodeType !== "hyperlink")
     return false;
   const anchor = value.anchor;
-  if (!isRecord4(anchor))
+  if (!isRecord5(anchor))
     return false;
   const start = anchor.start;
   const end = anchor.end;
-  if (!isRecord4(start) || !isRecord4(end))
+  if (!isRecord5(start) || !isRecord5(end))
     return false;
   return typeof start.blockId === "string" && typeof start.offset === "number" && typeof end.blockId === "string" && typeof end.offset === "number";
 }
@@ -72360,7 +72580,7 @@ function validateHyperlinkTarget2(target, operationName) {
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} target must be a HyperlinkTarget with kind 'inline', nodeType 'hyperlink', and a valid anchor.`, { target });
 }
 function validateDestination2(destination, operationName) {
-  if (!isRecord4(destination))
+  if (!isRecord5(destination))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} requires a destination object.`);
   const hasHref = typeof destination.href === "string" && destination.href.length > 0;
   const hasAnchor = typeof destination.anchor === "string" && destination.anchor.length > 0;
@@ -72368,12 +72588,12 @@ function validateDestination2(destination, operationName) {
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} destination must have at least one of 'href' or 'anchor'.`);
 }
 function validateHyperlinkSpec2(link2, operationName) {
-  if (!isRecord4(link2))
+  if (!isRecord5(link2))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} requires a link specification object.`);
   validateDestination2(link2.destination, operationName);
 }
 function validatePatch2(patch, operationName) {
-  if (!isRecord4(patch))
+  if (!isRecord5(patch))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} requires a patch object.`);
   for (const key of Object.keys(patch))
     if (!PATCH_FIELDS2.has(key))
@@ -72425,11 +72645,11 @@ function executeHyperlinksRemove2(adapter, input, options) {
   return adapter.remove(input, normalizeMutationOptions2(options));
 }
 function validateCCInput2(input, operationName) {
-  if (!isRecord4(input))
+  if (!isRecord5(input))
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} input must be a non-null object.`);
 }
 function validateCCTarget2(target, operationName) {
-  if (!isRecord4(target))
+  if (!isRecord5(target))
     throw new DocumentApiValidationError2("INVALID_TARGET", `${operationName} requires a valid target with { kind, nodeType: 'sdt', nodeId }.`, {
       field: "target",
       value: target
@@ -72494,14 +72714,14 @@ function validateContentPayload2(input, operationName) {
   validateContentFormat2(input.format, "format", operationName);
 }
 function validateSymbol2(value, field, operationName) {
-  if (!isRecord4(value) || typeof value.font !== "string" || typeof value.char !== "string")
+  if (!isRecord5(value) || typeof value.font !== "string" || typeof value.char !== "string")
     throw new DocumentApiValidationError2("INVALID_INPUT", `${operationName} ${field} must be { font: string, char: string }.`, {
       field,
       value
     });
 }
 function executeContentControlsList2(adapter, query2) {
-  if (query2 !== undefined && !isRecord4(query2))
+  if (query2 !== undefined && !isRecord5(query2))
     throw new DocumentApiValidationError2("INVALID_INPUT", "contentControls.list query must be an object if provided.");
   return adapter.list(query2);
 }
@@ -72681,7 +72901,7 @@ function executeContentControlsPatchRawProperties2(adapter, input, options) {
     });
   for (let i$1 = 0;i$1 < input.patches.length; i$1++) {
     const patch = input.patches[i$1];
-    if (!isRecord4(patch))
+    if (!isRecord5(patch))
       throw new DocumentApiValidationError2("INVALID_INPUT", `contentControls.patchRawProperties patches[${i$1}] must be an object.`, {
         field: `patches[${i$1}]`,
         value: patch
@@ -72812,7 +73032,7 @@ function executeContentControlsChoiceListSetItems2(adapter, input, options) {
     });
   for (let i$1 = 0;i$1 < input.items.length; i$1++) {
     const item = input.items[i$1];
-    if (!isRecord4(item) || typeof item.displayText !== "string" || typeof item.value !== "string")
+    if (!isRecord5(item) || typeof item.displayText !== "string" || typeof item.value !== "string")
       throw new DocumentApiValidationError2("INVALID_INPUT", `contentControls.choiceList.setItems items[${i$1}] must be { displayText: string, value: string }.`, {
         field: `items[${i$1}]`,
         value: item
@@ -120534,7 +120754,7 @@ var isRegExp = (value) => {
       state.kern = kernNode.attributes["w:val"];
   }
 }, SuperConverter;
-var init_SuperConverter_SvCYq2KK_es = __esm(() => {
+var init_SuperConverter_UqLu6KQU_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
@@ -124353,7 +124573,7 @@ var init_SuperConverter_SvCYq2KK_es = __esm(() => {
     },
     "format.paragraph.setAlignment": {
       memberPath: "format.paragraph.setAlignment",
-      description: "Set paragraph alignment (justification) on a paragraph-like block.",
+      description: "Set visual paragraph alignment on a paragraph-like block. For RTL paragraphs, left/right are translated to Word-compatible stored justification values.",
       expectedResult: "Returns a ParagraphMutationResult; reports NO_OP if the alignment already matches.",
       requiresDocumentContext: true,
       metadata: mutationOperation2({
@@ -132283,7 +132503,10 @@ var init_SuperConverter_SvCYq2KK_es = __esm(() => {
     }
   }, ["target", "styleId"]), paragraphMutationResultSchemaFor2("styles.paragraph.setStyle"), paragraphMutationFailureSchemaFor2("styles.paragraph.setStyle"), objectSchema2({ target: paragraphTargetSchema2 }, ["target"]), paragraphMutationResultSchemaFor2("styles.paragraph.clearStyle"), paragraphMutationFailureSchemaFor2("styles.paragraph.clearStyle"), objectSchema2({ target: paragraphTargetSchema2 }, ["target"]), paragraphMutationResultSchemaFor2("format.paragraph.resetDirectFormatting"), paragraphMutationFailureSchemaFor2("format.paragraph.resetDirectFormatting"), objectSchema2({
     target: paragraphTargetSchema2,
-    alignment: { enum: [...PARAGRAPH_ALIGNMENTS2] }
+    alignment: {
+      enum: [...PARAGRAPH_ALIGNMENTS2],
+      description: "Visual paragraph alignment. In RTL paragraphs, 'left' stores w:jc='right' and 'right' stores w:jc='left' so Word displays the requested side."
+    }
   }, ["target", "alignment"]), paragraphMutationResultSchemaFor2("format.paragraph.setAlignment"), paragraphMutationFailureSchemaFor2("format.paragraph.setAlignment"), objectSchema2({ target: paragraphTargetSchema2 }, ["target"]), paragraphMutationResultSchemaFor2("format.paragraph.clearAlignment"), paragraphMutationFailureSchemaFor2("format.paragraph.clearAlignment"), { ...objectSchema2({
     target: paragraphTargetSchema2,
     left: {
@@ -158711,7 +158934,7 @@ var init_SuperConverter_SvCYq2KK_es = __esm(() => {
   };
 });
 
-// ../../packages/superdoc/dist/chunks/create-headless-toolbar-CAjlOJ3Q.es.js
+// ../../packages/superdoc/dist/chunks/create-headless-toolbar-QcQvy-nD.es.js
 function parseSizeUnit(val = "0") {
   const length3 = val.toString() || "0";
   const value = Number.parseFloat(length3);
@@ -161994,6 +162217,7 @@ function getWordChanges(oldText, newText) {
       i4++;
       continue;
     }
+    const groupStart = i4;
     let deleteStart = -1;
     let deleteEnd = -1;
     let insertText2 = "";
@@ -162022,7 +162246,7 @@ function getWordChanges(oldText, newText) {
         oldTo: deleteEnd
       });
     else if (insertText2.length > 0) {
-      const prevStep = i4 > 0 ? steps[i4 - 1] : null;
+      const prevStep = groupStart > 0 ? steps[groupStart - 1] : null;
       let insertAt = 0;
       if (prevStep && prevStep.type === "equal") {
         const prevToken = oldTokens[prevStep.oldIdx];
@@ -163479,7 +163703,7 @@ function resolveKind(node3) {
 function resolvePayload(node3, kind) {
   return node3[kind] ?? node3;
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function materializeFragment(schema, fragment2, existingDocIds = /* @__PURE__ */ new Set, operation = "insert", options) {
@@ -163556,7 +163780,7 @@ function materializeTable(schema, node3, seenIds, existingDocIds, operation, opt
     paraId: v4_default()
   };
   const styleRef = payload.styleRef ?? payload.style;
-  const tableProperties = isRecord5(payload.tableProperties) ? { ...payload.tableProperties } : {};
+  const tableProperties = isRecord6(payload.tableProperties) ? { ...payload.tableProperties } : {};
   if (styleRef) {
     attrs.tableStyleId = styleRef;
     tableProperties.tableStyleId = styleRef;
@@ -163574,7 +163798,7 @@ function materializeTable(schema, node3, seenIds, existingDocIds, operation, opt
     attrs.justification = justification;
     tableProperties.justification = justification;
   }
-  if (payload.props?.borders && isRecord5(payload.props.borders)) {
+  if (payload.props?.borders && isRecord6(payload.props.borders)) {
     attrs.borders = payload.props.borders;
     tableProperties.borders = payload.props.borders;
   }
@@ -163620,7 +163844,7 @@ function normalizeTableGridColumns(columns) {
   if (!Array.isArray(columns) || columns.length === 0)
     return;
   const normalized = columns.map((column) => {
-    const raw = typeof column === "number" ? column : isRecord5(column) && typeof column.width === "number" ? column.width : undefined;
+    const raw = typeof column === "number" ? column : isRecord6(column) && typeof column.width === "number" ? column.width : undefined;
     if (typeof raw !== "number" || !Number.isFinite(raw))
       return null;
     return { col: Math.round(raw) };
@@ -163628,7 +163852,7 @@ function normalizeTableGridColumns(columns) {
   return normalized.length > 0 ? normalized : undefined;
 }
 function mapSDTableWidthToMeasurement(width) {
-  if (isRecord5(width)) {
+  if (isRecord6(width)) {
     if ("kind" in width && typeof width.kind === "string")
       switch (width.kind) {
         case "auto":
@@ -163682,15 +163906,15 @@ function mapSDTableAlignmentToJustification(value) {
 function resolveNeedsTableStyleNormalization(node3, payload) {
   if (payload.needsTableStyleNormalization === true)
     return true;
-  if (!isRecord5(node3))
+  if (!isRecord6(node3))
     return false;
   const ext = node3.ext;
-  if (!isRecord5(ext))
+  if (!isRecord6(ext))
     return false;
   if (ext.needsTableStyleNormalization === true)
     return true;
   const superdocExt = ext.superdoc;
-  if (isRecord5(superdocExt) && superdocExt.needsTableStyleNormalization === true)
+  if (isRecord6(superdocExt) && superdocExt.needsTableStyleNormalization === true)
     return true;
   return false;
 }
@@ -167617,6 +167841,8 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, Extension = class Extension2 {
   const documentId = activeEditor?.options?.documentId;
   if (!documentId)
     return null;
+  if (typeof superdoc.getPresentationEditorForDocument === "function")
+    return superdoc.getPresentationEditorForDocument(documentId);
   return (superdoc.superdocStore?.documents ?? []).find((doc2) => doc2.getEditor?.()?.options?.documentId === documentId)?.getPresentationEditor?.() ?? null;
 }, resolveToolbarSources = (superdoc) => {
   const presentationEditor = resolvePresentationEditor(superdoc);
@@ -168363,17 +168589,21 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, Extension = class Extension2 {
     active: false,
     disabled: isCommandDisabled(context) || !inTable
   };
+}, lookupCommentByCommentId = (superdoc, commentId) => {
+  if (typeof superdoc?.getComment === "function")
+    return superdoc.getComment(commentId) ?? null;
+  const store = superdoc?.commentsStore;
+  if (typeof store?.getComment === "function")
+    return store.getComment(commentId) ?? null;
+  return null;
 }, enrichTrackedChanges = (trackedChanges = [], superdoc) => {
   if (!trackedChanges.length)
     return trackedChanges;
-  const store = superdoc?.commentsStore;
-  if (!store?.getComment)
-    return trackedChanges;
   return trackedChanges.map((change) => {
     const commentId = change.id;
     if (!commentId)
       return change;
-    const storeComment = store.getComment(commentId);
+    const storeComment = lookupCommentByCommentId(superdoc, commentId);
     if (!storeComment)
       return change;
     const comment = typeof storeComment.getValues === "function" ? storeComment.getValues() : storeComment;
@@ -168721,8 +168951,8 @@ var CSS_DIMENSION_REGEX, DOM_SIZE_UNITS, Extension = class Extension2 {
     }
   };
 };
-var init_create_headless_toolbar_CAjlOJ3Q_es = __esm(() => {
-  init_SuperConverter_SvCYq2KK_es();
+var init_create_headless_toolbar_QcQvy_nD_es = __esm(() => {
+  init_SuperConverter_UqLu6KQU_es();
   init_uuid_qzgm05fK_es();
   init_constants_DrU4EASo_es();
   init_dist_B8HfvhaK_es();
@@ -183513,14 +183743,14 @@ var require_lib2 = __commonJS((exports) => {
   var mixinPluginNames = Object.keys(mixinPlugins);
 
   class ExpressionParser extends LValParser {
-    checkProto(prop, isRecord6, sawProto, refExpressionErrors) {
+    checkProto(prop, isRecord7, sawProto, refExpressionErrors) {
       if (prop.type === "SpreadElement" || this.isObjectMethod(prop) || prop.computed || prop.shorthand) {
         return sawProto;
       }
       const key2 = prop.key;
       const name = key2.type === "Identifier" ? key2.name : key2.value;
       if (name === "__proto__") {
-        if (isRecord6) {
+        if (isRecord7) {
           this.raise(Errors.RecordNoProto, key2);
           return true;
         }
@@ -184583,8 +184813,8 @@ var require_lib2 = __commonJS((exports) => {
     parseTemplateSubstitution() {
       return this.parseExpression();
     }
-    parseObjectLike(close2, isPattern, isRecord6, refExpressionErrors) {
-      if (isRecord6) {
+    parseObjectLike(close2, isPattern, isRecord7, refExpressionErrors) {
+      if (isRecord7) {
         this.expectPlugin("recordAndTuple");
       }
       const oldInFSharpPipelineDirectBody = this.state.inFSharpPipelineDirectBody;
@@ -184609,9 +184839,9 @@ var require_lib2 = __commonJS((exports) => {
           prop = this.parseBindingProperty();
         } else {
           prop = this.parsePropertyDefinition(refExpressionErrors);
-          sawProto = this.checkProto(prop, isRecord6, sawProto, refExpressionErrors);
+          sawProto = this.checkProto(prop, isRecord7, sawProto, refExpressionErrors);
         }
-        if (isRecord6 && !this.isObjectProperty(prop) && prop.type !== "SpreadElement") {
+        if (isRecord7 && !this.isObjectProperty(prop) && prop.type !== "SpreadElement") {
           this.raise(Errors.InvalidRecordProperty, prop);
         }
         if (prop.shorthand) {
@@ -184624,7 +184854,7 @@ var require_lib2 = __commonJS((exports) => {
       let type = "ObjectExpression";
       if (isPattern) {
         type = "ObjectPattern";
-      } else if (isRecord6) {
+      } else if (isRecord7) {
         type = "RecordExpression";
       }
       return this.finishNode(node3, type);
@@ -217927,7 +218157,7 @@ var init_remark_gfm_eZN6yzWQ_es = __esm(() => {
   init_remark_gfm_BhnWr3yf_es();
 });
 
-// ../../packages/superdoc/dist/chunks/src-5wVLGLjJ.es.js
+// ../../packages/superdoc/dist/chunks/src-BJQRcFsD.es.js
 function deleteProps(obj, propOrProps) {
   const props = typeof propOrProps === "string" ? [propOrProps] : propOrProps;
   const removeNested = (target, pathParts, index2 = 0) => {
@@ -231407,8 +231637,8 @@ function projectTable(pmNode) {
       result.table.columns = columns;
   }
   if (pmAttrs?.needsTableStyleNormalization === true) {
-    const ext = isRecord6(result.ext) ? { ...result.ext } : {};
-    const superdocExt = isRecord6(ext.superdoc) ? { ...ext.superdoc } : {};
+    const ext = isRecord7(result.ext) ? { ...result.ext } : {};
+    const superdocExt = isRecord7(ext.superdoc) ? { ...ext.superdoc } : {};
     superdocExt.needsTableStyleNormalization = true;
     result.ext = {
       ...ext,
@@ -231880,7 +232110,7 @@ function resolveSdtNodeId(pmNode) {
     return String(id2);
   return typeof id2 === "string" && id2.length > 0 ? id2 : undefined;
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function extractTableProps(attrs, pmAttrs) {
@@ -231923,7 +232153,7 @@ function mapTableAlignmentToSD(value) {
   }
 }
 function extractTableWidth(width) {
-  if (!isRecord6(width))
+  if (!isRecord7(width))
     return;
   const type = typeof width.type === "string" ? width.type.toLowerCase() : undefined;
   const value = typeof width.value === "number" ? width.value : typeof width.width === "number" ? width.width : undefined;
@@ -306316,13 +306546,13 @@ menclose::after {
     return;
   console.log(...args$1);
 }, HEADER_FOOTER_INIT_BUDGET_MS = 200, MAX_ZOOM_WARNING_THRESHOLD = 10, MAX_SELECTION_RECTS_PER_USER = 100, SEMANTIC_RESIZE_DEBOUNCE_MS = 120, MIN_SEMANTIC_CONTENT_WIDTH_PX = 1, GLOBAL_PERFORMANCE, PresentationEditor, ICONS, TEXTS, tableActionsOptions;
-var init_src_5wVLGLjJ_es = __esm(() => {
+var init_src_BJQRcFsD_es = __esm(() => {
   init_rolldown_runtime_Bg48TavK_es();
-  init_SuperConverter_SvCYq2KK_es();
+  init_SuperConverter_UqLu6KQU_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
   init_uuid_qzgm05fK_es();
-  init_create_headless_toolbar_CAjlOJ3Q_es();
+  init_create_headless_toolbar_QcQvy_nD_es();
   init_constants_DrU4EASo_es();
   init_dist_B8HfvhaK_es();
   init_unified_Dsuw2be5_es();
@@ -344038,11 +344268,11 @@ function print() { __p += __j.call(arguments, '') }
   ];
 });
 
-// ../../packages/superdoc/dist/chunks/create-super-doc-ui-C2jsxhNG.es.js
+// ../../packages/superdoc/dist/chunks/create-super-doc-ui-FWAQonYc.es.js
 var MOD_ALIASES, ALT_ALIASES, CTRL_ALIASES, SHIFT_ALIASES, BUILTIN_CONTEXT_MENU_GROUPS, BUILTIN_GROUP_ORDER, RESERVED_PROXY_PROPERTY_NAMES, ALL_TOOLBAR_COMMAND_IDS, EMPTY_ACTIVE_IDS;
-var init_create_super_doc_ui_C2jsxhNG_es = __esm(() => {
-  init_SuperConverter_SvCYq2KK_es();
-  init_create_headless_toolbar_CAjlOJ3Q_es();
+var init_create_super_doc_ui_FWAQonYc_es = __esm(() => {
+  init_SuperConverter_UqLu6KQU_es();
+  init_create_headless_toolbar_QcQvy_nD_es();
   MOD_ALIASES = new Set([
     "Mod",
     "Meta",
@@ -344084,16 +344314,16 @@ var init_zipper_yaJVJ4z9_es = __esm(() => {
 
 // ../../packages/superdoc/dist/super-editor.es.js
 var init_super_editor_es = __esm(() => {
-  init_src_5wVLGLjJ_es();
-  init_SuperConverter_SvCYq2KK_es();
+  init_src_BJQRcFsD_es();
+  init_SuperConverter_UqLu6KQU_es();
   init_jszip_C49i9kUs_es();
   init_xml_js_CqGKpaft_es();
-  init_create_headless_toolbar_CAjlOJ3Q_es();
+  init_create_headless_toolbar_QcQvy_nD_es();
   init_constants_DrU4EASo_es();
   init_dist_B8HfvhaK_es();
   init_unified_Dsuw2be5_es();
   init_DocxZipper_CZMPWpOp_es();
-  init_create_super_doc_ui_C2jsxhNG_es();
+  init_create_super_doc_ui_FWAQonYc_es();
   init_ui_C5PAS9hY_es();
   init_eventemitter3_BnGqBE_Q_es();
   init_errors_CNaD6vcg_es();
@@ -393847,13 +394077,13 @@ var init_special_handlers = __esm(() => {
 });
 
 // src/lib/invoke-input.ts
-function isRecord7(value2) {
+function isRecord8(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
 function isTextAddressLike(value2) {
-  if (!isRecord7(value2) || value2.kind !== "text" || typeof value2.blockId !== "string")
+  if (!isRecord8(value2) || value2.kind !== "text" || typeof value2.blockId !== "string")
     return false;
-  if (!isRecord7(value2.range))
+  if (!isRecord8(value2.range))
     return false;
   return typeof value2.range.start === "number" && typeof value2.range.end === "number";
 }
@@ -393881,7 +394111,7 @@ function assertLegacySelectionTargetSupported(operationId, target2) {
   }
 }
 function normalizeFlatTargetFlags(operationId, apiInput) {
-  if (!isRecord7(apiInput))
+  if (!isRecord8(apiInput))
     return apiInput;
   if (apiInput.target !== undefined) {
     if (SELECTION_TARGET_OPERATIONS.has(operationId) && isTextAddressLike(apiInput.target)) {
@@ -397322,11 +397552,11 @@ var init_close = __esm(() => {
 });
 
 // src/commands/insert-inline-special.ts
-function isRecord8(value2) {
+function isRecord9(value2) {
   return typeof value2 === "object" && value2 != null && !Array.isArray(value2);
 }
 function isSelectionTarget3(value2) {
-  return isRecord8(value2) && value2.kind === "selection" && isRecord8(value2.start) && isRecord8(value2.end);
+  return isRecord9(value2) && value2.kind === "selection" && isRecord9(value2.start) && isRecord9(value2.end);
 }
 function isCollapsedTextSelectionTarget(target2) {
   return target2.start.kind === "text" && target2.end.kind === "text" && target2.start.blockId === target2.end.blockId && target2.start.offset === target2.end.offset;
@@ -397337,7 +397567,7 @@ function buildPrettyOutput3(kind2, revision, outputPath) {
 }
 async function resolveInsertionPoint(editor, input2, kind2) {
   const apiInput = extractInvokeInput("insert", input2);
-  if (!isRecord8(apiInput)) {
+  if (!isRecord9(apiInput)) {
     throw new CliError("INVALID_ARGUMENT", `insert ${COMMAND_BY_KIND[kind2].label}: invalid target input.`);
   }
   const ref4 = typeof apiInput.ref === "string" ? apiInput.ref : undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/cli",
-  "version": "0.12.0-next.1",
+  "version": "0.12.0-next.5",
   "type": "module",
   "bin": {
     "superdoc": "./dist/index.js"
@@ -24,21 +24,21 @@
     "@types/node": "22.19.2",
     "@types/ws": "^8.5.13",
     "typescript": "^5.9.2",
-    "@superdoc/pm-adapter": "0.0.0",
     "@superdoc/document-api": "0.0.1",
-    "superdoc": "1.34.0",
-    "@superdoc/super-editor": "0.0.1"
+    "@superdoc/super-editor": "0.0.1",
+    "@superdoc/pm-adapter": "0.0.0",
+    "superdoc": "1.34.0"
   },
   "module": "src/index.ts",
   "publishConfig": {
     "access": "public"
   },
   "optionalDependencies": {
-    "@superdoc-dev/cli-darwin-arm64": "0.12.0-next.1",
-    "@superdoc-dev/cli-darwin-x64": "0.12.0-next.1",
-    "@superdoc-dev/cli-linux-x64": "0.12.0-next.1",
-    "@superdoc-dev/cli-linux-arm64": "0.12.0-next.1",
-    "@superdoc-dev/cli-windows-x64": "0.12.0-next.1"
+    "@superdoc-dev/cli-darwin-arm64": "0.12.0-next.5",
+    "@superdoc-dev/cli-darwin-x64": "0.12.0-next.5",
+    "@superdoc-dev/cli-linux-arm64": "0.12.0-next.5",
+    "@superdoc-dev/cli-linux-x64": "0.12.0-next.5",
+    "@superdoc-dev/cli-windows-x64": "0.12.0-next.5"
   },
   "scripts": {
     "predev": "node scripts/ensure-superdoc-build.js",