unstale

npm / cropperjs

cropperjs

What changed in cropperjs 1 to 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-29.

16 new APIs and options3 behavior and defaults8 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.9 on npm

cropperjs 215 changes

New APIs and options 9

  • Adds border radius support for selection and shade elements.

    2.3.0release notes

  • Adds the createCropper function for creating a new Cropper instance.

    2.3.0release notes

  • Adds the maxInset property to cropper-image.

    2.3.0release notes

  • Adds the minInset property to cropper-image.

    2.3.0release notes

  • Adds the zoomAroundCenter property to cropper-image.

    2.3.0release notes

  • Adds the maxInset property to cropper-selection.

    2.3.0release notes

  • Adds the minInset property to cropper-selection.

    2.3.0release notes

  • Adds the resizeAroundCenter property to cropper-selection.

    2.3.0release notes

  • Adds the zoomAroundCenter property to cropper-selection.

    2.3.0release notes

Behavior and default changes 3

  • Enhances resize handling with initial dimensions tracking.

    2.3.0release notes

  • Enhances selection handling for non-resizable elements.

    2.3.0release notes

  • Improves selection coverage and boundary handling.

    2.3.0release notes

Fixes and other changes 3

  • Fixes the element staying 0×0 when src is set after connect.

    2.3.1release notes

  • Handles the image load event for complete images.

    2.3.0release notes

  • Preserves explicit selection dimensions on initial coverage.

    2.3.0release notes

cropperjs 112 changes

New APIs and options 7

  • Adds rounded crop boxes and canvases.

    1.7.0release notes

  • Adds an option to move and resize the crop box relative to the drag start point.

    1.7.0release notes

  • Adds an option to resize the crop box around its center.

    1.7.0release notes

  • Creates a new Cropper instance without the new operator.

    1.7.0release notes

  • Adds an error event when the target image fails to load.

    1.7.0release notes

  • Adds a beforeDraw option for applying canvas filters or custom drawing before the cropped image is rendered.

    1.7.0release notes

  • Adds an option to zoom around the center of the cropper.

    1.7.0release notes

Fixes and other changes 5

  • Ends an active crop when the window loses focus, such as when releasing the mouse outside an iframe.

    1.7.0release notes

  • Fixes crop box creation when a diagonal drag begins with movement along only one axis.

    1.7.0release notes

  • Fixes crop box jumps when resizing past the opposite edge with minimum dimensions set.

    1.7.0release notes

  • Fixes squished images with EXIF rotation when image-orientation: none is set.

    1.7.0release notes

  • Fixes tiny negative offsets returned due to floating-point errors.

    1.7.0release notes