Save/load Multi-tail Arrow to/from ket

[yauhen-karmyzau]

As a User, I want to be able to load and save multi-tail arrows to and from KET, so that I can preserve my work and continue working on complex diagrams across multiple sessions.

The arrow should be saved in the following format:

            {
                "type": "multi-tailed-arrow",
                "data": {
                    "head": {
                        "position": { 
                             "x": 12.1806,
                             "y": 10.9876,
                        } 
                    },
                    "spine": {
                        "pos": [ 
                             {
                                 "x": 9.1976,
                                 "y": 8.8159
                             },
                             {
                                 "x": 9.1976,
                                 "y": 14.1234
                             }
                        ] 
                    },
                    "tails": {
                         "pos": [
                            {
                                "x": 7.9901,
                                "y": 8.8159
                            },
                            {
                                "x": 7.9901,
                                "y": 10.5923
                            },
                            {
                                "x": 7.9901,
                                "y": 14.1234
                            }
                         ] 
                    },
                    "zOrder": 0
                }
            }

As multi-tailed arrows can only be aligned horizontally with current implementation, the following invariants apply:

• X coordinates for all tails should be the same;
• X coordinate for both spine ends should be the same;
• Two Y coordinates of the spine ends should be equal to min and max Y coordinates of the tails;

zOrder is not used at the moment and should always be set to 0.
Also "z": 0 coordinate will be in Json as for other elements after X and Y.

Acceptance Criteria:

1. A user should be able to save a diagram containing a multi-tail arrow to KET. The saved file should accurately represent the state of the diagram, including the position, size, and structure of the multi-tail arrow.
2. A user should be able to load a diagram containing a multi-tail arrow from a KET file. The loaded diagram should accurately represent the state of the diagram as it was when saved, including the position, size, and structure of the multi-tail arrow.
3. The application should handle any errors during the loading or saving process gracefully, providing the user with clear error messages and, if possible, guidance on how to resolve the issue.**

• Load Validations from KET format:
  • X coordinates for all tails should be the same;
  • X coordinate for both spine ends should be the same;
  • Two Y coordinates of the spine ends should be equal to min and max Y coordinates of the tails;
  • Minimal possible sizes for spine - 0.5, tail - 0.4, head - 0.5
  • Head can't be positioned in rounded region of spine 0.15 from both ends
  • Minimal distance between tails - 0.35
• Save Validation to KET format - TBD
• Save Validations to not KET Format - OUT OF SCOPE, it will be implemented in scope of Warning or error messages appear when the user tries to save a Multi-Tailed Arrow to inappropriate formats #5338

4. User can perform basic actions with Multi-Tail Arrows:

• User can Undo (Ctrl + Z)/Redo (Ctrl + Shift + Z) actions (loading from file, copy/paste) with multi-tails arrows;
• User can Copy (Ctrl + C)/Cut (Ctrl + X)/Paste (Ctrl + V) multi-tails on the Canvas;

[ivanmaslow]

Exploratory testing is completed on RC Remote environment:

• Ketcher [Version 2.25.0-rc.1] Build at 2024-09-03; 15:37:29
• Indigo Version 1.24.0-rc.1.0-gb8f099851-x86_64-linux-gnu-11.2.1
• Windows 11 Enterprise
• Chrome Version 128.0.6613.120 (Official Build) (64-bit)

The following checks were performed, tests are updated:

• Single/Several Multi-Tailed Arrows with correct positions and coordinates can be saved/loaded to/from KET file separately or together with chemical elements:
  • Example of Json for default Multi-Tailed arrow:
    
  • How it looks like after loading on Canvas:
    
• Multi-Tailed Arrow can be added to Canvas from the KET file as a new project, by adding to Canvas, from the clipboard;
• Correct preview of Multi-Tailed on Save/Load of KET file in Json;
• Loading of corrupted KET file with Multi-Tailed Arrows (wrong fields, wrong coordinates of spine, head, tails)
• Switching from Micro to Macro and back on Canvas with Multi-Tailed Arrows;
• Undo/Redo of adding Multi-Tailed Arrow;
• Zoom actions with Multi-Tailed Arrow on Canvas;

Defects below are detected and fixed:

• Preview: When user copies any element on Canvas and Multi-Tail arrow is on Canvas, Multi-Tail arrow is copied too #5308;
• Preview: Can't delete the first multi-tail arrow if the first is added as a new project and second by any another option #5311;

This defect will be fixed in Ketcher 2.25.0-rc.2:

• Issue with loading from KET Multi-Tailed arrows because of floating-point format of coordinates #5447

[ivanmaslow]

In scope of this task we are going to change validations for minimal sizes - #5761