@pixerate/editor 0.80.0 → 0.82.0

package/dist/image-editor/index.d.cts

@@ -1,5 +1,6 @@
 import { b as LoadReport, J as JsonObject, f as MigrationStep } from '../migrate-iTlm3a8h.cjs';
-import { A as AgentToolProvider, b as AgentTool } from '../registry-DIpIaCkH.cjs';
+import { a as AgentToolProvider, A as AgentTool } from '../registry-BqA1AZt0.cjs';
+import { b as CaptureSurface } from '../capture-DFEMFmVt.cjs';
 import '../schema-Di0CS6Pe.cjs';
 
 /**
@@ -1330,6 +1331,16 @@ declare class ImageEditorController {
     setComparing(comparing: boolean): void;
     render(targetCanvas: HTMLCanvasElement, options?: RenderOptions): Promise<void>;
     renderExport(options?: ExportOptions): Promise<HTMLCanvasElement>;
+    /**
+     * Renders the edited image (adjustments, layers and, by default, annotations) in the
+     * source image's own orientation and frame, ignoring crop, rotation and flips, so it lines
+     * up with natural-pixel coordinates (selections, `select_region`). `scale` ≤ 1 shrinks it.
+     * Returns `null` when no image is loaded.
+     */
+    renderSourceView(options?: {
+        scale?: number;
+        includeAnnotations?: boolean;
+    }): Promise<HTMLCanvasElement | null>;
     toDataURL(options?: ExportOptions): Promise<string>;
     toBlob(options?: ExportOptions): Promise<Blob>;
     renderMask(options?: {
@@ -1638,8 +1649,13 @@ interface ImageEditorToolProviderOptions {
  *   control ranges and the applied values are echoed.
  * - `add_adjustment_layer {kind, params?, opacity?, blend?, name?}`.
  * - `render_preview {maxSide}`: the rendered image as a PNG, longest side at most `maxSide`.
+ * - `capture_view {region, rect?, ...}`: a screenshot of the whole image, the selection or a rect in
+ *   natural pixels (up to 8× for close inspection), optionally with the selection shaded.
  * - Selections and masks: `get_selection`, `select_region`, `select_by_color`, `modify_selection`,
  *   `refine_selection`, `apply_selection_as_mask` (see `createImageSelectionTools`).
+ * - Layers, geometry and history: `get_image_info`, `get_histogram`, `update_adjustment_layer`,
+ *   `remove_adjustment_layer`, `move_adjustment_layer`, `set_crop`, `reset_crop`, `set_rotation`,
+ *   `flip_image`, `undo_image`, `redo_image` (see `createImageEditTools`).
  */
 declare function createImageEditorToolProvider(controller: ImageEditorController, options?: ImageEditorToolProviderOptions): AgentToolProvider;
 
@@ -1768,6 +1784,14 @@ declare class SelectionGesture {
  */
 declare function createImageSelectionTools(controller: ImageEditorController): AgentTool[];
 
+/**
+ * Agent tools for the image editor's layers, geometry and history: `get_image_info`,
+ * `get_histogram`, `update_adjustment_layer`, `remove_adjustment_layer`,
+ * `move_adjustment_layer`, `set_crop`, `reset_crop`, `set_rotation`, `flip_image`,
+ * `undo_image` and `redo_image`. Each write is one undo step and returns what changed.
+ */
+declare function createImageEditTools(controller: ImageEditorController): AgentTool[];
+
 /**
  * Region-based mosaic (pixelation) and box-blur filters for redacting or anonymizing
  * rectangular bounding boxes on an ImageData-like buffer.
@@ -1809,4 +1833,13 @@ declare function applyRegionMosaic<T extends MosaicImageDataLike>(imageData: T,
  */
 declare function applyRegionBlur<T extends MosaicImageDataLike>(imageData: T, regions: MosaicRegion[], radius?: number): T;
 
-export { ADJUSTMENT_KINDS, ADJUSTMENT_LAYER_CONTROLS, ADJUSTMENT_LAYER_OPACITY_CONTROL, ADJUSTMENT_LUT_SIZE, AS_SHOT_KELVIN, type AdjustmentKind, type AdjustmentKindInfo, type AdjustmentLayer, type AdjustmentLayerBase, type AdjustmentLayerInit, type AdjustmentLayerMask, type AdjustmentLayerOf, type AdjustmentLayerUpdate, type AdjustmentParamsMap, type Annotation, type AnnotationType, type ArrowAnnotation, type AspectRatio, BLEND_MODES, type BaseAnnotation, type BlackWhiteParams, type BlendMode, type BlendModeInfo, type Chromaticity, type CircleAnnotation, type ColorBalanceParams, type ColorBalanceTone, type ColorDistance, type ColorRangeOptions, type ColorRangeSample, type ControlSection, type ControlSpec, type ControlTrack, type CreateAnnotationPayload, type CropBox, type CropHandle, type CurvePoint, type CurvesParams, D65, DEFAULT_ADJUSTMENTS, DEFAULT_DEPTH_MASK, DEFAULT_REFINE_EDGE_PARAMS, DEFAULT_SELECTION_TOOL_OPTIONS, DEFAULT_TRANSFORM, DIRECT_GAUSSIAN_MAX_SIGMA, type DepthMaskOptions, EMPTY_DISTANCE, type ExportOptions, GUIDED_FILTER_EPS, type GestureModifiers, HISTOGRAM_BINS, HUE_RANGE_LABELS, type HistogramChannel, type HueRange, type HueSaturationParams, IDENTITY_MATRIX3, IMAGE_ADJUSTMENT_CONTROLS, IMAGE_EDITOR_SCHEMA_VERSION, IMAGE_EDITOR_STATE_VERSION, type ImageAdjustments, type ImageAnnotation, type ImageDimensions, type ImageEditorAIHooks, ImageEditorController, type ImageEditorDocumentLoad, type ImageEditorOptions, ImageEditorRenderer, type ImageEditorState, type ImageEditorTool, type ImageEditorToolProviderOptions, type ImageHistogram, type ImagePoint, type ImageProcessVersion, type ImageProjection, type ImageTransform, type InpaintHook, type InpaintOptions, type InvertParams, LATEST_PROCESS_VERSION, LEGACY_PROCESS_VERSION, LUMA_709, type LayerMaskProps, type LevelsChannel, type LevelsParams, type LineAnnotation, MAX_KELVIN, MIN_KELVIN, MIRED_PER_TEMPERATURE_UNIT, type MagicWandOptions, type Matrix3, type MosaicImageDataLike, type MosaicRegion, type PenAnnotation, type PhotoFilterParams, type PixelBuffer, type PixelOp, type PosterizeParams, type QuickMaskStyle, REFINE_EDGE_CONTROLS, type RectAnnotation, type RefineEdgeControl, type RefineEdgeParams, type RemoveBackgroundHook, type RemoveBackgroundOptions, type RenderOptions, type Rgb$1 as Rgb, type Rgba, SELECTION_MODES, SELECTION_MODE_LABELS, SELECTION_MODIFY_OPS, SELECTION_TOOLS, type SampleOptions, type SelectionChannel, type SelectionCommandOptions, SelectionGesture, type SelectionMask, type SelectionMode, type SelectionModifyOp, type SelectionToolKind, type SelectionToolOptions, type SerializedImageEditorState, type SerializedSelection, type ShapeSelectionOptions, TINT_SCALE, TONE_LUT_SIZE, TONE_RANGE_PRESETS, type TextAnnotation, type ThresholdParams, type ToneRangePreset, type UnitLevels, VIBRANCE_GREY, type VibranceParams, type ViewportMetrics, activeAdjustmentLayers, adjustmentKindLabel, adjustmentLayersKey, applyAdjustmentLayers, applyAdjustments, applyDepthMask, applyImageProjectionToContext, applyLegacyAdjustments, applyMatrix3, applyProcess2Adjustments, applyRegionBlur, applyRegionMosaic, blackWhiteGray, blendChannel, blendImageData, blendLum, blendPixel, blendRgb, borderCoverage, boxMean, boxToCurvePoint, bradfordAdaptation, buildLayerMaskPlanes, buildToneLut, calculateCropDrag, canvasCompositeOperation, canvasToImagePoint, clampControlValue, clampCropToImage, colorBalanceChannel, colorRange, combineSelections, compileAdjustmentLayer, computeHistogram, computeSelectionBounds, contractCoverage, controlPosition, controlTrackBackground, coverageToByte, createAdjustmentLayer, createImageEditorToolProvider, createImageSelectionTools, createSelectionMask, curveLut, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerMask, decodeSelectionRle, defaultAdjustmentParams, describeSelection, deserializeSelection, distanceTransform, edgeWidth, ellipsePoints, ellipseSelection, encodeSelectionRle, evaluateAdjustmentLayers, expandCoverage, featherCoverage, findAdjustmentControl, findLayerControl, formatControlValue, fullSelection, gaussianBlur, getAnnotationBounds, getControlPath, getCropCursor, getRotatedSize, getViewportMetrics, getViewportProjection, globalImageCache, greyMorphology, guidePlanes, guidedFilterColor, hashMaskContent, hexToRgb, histogramPath, hitTestAnnotation, hitTestCrop, hitTestCurvePoint, hslToRgb, hueRange, hueRangeTables, hueRangeWeight, hueSaturation, identityCurve, identityLevels, imageEditorStateMigrations, imageToCanvasPoint, insertCurvePoint, invertMatrix3, invertSelection, isAdjustmentKind, isBlendMode, isQuarterTurnSwapped, isSelectionEmpty, isSelectionMode, isSeparableBlendMode, kelvinToTemperature, layerMaskCoverage, layerMaskFromSelection, layerMaskKey, levelsValue, linearSrgbToXy, linearToSrgb, loadImageEditorDocument, magicWand, mapCropHandle, migrateSerializedImageEditorState, modifySelection, moveCurvePoint, mulMatrix3, neutralHueRange, normalizeAdjustmentLayer, normalizeAdjustmentLayers, normalizeAngle, normalizeBlendMode, normalizeLayerMask, normalizeProcessVersion, normalizeRect, normalizeRefineEdgeParams, normalizeStoredAdjustments, parseSelectionMode, photoFilterMatrix, polygonCoverage, polygonSelection, posterizeValue, projectImagePoint, projectImageRect, projectMaskCoverage, quickMaskPixels, rangeLightness, readAdjustmentControls, rectSelection, refineCoverage, refineEdgeHalo, refineSelection, removeAlpha, removeCurvePoint, resizeSelection, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeSelection, setControlPath, setLum, shiftCoverage, smoothCoverage, srgb8ToLab, srgbToLinear, tempTintToXy, temperatureToKelvin, toneCurve, toneLuts, toneRange, unprojectCanvasPoint, updateLayerMaskProps, uvToXy, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, xyToTempTint, xyToUv };
+/**
+ * The image editor as a capture surface. Units are natural pixels of the source image,
+ * the same space as `get_selection` and `select_region`: crop, rotation and flips are not
+ * applied (use `render_preview` for the final framing), adjustments, layers and annotations
+ * are. Regions: the whole image, the selection's bounds, or a rect. Small regions are
+ * enlarged up to 8× with hard pixel edges for close inspection.
+ */
+declare function createImageCaptureSurface(controller: ImageEditorController): CaptureSurface;
+
+export { ADJUSTMENT_KINDS, ADJUSTMENT_LAYER_CONTROLS, ADJUSTMENT_LAYER_OPACITY_CONTROL, ADJUSTMENT_LUT_SIZE, AS_SHOT_KELVIN, type AdjustmentKind, type AdjustmentKindInfo, type AdjustmentLayer, type AdjustmentLayerBase, type AdjustmentLayerInit, type AdjustmentLayerMask, type AdjustmentLayerOf, type AdjustmentLayerUpdate, type AdjustmentParamsMap, type Annotation, type AnnotationType, type ArrowAnnotation, type AspectRatio, BLEND_MODES, type BaseAnnotation, type BlackWhiteParams, type BlendMode, type BlendModeInfo, type Chromaticity, type CircleAnnotation, type ColorBalanceParams, type ColorBalanceTone, type ColorDistance, type ColorRangeOptions, type ColorRangeSample, type ControlSection, type ControlSpec, type ControlTrack, type CreateAnnotationPayload, type CropBox, type CropHandle, type CurvePoint, type CurvesParams, D65, DEFAULT_ADJUSTMENTS, DEFAULT_DEPTH_MASK, DEFAULT_REFINE_EDGE_PARAMS, DEFAULT_SELECTION_TOOL_OPTIONS, DEFAULT_TRANSFORM, DIRECT_GAUSSIAN_MAX_SIGMA, type DepthMaskOptions, EMPTY_DISTANCE, type ExportOptions, GUIDED_FILTER_EPS, type GestureModifiers, HISTOGRAM_BINS, HUE_RANGE_LABELS, type HistogramChannel, type HueRange, type HueSaturationParams, IDENTITY_MATRIX3, IMAGE_ADJUSTMENT_CONTROLS, IMAGE_EDITOR_SCHEMA_VERSION, IMAGE_EDITOR_STATE_VERSION, type ImageAdjustments, type ImageAnnotation, type ImageDimensions, type ImageEditorAIHooks, ImageEditorController, type ImageEditorDocumentLoad, type ImageEditorOptions, ImageEditorRenderer, type ImageEditorState, type ImageEditorTool, type ImageEditorToolProviderOptions, type ImageHistogram, type ImagePoint, type ImageProcessVersion, type ImageProjection, type ImageTransform, type InpaintHook, type InpaintOptions, type InvertParams, LATEST_PROCESS_VERSION, LEGACY_PROCESS_VERSION, LUMA_709, type LayerMaskProps, type LevelsChannel, type LevelsParams, type LineAnnotation, MAX_KELVIN, MIN_KELVIN, MIRED_PER_TEMPERATURE_UNIT, type MagicWandOptions, type Matrix3, type MosaicImageDataLike, type MosaicRegion, type PenAnnotation, type PhotoFilterParams, type PixelBuffer, type PixelOp, type PosterizeParams, type QuickMaskStyle, REFINE_EDGE_CONTROLS, type RectAnnotation, type RefineEdgeControl, type RefineEdgeParams, type RemoveBackgroundHook, type RemoveBackgroundOptions, type RenderOptions, type Rgb$1 as Rgb, type Rgba, SELECTION_MODES, SELECTION_MODE_LABELS, SELECTION_MODIFY_OPS, SELECTION_TOOLS, type SampleOptions, type SelectionChannel, type SelectionCommandOptions, SelectionGesture, type SelectionMask, type SelectionMode, type SelectionModifyOp, type SelectionToolKind, type SelectionToolOptions, type SerializedImageEditorState, type SerializedSelection, type ShapeSelectionOptions, TINT_SCALE, TONE_LUT_SIZE, TONE_RANGE_PRESETS, type TextAnnotation, type ThresholdParams, type ToneRangePreset, type UnitLevels, VIBRANCE_GREY, type VibranceParams, type ViewportMetrics, activeAdjustmentLayers, adjustmentKindLabel, adjustmentLayersKey, applyAdjustmentLayers, applyAdjustments, applyDepthMask, applyImageProjectionToContext, applyLegacyAdjustments, applyMatrix3, applyProcess2Adjustments, applyRegionBlur, applyRegionMosaic, blackWhiteGray, blendChannel, blendImageData, blendLum, blendPixel, blendRgb, borderCoverage, boxMean, boxToCurvePoint, bradfordAdaptation, buildLayerMaskPlanes, buildToneLut, calculateCropDrag, canvasCompositeOperation, canvasToImagePoint, clampControlValue, clampCropToImage, colorBalanceChannel, colorRange, combineSelections, compileAdjustmentLayer, computeHistogram, computeSelectionBounds, contractCoverage, controlPosition, controlTrackBackground, coverageToByte, createAdjustmentLayer, createImageCaptureSurface, createImageEditTools, createImageEditorToolProvider, createImageSelectionTools, createSelectionMask, curveLut, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerMask, decodeSelectionRle, defaultAdjustmentParams, describeSelection, deserializeSelection, distanceTransform, edgeWidth, ellipsePoints, ellipseSelection, encodeSelectionRle, evaluateAdjustmentLayers, expandCoverage, featherCoverage, findAdjustmentControl, findLayerControl, formatControlValue, fullSelection, gaussianBlur, getAnnotationBounds, getControlPath, getCropCursor, getRotatedSize, getViewportMetrics, getViewportProjection, globalImageCache, greyMorphology, guidePlanes, guidedFilterColor, hashMaskContent, hexToRgb, histogramPath, hitTestAnnotation, hitTestCrop, hitTestCurvePoint, hslToRgb, hueRange, hueRangeTables, hueRangeWeight, hueSaturation, identityCurve, identityLevels, imageEditorStateMigrations, imageToCanvasPoint, insertCurvePoint, invertMatrix3, invertSelection, isAdjustmentKind, isBlendMode, isQuarterTurnSwapped, isSelectionEmpty, isSelectionMode, isSeparableBlendMode, kelvinToTemperature, layerMaskCoverage, layerMaskFromSelection, layerMaskKey, levelsValue, linearSrgbToXy, linearToSrgb, loadImageEditorDocument, magicWand, mapCropHandle, migrateSerializedImageEditorState, modifySelection, moveCurvePoint, mulMatrix3, neutralHueRange, normalizeAdjustmentLayer, normalizeAdjustmentLayers, normalizeAngle, normalizeBlendMode, normalizeLayerMask, normalizeProcessVersion, normalizeRect, normalizeRefineEdgeParams, normalizeStoredAdjustments, parseSelectionMode, photoFilterMatrix, polygonCoverage, polygonSelection, posterizeValue, projectImagePoint, projectImageRect, projectMaskCoverage, quickMaskPixels, rangeLightness, readAdjustmentControls, rectSelection, refineCoverage, refineEdgeHalo, refineSelection, removeAlpha, removeCurvePoint, resizeSelection, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeSelection, setControlPath, setLum, shiftCoverage, smoothCoverage, srgb8ToLab, srgbToLinear, tempTintToXy, temperatureToKelvin, toneCurve, toneLuts, toneRange, unprojectCanvasPoint, updateLayerMaskProps, uvToXy, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, xyToTempTint, xyToUv };

package/dist/image-editor/index.d.ts

@@ -1,5 +1,6 @@
 import { b as LoadReport, J as JsonObject, f as MigrationStep } from '../migrate-iTlm3a8h.js';
-import { A as AgentToolProvider, b as AgentTool } from '../registry-7AZFuand.js';
+import { a as AgentToolProvider, A as AgentTool } from '../registry-D-4fit9C.js';
+import { b as CaptureSurface } from '../capture-wwNGaW05.js';
 import '../schema-Di0CS6Pe.js';
 
 /**
@@ -1330,6 +1331,16 @@ declare class ImageEditorController {
     setComparing(comparing: boolean): void;
     render(targetCanvas: HTMLCanvasElement, options?: RenderOptions): Promise<void>;
     renderExport(options?: ExportOptions): Promise<HTMLCanvasElement>;
+    /**
+     * Renders the edited image (adjustments, layers and, by default, annotations) in the
+     * source image's own orientation and frame, ignoring crop, rotation and flips, so it lines
+     * up with natural-pixel coordinates (selections, `select_region`). `scale` ≤ 1 shrinks it.
+     * Returns `null` when no image is loaded.
+     */
+    renderSourceView(options?: {
+        scale?: number;
+        includeAnnotations?: boolean;
+    }): Promise<HTMLCanvasElement | null>;
     toDataURL(options?: ExportOptions): Promise<string>;
     toBlob(options?: ExportOptions): Promise<Blob>;
     renderMask(options?: {
@@ -1638,8 +1649,13 @@ interface ImageEditorToolProviderOptions {
  *   control ranges and the applied values are echoed.
  * - `add_adjustment_layer {kind, params?, opacity?, blend?, name?}`.
  * - `render_preview {maxSide}`: the rendered image as a PNG, longest side at most `maxSide`.
+ * - `capture_view {region, rect?, ...}`: a screenshot of the whole image, the selection or a rect in
+ *   natural pixels (up to 8× for close inspection), optionally with the selection shaded.
  * - Selections and masks: `get_selection`, `select_region`, `select_by_color`, `modify_selection`,
  *   `refine_selection`, `apply_selection_as_mask` (see `createImageSelectionTools`).
+ * - Layers, geometry and history: `get_image_info`, `get_histogram`, `update_adjustment_layer`,
+ *   `remove_adjustment_layer`, `move_adjustment_layer`, `set_crop`, `reset_crop`, `set_rotation`,
+ *   `flip_image`, `undo_image`, `redo_image` (see `createImageEditTools`).
  */
 declare function createImageEditorToolProvider(controller: ImageEditorController, options?: ImageEditorToolProviderOptions): AgentToolProvider;
 
@@ -1768,6 +1784,14 @@ declare class SelectionGesture {
  */
 declare function createImageSelectionTools(controller: ImageEditorController): AgentTool[];
 
+/**
+ * Agent tools for the image editor's layers, geometry and history: `get_image_info`,
+ * `get_histogram`, `update_adjustment_layer`, `remove_adjustment_layer`,
+ * `move_adjustment_layer`, `set_crop`, `reset_crop`, `set_rotation`, `flip_image`,
+ * `undo_image` and `redo_image`. Each write is one undo step and returns what changed.
+ */
+declare function createImageEditTools(controller: ImageEditorController): AgentTool[];
+
 /**
  * Region-based mosaic (pixelation) and box-blur filters for redacting or anonymizing
  * rectangular bounding boxes on an ImageData-like buffer.
@@ -1809,4 +1833,13 @@ declare function applyRegionMosaic<T extends MosaicImageDataLike>(imageData: T,
  */
 declare function applyRegionBlur<T extends MosaicImageDataLike>(imageData: T, regions: MosaicRegion[], radius?: number): T;
 
-export { ADJUSTMENT_KINDS, ADJUSTMENT_LAYER_CONTROLS, ADJUSTMENT_LAYER_OPACITY_CONTROL, ADJUSTMENT_LUT_SIZE, AS_SHOT_KELVIN, type AdjustmentKind, type AdjustmentKindInfo, type AdjustmentLayer, type AdjustmentLayerBase, type AdjustmentLayerInit, type AdjustmentLayerMask, type AdjustmentLayerOf, type AdjustmentLayerUpdate, type AdjustmentParamsMap, type Annotation, type AnnotationType, type ArrowAnnotation, type AspectRatio, BLEND_MODES, type BaseAnnotation, type BlackWhiteParams, type BlendMode, type BlendModeInfo, type Chromaticity, type CircleAnnotation, type ColorBalanceParams, type ColorBalanceTone, type ColorDistance, type ColorRangeOptions, type ColorRangeSample, type ControlSection, type ControlSpec, type ControlTrack, type CreateAnnotationPayload, type CropBox, type CropHandle, type CurvePoint, type CurvesParams, D65, DEFAULT_ADJUSTMENTS, DEFAULT_DEPTH_MASK, DEFAULT_REFINE_EDGE_PARAMS, DEFAULT_SELECTION_TOOL_OPTIONS, DEFAULT_TRANSFORM, DIRECT_GAUSSIAN_MAX_SIGMA, type DepthMaskOptions, EMPTY_DISTANCE, type ExportOptions, GUIDED_FILTER_EPS, type GestureModifiers, HISTOGRAM_BINS, HUE_RANGE_LABELS, type HistogramChannel, type HueRange, type HueSaturationParams, IDENTITY_MATRIX3, IMAGE_ADJUSTMENT_CONTROLS, IMAGE_EDITOR_SCHEMA_VERSION, IMAGE_EDITOR_STATE_VERSION, type ImageAdjustments, type ImageAnnotation, type ImageDimensions, type ImageEditorAIHooks, ImageEditorController, type ImageEditorDocumentLoad, type ImageEditorOptions, ImageEditorRenderer, type ImageEditorState, type ImageEditorTool, type ImageEditorToolProviderOptions, type ImageHistogram, type ImagePoint, type ImageProcessVersion, type ImageProjection, type ImageTransform, type InpaintHook, type InpaintOptions, type InvertParams, LATEST_PROCESS_VERSION, LEGACY_PROCESS_VERSION, LUMA_709, type LayerMaskProps, type LevelsChannel, type LevelsParams, type LineAnnotation, MAX_KELVIN, MIN_KELVIN, MIRED_PER_TEMPERATURE_UNIT, type MagicWandOptions, type Matrix3, type MosaicImageDataLike, type MosaicRegion, type PenAnnotation, type PhotoFilterParams, type PixelBuffer, type PixelOp, type PosterizeParams, type QuickMaskStyle, REFINE_EDGE_CONTROLS, type RectAnnotation, type RefineEdgeControl, type RefineEdgeParams, type RemoveBackgroundHook, type RemoveBackgroundOptions, type RenderOptions, type Rgb$1 as Rgb, type Rgba, SELECTION_MODES, SELECTION_MODE_LABELS, SELECTION_MODIFY_OPS, SELECTION_TOOLS, type SampleOptions, type SelectionChannel, type SelectionCommandOptions, SelectionGesture, type SelectionMask, type SelectionMode, type SelectionModifyOp, type SelectionToolKind, type SelectionToolOptions, type SerializedImageEditorState, type SerializedSelection, type ShapeSelectionOptions, TINT_SCALE, TONE_LUT_SIZE, TONE_RANGE_PRESETS, type TextAnnotation, type ThresholdParams, type ToneRangePreset, type UnitLevels, VIBRANCE_GREY, type VibranceParams, type ViewportMetrics, activeAdjustmentLayers, adjustmentKindLabel, adjustmentLayersKey, applyAdjustmentLayers, applyAdjustments, applyDepthMask, applyImageProjectionToContext, applyLegacyAdjustments, applyMatrix3, applyProcess2Adjustments, applyRegionBlur, applyRegionMosaic, blackWhiteGray, blendChannel, blendImageData, blendLum, blendPixel, blendRgb, borderCoverage, boxMean, boxToCurvePoint, bradfordAdaptation, buildLayerMaskPlanes, buildToneLut, calculateCropDrag, canvasCompositeOperation, canvasToImagePoint, clampControlValue, clampCropToImage, colorBalanceChannel, colorRange, combineSelections, compileAdjustmentLayer, computeHistogram, computeSelectionBounds, contractCoverage, controlPosition, controlTrackBackground, coverageToByte, createAdjustmentLayer, createImageEditorToolProvider, createImageSelectionTools, createSelectionMask, curveLut, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerMask, decodeSelectionRle, defaultAdjustmentParams, describeSelection, deserializeSelection, distanceTransform, edgeWidth, ellipsePoints, ellipseSelection, encodeSelectionRle, evaluateAdjustmentLayers, expandCoverage, featherCoverage, findAdjustmentControl, findLayerControl, formatControlValue, fullSelection, gaussianBlur, getAnnotationBounds, getControlPath, getCropCursor, getRotatedSize, getViewportMetrics, getViewportProjection, globalImageCache, greyMorphology, guidePlanes, guidedFilterColor, hashMaskContent, hexToRgb, histogramPath, hitTestAnnotation, hitTestCrop, hitTestCurvePoint, hslToRgb, hueRange, hueRangeTables, hueRangeWeight, hueSaturation, identityCurve, identityLevels, imageEditorStateMigrations, imageToCanvasPoint, insertCurvePoint, invertMatrix3, invertSelection, isAdjustmentKind, isBlendMode, isQuarterTurnSwapped, isSelectionEmpty, isSelectionMode, isSeparableBlendMode, kelvinToTemperature, layerMaskCoverage, layerMaskFromSelection, layerMaskKey, levelsValue, linearSrgbToXy, linearToSrgb, loadImageEditorDocument, magicWand, mapCropHandle, migrateSerializedImageEditorState, modifySelection, moveCurvePoint, mulMatrix3, neutralHueRange, normalizeAdjustmentLayer, normalizeAdjustmentLayers, normalizeAngle, normalizeBlendMode, normalizeLayerMask, normalizeProcessVersion, normalizeRect, normalizeRefineEdgeParams, normalizeStoredAdjustments, parseSelectionMode, photoFilterMatrix, polygonCoverage, polygonSelection, posterizeValue, projectImagePoint, projectImageRect, projectMaskCoverage, quickMaskPixels, rangeLightness, readAdjustmentControls, rectSelection, refineCoverage, refineEdgeHalo, refineSelection, removeAlpha, removeCurvePoint, resizeSelection, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeSelection, setControlPath, setLum, shiftCoverage, smoothCoverage, srgb8ToLab, srgbToLinear, tempTintToXy, temperatureToKelvin, toneCurve, toneLuts, toneRange, unprojectCanvasPoint, updateLayerMaskProps, uvToXy, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, xyToTempTint, xyToUv };
+/**
+ * The image editor as a capture surface. Units are natural pixels of the source image,
+ * the same space as `get_selection` and `select_region`: crop, rotation and flips are not
+ * applied (use `render_preview` for the final framing), adjustments, layers and annotations
+ * are. Regions: the whole image, the selection's bounds, or a rect. Small regions are
+ * enlarged up to 8× with hard pixel edges for close inspection.
+ */
+declare function createImageCaptureSurface(controller: ImageEditorController): CaptureSurface;
+
+export { ADJUSTMENT_KINDS, ADJUSTMENT_LAYER_CONTROLS, ADJUSTMENT_LAYER_OPACITY_CONTROL, ADJUSTMENT_LUT_SIZE, AS_SHOT_KELVIN, type AdjustmentKind, type AdjustmentKindInfo, type AdjustmentLayer, type AdjustmentLayerBase, type AdjustmentLayerInit, type AdjustmentLayerMask, type AdjustmentLayerOf, type AdjustmentLayerUpdate, type AdjustmentParamsMap, type Annotation, type AnnotationType, type ArrowAnnotation, type AspectRatio, BLEND_MODES, type BaseAnnotation, type BlackWhiteParams, type BlendMode, type BlendModeInfo, type Chromaticity, type CircleAnnotation, type ColorBalanceParams, type ColorBalanceTone, type ColorDistance, type ColorRangeOptions, type ColorRangeSample, type ControlSection, type ControlSpec, type ControlTrack, type CreateAnnotationPayload, type CropBox, type CropHandle, type CurvePoint, type CurvesParams, D65, DEFAULT_ADJUSTMENTS, DEFAULT_DEPTH_MASK, DEFAULT_REFINE_EDGE_PARAMS, DEFAULT_SELECTION_TOOL_OPTIONS, DEFAULT_TRANSFORM, DIRECT_GAUSSIAN_MAX_SIGMA, type DepthMaskOptions, EMPTY_DISTANCE, type ExportOptions, GUIDED_FILTER_EPS, type GestureModifiers, HISTOGRAM_BINS, HUE_RANGE_LABELS, type HistogramChannel, type HueRange, type HueSaturationParams, IDENTITY_MATRIX3, IMAGE_ADJUSTMENT_CONTROLS, IMAGE_EDITOR_SCHEMA_VERSION, IMAGE_EDITOR_STATE_VERSION, type ImageAdjustments, type ImageAnnotation, type ImageDimensions, type ImageEditorAIHooks, ImageEditorController, type ImageEditorDocumentLoad, type ImageEditorOptions, ImageEditorRenderer, type ImageEditorState, type ImageEditorTool, type ImageEditorToolProviderOptions, type ImageHistogram, type ImagePoint, type ImageProcessVersion, type ImageProjection, type ImageTransform, type InpaintHook, type InpaintOptions, type InvertParams, LATEST_PROCESS_VERSION, LEGACY_PROCESS_VERSION, LUMA_709, type LayerMaskProps, type LevelsChannel, type LevelsParams, type LineAnnotation, MAX_KELVIN, MIN_KELVIN, MIRED_PER_TEMPERATURE_UNIT, type MagicWandOptions, type Matrix3, type MosaicImageDataLike, type MosaicRegion, type PenAnnotation, type PhotoFilterParams, type PixelBuffer, type PixelOp, type PosterizeParams, type QuickMaskStyle, REFINE_EDGE_CONTROLS, type RectAnnotation, type RefineEdgeControl, type RefineEdgeParams, type RemoveBackgroundHook, type RemoveBackgroundOptions, type RenderOptions, type Rgb$1 as Rgb, type Rgba, SELECTION_MODES, SELECTION_MODE_LABELS, SELECTION_MODIFY_OPS, SELECTION_TOOLS, type SampleOptions, type SelectionChannel, type SelectionCommandOptions, SelectionGesture, type SelectionMask, type SelectionMode, type SelectionModifyOp, type SelectionToolKind, type SelectionToolOptions, type SerializedImageEditorState, type SerializedSelection, type ShapeSelectionOptions, TINT_SCALE, TONE_LUT_SIZE, TONE_RANGE_PRESETS, type TextAnnotation, type ThresholdParams, type ToneRangePreset, type UnitLevels, VIBRANCE_GREY, type VibranceParams, type ViewportMetrics, activeAdjustmentLayers, adjustmentKindLabel, adjustmentLayersKey, applyAdjustmentLayers, applyAdjustments, applyDepthMask, applyImageProjectionToContext, applyLegacyAdjustments, applyMatrix3, applyProcess2Adjustments, applyRegionBlur, applyRegionMosaic, blackWhiteGray, blendChannel, blendImageData, blendLum, blendPixel, blendRgb, borderCoverage, boxMean, boxToCurvePoint, bradfordAdaptation, buildLayerMaskPlanes, buildToneLut, calculateCropDrag, canvasCompositeOperation, canvasToImagePoint, clampControlValue, clampCropToImage, colorBalanceChannel, colorRange, combineSelections, compileAdjustmentLayer, computeHistogram, computeSelectionBounds, contractCoverage, controlPosition, controlTrackBackground, coverageToByte, createAdjustmentLayer, createImageCaptureSurface, createImageEditTools, createImageEditorToolProvider, createImageSelectionTools, createSelectionMask, curveLut, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerMask, decodeSelectionRle, defaultAdjustmentParams, describeSelection, deserializeSelection, distanceTransform, edgeWidth, ellipsePoints, ellipseSelection, encodeSelectionRle, evaluateAdjustmentLayers, expandCoverage, featherCoverage, findAdjustmentControl, findLayerControl, formatControlValue, fullSelection, gaussianBlur, getAnnotationBounds, getControlPath, getCropCursor, getRotatedSize, getViewportMetrics, getViewportProjection, globalImageCache, greyMorphology, guidePlanes, guidedFilterColor, hashMaskContent, hexToRgb, histogramPath, hitTestAnnotation, hitTestCrop, hitTestCurvePoint, hslToRgb, hueRange, hueRangeTables, hueRangeWeight, hueSaturation, identityCurve, identityLevels, imageEditorStateMigrations, imageToCanvasPoint, insertCurvePoint, invertMatrix3, invertSelection, isAdjustmentKind, isBlendMode, isQuarterTurnSwapped, isSelectionEmpty, isSelectionMode, isSeparableBlendMode, kelvinToTemperature, layerMaskCoverage, layerMaskFromSelection, layerMaskKey, levelsValue, linearSrgbToXy, linearToSrgb, loadImageEditorDocument, magicWand, mapCropHandle, migrateSerializedImageEditorState, modifySelection, moveCurvePoint, mulMatrix3, neutralHueRange, normalizeAdjustmentLayer, normalizeAdjustmentLayers, normalizeAngle, normalizeBlendMode, normalizeLayerMask, normalizeProcessVersion, normalizeRect, normalizeRefineEdgeParams, normalizeStoredAdjustments, parseSelectionMode, photoFilterMatrix, polygonCoverage, polygonSelection, posterizeValue, projectImagePoint, projectImageRect, projectMaskCoverage, quickMaskPixels, rangeLightness, readAdjustmentControls, rectSelection, refineCoverage, refineEdgeHalo, refineSelection, removeAlpha, removeCurvePoint, resizeSelection, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeSelection, setControlPath, setLum, shiftCoverage, smoothCoverage, srgb8ToLab, srgbToLinear, tempTintToXy, temperatureToKelvin, toneCurve, toneLuts, toneRange, unprojectCanvasPoint, updateLayerMaskProps, uvToXy, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, xyToTempTint, xyToUv };

package/dist/image-editor/index.js

@@ -1,3 +1,6 @@
+import {
+  createCaptureTool
+} from "../chunk-REOJJIY3.js";
 import {
   loadDocument
 } from "../chunk-U5HZSFCS.js";
@@ -4610,6 +4613,27 @@ var ImageEditorController = class {
     }
     return this.renderer.renderExport(source, this.state, options);
   }
+  /**
+   * Renders the edited image (adjustments, layers and, by default, annotations) in the
+   * source image's own orientation and frame, ignoring crop, rotation and flips, so it lines
+   * up with natural-pixel coordinates (selections, `select_region`). `scale` ≤ 1 shrinks it.
+   * Returns `null` when no image is loaded.
+   */
+  async renderSourceView(options = {}) {
+    const source = this.imageElement || this.state.sourceUrl;
+    if (!source) return null;
+    const { width, height } = this.state.imageDimensions;
+    const k = Math.min(1, Math.max(0, options.scale ?? 1));
+    return this.renderer.renderExport(
+      source,
+      { ...this.state, crop: null, transform: { rotate: 0, flipH: false, flipV: false } },
+      {
+        width: Math.max(1, Math.round(width * k)),
+        height: Math.max(1, Math.round(height * k)),
+        includeAnnotations: options.includeAnnotations
+      }
+    );
+  }
   async toDataURL(options = {}) {
     const canvas = await this.renderExport(options);
     const format = options.format || "image/png";
@@ -5357,6 +5381,331 @@ function createImageSelectionTools(controller) {
   return [getSelection, selectRegion, selectByColor, modify, refine, applyMask];
 }
 
+// src/image-editor/capture.ts
+var NO_CANVAS = "Rendering is not available in this environment.";
+function selectionShade(selection, doc) {
+  const canvas = doc.createElement("canvas");
+  canvas.width = selection.width;
+  canvas.height = selection.height;
+  const context = canvas.getContext("2d");
+  if (!context) return null;
+  const pixels = context.createImageData(selection.width, selection.height);
+  for (let i = 0; i < selection.data.length; i++) {
+    pixels.data[i * 4 + 3] = Math.round(150 * (1 - selection.data[i] / 255));
+  }
+  context.putImageData(pixels, 0, 0);
+  return canvas;
+}
+async function renderImageRegion(controller, request) {
+  const state = controller.getState();
+  const k = Math.min(1, request.scale);
+  const view = await controller.renderSourceView({ scale: k });
+  if (!view) throw new Error("No image is loaded, so there is nothing to capture.");
+  if (typeof document === "undefined") throw new Error(NO_CANVAS);
+  const out = document.createElement("canvas");
+  out.width = request.width;
+  out.height = request.height;
+  const context = out.getContext("2d");
+  if (!context) throw new Error(NO_CANVAS);
+  const { rect } = request;
+  context.imageSmoothingEnabled = request.scale < 1;
+  if (request.format === "jpeg") {
+    context.fillStyle = "#ffffff";
+    context.fillRect(0, 0, out.width, out.height);
+  }
+  const kx = view.width / state.imageDimensions.width;
+  const ky = view.height / state.imageDimensions.height;
+  context.drawImage(view, rect.x * kx, rect.y * ky, rect.width * kx, rect.height * ky, 0, 0, out.width, out.height);
+  if (request.includeOverlays) {
+    const s = request.scale;
+    const selection = state.selection;
+    if (selection?.bounds && selection.width === state.imageDimensions.width && selection.height === state.imageDimensions.height) {
+      const shade = selectionShade(selection, document);
+      if (shade) context.drawImage(shade, rect.x, rect.y, rect.width, rect.height, 0, 0, out.width, out.height);
+    }
+    if (state.crop) {
+      context.save();
+      context.strokeStyle = "#ffd400";
+      context.lineWidth = 2;
+      context.setLineDash([6, 4]);
+      context.strokeRect((state.crop.x - rect.x) * s, (state.crop.y - rect.y) * s, state.crop.width * s, state.crop.height * s);
+      context.restore();
+    }
+  }
+  const url = out.toDataURL(request.format === "jpeg" ? "image/jpeg" : "image/png", request.quality);
+  if (!url.startsWith("data:image/") || url.indexOf(",") === url.length - 1) throw new Error(NO_CANVAS);
+  return url;
+}
+function createImageCaptureSurface(controller) {
+  const whole = () => {
+    const { width, height } = controller.getState().imageDimensions;
+    return width > 0 && height > 0 ? { x: 0, y: 0, width, height } : null;
+  };
+  return {
+    units: "image pixels",
+    content: whole,
+    selection: () => ({ rect: controller.getState().selection?.bounds ?? null }),
+    overlays: "a shade over unselected pixels and the crop box outline",
+    maxScale: 8,
+    render: (request) => renderImageRegion(controller, request)
+  };
+}
+
+// src/image-editor/edit-tools.ts
+var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+var WRITE_IDEMPOTENT = { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var LAYER_ID = { type: "string", description: 'Adjustment layer id from get_adjustments (e.g. "adj_1").' };
+var round = (n, digits = 2) => Math.round(n * 10 ** digits) / 10 ** digits;
+function binStats(bins, samples) {
+  if (!samples) return { mean: null, p1: null, p99: null };
+  let sum = 0;
+  let seen = 0;
+  let p1 = null;
+  let p99 = null;
+  for (let i = 0; i < bins.length; i++) {
+    sum += i * bins[i];
+    seen += bins[i];
+    if (p1 === null && seen >= samples * 0.01) p1 = i;
+    if (p99 === null && seen >= samples * 0.99) p99 = i;
+  }
+  return { mean: round(sum / samples, 1), p1, p99 };
+}
+function rebin(bins, count) {
+  const out = new Array(count).fill(0);
+  const width = bins.length / count;
+  for (let i = 0; i < bins.length; i++) out[Math.floor(i / width)] += bins[i];
+  return out;
+}
+function histogramSummary(h, bins) {
+  const pct = (n) => h.samples ? round(n / h.samples * 100) : 0;
+  const channels = { red: h.red, green: h.green, blue: h.blue, luminance: h.luminance };
+  return {
+    samples: h.samples,
+    transparent: h.transparent,
+    clipping: {
+      shadowsPercent: { red: pct(h.shadows[0]), green: pct(h.shadows[1]), blue: pct(h.shadows[2]) },
+      highlightsPercent: { red: pct(h.highlights[0]), green: pct(h.highlights[1]), blue: pct(h.highlights[2]) }
+    },
+    stats: Object.fromEntries(Object.entries(channels).map(([k, v]) => [k, binStats(v, h.samples)])),
+    ...bins ? { bins: Object.fromEntries(Object.entries(channels).map(([k, v]) => [k, rebin(v, bins)])) } : {}
+  };
+}
+function createImageEditTools(controller) {
+  const layerOrThrow = (id) => {
+    const layers = controller.getAdjustmentLayers();
+    const index = layers.findIndex((l) => l.id === id);
+    if (index === -1) {
+      const ids = layers.map((l) => l.id);
+      throw new Error(`Unknown adjustment layer "${id}". ${ids.length ? `Layers: ${ids.join(", ")}.` : "There are no adjustment layers."}`);
+    }
+    return { layer: layers[index], index };
+  };
+  const layerJson = (id) => JSON.parse(JSON.stringify(controller.getAdjustmentLayer(id)));
+  const geometry = () => {
+    const s = controller.getState();
+    const region = s.crop ?? { x: 0, y: 0, ...s.imageDimensions };
+    const out = getRotatedSize(region.width, region.height, s.transform);
+    return {
+      image: { ...s.imageDimensions },
+      crop: s.crop ? { ...s.crop } : null,
+      rotation: normalizeAngle(s.transform.rotate),
+      flipH: s.transform.flipH,
+      flipV: s.transform.flipV,
+      output: { width: Math.round(out.width), height: Math.round(out.height) }
+    };
+  };
+  const history = () => ({ canUndo: controller.canUndo, canRedo: controller.canRedo });
+  const requireImage = () => {
+    const { width, height } = controller.getState().imageDimensions;
+    if (!width || !height) throw new Error("No image is loaded. Ask the user to open one first.");
+    return { width, height };
+  };
+  const getImageInfo = {
+    name: "get_image_info",
+    title: "Read image geometry",
+    description: "Returns the source image size in pixels, the crop box (natural image pixels, or null for the whole image), rotation in degrees, flips, the output size after crop and rotation, the number of adjustment layers and whether undo / redo are available.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: "Read image geometry", ...READ },
+    handler: () => ({ ...geometry(), layers: controller.getAdjustmentLayers().length, ...history() })
+  };
+  const getHistogram = {
+    name: "get_histogram",
+    title: "Read the histogram",
+    description: "Returns the histogram of the last rendered preview (after adjustments and layers): per channel and luminance mean and 1st / 99th percentiles (0-255), and the percentage of pixels clipped to pure black or white per channel. Use it to judge exposure and clipping numerically. Pass bins for the counts themselves. Fails before the first render: call render_preview first.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        bins: { type: "integer", enum: [16, 32, 64, 256], description: "Also return the counts in this many buckets per channel (default: no counts)." }
+      },
+      additionalProperties: false
+    },
+    annotations: { title: "Read the histogram", ...READ },
+    handler: ({ bins }) => {
+      const h = controller.getHistogram();
+      if (!h) throw new Error("No histogram yet: it comes from the rendered preview. Call render_preview, then try again.");
+      return histogramSummary(h, bins);
+    }
+  };
+  const updateLayer = {
+    name: "update_adjustment_layer",
+    title: "Change an adjustment layer",
+    description: 'Shows or hides a layer, renames it, or changes its blend mode or opacity, as one undo step. Change its parameters with set_adjustments ("layers.<id>.<control>"). Returns the updated layer.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        layer: LAYER_ID,
+        enabled: { type: "boolean", description: "false hides the layer without deleting it." },
+        blend: { type: "string", enum: BLEND_MODES.map((m) => m.id), description: "Blend mode (see list_controls)." },
+        opacity: { type: "number", minimum: 0, maximum: 1, description: "Layer opacity 0-1." },
+        name: { type: "string", description: "Layer name shown in the layers panel." }
+      },
+      required: ["layer"],
+      additionalProperties: false
+    },
+    annotations: { title: "Change an adjustment layer", ...WRITE_IDEMPOTENT },
+    handler: ({ layer, enabled, blend, opacity, name }) => {
+      layerOrThrow(layer);
+      if (enabled === void 0 && blend === void 0 && opacity === void 0 && name === void 0) {
+        throw new Error("Nothing to change. Pass enabled, blend, opacity or name.");
+      }
+      if (blend !== void 0 && !isBlendMode(blend)) throw new Error(`Unknown blend mode "${blend}".`);
+      controller.updateAdjustmentLayer(layer, { enabled, blend, opacity, name });
+      return { layer: layerJson(layer) };
+    }
+  };
+  const removeLayer = {
+    name: "remove_adjustment_layer",
+    title: "Delete an adjustment layer",
+    description: "Deletes an adjustment layer and its mask as one undo step. To hide it instead, use update_adjustment_layer with enabled false. Returns the remaining layer ids, bottom to top.",
+    inputSchema: { type: "object", properties: { layer: LAYER_ID }, required: ["layer"], additionalProperties: false },
+    annotations: { title: "Delete an adjustment layer", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
+    handler: ({ layer }) => {
+      layerOrThrow(layer);
+      controller.removeAdjustmentLayer(layer);
+      return { removed: layer, layers: controller.getAdjustmentLayers().map((l) => l.id) };
+    }
+  };
+  const moveLayer = {
+    name: "move_adjustment_layer",
+    title: "Reorder an adjustment layer",
+    description: "Moves an adjustment layer to a position in the stack (0 = bottom, applied first) as one undo step. Layers apply bottom to top, so order changes the result. Returns the layer ids, bottom to top.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        layer: LAYER_ID,
+        to: { type: "integer", minimum: 0, description: "New index, 0 = bottom; past the top means the top." }
+      },
+      required: ["layer", "to"],
+      additionalProperties: false
+    },
+    annotations: { title: "Reorder an adjustment layer", ...WRITE_IDEMPOTENT },
+    handler: ({ layer, to }) => {
+      const { index } = layerOrThrow(layer);
+      const top = controller.getAdjustmentLayers().length - 1;
+      const target = Math.min(to, top);
+      if (target === index) throw new Error(`Layer "${layer}" is already at index ${index} (0 = bottom, ${top} = top).`);
+      controller.moveAdjustmentLayer(layer, target);
+      return { layer, index: target, layers: controller.getAdjustmentLayers().map((l) => l.id) };
+    }
+  };
+  const setCrop = {
+    name: "set_crop",
+    title: "Crop the image",
+    description: "Sets the crop box in natural image pixels of the un-rotated source (origin top-left; see get_image_info for the size) as one undo step. Non-destructive: reset_crop restores the whole image. Returns the new geometry and output size.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        x: { type: "number", minimum: 0, description: "Left edge in source pixels." },
+        y: { type: "number", minimum: 0, description: "Top edge in source pixels." },
+        width: { type: "number", exclusiveMinimum: 0, description: "Width in source pixels." },
+        height: { type: "number", exclusiveMinimum: 0, description: "Height in source pixels." }
+      },
+      required: ["x", "y", "width", "height"],
+      additionalProperties: false
+    },
+    annotations: { title: "Crop the image", ...WRITE_IDEMPOTENT },
+    handler: ({ x, y, width, height }) => {
+      const image = requireImage();
+      if (x + width > image.width + 0.5 || y + height > image.height + 0.5) {
+        throw new Error(`The crop box (${x}, ${y}, ${width} \xD7 ${height}) goes outside the ${image.width} \xD7 ${image.height} image.`);
+      }
+      controller.setCrop({ x: Math.round(x), y: Math.round(y), width: Math.round(width), height: Math.round(height) });
+      return geometry();
+    }
+  };
+  const resetCrop = {
+    name: "reset_crop",
+    title: "Remove the crop",
+    description: "Removes the crop so the whole image shows again, as one undo step. Returns the new geometry.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: "Remove the crop", ...WRITE_IDEMPOTENT },
+    handler: () => {
+      if (!controller.getState().crop) throw new Error("The image is not cropped.");
+      controller.resetCrop();
+      return geometry();
+    }
+  };
+  const setRotation = {
+    name: "set_rotation",
+    title: "Rotate the image",
+    description: "Sets the image rotation in degrees clockwise, as one undo step. Quarter turns (90, 180, 270) keep every pixel; other angles straighten the image inside a larger frame with transparent corners, so crop afterwards. Returns the new geometry.",
+    inputSchema: {
+      type: "object",
+      properties: { degrees: { type: "number", minimum: -360, maximum: 360, description: "Absolute rotation in degrees clockwise (0 = upright)." } },
+      required: ["degrees"],
+      additionalProperties: false
+    },
+    annotations: { title: "Rotate the image", ...WRITE_IDEMPOTENT },
+    handler: ({ degrees }) => {
+      requireImage();
+      controller.setRotation(degrees);
+      return geometry();
+    }
+  };
+  const flipImage = {
+    name: "flip_image",
+    title: "Flip the image",
+    description: "Mirrors the image horizontally (left-right) or vertically (top-bottom), as one undo step. Flipping twice restores it. Returns the new geometry.",
+    inputSchema: {
+      type: "object",
+      properties: { axis: { type: "string", enum: ["horizontal", "vertical"], description: "horizontal mirrors left-right; vertical mirrors top-bottom." } },
+      required: ["axis"],
+      additionalProperties: false
+    },
+    annotations: { title: "Flip the image", ...WRITE },
+    handler: ({ axis }) => {
+      requireImage();
+      if (axis === "horizontal") controller.flipHorizontal();
+      else controller.flipVertical();
+      return geometry();
+    }
+  };
+  const undo = {
+    name: "undo_image",
+    title: "Undo an image edit",
+    description: "Undoes the last image edit (one tool call is one step). Returns whether undo and redo are still available.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: "Undo an image edit", ...WRITE },
+    handler: () => {
+      if (!controller.undo()) throw new Error("Nothing to undo.");
+      return history();
+    }
+  };
+  const redo = {
+    name: "redo_image",
+    title: "Redo an image edit",
+    description: "Redoes the last undone image edit. Returns whether undo and redo are still available.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: "Redo an image edit", ...WRITE },
+    handler: () => {
+      if (!controller.redo()) throw new Error("Nothing to redo.");
+      return history();
+    }
+  };
+  return [getImageInfo, getHistogram, updateLayer, removeLayer, moveLayer, setCrop, resetCrop, setRotation, flipImage, undo, redo];
+}
+
 // src/image-editor/tools.ts
 var LAYER_PATH = /^layers\.([^.]+)\.(.+)$/;
 function adjustmentsSummary(adjustments) {
@@ -5574,7 +5923,16 @@ function createImageEditorToolProvider(controller, options = {}) {
   return {
     id: options.id ?? "image-editor",
     namespace: options.namespace,
-    tools: [getAdjustments, listControls, setAdjustments, addLayer, renderPreview, ...createImageSelectionTools(controller)]
+    tools: [
+      getAdjustments,
+      listControls,
+      setAdjustments,
+      addLayer,
+      renderPreview,
+      createCaptureTool(createImageCaptureSurface(controller), { subject: "the image (source orientation, before crop and rotation)", defaultPadding: 0 }),
+      ...createImageSelectionTools(controller),
+      ...createImageEditTools(controller)
+    ]
   };
 }
 
@@ -5950,6 +6308,8 @@ export {
   controlTrackBackground,
   coverageToByte,
   createAdjustmentLayer,
+  createImageCaptureSurface,
+  createImageEditTools,
   createImageEditorToolProvider,
   createImageSelectionTools,
   createSelectionMask,