Support configurable and auto-detected output format for cropped images#34
Merged
Conversation
|
Note Reviews pausedIt looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
WalkthroughAdds configurable cropped-image output MIME type and quality, with client-side format detection, circular-crop PNG fallback, a new demo, unit tests, README updates, and a version bump. ChangesOutput format configuration
Estimated code review effort: 3 (Moderate) | ~25 minutes Possibly related PRs
Suggested reviewers: 🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
paodb
changed the title
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 3
🧹 Nitpick comments (1)
src/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java (1)
48-61: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick winConsider adding tests for default (auto-detect) state.
These tests only verify explicit set/get round-trips. The PR's headline feature is auto-detection when
outputMimeType/outputQualityare left unset (null). Consider adding a test assertinggetOutputMimeType()returnsnullby default (before anysetOutputMimeTypecall) to lock in the auto-detect contract.✅ Suggested additional test
+ `@Test` + public void testGetOutputMimeTypeDefaultsToNull() { + assertNull(imageCrop.getOutputMimeType()); + }🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@src/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java` around lines 48 - 61, Add a test in ImageCropTest that exercises the default auto-detect state before any setters are called: verify imageCrop.getOutputMimeType() returns null initially, and if applicable do the same for outputQuality. Use the existing ImageCrop test fixture and the getOutputMimeType()/getOutputQuality() accessors to lock in the unset/null contract, instead of only testing set/get round-trips.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java`:
- Around line 143-154: The refreshCroppedImage() flow currently depends on
setState(...) having already been applied before
getElement().executeJs("_updateCroppedImage(...)") runs, which is not guaranteed
by Vaadin. Update the ImageCrop logic so the re-encode uses client-side state
consistently, either by moving the update into a client-side effect or by
passing the new crop/mime/quality values directly from the caller into
refreshCroppedImage()/_updateCroppedImage(). Ensure the fix is applied where
property-change handlers trigger refreshCroppedImage() so the client always uses
the intended latest values.
- Around line 378-398: `ImageCrop#getOutputQuality()` can still fail if the
server-side state has never been initialized, even though the client defaults to
1.0. Update `ImageCrop` to initialize `outputQuality` on the Java side
(preferably in the constructor) or make `getOutputQuality()` fall back to 1.0
when the state is absent, and keep the existing `setOutputQuality` /
`refreshCroppedImage` flow unchanged.
In `@src/main/resources/META-INF/resources/frontend/src/image-crop.tsx`:
- Around line 300-302: The server-side output quality path can unbox a null
primitive before the client initializes its fallback value, so mirror the
client’s 1.0 default there. Update the relevant server-side getter or
initializer for output quality so it safely falls back to 1.0 when the nullable
state is unset, keeping behavior aligned with the frontend’s `this.outputQuality
?? 1.0` in `image-crop.tsx`.
---
Nitpick comments:
In
`@src/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java`:
- Around line 48-61: Add a test in ImageCropTest that exercises the default
auto-detect state before any setters are called: verify
imageCrop.getOutputMimeType() returns null initially, and if applicable do the
same for outputQuality. Use the existing ImageCrop test fixture and the
getOutputMimeType()/getOutputQuality() accessors to lock in the unset/null
contract, instead of only testing set/get round-trips.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 50c61048-98f9-49a4-bbb3-29d5cccd1bbb
📒 Files selected for processing (7)
README.mdpom.xmlsrc/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.javasrc/main/resources/META-INF/resources/frontend/src/image-crop.tsxsrc/test/java/com/flowingcode/vaadin/addons/imagecrop/ImageCropDemoView.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/OutputFormatImageCropDemo.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java
paodb
force-pushed
the
issue-23-output-format
branch
from
July 2, 2026 19:11
63bd5fa to
3545968
Compare
There was a problem hiding this comment.
🧹 Nitpick comments (1)
src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java (1)
387-389: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low valueConsider validating
outputQualitybounds.
setOutputQualityaccepts anydoublewith no range check, though the Javadoc states "a value between 0 and 1". Out-of-range values are silently passed through tocanvas.toDataURLon the client.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java` around lines 387 - 389, `ImageCrop.setOutputQuality` currently passes any double through without enforcing the documented 0-to-1 range. Add validation in this setter to reject or clamp out-of-bounds values before calling `setState("outputQuality", ...)`, so the method matches its Javadoc and only sends valid quality values to the client.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java`:
- Around line 387-389: `ImageCrop.setOutputQuality` currently passes any double
through without enforcing the documented 0-to-1 range. Add validation in this
setter to reject or clamp out-of-bounds values before calling
`setState("outputQuality", ...)`, so the method matches its Javadoc and only
sends valid quality values to the client.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: b6eb90f1-5355-405a-b6a3-23064cb9a113
📒 Files selected for processing (7)
README.mdpom.xmlsrc/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.javasrc/main/resources/META-INF/resources/frontend/src/image-crop.tsxsrc/test/java/com/flowingcode/vaadin/addons/imagecrop/ImageCropDemoView.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/OutputFormatImageCropDemo.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java
✅ Files skipped from review due to trivial changes (2)
- pom.xml
- README.md
🚧 Files skipped from review as they are similar to previous changes (3)
- src/test/java/com/flowingcode/vaadin/addons/imagecrop/ImageCropDemoView.java
- src/test/java/com/flowingcode/vaadin/addons/imagecrop/OutputFormatImageCropDemo.java
- src/main/resources/META-INF/resources/frontend/src/image-crop.tsx
paodb
force-pushed
the
issue-23-output-format
branch
from
July 2, 2026 19:24
3545968 to
9f06011
Compare
Member
Author
|
@coderabbitai full review |
✅ Action performedFull review finished. |
There was a problem hiding this comment.
🧹 Nitpick comments (1)
src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java (1)
340-392: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick winExtract property-name constants to fix SonarCloud duplication failures.
"outputMimeType"and"outputQuality"are each repeated 3 times (setter,getPropertyRawcheck,getStatecall). SonarCloud flags both as quality-gate failures.♻️ Proposed fix
+ private static final String OUTPUT_MIME_TYPE_PROPERTY = "outputMimeType"; + private static final String OUTPUT_QUALITY_PROPERTY = "outputQuality"; + public void setOutputMimeType(String outputMimeType) { - setState("outputMimeType", outputMimeType); + setState(OUTPUT_MIME_TYPE_PROPERTY, outputMimeType); } public String getOutputMimeType() { - if (getElement().getPropertyRaw("outputMimeType") == null) { + if (getElement().getPropertyRaw(OUTPUT_MIME_TYPE_PROPERTY) == null) { return null; } - return getState("outputMimeType", String.class); + return getState(OUTPUT_MIME_TYPE_PROPERTY, String.class); } public void setOutputQuality(double outputQuality) { - setState("outputQuality", outputQuality); + setState(OUTPUT_QUALITY_PROPERTY, outputQuality); } public double getOutputQuality() { - if (getElement().getPropertyRaw("outputQuality") == null) { + if (getElement().getPropertyRaw(OUTPUT_QUALITY_PROPERTY) == null) { return 1.0; } - return getState("outputQuality", Double.class); + return getState(OUTPUT_QUALITY_PROPERTY, Double.class); }🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java` around lines 340 - 392, The ImageCrop output property names are duplicated in multiple places, triggering SonarCloud duplication warnings. Extract shared constants for the state keys used by setOutputMimeType/getOutputMimeType and setOutputQuality/getOutputQuality, and reuse those constants in the setState, getPropertyRaw, and getState calls. Keep the existing behavior unchanged while centralizing the literal names in ImageCrop.Source: Linters/SAST tools
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java`:
- Around line 340-392: The ImageCrop output property names are duplicated in
multiple places, triggering SonarCloud duplication warnings. Extract shared
constants for the state keys used by setOutputMimeType/getOutputMimeType and
setOutputQuality/getOutputQuality, and reuse those constants in the setState,
getPropertyRaw, and getState calls. Keep the existing behavior unchanged while
centralizing the literal names in ImageCrop.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 9659a7f1-801d-41a8-93f9-210f59c060f9
📒 Files selected for processing (7)
README.mdpom.xmlsrc/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.javasrc/main/resources/META-INF/resources/frontend/src/image-crop.tsxsrc/test/java/com/flowingcode/vaadin/addons/imagecrop/ImageCropDemoView.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/OutputFormatImageCropDemo.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java
paodb
marked this pull request as ready for review
July 3, 2026 12:45
javier-godoy
approved these changes
Jul 16, 2026
paodb
force-pushed
the
issue-23-output-format
branch
from
July 16, 2026 16:43
c3360bc to
06ade65
Compare
|
There was a problem hiding this comment.
🧹 Nitpick comments (1)
src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java (1)
363-368: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick winSimplify state retrieval and resolve SonarCloud warnings.
The checks against
getElement().getPropertyRaw(...)bypass the component's state abstraction and duplicate the property name literals, which triggers SonarCloud code duplication warnings. Vaadin'sgetStatealready safely handles absent properties by returningnull, so you can rely on it directly.This approach simplifies the logic and reduces the string literal occurrences to two, natively resolving the SonarCloud failures without needing to introduce new constants.
♻️ Proposed refactors
For
getOutputMimeType:public String getOutputMimeType() { - if (getElement().getPropertyRaw("outputMimeType") == null) { - return null; - } return getState("outputMimeType", String.class); }For
getOutputQuality:public double getOutputQuality() { - if (getElement().getPropertyRaw("outputQuality") == null) { - return 1.0; - } - return getState("outputQuality", Double.class); + Double quality = getState("outputQuality", Double.class); + return quality != null ? quality : 1.0; }Also applies to: 392-397
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java` around lines 363 - 368, Update getOutputMimeType and getOutputQuality to return getState directly with the existing "outputMimeType" and "outputQuality" keys, removing the getElement().getPropertyRaw null checks and duplicated property literals. Rely on getState’s null behavior for absent properties.Source: Linters/SAST tools
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@src/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.java`:
- Around line 363-368: Update getOutputMimeType and getOutputQuality to return
getState directly with the existing "outputMimeType" and "outputQuality" keys,
removing the getElement().getPropertyRaw null checks and duplicated property
literals. Rely on getState’s null behavior for absent properties.
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: 9ec50d2f-7685-46d2-829d-16e0d3b10053
📒 Files selected for processing (7)
README.mdpom.xmlsrc/main/java/com/flowingcode/vaadin/addons/imagecrop/ImageCrop.javasrc/main/resources/META-INF/resources/frontend/src/image-crop.tsxsrc/test/java/com/flowingcode/vaadin/addons/imagecrop/ImageCropDemoView.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/OutputFormatImageCropDemo.javasrc/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java
🚧 Files skipped from review as they are similar to previous changes (4)
- pom.xml
- src/test/java/com/flowingcode/vaadin/addons/imagecrop/test/ImageCropTest.java
- src/test/java/com/flowingcode/vaadin/addons/imagecrop/OutputFormatImageCropDemo.java
- README.md
github-project-automation
Bot
moved this from To Do
to Pending release
in Flowing Code Addons
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Reworks the fix for #23 following the approach agreed in the PR #27 discussion: a combination of an explicit server-side output-format property and zero-network auto-detection. Supersedes #27.
Problem
The cropped image was always encoded as PNG (
canvas.toDataURL("image/png", ...)), so JPEGs (and any other format) were silently converted to PNG.What this does
setOutputMimeType(String)lets the caller choose the output format (image/png,image/jpeg,image/webp).data:URI, or the file extension of a regular URL.canvas.toDataURLcan actually encode (png/jpeg/webp); anything else falls back toimage/png.setOutputQuality(double)controls the encoding quality for lossy formats (jpeg/webp).Notes
Closes #23
Summary by CodeRabbit