@superdoc-dev/cli 0.2.0-next.86 → 0.2.0-next.87

package/dist/index.js

@@ -3549,6 +3549,216 @@ var init_operation_definitions = __esm(() => {
       referenceDocPath: "images/set-z-order.mdx",
       referenceGroup: "images"
     },
+    "images.scale": {
+      memberPath: "images.scale",
+      description: "Scale an image by a uniform factor applied to both dimensions.",
+      expectedResult: "Returns an ImagesMutationResult with the updated image address.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "non-idempotent",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/scale.mdx",
+      referenceGroup: "images"
+    },
+    "images.setLockAspectRatio": {
+      memberPath: "images.setLockAspectRatio",
+      description: "Lock or unlock the aspect ratio for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if already set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-lock-aspect-ratio.mdx",
+      referenceGroup: "images"
+    },
+    "images.rotate": {
+      memberPath: "images.rotate",
+      description: "Set the absolute rotation angle for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if already set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/rotate.mdx",
+      referenceGroup: "images"
+    },
+    "images.flip": {
+      memberPath: "images.flip",
+      description: "Set horizontal and/or vertical flip state for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if already set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/flip.mdx",
+      referenceGroup: "images"
+    },
+    "images.crop": {
+      memberPath: "images.crop",
+      description: "Apply rectangular edge-percentage crop to an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/crop.mdx",
+      referenceGroup: "images"
+    },
+    "images.resetCrop": {
+      memberPath: "images.resetCrop",
+      description: "Remove all cropping from an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if no crop is set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: T_IMAGE_COMMAND
+      }),
+      referenceDocPath: "images/reset-crop.mdx",
+      referenceGroup: "images"
+    },
+    "images.replaceSource": {
+      memberPath: "images.replaceSource",
+      description: "Replace the image source while preserving identity and placement.",
+      expectedResult: "Returns an ImagesMutationResult with the updated image address.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "non-idempotent",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/replace-source.mdx",
+      referenceGroup: "images"
+    },
+    "images.setAltText": {
+      memberPath: "images.setAltText",
+      description: "Set the accessibility description (alt text) for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-alt-text.mdx",
+      referenceGroup: "images"
+    },
+    "images.setDecorative": {
+      memberPath: "images.setDecorative",
+      description: "Mark or unmark an image as decorative.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-decorative.mdx",
+      referenceGroup: "images"
+    },
+    "images.setName": {
+      memberPath: "images.setName",
+      description: "Set the object name for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-name.mdx",
+      referenceGroup: "images"
+    },
+    "images.setHyperlink": {
+      memberPath: "images.setHyperlink",
+      description: "Set or remove the hyperlink attached to an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-hyperlink.mdx",
+      referenceGroup: "images"
+    },
+    "images.insertCaption": {
+      memberPath: "images.insertCaption",
+      description: "Insert a caption paragraph below the image.",
+      expectedResult: "Returns an ImagesMutationResult with the image address.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "non-idempotent",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/insert-caption.mdx",
+      referenceGroup: "images"
+    },
+    "images.updateCaption": {
+      memberPath: "images.updateCaption",
+      description: "Update the text of an existing caption paragraph.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if text unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/update-caption.mdx",
+      referenceGroup: "images"
+    },
+    "images.removeCaption": {
+      memberPath: "images.removeCaption",
+      description: "Remove the caption paragraph from below the image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if no caption exists.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: T_IMAGE_COMMAND
+      }),
+      referenceDocPath: "images/remove-caption.mdx",
+      referenceGroup: "images"
+    },
     "hyperlinks.list": {
       memberPath: "hyperlinks.list",
       description: "List all hyperlinks in the document, with optional filtering by href, anchor, or display text.",
@@ -4720,6 +4930,17 @@ function arraySchema(items) {
 function ref(name) {
   return { $ref: `#/$defs/${name}` };
 }
+function imagesMutationSchemaSet(inputSchema) {
+  return {
+    input: inputSchema,
+    output: objectSchema({ success: { type: "boolean" }, image: { type: "object" }, failure: { type: "object" } }),
+    success: objectSchema({ success: { const: true }, image: { type: "object" } }, ["success", "image"]),
+    failure: objectSchema({
+      success: { const: false },
+      failure: objectSchema({ code: { type: "string" }, message: { type: "string" } }, ["code", "message"])
+    }, ["success", "failure"])
+  };
+}
 function discoveryResultSchema(itemSchema, metaSchema) {
   const properties = {
     evaluatedRevision: { type: "string" },
@@ -7895,24 +8116,53 @@ var init_schemas = __esm(() => {
         failure: objectSchema({ code: { type: "string" }, message: { type: "string" } }, ["code", "message"])
       }, ["success", "failure"])
     },
-    "images.setZOrder": {
-      input: objectSchema({
-        imageId: { type: "string" },
-        zOrder: objectSchema({
-          relativeHeight: {
-            type: "integer",
-            minimum: Z_ORDER_RELATIVE_HEIGHT_MIN,
-            maximum: Z_ORDER_RELATIVE_HEIGHT_MAX
-          }
-        }, ["relativeHeight"])
-      }, ["imageId", "zOrder"]),
-      output: objectSchema({ success: { type: "boolean" }, image: { type: "object" }, failure: { type: "object" } }),
-      success: objectSchema({ success: { const: true }, image: { type: "object" } }, ["success", "image"]),
-      failure: objectSchema({
-        success: { const: false },
-        failure: objectSchema({ code: { type: "string" }, message: { type: "string" } }, ["code", "message"])
-      }, ["success", "failure"])
-    },
+    "images.setZOrder": imagesMutationSchemaSet(objectSchema({
+      imageId: { type: "string" },
+      zOrder: objectSchema({
+        relativeHeight: {
+          type: "integer",
+          minimum: Z_ORDER_RELATIVE_HEIGHT_MIN,
+          maximum: Z_ORDER_RELATIVE_HEIGHT_MAX
+        }
+      }, ["relativeHeight"])
+    }, ["imageId", "zOrder"])),
+    "images.scale": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, factor: { type: "number", exclusiveMinimum: 0 } }, [
+      "imageId",
+      "factor"
+    ])),
+    "images.setLockAspectRatio": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, locked: { type: "boolean" } }, ["imageId", "locked"])),
+    "images.rotate": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, angle: { type: "number", minimum: 0, maximum: 360 } }, [
+      "imageId",
+      "angle"
+    ])),
+    "images.flip": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, horizontal: { type: "boolean" }, vertical: { type: "boolean" } }, [
+      "imageId"
+    ])),
+    "images.crop": imagesMutationSchemaSet(objectSchema({
+      imageId: { type: "string" },
+      crop: objectSchema({
+        left: { type: "number", minimum: 0, maximum: 100 },
+        top: { type: "number", minimum: 0, maximum: 100 },
+        right: { type: "number", minimum: 0, maximum: 100 },
+        bottom: { type: "number", minimum: 0, maximum: 100 }
+      }, [])
+    }, ["imageId", "crop"])),
+    "images.resetCrop": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" } }, ["imageId"])),
+    "images.replaceSource": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, src: { type: "string" }, resetSize: { type: "boolean" } }, [
+      "imageId",
+      "src"
+    ])),
+    "images.setAltText": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, description: { type: "string" } }, ["imageId", "description"])),
+    "images.setDecorative": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, decorative: { type: "boolean" } }, ["imageId", "decorative"])),
+    "images.setName": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, name: { type: "string" } }, ["imageId", "name"])),
+    "images.setHyperlink": imagesMutationSchemaSet(objectSchema({
+      imageId: { type: "string" },
+      url: { type: ["string", "null"] },
+      tooltip: { type: "string" }
+    }, ["imageId", "url"])),
+    "images.insertCaption": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, text: { type: "string" } }, ["imageId", "text"])),
+    "images.updateCaption": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" }, text: { type: "string" } }, ["imageId", "text"])),
+    "images.removeCaption": imagesMutationSchemaSet(objectSchema({ imageId: { type: "string" } }, ["imageId"])),
     "hyperlinks.list": {
       input: objectSchema({
         within: nodeAddressSchema,
@@ -9183,6 +9433,20 @@ function buildDispatchTable(api) {
     "images.setPosition": (input, options) => api.images.setPosition(input, options),
     "images.setAnchorOptions": (input, options) => api.images.setAnchorOptions(input, options),
     "images.setZOrder": (input, options) => api.images.setZOrder(input, options),
+    "images.scale": (input, options) => api.images.scale(input, options),
+    "images.setLockAspectRatio": (input, options) => api.images.setLockAspectRatio(input, options),
+    "images.rotate": (input, options) => api.images.rotate(input, options),
+    "images.flip": (input, options) => api.images.flip(input, options),
+    "images.crop": (input, options) => api.images.crop(input, options),
+    "images.resetCrop": (input, options) => api.images.resetCrop(input, options),
+    "images.replaceSource": (input, options) => api.images.replaceSource(input, options),
+    "images.setAltText": (input, options) => api.images.setAltText(input, options),
+    "images.setDecorative": (input, options) => api.images.setDecorative(input, options),
+    "images.setName": (input, options) => api.images.setName(input, options),
+    "images.setHyperlink": (input, options) => api.images.setHyperlink(input, options),
+    "images.insertCaption": (input, options) => api.images.insertCaption(input, options),
+    "images.updateCaption": (input, options) => api.images.updateCaption(input, options),
+    "images.removeCaption": (input, options) => api.images.removeCaption(input, options),
     "hyperlinks.list": (input) => api.hyperlinks.list(input),
     "hyperlinks.get": (input) => api.hyperlinks.get(input),
     "hyperlinks.wrap": (input, options) => api.hyperlinks.wrap(input, options),
@@ -9738,6 +10002,142 @@ function executeImagesSetZOrder(adapter, input, options) {
   requireUnsignedInt32(input.zOrder.relativeHeight, "zOrder.relativeHeight");
   return adapter.setZOrder(input, options);
 }
+function executeImagesScale(adapter, input, options) {
+  requireImageId(input);
+  if (typeof input.factor !== "number" || !Number.isFinite(input.factor) || input.factor <= 0) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.scale requires factor as a finite positive number.", {
+      field: "factor",
+      value: input.factor
+    });
+  }
+  return adapter.scale(input, options);
+}
+function executeImagesSetLockAspectRatio(adapter, input, options) {
+  requireImageId(input);
+  if (typeof input.locked !== "boolean") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.setLockAspectRatio requires locked as a boolean.", {
+      field: "locked"
+    });
+  }
+  return adapter.setLockAspectRatio(input, options);
+}
+function executeImagesRotate(adapter, input, options) {
+  requireImageId(input);
+  if (typeof input.angle !== "number" || !Number.isFinite(input.angle) || input.angle < 0 || input.angle > 360) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.rotate requires angle as a number in [0, 360].", {
+      field: "angle",
+      value: input.angle
+    });
+  }
+  return adapter.rotate(input, options);
+}
+function executeImagesFlip(adapter, input, options) {
+  requireImageId(input);
+  if (input.horizontal === undefined && input.vertical === undefined) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.flip requires at least one of horizontal or vertical.", { field: "horizontal|vertical" });
+  }
+  if (input.horizontal !== undefined && typeof input.horizontal !== "boolean") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.flip horizontal must be a boolean.", {
+      field: "horizontal"
+    });
+  }
+  if (input.vertical !== undefined && typeof input.vertical !== "boolean") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.flip vertical must be a boolean.", {
+      field: "vertical"
+    });
+  }
+  return adapter.flip(input, options);
+}
+function executeImagesCrop(adapter, input, options) {
+  requireImageId(input);
+  if (!input.crop || typeof input.crop !== "object") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.crop requires a crop object.", { field: "crop" });
+  }
+  const { left = 0, top = 0, right = 0, bottom = 0 } = input.crop;
+  for (const [name, value] of Object.entries({ left, top, right, bottom })) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0 || value > 100) {
+      throw new DocumentApiValidationError("INVALID_INPUT", `crop.${name} must be a number in [0, 100].`, {
+        field: `crop.${name}`,
+        value
+      });
+    }
+  }
+  if (left + right >= 100) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "crop.left + crop.right must be less than 100.", {
+      field: "crop"
+    });
+  }
+  if (top + bottom >= 100) {
+    throw new DocumentApiValidationError("INVALID_INPUT", "crop.top + crop.bottom must be less than 100.", {
+      field: "crop"
+    });
+  }
+  return adapter.crop(input, options);
+}
+function executeImagesResetCrop(adapter, input, options) {
+  requireImageId(input);
+  return adapter.resetCrop(input, options);
+}
+function executeImagesReplaceSource(adapter, input, options) {
+  requireImageId(input);
+  requireString(input.src, "src");
+  return adapter.replaceSource(input, options);
+}
+function executeImagesSetAltText(adapter, input, options) {
+  requireImageId(input);
+  if (typeof input.description !== "string") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.setAltText requires description as a string.", {
+      field: "description"
+    });
+  }
+  return adapter.setAltText(input, options);
+}
+function executeImagesSetDecorative(adapter, input, options) {
+  requireImageId(input);
+  if (typeof input.decorative !== "boolean") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.setDecorative requires decorative as a boolean.", {
+      field: "decorative"
+    });
+  }
+  return adapter.setDecorative(input, options);
+}
+function executeImagesSetName(adapter, input, options) {
+  requireImageId(input);
+  if (typeof input.name !== "string") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.setName requires name as a string.", {
+      field: "name"
+    });
+  }
+  return adapter.setName(input, options);
+}
+function executeImagesSetHyperlink(adapter, input, options) {
+  requireImageId(input);
+  if (input.url !== null && typeof input.url !== "string") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.setHyperlink requires url as a string or null.", {
+      field: "url"
+    });
+  }
+  if (input.tooltip !== undefined && typeof input.tooltip !== "string") {
+    throw new DocumentApiValidationError("INVALID_INPUT", "images.setHyperlink tooltip must be a string.", {
+      field: "tooltip"
+    });
+  }
+  return adapter.setHyperlink(input, options);
+}
+function executeImagesInsertCaption(adapter, input, options) {
+  requireImageId(input);
+  requireString(input.text, "text");
+  return adapter.insertCaption(input, options);
+}
+function executeImagesUpdateCaption(adapter, input, options) {
+  requireImageId(input);
+  requireString(input.text, "text");
+  return adapter.updateCaption(input, options);
+}
+function executeImagesRemoveCaption(adapter, input, options) {
+  requireImageId(input);
+  return adapter.removeCaption(input, options);
+}
 function executeCreateImage(adapter, input, options) {
   requireString(input?.src, "src");
   return adapter.image(input, options);
@@ -10157,6 +10557,48 @@ function createDocumentApi(adapters) {
       },
       setZOrder(input, options) {
         return executeImagesSetZOrder(adapters.images, input, options);
+      },
+      scale(input, options) {
+        return executeImagesScale(adapters.images, input, options);
+      },
+      setLockAspectRatio(input, options) {
+        return executeImagesSetLockAspectRatio(adapters.images, input, options);
+      },
+      rotate(input, options) {
+        return executeImagesRotate(adapters.images, input, options);
+      },
+      flip(input, options) {
+        return executeImagesFlip(adapters.images, input, options);
+      },
+      crop(input, options) {
+        return executeImagesCrop(adapters.images, input, options);
+      },
+      resetCrop(input, options) {
+        return executeImagesResetCrop(adapters.images, input, options);
+      },
+      replaceSource(input, options) {
+        return executeImagesReplaceSource(adapters.images, input, options);
+      },
+      setAltText(input, options) {
+        return executeImagesSetAltText(adapters.images, input, options);
+      },
+      setDecorative(input, options) {
+        return executeImagesSetDecorative(adapters.images, input, options);
+      },
+      setName(input, options) {
+        return executeImagesSetName(adapters.images, input, options);
+      },
+      setHyperlink(input, options) {
+        return executeImagesSetHyperlink(adapters.images, input, options);
+      },
+      insertCaption(input, options) {
+        return executeImagesInsertCaption(adapters.images, input, options);
+      },
+      updateCaption(input, options) {
+        return executeImagesUpdateCaption(adapters.images, input, options);
+      },
+      removeCaption(input, options) {
+        return executeImagesRemoveCaption(adapters.images, input, options);
       }
     },
     lists: {
@@ -32778,7 +33220,7 @@ var init_remark_gfm_z_sDF4ss_es = __esm(() => {
   emptyOptions2 = {};
 });
 
-// ../../packages/superdoc/dist/chunks/SuperConverter-C3jSWLmj.es.js
+// ../../packages/superdoc/dist/chunks/SuperConverter-BcmJ8-gc.es.js
 function getExtensionConfigField(extension$1, field, context = { name: "" }) {
   const fieldValue = extension$1.config[field];
   if (typeof fieldValue === "function")
@@ -34533,6 +34975,27 @@ function arraySchema2(items) {
 function ref2(name) {
   return { $ref: `#/$defs/${name}` };
 }
+function imagesMutationSchemaSet2(inputSchema) {
+  return {
+    input: inputSchema,
+    output: objectSchema2({
+      success: { type: "boolean" },
+      image: { type: "object" },
+      failure: { type: "object" }
+    }),
+    success: objectSchema2({
+      success: { const: true },
+      image: { type: "object" }
+    }, ["success", "image"]),
+    failure: objectSchema2({
+      success: { const: false },
+      failure: objectSchema2({
+        code: { type: "string" },
+        message: { type: "string" }
+      }, ["code", "message"])
+    }, ["success", "failure"])
+  };
+}
 function discoveryResultSchema2(itemSchema, metaSchema) {
   const properties = {
     evaluatedRevision: { type: "string" },
@@ -35554,6 +36017,20 @@ function buildDispatchTable2(api) {
     "images.setPosition": (input, options) => api.images.setPosition(input, options),
     "images.setAnchorOptions": (input, options) => api.images.setAnchorOptions(input, options),
     "images.setZOrder": (input, options) => api.images.setZOrder(input, options),
+    "images.scale": (input, options) => api.images.scale(input, options),
+    "images.setLockAspectRatio": (input, options) => api.images.setLockAspectRatio(input, options),
+    "images.rotate": (input, options) => api.images.rotate(input, options),
+    "images.flip": (input, options) => api.images.flip(input, options),
+    "images.crop": (input, options) => api.images.crop(input, options),
+    "images.resetCrop": (input, options) => api.images.resetCrop(input, options),
+    "images.replaceSource": (input, options) => api.images.replaceSource(input, options),
+    "images.setAltText": (input, options) => api.images.setAltText(input, options),
+    "images.setDecorative": (input, options) => api.images.setDecorative(input, options),
+    "images.setName": (input, options) => api.images.setName(input, options),
+    "images.setHyperlink": (input, options) => api.images.setHyperlink(input, options),
+    "images.insertCaption": (input, options) => api.images.insertCaption(input, options),
+    "images.updateCaption": (input, options) => api.images.updateCaption(input, options),
+    "images.removeCaption": (input, options) => api.images.removeCaption(input, options),
     "hyperlinks.list": (input) => api.hyperlinks.list(input),
     "hyperlinks.get": (input) => api.hyperlinks.get(input),
     "hyperlinks.wrap": (input, options) => api.hyperlinks.wrap(input, options),
@@ -36016,6 +36493,111 @@ function executeImagesSetZOrder2(adapter, input, options) {
   requireUnsignedInt322(input.zOrder.relativeHeight, "zOrder.relativeHeight");
   return adapter.setZOrder(input, options);
 }
+function executeImagesScale2(adapter, input, options) {
+  requireImageId2(input);
+  if (typeof input.factor !== "number" || !Number.isFinite(input.factor) || input.factor <= 0)
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.scale requires factor as a finite positive number.", {
+      field: "factor",
+      value: input.factor
+    });
+  return adapter.scale(input, options);
+}
+function executeImagesSetLockAspectRatio2(adapter, input, options) {
+  requireImageId2(input);
+  if (typeof input.locked !== "boolean")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.setLockAspectRatio requires locked as a boolean.", { field: "locked" });
+  return adapter.setLockAspectRatio(input, options);
+}
+function executeImagesRotate2(adapter, input, options) {
+  requireImageId2(input);
+  if (typeof input.angle !== "number" || !Number.isFinite(input.angle) || input.angle < 0 || input.angle > 360)
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.rotate requires angle as a number in [0, 360].", {
+      field: "angle",
+      value: input.angle
+    });
+  return adapter.rotate(input, options);
+}
+function executeImagesFlip2(adapter, input, options) {
+  requireImageId2(input);
+  if (input.horizontal === undefined && input.vertical === undefined)
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.flip requires at least one of horizontal or vertical.", { field: "horizontal|vertical" });
+  if (input.horizontal !== undefined && typeof input.horizontal !== "boolean")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.flip horizontal must be a boolean.", { field: "horizontal" });
+  if (input.vertical !== undefined && typeof input.vertical !== "boolean")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.flip vertical must be a boolean.", { field: "vertical" });
+  return adapter.flip(input, options);
+}
+function executeImagesCrop2(adapter, input, options) {
+  requireImageId2(input);
+  if (!input.crop || typeof input.crop !== "object")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.crop requires a crop object.", { field: "crop" });
+  const { left = 0, top = 0, right = 0, bottom = 0 } = input.crop;
+  for (const [name, value] of Object.entries({
+    left,
+    top,
+    right,
+    bottom
+  }))
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0 || value > 100)
+      throw new DocumentApiValidationError2("INVALID_INPUT", `crop.${name} must be a number in [0, 100].`, {
+        field: `crop.${name}`,
+        value
+      });
+  if (left + right >= 100)
+    throw new DocumentApiValidationError2("INVALID_INPUT", "crop.left + crop.right must be less than 100.", { field: "crop" });
+  if (top + bottom >= 100)
+    throw new DocumentApiValidationError2("INVALID_INPUT", "crop.top + crop.bottom must be less than 100.", { field: "crop" });
+  return adapter.crop(input, options);
+}
+function executeImagesResetCrop2(adapter, input, options) {
+  requireImageId2(input);
+  return adapter.resetCrop(input, options);
+}
+function executeImagesReplaceSource2(adapter, input, options) {
+  requireImageId2(input);
+  requireString2(input.src, "src");
+  return adapter.replaceSource(input, options);
+}
+function executeImagesSetAltText2(adapter, input, options) {
+  requireImageId2(input);
+  if (typeof input.description !== "string")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.setAltText requires description as a string.", { field: "description" });
+  return adapter.setAltText(input, options);
+}
+function executeImagesSetDecorative2(adapter, input, options) {
+  requireImageId2(input);
+  if (typeof input.decorative !== "boolean")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.setDecorative requires decorative as a boolean.", { field: "decorative" });
+  return adapter.setDecorative(input, options);
+}
+function executeImagesSetName2(adapter, input, options) {
+  requireImageId2(input);
+  if (typeof input.name !== "string")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.setName requires name as a string.", { field: "name" });
+  return adapter.setName(input, options);
+}
+function executeImagesSetHyperlink2(adapter, input, options) {
+  requireImageId2(input);
+  if (input.url !== null && typeof input.url !== "string")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.setHyperlink requires url as a string or null.", { field: "url" });
+  if (input.tooltip !== undefined && typeof input.tooltip !== "string")
+    throw new DocumentApiValidationError2("INVALID_INPUT", "images.setHyperlink tooltip must be a string.", { field: "tooltip" });
+  return adapter.setHyperlink(input, options);
+}
+function executeImagesInsertCaption2(adapter, input, options) {
+  requireImageId2(input);
+  requireString2(input.text, "text");
+  return adapter.insertCaption(input, options);
+}
+function executeImagesUpdateCaption2(adapter, input, options) {
+  requireImageId2(input);
+  requireString2(input.text, "text");
+  return adapter.updateCaption(input, options);
+}
+function executeImagesRemoveCaption2(adapter, input, options) {
+  requireImageId2(input);
+  return adapter.removeCaption(input, options);
+}
 function executeCreateImage2(adapter, input, options) {
   requireString2(input?.src, "src");
   return adapter.image(input, options);
@@ -36379,6 +36961,48 @@ function createDocumentApi2(adapters) {
       },
       setZOrder(input, options) {
         return executeImagesSetZOrder2(adapters.images, input, options);
+      },
+      scale(input, options) {
+        return executeImagesScale2(adapters.images, input, options);
+      },
+      setLockAspectRatio(input, options) {
+        return executeImagesSetLockAspectRatio2(adapters.images, input, options);
+      },
+      rotate(input, options) {
+        return executeImagesRotate2(adapters.images, input, options);
+      },
+      flip(input, options) {
+        return executeImagesFlip2(adapters.images, input, options);
+      },
+      crop(input, options) {
+        return executeImagesCrop2(adapters.images, input, options);
+      },
+      resetCrop(input, options) {
+        return executeImagesResetCrop2(adapters.images, input, options);
+      },
+      replaceSource(input, options) {
+        return executeImagesReplaceSource2(adapters.images, input, options);
+      },
+      setAltText(input, options) {
+        return executeImagesSetAltText2(adapters.images, input, options);
+      },
+      setDecorative(input, options) {
+        return executeImagesSetDecorative2(adapters.images, input, options);
+      },
+      setName(input, options) {
+        return executeImagesSetName2(adapters.images, input, options);
+      },
+      setHyperlink(input, options) {
+        return executeImagesSetHyperlink2(adapters.images, input, options);
+      },
+      insertCaption(input, options) {
+        return executeImagesInsertCaption2(adapters.images, input, options);
+      },
+      updateCaption(input, options) {
+        return executeImagesUpdateCaption2(adapters.images, input, options);
+      },
+      removeCaption(input, options) {
+        return executeImagesRemoveCaption2(adapters.images, input, options);
       }
     },
     lists: {
@@ -41292,6 +41916,35 @@ function handleImageNode(node3, params, isAnchor) {
         horizontalFlip: xfrm.attributes["flipH"] === "1"
       };
   }
+  const nvPicPr = picture.elements.find((el) => el.name === "pic:nvPicPr");
+  const picLocks = nvPicPr?.elements?.find((el) => el.name === "pic:cNvPicPr")?.elements?.find((el) => el.name === "a:picLocks");
+  const lockAspectRatio = picLocks ? picLocks.attributes?.["noChangeAspect"] === "1" || picLocks.attributes?.["noChangeAspect"] === 1 : false;
+  const hlinkClick = nvPicPr?.elements?.find((el) => el.name === "pic:cNvPr")?.elements?.find((el) => el.name === "a:hlinkClick") || docPr?.elements?.find((el) => el.name === "a:hlinkClick");
+  let hyperlink = null;
+  if (hlinkClick?.attributes?.["r:id"]) {
+    const hlinkRId = hlinkClick.attributes["r:id"];
+    let hlinkRels = docx[`word/_rels/${filename || "document.xml"}.rels`];
+    if (!hlinkRels)
+      hlinkRels = docx[`word/_rels/document.xml.rels`];
+    const hlinkRel = hlinkRels?.elements?.find((el) => el.name === "Relationships")?.elements?.find((el) => el.attributes?.["Id"] === hlinkRId);
+    if (hlinkRel?.attributes?.["Target"]) {
+      hyperlink = { url: hlinkRel.attributes["Target"] };
+      if (hlinkClick.attributes?.["tooltip"])
+        hyperlink.tooltip = hlinkClick.attributes["tooltip"];
+    }
+  }
+  let decorative = false;
+  const docPrExtLst = docPr?.elements?.find((el) => el.name === "a:extLst");
+  if (docPrExtLst)
+    for (const ext of docPrExtLst.elements || []) {
+      if (ext.name !== "a:ext")
+        continue;
+      const decEl = ext.elements?.find((el) => el.name === "adec:decorative" || el.name === "a16:decorative");
+      if (decEl && (decEl.attributes?.["val"] === "1" || decEl.attributes?.["val"] === 1)) {
+        decorative = true;
+        break;
+      }
+    }
   const { attributes: blipAttributes = {} } = blip;
   const rEmbed = blipAttributes["r:embed"];
   if (!rEmbed)
@@ -41380,6 +42033,9 @@ function handleImageNode(node3, params, isAnchor) {
       },
       originalAttributes: node3.attributes,
       rId: relAttributes["Id"],
+      lockAspectRatio,
+      decorative,
+      hyperlink,
       ...order2.length ? { drawingChildOrder: order2 } : {},
       ...originalChildren.length ? { originalDrawingChildren: originalChildren } : {},
       ...hasGrayscale ? { grayscale: true } : {}
@@ -47827,6 +48483,96 @@ function readImageDimensionsFromDataUri(dataUri) {
     return null;
   }
 }
+function resolveHyperlinkRId(attrs, params) {
+  if (!attrs.hyperlink?.url || !params)
+    return null;
+  return addHyperlinkRelationship(params, attrs.hyperlink.url);
+}
+function buildHlinkClickElement(attrs, hlinkRId) {
+  if (!hlinkRId)
+    return null;
+  const hlinkAttrs = { "r:id": hlinkRId };
+  if (attrs.hyperlink?.tooltip)
+    hlinkAttrs.tooltip = attrs.hyperlink.tooltip;
+  return {
+    name: "a:hlinkClick",
+    attributes: hlinkAttrs
+  };
+}
+function buildDocPrElement(attrs, imageName, hlinkRId) {
+  const docPrAttrs = {
+    id: attrs.id || 0,
+    name: attrs.alt || `Picture ${imageName}`
+  };
+  if (!attrs.decorative && attrs.title)
+    docPrAttrs.descr = attrs.title;
+  const children = [];
+  const hlinkEl = buildHlinkClickElement(attrs, hlinkRId);
+  if (hlinkEl)
+    children.push(hlinkEl);
+  if (attrs.decorative)
+    children.push({
+      name: "a:extLst",
+      elements: [{
+        name: "a:ext",
+        attributes: { uri: DECORATIVE_EXT_URI },
+        elements: [{
+          name: "adec:decorative",
+          attributes: {
+            "xmlns:adec": DECORATIVE_NAMESPACE,
+            val: "1"
+          }
+        }]
+      }]
+    });
+  return {
+    name: "wp:docPr",
+    attributes: docPrAttrs,
+    ...children.length ? { elements: children } : {}
+  };
+}
+function buildNvPicPrElement(attrs, imageName, hlinkRId) {
+  const cNvPrChildren = [];
+  const hlinkEl = buildHlinkClickElement(attrs, hlinkRId);
+  if (hlinkEl)
+    cNvPrChildren.push(hlinkEl);
+  return {
+    name: "pic:nvPicPr",
+    elements: [{
+      name: "pic:cNvPr",
+      attributes: {
+        id: attrs.id || 0,
+        name: attrs.alt || `Picture ${imageName}`
+      },
+      ...cNvPrChildren.length ? { elements: cNvPrChildren } : {}
+    }, {
+      name: "pic:cNvPicPr",
+      elements: [{
+        name: "a:picLocks",
+        attributes: {
+          ...attrs.lockAspectRatio ? { noChangeAspect: 1 } : {},
+          noChangeArrowheads: 1
+        }
+      }]
+    }]
+  };
+}
+function addHyperlinkRelationship(params, url) {
+  const newId = `rId${generateDocxRandomId(8)}`;
+  if (!params.relationships || !Array.isArray(params.relationships))
+    params.relationships = [];
+  params.relationships.push({
+    type: "element",
+    name: "Relationship",
+    attributes: {
+      Id: newId,
+      Type: HYPERLINK_REL_TYPE,
+      Target: url,
+      TargetMode: "External"
+    }
+  });
+  return newId;
+}
 function isFinitePositive(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0;
 }
@@ -60895,7 +61641,7 @@ var isRegExp = (value) => {
     tr,
     changed: true
   };
-}, helpers_exports, translateImageNode = (params) => {
+}, helpers_exports, DECORATIVE_EXT_URI = "{C183D7F6-B498-43B3-948B-1728B52AA6E4}", DECORATIVE_NAMESPACE = "http://schemas.microsoft.com/office/drawing/2017/decorative", HYPERLINK_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", translateImageNode = (params) => {
   const { node: { attrs = {} }, tableCell, imageSize } = params;
   let imageId = attrs.rId;
   const src = attrs.originalSrc || attrs.src || attrs.imageSrc;
@@ -60981,6 +61727,7 @@ var isRegExp = (value) => {
   const rawSrcRect = attrs.rawSrcRect;
   const drawingXmlns = "http://schemas.openxmlformats.org/drawingml/2006/main";
   const pictureXmlns = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+  const hlinkRId = resolveHyperlinkRId(attrs, params);
   return {
     attributes: inlineAttrs,
     elements: [
@@ -60995,20 +61742,14 @@ var isRegExp = (value) => {
         name: "wp:effectExtent",
         attributes: effectExtentAttrs
       },
-      {
-        name: "wp:docPr",
-        attributes: {
-          id: attrs.id || 0,
-          name: attrs.alt || `Picture ${imageName}`
-        }
-      },
+      buildDocPrElement(attrs, imageName, hlinkRId),
       {
         name: "wp:cNvGraphicFramePr",
         elements: [{
           name: "a:graphicFrameLocks",
           attributes: {
             "xmlns:a": drawingXmlns,
-            noChangeAspect: 1
+            ...attrs.lockAspectRatio ? { noChangeAspect: 1 } : {}
           }
         }]
       },
@@ -61022,25 +61763,7 @@ var isRegExp = (value) => {
             name: "pic:pic",
             attributes: { "xmlns:pic": pictureXmlns },
             elements: [
-              {
-                name: "pic:nvPicPr",
-                elements: [{
-                  name: "pic:cNvPr",
-                  attributes: {
-                    id: attrs.id || 0,
-                    name: attrs.title || `Picture ${imageName}`
-                  }
-                }, {
-                  name: "pic:cNvPicPr",
-                  elements: [{
-                    name: "a:picLocks",
-                    attributes: {
-                      noChangeAspect: 1,
-                      noChangeArrowheads: 1
-                    }
-                  }]
-                }]
-              },
+              buildNvPicPrElement(attrs, imageName, hlinkRId),
               {
                 name: "pic:blipFill",
                 elements: [
@@ -64289,7 +65012,7 @@ var isRegExp = (value) => {
       state.kern = kernNode.attributes["w:val"];
   }
 }, SuperConverter;
-var init_SuperConverter_C3jSWLmj_es = __esm(() => {
+var init_SuperConverter_BcmJ8_gc_es = __esm(() => {
   init_rolldown_runtime_B2q5OVn9_es();
   init_jszip_ChlR43oI_es();
   init_xml_js_DLE8mr0n_es();
@@ -69713,6 +70436,216 @@ var init_SuperConverter_C3jSWLmj_es = __esm(() => {
       referenceDocPath: "images/set-z-order.mdx",
       referenceGroup: "images"
     },
+    "images.scale": {
+      memberPath: "images.scale",
+      description: "Scale an image by a uniform factor applied to both dimensions.",
+      expectedResult: "Returns an ImagesMutationResult with the updated image address.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "non-idempotent",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/scale.mdx",
+      referenceGroup: "images"
+    },
+    "images.setLockAspectRatio": {
+      memberPath: "images.setLockAspectRatio",
+      description: "Lock or unlock the aspect ratio for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if already set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-lock-aspect-ratio.mdx",
+      referenceGroup: "images"
+    },
+    "images.rotate": {
+      memberPath: "images.rotate",
+      description: "Set the absolute rotation angle for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if already set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/rotate.mdx",
+      referenceGroup: "images"
+    },
+    "images.flip": {
+      memberPath: "images.flip",
+      description: "Set horizontal and/or vertical flip state for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if already set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/flip.mdx",
+      referenceGroup: "images"
+    },
+    "images.crop": {
+      memberPath: "images.crop",
+      description: "Apply rectangular edge-percentage crop to an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/crop.mdx",
+      referenceGroup: "images"
+    },
+    "images.resetCrop": {
+      memberPath: "images.resetCrop",
+      description: "Remove all cropping from an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if no crop is set.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: T_IMAGE_COMMAND2
+      }),
+      referenceDocPath: "images/reset-crop.mdx",
+      referenceGroup: "images"
+    },
+    "images.replaceSource": {
+      memberPath: "images.replaceSource",
+      description: "Replace the image source while preserving identity and placement.",
+      expectedResult: "Returns an ImagesMutationResult with the updated image address.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "non-idempotent",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/replace-source.mdx",
+      referenceGroup: "images"
+    },
+    "images.setAltText": {
+      memberPath: "images.setAltText",
+      description: "Set the accessibility description (alt text) for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-alt-text.mdx",
+      referenceGroup: "images"
+    },
+    "images.setDecorative": {
+      memberPath: "images.setDecorative",
+      description: "Mark or unmark an image as decorative.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-decorative.mdx",
+      referenceGroup: "images"
+    },
+    "images.setName": {
+      memberPath: "images.setName",
+      description: "Set the object name for an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-name.mdx",
+      referenceGroup: "images"
+    },
+    "images.setHyperlink": {
+      memberPath: "images.setHyperlink",
+      description: "Set or remove the hyperlink attached to an image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/set-hyperlink.mdx",
+      referenceGroup: "images"
+    },
+    "images.insertCaption": {
+      memberPath: "images.insertCaption",
+      description: "Insert a caption paragraph below the image.",
+      expectedResult: "Returns an ImagesMutationResult with the image address.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "non-idempotent",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/insert-caption.mdx",
+      referenceGroup: "images"
+    },
+    "images.updateCaption": {
+      memberPath: "images.updateCaption",
+      description: "Update the text of an existing caption paragraph.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if text unchanged.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: [...T_IMAGE_COMMAND2, "INVALID_INPUT"]
+      }),
+      referenceDocPath: "images/update-caption.mdx",
+      referenceGroup: "images"
+    },
+    "images.removeCaption": {
+      memberPath: "images.removeCaption",
+      description: "Remove the caption paragraph from below the image.",
+      expectedResult: "Returns an ImagesMutationResult; reports NO_OP if no caption exists.",
+      requiresDocumentContext: true,
+      metadata: mutationOperation2({
+        idempotency: "conditional",
+        supportsDryRun: true,
+        supportsTrackedMode: false,
+        possibleFailureCodes: ["NO_OP"],
+        throws: T_IMAGE_COMMAND2
+      }),
+      referenceDocPath: "images/remove-caption.mdx",
+      referenceGroup: "images"
+    },
     "hyperlinks.list": {
       memberPath: "hyperlinks.list",
       description: "List all hyperlinks in the document, with optional filtering by href, anchor, or display text.",
@@ -73596,27 +74529,81 @@ var init_SuperConverter_C3jSWLmj_es = __esm(() => {
       code: { type: "string" },
       message: { type: "string" }
     }, ["code", "message"])
-  }, ["success", "failure"]), objectSchema2({
+  }, ["success", "failure"]), imagesMutationSchemaSet2(objectSchema2({
     imageId: { type: "string" },
     zOrder: objectSchema2({ relativeHeight: {
       type: "integer",
       minimum: 0,
       maximum: Z_ORDER_RELATIVE_HEIGHT_MAX2
     } }, ["relativeHeight"])
-  }, ["imageId", "zOrder"]), objectSchema2({
-    success: { type: "boolean" },
-    image: { type: "object" },
-    failure: { type: "object" }
-  }), objectSchema2({
-    success: { const: true },
-    image: { type: "object" }
-  }, ["success", "image"]), objectSchema2({
-    success: { const: false },
-    failure: objectSchema2({
-      code: { type: "string" },
-      message: { type: "string" }
-    }, ["code", "message"])
-  }, ["success", "failure"]), objectSchema2({
+  }, ["imageId", "zOrder"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    factor: {
+      type: "number",
+      exclusiveMinimum: 0
+    }
+  }, ["imageId", "factor"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    locked: { type: "boolean" }
+  }, ["imageId", "locked"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    angle: {
+      type: "number",
+      minimum: 0,
+      maximum: 360
+    }
+  }, ["imageId", "angle"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    horizontal: { type: "boolean" },
+    vertical: { type: "boolean" }
+  }, ["imageId"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    crop: objectSchema2({
+      left: {
+        type: "number",
+        minimum: 0,
+        maximum: 100
+      },
+      top: {
+        type: "number",
+        minimum: 0,
+        maximum: 100
+      },
+      right: {
+        type: "number",
+        minimum: 0,
+        maximum: 100
+      },
+      bottom: {
+        type: "number",
+        minimum: 0,
+        maximum: 100
+      }
+    }, [])
+  }, ["imageId", "crop"])), imagesMutationSchemaSet2(objectSchema2({ imageId: { type: "string" } }, ["imageId"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    src: { type: "string" },
+    resetSize: { type: "boolean" }
+  }, ["imageId", "src"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    description: { type: "string" }
+  }, ["imageId", "description"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    decorative: { type: "boolean" }
+  }, ["imageId", "decorative"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    name: { type: "string" }
+  }, ["imageId", "name"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    url: { type: ["string", "null"] },
+    tooltip: { type: "string" }
+  }, ["imageId", "url"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    text: { type: "string" }
+  }, ["imageId", "text"])), imagesMutationSchemaSet2(objectSchema2({
+    imageId: { type: "string" },
+    text: { type: "string" }
+  }, ["imageId", "text"])), imagesMutationSchemaSet2(objectSchema2({ imageId: { type: "string" } }, ["imageId"])), objectSchema2({
     within: nodeAddressSchema2,
     hrefPattern: { type: "string" },
     anchor: { type: "string" },
@@ -120758,9 +121745,9 @@ var init_remark_gfm_CjV8kaUy_es = __esm(() => {
   init_remark_gfm_z_sDF4ss_es();
 });
 
-// ../../packages/superdoc/dist/chunks/src-nq0HTKfv.es.js
-var exports_src_nq0HTKfv_es = {};
-__export(exports_src_nq0HTKfv_es, {
+// ../../packages/superdoc/dist/chunks/src-LqliKMID.es.js
+var exports_src_LqliKMID_es = {};
+__export(exports_src_LqliKMID_es, {
   zt: () => defineMark,
   z: () => cM,
   yt: () => removeAwarenessStates,
@@ -128697,9 +129684,47 @@ function mapTableOfContentsNode(candidate) {
     }
   };
 }
-function buildImageInfo(attrs, kind) {
+function parseCropFromClipPath$1(clipPath) {
+  if (!clipPath)
+    return null;
+  const match$1 = clipPath.match(/^inset\(\s*([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s*\)$/);
+  if (!match$1)
+    return null;
+  return {
+    top: parseFloat(match$1[1]),
+    right: parseFloat(match$1[2]),
+    bottom: parseFloat(match$1[3]),
+    left: parseFloat(match$1[4])
+  };
+}
+function detectCaptionSibling(doc$2, imagePos) {
+  if (!doc$2)
+    return false;
+  try {
+    const $pos = doc$2.resolve(imagePos);
+    const parentDepth = $pos.depth - 1;
+    if (parentDepth < 0)
+      return false;
+    const afterParentPos = $pos.before(parentDepth + 1) + $pos.node(parentDepth + 1).nodeSize;
+    if (afterParentPos >= doc$2.content.size)
+      return false;
+    const nextNode = doc$2.nodeAt(afterParentPos);
+    if (!nextNode || nextNode.type.name !== "paragraph")
+      return false;
+    return nextNode.attrs?.paragraphProperties?.styleId === "Caption";
+  } catch {
+    return false;
+  }
+}
+function buildImageInfo(attrs, kind, doc$2, pos) {
   const isFloating = Boolean(attrs?.isAnchor);
   const wrapObj = attrs?.wrap;
+  const td = attrs?.transformData;
+  const transform = td && (td.rotation || td.verticalFlip || td.horizontalFlip) ? {
+    rotation: td.rotation ?? undefined,
+    verticalFlip: td.verticalFlip ?? undefined,
+    horizontalFlip: td.horizontalFlip ?? undefined
+  } : null;
   return {
     nodeType: "image",
     kind,
@@ -128718,7 +129743,15 @@ function buildImageInfo(attrs, kind) {
       },
       anchorData: attrs?.anchorData ?? null,
       marginOffset: attrs?.marginOffset ?? null,
-      relativeHeight: attrs?.relativeHeight ?? null
+      relativeHeight: attrs?.relativeHeight ?? null,
+      name: attrs?.alt ?? undefined,
+      description: attrs?.title ?? undefined,
+      transform,
+      crop: parseCropFromClipPath$1(attrs?.clipPath),
+      lockAspectRatio: attrs?.lockAspectRatio ?? true,
+      decorative: attrs?.decorative ?? false,
+      hyperlink: attrs?.hyperlink ?? null,
+      hasCaption: pos != null ? detectCaptionSibling(doc$2, pos) : false
     }
   };
 }
@@ -128916,7 +129949,7 @@ function mapLineBreakNode() {
 function isInlineCandidate(candidate) {
   return "anchor" in candidate;
 }
-function mapNodeInfo(candidate, overrideType) {
+function mapNodeInfo(candidate, overrideType, doc$2) {
   const nodeType = overrideType ?? candidate.nodeType;
   const kind = isInlineCandidate(candidate) ? "inline" : "block";
   switch (nodeType) {
@@ -128946,7 +129979,7 @@ function mapNodeInfo(candidate, overrideType) {
       return mapTableCellNode(candidate);
     case "image": {
       const attrs = candidate.node?.attrs;
-      return buildImageInfo(attrs, kind);
+      return buildImageInfo(attrs, kind, doc$2, candidate.pos);
     }
     case "sdt": {
       const attrs = candidate.node?.attrs;
@@ -128989,7 +130022,7 @@ function resolveNodeInfoForAddress(editor, index2, address2, inlineIndex) {
     const candidate$1 = findBlockById(index2, address2);
     if (!candidate$1)
       return;
-    return mapNodeInfo(candidate$1, address2.nodeType);
+    return mapNodeInfo(candidate$1, address2.nodeType, editor.state.doc);
   }
   const candidate = findInlineByAnchor(inlineIndex ?? getInlineIndex(editor), address2);
   if (!candidate)
@@ -129418,12 +130451,12 @@ function getNodeAdapter(editor, address2) {
       throw new DocumentApiAdapterError("TARGET_NOT_FOUND", `Node "${address2.nodeType}" not found for id "${address2.nodeId}".`);
     if (matches2.length > 1)
       throw new DocumentApiAdapterError("TARGET_NOT_FOUND", `Multiple nodes share ${address2.nodeType} id "${address2.nodeId}".`);
-    return mapNodeInfo(matches2[0], address2.nodeType);
+    return mapNodeInfo(matches2[0], address2.nodeType, editor.state.doc);
   }
   const candidate = findInlineByAnchor(getInlineIndex(editor), address2);
   if (!candidate)
     throw new DocumentApiAdapterError("TARGET_NOT_FOUND", `Inline node "${address2.nodeType}" not found for the provided anchor.`);
-  return mapNodeInfo(candidate, address2.nodeType);
+  return mapNodeInfo(candidate, address2.nodeType, editor.state.doc);
 }
 function resolveBlockById(editor, nodeId, nodeType) {
   const blockIndex = getBlockIndex(editor);
@@ -129457,7 +130490,7 @@ function resolveBlockById(editor, nodeId, nodeType) {
 function getNodeByIdAdapter(editor, input2) {
   const { nodeId, nodeType } = input2;
   const { candidate, resolvedType } = resolveBlockById(editor, nodeId, nodeType);
-  return mapNodeInfo(candidate, nodeType ?? resolvedType);
+  return mapNodeInfo(candidate, nodeType ?? resolvedType, editor.state.doc);
 }
 function getTextAdapter(editor, _input) {
   const doc$2 = editor.state.doc;
@@ -142824,7 +143857,38 @@ function buildNoOpResult(message) {
     }
   };
 }
-function buildImageSummary(candidate) {
+function parseCropFromClipPath(clipPath) {
+  if (!clipPath)
+    return null;
+  const match$1 = clipPath.match(/^inset\(\s*([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s*\)$/);
+  if (!match$1)
+    return null;
+  return {
+    top: parseFloat(match$1[1]),
+    right: parseFloat(match$1[2]),
+    bottom: parseFloat(match$1[3]),
+    left: parseFloat(match$1[4])
+  };
+}
+function buildTransformInfo(td) {
+  if (!td)
+    return null;
+  if (!td.rotation && !td.verticalFlip && !td.horizontalFlip)
+    return null;
+  return {
+    rotation: td.rotation ?? undefined,
+    verticalFlip: td.verticalFlip ?? undefined,
+    horizontalFlip: td.horizontalFlip ?? undefined
+  };
+}
+function hasCaptionSibling(editor, imagePos) {
+  try {
+    return findCaptionParagraph(editor, imagePos) !== null;
+  } catch {
+    return false;
+  }
+}
+function buildImageSummary(editor, candidate) {
   const attrs = candidate.node.attrs;
   return {
     sdImageId: candidate.sdImageId,
@@ -142840,7 +143904,15 @@ function buildImageSummary(candidate) {
       },
       anchorData: attrs.anchorData ?? null,
       marginOffset: attrs.marginOffset ?? null,
-      relativeHeight: attrs.relativeHeight ?? null
+      relativeHeight: attrs.relativeHeight ?? null,
+      name: attrs.alt ?? undefined,
+      description: attrs.title ?? undefined,
+      transform: buildTransformInfo(attrs.transformData),
+      crop: parseCropFromClipPath(attrs.clipPath),
+      lockAspectRatio: attrs.lockAspectRatio ?? true,
+      decorative: attrs.decorative ?? false,
+      hyperlink: attrs.hyperlink ?? null,
+      hasCaption: hasCaptionSibling(editor, candidate.pos)
     }
   };
 }
@@ -142874,14 +143946,14 @@ function imagesListWrapper(editor, input2) {
   const allImages = collectImages(editor.state.doc);
   const offset$1 = input2.offset ?? 0;
   const limit = input2.limit ?? allImages.length;
-  const items = allImages.slice(offset$1, offset$1 + limit).map(buildImageSummary);
+  const items = allImages.slice(offset$1, offset$1 + limit).map((c$3) => buildImageSummary(editor, c$3));
   return {
     total: allImages.length,
     items
   };
 }
 function imagesGetWrapper(editor, input2) {
-  return buildImageSummary(findImageById(editor, input2.imageId));
+  return buildImageSummary(editor, findImageById(editor, input2.imageId));
 }
 function createImageWrapper(editor, input2, options) {
   rejectTrackedMode("create.image", options);
@@ -143265,6 +144337,395 @@ function imagesSetZOrderWrapper(editor, input2, options) {
     return buildNoOpResult("Set z-order produced no change.");
   return buildSuccessResult(findImageById(editor, input2.imageId));
 }
+function imagesScaleWrapper(editor, input2, options) {
+  rejectTrackedMode("images.scale", options);
+  const image2 = findImageById(editor, input2.imageId);
+  const currentSize = image2.node.attrs.size;
+  if (!isFinitePositive2(currentSize?.width) || !isFinitePositive2(currentSize?.height))
+    throw new DocumentApiAdapterError("INVALID_TARGET", "Image has no explicit size; use setSize first.");
+  const newSize = {
+    width: Math.max(1, Math.round(currentSize.width * input2.factor)),
+    height: Math.max(1, Math.round(currentSize.height * input2.factor))
+  };
+  if (newSize.width === currentSize.width && newSize.height === currentSize.height)
+    return buildNoOpResult("Scale produced no size change.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      size: newSize
+    });
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Scale produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesSetLockAspectRatioWrapper(editor, input2, options) {
+  rejectTrackedMode("images.setLockAspectRatio", options);
+  const image2 = findImageById(editor, input2.imageId);
+  if ((image2.node.attrs.lockAspectRatio ?? true) === input2.locked)
+    return buildNoOpResult(`lockAspectRatio is already ${input2.locked}.`);
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      lockAspectRatio: input2.locked
+    });
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Set lock aspect ratio produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesRotateWrapper(editor, input2, options) {
+  rejectTrackedMode("images.rotate", options);
+  const image2 = findImageById(editor, input2.imageId);
+  if ((image2.node.attrs.transformData?.rotation ?? 0) === input2.angle)
+    return buildNoOpResult(`Rotation is already ${input2.angle} degrees.`);
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      transformData: {
+        ...node3.attrs.transformData ?? {},
+        rotation: input2.angle
+      }
+    });
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Rotate produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesFlipWrapper(editor, input2, options) {
+  rejectTrackedMode("images.flip", options);
+  const image2 = findImageById(editor, input2.imageId);
+  const current = image2.node.attrs.transformData ?? {};
+  const targetH = input2.horizontal ?? current.horizontalFlip ?? false;
+  const targetV = input2.vertical ?? current.verticalFlip ?? false;
+  if (targetH === (current.horizontalFlip ?? false) && targetV === (current.verticalFlip ?? false))
+    return buildNoOpResult("Flip state is already as requested.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      transformData: {
+        ...node3.attrs.transformData ?? {},
+        horizontalFlip: targetH,
+        verticalFlip: targetV
+      }
+    });
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Flip produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function cropToClipPath(crop) {
+  const { top: top$1 = 0, right: right$1 = 0, bottom: bottom$1 = 0, left: left$1 = 0 } = crop;
+  return `inset(${top$1}% ${right$1}% ${bottom$1}% ${left$1}%)`;
+}
+function cropToRawSrcRect(crop) {
+  const { top: top$1 = 0, right: right$1 = 0, bottom: bottom$1 = 0, left: left$1 = 0 } = crop;
+  return {
+    name: "a:srcRect",
+    attributes: {
+      l: String(Math.round(left$1 * 1000)),
+      t: String(Math.round(top$1 * 1000)),
+      r: String(Math.round(right$1 * 1000)),
+      b: String(Math.round(bottom$1 * 1000))
+    }
+  };
+}
+function imagesCropWrapper(editor, input2, options) {
+  rejectTrackedMode("images.crop", options);
+  const image2 = findImageById(editor, input2.imageId);
+  const newClipPath = cropToClipPath(input2.crop);
+  if (image2.node.attrs.clipPath === newClipPath)
+    return buildNoOpResult("Crop values are already as requested.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      clipPath: newClipPath,
+      rawSrcRect: cropToRawSrcRect(input2.crop)
+    });
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Crop produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesResetCropWrapper(editor, input2, options) {
+  rejectTrackedMode("images.resetCrop", options);
+  const image2 = findImageById(editor, input2.imageId);
+  if (!image2.node.attrs.clipPath)
+    return buildNoOpResult("Image has no crop to reset.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      clipPath: null,
+      rawSrcRect: null,
+      shouldCover: false
+    });
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Reset crop produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesReplaceSourceWrapper(editor, input2, options) {
+  rejectTrackedMode("images.replaceSource", options);
+  const isDataUri = input2.src.startsWith("data:");
+  const isInternalPath = input2.src.startsWith("word/media/");
+  if (!isDataUri && !isInternalPath)
+    throw new DocumentApiAdapterError("INVALID_INPUT", "External URLs are not supported in V1; provide a data URI or internal media path.");
+  const image2 = findImageById(editor, input2.imageId);
+  const newAttrs = {
+    ...image2.node.attrs,
+    src: input2.src,
+    rId: null,
+    originalSrc: null,
+    originalExtension: null,
+    clipPath: null,
+    rawSrcRect: null,
+    shouldCover: false
+  };
+  if (input2.resetSize) {
+    if (!isDataUri)
+      throw new DocumentApiAdapterError("INVALID_INPUT", "Cannot determine intrinsic dimensions from internal path; set size explicitly via setSize after replacement.");
+    const dims = readImageDimensionsFromDataUri(input2.src);
+    if (!dims)
+      throw new DocumentApiAdapterError("INVALID_INPUT", "Could not determine intrinsic dimensions from data URI.");
+    newAttrs.size = {
+      width: dims.width,
+      height: dims.height
+    };
+  }
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, newAttrs);
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Replace source produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesSetAltTextWrapper(editor, input2, options) {
+  rejectTrackedMode("images.setAltText", options);
+  const image2 = findImageById(editor, input2.imageId);
+  if (image2.node.attrs.title === input2.description && !image2.node.attrs.decorative)
+    return buildNoOpResult("Alt text is already as requested.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      title: input2.description,
+      decorative: false
+    });
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Set alt text produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesSetDecorativeWrapper(editor, input2, options) {
+  rejectTrackedMode("images.setDecorative", options);
+  const image2 = findImageById(editor, input2.imageId);
+  if ((image2.node.attrs.decorative ?? false) === input2.decorative)
+    return buildNoOpResult(`Decorative is already ${input2.decorative}.`);
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      decorative: input2.decorative,
+      title: input2.decorative ? "" : node3.attrs.title
+    });
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Set decorative produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesSetNameWrapper(editor, input2, options) {
+  rejectTrackedMode("images.setName", options);
+  const image2 = findImageById(editor, input2.imageId);
+  if (image2.node.attrs.alt === input2.name)
+    return buildNoOpResult("Name is already as requested.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      alt: input2.name
+    });
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Set name produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesSetHyperlinkWrapper(editor, input2, options) {
+  rejectTrackedMode("images.setHyperlink", options);
+  const image2 = findImageById(editor, input2.imageId);
+  const newValue = input2.url === null ? null : {
+    url: input2.url,
+    ...input2.tooltip ? { tooltip: input2.tooltip } : {}
+  };
+  const current = image2.node.attrs.hyperlink ?? null;
+  if (current === null && newValue === null || current !== null && newValue !== null && current.url === newValue.url && current.tooltip === newValue.tooltip)
+    return buildNoOpResult("Hyperlink is already as requested.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const { pos, node: node3 } = image2;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node3.attrs,
+      hyperlink: newValue
+    });
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Set hyperlink produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function findCaptionParagraph(editor, imagePos) {
+  const $pos = editor.state.doc.resolve(imagePos);
+  const parentDepth = $pos.depth - 1;
+  if (parentDepth < 0)
+    return null;
+  const afterParentPos = $pos.before(parentDepth + 1) + $pos.node(parentDepth + 1).nodeSize;
+  if (afterParentPos >= editor.state.doc.content.size)
+    return null;
+  const nextNode = editor.state.doc.nodeAt(afterParentPos);
+  if (!nextNode || nextNode.type.name !== "paragraph")
+    return null;
+  if (nextNode.attrs?.paragraphProperties?.styleId !== "Caption")
+    return null;
+  return {
+    pos: afterParentPos,
+    node: nextNode
+  };
+}
+function requireSoleImageInParagraph(editor, imagePos) {
+  const $pos = editor.state.doc.resolve(imagePos);
+  const parentDepth = $pos.depth - 1;
+  if (parentDepth < 0)
+    throw new DocumentApiAdapterError("INVALID_TARGET", "Caption operations require the image to be inside a paragraph.");
+  const parentNode$1 = $pos.node(parentDepth + 1);
+  let inlineContentCount = 0;
+  parentNode$1.forEach((child) => {
+    if (child.isInline)
+      inlineContentCount++;
+  });
+  if (inlineContentCount !== 1)
+    throw new DocumentApiAdapterError("INVALID_TARGET", "Caption operations require the image to be the sole content of its paragraph.");
+}
+function imagesInsertCaptionWrapper(editor, input2, options) {
+  rejectTrackedMode("images.insertCaption", options);
+  const image2 = findImageById(editor, input2.imageId);
+  requireSoleImageInParagraph(editor, image2.pos);
+  if (findCaptionParagraph(editor, image2.pos))
+    throw new DocumentApiAdapterError("INVALID_TARGET", "Image already has a caption; use updateCaption.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const $pos = editor.state.doc.resolve(image2.pos);
+    const parentDepth = $pos.depth - 1;
+    const afterParentPos = $pos.before(parentDepth + 1) + $pos.node(parentDepth + 1).nodeSize;
+    const tr = editor.state.tr;
+    const captionPara = editor.state.schema.nodes.paragraph.create({ paragraphProperties: { styleId: "Caption" } }, editor.state.schema.text(input2.text));
+    tr.insert(afterParentPos, captionPara);
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Insert caption produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesUpdateCaptionWrapper(editor, input2, options) {
+  rejectTrackedMode("images.updateCaption", options);
+  const image2 = findImageById(editor, input2.imageId);
+  requireSoleImageInParagraph(editor, image2.pos);
+  const caption = findCaptionParagraph(editor, image2.pos);
+  if (!caption)
+    throw new DocumentApiAdapterError("INVALID_TARGET", "No caption paragraph found; use insertCaption first.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const tr = editor.state.tr;
+    const textStart = caption.pos + 1;
+    const textEnd = caption.pos + caption.node.nodeSize - 1;
+    tr.replaceWith(textStart, textEnd, editor.state.schema.text(input2.text));
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Update caption produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
+function imagesRemoveCaptionWrapper(editor, input2, options) {
+  rejectTrackedMode("images.removeCaption", options);
+  const image2 = findImageById(editor, input2.imageId);
+  requireSoleImageInParagraph(editor, image2.pos);
+  const caption = findCaptionParagraph(editor, image2.pos);
+  if (!caption)
+    return buildNoOpResult("No caption to remove.");
+  if (options?.dryRun)
+    return buildSuccessResult(image2);
+  if (executeDomainCommand(editor, () => {
+    const tr = editor.state.tr;
+    tr.delete(caption.pos, caption.pos + caption.node.nodeSize);
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  }).steps[0]?.effect !== "changed")
+    return buildNoOpResult("Remove caption produced no change.");
+  return buildSuccessResult(findImageById(editor, input2.imageId));
+}
 function getLinkMarkType(editor) {
   const markType = editor.schema.marks.link;
   if (!markType)
@@ -143936,7 +145397,21 @@ function assembleDocumentApiAdapters(editor) {
       setWrapDistances: (input2, options) => imagesSetWrapDistancesWrapper(editor, input2, options),
       setPosition: (input2, options) => imagesSetPositionWrapper(editor, input2, options),
       setAnchorOptions: (input2, options) => imagesSetAnchorOptionsWrapper(editor, input2, options),
-      setZOrder: (input2, options) => imagesSetZOrderWrapper(editor, input2, options)
+      setZOrder: (input2, options) => imagesSetZOrderWrapper(editor, input2, options),
+      scale: (input2, options) => imagesScaleWrapper(editor, input2, options),
+      setLockAspectRatio: (input2, options) => imagesSetLockAspectRatioWrapper(editor, input2, options),
+      rotate: (input2, options) => imagesRotateWrapper(editor, input2, options),
+      flip: (input2, options) => imagesFlipWrapper(editor, input2, options),
+      crop: (input2, options) => imagesCropWrapper(editor, input2, options),
+      resetCrop: (input2, options) => imagesResetCropWrapper(editor, input2, options),
+      replaceSource: (input2, options) => imagesReplaceSourceWrapper(editor, input2, options),
+      setAltText: (input2, options) => imagesSetAltTextWrapper(editor, input2, options),
+      setDecorative: (input2, options) => imagesSetDecorativeWrapper(editor, input2, options),
+      setName: (input2, options) => imagesSetNameWrapper(editor, input2, options),
+      setHyperlink: (input2, options) => imagesSetHyperlinkWrapper(editor, input2, options),
+      insertCaption: (input2, options) => imagesInsertCaptionWrapper(editor, input2, options),
+      updateCaption: (input2, options) => imagesUpdateCaptionWrapper(editor, input2, options),
+      removeCaption: (input2, options) => imagesRemoveCaptionWrapper(editor, input2, options)
     },
     hyperlinks: {
       list: (query2) => hyperlinksListWrapper(editor, query2),
@@ -197248,9 +198723,9 @@ var Node$13 = class Node$14 {
     trackedChanges: context.trackedChanges ?? []
   });
 }, _hoisted_1$6, _hoisted_2$2, _hoisted_3, _hoisted_4, ContextMenu_default, _hoisted_1$5, BasicUpload_default, _hoisted_1$4, MIN_WIDTH = 200, PPI = 96, alignment = "flex-end", Ruler_default, GenericPopover_default, _hoisted_1$3, _hoisted_2$1, RESIZE_HANDLE_WIDTH_PX = 9, RESIZE_HANDLE_HEIGHT_PX = 9, RESIZE_HANDLE_OFFSET_PX = 4, DRAG_OVERLAY_EXTENSION_PX = 1000, MIN_DRAG_OVERLAY_WIDTH_PX = 2000, THROTTLE_INTERVAL_MS = 16, MIN_RESIZE_DELTA_PX = 1, TableResizeOverlay_default, _hoisted_1$2, OVERLAY_EXPANSION_PX = 2000, RESIZE_HANDLE_SIZE_PX = 12, MOUSE_MOVE_THROTTLE_MS = 16, DIMENSION_CHANGE_THRESHOLD_PX = 1, Z_INDEX_OVERLAY = 10, Z_INDEX_HANDLE = 15, Z_INDEX_GUIDELINE = 20, ImageResizeOverlay_default, LINK_CLICK_DEBOUNCE_MS = 300, CURSOR_UPDATE_TIMEOUT_MS = 10, POPOVER_VERTICAL_OFFSET_PX = 15, LinkClickHandler_default, _hoisted_1$1, _hoisted_2, DOCX2 = "application/vnd.openxmlformats-officedocument.wordprocessingml.document", TABLE_RESIZE_HOVER_THRESHOLD = 8, TABLE_RESIZE_THROTTLE_MS = 16, SuperEditor_default, _hoisted_1, SuperInput_default, SlashMenu, Extensions;
-var init_src_nq0HTKfv_es = __esm(() => {
+var init_src_LqliKMID_es = __esm(() => {
   init_rolldown_runtime_B2q5OVn9_es();
-  init_SuperConverter_C3jSWLmj_es();
+  init_SuperConverter_BcmJ8_gc_es();
   init_jszip_ChlR43oI_es();
   init_uuid_qzgm05fK_es();
   init_constants_CMPtQbp7_es();
@@ -205525,7 +207000,21 @@ function print() { __p += __j.call(arguments, '') }
     "images.setWrapDistances": ["setImage"],
     "images.setPosition": ["setImage"],
     "images.setAnchorOptions": ["setImage"],
-    "images.setZOrder": ["setImage"]
+    "images.setZOrder": ["setImage"],
+    "images.scale": ["setImage"],
+    "images.setLockAspectRatio": ["setImage"],
+    "images.rotate": ["setImage"],
+    "images.flip": ["setImage"],
+    "images.crop": ["setImage"],
+    "images.resetCrop": ["setImage"],
+    "images.replaceSource": ["setImage"],
+    "images.setAltText": ["setImage"],
+    "images.setDecorative": ["setImage"],
+    "images.setName": ["setImage"],
+    "images.setHyperlink": ["setImage"],
+    "images.insertCaption": ["setImage"],
+    "images.updateCaption": ["setImage"],
+    "images.removeCaption": ["setImage"]
   };
   VALID_CAPABILITY_REASON_CODES = new Set(CAPABILITY_REASON_CODES2);
   REQUIRED_HELPERS = {
@@ -222736,6 +224225,18 @@ function print() { __p += __j.call(arguments, '') }
         rawSrcRect: {
           default: null,
           rendered: false
+        },
+        lockAspectRatio: {
+          default: true,
+          rendered: false
+        },
+        decorative: {
+          default: false,
+          rendered: false
+        },
+        hyperlink: {
+          default: null,
+          rendered: false
         }
       };
     },
@@ -228932,8 +230433,8 @@ function print() { __p += __j.call(arguments, '') }
     return isObjectLike_default(value) && hasOwnProperty$8.call(value, "callee") && !propertyIsEnumerable$1.call(value, "callee");
   };
   stubFalse_default = stubFalse;
-  freeExports$2 = typeof exports_src_nq0HTKfv_es == "object" && exports_src_nq0HTKfv_es && !exports_src_nq0HTKfv_es.nodeType && exports_src_nq0HTKfv_es;
-  freeModule$2 = freeExports$2 && typeof module_src_nq0HTKfv_es == "object" && module_src_nq0HTKfv_es && !module_src_nq0HTKfv_es.nodeType && module_src_nq0HTKfv_es;
+  freeExports$2 = typeof exports_src_LqliKMID_es == "object" && exports_src_LqliKMID_es && !exports_src_LqliKMID_es.nodeType && exports_src_LqliKMID_es;
+  freeModule$2 = freeExports$2 && typeof module_src_LqliKMID_es == "object" && module_src_LqliKMID_es && !module_src_LqliKMID_es.nodeType && module_src_LqliKMID_es;
   Buffer$1 = freeModule$2 && freeModule$2.exports === freeExports$2 ? _root_default.Buffer : undefined;
   isBuffer_default = (Buffer$1 ? Buffer$1.isBuffer : undefined) || stubFalse_default;
   typedArrayTags = {};
@@ -228941,8 +230442,8 @@ function print() { __p += __j.call(arguments, '') }
   typedArrayTags[argsTag$1] = typedArrayTags[arrayTag$1] = typedArrayTags[arrayBufferTag$1] = typedArrayTags[boolTag$1] = typedArrayTags[dataViewTag$2] = typedArrayTags[dateTag$1] = typedArrayTags[errorTag$1] = typedArrayTags[funcTag] = typedArrayTags[mapTag$2] = typedArrayTags[numberTag$1] = typedArrayTags[objectTag$3] = typedArrayTags[regexpTag$1] = typedArrayTags[setTag$2] = typedArrayTags[stringTag$1] = typedArrayTags[weakMapTag$1] = false;
   _baseIsTypedArray_default = baseIsTypedArray;
   _baseUnary_default = baseUnary;
-  freeExports$1 = typeof exports_src_nq0HTKfv_es == "object" && exports_src_nq0HTKfv_es && !exports_src_nq0HTKfv_es.nodeType && exports_src_nq0HTKfv_es;
-  freeModule$1 = freeExports$1 && typeof module_src_nq0HTKfv_es == "object" && module_src_nq0HTKfv_es && !module_src_nq0HTKfv_es.nodeType && module_src_nq0HTKfv_es;
+  freeExports$1 = typeof exports_src_LqliKMID_es == "object" && exports_src_LqliKMID_es && !exports_src_LqliKMID_es.nodeType && exports_src_LqliKMID_es;
+  freeModule$1 = freeExports$1 && typeof module_src_LqliKMID_es == "object" && module_src_LqliKMID_es && !module_src_LqliKMID_es.nodeType && module_src_LqliKMID_es;
   freeProcess = freeModule$1 && freeModule$1.exports === freeExports$1 && _freeGlobal_default.process;
   _nodeUtil_default = function() {
     try {
@@ -229047,8 +230548,8 @@ function print() { __p += __j.call(arguments, '') }
   Stack.prototype.has = _stackHas_default;
   Stack.prototype.set = _stackSet_default;
   _Stack_default = Stack;
-  freeExports = typeof exports_src_nq0HTKfv_es == "object" && exports_src_nq0HTKfv_es && !exports_src_nq0HTKfv_es.nodeType && exports_src_nq0HTKfv_es;
-  freeModule = freeExports && typeof module_src_nq0HTKfv_es == "object" && module_src_nq0HTKfv_es && !module_src_nq0HTKfv_es.nodeType && module_src_nq0HTKfv_es;
+  freeExports = typeof exports_src_LqliKMID_es == "object" && exports_src_LqliKMID_es && !exports_src_LqliKMID_es.nodeType && exports_src_LqliKMID_es;
+  freeModule = freeExports && typeof module_src_LqliKMID_es == "object" && module_src_LqliKMID_es && !module_src_LqliKMID_es.nodeType && module_src_LqliKMID_es;
   Buffer4 = freeModule && freeModule.exports === freeExports ? _root_default.Buffer : undefined;
   allocUnsafe = Buffer4 ? Buffer4.allocUnsafe : undefined;
   _cloneBuffer_default = cloneBuffer;
@@ -237128,8 +238629,8 @@ var init_zipper_DqXT7uTa_es = __esm(() => {
 
 // ../../packages/superdoc/dist/super-editor.es.js
 var init_super_editor_es = __esm(() => {
-  init_src_nq0HTKfv_es();
-  init_SuperConverter_C3jSWLmj_es();
+  init_src_LqliKMID_es();
+  init_SuperConverter_BcmJ8_gc_es();
   init_jszip_ChlR43oI_es();
   init_xml_js_DLE8mr0n_es();
   init_constants_CMPtQbp7_es();
@@ -238496,9 +239997,49 @@ function mapTableOfContentsNode2(candidate) {
     }
   };
 }
-function buildImageInfo2(attrs, kind) {
+function parseCropFromClipPath2(clipPath) {
+  if (!clipPath)
+    return null;
+  const match2 = clipPath.match(/^inset\(\s*([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s*\)$/);
+  if (!match2)
+    return null;
+  return {
+    top: parseFloat(match2[1]),
+    right: parseFloat(match2[2]),
+    bottom: parseFloat(match2[3]),
+    left: parseFloat(match2[4])
+  };
+}
+function detectCaptionSibling2(doc4, imagePos) {
+  if (!doc4)
+    return false;
+  try {
+    const $pos = doc4.resolve(imagePos);
+    const parentDepth = $pos.depth - 1;
+    if (parentDepth < 0)
+      return false;
+    const parentPos = $pos.before(parentDepth + 1);
+    const parentNode2 = $pos.node(parentDepth + 1);
+    const afterParentPos = parentPos + parentNode2.nodeSize;
+    if (afterParentPos >= doc4.content.size)
+      return false;
+    const nextNode = doc4.nodeAt(afterParentPos);
+    if (!nextNode || nextNode.type.name !== "paragraph")
+      return false;
+    return nextNode.attrs?.paragraphProperties?.styleId === "Caption";
+  } catch {
+    return false;
+  }
+}
+function buildImageInfo2(attrs, kind, doc4, pos) {
   const isFloating = Boolean(attrs?.isAnchor);
   const wrapObj = attrs?.wrap;
+  const td = attrs?.transformData;
+  const transform = td && (td.rotation || td.verticalFlip || td.horizontalFlip) ? {
+    rotation: td.rotation ?? undefined,
+    verticalFlip: td.verticalFlip ?? undefined,
+    horizontalFlip: td.horizontalFlip ?? undefined
+  } : null;
   const properties = {
     src: attrs?.src ?? undefined,
     alt: attrs?.alt ?? undefined,
@@ -238514,7 +240055,15 @@ function buildImageInfo2(attrs, kind) {
     },
     anchorData: attrs?.anchorData ?? null,
     marginOffset: attrs?.marginOffset ?? null,
-    relativeHeight: attrs?.relativeHeight ?? null
+    relativeHeight: attrs?.relativeHeight ?? null,
+    name: attrs?.alt ?? undefined,
+    description: attrs?.title ?? undefined,
+    transform,
+    crop: parseCropFromClipPath2(attrs?.clipPath),
+    lockAspectRatio: attrs?.lockAspectRatio ?? true,
+    decorative: attrs?.decorative ?? false,
+    hyperlink: attrs?.hyperlink ?? null,
+    hasCaption: pos != null ? detectCaptionSibling2(doc4, pos) : false
   };
   return {
     nodeType: "image",
@@ -238710,7 +240259,7 @@ function mapLineBreakNode2() {
 function isInlineCandidate2(candidate) {
   return "anchor" in candidate;
 }
-function mapNodeInfo2(candidate, overrideType) {
+function mapNodeInfo2(candidate, overrideType, doc4) {
   const nodeType = overrideType ?? candidate.nodeType;
   const kind = isInlineCandidate2(candidate) ? "inline" : "block";
   switch (nodeType) {
@@ -238740,7 +240289,7 @@ function mapNodeInfo2(candidate, overrideType) {
       return mapTableCellNode2(candidate);
     case "image": {
       const attrs = candidate.node?.attrs;
-      return buildImageInfo2(attrs, kind);
+      return buildImageInfo2(attrs, kind, doc4, candidate.pos);
     }
     case "sdt": {
       const attrs = candidate.node?.attrs;
@@ -238790,7 +240339,7 @@ function resolveNodeInfoForAddress2(editor, index2, address2, inlineIndex) {
     const candidate2 = findBlockById2(index2, address2);
     if (!candidate2)
       return;
-    return mapNodeInfo2(candidate2, address2.nodeType);
+    return mapNodeInfo2(candidate2, address2.nodeType, editor.state.doc);
   }
   const resolvedInlineIndex = inlineIndex ?? getInlineIndex2(editor);
   const candidate = findInlineByAnchor2(resolvedInlineIndex, address2);
@@ -239336,14 +240885,14 @@ function getNodeAdapter2(editor, address2) {
     if (matches2.length > 1) {
       throw new DocumentApiAdapterError3("TARGET_NOT_FOUND", `Multiple nodes share ${address2.nodeType} id "${address2.nodeId}".`);
     }
-    return mapNodeInfo2(matches2[0], address2.nodeType);
+    return mapNodeInfo2(matches2[0], address2.nodeType, editor.state.doc);
   }
   const inlineIndex = getInlineIndex2(editor);
   const candidate = findInlineByAnchor2(inlineIndex, address2);
   if (!candidate) {
     throw new DocumentApiAdapterError3("TARGET_NOT_FOUND", `Inline node "${address2.nodeType}" not found for the provided anchor.`);
   }
-  return mapNodeInfo2(candidate, address2.nodeType);
+  return mapNodeInfo2(candidate, address2.nodeType, editor.state.doc);
 }
 function resolveBlockById2(editor, nodeId, nodeType) {
   const blockIndex = getBlockIndex2(editor);
@@ -239375,7 +240924,7 @@ function getNodeByIdAdapter2(editor, input2) {
   const { nodeId, nodeType } = input2;
   const { candidate, resolvedType } = resolveBlockById2(editor, nodeId, nodeType);
   const displayType = nodeType ?? resolvedType;
-  return mapNodeInfo2(candidate, displayType);
+  return mapNodeInfo2(candidate, displayType, editor.state.doc);
 }
 var init_get_node_adapter = __esm(() => {
   init_index_cache();
@@ -282287,6 +283836,41 @@ function handleImageNode3(node4, params3, isAnchor) {
       };
     }
   }
+  const nvPicPr = picture.elements.find((el) => el.name === "pic:nvPicPr");
+  const cNvPicPr = nvPicPr?.elements?.find((el) => el.name === "pic:cNvPicPr");
+  const picLocks = cNvPicPr?.elements?.find((el) => el.name === "a:picLocks");
+  const lockAspectRatio = picLocks ? picLocks.attributes?.["noChangeAspect"] === "1" || picLocks.attributes?.["noChangeAspect"] === 1 : false;
+  const cNvPr = nvPicPr?.elements?.find((el) => el.name === "pic:cNvPr");
+  const hlinkClick = cNvPr?.elements?.find((el) => el.name === "a:hlinkClick") || docPr?.elements?.find((el) => el.name === "a:hlinkClick");
+  let hyperlink = null;
+  if (hlinkClick?.attributes?.["r:id"]) {
+    const hlinkRId = hlinkClick.attributes["r:id"];
+    const currentFile2 = filename || "document.xml";
+    let hlinkRels = docx[`word/_rels/${currentFile2}.rels`];
+    if (!hlinkRels)
+      hlinkRels = docx[`word/_rels/document.xml.rels`];
+    const hlinkRelationships = hlinkRels?.elements?.find((el) => el.name === "Relationships");
+    const hlinkRel = hlinkRelationships?.elements?.find((el) => el.attributes?.["Id"] === hlinkRId);
+    if (hlinkRel?.attributes?.["Target"]) {
+      hyperlink = { url: hlinkRel.attributes["Target"] };
+      if (hlinkClick.attributes?.["tooltip"]) {
+        hyperlink.tooltip = hlinkClick.attributes["tooltip"];
+      }
+    }
+  }
+  let decorative = false;
+  const docPrExtLst = docPr?.elements?.find((el) => el.name === "a:extLst");
+  if (docPrExtLst) {
+    for (const ext of docPrExtLst.elements || []) {
+      if (ext.name !== "a:ext")
+        continue;
+      const decEl = ext.elements?.find((el) => el.name === "adec:decorative" || el.name === "a16:decorative");
+      if (decEl && (decEl.attributes?.["val"] === "1" || decEl.attributes?.["val"] === 1)) {
+        decorative = true;
+        break;
+      }
+    }
+  }
   const { attributes: blipAttributes = {} } = blip;
   const rEmbed = blipAttributes["r:embed"];
   if (!rEmbed) {
@@ -282381,6 +283965,9 @@ function handleImageNode3(node4, params3, isAnchor) {
     },
     originalAttributes: node4.attributes,
     rId: relAttributes["Id"],
+    lockAspectRatio,
+    decorative,
+    hyperlink,
     ...order4.length ? { drawingChildOrder: order4 } : {},
     ...originalChildren.length ? { originalDrawingChildren: originalChildren } : {},
     ...hasGrayscale ? { grayscale: true } : {}
@@ -283098,6 +284685,103 @@ var init_image_dimensions = __esm(() => {
 });
 
 // ../../packages/super-editor/src/core/super-converter/v3/handlers/wp/helpers/decode-image-node-helpers.js
+function resolveHyperlinkRId2(attrs, params3) {
+  if (!attrs.hyperlink?.url || !params3)
+    return null;
+  return addHyperlinkRelationship2(params3, attrs.hyperlink.url);
+}
+function buildHlinkClickElement2(attrs, hlinkRId) {
+  if (!hlinkRId)
+    return null;
+  const hlinkAttrs = { "r:id": hlinkRId };
+  if (attrs.hyperlink?.tooltip) {
+    hlinkAttrs.tooltip = attrs.hyperlink.tooltip;
+  }
+  return { name: "a:hlinkClick", attributes: hlinkAttrs };
+}
+function buildDocPrElement2(attrs, imageName, hlinkRId) {
+  const docPrAttrs = {
+    id: attrs.id || 0,
+    name: attrs.alt || `Picture ${imageName}`
+  };
+  if (!attrs.decorative && attrs.title) {
+    docPrAttrs.descr = attrs.title;
+  }
+  const children = [];
+  const hlinkEl = buildHlinkClickElement2(attrs, hlinkRId);
+  if (hlinkEl)
+    children.push(hlinkEl);
+  if (attrs.decorative) {
+    children.push({
+      name: "a:extLst",
+      elements: [
+        {
+          name: "a:ext",
+          attributes: { uri: DECORATIVE_EXT_URI2 },
+          elements: [
+            {
+              name: "adec:decorative",
+              attributes: { "xmlns:adec": DECORATIVE_NAMESPACE2, val: "1" }
+            }
+          ]
+        }
+      ]
+    });
+  }
+  return {
+    name: "wp:docPr",
+    attributes: docPrAttrs,
+    ...children.length ? { elements: children } : {}
+  };
+}
+function buildNvPicPrElement2(attrs, imageName, hlinkRId) {
+  const cNvPrChildren = [];
+  const hlinkEl = buildHlinkClickElement2(attrs, hlinkRId);
+  if (hlinkEl)
+    cNvPrChildren.push(hlinkEl);
+  return {
+    name: "pic:nvPicPr",
+    elements: [
+      {
+        name: "pic:cNvPr",
+        attributes: {
+          id: attrs.id || 0,
+          name: attrs.alt || `Picture ${imageName}`
+        },
+        ...cNvPrChildren.length ? { elements: cNvPrChildren } : {}
+      },
+      {
+        name: "pic:cNvPicPr",
+        elements: [
+          {
+            name: "a:picLocks",
+            attributes: {
+              ...attrs.lockAspectRatio ? { noChangeAspect: 1 } : {},
+              noChangeArrowheads: 1
+            }
+          }
+        ]
+      }
+    ]
+  };
+}
+function addHyperlinkRelationship2(params3, url) {
+  const newId = `rId${generateDocxRandomId2(8)}`;
+  if (!params3.relationships || !Array.isArray(params3.relationships)) {
+    params3.relationships = [];
+  }
+  params3.relationships.push({
+    type: "element",
+    name: "Relationship",
+    attributes: {
+      Id: newId,
+      Type: HYPERLINK_REL_TYPE2,
+      Target: url,
+      TargetMode: "External"
+    }
+  });
+  return newId;
+}
 function isFinitePositive3(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0;
 }
@@ -283203,7 +284887,7 @@ function translateShapeGroup2(params3) {
     elements: []
   });
 }
-var translateImageNode2 = (params3) => {
+var DECORATIVE_EXT_URI2 = "{C183D7F6-B498-43B3-948B-1728B52AA6E4}", DECORATIVE_NAMESPACE2 = "http://schemas.microsoft.com/office/drawing/2017/decorative", HYPERLINK_REL_TYPE2 = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink", translateImageNode2 = (params3) => {
   const {
     node: { attrs = {} },
     tableCell: tableCell2,
@@ -283305,6 +284989,7 @@ var translateImageNode2 = (params3) => {
   const rawSrcRect = attrs.rawSrcRect;
   const drawingXmlns = "http://schemas.openxmlformats.org/drawingml/2006/main";
   const pictureXmlns = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+  const hlinkRId = resolveHyperlinkRId2(attrs, params3);
   return {
     attributes: inlineAttrs,
     elements: [
@@ -283319,13 +285004,7 @@ var translateImageNode2 = (params3) => {
         name: "wp:effectExtent",
         attributes: effectExtentAttrs
       },
-      {
-        name: "wp:docPr",
-        attributes: {
-          id: attrs.id || 0,
-          name: attrs.alt || `Picture ${imageName}`
-        }
-      },
+      buildDocPrElement2(attrs, imageName, hlinkRId),
       {
         name: "wp:cNvGraphicFramePr",
         elements: [
@@ -283333,7 +285012,7 @@ var translateImageNode2 = (params3) => {
             name: "a:graphicFrameLocks",
             attributes: {
               "xmlns:a": drawingXmlns,
-              noChangeAspect: 1
+              ...attrs.lockAspectRatio ? { noChangeAspect: 1 } : {}
             }
           }
         ]
@@ -283350,30 +285029,7 @@ var translateImageNode2 = (params3) => {
                 name: "pic:pic",
                 attributes: { "xmlns:pic": pictureXmlns },
                 elements: [
-                  {
-                    name: "pic:nvPicPr",
-                    elements: [
-                      {
-                        name: "pic:cNvPr",
-                        attributes: {
-                          id: attrs.id || 0,
-                          name: attrs.title || `Picture ${imageName}`
-                        }
-                      },
-                      {
-                        name: "pic:cNvPicPr",
-                        elements: [
-                          {
-                            name: "a:picLocks",
-                            attributes: {
-                              noChangeAspect: 1,
-                              noChangeArrowheads: 1
-                            }
-                          }
-                        ]
-                      }
-                    ]
-                  },
+                  buildNvPicPrElement2(attrs, imageName, hlinkRId),
                   {
                     name: "pic:blipFill",
                     elements: [
@@ -299120,7 +300776,21 @@ var init_capabilities_adapter = __esm(() => {
     "images.setWrapDistances": ["setImage"],
     "images.setPosition": ["setImage"],
     "images.setAnchorOptions": ["setImage"],
-    "images.setZOrder": ["setImage"]
+    "images.setZOrder": ["setImage"],
+    "images.scale": ["setImage"],
+    "images.setLockAspectRatio": ["setImage"],
+    "images.rotate": ["setImage"],
+    "images.flip": ["setImage"],
+    "images.crop": ["setImage"],
+    "images.resetCrop": ["setImage"],
+    "images.replaceSource": ["setImage"],
+    "images.setAltText": ["setImage"],
+    "images.setDecorative": ["setImage"],
+    "images.setName": ["setImage"],
+    "images.setHyperlink": ["setImage"],
+    "images.insertCaption": ["setImage"],
+    "images.updateCaption": ["setImage"],
+    "images.removeCaption": ["setImage"]
   };
   VALID_CAPABILITY_REASON_CODES2 = new Set(CAPABILITY_REASON_CODES);
   REQUIRED_HELPERS2 = {
@@ -314026,7 +315696,38 @@ function buildSuccessResult2(candidate) {
 function buildNoOpResult2(message) {
   return { success: false, failure: { code: "NO_OP", message } };
 }
-function buildImageSummary2(candidate) {
+function parseCropFromClipPath3(clipPath) {
+  if (!clipPath)
+    return null;
+  const match2 = clipPath.match(/^inset\(\s*([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s+([\d.]+)%\s*\)$/);
+  if (!match2)
+    return null;
+  return {
+    top: parseFloat(match2[1]),
+    right: parseFloat(match2[2]),
+    bottom: parseFloat(match2[3]),
+    left: parseFloat(match2[4])
+  };
+}
+function buildTransformInfo2(td) {
+  if (!td)
+    return null;
+  if (!td.rotation && !td.verticalFlip && !td.horizontalFlip)
+    return null;
+  return {
+    rotation: td.rotation ?? undefined,
+    verticalFlip: td.verticalFlip ?? undefined,
+    horizontalFlip: td.horizontalFlip ?? undefined
+  };
+}
+function hasCaptionSibling2(editor, imagePos) {
+  try {
+    return findCaptionParagraph2(editor, imagePos) !== null;
+  } catch {
+    return false;
+  }
+}
+function buildImageSummary2(editor, candidate) {
   const attrs = candidate.node.attrs;
   return {
     sdImageId: candidate.sdImageId,
@@ -314042,7 +315743,15 @@ function buildImageSummary2(candidate) {
       },
       anchorData: attrs.anchorData ?? null,
       marginOffset: attrs.marginOffset ?? null,
-      relativeHeight: attrs.relativeHeight ?? null
+      relativeHeight: attrs.relativeHeight ?? null,
+      name: attrs.alt ?? undefined,
+      description: attrs.title ?? undefined,
+      transform: buildTransformInfo2(attrs.transformData),
+      crop: parseCropFromClipPath3(attrs.clipPath),
+      lockAspectRatio: attrs.lockAspectRatio ?? true,
+      decorative: attrs.decorative ?? false,
+      hyperlink: attrs.hyperlink ?? null,
+      hasCaption: hasCaptionSibling2(editor, candidate.pos)
     }
   };
 }
@@ -314081,12 +315790,12 @@ function imagesListWrapper2(editor, input2) {
   const allImages = collectImages2(editor.state.doc);
   const offset2 = input2.offset ?? 0;
   const limit = input2.limit ?? allImages.length;
-  const items = allImages.slice(offset2, offset2 + limit).map(buildImageSummary2);
+  const items = allImages.slice(offset2, offset2 + limit).map((c2) => buildImageSummary2(editor, c2));
   return { total: allImages.length, items };
 }
 function imagesGetWrapper2(editor, input2) {
   const image3 = findImageById2(editor, input2.imageId);
-  return buildImageSummary2(image3);
+  return buildImageSummary2(editor, image3);
 }
 function createImageWrapper2(editor, input2, options) {
   rejectTrackedMode2("create.image", options);
@@ -314486,6 +316195,397 @@ function imagesSetZOrderWrapper2(editor, input2, options) {
   const updated = findImageById2(editor, input2.imageId);
   return buildSuccessResult2(updated);
 }
+function imagesScaleWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.scale", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  const currentSize = image3.node.attrs.size;
+  if (!isFinitePositive4(currentSize?.width) || !isFinitePositive4(currentSize?.height)) {
+    throw new DocumentApiAdapterError3("INVALID_TARGET", "Image has no explicit size; use setSize first.");
+  }
+  const newSize = {
+    width: Math.max(1, Math.round(currentSize.width * input2.factor)),
+    height: Math.max(1, Math.round(currentSize.height * input2.factor))
+  };
+  if (newSize.width === currentSize.width && newSize.height === currentSize.height) {
+    return buildNoOpResult2("Scale produced no size change.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, { ...node4.attrs, size: newSize });
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Scale produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesSetLockAspectRatioWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.setLockAspectRatio", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  if ((image3.node.attrs.lockAspectRatio ?? true) === input2.locked) {
+    return buildNoOpResult2(`lockAspectRatio is already ${input2.locked}.`);
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, { ...node4.attrs, lockAspectRatio: input2.locked });
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Set lock aspect ratio produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesRotateWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.rotate", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  const currentRotation = image3.node.attrs.transformData?.rotation ?? 0;
+  if (currentRotation === input2.angle) {
+    return buildNoOpResult2(`Rotation is already ${input2.angle} degrees.`);
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node4.attrs,
+      transformData: { ...node4.attrs.transformData ?? {}, rotation: input2.angle }
+    });
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Rotate produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesFlipWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.flip", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  const current = image3.node.attrs.transformData ?? {};
+  const targetH = input2.horizontal ?? current.horizontalFlip ?? false;
+  const targetV = input2.vertical ?? current.verticalFlip ?? false;
+  if (targetH === (current.horizontalFlip ?? false) && targetV === (current.verticalFlip ?? false)) {
+    return buildNoOpResult2("Flip state is already as requested.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node4.attrs,
+      transformData: { ...node4.attrs.transformData ?? {}, horizontalFlip: targetH, verticalFlip: targetV }
+    });
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Flip produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function cropToClipPath2(crop) {
+  const { top = 0, right: right2 = 0, bottom: bottom2 = 0, left: left2 = 0 } = crop;
+  return `inset(${top}% ${right2}% ${bottom2}% ${left2}%)`;
+}
+function cropToRawSrcRect2(crop) {
+  const { top = 0, right: right2 = 0, bottom: bottom2 = 0, left: left2 = 0 } = crop;
+  return {
+    name: "a:srcRect",
+    attributes: {
+      l: String(Math.round(left2 * 1000)),
+      t: String(Math.round(top * 1000)),
+      r: String(Math.round(right2 * 1000)),
+      b: String(Math.round(bottom2 * 1000))
+    }
+  };
+}
+function imagesCropWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.crop", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  const newClipPath = cropToClipPath2(input2.crop);
+  if (image3.node.attrs.clipPath === newClipPath) {
+    return buildNoOpResult2("Crop values are already as requested.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node4.attrs,
+      clipPath: newClipPath,
+      rawSrcRect: cropToRawSrcRect2(input2.crop)
+    });
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Crop produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesResetCropWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.resetCrop", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  if (!image3.node.attrs.clipPath) {
+    return buildNoOpResult2("Image has no crop to reset.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, { ...node4.attrs, clipPath: null, rawSrcRect: null, shouldCover: false });
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Reset crop produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesReplaceSourceWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.replaceSource", options);
+  const isDataUri = input2.src.startsWith("data:");
+  const isInternalPath = input2.src.startsWith("word/media/");
+  if (!isDataUri && !isInternalPath) {
+    throw new DocumentApiAdapterError3("INVALID_INPUT", "External URLs are not supported in V1; provide a data URI or internal media path.");
+  }
+  const image3 = findImageById2(editor, input2.imageId);
+  const newAttrs = {
+    ...image3.node.attrs,
+    src: input2.src,
+    rId: null,
+    originalSrc: null,
+    originalExtension: null,
+    clipPath: null,
+    rawSrcRect: null,
+    shouldCover: false
+  };
+  if (input2.resetSize) {
+    if (!isDataUri) {
+      throw new DocumentApiAdapterError3("INVALID_INPUT", "Cannot determine intrinsic dimensions from internal path; set size explicitly via setSize after replacement.");
+    }
+    const dims = readImageDimensionsFromDataUri2(input2.src);
+    if (!dims) {
+      throw new DocumentApiAdapterError3("INVALID_INPUT", "Could not determine intrinsic dimensions from data URI.");
+    }
+    newAttrs.size = { width: dims.width, height: dims.height };
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, newAttrs);
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Replace source produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesSetAltTextWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.setAltText", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  if (image3.node.attrs.title === input2.description && !image3.node.attrs.decorative) {
+    return buildNoOpResult2("Alt text is already as requested.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, { ...node4.attrs, title: input2.description, decorative: false });
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Set alt text produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesSetDecorativeWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.setDecorative", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  if ((image3.node.attrs.decorative ?? false) === input2.decorative) {
+    return buildNoOpResult2(`Decorative is already ${input2.decorative}.`);
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, {
+      ...node4.attrs,
+      decorative: input2.decorative,
+      title: input2.decorative ? "" : node4.attrs.title
+    });
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Set decorative produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesSetNameWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.setName", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  if (image3.node.attrs.alt === input2.name) {
+    return buildNoOpResult2("Name is already as requested.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, { ...node4.attrs, alt: input2.name });
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Set name produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesSetHyperlinkWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.setHyperlink", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  const newValue = input2.url === null ? null : { url: input2.url, ...input2.tooltip ? { tooltip: input2.tooltip } : {} };
+  const current = image3.node.attrs.hyperlink ?? null;
+  if (current === null && newValue === null || current !== null && newValue !== null && current.url === newValue.url && current.tooltip === newValue.tooltip) {
+    return buildNoOpResult2("Hyperlink is already as requested.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const { pos, node: node4 } = image3;
+    const tr = editor.state.tr;
+    tr.setNodeMarkup(pos, undefined, { ...node4.attrs, hyperlink: newValue });
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Set hyperlink produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function findCaptionParagraph2(editor, imagePos) {
+  const $pos = editor.state.doc.resolve(imagePos);
+  const parentDepth = $pos.depth - 1;
+  if (parentDepth < 0)
+    return null;
+  const parentPos = $pos.before(parentDepth + 1);
+  const parentNode2 = $pos.node(parentDepth + 1);
+  const afterParentPos = parentPos + parentNode2.nodeSize;
+  if (afterParentPos >= editor.state.doc.content.size)
+    return null;
+  const nextNode = editor.state.doc.nodeAt(afterParentPos);
+  if (!nextNode || nextNode.type.name !== "paragraph")
+    return null;
+  if (nextNode.attrs?.paragraphProperties?.styleId !== "Caption")
+    return null;
+  return { pos: afterParentPos, node: nextNode };
+}
+function requireSoleImageInParagraph2(editor, imagePos) {
+  const $pos = editor.state.doc.resolve(imagePos);
+  const parentDepth = $pos.depth - 1;
+  if (parentDepth < 0) {
+    throw new DocumentApiAdapterError3("INVALID_TARGET", "Caption operations require the image to be inside a paragraph.");
+  }
+  const parentNode2 = $pos.node(parentDepth + 1);
+  let inlineContentCount = 0;
+  parentNode2.forEach((child) => {
+    if (child.isInline)
+      inlineContentCount++;
+  });
+  if (inlineContentCount !== 1) {
+    throw new DocumentApiAdapterError3("INVALID_TARGET", "Caption operations require the image to be the sole content of its paragraph.");
+  }
+}
+function imagesInsertCaptionWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.insertCaption", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  requireSoleImageInParagraph2(editor, image3.pos);
+  const existing = findCaptionParagraph2(editor, image3.pos);
+  if (existing) {
+    throw new DocumentApiAdapterError3("INVALID_TARGET", "Image already has a caption; use updateCaption.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const $pos = editor.state.doc.resolve(image3.pos);
+    const parentDepth = $pos.depth - 1;
+    const parentPos = $pos.before(parentDepth + 1);
+    const parentNode2 = $pos.node(parentDepth + 1);
+    const afterParentPos = parentPos + parentNode2.nodeSize;
+    const tr = editor.state.tr;
+    const captionPara = editor.state.schema.nodes.paragraph.create({ paragraphProperties: { styleId: "Caption" } }, editor.state.schema.text(input2.text));
+    tr.insert(afterParentPos, captionPara);
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Insert caption produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesUpdateCaptionWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.updateCaption", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  requireSoleImageInParagraph2(editor, image3.pos);
+  const caption = findCaptionParagraph2(editor, image3.pos);
+  if (!caption) {
+    throw new DocumentApiAdapterError3("INVALID_TARGET", "No caption paragraph found; use insertCaption first.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const tr = editor.state.tr;
+    const textStart = caption.pos + 1;
+    const textEnd = caption.pos + caption.node.nodeSize - 1;
+    tr.replaceWith(textStart, textEnd, editor.state.schema.text(input2.text));
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Update caption produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
+function imagesRemoveCaptionWrapper2(editor, input2, options) {
+  rejectTrackedMode2("images.removeCaption", options);
+  const image3 = findImageById2(editor, input2.imageId);
+  requireSoleImageInParagraph2(editor, image3.pos);
+  const caption = findCaptionParagraph2(editor, image3.pos);
+  if (!caption) {
+    return buildNoOpResult2("No caption to remove.");
+  }
+  if (options?.dryRun)
+    return buildSuccessResult2(image3);
+  const receipt2 = executeDomainCommand2(editor, () => {
+    const tr = editor.state.tr;
+    tr.delete(caption.pos, caption.pos + caption.node.nodeSize);
+    if (!tr.docChanged)
+      return false;
+    editor.dispatch(tr);
+    return true;
+  });
+  if (receipt2.steps[0]?.effect !== "changed")
+    return buildNoOpResult2("Remove caption produced no change.");
+  return buildSuccessResult2(findImageById2(editor, input2.imageId));
+}
 var ALLOWED_WRAP_ATTRS2, WRAP_TYPES_SUPPORTING_SIDE2, WRAP_TYPES_SUPPORTING_DISTANCES2, RELATIVE_HEIGHT_MIN3 = 0, RELATIVE_HEIGHT_MAX3 = 4294967295;
 var init_images_wrappers = __esm(() => {
   init_wrapper();
@@ -315246,7 +317346,21 @@ function assembleDocumentApiAdapters2(editor) {
       setWrapDistances: (input2, options) => imagesSetWrapDistancesWrapper2(editor, input2, options),
       setPosition: (input2, options) => imagesSetPositionWrapper2(editor, input2, options),
       setAnchorOptions: (input2, options) => imagesSetAnchorOptionsWrapper2(editor, input2, options),
-      setZOrder: (input2, options) => imagesSetZOrderWrapper2(editor, input2, options)
+      setZOrder: (input2, options) => imagesSetZOrderWrapper2(editor, input2, options),
+      scale: (input2, options) => imagesScaleWrapper2(editor, input2, options),
+      setLockAspectRatio: (input2, options) => imagesSetLockAspectRatioWrapper2(editor, input2, options),
+      rotate: (input2, options) => imagesRotateWrapper2(editor, input2, options),
+      flip: (input2, options) => imagesFlipWrapper2(editor, input2, options),
+      crop: (input2, options) => imagesCropWrapper2(editor, input2, options),
+      resetCrop: (input2, options) => imagesResetCropWrapper2(editor, input2, options),
+      replaceSource: (input2, options) => imagesReplaceSourceWrapper2(editor, input2, options),
+      setAltText: (input2, options) => imagesSetAltTextWrapper2(editor, input2, options),
+      setDecorative: (input2, options) => imagesSetDecorativeWrapper2(editor, input2, options),
+      setName: (input2, options) => imagesSetNameWrapper2(editor, input2, options),
+      setHyperlink: (input2, options) => imagesSetHyperlinkWrapper2(editor, input2, options),
+      insertCaption: (input2, options) => imagesInsertCaptionWrapper2(editor, input2, options),
+      updateCaption: (input2, options) => imagesUpdateCaptionWrapper2(editor, input2, options),
+      removeCaption: (input2, options) => imagesRemoveCaptionWrapper2(editor, input2, options)
     },
     hyperlinks: {
       list: (query2) => hyperlinksListWrapper2(editor, query2),
@@ -368495,6 +370609,25 @@ var init_collaboration = __esm(() => {
 });
 
 // src/lib/bootstrap.ts
+function waitForContentSettling(ydoc, maxWaitMs = CONTENT_SETTLING_MAX_MS) {
+  if (detectRoomState(ydoc) === "populated")
+    return Promise.resolve();
+  const fragment = ydoc.getXmlFragment("supereditor");
+  return new Promise((resolve4) => {
+    const timeout2 = setTimeout(() => {
+      fragment.unobserve(observer);
+      resolve4();
+    }, maxWaitMs);
+    const observer = () => {
+      if (fragment.length > 0) {
+        clearTimeout(timeout2);
+        fragment.unobserve(observer);
+        resolve4();
+      }
+    };
+    fragment.observe(observer);
+  });
+}
 function detectRoomState(ydoc) {
   const fragment = ydoc.getXmlFragment("supereditor");
   if (fragment.length > 0)
@@ -368523,6 +370656,9 @@ function resolveBootstrapDecision(roomState, onMissing, hasDoc) {
       return { action: "error", reason: 'Collaboration room is empty and onMissing is set to "error".' };
   }
 }
+function clearBootstrapMarker(ydoc) {
+  ydoc.getMap("meta").delete("bootstrap");
+}
 function writeBootstrapMarker(ydoc, source) {
   const metaMap = ydoc.getMap("meta");
   const marker = {
@@ -368605,7 +370741,7 @@ async function detectBootstrapRace(ydoc, observeMs = POST_SEED_OBSERVE_MS) {
     observer.dispose();
   }
 }
-var DEFAULT_BOOTSTRAP_SETTLING_MS = 1500, DEFAULT_BOOTSTRAP_JITTER_MS = 150, POST_SEED_OBSERVE_MS = 200;
+var DEFAULT_BOOTSTRAP_SETTLING_MS = 1500, DEFAULT_BOOTSTRAP_JITTER_MS = 150, POST_SEED_OBSERVE_MS = 200, CONTENT_SETTLING_MAX_MS = 200;
 
 // src/lib/document.ts
 import { readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
@@ -368747,6 +370883,7 @@ async function openCollaborativeDocument(doc4, io, profile, options2 = {}) {
   const runtime = createCollaborationRuntime(profile);
   try {
     await runtime.waitForSync();
+    await waitForContentSettling(runtime.ydoc);
     const onMissing = profile.onMissing ?? "seedFromDoc";
     let finalRoomState = detectRoomState(runtime.ydoc);
     let decision = resolveBootstrapDecision(finalRoomState, onMissing, doc4 != null);
@@ -368755,6 +370892,13 @@ async function openCollaborativeDocument(doc4, io, profile, options2 = {}) {
       if (!claim.granted) {
         finalRoomState = detectRoomState(runtime.ydoc);
         decision = { action: "join" };
+      } else {
+        const postClaimState = detectRoomState(runtime.ydoc);
+        if (postClaimState === "populated") {
+          clearBootstrapMarker(runtime.ydoc);
+          finalRoomState = postClaimState;
+          decision = { action: "join" };
+        }
       }
     }
     if (decision.action === "error") {