ROU-12638: Adding TerraDraw drawing tools

[rugoncalves]

This PR introduces the support to a new provider for the drawing tools: TerraDraw. The reason being related with the upcoming decommission of Google Maps Drawing Tools in version 3.65 (May 2026). The changes include new configuration classes, abstract base classes for TerraDraw tools, and provider-specific logic for handling drawing events and feature creation. The Drawing Tools factory is updated to instantiate TerraDraw tools for Google Maps, and a new error code is added for shape creation failures.

Read the Architecture Decision Record 2 for more context.

What was happening

• Google Maps is decommissioning Drawing Tools on version 3.65;
• A new provider for the Drawing Tools need to be supported;

What was done

• Added classes to support TerraDraw provider;
• New folder was created for Providers that are not maps;
• Added new API to enable using Google Maps Drawing Tools, while it's possible: OutSystems.Maps.MapAPI.DrawingToolsManager.SetUseTerraDraw( true | false );
• Added new dev dependency for TerraDraw;
• Changed the ECMA script target of the compilation: es2017 » es2020;
• Added the ADR-0002-Replace-Google-DrawingManager-with-TerraDraw.md
• Updated Google Maps default version: 3.63 (quarterly updates from Mid-February 2026 onward)

Test Steps

A. Using TerraDraw provider:

1. Enter the test "DrawingTools"
2. Try to use the drawing tools
3. Validate that the shapes are added to the map
   B. Using Google Maps provider:
4. Enter the test "DrawingTools_google"
5. Run the command OutSystems.Maps.MapAPI.DrawingToolsManager.SetUseTerraDraw(false) before the map is created;
6. Try to use the drawing tools
7. Validate that the shapes are added to the map

Screenshots

Checklist

• tested locally
• documented the code
• clean all warnings and errors of eslint
• requires changes in OutSystems (if so, provide a module with changes)
  • add new provider scripts
  • add new css for the DrawingTools toolbar
• requires new sample page in OutSystems (if so, provide a module with changes)

[Copilot]

Pull request overview

Copilot reviewed 31 out of 34 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[gnbm]

@rugoncalves have you checked CoPilot's comments?

[gnbm]

Left a couple of comments.
Take a look at Copilot's feedback as well

[Copilot]

Pull request overview

Copilot reviewed 31 out of 34 changed files in this pull request and generated 4 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
1.4% Duplication on New Code

See analysis details on SonarQube Cloud

[gnbm]

LGTM