From be3a31ea94676e5e6e54f368c99561297ad4ba7e Mon Sep 17 00:00:00 2001
From: Nick Shirokov <nick_4312@mail.ru>
Date: Sun, 8 Feb 2026 14:25:11 +0300
Subject: [PATCH] Add advanced spreadsheet features: multiple column sets,
 verticalUnmerge, Rectangle areas
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Based on УКД (universal correction document) template analysis.
Multiple <columns> with UUID allow rows to use independent
column grids. Merges and named areas also reference column sets.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 docs/1c-spreadsheet-spec.md | 88 +++++++++++++++++++++++++++++++++++--
 1 file changed, 85 insertions(+), 3 deletions(-)

diff --git a/docs/1c-spreadsheet-spec.md b/docs/1c-spreadsheet-spec.md
index 456765d9..a330852b 100644
--- a/docs/1c-spreadsheet-spec.md
+++ b/docs/1c-spreadsheet-spec.md
@@ -20,7 +20,7 @@
 ```
 <document>
     <languageSettings>          — языковые настройки
-    <columns>                   — определения колонок
+    <columns> ...               — наборы колонок (один или несколько)
     <rowsItem> ...              — строки с данными (повторяются)
     <drawing> ...               — рисунки (опционально, повторяются)
     <templateMode>true          — признак макета
@@ -28,6 +28,7 @@
     <height>                    — общее количество строк
     <vgRows>                    — видимых строк (обычно = height)
     <merge> ...                 — объединения ячеек (повторяются)
+    <verticalUnmerge> ...       — отмена объединений (опционально)
     <namedItem> ...             — именованные области (повторяются)
     <line> ...                  — стили линий (повторяются)
     <font> ...                  — шрифты (опционально, повторяются)
@@ -64,6 +65,8 @@
 
 ## Колонки
 
+### Основной набор
+
 ```xml
 <columns>
     <size>33</size>              <!-- общее количество колонок -->
@@ -79,6 +82,30 @@
 
 Перечисляются только колонки с нестандартной шириной. Формат колонки определяет ширину через свойство `<width>` в палитре форматов.
 
+### Дополнительные наборы колонок
+
+Некоторые строки документа могут использовать **собственную сетку колонок**, отличную от основной. Каждый дополнительный набор имеет UUID:
+
+```xml
+<columns>
+    <id>f01e015f-de4c-4f97-9fbe-a244c4c30c6c</id>
+    <size>17</size>
+    <columnsItem>
+        <index>0</index>
+        <column>
+            <formatIndex>12</formatIndex>
+        </column>
+    </columnsItem>
+    ...
+</columns>
+```
+
+- Первый `<columns>` — основной набор (без `<id>`)
+- Дополнительные наборы — с `<id>` (UUID), могут иметь другое количество и ширину колонок
+- Строки, merge и namedItem ссылаются на набор через `<columnsID>`
+
+Типичное применение: сложные печатные формы (УПД, УКД), где шапка/подвал/табличная часть имеют разную разбивку на колонки.
+
 ## Строки и ячейки
 
 ### Строка
@@ -88,6 +115,7 @@
     <index>3</index>               <!-- индекс строки (0-based) -->
     <indexTo>5</indexTo>            <!-- опц.: диапазон [index..indexTo] с одинаковым содержимым -->
     <row>
+        <columnsID>f01e015f-...</columnsID>  <!-- опц.: набор колонок (UUID) -->
         <formatIndex>5</formatIndex>  <!-- опц.: формат строки (определяет высоту) -->
         <empty>true</empty>           <!-- опц.: пустая строка -->
         <c>...</c>                    <!-- ячейки (повторяются) -->
@@ -95,7 +123,8 @@
 </rowsItem>
 ```
 
-Строки с одинаковым содержимым объединяются через `<indexTo>`.
+- Строки с одинаковым содержимым объединяются через `<indexTo>`
+- `<columnsID>` привязывает строку к дополнительному набору колонок. Без него — используется основной набор
 
 ### Ячейка
 
@@ -164,15 +193,32 @@
 
 ```xml
 <merge>
-    <r>3</r>      <!-- строка (0-based) -->
+    <r>3</r>      <!-- строка (0-based), -1 = все строки -->
     <c>1</c>      <!-- колонка (0-based) -->
     <h>1</h>      <!-- доп. строк (опц., по умолчанию 0 = одна строка) -->
     <w>30</w>     <!-- доп. колонок -->
+    <columnsID>f01e015f-...</columnsID>  <!-- опц.: набор колонок -->
 </merge>
 ```
 
 Размер объединения: `(h + 1)` строк × `(w + 1)` колонок. Если `<h>` не указан — объединение в пределах одной строки.
 
+`<r>-1</r>` — объединение действует для всех строк, использующих данный набор колонок (аналог объединения колонок на уровне всего документа).
+
+### Отмена объединений
+
+`<verticalUnmerge>` отменяет вертикальное объединение для конкретной строки:
+
+```xml
+<verticalUnmerge>
+    <r>10</r>     <!-- строка (0-based) -->
+    <c>7</c>      <!-- колонка (0-based) -->
+    <w>12</w>     <!-- доп. колонок -->
+</verticalUnmerge>
+```
+
+Используется в сложных макетах, когда глобальное объединение колонок (`<r>-1</r>`) нужно разорвать в отдельных строках.
+
 ## Именованные области
 
 Именованные области — аналог «имён» в табличном документе 1С. Используются для программного вывода секций.
@@ -218,6 +264,42 @@
 </namedItem>
 ```
 
+### Тип Rectangle — прямоугольная область
+
+Область, ограниченная и по строкам, и по колонкам. Используется с дополнительными наборами колонок:
+
+```xml
+<namedItem xsi:type="NamedItemCells">
+    <name>ОбластьЗаписьДо</name>
+    <area>
+        <type>Rectangle</type>
+        <beginRow>22</beginRow>         <!-- 0-based -->
+        <endRow>22</endRow>
+        <beginColumn>5</beginColumn>    <!-- 0-based -->
+        <endColumn>17</endColumn>
+        <columnsID>c6cb0794-...</columnsID>  <!-- набор колонок -->
+    </area>
+</namedItem>
+```
+
+### Привязка к набору колонок
+
+Именованные области могут ссылаться на дополнительный набор колонок через `<columnsID>`:
+
+```xml
+<namedItem xsi:type="NamedItemCells">
+    <name>НумерацияЛистов</name>
+    <area>
+        <type>Rows</type>
+        <beginRow>59</beginRow>
+        <endRow>59</endRow>
+        <beginColumn>-1</beginColumn>
+        <endColumn>-1</endColumn>
+        <columnsID>0adf41ed-...</columnsID>
+    </area>
+</namedItem>
+```
+
 ### Тип Drawing — именованный рисунок
 
 ```xml