PAINTROID-790: Create cursor_tool object and provider.

[haske6155]

PAINTROID-790

New Features and Enhancements

Added new Cursor Tool functionality allowing users to control a cursor for precise drawing

• Cursor can be positioned by dragging and activated/deactivated by tapping
• When active, cursor draws paths as it moves; when inactive, it only repositions without drawing
• Visual cursor indicator with circle and cross-hair design that changes color based on active state
• Support for undo/redo operations with cursor-drawn paths
• Enhanced command system to support cursor-specific path commands with isCursorPath flag
• Added comprehensive integration and unit tests for cursor tool functionality

Code Structure Improvements

• Enhanced CommandFactory to accept optional isCursor parameter for path command creation
• Extended PathCommand class with isCursorPath boolean field for cursor-specific commands
• Improved CommandManager to properly categorize cursor commands in tool data detection
• Added cursor tool provider with Riverpod state management
• Enhanced CommandPainter to handle cursor tool rendering and icon display
• Extended BrushTool with optional isCursor parameter for cursor tool inheritance
• Updated toolbox state provider to support cursor tool selection and initialization

Checklist

Your checklist for this pull request

Please review the contributing guidelines and wiki pages of this repository.

• Include the name of the Jira ticket in the PR’s title
• Add the link to the ticket in Jira in the description of the PR
• Include a summary of the changes plus the relevant context
• Choose the proper base branch (develop)
• Confirm that the changes follow the project’s coding guidelines (Wiki)
• Verify that the changes generate no compiler or linter warnings
• Perform a self-review of the changes
• Verify to commit no other files than the intentionally changed ones
• Include reasonable and readable tests verifying the added or changed behavior
• Confirm that new and existing tests pass locally
• Check that the commits’ message style matches the project’s guideline
• Verify that your changes do not have any conflicts with the base branch
• After the PR, verify that all CI checks have passed
• Add new information to the Wiki

[Copilot]

Pull Request Overview

This PR introduces a new CursorTool, its provider, integrates it into the toolbox state and painter, and adds corresponding unit & integration tests, plus minor UI painter and iOS project config updates.

• Added CursorTool implementation and provider, and wired it into ToolBoxStateProvider & CommandPainter
• Added comprehensive unit tests (cursor_tool_test.dart) and integration tests (cursor_tool_test.dart)
• Updated CanvasPainter to render the cursor icon and adjusted iOS scheme/project for GPU validation and pod resource copying

Reviewed Changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
test/unit/tools/cursor_tool_test.dart	Added unit tests covering cursor positioning and drawing behavior
test/integration/cursor_tool_test.dart	Added integration tests for cursor tool interactions
lib/ui/pages/workspace_page/components/drawing_surface/canvas_painter.dart	Render cursor icon instead of const Stack
lib/core/tools/tool.dart	Changed Tool constructor from const to non-const
lib/core/tools/implementation/cursor_tool.dart	New CursorTool implementation
lib/core/providers/state/toolbox_state_provider.dart	Integrated ToolType.CURSOR into toolbox state
lib/core/providers/object/tools/cursor_tool_provider.dart	Added Riverpod provider for CursorTool
lib/core/commands/command_painter.dart	Draw cursor icon in the painter switch
ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme	Enabled GPU validation
ios/Runner.xcodeproj/project.pbxproj	Added pod resource copy build phase

Comments suppressed due to low confidence (4)

test/integration/cursor_tool_test.dart:50

• The test block for testID 1 and the test block for testID 2 are identical. Consider removing one of the duplicate tests to reduce redundancy and speed up CI.

  if (testID == -1 || testID == 1) {

lib/ui/pages/workspace_page/components/drawing_surface/canvas_painter.dart:24

• [nitpick] Removing the const qualifier from the Stack prevents compile-time optimizations. If the children are immutable, consider restoring const Stack to improve rendering performance.

      child: Stack(

lib/core/tools/tool.dart:15

• [nitpick] The constructor was changed from const Tool to non-const; since all fields are final, you could reintroduce const here to allow compile-time instantiation and improve code clarity.

  Tool({

ios/Runner.xcodeproj/project.pbxproj:272

• This appears to add a duplicate '[CP] Copy Pods Resources' build phase, which can lead to duplicated resource copies or build confusion. Consider removing or merging with the existing phase.

		CE347BAC542BC77A1AF7E630 /* [CP] Copy Pods Resources */ = {

[Copilot]

When selecting the cursor tool, the paint stroke width isn’t updated. You may need to call ref.read(paintProvider.notifier).updateStrokeWidth(...) with the cursor’s stroke width to ensure drawing uses the correct thickness.

Suggested change

	state = state.copyWith(currentTool: ref.read(cursorToolProvider));
	state = state.copyWith(currentTool: ref.read(cursorToolProvider));
	ref.read(paintProvider.notifier).updateStrokeWidth(1.0); // Default stroke width for cursor

[Lenkomotive]

Overall good work:

1. pls check out the redo/undo function and how it works in other tools. I noticed some inconsistency and also redoing to a line which was drawn by a cursor should also switch back to cursor tool. Might need to look at the PathCommand.
2. pls use the Catrobat PR-template and check if you have ticked all the boxes.

[bakicelebi]

Please solve the conflicts, otherwise verything looks good 👍🏻

[juliajulie95]

When zooming the cursor icon changes position or just vanishes completely.
Make sure the cursor only switches state (drawing, non drawing) when tapped.
Currently it also changes state when you tapped anywhere. Make sure it is as similar as possible to the old app, because this tool is a little bit more difficult to use and existing users should be able to use it the same way as before.

Undoing until you hit a cursor tool stroke it still changes back to cursor tool like Mario mentioned, that should not happen.