feat(drawing): линия-выноска с текстом (drawing_add_leader)

Выноска на виде через API7 ISymbols2DContainer.Leaders. Стрелка указывает в (x,y), текст на полке у (textX,textY). shelfDirection: auto|right|left|up|down. - DrawingService.AddLeaderAsync + GetViewLeaderCountAsync - ShelfDirection (enum + Parse/ToKompas), переиспользует DrawingAnnotationResult - 13 unit + 7 интеграционных тестов (всего 328 зелёных), сборка Release чистая КЛЮЧ (спайк): новая выноска имеет 0 ответвлений — сначала (IBranchs)bl.AddBranchByPoint(0,x,y) (остриё), ИНАЧЕ КОМПАС падает RPC_E_SERVERFAULT; затем SetBranchTextPosition (полка), (ILeader)bl.TextOnShelf.Str (текст), Update. Ревью спека Codex+pi/glm-5.1+pi/kimi-k2.6 учтено (QI as?? throw, read-back ?? empty, RequireDistinctPoints, RU-алиасы, критический порядок). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-28 00:18:08 +03:00
parent 08191db25c
commit f89ad951ae
6 changed files with 410 additions and 0 deletions
@@ -0,0 +1,141 @@
+using Kompas.Mcp.Core.Documents;
+using Kompas.Mcp.Core.Drawings;
+using Kompas.Mcp.Core.Modeling;
+
+namespace Kompas.Mcp.Tests.Integration;
+
+/// <summary>Интеграция: линия-выноска с текстом на виде (API7 ISymbols2DContainer.Leaders + IBranchs).</summary>
+[Trait("Category", "Integration")]
+[Collection(KompasCollection.Name)]
+public sealed class DrawingLeaderTests : IntegrationTestBase
+{
+    private readonly DocumentService _docs;
+    private readonly PartModeler _modeler;
+    private readonly DrawingService _drawing;
+
+    public DrawingLeaderTests(KompasFixture fx) : base(fx)
+    {
+        _docs = new DocumentService(fx.Session, fx.Dispatcher);
+        _modeler = new PartModeler(fx.Session, fx.Dispatcher);
+        _drawing = new DrawingService(fx.Session, fx.Dispatcher);
+    }
+
+    private async Task<string> BuildAndSaveBoxAsync()
+    {
+        var path = TestPaths.NewFile(".m3d");
+        await _docs.CreateAsync(KompasDocumentType.Part);
+        try
+        {
+            var s = await _modeler.OpenSketchAsync(BasePlane.XOY);
+            await _modeler.AddRectangleAsync(s, 0, 0, 40, 30);
+            await _modeler.CloseSketchAsync(s);
+            await _modeler.ExtrudeAsync(s, depth: 20);
+            await _modeler.RebuildAsync();
+            await _docs.SaveAsAsync(path);
+        }
+        finally { await _docs.CloseAsync(save: false); }
+        return path;
+    }
+
+    [Fact]
+    public async Task Leader_is_placed_round_trip_and_resolves_default_view()
+    {
+        var partFile = await BuildAndSaveBoxAsync();
+        await _docs.CreateAsync(KompasDocumentType.Drawing);
+        try
+        {
+            var views = await _drawing.CreateStandardViewsAsync(partFile, 1.0, 100, 150);
+            var first = views.ViewNumbers[0];
+
+            var before = await _drawing.GetViewLeaderCountAsync(first);
+            // viewNumber=0 → первый несистемный вид (= first)
+            var r = await _drawing.AddLeaderAsync(0, x: 5, y: 5, textX: 25, textY: 20,
+                text: "Примечание 1", shelfDirection: ShelfDirection.Auto);
+            var after = await _drawing.GetViewLeaderCountAsync(first);
+
+            Assert.Equal(first, r.ViewNumber);
+            Assert.Equal("Примечание 1", r.Value); // read-back из COM
+            Assert.Equal(before + 1, after);
+        }
+        finally { await _docs.CloseAsync(save: false); }
+    }
+
+    [Fact]
+    public async Task Leader_with_explicit_shelf_direction()
+    {
+        var partFile = await BuildAndSaveBoxAsync();
+        await _docs.CreateAsync(KompasDocumentType.Drawing);
+        try
+        {
+            var views = await _drawing.CreateStandardViewsAsync(partFile, 1.0, 100, 150);
+            var target = views.ViewNumbers[0];
+            var before = await _drawing.GetViewLeaderCountAsync(target);
+            var r = await _drawing.AddLeaderAsync(target, x: 10, y: 8, textX: 30, textY: 25,
+                text: "Слева", shelfDirection: ShelfDirection.Left);
+            var after = await _drawing.GetViewLeaderCountAsync(target);
+            Assert.Equal(before + 1, after);
+            Assert.Equal("Слева", r.Value);
+        }
+        finally { await _docs.CloseAsync(save: false); }
+    }
+
+    [Theory]
+    [InlineData("")]
+    [InlineData("   ")]
+    public async Task Empty_text_throws(string text)
+    {
+        var partFile = await BuildAndSaveBoxAsync();
+        await _docs.CreateAsync(KompasDocumentType.Drawing);
+        try
+        {
+            await _drawing.CreateStandardViewsAsync(partFile, 1.0, 100, 150);
+            await Assert.ThrowsAsync<ArgumentException>(() =>
+                _drawing.AddLeaderAsync(0, x: 5, y: 5, textX: 25, textY: 20, text: text,
+                    shelfDirection: ShelfDirection.Auto));
+        }
+        finally { await _docs.CloseAsync(save: false); }
+    }
+
+    [Fact]
+    public async Task Degenerate_tip_equals_shelf_throws()
+    {
+        var partFile = await BuildAndSaveBoxAsync();
+        await _docs.CreateAsync(KompasDocumentType.Drawing);
+        try
+        {
+            await _drawing.CreateStandardViewsAsync(partFile, 1.0, 100, 150);
+            await Assert.ThrowsAsync<ArgumentException>(() =>
+                _drawing.AddLeaderAsync(0, x: 5, y: 5, textX: 5, textY: 5, text: "X",
+                    shelfDirection: ShelfDirection.Auto));
+        }
+        finally { await _docs.CloseAsync(save: false); }
+    }
+
+    [Fact]
+    public async Task No_views_throws()
+    {
+        await _docs.CreateAsync(KompasDocumentType.Drawing);
+        try
+        {
+            await Assert.ThrowsAsync<InvalidOperationException>(() =>
+                _drawing.AddLeaderAsync(0, x: 5, y: 5, textX: 25, textY: 20, text: "X",
+                    shelfDirection: ShelfDirection.Auto));
+        }
+        finally { await _docs.CloseAsync(save: false); }
+    }
+
+    [Fact]
+    public async Task Unknown_view_number_throws()
+    {
+        var partFile = await BuildAndSaveBoxAsync();
+        await _docs.CreateAsync(KompasDocumentType.Drawing);
+        try
+        {
+            await _drawing.CreateStandardViewsAsync(partFile, 1.0, 100, 150);
+            await Assert.ThrowsAsync<InvalidOperationException>(() =>
+                _drawing.AddLeaderAsync(999, x: 5, y: 5, textX: 25, textY: 20, text: "X",
+                    shelfDirection: ShelfDirection.Auto));
+        }
+        finally { await _docs.CloseAsync(save: false); }
+    }
+}
@@ -0,0 +1,32 @@
+using Kompas.Mcp.Core.Drawings;
+
+namespace Kompas.Mcp.Tests;
+
+[Trait("Category", "Unit")]
+public sealed class ShelfDirectionsTests
+{
+    [Theory]
+    [InlineData("auto", ShelfDirection.Auto)]
+    [InlineData("right", ShelfDirection.Right)]
+    [InlineData("left", ShelfDirection.Left)]
+    [InlineData("up", ShelfDirection.Up)]
+    [InlineData("down", ShelfDirection.Down)]
+    [InlineData("  RIGHT ", ShelfDirection.Right)]
+    [InlineData("авто", ShelfDirection.Auto)]
+    [InlineData("вправо", ShelfDirection.Right)]
+    [InlineData("влево", ShelfDirection.Left)]
+    [InlineData("вверх", ShelfDirection.Up)]
+    [InlineData("вниз", ShelfDirection.Down)]
+    public void Parse_maps_known(string value, ShelfDirection expected)
+        => Assert.Equal(expected, ShelfDirections.Parse(value));
+
+    [Fact]
+    public void Parse_throws_on_unknown()
+        => Assert.Throws<ArgumentException>(() => ShelfDirections.Parse("diagonal"));
+
+    [Fact]
+    public void Parse_throws_on_null()
+        => Assert.Throws<ArgumentNullException>(() => ShelfDirections.Parse(null!));
+
+    // ToKompas (→ ksShelfDirectionEnum) — граница проекта; для Auto бросает (проверяется косвенно).
+}