[ Word ROTATES ]

QWERTYkez.ExcelProcessor/Editors/CellAddressHelper.cs

@@ -2,8 +2,8 @@
 
 internal static class CellAddressHelper
 {
-    private const string letters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+    const string letters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
-    private static readonly uint[] _powers = [1, 26, 676];
+    static readonly uint[] _powers = [1, 26, 676];
 
     public static uint ColumnLetterToIndex(string col)
     {

QWERTYkez.ExcelProcessor/Editors/CellAlign.cs

@@ -18,6 +18,30 @@ public readonly struct CellAlign : IEquatable<CellAlign>
     /// <summary>Уменьшать размер шрифта, чтобы текст поместился в ячейку.</summary>
     public bool? ShrinkToFit { get; init; }
 
+
+    internal bool TryMerge(CellAlign other, out CellAlign result)
+    {
+        // Если other не содержит новых значений, возвращаем this
+        if (other.Horizontal == Horizontal &&
+            other.Vertical == Vertical &&
+            other.WrapText == WrapText &&
+            other.ShrinkToFit == ShrinkToFit)
+        {
+            result = default;
+            return false;
+        }
+
+        result = new CellAlign
+        {
+            Horizontal = other.Horizontal ?? Horizontal,
+            Vertical = other.Vertical ?? Vertical,
+            WrapText = other.WrapText ?? WrapText,
+            ShrinkToFit = other.ShrinkToFit ?? ShrinkToFit
+        };
+        return true;
+    }
+
+
     /// <summary>Преобразует горизонтальное выравнивание в тип Open XML.</summary>
     public bool TryGetExcelHorizontalAlignment(out HorizontalAlignmentValues value)
     {
@@ -104,7 +128,7 @@ public readonly struct CellAlign : IEquatable<CellAlign>
         return result;
     }
 
-    private static CellAlignHorizontal MapHorizontalFromExcel(HorizontalAlignmentValues value)
+    static CellAlignHorizontal MapHorizontalFromExcel(HorizontalAlignmentValues value)
     {
         if (value == HorizontalAlignmentValues.Left)
         {
@@ -137,7 +161,7 @@ public readonly struct CellAlign : IEquatable<CellAlign>
         else throw new NotSupportedException($"Unsupported horizontal alignment: {value}");
     }
 
-    private static CellAlignVertical MapVerticalFromExcel(VerticalAlignmentValues value)
+    static CellAlignVertical MapVerticalFromExcel(VerticalAlignmentValues value)
     {
         if (value == VerticalAlignmentValues.Top)
         {

QWERTYkez.ExcelProcessor/Editors/CellBorder.cs

@@ -1,11 +1,53 @@
 namespace QWERTYkez.ExcelProcessor;
 
+
+
+
 /// <summary>
 /// Определяет границы ячейки: верхнюю, нижнюю, левую, правую и диагональные.
 /// Каждая граница может иметь стиль и цвет.
 /// </summary>
 public readonly struct CellBorder : IEquatable<CellBorder>
 {
+
+    public static CellBorder BottomThin { get; } = new() { BottomBorder = BorderSide.BlackThin };
+    public static CellBorder TopThin { get; } = new() { TopBorder = BorderSide.BlackThin };
+    public static CellBorder LeftThin { get; } = new() { LeftBorder = BorderSide.BlackThin };
+    public static CellBorder RightThin { get; } = new() { RightBorder = BorderSide.BlackThin };
+    public static CellBorder AllThin { get; } = new()
+    {
+        BottomBorder = BorderSide.BlackThin,
+        TopBorder = BorderSide.BlackThin,
+        LeftBorder = BorderSide.BlackThin,
+        RightBorder = BorderSide.BlackThin
+    };
+
+    public static CellBorder BottomMedium { get; } = new() { BottomBorder = BorderSide.BlackMedium };
+    public static CellBorder TopMedium { get; } = new() { TopBorder = BorderSide.BlackMedium };
+    public static CellBorder LeftMedium { get; } = new() { LeftBorder = BorderSide.BlackMedium };
+    public static CellBorder RightMedium { get; } = new() { RightBorder = BorderSide.BlackMedium };
+    public static CellBorder AllMedium { get; } = new()
+    {
+        BottomBorder = BorderSide.BlackMedium,
+        TopBorder = BorderSide.BlackMedium,
+        LeftBorder = BorderSide.BlackMedium,
+        RightBorder = BorderSide.BlackMedium
+    };
+
+    public static CellBorder BottomThick { get; } = new() { BottomBorder = BorderSide.BlackThick };
+    public static CellBorder TopThick { get; } = new() { TopBorder = BorderSide.BlackThick };
+    public static CellBorder LeftThick { get; } = new() { LeftBorder = BorderSide.BlackThick };
+    public static CellBorder RightThick { get; } = new() { RightBorder = BorderSide.BlackThick };
+    public static CellBorder AllThick { get; } = new()
+    {
+        BottomBorder = BorderSide.BlackThick,
+        TopBorder = BorderSide.BlackThick,
+        LeftBorder = BorderSide.BlackThick,
+        RightBorder = BorderSide.BlackThick
+    };
+
+
+
     /// <summary>Верхняя граница.</summary>
     public BorderSide? TopBorder { get; init; }
 
@@ -24,6 +66,33 @@ public readonly struct CellBorder : IEquatable<CellBorder>
     /// <summary>Диагональная граница «из левого нижнего в правый верхний» (//).</summary>
     public BorderSide? DiagonalRight { get; init; }
 
+
+    public bool TryMerge(CellBorder other, out CellBorder result)
+    {
+        if (other.TopBorder == TopBorder &&
+            other.BottomBorder == BottomBorder &&
+            other.LeftBorder == LeftBorder &&
+            other.RightBorder == RightBorder &&
+            other.DiagonalLeft == DiagonalLeft &&
+            other.DiagonalRight == DiagonalRight)
+        {
+            result = default;
+            return false;
+        }
+
+        result = new CellBorder
+        {
+            TopBorder = other.TopBorder ?? TopBorder,
+            BottomBorder = other.BottomBorder ?? BottomBorder,
+            LeftBorder = other.LeftBorder ?? LeftBorder,
+            RightBorder = other.RightBorder ?? RightBorder,
+            DiagonalLeft = other.DiagonalLeft ?? DiagonalLeft,
+            DiagonalRight = other.DiagonalRight ?? DiagonalRight
+        };
+        return true;
+    }
+
+
     /// <summary>Создаёт элемент Border для Open XML.</summary>
     public Border? ToBorder()
     {
@@ -112,11 +181,23 @@ public readonly struct CellBorder : IEquatable<CellBorder>
 /// <summary>Стиль и цвет границы.</summary>
 public readonly struct BorderSide : IEquatable<BorderSide>
 {
+    /// <summary>Тонкая черная линия</summary>
+    public static BorderSide BlackThin { get; } = new() { Color = System.Drawing.Color.Black, Style = BorderStyle.Thin };
+
+    /// <summary>Толстая черная линия</summary>
+    public static BorderSide BlackThick { get; } = new() { Color = System.Drawing.Color.Black, Style = BorderStyle.Thick };
+
+    /// <summary>Средняя черная линия</summary>
+    public static BorderSide BlackMedium { get; } = new() { Color = System.Drawing.Color.Black, Style = BorderStyle.Medium };
+
+
+
+
     /// <summary>Стиль линии границы.</summary>
     public BorderStyle? Style { get; init; }
 
     /// <summary>Цвет границы.</summary>
-    public ExColor? Color { get; init; }
+    public System.Drawing.Color? Color { get; init; }
 
     internal T ToBorderElement<T>() where T : BorderPropertiesType, new()
     {
@@ -141,9 +222,9 @@ public readonly struct BorderSide : IEquatable<BorderSide>
                 _ => throw new NotImplementedException(),
             };
         }
-        if (Color.HasValue && Color.Value.Color.HasValue)
+        if (Color.HasValue)
         {
-            var c = Color.Value.Color.Value;
+            var c = Color.Value;
             element.Color = new Color { Rgb = $"{c.R:X2}{c.G:X2}{c.B:X2}" };
         }
         return element;
@@ -162,17 +243,18 @@ public readonly struct BorderSide : IEquatable<BorderSide>
         }
         if (borderElement.Color?.Rgb?.Value is { } rgb && rgb.Length >= 6)
         {
-            var color = System.Drawing.Color.FromArgb(
+            result = result with
+            {
+                Color = System.Drawing.Color.FromArgb(
                     Convert.ToByte(rgb.Substring(0, 2), 16),
                     Convert.ToByte(rgb.Substring(2, 2), 16),
-                Convert.ToByte(rgb.Substring(4, 2), 16)
+                    Convert.ToByte(rgb.Substring(4, 2), 16))
-            );
+            };
-            result = result with { Color = new ExColor(color) };
         }
         return result;
     }
 
-    private static BorderStyle MapBorderStyleFromExcel(BorderStyleValues value)
+    static BorderStyle MapBorderStyleFromExcel(BorderStyleValues value)
     {
         if (value == BorderStyleValues.Thin)
         {
@@ -279,3 +361,24 @@ public enum BorderStyle
     /// <summary> Наклонная штрих-пунктирная (для диагональных) </summary>
     SlantDashDot,
 }
+
+/// <summary>
+/// Определяет, какие границы диапазона следует применить.
+/// </summary>
+public enum BorderTarget
+{
+    /// <summary>Все границы (внешние и внутренние) – полная сетка.</summary>
+    All,
+    /// <summary>Только внешние границы диапазона.</summary>
+    Outside,
+    /// <summary>Только внутренние границы (между ячейками).</summary>
+    Inside,
+    /// <summary>Только верхняя граница диапазона.</summary>
+    Top,
+    /// <summary>Только нижняя граница диапазона.</summary>
+    Bottom,
+    /// <summary>Только левая граница диапазона.</summary>
+    Left,
+    /// <summary>Только правая граница диапазона.</summary>
+    Right
+}

QWERTYkez.ExcelProcessor/Editors/CellFill.cs

@@ -6,15 +6,13 @@
 public readonly struct CellFill : IEquatable<CellFill>
 {
     /// <summary>Цвет фона.</summary>
-    public ExColor? BackgroundColor { get; init; }
+    public System.Drawing.Color? BackgroundColor { get; init; }
 
     /// <summary>Создаёт элемент Fill для Open XML.</summary>
     public Fill? ToFill()
     {
-        if (!BackgroundColor.HasValue || !BackgroundColor.Value.Color.HasValue)
+        if (BackgroundColor is not { } c) return null;
-            return null;
 
-        var c = BackgroundColor.Value.Color.Value;
         var fill = new Fill
         {
             PatternFill = new PatternFill
@@ -37,7 +35,7 @@ public readonly struct CellFill : IEquatable<CellFill>
             Convert.ToByte(rgb.Substring(2, 2), 16),
             Convert.ToByte(rgb.Substring(4, 2), 16)
         );
-        return new CellFill { BackgroundColor = new ExColor(color) };
+        return new CellFill { BackgroundColor = color };
     }
 
     public override bool Equals(object? obj) => obj is CellFill other && Equals(other);

QWERTYkez.ExcelProcessor/Editors/CellFont.cs

@@ -13,7 +13,7 @@ public readonly struct CellFont : IEquatable<CellFont>
     public string? FontFamily { get; init; }
 
     /// <summary>Цвет текста.</summary>
-    public ExColor? FontColor { get; init; }
+    public System.Drawing.Color? FontColor { get; init; }
 
     /// <summary>Жирное начертание.</summary>
     public bool? IsBold { get; init; }
@@ -27,6 +27,35 @@ public readonly struct CellFont : IEquatable<CellFont>
     /// <summary>Зачёркивание.</summary>
     public bool? IsStrike { get; init; }
 
+
+    internal bool TryMerge(CellFont other, out CellFont result)
+    {
+        if (other.FontSize == FontSize &&
+            other.FontFamily == FontFamily &&
+            other.FontColor == FontColor &&
+            other.IsBold == IsBold &&
+            other.IsItalic == IsItalic &&
+            other.IsUnderline == IsUnderline &&
+            other.IsStrike == IsStrike)
+        {
+            result = default;
+            return false;
+        }
+
+        result = new CellFont
+        {
+            FontSize = other.FontSize ?? FontSize,
+            FontFamily = other.FontFamily ?? FontFamily,
+            FontColor = other.FontColor ?? FontColor,
+            IsBold = other.IsBold ?? IsBold,
+            IsItalic = other.IsItalic ?? IsItalic,
+            IsUnderline = other.IsUnderline ?? IsUnderline,
+            IsStrike = other.IsStrike ?? IsStrike
+        };
+        return true;
+    }
+
+
     /// <summary>Создаёт элемент Font для Open XML.</summary>
     public Font? ToFont()
     {
@@ -39,11 +68,8 @@ public readonly struct CellFont : IEquatable<CellFont>
             font.FontSize = new FontSize { Val = FontSize.Value };
         if (FontFamily is not null)
             font.FontName = new FontName { Val = FontFamily };
-        if (FontColor.HasValue && FontColor.Value.Color.HasValue)
+        if (FontColor is { } c)
-        {
-            var c = FontColor.Value.Color.Value;
             font.Color = new Color { Rgb = $"{c.R:X2}{c.G:X2}{c.B:X2}" };
-        }
         if (IsBold == true) font.Bold = new Bold();
         if (IsItalic == true) font.Italic = new Italic();
         if (IsUnderline == true) font.Underline = new Underline();
@@ -75,7 +101,7 @@ public readonly struct CellFont : IEquatable<CellFont>
                 Convert.ToByte(rgb.Substring(2, 2), 16),
                 Convert.ToByte(rgb.Substring(4, 2), 16)
             );
-            result = result with { FontColor = new ExColor(color) };
+            result = result with { FontColor = color };
         }
         return result;
     }

QWERTYkez.ExcelProcessor/Editors/CellStyle.cs

@@ -0,0 +1,153 @@
+namespace QWERTYkez.ExcelProcessor;
+
+/// <summary>
+/// Неизменяемый набор всех параметров оформления ячейки.
+/// </summary>
+public sealed record CellStyle
+{
+    public CellAlign? Align { get; init; }
+    public CellFont? Font { get; init; }
+    public CellFill? Fill { get; init; }
+    public CellBorder? Border { get; init; }
+    public NumberFormatPattern? NumberFormat { get; init; }
+
+    public bool IsEmpty() =>
+        Align == null && Font == null && Fill == null && Border == null && NumberFormat == null;
+
+    internal bool TryMerge(NumberFormatPattern format, out CellStyle result)
+    {
+        result = this;
+        if (format is not null)
+        {
+            if (!Equals(NumberFormat, format))
+            {
+                result = result with { NumberFormat = format };
+                return true;
+            }
+        }
+        return false;
+    }
+
+    internal bool TryMerge(CellAlign align, out CellStyle result)
+    {
+        result = this;
+        var current = Align ?? new CellAlign();
+        if (current.TryMerge(align, out align))
+        {
+            result = result with { Align = align };
+            return true;
+        }
+        return false;
+    }
+
+    internal bool TryMerge(CellBorder border, out CellStyle result)
+    {
+        result = this;
+        var current = Border ?? new CellBorder();
+        if (current.TryMerge(border, out border))
+        {
+            result = result with { Border = border };
+            return true;
+        }
+        return false;
+    }
+
+    internal bool TryMerge(CellFill fill, out CellStyle result)
+    {
+        result = this;
+        var current = Fill ?? new CellFill();
+        if (!current.Equals(fill))
+        {
+            result = result with { Fill = fill };
+            return true;
+        }
+        return false;
+    }
+
+    internal bool TryMerge(CellFont font, out CellStyle result)
+    {
+        result = this;
+        var current = Font ?? new CellFont();
+        if (!current.Equals(font))
+        {
+            result = result with { Font = font };
+            return true;
+        }
+        return false;
+    }
+
+    internal CellStyle Merge(CellStyle other)
+    {
+        if (other == null) return this;
+        return new CellStyle
+        {
+            Align = other.Align ?? Align,
+            Font = other.Font ?? Font,
+            Fill = other.Fill ?? Fill,
+            Border = other.Border ?? Border,
+            NumberFormat = other.NumberFormat ?? NumberFormat
+        };
+    }
+
+    internal bool TryMerge(CellStyle other, out CellStyle result)
+    {
+        result = this;
+
+        bool changed = false;
+
+        // Объединяем Align, если есть
+        if (other.Align is not null)
+        {
+            var currentAlign = Align ?? new CellAlign();
+            if (currentAlign.TryMerge(other.Align.Value, out var newAlign))
+            {
+                result = result with { Align = newAlign };
+                changed = true;
+            }
+        }
+
+        // Аналогично для Font
+        if (other.Font is not null)
+        {
+            var currentFont = Font ?? new CellFont();
+            if (currentFont.TryMerge(other.Font.Value, out var newFont))
+            {
+                result = result with { Font = newFont };
+                changed = true;
+            }
+        }
+
+        // Для Fill просто заменяем, если он задан (нет nullable-полей)
+        if (other.Fill is not null)
+        {
+            if (!Fill.Equals(other.Fill))
+            {
+                result = result with { Fill = other.Fill };
+                changed = true;
+            }
+        }
+
+        // Border
+        if (other.Border is not null)
+        {
+            var currentBorder = Border ?? new CellBorder();
+            if (currentBorder.TryMerge(other.Border.Value, out var newBorder))
+            {
+                result = result with { Border = newBorder };
+                changed = true;
+            }
+        }
+
+        // NumberFormat
+        if (other.NumberFormat is not null)
+        {
+            if (!Equals(NumberFormat, other.NumberFormat))
+            {
+                result = result with { NumberFormat = other.NumberFormat };
+                changed = true;
+            }
+        }
+
+        return changed;
+    }
+}

QWERTYkez.ExcelProcessor/Editors/ColumnWidth.cs

@@ -6,15 +6,15 @@
     /// </summary>
     public readonly struct ColumnWidth
     {
-        private readonly double _rawValue;
+        readonly double _rawValue;
-        private readonly UnitType _unit;
+        readonly UnitType _unit;
 
-        private enum UnitType { Characters, Points, Centimeters, Millimeters }
+        enum UnitType { Characters, Points, Centimeters, Millimeters }
 
         /// <summary>Коэффициент перевода символов в пункты по умолчанию (используется, если нет калибровочной таблицы).</summary>
         public static double DefaultPointsPerChar { get; set; } = 5.65;
 
-        private ColumnWidth(double value, UnitType unit)
+        ColumnWidth(double value, UnitType unit)
         {
             _rawValue = value;
             _unit = unit;

QWERTYkez.ExcelProcessor/Editors/ExColor.cs

@@ -1,82 +0,0 @@
-namespace QWERTYkez.ExcelProcessor;
-
-public readonly struct ExColor(System.Drawing.Color? Color)
-{
-    private readonly System.Drawing.Color? color = Color;
-
-    /// <summary>Проверяет, является ли цвет автоматическим (т.е. Color == null).</summary>
-    public bool IsAuto => color is null;
-
-    public System.Drawing.Color? Color => color;
-
-    public static ExColor FromArgb(byte r, byte g, byte b) => new(System.Drawing.Color.FromArgb(r, g, b));
-    public static ExColor FromName(string knownColor) => new(System.Drawing.Color.FromName(knownColor));
-
-
-
-    public static implicit operator ExColor(Color exColor) => FromExcel(exColor);
-    public static implicit operator Color(ExColor color) => color.ToExcel();
-    public static ExColor FromExcel(Color excelColor)
-    {
-        if (excelColor == null)
-            return new ExColor(null);
-
-        // Если цвет автоматический
-        if (excelColor.Auto != null && excelColor.Auto.Value)
-            return new ExColor(null);
-
-        // Если задан RGB
-        if (excelColor.Rgb?.Value is { } rgb && rgb.Length > 0)
-        {
-            if (rgb.Length == 6) // RRGGBB
-            {
-                byte r = Convert.ToByte(rgb.Substring(0, 2), 16);
-                byte g = Convert.ToByte(rgb.Substring(2, 2), 16);
-                byte b = Convert.ToByte(rgb.Substring(4, 2), 16);
-                return new ExColor(System.Drawing.Color.FromArgb(r, g, b));
-            }
-            else if (rgb.Length == 8) // AARRGGBB (альфа игнорируется)
-            {
-                byte r = Convert.ToByte(rgb.Substring(2, 2), 16);
-                byte g = Convert.ToByte(rgb.Substring(4, 2), 16);
-                byte b = Convert.ToByte(rgb.Substring(6, 2), 16);
-                return new ExColor(System.Drawing.Color.FromArgb(r, g, b));
-            }
-        }
-
-        // По умолчанию — автоматический цвет
-        return new ExColor(null);
-    }
-    public Color ToExcel()
-    {
-        var excelColor = new Color();
-        {
-            if (color.HasValue)
-            {
-                excelColor.Rgb = $"{color.Value.R:X2}{color.Value.G:X2}{color.Value.B:X2}";
-            }
-            else excelColor.Auto = true;
-        }
-        return excelColor;
-    }
-
-    public static ExColor FromRgb(string rgb)
-    {
-        if (string.IsNullOrEmpty(rgb)) return new ExColor(null);
-        if (rgb.Length == 6)
-        {
-            byte r = Convert.ToByte(rgb.Substring(0, 2), 16);
-            byte g = Convert.ToByte(rgb.Substring(2, 2), 16);
-            byte b = Convert.ToByte(rgb.Substring(4, 2), 16);
-            return new ExColor(System.Drawing.Color.FromArgb(r, g, b));
-        }
-        else if (rgb.Length == 8)
-        {
-            byte r = Convert.ToByte(rgb.Substring(2, 2), 16);
-            byte g = Convert.ToByte(rgb.Substring(4, 2), 16);
-            byte b = Convert.ToByte(rgb.Substring(6, 2), 16);
-            return new ExColor(System.Drawing.Color.FromArgb(r, g, b));
-        }
-        return new ExColor(null);
-    }
-}

QWERTYkez.ExcelProcessor/Editors/ExcelBook.cs

@@ -21,16 +21,16 @@ internal sealed class ExcelBook : IBook
     public IReadOnlyList<ISheet> GetSheets() => Writer.GetSheets();
 
     /// <inheritdoc />
-    public ISheet? Sheet(string name) => Writer.Sheet(name);
+    public ISheet? Sheet(string name) => Writer.Sheet(name.EscapeSymbols());
 
     /// <inheritdoc />
-    public bool TryGetSheet(string name, out ISheet sheet) => Writer.TryGetSheet(name, out sheet);
+    public bool TryGetSheet(string name, out ISheet sheet) => Writer.TryGetSheet(name.EscapeSymbols(), out sheet);
 
     /// <inheritdoc />
-    public bool TryAddSheet(string name, Action<ISheet>? edit = null) => Writer.TryAddSheet(name, edit);
+    public bool TryAddSheet(string name, Action<ISheet>? edit = null) => Writer.TryAddSheet(name.EscapeSymbols(), edit);
 
     /// <inheritdoc />
-    public bool TryRemoveSheet(string name) => Writer.TryRemoveSheet(name);
+    public bool TryRemoveSheet(string name) => Writer.TryRemoveSheet(name.EscapeSymbols());
 
     /// <inheritdoc />
     public bool TryRemoveSheet(ISheet sheet) => Writer.TryRemoveSheet(sheet);
@@ -41,3 +41,21 @@ internal sealed class ExcelBook : IBook
     /// <inheritdoc />
     public NumberFormatPattern CreateNumberFormat(string format) => Writer.CreateNumberFormat(format);
 }
+
+public static class EscapeExt
+{
+    public static string EscapeSymbols(this string source)
+    {
+        var sb = new StringBuilder(source);
+
+        sb.Replace('/', '∕');
+        sb.Replace('\\', '∖');
+        sb.Replace('*', '∗');
+        sb.Replace('?', '？');
+        sb.Replace(':', '˸');
+        sb.Replace('[', '［');
+        sb.Replace(']', '］');
+
+        return sb.ToString();
+    }
+}

QWERTYkez.ExcelProcessor/Editors/ExcelCellText.cs

@@ -1,270 +0,0 @@
-namespace QWERTYkez.ExcelProcessor;
-
-/// <summary>
-/// Внутренняя реализация <see cref="ICellText"/> для работы с богатым текстом ячейки.
-/// Хранит коллекцию фрагментов <see cref="ExcelRun"/>.
-/// Минимизирует аллокации, не использует рефлексию.
-/// </summary>
-internal sealed class ExcelCellText : ICellText
-{
-    private List<IRun>? _runs;
-
-    /// <inheritdoc />
-    public int Count => _runs?.Count ?? 0;
-
-    /// <inheritdoc />
-    public IEnumerable<IRun> GetRuns()
-    {
-        if (_runs is null)
-            return [];
-        // Возвращаем сам список, чтобы избежать копирования.
-        // Вызывающий не должен модифицировать коллекцию.
-        return _runs;
-    }
-
-    /// <inheritdoc />
-    public IRun? GetRunAt(int index)
-    {
-        if (_runs is null || index < 0 || index >= _runs.Count)
-            return null;
-        return _runs[index];
-    }
-
-    /// <inheritdoc />
-    public bool TryGetRunAt(int index, out IRun run)
-    {
-        run = GetRunAt(index)!;
-        return run != null;
-    }
-
-    /// <inheritdoc />
-    public IRun? First()
-    {
-        if (_runs is null || _runs.Count == 0)
-            return null;
-        return _runs[0];
-    }
-
-    /// <inheritdoc />
-    public bool TryGetFirst(out IRun run)
-    {
-        run = First()!;
-        return run != null;
-    }
-
-    /// <inheritdoc />
-    public IRun? Last()
-    {
-        if (_runs is null || _runs.Count == 0)
-            return null;
-        return _runs[_runs.Count - 1];
-    }
-
-    /// <inheritdoc />
-    public bool TryGetLast(out IRun run)
-    {
-        run = Last()!;
-        return run != null;
-    }
-
-    /// <inheritdoc />
-    public bool TryRemoveRun(IRun run)
-    {
-        if (run is null || _runs is null)
-            return false;
-        return _runs.Remove(run);
-    }
-
-    /// <inheritdoc />
-    public bool TryRemoveRun(int index)
-    {
-        if (_runs is null || index < 0 || index >= _runs.Count)
-            return false;
-        _runs.RemoveAt(index);
-        return true;
-    }
-
-    /// <inheritdoc />
-    public bool TryRemoveRun(int index, out IRun? removed)
-    {
-        removed = GetRunAt(index);
-        if (removed is null)
-            return false;
-        return TryRemoveRun(index);
-    }
-
-    /// <inheritdoc />
-    public ICellText Break()
-    {
-        // Добавляем символ переноса строки в последний существующий Run
-        if (_runs != null && _runs.Count > 0)
-        {
-            var lastRun = _runs[_runs.Count - 1];
-            lastRun.Text += "\n";
-        }
-        else
-        {
-            // Если нет ни одного Run, создаём новый с символом переноса
-            Run("\n", null);
-        }
-        return this;
-    }
-
-    /// <inheritdoc />
-    public ICellText Run(string text, RunFormat? format = null)
-    {
-        if (string.IsNullOrEmpty(text))
-            return this;
-        _runs ??= [];
-        var run = new ExcelRun { Text = text, Format = format };
-        _runs.Add(run);
-        return this;
-    }
-
-    /// <inheritdoc />
-    public ICellText RunBreak(string text, RunFormat? format = null)
-    {
-        Run(text, format);
-        Break();
-        return this;
-    }
-
-    /// <inheritdoc />
-    public ICellText Sub(string text, RunFormat? format = null)
-    {
-        var subFormat = format is { } fmt
-            ? new RunFormat
-            {
-                IsBold = fmt.IsBold,
-                IsItalic = fmt.IsItalic,
-                Underline = fmt.Underline,
-                IsStrike = fmt.IsStrike,
-                Color = fmt.Color,
-                FontSize = fmt.FontSize,
-                FontFamily = fmt.FontFamily,
-                Vertical = VerticalTextRunAlignment.Subscript
-            }
-            : new RunFormat { Vertical = VerticalTextRunAlignment.Subscript };
-        return Run(text, subFormat);
-    }
-
-    /// <inheritdoc />
-    public ICellText Sup(string text, RunFormat? format = null)
-    {
-        var supFormat = format is { } fmt
-            ? new RunFormat
-            {
-                IsBold = fmt.IsBold,
-                IsItalic = fmt.IsItalic,
-                Underline = fmt.Underline,
-                IsStrike = fmt.IsStrike,
-                Color = fmt.Color,
-                FontSize = fmt.FontSize,
-                FontFamily = fmt.FontFamily,
-                Vertical = VerticalTextRunAlignment.Subscript
-            }
-            : new RunFormat { Vertical = VerticalTextRunAlignment.Superscript };
-        return Run(text, supFormat);
-    }
-
-    /// <inheritdoc />
-    public bool TryInsertRun(int index, string text, RunFormat? format = null)
-    {
-        if (index < 0 || string.IsNullOrEmpty(text))
-            return false;
-        _runs ??= [];
-        if (index > _runs.Count)
-            return false;
-        var run = new ExcelRun { Text = text, Format = format };
-        _runs.Insert(index, run);
-        return true;
-    }
-
-    /// <inheritdoc />
-    public bool TryInsertRunBreak(int index, string text, RunFormat? format = null)
-    {
-        if (!TryInsertRun(index, text, format))
-            return false;
-        // После вставленного run добавляем break на следующей позиции
-        Break();
-        // Сдвигаем? Просто добавляем break в конец – неверно. Break должен быть сразу после вставленного.
-        // Но AddBreak добавляет в конец. Нужно вставить break на index+1.
-        return TryInsertRun(index + 1, "\n", null);
-    }
-
-    /// <inheritdoc />
-    public bool TryInsertSub(int index, string text, RunFormat? format = null)
-    {
-        var subFormat = format is { } fmt
-            ? new RunFormat
-            {
-                IsBold = fmt.IsBold,
-                IsItalic = fmt.IsItalic,
-                Underline = fmt.Underline,
-                IsStrike = fmt.IsStrike,
-                Color = fmt.Color,
-                FontSize = fmt.FontSize,
-                FontFamily = fmt.FontFamily,
-                Vertical = VerticalTextRunAlignment.Subscript
-            }
-            : new RunFormat { Vertical = VerticalTextRunAlignment.Subscript };
-        return TryInsertRun(index, text, subFormat);
-    }
-
-    /// <inheritdoc />
-    public bool TryInsertSup(int index, string text, RunFormat? format = null)
-    {
-        var supFormat = format is { } fmt
-            ? new RunFormat
-            {
-                IsBold = fmt.IsBold,
-                IsItalic = fmt.IsItalic,
-                Underline = fmt.Underline,
-                IsStrike = fmt.IsStrike,
-                Color = fmt.Color,
-                FontSize = fmt.FontSize,
-                FontFamily = fmt.FontFamily,
-                Vertical = VerticalTextRunAlignment.Subscript
-            }
-            : new RunFormat { Vertical = VerticalTextRunAlignment.Superscript };
-        return TryInsertRun(index, text, supFormat);
-    }
-
-    /// <inheritdoc />
-    public void ApplyFormatToAllRuns(RunFormat format)
-    {
-        if (_runs is null || _runs.Count == 0)
-            return;
-        foreach (var run in _runs)
-        {
-            if (run is ExcelRun xRun)
-            {
-                // Объединение форматов: ненулевые свойства overlay заменяют значения в base.
-                var baseFmt = xRun.Format ?? new RunFormat();
-                xRun.Format = MergeRunFormat(baseFmt, format);
-            }
-        }
-    }
-
-    /// <inheritdoc />
-    public void Clear()
-    {
-        _runs?.Clear();
-        _runs = null;
-    }
-
-    private static RunFormat MergeRunFormat(RunFormat baseFmt, RunFormat overlay)
-    {
-        return new RunFormat
-        {
-            IsBold = overlay.IsBold ?? baseFmt.IsBold,
-            IsItalic = overlay.IsItalic ?? baseFmt.IsItalic,
-            Underline = overlay.Underline ?? baseFmt.Underline,
-            IsStrike = overlay.IsStrike ?? baseFmt.IsStrike,
-            Color = overlay.Color ?? baseFmt.Color,
-            FontSize = overlay.FontSize ?? baseFmt.FontSize,
-            FontFamily = overlay.FontFamily ?? baseFmt.FontFamily,
-            Vertical = overlay.Vertical ?? baseFmt.Vertical
-        };
-    }
-}

QWERTYkez.ExcelProcessor/Editors/ExcelColumn.cs

@@ -16,6 +16,160 @@ internal sealed class ExcelColumn : IColumn
         _colIndex = colIndex;
     }
 
+
+	private CellStyle? GetColumnStyle(Column columnElement)
+	{
+		if (columnElement.Style?.Value is not uint styleIndex)
+			return null;
+		return _writer.GetCellStyle(styleIndex);
+	}
+
+	private void ApplyStyleToColumn(CellStyle style)
+	{
+		var columnElement = GetOrCreateColumnElement();
+		int styleIndex = _writer.GetOrCreateStyleId(style);
+		columnElement.Style = (uint)styleIndex;
+		// Принудительно устанавливаем customStyle через атрибут
+		if (!columnElement.ExtendedAttributes.Any(attr => attr.LocalName == "customStyle" && attr.Value == "1"))
+			columnElement.SetAttribute(new OpenXmlAttribute("customStyle", "", "1"));
+	}
+
+	internal static Column? GetColumnElementInternal(ExcelSheet sheet, uint colIndex)
+	{
+		var cols = sheet.Worksheet.GetFirstChild<Columns>();
+		if (cols == null) return null;
+		foreach (Column col in cols.Elements<Column>())
+		{
+			if (col.Min?.Value is { } min && col.Max?.Value is { } max && min <= colIndex && max >= colIndex)
+				return col;
+		}
+		return null;
+	}
+
+
+	/// <inheritdoc />
+	public IColumn Set(NumberFormatPattern format)
+	{
+		if (format == null) return this;
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			var columnElement = GetOrCreateColumnElement();
+			var currentStyle = GetColumnStyle(columnElement) ?? new CellStyle();
+			if (currentStyle.TryMerge(format, out var newStyle))
+			{
+				ApplyStyleToColumn(newStyle);
+				ApplyStyleToColumnCells(newStyle);
+			}
+			return this;
+		}
+	}
+
+    /// <inheritdoc />
+    public IColumn Set(CellAlign align)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			var columnElement = GetOrCreateColumnElement();
+			var currentStyle = GetColumnStyle(columnElement) ?? new CellStyle();
+			if (currentStyle.TryMerge(align, out var newStyle))
+			{
+				ApplyStyleToColumn(newStyle);
+				ApplyStyleToColumnCells(newStyle);
+			}
+			return this;
+		}
+	}
+
+    /// <inheritdoc />
+    public IColumn Set(CellBorder border)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			var columnElement = GetOrCreateColumnElement();
+			var currentStyle = GetColumnStyle(columnElement) ?? new CellStyle();
+			if (currentStyle.TryMerge(border, out var newStyle))
+			{
+				ApplyStyleToColumn(newStyle);
+				ApplyStyleToColumnCells(newStyle);
+			}
+			return this;
+		}
+	}
+
+    /// <inheritdoc />
+    public IColumn Set(CellFill fill)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			var columnElement = GetOrCreateColumnElement();
+			var currentStyle = GetColumnStyle(columnElement) ?? new CellStyle();
+			if (currentStyle.TryMerge(fill, out var newStyle))
+			{
+				ApplyStyleToColumn(newStyle);
+				ApplyStyleToColumnCells(newStyle);
+			}
+			return this;
+		}
+	}
+
+    /// <inheritdoc />
+    public IColumn Set(CellFont font)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			var columnElement = GetOrCreateColumnElement();
+			var currentStyle = GetColumnStyle(columnElement) ?? new CellStyle();
+			if (currentStyle.TryMerge(font, out var newStyle))
+			{
+				ApplyStyleToColumn(newStyle);
+				ApplyStyleToColumnCells(newStyle);
+			}
+			return this;
+		}
+	}
+
+    /// <inheritdoc />
+    public IColumn Set(CellStyle style)
+	{
+		if (style == null) return this;
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			var columnElement = GetOrCreateColumnElement();
+			var currentStyle = GetColumnStyle(columnElement) ?? new CellStyle();
+			if (currentStyle.TryMerge(style, out var newStyle))
+			{
+				ApplyStyleToColumn(newStyle);
+				ApplyStyleToColumnCells(newStyle);
+			}
+			return this;
+		}
+	}
+
+
+
+	private void ApplyStyleToColumnCells(CellStyle style)
+	{
+		var sheetData = _sheet.GetSheetData();
+		foreach (var rowElement in sheetData.Elements<Row>())
+		{
+			var cellElement = FindCellInRow(rowElement, _colIndex);
+			if (cellElement != null)
+			{
+				var cell = new ExcelCell(_writer, _sheet, rowElement.RowIndex!.Value, _colIndex);
+				cell.Set(style);
+			}
+		}
+	}
+
+
+
+
 	public uint Index => _colIndex;
     public string IndexLetter => NumberToColumnLetter(_colIndex);
 
@@ -64,23 +218,7 @@ internal sealed class ExcelColumn : IColumn
         }
     }
 
-    // Вспомогательные внутренние методы (перенести существующую логику)
+    static Column GetOrCreateColumnElementInternal(ExcelSheet sheet, uint colIndex)
-    private static Column? GetColumnElementInternal(ExcelSheet sheet, uint colIndex)
-    {
-        var cols = sheet.Worksheet.GetFirstChild<Columns>();
-        if (cols == null) return null;
-        foreach (Column col in cols.Elements<Column>())
-        {
-            if (col?.Min?.Value is { } min
-             && col?.Max?.Value is { } max
-             && min <= colIndex
-             && max >= colIndex)
-                return col;
-        }
-        return null;
-    }
-
-    private static Column GetOrCreateColumnElementInternal(ExcelSheet sheet, uint colIndex)
     {
         var existing = GetColumnElementInternal(sheet, colIndex);
         if (existing != null) return existing;
@@ -165,23 +303,7 @@ internal sealed class ExcelColumn : IColumn
         }
     }
 
-    public IColumn SetNumberFormat(NumberFormatPattern format)
+
-    {
-        if (format == null) return this;
-        _writer.ThrowIfDisposed();
-        lock (_writer._syncLock)
-        {
-            int fmtId = GetOrCreateNumberFormatId(format);
-            // Применяем ко всем ячейкам столбца
-            var sheetData = _sheet.GetSheetData();
-            foreach (var row in sheetData.Elements<Row>())
-            {
-                var cell = FindCellInRow(row, _colIndex);
-                cell?.StyleIndex = (uint)fmtId;
-            }
-        }
-        return this;
-    }
 
     public ICell Cell(uint row)
     {
@@ -207,7 +329,7 @@ internal sealed class ExcelColumn : IColumn
 
     public IColumn Cell(uint row, string value, NumberFormatPattern? format = null)
     {
-        Cell(row).Set(value, format); return this;
+        Cell(row).SetFormula(value, format); return this;
     }
 
     public IColumn Cell(uint row, DateTime value, NumberFormatPattern? format = null)
@@ -305,7 +427,7 @@ internal sealed class ExcelColumn : IColumn
 
     // Вспомогательные методы
 
-    private Column? GetColumnElement()
+    Column? GetColumnElement()
     {
         var cols = _sheet.Worksheet.GetFirstChild<Columns>();
         if (cols == null) return null;
@@ -320,7 +442,7 @@ internal sealed class ExcelColumn : IColumn
         return null;
     }
 
-    private Column GetOrCreateColumnElement()
+    Column GetOrCreateColumnElement()
     {
         var existing = GetColumnElement();
         if (existing != null) return existing;
@@ -344,13 +466,13 @@ internal sealed class ExcelColumn : IColumn
         return newCol;
     }
 
-    private void DeleteColumnElement()
+    void DeleteColumnElement()
     {
         var col = GetColumnElement();
         col?.Remove();
     }
 
-    private void CopyColumnData(uint sourceCol, uint targetCol)
+    void CopyColumnData(uint sourceCol, uint targetCol)
     {
         if (sourceCol == targetCol) return;
         var sheetData = _sheet.GetSheetData();
@@ -389,7 +511,7 @@ internal sealed class ExcelColumn : IColumn
         }
     }
 
-    private void ClearColumnData(uint col)
+    void ClearColumnData(uint col)
     {
         var sheetData = _sheet.GetSheetData();
         foreach (var row in sheetData.Elements<Row>().ToList())
@@ -399,7 +521,7 @@ internal sealed class ExcelColumn : IColumn
         }
     }
 
-    private Cell? FindCellInRow(Row row, uint colIndex)
+    Cell? FindCellInRow(Row row, uint colIndex)
     {
         foreach (var cell in row.Elements<Cell>())
         {
@@ -410,7 +532,7 @@ internal sealed class ExcelColumn : IColumn
         return null;
     }
 
-    private void InsertCellInRow(Row row, Cell cell, uint colIndex)
+    void InsertCellInRow(Row row, Cell cell, uint colIndex)
     {
         string newRef = NumberToColumnLetter(colIndex) + (row.RowIndex?.Value ?? 1).ToString();
         cell.CellReference = newRef;
@@ -430,7 +552,7 @@ internal sealed class ExcelColumn : IColumn
             row.Append(cell);
     }
 
-    private Column? GetColumnElementForIndex(uint col)
+    Column? GetColumnElementForIndex(uint col)
     {
         var cols = _sheet.Worksheet.GetFirstChild<Columns>();
         if (cols == null) return null;
@@ -445,7 +567,7 @@ internal sealed class ExcelColumn : IColumn
         return null;
     }
 
-    private Column GetOrCreateColumnElementForIndex(uint col)
+    Column GetOrCreateColumnElementForIndex(uint col)
     {
         var existing = GetColumnElementForIndex(col);
         if (existing != null) return existing;
@@ -468,12 +590,12 @@ internal sealed class ExcelColumn : IColumn
         return newCol;
     }
 
-    private int GetOrCreateNumberFormatId(NumberFormatPattern format)
+    int GetOrCreateNumberFormatId(NumberFormatPattern format)
     {
         return _writer.GetOrCreateCellFormatId(numberFormat: format);
     }
 
-    private static bool TryParseCellReference(string reference, out uint row, out uint col)
+    static bool TryParseCellReference(string reference, out uint row, out uint col)
     {
         row = 0; col = 0;
         if (string.IsNullOrEmpty(reference)) return false;
@@ -487,7 +609,7 @@ internal sealed class ExcelColumn : IColumn
         return true;
     }
 
-    private static string NumberToColumnLetter(uint col)
+    static string NumberToColumnLetter(uint col)
     {
         if (col == 0) throw new ArgumentException("Column number must be > 0");
         string result = "";

QWERTYkez.ExcelProcessor/Editors/ExcelRange.cs

@@ -5,10 +5,10 @@
 /// </summary>
 internal sealed class ExcelRange : IRange
 {
-    private readonly ExcelWriter _writer;
+    internal readonly ExcelWriter _writer;
-    private readonly ExcelSheet _sheet;
+    internal readonly ExcelSheet _sheet;
-    private uint _rowStart, _rowEnd;
+    internal uint _rowStart, _rowEnd;
-    private uint _colStart, _colEnd;
+    internal uint _colStart, _colEnd;
 
     internal ExcelRange(ExcelWriter writer, ExcelSheet sheet, uint rowStart, uint colStart, uint rowEnd, uint colEnd)
     {
@@ -55,6 +55,79 @@ internal sealed class ExcelRange : IRange
 
 
 
+    void ForEachCell(Action<ICell> action)
+	{
+		for (uint r = _rowStart; r <= _rowEnd; r++)
+			for (uint c = _colStart; c <= _colEnd; c++)
+			{
+				var cell = new ExcelCell(_writer, _sheet, r, c);
+				action(cell);
+			}
+	}
+
+	public IRange Set(NumberFormatPattern format)
+	{
+		if (format == null) return this;
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			ForEachCell(cell => cell.Set(format));
+			return this;
+		}
+	}
+
+	public IRange Set(CellAlign align)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			ForEachCell(cell => cell.Set(align));
+			return this;
+		}
+	}
+
+	public IRange Set(CellBorder border)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			ForEachCell(cell => cell.Set(border));
+			return this;
+		}
+	}
+
+	public IRange Set(CellFill fill)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			ForEachCell(cell => cell.Set(fill));
+			return this;
+		}
+	}
+
+	public IRange Set(CellFont font)
+	{
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			ForEachCell(cell => cell.Set(font));
+			return this;
+		}
+	}
+
+	public IRange Set(CellStyle style)
+	{
+		if (style == null) return this;
+		_writer.ThrowIfDisposed();
+		lock (_writer._syncLock)
+		{
+			ForEachCell(cell => cell.Set(style));
+			return this;
+		}
+	}
+
+
 
 
 
@@ -115,7 +188,7 @@ internal sealed class ExcelRange : IRange
         return MoveTo(rowIndex, CellAddressHelper.ColumnLetterToIndex(colIndex));
     }
 
-    private enum CopyOrder
+    enum CopyOrder
     {
         Any,
         LeftToRight,
@@ -125,7 +198,7 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Копирует ячейки из исходного диапазона в целевой, поддерживая различные порядки обхода.</summary>
-    private void CopyCells(uint srcRowStart, uint srcColStart, uint srcRowEnd, uint srcColEnd,
+    void CopyCells(uint srcRowStart, uint srcColStart, uint srcRowEnd, uint srcColEnd,
                            uint dstRowStart, uint dstColStart, CopyOrder order)
     {
         // Определяем все строки, которые могут понадобиться (исходные и целевые)
@@ -172,7 +245,7 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Строит словарь строк для указанных индексов строк.</summary>
-    private Dictionary<uint, Row> GetRowDictionary(HashSet<uint> rowIndices)
+    Dictionary<uint, Row> GetRowDictionary(HashSet<uint> rowIndices)
     {
         var dict = new Dictionary<uint, Row>();
         var sheetData = _sheet.GetSheetData();
@@ -185,7 +258,7 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Быстрый поиск ячейки в строке (линейный, подходит для типичного количества ячеек в строке).</summary>
-    private Cell? FindCellInRowFast(Row row, uint colIndex)
+    Cell? FindCellInRowFast(Row row, uint colIndex)
     {
         foreach (var cell in row.Elements<Cell>())
         {
@@ -196,14 +269,14 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Проверяет, пересекаются ли два прямоугольных диапазона.</summary>
-    private static bool RangesOverlap(uint r1s, uint c1s, uint r1e, uint c1e,
+    static bool RangesOverlap(uint r1s, uint c1s, uint r1e, uint c1e,
                                        uint r2s, uint c2s, uint r2e, uint c2e)
     {
         return !(r1e < r2s || r2e < r1s || c1e < c2s || c2e < c1s);
     }
 
     /// <summary>Вставляет ячейку в указанную позицию, предварительно удаляя существующую.</summary>
-    private void InsertCellAt(uint row, uint col, Cell cell)
+    void InsertCellAt(uint row, uint col, Cell cell)
     {
         DeleteCellAt(row, col);
         var sheetData = _sheet.GetSheetData();
@@ -212,7 +285,7 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Удаляет ячейку, если она существует.</summary>
-    private void DeleteCellAt(uint row, uint col)
+    void DeleteCellAt(uint row, uint col)
     {
         var sheetData = _sheet.GetSheetData();
         var rowElement = FindRowElement(sheetData, row);
@@ -222,7 +295,7 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Получает или создаёт строку с указанным индексом.</summary>
-    private Row GetOrCreateRowElement(SheetData sheetData, uint rowIndex)
+    Row GetOrCreateRowElement(SheetData sheetData, uint rowIndex)
     {
         var existing = FindRowElement(sheetData, rowIndex);
         if (existing != null) return existing;
@@ -232,7 +305,7 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Вставляет ячейку в строку с сохранением порядка столбцов.</summary>
-    private void InsertCellInRow(Row row, Cell cell, uint colIndex)
+    void InsertCellInRow(Row row, Cell cell, uint colIndex)
     {
         string newRef = $"{CellAddressHelper.ColumnIndexToLetter(colIndex)}{row.RowIndex?.Value ?? 1}";
         cell.CellReference = newRef;
@@ -251,7 +324,7 @@ internal sealed class ExcelRange : IRange
     }
 
     /// <summary>Очищает данные (содержимое) в указанном диапазоне.</summary>
-    private void ClearRangeData(uint rowStart, uint colStart, uint rowEnd, uint colEnd)
+    void ClearRangeData(uint rowStart, uint colStart, uint rowEnd, uint colEnd)
     {
         for (uint r = rowStart; r <= rowEnd; r++)
         {
@@ -334,103 +407,12 @@ internal sealed class ExcelRange : IRange
         return merged.Equals(range);
     }
 
-    public IRange SetNumberFormat(NumberFormatPattern format)
-    {
-        if (format == null) return this;
-        _writer.ThrowIfDisposed();
-        lock (_writer._syncLock)
-        {
-            int fmtId = GetOrCreateNumberFormatId(format);
-            for (uint r = _rowStart; r <= _rowEnd; r++)
-            {
-                for (uint c = _colStart; c <= _colEnd; c++)
-                {
-                    var cell = GetCellInternal(r, c);
-                    cell?.StyleIndex = (uint)fmtId;
-                }
-            }
-        }
-        return this;
-    }
-
-    /// <inheritdoc />
-    public IRange SetCellAlign(CellAlign align)
-    {
-        _writer.ThrowIfDisposed();
-        lock (_writer._syncLock)
-        {
-            int styleIndex = _writer.GetOrCreateCellFormatId(
-                numberFormat: null,
-                font: null,
-                fill: null,
-                border: null,
-                align: align
-            );
-            ApplyStyleToRange((uint)styleIndex);
-            return this;
-        }
-    }
-
-    /// <inheritdoc />
-    public IRange SetCellBorder(CellBorder border)
-    {
-        _writer.ThrowIfDisposed();
-        lock (_writer._syncLock)
-        {
-            int styleIndex = _writer.GetOrCreateCellFormatId(
-                numberFormat: null,
-                font: null,
-                fill: null,
-                border: border,
-                align: null
-            );
-            ApplyStyleToRange((uint)styleIndex);
-            return this;
-        }
-    }
-
-    /// <inheritdoc />
-    public IRange SetCellFill(CellFill fill)
-    {
-        _writer.ThrowIfDisposed();
-        lock (_writer._syncLock)
-        {
-            int styleIndex = _writer.GetOrCreateCellFormatId(
-                numberFormat: null,
-                font: null,
-                fill: fill,
-                border: null,
-                align: null
-            );
-            ApplyStyleToRange((uint)styleIndex);
-            return this;
-        }
-    }
-
-    /// <inheritdoc />
-    public IRange SetCellFont(CellFont font)
-    {
-        _writer.ThrowIfDisposed();
-        lock (_writer._syncLock)
-        {
-            int styleIndex = _writer.GetOrCreateCellFormatId(
-                numberFormat: null,
-                font: font,
-                fill: null,
-                border: null,
-                align: null
-            );
-            ApplyStyleToRange((uint)styleIndex);
-            return this;
-        }
-    }
-
     /// <summary>
     /// Применяет стиль ко всем ячейкам диапазона.
     /// </summary>
     /// <param name="styleIndex">Индекс стиля для применения.</param>
     /// <param name="createIfMissing">Если true, создаёт недостающие ячейки (по умолчанию true).</param>
-    private void ApplyStyleToRange(uint styleIndex, bool createIfMissing = true)
+    void ApplyStyleToRange(uint styleIndex, bool createIfMissing = true)
     {
         for (uint row = _rowStart; row <= _rowEnd; row++)
         {
@@ -517,7 +499,7 @@ internal sealed class ExcelRange : IRange
     {
         if (GetSubCell(row, col, out var cell))
         {
-            cell.Set(formula, format);
+            cell.SetFormula(formula, format);
             return true;
         }
         return false;
@@ -619,7 +601,7 @@ internal sealed class ExcelRange : IRange
     {
         if (GetSubCell(row, col, out var cell))
         {
-            cell.Set(formula, format);
+            cell.SetFormula(formula, format);
             return true;
         }
         return false;
@@ -727,7 +709,7 @@ internal sealed class ExcelRange : IRange
 
     // Вспомогательные методы
 
-    private Cell? GetCellInternal(uint row, uint col)
+    Cell? GetCellInternal(uint row, uint col)
     {
         var sheetData = _sheet.GetSheetData();
         var rowElement = FindRowElement(sheetData, row);
@@ -735,7 +717,7 @@ internal sealed class ExcelRange : IRange
         return FindCellInRow(rowElement, col);
     }
 
-    private void CopyData(uint srcRowStart, uint srcColStart, uint srcRowEnd, uint srcColEnd, uint dstRowStart, uint dstColStart)
+    void CopyData(uint srcRowStart, uint srcColStart, uint srcRowEnd, uint srcColEnd, uint dstRowStart, uint dstColStart)
     {
         // Сохраняем все значения и форматы из исходного диапазона
         var cellsData = new List<(uint row, uint col, Cell cell)>();
@@ -784,7 +766,7 @@ internal sealed class ExcelRange : IRange
         }
     }
 
-    private Row GetOrCreateRowElement(uint rowIndex)
+    Row GetOrCreateRowElement(uint rowIndex)
     {
         var existing = FindRowElement(_sheet.GetSheetData(), rowIndex);
         if (existing != null) return existing;
@@ -793,14 +775,14 @@ internal sealed class ExcelRange : IRange
         return newRow;
     }
 
-    private static Row? FindRowElement(SheetData sheetData, uint rowIndex)
+    static Row? FindRowElement(SheetData sheetData, uint rowIndex)
     {
         foreach (var row in sheetData.Elements<Row>())
             if (row.RowIndex?.Value == rowIndex) return row;
         return null;
     }
 
-    private static void InsertRowElement(SheetData sheetData, Row row, uint rowIndex)
+    static void InsertRowElement(SheetData sheetData, Row row, uint rowIndex)
     {
         bool inserted = false;
         foreach (var existing in sheetData.Elements<Row>().ToList())
@@ -815,7 +797,7 @@ internal sealed class ExcelRange : IRange
         if (!inserted) sheetData.Append(row);
     }
 
-    private Cell? FindCellInRow(Row row, uint colIndex)
+    Cell? FindCellInRow(Row row, uint colIndex)
     {
         foreach (var cell in row.Elements<Cell>())
         {
@@ -825,7 +807,7 @@ internal sealed class ExcelRange : IRange
         return null;
     }
 
-    private Column? GetColumnElementForIndex(uint col)
+    Column? GetColumnElementForIndex(uint col)
     {
         var worksheet = _sheet.Worksheet;
         var cols = worksheet.GetFirstChild<Columns>();
@@ -839,7 +821,7 @@ internal sealed class ExcelRange : IRange
         return null;
     }
 
-    private Column GetOrCreateColumnElementForIndex(uint col)
+    Column GetOrCreateColumnElementForIndex(uint col)
     {
         var existing = GetColumnElementForIndex(col);
         if (existing != null) return existing;
@@ -861,10 +843,10 @@ internal sealed class ExcelRange : IRange
         return newCol;
     }
 
-    private MergeCells? GetMergeCells() =>
+    MergeCells? GetMergeCells() =>
         _sheet.Worksheet.GetFirstChild<MergeCells>();
 
-    private bool TryParseRangeReference(string reference, out ExcelRange range)
+    bool TryParseRangeReference(string reference, out ExcelRange range)
     {
         range = null!;
         if (string.IsNullOrEmpty(reference)) return false;
@@ -877,10 +859,4 @@ internal sealed class ExcelRange : IRange
         range = new ExcelRange(_writer, _sheet, rowStart, colStart, rowEnd, colEnd);
         return true;
     }
-
-    // создаёт стиль только с числовым форматом
-    private int GetOrCreateNumberFormatId(NumberFormatPattern format)
-    {
-        return _writer.GetOrCreateCellFormatId(numberFormat: format);
-    }
 }

QWERTYkez.ExcelProcessor/Editors/ExcelRow.cs

@@ -5,9 +5,9 @@
 /// </summary>
 internal sealed class ExcelRow : IRow
 {
-    private readonly ExcelWriter _writer;
+    readonly ExcelWriter _writer;
-    private readonly ExcelSheet _sheet;
+    readonly ExcelSheet _sheet;
-    private uint _rowIndex;
+    uint _rowIndex;
 
     internal ExcelRow(ExcelWriter writer, ExcelSheet sheet, uint rowIndex)
     {
@@ -47,7 +47,7 @@ internal sealed class ExcelRow : IRow
     }
 
     // Вспомогательные методы
-    private static Row? GetRowElementInternal(ExcelSheet sheet, uint rowIndex)
+    static Row? GetRowElementInternal(ExcelSheet sheet, uint rowIndex)
     {
         var sheetData = sheet.GetSheetData();
         foreach (var row in sheetData.Elements<Row>())
@@ -55,7 +55,7 @@ internal sealed class ExcelRow : IRow
         return null;
     }
 
-    private static Row GetOrCreateRowElementInternal(ExcelSheet sheet, uint rowIndex)
+    static Row GetOrCreateRowElementInternal(ExcelSheet sheet, uint rowIndex)
     {
         var existing = GetRowElementInternal(sheet, rowIndex);
         if (existing != null) return existing;
@@ -66,7 +66,7 @@ internal sealed class ExcelRow : IRow
         return newRow;
     }
 
-    private static void InsertRowElementInternal(SheetData sheetData, Row row, uint rowIndex)
+    static void InsertRowElementInternal(SheetData sheetData, Row row, uint rowIndex)
     {
         bool inserted = false;
         foreach (var existing in sheetData.Elements<Row>().ToList())
@@ -136,24 +136,156 @@ internal sealed class ExcelRow : IRow
             }
         }
     }
+    private void ApplyStyleToRowCells(CellStyle style)
+    {
+        var sheetData = _sheet.GetSheetData();
+        var rowElement = FindRowElement(sheetData, _rowIndex);
+        if (rowElement == null) return;
+
+        // Применяем стиль ко всем существующим ячейкам
+        foreach (var cellElement in rowElement.Elements<Cell>())
+        {
+            var colIndex = GetColumnIndex(cellElement.CellReference?.Value);
+            if (colIndex > 0)
+            {
+                var cell = new ExcelCell(_writer, _sheet, _rowIndex, colIndex);
+                // Применяем стиль через Set, чтобы объединить с существующим
+                cell.Set(style);
+            }
+        }
+    }
+    static uint GetColumnIndex(string? cellReference)
+    {
+        if (string.IsNullOrEmpty(cellReference)) return 0;
+        int i = 0;
+        while (i < cellReference!.Length && char.IsLetter(cellReference[i])) i++;
+        if (i == 0) return 0;
+        string colPart = cellReference.Substring(0, i);
+        return CellAddressHelper.ColumnLetterToIndex(colPart);
+    }
+
+    CellStyle? GetRowStyle(Row rowElement)
+    {
+        if (rowElement.StyleIndex?.Value is not uint styleIndex)
+            return null;
+        return _writer.GetCellStyle(styleIndex);
+    }
+
 
     /// <inheritdoc />
-    public IRow SetNumberFormat(NumberFormatPattern format)
+    public IRow Set(NumberFormatPattern format)
     {
         if (format == null) return this;
         _writer.ThrowIfDisposed();
         lock (_writer._syncLock)
         {
-            // Находим все ячейки в этой строке и устанавливаем формат
+            var rowElement = GetOrCreateRowElement();
-            var sheetData = _sheet.GetSheetData();
+            var currentStyle = GetRowStyle(rowElement) ?? new CellStyle();
-            var rowElement = FindRowElement(sheetData, _rowIndex);
+            if (currentStyle.TryMerge(format, out var newStyle))
-            if (rowElement == null) return this;
+            {
-            int formatIndex = GetOrCreateNumberFormatId(format);
+                ApplyStyleToRow(newStyle);
-            foreach (var cell in rowElement.Elements<Cell>())
+                ApplyStyleToRowCells(newStyle);
-                cell.StyleIndex = (uint)formatIndex;
             }
             return this;
         }
+    }
+
+    /// <inheritdoc />
+    public IRow Set(CellAlign align)
+    {
+        _writer.ThrowIfDisposed();
+        lock (_writer._syncLock)
+        {
+            var rowElement = GetOrCreateRowElement();
+            var currentStyle = GetRowStyle(rowElement) ?? new CellStyle();
+            if (currentStyle.TryMerge(align, out var newStyle))
+            {
+                ApplyStyleToRow(newStyle);
+                ApplyStyleToRowCells(newStyle);
+            }
+            return this;
+        }
+    }
+
+    /// <inheritdoc />
+    public IRow Set(CellBorder border)
+    {
+        _writer.ThrowIfDisposed();
+        lock (_writer._syncLock)
+        {
+            var rowElement = GetOrCreateRowElement();
+            var currentStyle = GetRowStyle(rowElement) ?? new CellStyle();
+            if (currentStyle.TryMerge(border, out var newStyle))
+            {
+                ApplyStyleToRow(newStyle);
+                ApplyStyleToRowCells(newStyle);
+            }
+            return this;
+        }
+    }
+
+    /// <inheritdoc />
+    public IRow Set(CellFill fill)
+    {
+        _writer.ThrowIfDisposed();
+        lock (_writer._syncLock)
+        {
+            var rowElement = GetOrCreateRowElement();
+            var currentStyle = GetRowStyle(rowElement) ?? new CellStyle();
+            if (currentStyle.TryMerge(fill, out var newStyle))
+            {
+                ApplyStyleToRow(newStyle);
+                ApplyStyleToRowCells(newStyle);
+            }
+            return this;
+        }
+    }
+
+    /// <inheritdoc />
+    public IRow Set(CellFont font)
+    {
+        _writer.ThrowIfDisposed();
+        lock (_writer._syncLock)
+        {
+            var rowElement = GetOrCreateRowElement();
+            var currentStyle = GetRowStyle(rowElement) ?? new CellStyle();
+            if (currentStyle.TryMerge(font, out var newStyle))
+            {
+                ApplyStyleToRow(newStyle);
+                ApplyStyleToRowCells(newStyle);
+            }
+            return this;
+        }
+    }
+
+    /// <inheritdoc />
+    public IRow Set(CellStyle style)
+    {
+        if (style == null) return this;
+        _writer.ThrowIfDisposed();
+        lock (_writer._syncLock)
+        {
+            var rowElement = GetOrCreateRowElement();
+            var currentStyle = GetRowStyle(rowElement) ?? new CellStyle();
+            if (currentStyle.TryMerge(style, out var newStyle))
+            {
+                ApplyStyleToRow(newStyle);
+                ApplyStyleToRowCells(newStyle);
+            }
+            return this;
+        }
+    }
+
+
+    void ApplyStyleToRow(CellStyle style)
+    {
+        var rowElement = GetOrCreateRowElement();
+        int styleIndex = _writer.GetOrCreateStyleId(style);
+        rowElement.StyleIndex = (uint)styleIndex;
+        rowElement.CustomFormat = true;
+    }
+
+
 
     /// <inheritdoc />
     public ICell Cell(uint col) => new ExcelCell(_writer, _sheet, _rowIndex, col);
@@ -176,7 +308,7 @@ internal sealed class ExcelRow : IRow
 
     public IRow Cell(uint col, string value, NumberFormatPattern? format = null)
     {
-        Cell(col).Set(value, format); return this;
+        Cell(col).SetFormula(value, format); return this;
     }
 
     public IRow Cell(uint col, DateTime value, NumberFormatPattern? format = null)
@@ -226,7 +358,7 @@ internal sealed class ExcelRow : IRow
 
     public IRow Cell(string col, string value, NumberFormatPattern? format = null)
     {
-        Cell(col).Set(value, format); return this;
+        Cell(col).SetFormula(value, format); return this;
     }
 
     public IRow Cell(string col, DateTime value, NumberFormatPattern? format = null)
@@ -347,7 +479,7 @@ internal sealed class ExcelRow : IRow
 
     // Вспомогательные методы
 
-    private Row GetOrCreateRowElement()
+    Row GetOrCreateRowElement()
     {
         var sheetData = _sheet.GetSheetData();
         var existing = FindRowElement(sheetData, _rowIndex);
@@ -357,7 +489,7 @@ internal sealed class ExcelRow : IRow
         return newRow;
     }
 
-    private static Row? FindRowElement(SheetData sheetData, uint rowIndex)
+    static Row? FindRowElement(SheetData sheetData, uint rowIndex)
     {
         // Поиск по атрибуту RowIndex. В Open XML строки могут идти не по порядку.
         foreach (var row in sheetData.Elements<Row>())
@@ -368,7 +500,7 @@ internal sealed class ExcelRow : IRow
         return null;
     }
 
-    private static void InsertRowElement(SheetData sheetData, Row row, uint rowIndex)
+    static void InsertRowElement(SheetData sheetData, Row row, uint rowIndex)
     {
         // Вставка с сохранением сортировки по RowIndex
         bool inserted = false;
@@ -385,7 +517,7 @@ internal sealed class ExcelRow : IRow
             sheetData.Append(row);
     }
 
-    private int GetOrCreateNumberFormatId(NumberFormatPattern format)
+    int GetOrCreateNumberFormatId(NumberFormatPattern format)
     {
         // Создаём стиль, содержащий только числовой формат, и возвращаем его индекс
         return _writer.GetOrCreateCellFormatId(numberFormat: format);

QWERTYkez.ExcelProcessor/Editors/ExcelRun.cs

@@ -6,8 +6,8 @@
 /// </summary>
 internal sealed class ExcelRun : IRun
 {
-    private string _text = string.Empty;
+    string _text = string.Empty;
-    private RunFormat? _format;
+    RunFormat? _format;
 
     /// <inheritdoc />
     public string Text

QWERTYkez.ExcelProcessor/Editors/ExcelSheet.cs

@@ -33,7 +33,7 @@ internal sealed class ExcelSheet : ISheet
     {
         if (string.IsNullOrEmpty(name)) return false;
         Book.ThrowIfDisposed();
-        SheetElement.Name = name;
+        SheetElement.Name = name.EscapeSymbols();
         return true;
     }
 
@@ -77,7 +77,7 @@ internal sealed class ExcelSheet : ISheet
 
     public ISheet Cell(uint row, uint col, string formula, NumberFormatPattern? format = null)
     {
-        Cell(row, col).Set(formula, format); return this;
+        Cell(row, col).SetFormula(formula, format); return this;
     }
 
     public ISheet Cell(uint row, uint col, DateTime value, NumberFormatPattern? format = null)
@@ -129,7 +129,7 @@ internal sealed class ExcelSheet : ISheet
 
     public ISheet Cell(uint row, string col, string formula, NumberFormatPattern? format = null)
     {
-        Cell(row, col).Set(formula, format); return this;
+        Cell(row, col).SetFormula(formula, format); return this;
     }
 
     public ISheet Cell(uint row, string col, DateTime value, NumberFormatPattern? format = null)
@@ -212,20 +212,63 @@ internal sealed class ExcelSheet : ISheet
     /// <inheritdoc />
     public IRange RangeByIndexes(uint startRow, uint startCol, uint endRow, uint endCol)
     {
-        return new ExcelRange(Book, this, startRow, startCol, endRow, endCol);
+        if (startRow == 0) throw new ArgumentException("startRow must be >= 1", nameof(startRow));
+        if (startCol == 0) throw new ArgumentException("startCol must be >= 1", nameof(startCol));
+        if (endRow == 0) throw new ArgumentException("endRow must be >= 1", nameof(endRow));
+        if (endCol == 0) throw new ArgumentException("endCol must be >= 1", nameof(endCol));
+
+        // Приводим к корректному порядку (пользователь мог передать start > end)
+        uint rowStart = Math.Min(startRow, endRow);
+        uint rowEnd = Math.Max(startRow, endRow);
+        uint colStart = Math.Min(startCol, endCol);
+        uint colEnd = Math.Max(startCol, endCol);
+
+        return new ExcelRange(Book, this, rowStart, colStart, rowEnd, colEnd);
     }
 
     /// <inheritdoc />
     public IRange RangeByIndexes(uint startRow, string startCol, uint endRow, string endCol)
     {
+        if (string.IsNullOrEmpty(startCol)) throw new ArgumentException("startCol cannot be null or empty", nameof(startCol));
+        if (string.IsNullOrEmpty(endCol)) throw new ArgumentException("endCol cannot be null or empty", nameof(endCol));
+
         uint startColIdx = CellAddressHelper.ColumnLetterToIndex(startCol);
         uint endColIdx = CellAddressHelper.ColumnLetterToIndex(endCol);
-        return new ExcelRange(Book, this, startRow, startColIdx, endRow, endColIdx);
+        if (startColIdx == 0) throw new ArgumentException($"Invalid column letter: '{startCol}'", nameof(startCol));
+        if (endColIdx == 0) throw new ArgumentException($"Invalid column letter: '{endCol}'", nameof(endCol));
+
+        return RangeByIndexes(startRow, startColIdx, endRow, endColIdx);
+    }
+
+    /// <inheritdoc />
+    public IRange RangeByLength(uint startRow, uint startCol, uint rows, uint cols)
+    {
+        if (startRow == 0) throw new ArgumentException("startRow must be >= 1", nameof(startRow));
+        if (startCol == 0) throw new ArgumentException("startCol must be >= 1", nameof(startCol));
+        if (rows == 0) throw new ArgumentException("rows must be > 0", nameof(rows));
+        if (cols == 0) throw new ArgumentException("cols must be > 0", nameof(cols));
+
+        checked
+        {
+            uint endRow = startRow + rows - 1;
+            uint endCol = startCol + cols - 1;
+            return new ExcelRange(Book, this, startRow, startCol, endRow, endCol);
+        }
+    }
+
+    /// <inheritdoc />
+    public IRange RangeByLength(uint startRow, string startCol, uint rows, uint cols)
+    {
+        if (string.IsNullOrEmpty(startCol)) throw new ArgumentException("startCol cannot be null or empty", nameof(startCol));
+        uint startColIdx = CellAddressHelper.ColumnLetterToIndex(startCol);
+        if (startColIdx == 0) throw new ArgumentException($"Invalid column letter: '{startCol}'", nameof(startCol));
+        return RangeByLength(startRow, startColIdx, rows, cols);
     }
 
     /// <inheritdoc />
     public ISheet RangeByIndexes(uint startRow, uint startCol, uint endRow, uint endCol, Action<IRange> edit)
     {
+        if (edit is null) throw new ArgumentNullException(nameof(edit));
         var range = RangeByIndexes(startRow, startCol, endRow, endCol);
         edit(range);
         return this;
@@ -234,31 +277,16 @@ internal sealed class ExcelSheet : ISheet
     /// <inheritdoc />
     public ISheet RangeByIndexes(uint startRow, string startCol, uint endRow, string endCol, Action<IRange> edit)
     {
+        if (edit is null) throw new ArgumentNullException(nameof(edit));
         var range = RangeByIndexes(startRow, startCol, endRow, endCol);
         edit(range);
         return this;
     }
 
-    /// <inheritdoc />
-    public IRange RangeByLength(uint startRow, uint startCol, uint rows, uint cols)
-    {
-        if (rows == 0 || cols == 0)
-            throw new ArgumentException("Rows and columns must be greater than 0");
-        uint endRow = startRow + rows - 1;
-        uint endCol = startCol + cols - 1;
-        return new ExcelRange(Book, this, startRow, startCol, endRow, endCol);
-    }
-
-    /// <inheritdoc />
-    public IRange RangeByLength(uint startRow, string startCol, uint rows, uint cols)
-    {
-        uint startColIdx = CellAddressHelper.ColumnLetterToIndex(startCol);
-        return RangeByLength(startRow, startColIdx, rows, cols);
-    }
-
     /// <inheritdoc />
     public ISheet RangeByLength(uint startRow, uint startCol, uint rows, uint cols, Action<IRange> edit)
     {
+        if (edit is null) throw new ArgumentNullException(nameof(edit));
         var range = RangeByLength(startRow, startCol, rows, cols);
         edit(range);
         return this;
@@ -267,6 +295,7 @@ internal sealed class ExcelSheet : ISheet
     /// <inheritdoc />
     public ISheet RangeByLength(uint startRow, string startCol, uint rows, uint cols, Action<IRange> edit)
     {
+        if (edit is null) throw new ArgumentNullException(nameof(edit));
         var range = RangeByLength(startRow, startCol, rows, cols);
         edit(range);
         return this;
@@ -274,4 +303,27 @@ internal sealed class ExcelSheet : ISheet
 
     #endregion
 
+
+
+
+    #region Merge Operations
+
+    /// <inheritdoc />
+    public bool TryMergeByIndexes(uint startRow, uint startCol, uint endRow, uint endCol) =>
+        RangeByIndexes(startRow, startCol, endRow, endCol).TryMerge();
+
+    /// <inheritdoc />
+    public bool TryMergeByIndexes(uint startRow, string startCol, uint endRow, string endCol) =>
+        RangeByIndexes(startRow, startCol, endRow, endCol).TryMerge();
+
+    /// <inheritdoc />
+    public bool TryMergeByLength(uint startRow, uint startCol, uint rows, uint cols) =>
+        RangeByLength(startRow, startCol, rows, cols).TryMerge();
+
+    /// <inheritdoc />
+    public bool TryMergeByLength(uint startRow, string startCol, uint rows, uint cols) =>
+        RangeByLength(startRow, startCol, rows, cols).TryMerge();
+
+    #endregion
+
 }

QWERTYkez.ExcelProcessor/Editors/Interfaces.cs

@@ -99,6 +99,18 @@ public interface ISheet
     /// <summary>Редактирует диапазон, заданный начальной ячейкой и размером (буква столбца).</summary>
     ISheet RangeByLength(uint startRow, string startCol, uint rows, uint cols, Action<IRange> edit);
 
+    /// <summary>Возвращает диапазон ячеек по начальным и конечным индексам строк и столбцов.</summary>
+    bool TryMergeByIndexes(uint startRow, uint startCol, uint endRow, uint endCol);
+
+    /// <summary>Возвращает диапазон ячеек по начальным и конечным координатам с буквенным обозначением столбцов.</summary>
+    bool TryMergeByIndexes(uint startRow, string startCol, uint endRow, string endCol);
+
+    /// <summary>Возвращает диапазон, начиная с указанной ячейки, заданной размером (строки x столбцы).</summary>
+    bool TryMergeByLength(uint startRow, uint startCol, uint rows, uint cols);
+
+    /// <summary>Возвращает диапазон по начальной ячейке и размеру с буквенным обозначением столбца.</summary>
+    bool TryMergeByLength(uint startRow, string startCol, uint rows, uint cols);
+
     /// <summary>Возвращает ячейку по номеру строки и столбца (оба начиная с 1).</summary>
     ICell Cell(uint row, uint col);
 
@@ -207,7 +219,22 @@ public interface IRow
     RowHeight Height { get; set; }
 
     /// <summary>Устанавливает числовой формат для всех ячеек строки.</summary>
-    IRow SetNumberFormat(NumberFormatPattern format);
+    IRow Set(NumberFormatPattern format);
+
+    /// <summary>Устанавливает выравнивание для всех ячеек диапазона.</summary>
+    IRow Set(CellAlign format);
+
+    /// <summary>Устанавливает границы для всех ячеек диапазона.</summary>
+    IRow Set(CellBorder format);
+
+    /// <summary>Устанавливает заливку для всех ячеек диапазона.</summary>
+    IRow Set(CellFill format);
+
+    /// <summary>Устанавливает шрифт для всех ячеек диапазона.</summary>
+    IRow Set(CellFont format);
+
+    /// <summary>Устанавливает шрифт ячейки.</summary>
+    IRow Set(CellStyle font);
 
     /// <summary>Возвращает ячейку в заданном столбце (индекс с 1).</summary>
     ICell Cell(uint col);
@@ -334,7 +361,22 @@ public interface IColumn
     ColumnWidth Width { get; set; }
 
     /// <summary>Устанавливает числовой формат для всех ячеек столбца.</summary>
-    IColumn SetNumberFormat(NumberFormatPattern format);
+    IColumn Set(NumberFormatPattern format);
+
+    /// <summary>Устанавливает выравнивание для всех ячеек диапазона.</summary>
+    IColumn Set(CellAlign format);
+
+    /// <summary>Устанавливает границы для всех ячеек диапазона.</summary>
+    IColumn Set(CellBorder format);
+
+    /// <summary>Устанавливает заливку для всех ячеек диапазона.</summary>
+    IColumn Set(CellFill format);
+
+    /// <summary>Устанавливает шрифт для всех ячеек диапазона.</summary>
+    IColumn Set(CellFont format);
+
+    /// <summary>Устанавливает шрифт ячейки.</summary>
+    IColumn Set(CellStyle font);
 
     /// <summary>Возвращает ячейку в заданной строке (индекс с 1).</summary>
     ICell Cell(uint row);
@@ -464,19 +506,22 @@ public interface IRange
     IRange MoveTo(uint rowIndex, string colIndex);
 
     /// <summary>Устанавливает числовой формат для всех ячеек диапазона.</summary>
-    IRange SetNumberFormat(NumberFormatPattern format);
+    IRange Set(NumberFormatPattern format);
 
     /// <summary>Устанавливает выравнивание для всех ячеек диапазона.</summary>
-    IRange SetCellAlign(CellAlign format);
+    IRange Set(CellAlign format);
 
     /// <summary>Устанавливает границы для всех ячеек диапазона.</summary>
-    IRange SetCellBorder(CellBorder format);
+    IRange Set(CellBorder format);
 
     /// <summary>Устанавливает заливку для всех ячеек диапазона.</summary>
-    IRange SetCellFill(CellFill format);
+    IRange Set(CellFill format);
 
     /// <summary>Устанавливает шрифт для всех ячеек диапазона.</summary>
-    IRange SetCellFont(CellFont format);
+    IRange Set(CellFont format);
+
+    /// <summary>Устанавливает шрифт ячейки.</summary>
+    IRange Set(CellStyle font);
 
     /// <summary>Перечисляет все ячейки диапазона (по строкам).</summary>
     IEnumerable<ICell> Cells { get; }
@@ -560,6 +605,69 @@ public interface IRange
 /// <summary>Представляет одну ячейку на листе.</summary>
 public interface ICell
 {
+    /// <summary>Количество фрагментов (Run) в тексте.</summary>
+    int RunsCount { get; }
+
+    /// <summary>Возвращает все фрагменты.</summary>
+    IEnumerable<IRun> GetRuns();
+
+    /// <summary>Возвращает фрагмент по индексу или null.</summary>
+    IRun? GetRunAt(int index);
+
+    /// <summary>Пытается получить фрагмент по индексу.</summary>
+    bool TryGetRunAt(int index, out IRun run);
+
+    /// <summary>Первый фрагмент или null.</summary>
+    IRun? First();
+
+    /// <summary>Пытается получить первый фрагмент.</summary>
+    bool TryGetFirst(out IRun run);
+
+    /// <summary>Последний фрагмент или null.</summary>
+    IRun? Last();
+
+    /// <summary>Пытается получить последний фрагмент.</summary>
+    bool TryGetLast(out IRun run);
+
+    /// <summary>Пытается удалить фрагмент.</summary>
+    bool TryRemoveRun(IRun run);
+
+    /// <summary>Удаляет фрагмент по индексу.</summary>
+    bool TryRemoveRun(int index);
+
+    /// <summary>Удаляет фрагмент по индексу и возвращает удалённый.</summary>
+    bool TryRemoveRun(int index, out IRun? removed);
+
+    /// <summary>Добавляет разрыв строки (перенос внутри ячейки).</summary>
+    ICell Break();
+
+    /// <summary>Добавляет обычный текстовый фрагмент.</summary>
+    ICell Run(string text, RunFormat? format = null);
+
+    /// <summary>Добавляет фрагмент с последующим разрывом строки.</summary>
+    ICell RunBreak(string text, RunFormat? format = null);
+
+    /// <summary>Добавляет подстрочный фрагмент (эквивалентно AddRun с Vertical = Subscript).</summary>
+    ICell Sub(string text, RunFormat? format = null);
+
+    /// <summary>Добавляет надстрочный фрагмент.</summary>
+    ICell Sup(string text, RunFormat? format = null);
+
+    /// <summary>Вставляет фрагмент по индексу.</summary>
+    bool TryInsertRun(int index, string text, RunFormat? format = null);
+
+    /// <summary>Вставляет фрагмент с последующим разрывом строки по индексу.</summary>
+    bool TryInsertRunBreak(int index, string text, RunFormat? format = null);
+
+    /// <summary>Вставляет подстрочный фрагмент по индексу.</summary>
+    bool TryInsertSub(int index, string text, RunFormat? format = null);
+
+    /// <summary>Вставляет надстрочный фрагмент по индексу.</summary>
+    bool TryInsertSup(int index, string text, RunFormat? format = null);
+
+    /// <summary>Применяет заданный формат ко всем существующим фрагментам (поверх их текущего форматирования, заменяя неуказанные свойства).</summary>
+    void ApplyFormatToAllRuns(RunFormat format);
+
     /// <summary>Проверяет, входит ли ячейка в объединённый диапазон.</summary>
     bool IsMerged { get; }
 
@@ -658,6 +766,9 @@ public interface ICell
     /// <summary>Возвращает шрифт ячейки.</summary>
     CellFont GetCellFont();
 
+    /// <summary>Возвращает шрифт ячейки.</summary>
+    CellStyle? GetCellStyle();
+
     /// <summary>Пытается извлечь логическое значение.</summary>
     bool TryGetBoolean(out bool value);
 
@@ -679,34 +790,28 @@ public interface ICell
     /// <summary>Пытается установить формулу (без вычисленного значения).</summary>
     /// <param name="formula">Текст формулы (например, "SUM(A1:A5)").</param>
     /// <param name="format">Необязательный числовой формат для результата.</param>
-    bool TrySet(string formula, NumberFormatPattern? format = null);
+    bool TrySetFormula(string formula, NumberFormatPattern? format = null);
 
     /// <summary>Устанавливает формулу (выбрасывает исключение при ошибке).</summary>
-    ICell Set(string formula, NumberFormatPattern? format = null);
+    ICell SetFormula(string formula, NumberFormatPattern? format = null);
 
     /// <summary>Устанавливает числовой формат ячейки (не меняя значение).</summary>
     ICell Set(NumberFormatPattern format);
 
     /// <summary>Устанавливает выравнивание текста ячейки.</summary>
-    ICell Set(CellAlign format);
+    ICell Set(CellAlign align);
 
     /// <summary>Устанавливает границы ячейки.</summary>
-    ICell Set(CellBorder format);
+    ICell Set(CellBorder border);
 
     /// <summary>Устанавливает заливку ячейки.</summary>
-    ICell Set(CellFill format);
+    ICell Set(CellFill fill);
 
     /// <summary>Устанавливает шрифт ячейки.</summary>
-    ICell Set(CellFont format);
+    ICell Set(CellFont font);
 
-    /// <summary>Устанавливает богатый текст (форматированный) с помощью делегата.</summary>
+    /// <summary>Устанавливает стиль ячейки.</summary>
-    ICell Text(Action<ICellText> value);
+    ICell Set(CellStyle style);
-
-    /// <summary>Возвращает объект для редактирования богатого текста ячейки (если ячейка содержит InlineString).</summary>
-    bool TryText(out ICellText cellText);
-
-    /// <summary>Возвращает объект для редактирования богатого текста ячейки (если ячейка содержит InlineString).</summary>
-    ICellText? Text();
 
     /// <summary>Устанавливает простое текстовое значение (без форматирования).</summary>
     ICell Set(string value);
@@ -742,76 +847,6 @@ public interface ICell
     void Clear();
 }
 
-/// <summary>Представляет богатый текст внутри ячейки (несколько форматированных фрагментов).</summary>
-public interface ICellText
-{
-    /// <summary>Количество фрагментов (Run) в тексте.</summary>
-    int Count { get; }
-
-    /// <summary>Возвращает все фрагменты.</summary>
-    IEnumerable<IRun> GetRuns();
-
-    /// <summary>Возвращает фрагмент по индексу или null.</summary>
-    IRun? GetRunAt(int index);
-
-    /// <summary>Пытается получить фрагмент по индексу.</summary>
-    bool TryGetRunAt(int index, out IRun run);
-
-    /// <summary>Первый фрагмент или null.</summary>
-    IRun? First();
-
-    /// <summary>Пытается получить первый фрагмент.</summary>
-    bool TryGetFirst(out IRun run);
-
-    /// <summary>Последний фрагмент или null.</summary>
-    IRun? Last();
-
-    /// <summary>Пытается получить последний фрагмент.</summary>
-    bool TryGetLast(out IRun run);
-
-    /// <summary>Пытается удалить фрагмент.</summary>
-    bool TryRemoveRun(IRun run);
-
-    /// <summary>Удаляет фрагмент по индексу.</summary>
-    bool TryRemoveRun(int index);
-
-    /// <summary>Удаляет фрагмент по индексу и возвращает удалённый.</summary>
-    bool TryRemoveRun(int index, out IRun? removed);
-
-    /// <summary>Добавляет разрыв строки (перенос внутри ячейки).</summary>
-    ICellText Break();
-
-    /// <summary>Добавляет обычный текстовый фрагмент.</summary>
-    ICellText Run(string text, RunFormat? format = null);
-
-    /// <summary>Добавляет фрагмент с последующим разрывом строки.</summary>
-    ICellText RunBreak(string text, RunFormat? format = null);
-
-    /// <summary>Добавляет подстрочный фрагмент (эквивалентно AddRun с Vertical = Subscript).</summary>
-    ICellText Sub(string text, RunFormat? format = null);
-
-    /// <summary>Добавляет надстрочный фрагмент.</summary>
-    ICellText Sup(string text, RunFormat? format = null);
-
-    /// <summary>Вставляет фрагмент по индексу.</summary>
-    bool TryInsertRun(int index, string text, RunFormat? format = null);
-
-    /// <summary>Вставляет фрагмент с последующим разрывом строки по индексу.</summary>
-    bool TryInsertRunBreak(int index, string text, RunFormat? format = null);
-
-    /// <summary>Вставляет подстрочный фрагмент по индексу.</summary>
-    bool TryInsertSub(int index, string text, RunFormat? format = null);
-
-    /// <summary>Вставляет надстрочный фрагмент по индексу.</summary>
-    bool TryInsertSup(int index, string text, RunFormat? format = null);
-
-    /// <summary>Применяет заданный формат ко всем существующим фрагментам (поверх их текущего форматирования, заменяя неуказанные свойства).</summary>
-    void ApplyFormatToAllRuns(RunFormat format);
-
-    /// <summary>Удаляет все фрагменты, очищая текст ячейки.</summary>
-    void Clear();
-}
-
 /// <summary>Представляет один форматированный фрагмент текста внутри ячейки.</summary>
 public interface IRun
 {

QWERTYkez.ExcelProcessor/Editors/NumberFormatPattern.cs

@@ -3,7 +3,7 @@
 public class NumberFormatPattern
 {
     public string Format { get; }
-    internal int? Id { get; private set; }
+    internal int? Id { get; set; }
 
     public NumberFormatPattern(string format, ushort id = 0)
     {

QWERTYkez.ExcelProcessor/Editors/RangeBorderExtensions.cs

@@ -0,0 +1,149 @@
+namespace QWERTYkez.ExcelProcessor;
+
+/// <summary>
+/// Методы расширения для установки границ диапазона.
+/// </summary>
+public static class RangeBorderExtensions
+{
+    /// <summary>
+    /// Устанавливает границы для диапазона с указанным стилем и цветом.
+    /// </summary>
+    /// <param name="range">Диапазон ячеек.</param>
+    /// <param name="style">Стиль линии границы.</param>
+    /// <param name="color">Цвет границы (необязательно).</param>
+    /// <param name="target">Какие границы применять (по умолчанию Outside).</param>
+    /// <returns>Тот же диапазон для цепочки вызовов.</returns>
+    public static IRange Set(this IRange range, BorderStyle style, BorderTarget target = BorderTarget.Outside,
+        System.Drawing.Color? color = null) => range.Set(new() { Style = style, Color = color ?? System.Drawing.Color.Black }, target);
+
+    /// <summary>
+    /// Устанавливает границы для диапазона с указанными параметрами.
+    /// </summary>
+    /// <param name="range">Диапазон ячеек.</param>
+    /// <param name="borderSide">Стиль и цвет границы.</param>
+    /// <param name="target">Какие границы применять (по умолчанию Outside).</param>
+    /// <returns>Тот же диапазон для цепочки вызовов.</returns>
+    public static IRange Set(this IRange range, BorderSide borderSide, BorderTarget target = BorderTarget.Outside)
+    {
+        if (range is null) throw new ArgumentNullException(nameof(range));
+        if (range is not ExcelRange excelRange)
+            throw new ArgumentException("Range must be of type ExcelRange", nameof(range));
+
+        var writer = excelRange._writer;
+        var sheet = excelRange._sheet;
+        uint rowStart = range.RowStart;
+        uint rowEnd = range.RowEnd;
+        uint colStart = range.ColStart;
+        uint colEnd = range.ColEnd;
+
+        writer.ThrowIfDisposed();
+        lock (writer._syncLock)
+        {
+            // Определяем, какие стороны нужны для каждой ячейки
+            for (uint r = rowStart; r <= rowEnd; r++)
+            {
+                for (uint c = colStart; c <= colEnd; c++)
+                {
+                    var cell = new ExcelCell(writer, sheet, r, c);
+                    var newBorder = new CellBorder();
+
+                    bool isTopRow = (r == rowStart);
+                    bool isBottomRow = (r == rowEnd);
+                    bool isLeftCol = (c == colStart);
+                    bool isRightCol = (c == colEnd);
+
+                    // В зависимости от target, определяем, какие стороны устанавливать
+                    if (target == BorderTarget.All || target == BorderTarget.Outside)
+                    {
+                        if (isTopRow) newBorder = newBorder with { TopBorder = borderSide };
+                        if (isBottomRow) newBorder = newBorder with { BottomBorder = borderSide };
+                        if (isLeftCol) newBorder = newBorder with { LeftBorder = borderSide };
+                        if (isRightCol) newBorder = newBorder with { RightBorder = borderSide };
+                    }
+
+                    if (target == BorderTarget.All || target == BorderTarget.Inside)
+                    {
+                        // Внутренние границы: для каждой ячейки устанавливаем правую и нижнюю,
+                        // если есть сосед справа/снизу внутри диапазона
+                        if (c < colEnd) newBorder = newBorder with { RightBorder = borderSide };
+                        if (r < rowEnd) newBorder = newBorder with { BottomBorder = borderSide };
+                    }
+
+                    // Отдельные стороны
+                    if (target == BorderTarget.Top && isTopRow)
+                        newBorder = newBorder with { TopBorder = borderSide };
+                    if (target == BorderTarget.Bottom && isBottomRow)
+                        newBorder = newBorder with { BottomBorder = borderSide };
+                    if (target == BorderTarget.Left && isLeftCol)
+                        newBorder = newBorder with { LeftBorder = borderSide };
+                    if (target == BorderTarget.Right && isRightCol)
+                        newBorder = newBorder with { RightBorder = borderSide };
+
+                    // Применяем границу к ячейке (изолированно, без каскада)
+                    cell.SetBorderIsolate(newBorder);
+
+                    // Если ячейка находится на внешней границе диапазона, очищаем соответствующую сторону у соседа вне диапазона
+                    if (isTopRow && (target == BorderTarget.Outside || target == BorderTarget.All || target == BorderTarget.Top))
+                        ClearNeighborBorder(cell, -1, 0, b => b with { BottomBorder = null });
+
+                    if (isBottomRow && (target == BorderTarget.Outside || target == BorderTarget.All || target == BorderTarget.Bottom))
+                        ClearNeighborBorder(cell, 1, 0, b => b with { TopBorder = null });
+
+                    if (isLeftCol && (target == BorderTarget.Outside || target == BorderTarget.All || target == BorderTarget.Left))
+                        ClearNeighborBorder(cell, 0, -1, b => b with { RightBorder = null });
+
+                    if (isRightCol && (target == BorderTarget.Outside || target == BorderTarget.All || target == BorderTarget.Right))
+                        ClearNeighborBorder(cell, 0, 1, b => b with { LeftBorder = null });
+                }
+            }
+        }
+
+        return range;
+    }
+
+    /// <summary>
+    /// Очищает все границы в диапазоне (сбрасывает до None).
+    /// </summary>
+    public static IRange ClearBorders(this IRange range)
+    {
+        if (range is null) throw new ArgumentNullException(nameof(range));
+        if (range is not ExcelRange excelRange)
+            throw new ArgumentException("Range must be of type ExcelRange", nameof(range));
+
+        var writer = excelRange._writer;
+        var sheet = excelRange._sheet;
+        uint rowStart = range.RowStart;
+        uint rowEnd = range.RowEnd;
+        uint colStart = range.ColStart;
+        uint colEnd = range.ColEnd;
+
+        writer.ThrowIfDisposed();
+        lock (writer._syncLock)
+        {
+            for (uint r = rowStart; r <= rowEnd; r++)
+            {
+                for (uint c = colStart; c <= colEnd; c++)
+                {
+                    var cell = new ExcelCell(writer, sheet, r, c);
+                    // Удаляем все границы
+                    cell.SetBorderIsolate(new CellBorder()); // пустая граница
+                }
+            }
+        }
+
+        return range;
+    }
+
+    // Вспомогательный метод для очистки конкретной стороны у соседа
+    static void ClearNeighborBorder(ExcelCell cell, int rowOffset, int colOffset, Func<CellBorder, CellBorder> clearFunc)
+    {
+        var neighbor = cell.GetNeighbor(rowOffset, colOffset);
+        if (neighbor is null)
+            return;
+
+        var neighborBorder = neighbor.GetCellBorder();
+        var newBorder = clearFunc(neighborBorder);
+        if (!neighborBorder.Equals(newBorder))
+            neighbor.SetBorderIsolate(newBorder);
+    }
+}

QWERTYkez.ExcelProcessor/Editors/RowHeight.cs

@@ -5,13 +5,13 @@
 /// </summary>
 public readonly struct RowHeight(double points)
 {
-    private const double POINTS_PER_INCH = 72.0;
+    const double POINTS_PER_INCH = 72.0;
-    private const double INCH_PER_CM = 1.0 / 2.54;
+    const double INCH_PER_CM = 1.0 / 2.54;
-    private const double POINTS_PER_CM = POINTS_PER_INCH * INCH_PER_CM; // ≈ 28.3464566929
+    const double POINTS_PER_CM = POINTS_PER_INCH * INCH_PER_CM; // ≈ 28.3464566929
-    private const double POINTS_PER_MM = POINTS_PER_CM / 10.0;          // ≈ 2.83464566929
+    const double POINTS_PER_MM = POINTS_PER_CM / 10.0;          // ≈ 2.83464566929
 
-    private const double DXA_PER_POINT = 20.0;   // 1 point = 20 dxa
+    const double DXA_PER_POINT = 20.0;   // 1 point = 20 dxa
-    private const double POINTS_PER_DXA = 1.0 / DXA_PER_POINT;
+    const double POINTS_PER_DXA = 1.0 / DXA_PER_POINT;
 
     /// <summary>Высота в пунктах (points).</summary>
     public double Points { get; } = points;

QWERTYkez.ExcelProcessor/Editors/RunFormat.cs

@@ -19,7 +19,7 @@ public readonly struct RunFormat
     public bool? IsStrike { get; init; }
 
     /// <summary>Цвет текста фрагмента.</summary>
-    public ExColor? Color { get; init; }
+    public System.Drawing.Color? Color { get; init; }
 
     /// <summary>Размер шрифта фрагмента в пунктах.</summary>
     public double? FontSize { get; init; }
@@ -80,9 +80,7 @@ public readonly struct RunFormat
             // DoubleStrike в Excel не поддерживается, опускаем
 
             Underline = underline,
-            Color = rPr.GetFirstChild<Color>()?.Rgb is not null
+            Color = FromExcelColor(rPr.GetFirstChild<Color>()?.Rgb),
-                ? ExColor.FromRgb(rPr.GetFirstChild<Color>()!.Rgb!.Value!)
-                : null!,
             FontSize = rPr.GetFirstChild<FontSize>()?.Val?.Value,
             FontFamily = rPr.GetFirstChild<RunFont>()?.Val,
             Vertical = vertical
@@ -90,6 +88,45 @@ public readonly struct RunFormat
         return fmt;
     }
 
+
+
+    static System.Drawing.Color? FromExcelColor(string? rgb)
+    {
+        if (string.IsNullOrWhiteSpace(rgb)) return null;
+        if (rgb!.Length == 6)
+        {
+            byte r = Convert.ToByte(rgb.Substring(0, 2), 16);
+            byte g = Convert.ToByte(rgb.Substring(2, 2), 16);
+            byte b = Convert.ToByte(rgb.Substring(4, 2), 16);
+            return System.Drawing.Color.FromArgb(r, g, b);
+        }
+        else if (rgb.Length == 8)
+        {
+            byte a = Convert.ToByte(rgb.Substring(0, 2), 16);
+            byte r = Convert.ToByte(rgb.Substring(2, 2), 16);
+            byte g = Convert.ToByte(rgb.Substring(4, 2), 16);
+            byte b = Convert.ToByte(rgb.Substring(6, 2), 16);
+            return System.Drawing.Color.FromArgb(a, r, g, b);
+        }
+        else return null;
+    }
+
+    public bool TryGetExcelColor(out Color excelColor)
+    {
+        if (Color is { } c)
+        {
+            excelColor = new Color() { Rgb = $"{c.R:X2}{c.G:X2}{c.B:X2}" };
+            return true;
+        }
+        else
+        {
+            excelColor = null!;
+            return false;
+        }
+    }
+
+
+
     /*
 
     методы для извлечения OpenXmlElement или других более удобных типов

QWERTYkez.ExcelProcessor/ExcelWriter.cs

@@ -8,9 +8,56 @@ namespace QWERTYkez.ExcelProcessor;
 /// </summary>
 internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
 {
+
+    readonly Dictionary<CellStyle, int> _styleCache = [];
+
+    internal int GetOrCreateStyleId(CellStyle style)
+    {
+        lock (_syncLock)
+        {
+            if (_styleCache.TryGetValue(style, out int id))
+                return id;
+
+            // Создаём CellFormat через существующий метод GetOrCreateCellFormatId
+            int newId = GetOrCreateCellFormatId(
+                style.NumberFormat,
+                style.Font,
+                style.Fill,
+                style.Border,
+                style.Align
+            );
+            _styleCache[style] = newId;
+            return newId;
+        }
+    }
+
+
+    internal CellStyle? GetCellStyle(uint styleIndex)
+    {
+        if (styleIndex == 0) return null;
+        var align = GetCellAlign(styleIndex);
+        var font = GetCellFont(styleIndex);
+        var fill = GetCellFill(styleIndex);
+        var border = GetCellBorder(styleIndex);
+        var numberFormat = GetNumberFormat(styleIndex);
+        bool hasAny = !align.Equals(default) || !font.Equals(default) || !fill.Equals(default) ||
+                      !border.Equals(default) || numberFormat != null;
+        if (!hasAny) return null;
+        return new CellStyle
+        {
+            Align = align.Equals(default) ? null : align,
+            Font = font.Equals(default) ? null : font,
+            Fill = fill.Equals(default) ? null : fill,
+            Border = border.Equals(default) ? null : border,
+            NumberFormat = numberFormat
+        };
+    }
+
+
+
     // Работа с общей таблицей строк
-    private SharedStringTablePart? _sharedStringPart;
+    SharedStringTablePart? _sharedStringPart;
-    private SharedStringTable? _sharedStringTable;
+    SharedStringTable? _sharedStringTable;
 
     internal static Dictionary<int, double>? _calibrationTable; // cw -> width_pts
 
@@ -62,7 +109,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return true;
     }
 
-    private Dictionary<int, double> CalibrateWidthCoeffUsingInterop()
+    Dictionary<int, double> CalibrateWidthCoeffUsingInterop()
     {
         object? excelApp = null;
         object? workbooks = null;
@@ -133,7 +180,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
     }
 
 
-    private void EnsureSharedStringTable()
+    void EnsureSharedStringTable()
     {
         if (_sharedStringPart != null) return;
         _sharedStringPart = _doc.WorkbookPart?.GetPartsOfType<SharedStringTablePart>().FirstOrDefault();
@@ -193,17 +240,17 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
     }
 
     // Кэши числовых форматов
-    private readonly Dictionary<string, NumberFormatPattern> _numberFormatCache = [];
+    readonly Dictionary<string, NumberFormatPattern> _numberFormatCache = [];
-    private readonly Dictionary<uint, NumberFormatPattern> _numberFormatIdToPattern = [];
+    readonly Dictionary<uint, NumberFormatPattern> _numberFormatIdToPattern = [];
 
     // Кэши для компонентов стилей (чтобы не создавать дубликаты)
-    private readonly Dictionary<CellFont, int> _fontCache = [];
+    readonly Dictionary<CellFont, int> _fontCache = [];
-    private readonly Dictionary<CellFill, int> _fillCache = [];
+    readonly Dictionary<CellFill, int> _fillCache = [];
-    private readonly Dictionary<CellBorder, int> _borderCache = [];
+    readonly Dictionary<CellBorder, int> _borderCache = [];
-    private readonly Dictionary<CellAlign, int> _alignmentCache = [];
+    readonly Dictionary<CellAlign, int> _alignmentCache = [];
 
     // Кэш составных стилей (CellFormat)
-    private readonly Dictionary<(int fontId, int fillId, int borderId, int alignId, int numFmtId), int> _cellFormatCache = [];
+    readonly Dictionary<(int fontId, int fillId, int borderId, int alignId, int numFmtId), int> _cellFormatCache = [];
 
     // Конструктор, фабричные методы – без изменений (опущены)
 
@@ -294,10 +341,8 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
             int numFmtId = -1;
             if (numberFormat != null)
             {
-                if (numberFormat.Id.HasValue && numberFormat.Id.Value < 164)
+                numFmtId = numberFormat.Id.HasValue && numberFormat.Id.Value < 164
-                    numFmtId = numberFormat.Id.Value;
+                    ? numberFormat.Id.Value : (int)GetOrCreateNumberFormatId(numberFormat);
-                else
-                    numFmtId = (int)GetOrCreateNumberFormatId(numberFormat);
             }
 
             // Получаем или создаём Font, Fill, Border, Alignment
@@ -352,7 +397,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
 
     #region Вспомогательные методы для работы со стилями
 
-    private Stylesheet EnsureStylesheet()
+    Stylesheet EnsureStylesheet()
     {
         var workbookPart = _doc.WorkbookPart ?? throw new InvalidOperationException("No WorkbookPart");
         var stylesPart = workbookPart.WorkbookStylesPart;
@@ -390,7 +435,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return stylesheet;
     }
 
-    private uint GetOrCreateNumberFormatId(NumberFormatPattern pattern)
+    uint GetOrCreateNumberFormatId(NumberFormatPattern pattern)
     {
         if (pattern.Id.HasValue)
             return (uint)pattern.Id.Value;
@@ -400,7 +445,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return (uint)created.Id!.Value;
     }
 
-    private int GetOrCreateFontId(CellFont font)
+    int GetOrCreateFontId(CellFont font)
     {
         if (_fontCache.TryGetValue(font, out int id))
             return id;
@@ -414,7 +459,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return _fontCache[font] = (int)newId;
     }
 
-    private int GetOrCreateFillId(CellFill fill)
+    int GetOrCreateFillId(CellFill fill)
     {
         if (_fillCache.TryGetValue(fill, out int id))
             return id;
@@ -428,7 +473,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return _fillCache[fill] = (int)newId;
     }
 
-    private int GetOrCreateBorderId(CellBorder border)
+    int GetOrCreateBorderId(CellBorder border)
     {
         if (_borderCache.TryGetValue(border, out int id))
             return id;
@@ -443,7 +488,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return newId;
     }
 
-    private int GetOrCreateAlignmentId(CellAlign align)
+    int GetOrCreateAlignmentId(CellAlign align)
     {
         if (_alignmentCache.TryGetValue(align, out int id))
             return id;
@@ -456,7 +501,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return id;
     }
 
-    private Alignment GetAlignmentFromCache(int alignId)
+    Alignment GetAlignmentFromCache(int alignId)
     {
         foreach (var pair in _alignmentCache)
             if (pair.Value == alignId)
@@ -464,7 +509,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         return new Alignment();
     }
 
-    private CellFormat? GetCellFormatAt(uint index)
+    CellFormat? GetCellFormatAt(uint index)
     {
         var stylesheet = EnsureStylesheet();
         if (stylesheet.CellFormats == null || index >= stylesheet.CellFormats.Count!.Value)
@@ -473,14 +518,14 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
     }
 
     // Вспомогательные создания коллекций
-    private static NumberingFormats CreateNumberingFormats(Stylesheet stylesheet)
+    static NumberingFormats CreateNumberingFormats(Stylesheet stylesheet)
     {
         var nfs = new NumberingFormats();
         stylesheet.NumberingFormats = nfs;
         return nfs;
     }
 
-    private static CellFormats CreateCellFormats(Stylesheet stylesheet)
+    static CellFormats CreateCellFormats(Stylesheet stylesheet)
     {
         var cfs = new CellFormats();
         stylesheet.CellFormats = cfs;
@@ -491,7 +536,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
 
 
 
-    private bool _isModified = false;
+    bool _isModified = false;
 
     internal ExcelWriter() { }
 
@@ -1006,7 +1051,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
 
     #endregion
 
-    private void EnsureFullCalculationOnLoad()
+    void EnsureFullCalculationOnLoad()
     {
         if (_doc?.WorkbookPart?.Workbook == null) return;
         var workbook = _doc.WorkbookPart.Workbook;
@@ -1050,6 +1095,8 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
         if (string.IsNullOrEmpty(name))
             return null;
 
+        name = name.EscapeSymbols();
+
         lock (_syncLock)
         {
             var workbookPart = _doc.WorkbookPart;
@@ -1068,7 +1115,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
     /// <inheritdoc />
     public bool TryGetSheet(string name, out ISheet sheet)
     {
-        sheet = Sheet(name)!;
+        sheet = Sheet(name.EscapeSymbols())!;
         return sheet != null;
     }
 
@@ -1085,6 +1132,8 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
             if (workbookPart?.Workbook?.Sheets == null)
                 return false;
 
+            name = name.EscapeSymbols();
+
             // Проверка уникальности имени
             foreach (Sheet s in workbookPart.Workbook.Sheets.Elements<Sheet>())
             {
@@ -1123,7 +1172,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
     /// <inheritdoc />
     public bool TryRemoveSheet(string name)
     {
-        var sheet = Sheet(name);
+        var sheet = Sheet(name.EscapeSymbols());
         return sheet != null && TryRemoveSheet(sheet);
     }
 
@@ -1217,7 +1266,7 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
 
 
     // Внутренний метод, предполагает, что _syncLock уже захвачен вызывающим
-    private NumberFormatPattern CreateNumberFormatInternal(string formatCode)
+    NumberFormatPattern CreateNumberFormatInternal(string formatCode)
     {
         // Проверяем кэш по коду
         if (_numberFormatCache.TryGetValue(formatCode, out var existing))
@@ -1257,36 +1306,42 @@ internal sealed class ExcelWriter : ExcelReader, IExcelReader, IExcelWriter
 
     // Вспомогательные методы для извлечения элементов из стилей (нужно закешировать или обращаться напрямую)
 
-    private Border? GetBorderById(uint borderId)
+    Border? GetBorderById(uint borderId)
-    {
-        if (_cachedBorders == null)
     {
         var borders = EnsureStylesheet().Borders;
-            _cachedBorders = borders?.Elements<Border>().ToList() ?? [];
+        if (borders == null) return null;
-        }
+        int index = 0;
-        return borderId < _cachedBorders.Count ? _cachedBorders[(int)borderId] : null;
+        foreach (var border in borders.Elements<Border>())
-    }
-    private List<Border>? _cachedBorders;
-
-    private Fill? GetFillById(uint borderId)
         {
-        if (_cachedFills == null)
+            if (index == borderId) return border;
+            index++;
+        }
+        return null;
+    }
+
+    Fill? GetFillById(uint fillId)
     {
         var fills = EnsureStylesheet().Fills;
-            _cachedFills = fills?.Elements<Fill>().ToList() ?? [];
+        if (fills == null) return null;
+        int index = 0;
+        foreach (var fill in fills.Elements<Fill>())
+        {
+            if (index == fillId) return fill;
+            index++;
         }
-        return borderId < _cachedFills.Count ? _cachedFills[(int)borderId] : null;
+        return null;
     }
-    private List<Fill>? _cachedFills;
 
-    private Font? GetFontById(uint borderId)
+    Font? GetFontById(uint fontId)
     {
-        if (_cachedFonts == null)
+        var fonts = EnsureStylesheet().Fonts;
+        if (fonts == null) return null;
+        int index = 0;
+        foreach (var font in fonts.Elements<Font>())
         {
-            var borders = EnsureStylesheet().Borders;
+            if (index == fontId) return font;
-            _cachedFonts = borders?.Elements<Font>().ToList() ?? [];
+            index++;
         }
-        return borderId < _cachedFonts.Count ? _cachedFonts[(int)borderId] : null;
+        return null;
     }
-    private List<Font>? _cachedFonts;
 }

QWERTYkez.ExcelProcessor/NormalizedSet.cs

@@ -10,7 +10,7 @@ namespace QWERTYkez.ExcelProcessor;
 /// </summary>
 internal class NormalizedSet : ISet<string>
 {
-    private readonly HashSet<string> _inner;
+    readonly HashSet<string> _inner;
 
     /// <summary>
     /// Создаёт пустое нормализованное множество.
@@ -32,7 +32,7 @@ internal class NormalizedSet : ISet<string>
     /// <summary>
     /// Нормализует строку: верхний регистр и удаление диакритики.
     /// </summary>
-    private static string Normalize(string s)
+    static string Normalize(string s)
     {
         if (string.IsNullOrEmpty(s))
             return s;

QWERTYkez.ExcelProcessor/PlaceholderFinder.cs

@@ -22,7 +22,7 @@ internal static class PlaceholderFinder
         return FindInDocument(doc, [.. doc.WorkbookPart.WorksheetParts]);
     }
 
-    private static void ProcessWorksheet(WorksheetPart wsPart, SharedStringTable? sharedStrings, ISet<string> result)
+    static void ProcessWorksheet(WorksheetPart wsPart, SharedStringTable? sharedStrings, ISet<string> result)
     {
         var worksheet = wsPart.Worksheet;
         if (worksheet is null) return;
@@ -31,7 +31,7 @@ internal static class PlaceholderFinder
         ProcessHeaderFooter(worksheet, result);
     }
 
-    private static void ProcessCells(Worksheet worksheet, SharedStringTable? sharedStrings, ISet<string> result)
+    static void ProcessCells(Worksheet worksheet, SharedStringTable? sharedStrings, ISet<string> result)
     {
         var sheetData = worksheet.GetFirstChild<SheetData>();
         if (sheetData is null) return;
@@ -59,7 +59,7 @@ internal static class PlaceholderFinder
         }
     }
 
-    private static void ProcessHeaderFooter(Worksheet worksheet, ISet<string> result)
+    static void ProcessHeaderFooter(Worksheet worksheet, ISet<string> result)
     {
         var hf = worksheet.Descendants<HeaderFooter>().FirstOrDefault();
         if (hf is null) return;
@@ -84,7 +84,7 @@ internal static class PlaceholderFinder
         }
     }
 
-    private static string GetCellValue(Cell cell, SharedStringTable? sharedStrings)
+    static string GetCellValue(Cell cell, SharedStringTable? sharedStrings)
     {
         if (cell?.CellValue is null && cell?.InlineString is null)
             return string.Empty;
@@ -107,7 +107,7 @@ internal static class PlaceholderFinder
         return raw;
     }
 
-    private static unsafe bool FindPlaceholdersInText(string text, ref List<string>? output)
+    static unsafe bool FindPlaceholdersInText(string text, ref List<string>? output)
     {
         fixed (char* pText = text)
         {

QWERTYkez.ExcelProcessor/ReplaceNumericExtensions.cs

@@ -158,7 +158,7 @@ internal static class ReplaceNumericExtensions
 
     // =========================== ОБЩАЯ ЛОГИКА ===========================
 
-    private static void ReplaceNumericCore<T>(
+    static void ReplaceNumericCore<T>(
         WorkbookPart workbookPart,
         WorksheetPart[] worksheets,
         IEnumerable<KeyValuePair<string, T>> numericReplacements,
@@ -255,7 +255,7 @@ internal static class ReplaceNumericExtensions
         UpdateSharedStringTable(workbookPart, allSharedStrings);
     }
 
-    private static void ReplaceSingleCore<T>(
+    static void ReplaceSingleCore<T>(
         WorkbookPart workbookPart,
         WorksheetPart[] worksheets,
         string oldValue,
@@ -343,7 +343,7 @@ internal static class ReplaceNumericExtensions
 
     // =========================== ВСПОМОГАТЕЛЬНЫЕ МЕТОДЫ ===========================
 
-    private static string GetCellTextForNumeric(Cell cell, List<string> allSharedStrings)
+    static string GetCellTextForNumeric(Cell cell, List<string> allSharedStrings)
     {
         if (cell?.CellValue == null) return string.Empty;
 
@@ -366,7 +366,7 @@ internal static class ReplaceNumericExtensions
         return val;
     }
 
-    private static void SetCellText(Cell cell, string newText,
+    static void SetCellText(Cell cell, string newText,
         List<string> allSharedStrings, Dictionary<string, int> sharedStringIndexMap)
     {
         if (cell.InlineString != null)
@@ -388,7 +388,7 @@ internal static class ReplaceNumericExtensions
         cell.CellValue = new CellValue(index.ToString());
     }
 
-    private static void UpdateSharedStringTable(WorkbookPart workbookPart, List<string> allSharedStrings)
+    static void UpdateSharedStringTable(WorkbookPart workbookPart, List<string> allSharedStrings)
     {
         var ssPart = workbookPart.SharedStringTablePart;
         ssPart ??= workbookPart.AddNewPart<SharedStringTablePart>();
@@ -399,7 +399,7 @@ internal static class ReplaceNumericExtensions
         sharedStringTable.Save();
     }
 
-    private static string ConcatTexts(IEnumerable<Text> texts)
+    static string ConcatTexts(IEnumerable<Text> texts)
     {
         var sb = new StringBuilder();
         foreach (var t in texts)
@@ -408,7 +408,7 @@ internal static class ReplaceNumericExtensions
     }
 
     // Оптимизированная замена подстроки через string.Create (без unsafe)
-    private static unsafe string ReplaceSubstring(string original, int start, int length, string replacement)
+    static unsafe string ReplaceSubstring(string original, int start, int length, string replacement)
     {
         if (length == 0) return original;
         int newLen = original.Length - length + replacement.Length;
@@ -428,7 +428,7 @@ internal static class ReplaceNumericExtensions
         }
     }
 
-    private static uint CreateNumberFormat(WorkbookPart workbookPart, string format)
+    static uint CreateNumberFormat(WorkbookPart workbookPart, string format)
     {
         var stylesPart = workbookPart.WorkbookStylesPart;
         if (stylesPart == null)
@@ -457,7 +457,7 @@ internal static class ReplaceNumericExtensions
 
     // =========================== КОЛОНТИТУЛЫ И КОММЕНТАРИИ ===========================
 
-    private static void ReplaceInHeadersFooters(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static void ReplaceInHeadersFooters(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         var worksheet = worksheetPart.Worksheet;
         if (worksheet is null) return;
@@ -468,7 +468,7 @@ internal static class ReplaceNumericExtensions
             ReplaceHeaderFooter(elem, replacementDict, comparisonType);
     }
 
-    private static void ReplaceHeaderFooter(OpenXmlLeafTextElement? element, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static void ReplaceHeaderFooter(OpenXmlLeafTextElement? element, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         if (element?.Text is null) return;
         string original = element.Text;
@@ -477,7 +477,7 @@ internal static class ReplaceNumericExtensions
             element.Text = processed;
     }
 
-    private static void ReplaceInComments(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static void ReplaceInComments(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         var commentsPart = worksheetPart.WorksheetCommentsPart;
         if (commentsPart?.Comments is null) return;
@@ -493,7 +493,7 @@ internal static class ReplaceNumericExtensions
         }
     }
 
-    private static string ProcessReplacements(string input, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static string ProcessReplacements(string input, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         if (string.IsNullOrEmpty(input) || replacementDict.Count == 0) return input;
         string result = input;
@@ -505,7 +505,7 @@ internal static class ReplaceNumericExtensions
         return result;
     }
 
-    private static string ReplaceInString(string original, string oldValue, string newValue, StringComparison comparisonType)
+    static string ReplaceInString(string original, string oldValue, string newValue, StringComparison comparisonType)
     {
         int idx = original.IndexOf(oldValue, comparisonType);
         if (idx < 0) return original;

QWERTYkez.ExcelProcessor/ReplaceStringExtensions.cs

@@ -30,7 +30,7 @@ internal static class ReplaceStringExtensions
     }
 
     // --- Общий приватный метод, содержащий всю логику замены ---
-    private static void ReplaceCore(SpreadsheetDocument doc, WorksheetPart[] worksheets, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static void ReplaceCore(SpreadsheetDocument doc, WorksheetPart[] worksheets, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         var workbookPart = doc.WorkbookPart!;
 
@@ -63,7 +63,7 @@ internal static class ReplaceStringExtensions
     }
 
     // --- Остальные вспомогательные методы (без изменений) ---
-    private static IEqualityComparer<string> GetComparerForStringComparison(StringComparison comparisonType) =>
+    static IEqualityComparer<string> GetComparerForStringComparison(StringComparison comparisonType) =>
         comparisonType switch
         {
             StringComparison.Ordinal => StringComparer.Ordinal,
@@ -75,7 +75,7 @@ internal static class ReplaceStringExtensions
             _ => StringComparer.OrdinalIgnoreCase,
         };
 
-    private static void CollectCellChanges(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType, Dictionary<Cell, string> cellChanges, List<string> allSharedStrings)
+    static void CollectCellChanges(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType, Dictionary<Cell, string> cellChanges, List<string> allSharedStrings)
     {
         var worksheet = worksheetPart.Worksheet;
         if (worksheet is null) return;
@@ -93,7 +93,7 @@ internal static class ReplaceStringExtensions
             }
     }
 
-    private static void ApplyCellChanges(Dictionary<Cell, string> cellChanges, List<string> allSharedStrings)
+    static void ApplyCellChanges(Dictionary<Cell, string> cellChanges, List<string> allSharedStrings)
     {
         foreach (var kvp in cellChanges)
         {
@@ -114,7 +114,7 @@ internal static class ReplaceStringExtensions
         }
     }
 
-    private static void UpdateSharedStringTable(WorkbookPart workbookPart, List<string> allSharedStrings)
+    static void UpdateSharedStringTable(WorkbookPart workbookPart, List<string> allSharedStrings)
     {
         var ssPart = workbookPart.SharedStringTablePart;
         ssPart ??= workbookPart.AddNewPart<SharedStringTablePart>();
@@ -125,7 +125,7 @@ internal static class ReplaceStringExtensions
         sharedStringTable.Save();
     }
 
-    private static string ProcessReplacements(string input, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static string ProcessReplacements(string input, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         if (string.IsNullOrEmpty(input) || replacementDict.Count == 0) return input;
         string result = input;
@@ -137,7 +137,7 @@ internal static class ReplaceStringExtensions
         return result;
     }
 
-    private static string ReplaceInString(string original, string oldValue, string newValue, StringComparison comparisonType)
+    static string ReplaceInString(string original, string oldValue, string newValue, StringComparison comparisonType)
     {
         int idx = original.IndexOf(oldValue, comparisonType);
         if (idx < 0) return original;
@@ -154,7 +154,7 @@ internal static class ReplaceStringExtensions
         return sb.ToString();
     }
 
-    private static string GetCellText(Cell cell, List<string> allSharedStrings)
+    static string GetCellText(Cell cell, List<string> allSharedStrings)
     {
         if (cell?.CellValue is null) return string.Empty;
         if (cell.InlineString is not null)
@@ -169,7 +169,7 @@ internal static class ReplaceStringExtensions
         return value;
     }
 
-    private static int AddOrFindStringIndex(List<string> allSharedStrings, string text)
+    static int AddOrFindStringIndex(List<string> allSharedStrings, string text)
     {
         int idx = allSharedStrings.IndexOf(text);
         if (idx >= 0) return idx;
@@ -178,7 +178,7 @@ internal static class ReplaceStringExtensions
     }
 
     // --- Колонтитулы (обобщённый метод) ---
-    private static void ReplaceInHeadersFooters(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static void ReplaceInHeadersFooters(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         var worksheet = worksheetPart.Worksheet;
         if (worksheet is null) return;
@@ -189,7 +189,7 @@ internal static class ReplaceStringExtensions
             ReplaceHeaderFooter(elem, replacementDict, comparisonType);
     }
 
-    private static void ReplaceHeaderFooter(OpenXmlLeafTextElement? element, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static void ReplaceHeaderFooter(OpenXmlLeafTextElement? element, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         if (element?.Text is null) return;
         string original = element.Text;
@@ -199,7 +199,7 @@ internal static class ReplaceStringExtensions
     }
 
     // --- Комментарии ---
-    private static void ReplaceInComments(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
+    static void ReplaceInComments(WorksheetPart worksheetPart, Dictionary<string, string> replacementDict, StringComparison comparisonType)
     {
         var commentsPart = worksheetPart.WorksheetCommentsPart;
         if (commentsPart?.Comments is null) return;

QWERTYkez.WordProcessor/Extension.cs

@@ -0,0 +1,31 @@
+namespace QWERTYkez.WordProcessor;
+
+internal static class Extension
+{
+    public static void SwapBottomRight(this PageMargin margin)
+    {
+        if (margin.Right is { } r)
+        {
+            margin.Right = margin.Bottom is not null ? new((uint)margin.Bottom.Value) : null;
+            margin.Bottom = new((int)r.Value);
+        }
+        else if(margin.Bottom is { } b)
+        {
+            margin.Bottom = null;
+            margin.Right = new((uint)b.Value);
+        }
+    }
+    public static void SwapValues(this PageSize size)
+    {
+        if (size.Width is { } w)
+        {
+            size.Width = size.Height is not null ? new(size.Height.Value) : null;
+            size.Height = new(w.Value);
+        }
+        else if (size.Height is { } h)
+        {
+            size.Height = null;
+            size.Width = new(h.Value);
+        }
+    }
+}

QWERTYkez.WordProcessor/IWordReader.cs

@@ -6,6 +6,10 @@ public interface IWordReader
     string? FilePath { get; }
     bool IsValid { get; }
 
+#if DEBUG
+    Body Body { get; }
+#endif
+
     ISet<string> FindPlaceholders();
 
 

QWERTYkez.WordProcessor/IeExtension.cs

@@ -1,106 +0,0 @@
-namespace QWERTYkez.WordProcessor;
-
-internal static class IeExtension
-{
-    /// <summary>
-    /// Выполняет указанные действия для первого и последующих элементов последовательности.
-    /// </summary>
-    /// <typeparam name="T">Тип элементов последовательности.</typeparam>
-    /// <param name="items">Последовательность элементов.</param>
-    /// <param name="first">Действие над первым элементом (если есть).</param>
-    /// <param name="next">Действие над каждым последующим элементом, начиная со второго.</param>
-    /// <exception cref="ArgumentNullException">Возникает, если items или любой из делегатов равен null.</exception>
-    public static void ForFirstNext<T>(this IEnumerable<T> items, Action<T> first, Action<T> next)
-    {
-        if (items is null) throw new ArgumentNullException(nameof(items));
-        if (first is null) throw new ArgumentNullException(nameof(first));
-        if (next is null) throw new ArgumentNullException(nameof(next));
-
-        using var enumerator = items.GetEnumerator();
-
-        if (!enumerator.MoveNext())
-            return;
-
-        first(enumerator.Current);
-
-        while (enumerator.MoveNext())
-        {
-            next(enumerator.Current);
-        }
-    }
-
-    /// <summary>
-    /// Выполняет указанные действия для первого, промежуточных и последнего элементов последовательности.
-    /// Если последовательность содержит только один элемент, то для него вызываются и first, и last.
-    /// </summary>
-    /// <typeparam name="T">Тип элементов последовательности.</typeparam>
-    /// <param name="items">Последовательность элементов.</param>
-    /// <param name="first">Действие над первым элементом.</param>
-    /// <param name="next">Действие над элементами, которые не являются ни первыми, ни последними.</param>
-    /// <param name="last">Действие над последним элементом.</param>
-    /// <exception cref="ArgumentNullException">Возникает, если items или любой из делегатов равен null.</exception>
-    public static void ForFirstNextLast<T>(this IEnumerable<T> items, Action<T> first, Action<T> next, Action<T> last)
-    {
-        if (items is null) throw new ArgumentNullException(nameof(items));
-        if (first is null) throw new ArgumentNullException(nameof(first));
-        if (next is null) throw new ArgumentNullException(nameof(next));
-        if (last is null) throw new ArgumentNullException(nameof(last));
-
-        using var enumerator = items.GetEnumerator();
-
-        if (!enumerator.MoveNext())
-            return;
-
-        T firstItem = enumerator.Current;
-
-        // Если только один элемент
-        if (!enumerator.MoveNext())
-        {
-            first(firstItem);
-            last(firstItem);
-            return;
-        }
-
-        // Есть как минимум два элемента
-        first(firstItem);
-
-        T prev = enumerator.Current; // второй элемент
-        while (enumerator.MoveNext())
-        {
-            next(prev);          // предыдущий элемент точно не последний
-            prev = enumerator.Current;
-        }
-
-        last(prev); // последний элемент
-    }
-
-    /// <summary>
-    /// Выполняет указанные действия для всех элементов, кроме последнего, и для последнего элемента.
-    /// Если последовательность содержит только один элемент, то вызывается только last.
-    /// </summary>
-    /// <typeparam name="T">Тип элементов последовательности.</typeparam>
-    /// <param name="items">Последовательность элементов.</param>
-    /// <param name="next">Действие над элементами, не являющимися последними.</param>
-    /// <param name="last">Действие над последним элементом.</param>
-    /// <exception cref="ArgumentNullException">Возникает, если items или любой из делегатов равен null.</exception>
-    public static void ForNextLast<T>(this IEnumerable<T> items, Action<T> next, Action<T> last)
-    {
-        if (items is null) throw new ArgumentNullException(nameof(items));
-        if (next is null) throw new ArgumentNullException(nameof(next));
-        if (last is null) throw new ArgumentNullException(nameof(last));
-
-        using var enumerator = items.GetEnumerator();
-
-        if (!enumerator.MoveNext())
-            return;
-
-        T prev = enumerator.Current;
-        while (enumerator.MoveNext())
-        {
-            next(prev);
-            prev = enumerator.Current;
-        }
-
-        last(prev);
-    }
-}

QWERTYkez.WordProcessor/MultiReplace.cs

@@ -1,14 +1,22 @@
 namespace QWERTYkez.WordProcessor;
 
+#if DEBUG
+public static class Debugger
+{
+    public static StringBuilder Builder { get; } = new();
+}
+#endif
+
 /// <summary>
 /// Выполняет замену всех вхождений ключей из словаря на соответствующие массивы значений.
 /// Каждое значение из массива помещается в отдельный параграф, причём первое значение
 /// остаётся в текущем параграфе, а последующие создают новые.
 /// Текст между вхождениями и после последнего сохраняется в соответствующих параграфах.
+/// Поддерживает разрывы страниц и смену ориентации (альбомная/книжная) через <see cref="ReplaceItem.SplitValue"/>.
 /// </summary>
 internal static class MultiReplaceExt
 {
-    // ---------- ПУБЛИЧНЫЕ МЕТОДЫ (СИГНАТУРЫ НЕИЗМЕННЫ) ----------
+    // ---------- ПУБЛИЧНЫЕ МЕТОДЫ (для Body) ----------
 
     #region Body.Replace с одним ключом
 
@@ -152,7 +160,7 @@ internal static class MultiReplaceExt
         public int End { get; } = end;
     }
 
-    private class ParagraphStructure(string fullText, List<MultiReplaceExt.RunSegment> segments)
+    private class ParagraphStructure(string fullText, List<RunSegment> segments)
     {
         public string FullText { get; } = fullText;
         public List<RunSegment> Segments { get; } = segments;
@@ -182,147 +190,52 @@ internal static class MultiReplaceExt
         return sb.ToString();
     }
 
-    private static Paragraph CloneParagraphProperties(Paragraph original)
+    /// <summary>Клонирует параграф, удаляя все SectionProperties и PageBreakBefore.</summary>
+    private static Paragraph CloneParagraphWithoutSection(Paragraph original)
     {
         var newPara = new Paragraph();
         if (original.ParagraphProperties is not null)
-            newPara.ParagraphProperties = (ParagraphProperties)original.ParagraphProperties.CloneNode(true);
+        {
+            var newProps = new ParagraphProperties();
+            foreach (var child in original.ParagraphProperties.ChildElements)
+            {
+                if (child is not SectionProperties && child is not PageBreakBefore)
+                    newProps.AppendChild(child.CloneNode(true));
+            }
+            newPara.ParagraphProperties = newProps;
+        }
         return newPara;
     }
 
-    /// <summary>
+    private static Paragraph? BuildRemainderParagraph(Paragraph original, ParagraphStructure structure, int position)
-    /// Строит параграф, содержащий копии всех элементов исходного параграфа,
-    /// попадающих в текстовый диапазон [start, end).
-    /// </summary>
-    private static Paragraph? BuildRangeParagraph(Paragraph original, ParagraphStructure structure, int start, int end)
-    {
-        if (start >= end) return null;
-
-        var newPara = CloneParagraphProperties(original);
-
-        foreach (var child in original.ChildElements)
-        {
-            if (child is Run run)
-            {
-                var seg = structure.Segments.FirstOrDefault(s => s.Run == run);
-                if (seg is null)
-                {
-                    // Run без текста (разрыв, поле) – копируем целиком, т.к. не можем привязать к позиции
-                    newPara.AppendChild(run.CloneNode(true));
-                    continue;
-                }
-
-                if (seg.End <= start || seg.Start >= end)
-                    continue;
-
-                if (seg.Start >= start && seg.End <= end)
-                {
-                    // Полностью внутри диапазона
-                    newPara.AppendChild(run.CloneNode(true));
-                }
-                else
-                {
-                    // Частичное пересечение – обрезаем текст
-                    var runClone = (Run)run.CloneNode(true);
-                    foreach (var t in runClone.Elements<Text>().ToList())
-                        t.Remove();
-
-					int cutStart = Math.Max(start, seg.Start) - seg.Start;
-					int cutEnd = Math.Min(end, seg.End) - seg.Start;
-					string newText = seg.Text.Substring(cutStart, cutEnd - cutStart);
-					runClone.AppendChild(new Text(newText));
-					newPara.AppendChild(runClone);
-				}
-            }
-            else
-            {
-                // Не Run – копируем всегда (закладки, поля и т.п.), т.к. не можем определить позицию
-                newPara.AppendChild(child.CloneNode(true));
-            }
-        }
-
-        // Удаляем пустые Run
-        foreach (var run in newPara.Descendants<Run>().Where(r => !r.HasChildren).ToList())
-            run.Remove();
-
-        if (!newPara.ChildElements.OfType<Run>().Any() && newPara.ParagraphProperties is null)
-            return null;
-
-        return newPara;
-    }
-
-    /// <summary>
-    /// Строит параграф, содержащий все элементы исходного параграфа,
-    /// которые находятся строго после указанной текстовой позиции,
-    /// пропуская нетекстовые элементы до первого текстового сегмента.
-    /// </summary>
-    private static Paragraph? BuildAfterParagraph(Paragraph original, ParagraphStructure structure, int position)
     {
         if (position >= structure.FullText.Length) return null;
 
-        var newPara = CloneParagraphProperties(original);
+        var newPara = CloneParagraphWithoutSection(original);
-
+        foreach (var seg in structure.Segments)
-        // Находим первый текстовый сегмент, который начинается на или после position
-        var firstTextSeg = structure.Segments.FirstOrDefault(s => s.Start >= position);
-        bool passedFirstText = false;
-
-        foreach (var child in original.ChildElements)
         {
-            if (child is Run run)
+            if (seg.End <= position) continue;
-            {
-                var seg = structure.Segments.FirstOrDefault(s => s.Run == run);
-                if (seg is null)
-                {
-                    // Run без текста – добавляем только если уже прошли первый текстовый сегмент
-                    if (passedFirstText)
-                        newPara.AppendChild(run.CloneNode(true));
-                    continue;
-                }
-
             if (seg.Start >= position)
             {
-                    // Полностью после позиции
+                newPara.AppendChild(seg.Run.CloneNode(true));
-                    newPara.AppendChild(run.CloneNode(true));
-                    if (seg == firstTextSeg)
-                        passedFirstText = true;
             }
             else if (seg.End > position)
             {
-                    // Частично пересекает – обрезаем текст
+                var runClone = (Run)seg.Run.CloneNode(true);
-                    var runClone = (Run)run.CloneNode(true);
+                foreach (var t in runClone.Elements<Text>().ToList()) t.Remove();
-                    foreach (var t in runClone.Elements<Text>().ToList())
-                        t.Remove();
-
                 int offset = position - seg.Start;
                 string newText = seg.Text.Substring(offset);
                 runClone.AppendChild(new Text(newText));
                 newPara.AppendChild(runClone);
-                    passedFirstText = true;
-                }
-                // seg.End <= position – игнорируем
-            }
-            else
-            {
-                // Не Run – добавляем только если уже прошли первый текстовый сегмент
-                if (passedFirstText)
-                    newPara.AppendChild(child.CloneNode(true));
             }
         }
-
         foreach (var run in newPara.Descendants<Run>().Where(r => !r.HasChildren).ToList())
             run.Remove();
-
         if (!newPara.ChildElements.OfType<Run>().Any() && newPara.ParagraphProperties is null)
             return null;
-
         return newPara;
     }
 
-    /// <summary>
-    /// Вставляет в параграф новый Run с текстом из ReplaceItem,
-    /// копируя форматирование из сегмента, содержащего указанную позицию.
-    /// Если BreakPage == true, добавляет отдельный Run с разрывом страницы.
-    /// </summary>
     private static void InsertFormattedRun(Paragraph para, ReplaceItem item, ParagraphStructure structure, int position)
     {
         var seg = structure.Segments.FirstOrDefault(s => position >= s.Start && position < s.End);
@@ -333,42 +246,177 @@ internal static class MultiReplaceExt
             textRun.RunProperties = (RunProperties)seg.Run.RunProperties.CloneNode(true);
         textRun.AppendChild(new Text(item.Text ?? string.Empty));
         para.AppendChild(textRun);
-
-        if (item.BreakPage)
-        {
-            var breakRun = new Run(new Break() { Type = BreakValues.Page });
-            if (seg.Run.RunProperties is not null)
-                breakRun.RunProperties = (RunProperties)seg.Run.RunProperties.CloneNode(true);
-            para.AppendChild(breakRun);
-        }
     }
 
     /// <summary>
-    /// Добавляет содержимое одного параграфа в другой (клонируя элементы).
+    /// Добавляет SectionProperties к параграфу. Все значения (PageSize, PageMargin) берутся из документа.
+    /// Для книжных секций (addPageSize=false) Orient не устанавливается (not set).
     /// </summary>
+    private static void AddSectionProperties(Paragraph para, PageBreakType splitValue, bool addPageSize, SectionProperties sourceSection, SectionProperties portraitSection)
+    {
+        if (para is null) return;
+
+        // Удаляем существующие секции
+        if (para.ParagraphProperties is not null)
+        {
+            var sections = para.ParagraphProperties.Elements<SectionProperties>().ToList();
+            foreach (var sec in sections) sec.Remove();
+            var pageBreaks = para.ParagraphProperties.Elements<PageBreakBefore>().ToList();
+            foreach (var pb in pageBreaks) pb.Remove();
+        }
+
+        para.ParagraphProperties ??= new ParagraphProperties();
+        var sectionProps = new SectionProperties();
+
+        // Добавляем PageSize
+        SectionProperties? sizeSource = addPageSize ? sourceSection : portraitSection;
+        var sourcePageSize = sizeSource?.GetFirstChild<PageSize>();
+        if (sourcePageSize is null && portraitSection is not null)
+            sourcePageSize = portraitSection.GetFirstChild<PageSize>();
+        if (sourcePageSize is null && sourceSection is not null)
+            sourcePageSize = sourceSection.GetFirstChild<PageSize>();
+
+        if (sourcePageSize is not null)
+        {
+            var pageSizeClone = (PageSize)sourcePageSize.CloneNode(true);
+            bool sourceIsLandscape = pageSizeClone.Orient?.Value == PageOrientationValues.Landscape ||
+                                     (pageSizeClone.Width?.Value > pageSizeClone.Height?.Value);
+
+            bool targetIsLandscape = (addPageSize && splitValue == PageBreakType.NewLandscapeSection);
+
+            if (targetIsLandscape && !sourceIsLandscape)
+            {
+                pageSizeClone.SwapValues();
+                pageSizeClone.Orient = PageOrientationValues.Landscape;
+            }
+            else if (!targetIsLandscape && sourceIsLandscape)
+            {
+                pageSizeClone.SwapValues();
+                if (addPageSize)
+                    pageSizeClone.Orient = PageOrientationValues.Portrait;
+                else
+                    pageSizeClone.Orient = null; // не задаём Orient (not set)
+            }
+            else
+            {
+                if (targetIsLandscape)
+                    pageSizeClone.Orient = PageOrientationValues.Landscape;
+                else if (addPageSize)
+                    pageSizeClone.Orient = PageOrientationValues.Portrait;
+                else
+                    pageSizeClone.Orient = null; // not set
+            }
+            sectionProps.AppendChild(pageSizeClone);
+        }
+
+        // Копируем PageMargin
+        PageMargin? marginToUse = null;
+        if (addPageSize)
+        {
+            var sourceMargin = sourceSection?.GetFirstChild<PageMargin>()
+                              ?? portraitSection?.GetFirstChild<PageMargin>();
+            if (sourceMargin is not null)
+            {
+                var marginClone = (PageMargin)sourceMargin.CloneNode(true);
+                var sourceOrient = sourceSection?.GetFirstChild<PageSize>()?.Orient;
+                bool sourceIsLandscape = sourceOrient?.Value == PageOrientationValues.Landscape ||
+                                         (sourceSection?.GetFirstChild<PageSize>()?.Width?.Value > sourceSection?.GetFirstChild<PageSize>()?.Height?.Value);
+                if ((splitValue == PageBreakType.NewLandscapeSection && !sourceIsLandscape) ||
+                    (splitValue == PageBreakType.NewPortraitSection && sourceIsLandscape))
+                {
+                    marginClone.SwapBottomRight();
+                }
+                marginToUse = marginClone;
+            }
+        }
+        else
+        {
+            var portraitMargin = portraitSection?.GetFirstChild<PageMargin>();
+            if (portraitMargin is not null)
+                marginToUse = (PageMargin)portraitMargin.CloneNode(true);
+        }
+
+        if (marginToUse is not null)
+            sectionProps.AppendChild(marginToUse);
+
+        sectionProps.AppendChild(new SectionType { Val = SectionMarkValues.NextPage });
+        para.ParagraphProperties.AppendChild(sectionProps);
+    }
+
     private static void MergeParagraph(Paragraph target, Paragraph source)
     {
         foreach (var child in source.ChildElements)
             target.AppendChild(child.CloneNode(true));
     }
 
-    /// <summary>
+    /// <summary>Выводит структуру документа: для каждого параграфа показывает текст, наличие секции, ориентацию, размеры и поля.</summary>
-    /// Основной алгоритм: обрабатывает все вхождения всех ключей из предоставленных словарей.
+    private static void LogDocumentStructure(Body body, string title)
-    /// </summary>
+    {
+#if DEBUG
+        Debugger.Builder.AppendLine($"=== {title} ===");
+        var paragraphs = body.Descendants<Paragraph>().ToList();
+        int index = 0;
+        foreach (var para in paragraphs)
+        {
+            var text = para.InnerText.Replace("\n", "\\n").Replace("\r", "\\r");
+            var section = para.ParagraphProperties?.GetFirstChild<SectionProperties>();
+            string sectionInfo = "None";
+            if (section is not null)
+            {
+                var pageSize = section.GetFirstChild<PageSize>();
+                string orient = pageSize?.Orient?.ToString() ?? "not set";
+                string sizeInfo = "";
+                if (pageSize is not null)
+                {
+                    sizeInfo = $" Size: W={pageSize.Width?.Value}, H={pageSize.Height?.Value}";
+                }
+                var margins = section.GetFirstChild<PageMargin>();
+                string marginInfo = "";
+                if (margins is not null)
+                {
+                    marginInfo = $" Margins: Top={margins.Top?.Value}, Bottom={margins.Bottom?.Value}, Left={margins.Left?.Value}, Right={margins.Right?.Value}";
+                }
+                sectionInfo = $"Orient={orient}{sizeInfo}{marginInfo}";
+            }
+            Debugger.Builder.AppendLine($"  Para {index}: Text='{text}', Section={sectionInfo}");
+            index++;
+        }
+
+        // Логируем секции из Body (если есть)
+        var bodySections = body.Elements<SectionProperties>().ToList();
+        if (bodySections.Any())
+        {
+            Debugger.Builder.AppendLine("  Body SectionProperties:");
+            foreach (var sec in bodySections)
+            {
+                var ps = sec.GetFirstChild<PageSize>();
+                var pm = sec.GetFirstChild<PageMargin>();
+                Debugger.Builder.AppendLine($"    PageSize: Width={ps?.Width}, Height={ps?.Height}, Orient={ps?.Orient}");
+                Debugger.Builder.AppendLine($"    PageMargin: Top={pm?.Top}, Bottom={pm?.Bottom}, Left={pm?.Left}, Right={pm?.Right}");
+            }
+        }
+        Debugger.Builder.AppendLine($"=== END {title} ===");
+#endif
+    }
+
+    /// <summary>Основной алгоритм множественной замены с поддержкой разрывов и смены ориентации.</summary>
     private static List<Paragraph>? ProcessMultiReplacements(
         Paragraph original,
         IEnumerable<KeyValuePair<string, IEnumerable<string>>>? stringReplacements,
         IEnumerable<KeyValuePair<string, IEnumerable<ReplaceItem>>>? itemReplacements,
         StringComparison comparisonType)
     {
-        // 1. Собираем определения замен
+        var body = original.Ancestors<Body>().FirstOrDefault();
+
+        // 1. Сбор определений
         var definitions = new List<MatchDefinition>();
         if (stringReplacements is not null)
         {
             foreach (var kvp in stringReplacements)
             {
                 if (string.IsNullOrEmpty(kvp.Key) || kvp.Value is null || kvp.Value.Count() == 0) continue;
-                definitions.Add(new MatchDefinition(kvp.Key, [.. kvp.Value.Select(v => new ReplaceItem(v, false))]));
+                var items = kvp.Value.Select(v => new ReplaceItem(v, PageBreakType.None));
+                definitions.Add(new MatchDefinition(kvp.Key, items));
             }
         }
         if (itemReplacements is not null)
@@ -379,7 +427,6 @@ internal static class MultiReplaceExt
                 definitions.Add(new MatchDefinition(kvp.Key, kvp.Value));
             }
         }
-
         if (definitions.Count == 0) return null;
 
         // 2. Анализ структуры параграфа
@@ -389,7 +436,7 @@ internal static class MultiReplaceExt
         string fullText = structure.FullText;
         if (fullText.Length == 0) return null;
 
-        // 3. Находим все вхождения всех ключей
+        // 3. Поиск всех вхождений
         var matches = new List<Match>();
         foreach (var def in definitions)
         {
@@ -405,90 +452,201 @@ internal static class MultiReplaceExt
                 pos += def.Key.Length;
             }
         }
-
         if (matches.Count == 0) return null;
-
-        // 4. Сортируем по позиции
         matches.Sort((a, b) => a.Start.CompareTo(b.Start));
 
-        // 5. Построение результирующих параграфов
+        // 4. Получаем исходную секцию для копирования (из original или из документа)
+        SectionProperties? sourceSection = original.ParagraphProperties?.GetFirstChild<SectionProperties>()?.CloneNode(true) as SectionProperties;
+        if (sourceSection is null && body is not null)
+        {
+            sourceSection = body.Elements<SectionProperties>().LastOrDefault()?.CloneNode(true) as SectionProperties;
+        }
+        sourceSection ??= new SectionProperties();
+
+        // Получаем книжную секцию для копирования полей (из документа)
+        SectionProperties? portraitSection = null;
+        if (body is not null)
+        {
+            portraitSection = body.Elements<SectionProperties>().FirstOrDefault()?.CloneNode(true) as SectionProperties;
+        }
+        portraitSection ??= new SectionProperties();
+
+        // 5. Построение результата
         var resultParas = new List<Paragraph>();
         Paragraph? currentPara = null;
         int currentPos = 0;
+        bool sectionChangeInsideGroup = false;
+        PageBreakType? lastOrientation = null;
 
         for (int i = 0; i < matches.Count; i++)
         {
             var match = matches[i];
 
-            // Текст перед текущим совпадением (от currentPos до match.Start)
+            // Текст перед совпадением (если есть)
             if (currentPos < match.Start)
             {
-                var textPart = BuildRangeParagraph(original, structure, currentPos, match.Start);
+                var beforePara = CloneParagraphWithoutSection(original);
-                if (textPart is not null)
+                foreach (var seg in structure.Segments)
                 {
-                    if (currentPara is null)
+                    if (seg.End <= currentPos) continue;
+                    if (seg.Start >= match.Start) break;
+                    if (seg.Start >= currentPos && seg.End <= match.Start)
                     {
-                        currentPara = textPart;
+                        beforePara.AppendChild(seg.Run.CloneNode(true));
-                        resultParas.Add(currentPara);
                     }
-                    else
+                    else if (seg.Start < match.Start && seg.End > currentPos)
                     {
-                        MergeParagraph(currentPara, textPart);
+                        int startOffset = Math.Max(0, currentPos - seg.Start);
+                        int endOffset = Math.Min(seg.Text.Length, match.Start - seg.Start);
+                        var runClone = (Run)seg.Run.CloneNode(true);
+                        foreach (var t in runClone.Elements<Text>().ToList()) t.Remove();
+                        string textPart = seg.Text.Substring(startOffset, endOffset - startOffset);
+                        runClone.AppendChild(new Text(textPart));
+                        beforePara.AppendChild(runClone);
                     }
                 }
+                if (beforePara.ChildElements.OfType<Run>().Any())
+                {
+                    resultParas.Add(beforePara);
+                    currentPara = beforePara;
+                }
             }
 
-            // Обрабатываем значения замены для этого совпадения
+            var values = match.Definition.Values.ToList();
-            var values = match.Definition.Values;
+            if (values.Count == 0) continue;
 
-            // Первое значение – в текущий параграф (или создаём новый)
+            for (int vIdx = 0; vIdx < values.Count; vIdx++)
-            if (currentPara is null)
             {
-                currentPara = CloneParagraphProperties(original);
+                var item = values[vIdx];
-                resultParas.Add(currentPara);
-            }
 
-            values.ForFirstNext(first =>
+                // Создаём новый параграф для каждого элемента
-            {
+                var newPara = CloneParagraphWithoutSection(original);
-                InsertFormattedRun(currentPara, first, structure, match.Start);
-            },
-            next =>
-            {
-                // Остальные значения – в новые параграфы
-                var newPara = CloneParagraphProperties(original);
-                InsertFormattedRun(newPara, next, structure, match.Start);
                 resultParas.Add(newPara);
-                currentPara = newPara; // теперь текущий параграф – последний созданный
+                currentPara = newPara;
-            });
+
+                InsertFormattedRun(currentPara, item, structure, match.Start);
+
+                // Обработка смены ориентации
+                if (item.SplitValue == PageBreakType.NewLandscapeSection || item.SplitValue == PageBreakType.NewPortraitSection)
+                {
+                    bool addPageSize = (vIdx != 0);
+                    PageBreakType orientation = item.SplitValue;
+                    if (vIdx != 0)
+                    {
+                        orientation = PageBreakType.NewLandscapeSection;
+                    }
+                    AddSectionProperties(currentPara, orientation, addPageSize, sourceSection, portraitSection);
+                    lastOrientation = item.SplitValue;
+                    sectionChangeInsideGroup = true;
+                }
+                else if (item.SplitValue == PageBreakType.PageBreak)
+                {
+                    var seg = structure.Segments.FirstOrDefault(s => match.Start >= s.Start && match.Start < s.End);
+                    var breakRun = new Run(new Break { Type = BreakValues.Page });
+                    if (seg is not null && seg.Run.RunProperties is not null)
+                        breakRun.RunProperties = (RunProperties)seg.Run.RunProperties.CloneNode(true);
+                    currentPara.AppendChild(breakRun);
+                }
+            }
+
+            // Закрываем секцию, если была смена и последний параграф не имеет секции
+            if (sectionChangeInsideGroup && lastOrientation.HasValue && currentPara is not null)
+            {
+                if (currentPara.ParagraphProperties?.GetFirstChild<SectionProperties>() is null)
+                {
+                    bool addPageSize = (lastOrientation.Value == PageBreakType.NewLandscapeSection);
+                    AddSectionProperties(currentPara, lastOrientation.Value, addPageSize, sourceSection, portraitSection);
+                }
+            }
+
+            // Если исходная секция была landscape, внутри группы была смена, и последняя ориентация — книжная,
+            // добавляем landscape секцию в Body, чтобы остаток остался landscape.
+            if (body is not null)
+            {
+                var sourcePageSize = sourceSection.GetFirstChild<PageSize>();
+                if (sourcePageSize is not null)
+                {
+                    bool sourceIsLandscape = sourcePageSize.Orient?.Value == PageOrientationValues.Landscape ||
+                                             (sourcePageSize.Width?.Value > sourcePageSize.Height?.Value);
+                    bool lastIsPortrait = lastOrientation.HasValue && lastOrientation.Value == PageBreakType.NewPortraitSection;
+                    if (sourceIsLandscape && sectionChangeInsideGroup && lastIsPortrait)
+                    {
+                        // Проверяем, есть ли уже секция landscape на Body
+                        bool hasBodyLandscape = false;
+                        foreach (var bodySec in body.Elements<SectionProperties>())
+                        {
+                            var ps = bodySec.GetFirstChild<PageSize>();
+                            if (ps is not null && ps.Orient?.Value == PageOrientationValues.Landscape)
+                            {
+                                hasBodyLandscape = true;
+                                break;
+                            }
+                        }
+                        if (!hasBodyLandscape)
+                        {
+                            // Создаём секцию landscape для Body
+                            var bodySection = new SectionProperties();
+                            var pageSizeClone = (PageSize)sourcePageSize.CloneNode(true);
+                            // Если ориентация не landscape, меняем
+                            if (pageSizeClone.Orient?.Value != PageOrientationValues.Landscape)
+                            {
+                                pageSizeClone.SwapValues();
+                                pageSizeClone.Orient = PageOrientationValues.Landscape;
+                            }
+                            bodySection.AppendChild(pageSizeClone);
+                            var sourceMargin = sourceSection.GetFirstChild<PageMargin>();
+                            if (sourceMargin is not null)
+                            {
+                                var marginClone = (PageMargin)sourceMargin.CloneNode(true);
+                                // Если исходная секция не landscape, но мы делаем landscape, меняем поля
+                                if (sourceSection.GetFirstChild<PageSize>()?.Orient?.Value != PageOrientationValues.Landscape)
+                                {
+                                    marginClone.SwapBottomRight();
+                                }
+                                bodySection.AppendChild(marginClone);
+                            }
+                            bodySection.AppendChild(new SectionType { Val = SectionMarkValues.NextPage });
+                            body.AppendChild(bodySection);
+                        }
+                    }
+                }
+            }
 
             currentPos = match.End;
         }
 
-        // Текст после последнего совпадения – используем BuildAfterParagraph, чтобы пропустить лишние разрывы
+        // 6. Обработка остатка текста (если есть)
         if (currentPos < fullText.Length)
         {
-            var textPart = BuildAfterParagraph(original, structure, currentPos);
+            var remainderPara = BuildRemainderParagraph(original, structure, currentPos);
-            if (textPart is not null)
+            if (remainderPara is not null)
             {
-                if (currentPara is null)
+                // Если внутри группы была смена, применяем последнюю ориентацию к остатку
+                if (sectionChangeInsideGroup && lastOrientation.HasValue)
                 {
-                    currentPara = textPart;
+                    var breakRun = new Run(new Break { Type = BreakValues.Page });
-                    resultParas.Add(currentPara);
+                    remainderPara.InsertAt(breakRun, 0);
-                }
+                    bool addPageSize = (lastOrientation.Value == PageBreakType.NewLandscapeSection);
-                else
+                    AddSectionProperties(remainderPara, lastOrientation.Value, addPageSize, sourceSection, portraitSection);
-                {
-                    MergeParagraph(currentPara, textPart);
                 }
+                resultParas.Add(remainderPara);
             }
         }
 
-        // Удаляем пустые параграфы
+        // 7. Очистка пустых параграфов
         for (int i = resultParas.Count - 1; i >= 0; i--)
         {
-            if (!resultParas[i].ChildElements.OfType<Run>().Any() && resultParas[i].ParagraphProperties is null)
+            var p = resultParas[i];
+            if (!p.ChildElements.OfType<Run>().Any() && p.ParagraphProperties is null)
                 resultParas.RemoveAt(i);
         }
 
+        // Логирование
+#if DEBUG
+        if (body is not null)
+            LogDocumentStructure(body, "FINAL DOCUMENT STRUCTURE");
+#endif
+
         return resultParas.Count > 0 ? resultParas : null;
     }
 }

QWERTYkez.WordProcessor/ReplaceItem.cs

@@ -1,24 +1,70 @@
 namespace QWERTYkez.WordProcessor;
 
+/// <summary>
+/// Определяет тип разрыва или смены ориентации страницы, применяется к элементам следующим после замены
+/// </summary>
+public enum PageBreakType
+{
+    /// <summary>Без разрыва или смены ориентации.</summary>
+    None,
+
+    /// <summary>Обычный разрыв страницы (новый лист).</summary>
+    PageBreak,
+
+    /// <summary>Начать новую секцию с альбомной ориентацией страницы.</summary>
+    NewLandscapeSection,
+
+    /// <summary>Начать новую секцию с книжной ориентацией страницы.</summary>
+    NewPortraitSection,
+}
+
+/// <summary>
+/// Представляет элемент замены текста, содержащий сам текст и указание
+/// на тип разрыва или смены ориентации, который должен быть применён
+/// после вставки этого текста.
+/// </summary>
+/// <remarks>
+/// Используется в методах множественной замены, например,
+/// <see cref="IWordWriter.ReplaceItem(string, IEnumerable{ReplaceItem})"/>.
+/// </remarks>
 public readonly struct ReplaceItem
 {
+    /// <summary>
+    /// Инициализирует новый экземпляр <see cref="ReplaceItem"/> с пустым текстом
+    /// и типом разрыва <see cref="PageBreakType.None"/>.
+    /// </summary>
     public ReplaceItem() { }
-    public ReplaceItem(string text)
+
+    /// <summary>
+    /// Инициализирует новый экземпляр <see cref="ReplaceItem"/> с указанным текстом
+    /// и типом разрыва/смены ориентации.
+    /// </summary>
+    /// <param name="text">Текст, который будет вставлен вместо плейсхолдера.</param>
+    /// <param name="splitValue">
+    /// Тип разрыва или смены ориентации, который будет применён после вставки текста.
+    /// По умолчанию <see cref="PageBreakType.None"/>.
+    /// </param>
+    public ReplaceItem(string text, PageBreakType splitValue = PageBreakType.None)
     {
         Text = text;
-    }
+        SplitValue = splitValue;
-    public ReplaceItem(string text, bool breakPage)
-    {
-        Text = text;
-        BreakPage = breakPage;
     }
 
+    /// <summary>
+    /// Получает текст, который будет вставлен вместо плейсхолдера.
+    /// </summary>
     public string Text { get; init; } = string.Empty;
-    public bool BreakPage { get; init; } = false;
 
+    /// <summary>
+    /// Получает тип разрыва или смены ориентации, который будет применён
+    /// после вставки текста.
+    /// </summary>
+    public PageBreakType SplitValue { get; init; } = PageBreakType.None;
 
-    // Неявное преобразование из ReplaceItem в string
+    /// <summary>
-    //public static implicit operator string(ReplaceItem item) => item.Text;
+    /// Определяет явное преобразование из строки в <see cref="ReplaceItem"/>.
-    // Явное преобразование из string в ReplaceItem
+    /// </summary>
+    /// <param name="text">Строка текста.</param>
+    /// <returns>Новый экземпляр <see cref="ReplaceItem"/> с указанным текстом и <see cref="PageBreakType.None"/>.</returns>
     public static explicit operator ReplaceItem(string text) => new() { Text = text };
 }

QWERTYkez.WordProcessor/SimplyReplace.cs

@@ -9,7 +9,7 @@ internal static class SimplyReplaceExt
         internal readonly int Length = length;
     }
 
-    private sealed class ParagraphStructure(string fullText, SimplyReplaceExt.TextNodeInfo[] textNodes)
+    private sealed class ParagraphStructure(string fullText, TextNodeInfo[] textNodes)
     {
         internal readonly string FullText = fullText;
         internal readonly TextNodeInfo[] TextNodes = textNodes;
@@ -77,7 +77,7 @@ internal static class SimplyReplaceExt
         }
     }
 
-    internal static bool SimpleReplace(this Paragraph? paragraph, string oldValue, string newValue, StringComparison comparisonType, bool breakPage = false)
+    internal static bool SimpleReplace(this Paragraph? paragraph, string oldValue, string newValue, StringComparison comparisonType, PageBreakType splitValue = PageBreakType.None)
     {
         if (paragraph is null || string.IsNullOrEmpty(oldValue))
             return false;
@@ -103,10 +103,13 @@ internal static class SimplyReplaceExt
         if (nodesToReplace.Count == 0)
             return false;
 
-        ExecuteReplacement(nodesToReplace, matchIndex, matchEnd, newValue, breakPage);
+        ExecuteReplacement(nodesToReplace, matchIndex, matchEnd, newValue, splitValue);
         return true;
     }
 
+    internal static bool SimpleReplace(this Paragraph? paragraph, string oldValue, string newValue, StringComparison comparisonType, bool breakPage)
+        => SimpleReplace(paragraph, oldValue, newValue, comparisonType, breakPage ? PageBreakType.PageBreak : PageBreakType.None);
+
     internal static void Replace(this Paragraph paragraph, IEnumerable<KeyValuePair<string, string>> replacements, StringComparison comparisonType)
     {
         if (paragraph is null || replacements is null || replacements.Count() == 0)
@@ -120,10 +123,8 @@ internal static class SimplyReplaceExt
         if (structure.FullText.Length == 0)
             return;
 
-        // Используем List с предопределенной емкостью
         var replacementsInParagraph = new List<ReplacementInfo>(replacements.Count() * 2);
 
-        // Сначала находим все вхождения
         var fullText = structure.FullText;
         foreach (var kvp in replacements)
         {
@@ -137,7 +138,8 @@ internal static class SimplyReplaceExt
                 {
                     OldValue = kvp.Key,
                     NewValue = kvp.Value ?? string.Empty,
-                    Index = pos
+                    Index = pos,
+                    SplitValue = PageBreakType.None
                 });
                 pos += kvp.Key.Length;
             }
@@ -146,10 +148,8 @@ internal static class SimplyReplaceExt
         if (replacementsInParagraph.Count == 0)
             return;
 
-        // Сортируем по убыванию позиции
         replacementsInParagraph.Sort((x, y) => y.Index.CompareTo(x.Index));
 
-        // Выполняем замены
         for (int i = 0; i < replacementsInParagraph.Count; i++)
         {
             var replacement = replacementsInParagraph[i];
@@ -159,7 +159,7 @@ internal static class SimplyReplaceExt
             var nodesToReplace = FindNodesToReplace(structure, matchIndex, matchEnd);
             if (nodesToReplace.Count > 0)
             {
-                ExecuteReplacement(nodesToReplace, matchIndex, matchEnd, replacement.NewValue);
+                ExecuteReplacement(nodesToReplace, matchIndex, matchEnd, replacement.NewValue, replacement.SplitValue);
             }
         }
     }
@@ -177,10 +177,8 @@ internal static class SimplyReplaceExt
         if (structure.FullText.Length == 0)
             return;
 
-        // Используем List с предопределенной емкостью
         var replacementsInParagraph = new List<ReplacementInfo>(replacements.Count() * 2);
 
-        // Сначала находим все вхождения
         var fullText = structure.FullText;
         foreach (var kvp in replacements)
         {
@@ -194,8 +192,8 @@ internal static class SimplyReplaceExt
                 {
                     OldValue = kvp.Key,
                     NewValue = kvp.Value.Text ?? string.Empty,
-                    BreakPage = kvp.Value.BreakPage,
+                    Index = pos,
-                    Index = pos
+                    SplitValue = kvp.Value.SplitValue
                 });
                 pos += kvp.Key.Length;
             }
@@ -204,10 +202,8 @@ internal static class SimplyReplaceExt
         if (replacementsInParagraph.Count == 0)
             return;
 
-        // Сортируем по убыванию позиции
         replacementsInParagraph.Sort((x, y) => y.Index.CompareTo(x.Index));
 
-        // Выполняем замены
         for (int i = 0; i < replacementsInParagraph.Count; i++)
         {
             var replacement = replacementsInParagraph[i];
@@ -217,7 +213,7 @@ internal static class SimplyReplaceExt
             var nodesToReplace = FindNodesToReplace(structure, matchIndex, matchEnd);
             if (nodesToReplace.Count > 0)
             {
-                ExecuteReplacement(nodesToReplace, matchIndex, matchEnd, replacement.NewValue, replacement.BreakPage);
+                ExecuteReplacement(nodesToReplace, matchIndex, matchEnd, replacement.NewValue, replacement.SplitValue);
             }
         }
     }
@@ -227,7 +223,7 @@ internal static class SimplyReplaceExt
         internal string OldValue { get; set; } = null!;
         internal string NewValue { get; set; } = null!;
         internal int Index { get; set; }
-        internal bool BreakPage { get; set; }
+        internal PageBreakType SplitValue { get; set; } = PageBreakType.None;
     }
 
     private static ParagraphStructure AnalyzeParagraphStructure(IEnumerable<Run> runs)
@@ -291,7 +287,7 @@ internal static class SimplyReplaceExt
     int matchStart,
     int matchEnd,
     string newValue,
-        bool breakPage = false)
+    PageBreakType splitValue)
     {
         if (nodesToReplace.Count == 0) return;
 
@@ -311,22 +307,61 @@ internal static class SimplyReplaceExt
             processedNewValue
         );
 
-        // Очищаем остальные текстовые ноды
         for (int i = 1; i < nodesToReplace.Count; i++)
         {
             nodesToReplace[i].Text.Text = string.Empty;
         }
 
-        if (breakPage)
+        if (splitValue == PageBreakType.PageBreak)
         {
             if (nodesToReplace[0].Text.Parent is Run run && run.Parent is Paragraph para)
             {
-                var breakRun = new Run(new Break() { Type = BreakValues.Page });
+                var breakRun = new Run(new Break { Type = BreakValues.Page });
                 if (run.RunProperties is not null)
                     breakRun.RunProperties = (RunProperties)run.RunProperties.CloneNode(true);
                 para.AppendChild(breakRun);
             }
         }
+        else if (splitValue == PageBreakType.NewLandscapeSection || splitValue == PageBreakType.NewPortraitSection)
+        {
+            var firstText = nodesToReplace[0].Text;
+            if (firstText.Parent is Run run && run.Parent is Paragraph para)
+            {
+                AddSectionProperties(para, splitValue);
+            }
+        }
+    }
+
+    private static void AddSectionProperties(Paragraph para, PageBreakType splitValue)
+    {
+        if (para is null) return;
+        PageOrientationValues orientation = splitValue == PageBreakType.NewLandscapeSection
+            ? PageOrientationValues.Landscape
+            : PageOrientationValues.Portrait;
+
+        uint width, height;
+        if (orientation == PageOrientationValues.Landscape)
+        {
+            width = 16838;
+            height = 11906;
+        }
+        else
+        {
+            width = 11906;
+            height = 16838;
+        }
+
+        var sectionProps = new SectionProperties(
+            new PageSize
+            {
+                Width = width,
+                Height = height,
+                Orient = orientation
+            }
+        );
+
+        para.ParagraphProperties ??= new ParagraphProperties();
+        para.ParagraphProperties.AppendChild(sectionProps);
     }
 
     private static unsafe string ReplaceSpacesWithNonBreaking(string input)
@@ -358,7 +393,6 @@ internal static class SimplyReplaceExt
 
         int end = Math.Min(start + length, original.Length);
 
-        // Оптимизированная конкатенация
         var sb = new StringBuilder(original.Length - length + replacement.Length);
         if (start > 0)
         {

QWERTYkez.WordProcessor/WordReader.cs

@@ -21,7 +21,7 @@ internal class WordReader : IDisposable, IWordReader
 
     internal static WordReader? CreateInternal(FileInfo sourceFile)
     {
-        if (sourceFile is null || !sourceFile.Exists)
+        if (sourceFile is null || !File.Exists(sourceFile.FullName))
         {
 #if DEBUG
             Debug.WriteLine($"[DEBUG] Source file is null or does not exist: {sourceFile?.FullName}");

QWERTYkez.WordProcessor/WordWriter.cs

@@ -81,7 +81,7 @@ internal sealed class WordWriter : WordReader, IWordWriter
 
     internal static WordWriter? CreateInternal(FileInfo sourceFile, string? destinationPath = null!)
     {
-        if (sourceFile is null || !sourceFile.Exists) return null;
+        if (sourceFile is null || !File.Exists(sourceFile.FullName)) return null;
 
         var ms = new MemoryStream();
         try