feat(form-decompile,form-compile): tooltip элемента + фикс экранирования текста (кластер ToolTip)

Два дефекта вокруг текста <v8:content>, оба вскрылись на формах с подсказками.

1. ToolTip элемента (484 LOST в корпусе). <ToolTip> — прямой мультиязычный
   текст подсказки на элементе (UsualGroup 42150, Popup, Page, InputField,
   и почти все типы). Декомпилятор пропускал (как companion), компилятор не
   эмитил. Введён общий ключ tooltip (string|{ru,en}), как title:
   - декомпилятор: захват в Add-CommonProps;
   - компилятор: эмиссия в Emit-Title (сразу после Title) — покрывает все
     эмиттеры, зовущие Emit-Title.
   Попутно выяснилось, что Emit-Pages/Emit-CommandBar вовсе не звали Emit-Title
   (теряли и Title, и ToolTip), а Emit-Label эмитит Title по-своему — во все три
   добавлена обработка title/tooltip.

2. Экранирование кавычек. Esc-Xml экранировал " → &quot; в тексте элемента,
   но 1С в <v8:content> пишет " литерально (экранирует только & < >).
   Это ломало раундтрип любого текста с кавычками. Убрано экранирование " .

Декомпилятор (ps1) + компилятор (ps1+py) + spec (§4.1 tooltip). Покрытие:
input-fields (input+tooltip), pages (pages/page tooltip, page с кавычкой в
тексте — проверяет литеральность) — сертифицировано в 1С 8.3.24. Раундтрип
БанковскиеСчета/Wildberries/АдреснаяКнига: ToolTip и &quot; остаток = 0.
Регресс ps+py 33/33.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.claude/skills/form-compile/scripts/form-compile.ps1

@@ -1,4 +1,4 @@
-# form-compile v1.34 — Compile 1C managed form from JSON or object metadata
+# form-compile v1.36 — Compile 1C managed form from JSON or object metadata
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 param(
 	[string]$JsonPath,
@@ -1515,8 +1515,11 @@ function X {
 }
 
 function Esc-Xml {
+	# Экранирование ТЕКСТА элемента (<v8:content>, <Value>): только & < > .
+	# Кавычки/апострофы в тексте экранировать НЕ нужно (1С их не экранирует — пишет литерально);
+	# &quot; ломал бы раундтрип. Кавычки спецсимвольны лишь в значениях атрибутов.
 	param([string]$s)
-	return $s.Replace('&','&amp;').Replace('<','&lt;').Replace('>','&gt;').Replace('"','&quot;')
+	return $s.Replace('&','&amp;').Replace('<','&lt;').Replace('>','&gt;')
 }
 
 # --- 4. Multilang helper ---
@@ -1956,7 +1959,7 @@ function Emit-Element {
 		# radio-specific
 		"radioButtonType"=1;"choiceList"=1;"columnsCount"=1;"checkBoxType"=1;"editMode"=1
 		# naming & binding
-		"name"=1;"path"=1;"title"=1
+		"name"=1;"path"=1;"title"=1;"tooltip"=1
 		# visibility & state
 		"visible"=1;"hidden"=1;"enabled"=1;"disabled"=1;"readOnly"=1;"userVisible"=1
 		# events ("events" — основной формат; on/handlers — legacy, принимаются ради совместимости)
@@ -2091,6 +2094,8 @@ function Emit-Title {
 	} elseif ($auto -and $name) {
 		Emit-MLText -tag "Title" -text (Title-FromName -name $name) -indent $indent
 	}
+	# ToolTip элемента (всплывающая подсказка) — по схеме сразу после Title.
+	if ($el.tooltip) { Emit-MLText -tag "ToolTip" -text $el.tooltip -indent $indent }
 }
 
 function Map-TitleLoc {
@@ -2525,6 +2530,7 @@ function Emit-Label {
 		Emit-MLItems -val $labelTitle -indent "$inner`t"
 		X "$inner</Title>"
 	}
+	if ($el.tooltip) { Emit-MLText -tag "ToolTip" -text $el.tooltip -indent $inner }
 
 	Emit-CommonFlags -el $el -indent $inner
 
@@ -2644,6 +2650,8 @@ function Emit-Pages {
 	X "$indent<Pages name=`"$name`" id=`"$id`">"
 	$inner = "$indent`t"
 
+	Emit-Title -el $el -name $name -indent $inner
+
 	if ($el.pagesRepresentation) {
 		X "$inner<PagesRepresentation>$($el.pagesRepresentation)</PagesRepresentation>"
 	}
@@ -2906,6 +2914,8 @@ function Emit-CommandBar {
 	X "$indent<CommandBar name=`"$name`" id=`"$id`">"
 	$inner = "$indent`t"
 
+	Emit-Title -el $el -name $name -indent $inner
+
 	if ($el.autofill -eq $true) { X "$inner<Autofill>true</Autofill>" }
 
 	Emit-CommonFlags -el $el -indent $inner

.claude/skills/form-compile/scripts/form-compile.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# form-compile v1.34 — Compile 1C managed form from JSON or object metadata
+# form-compile v1.36 — Compile 1C managed form from JSON or object metadata
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 import argparse
 import copy
@@ -1251,7 +1251,9 @@ def generate_chart_of_accounts_choice_dsl(meta, preset_data):
 
 
 def esc_xml(s):
-    return s.replace('&', '&amp;').replace('<', '&lt;').replace('>', '&gt;').replace('"', '&quot;')
+    # Экранирование ТЕКСТА элемента (<v8:content>, <Value>): только & < > .
+    # Кавычки/апострофы в тексте 1С не экранирует (пишет литерально) — &quot; ломал бы раундтрип.
+    return s.replace('&', '&amp;').replace('<', '&lt;').replace('>', '&gt;')
 
 
 def emit_ml_items(lines, indent, val):
@@ -1354,7 +1356,7 @@ KNOWN_KEYS = {
     "button", "picture", "picField", "calendar", "cmdBar", "popup",
     "showInHeader",
     "radioButtonType", "choiceList", "columnsCount", "checkBoxType", "editMode",
-    "name", "path", "title",
+    "name", "path", "title", "tooltip",
     "visible", "hidden", "enabled", "disabled", "readOnly", "userVisible",
     "events", "on", "handlers",
     "selectionMode", "showCurrentDate", "widthInMonths", "heightInMonths", "showMonthsPanel",
@@ -1673,6 +1675,9 @@ def emit_title(lines, el, name, indent, auto=False):
             emit_mltext(lines, indent, 'Title', el['title'])
     elif auto and name:
         emit_mltext(lines, indent, 'Title', title_from_name(name))
+    # ToolTip элемента (всплывающая подсказка) — по схеме сразу после Title.
+    if el.get('tooltip'):
+        emit_mltext(lines, indent, 'ToolTip', el['tooltip'])
 
 
 _TITLE_LOC_MAP = {'none': 'None', 'left': 'Left', 'right': 'Right', 'top': 'Top', 'bottom': 'Bottom', 'auto': 'Auto'}
@@ -2173,6 +2178,8 @@ def emit_label(lines, el, name, eid, indent):
         lines.append(f'{inner}<Title formatted="{formatted}">')
         emit_ml_items(lines, f'{inner}\t', label_title)
         lines.append(f'{inner}</Title>')
+    if el.get('tooltip'):
+        emit_mltext(lines, inner, 'ToolTip', el['tooltip'])
 
     emit_common_flags(lines, el, inner)
 
@@ -2301,6 +2308,8 @@ def emit_pages(lines, el, name, eid, indent):
     lines.append(f'{indent}<Pages name="{name}" id="{eid}">')
     inner = f'{indent}\t'
 
+    emit_title(lines, el, name, inner)
+
     if el.get('pagesRepresentation'):
         lines.append(f'{inner}<PagesRepresentation>{el["pagesRepresentation"]}</PagesRepresentation>')
 
@@ -2535,6 +2544,8 @@ def emit_command_bar(lines, el, name, eid, indent):
     lines.append(f'{indent}<CommandBar name="{name}" id="{eid}">')
     inner = f'{indent}\t'
 
+    emit_title(lines, el, name, inner)
+
     if el.get('autofill') is True:
         lines.append(f'{inner}<Autofill>true</Autofill>')
 

.claude/skills/form-decompile/scripts/form-decompile.ps1

@@ -1,4 +1,4 @@
-# form-decompile v0.14 — Decompile 1C managed Form.xml to JSON DSL (draft)
+# form-decompile v0.16 — Decompile 1C managed Form.xml to JSON DSL (draft)
 # Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
 # ВНИМАНИЕ: раундтрип не гарантируется. Навык исключён из авто-использования моделью.
 param(
@@ -239,6 +239,8 @@ function Add-CommonProps {
 		if ($null -ne $t) { $obj['title'] = $t }
 		# formatted у LabelDecoration выводится компилятором из hyperlink — отдельный ключ не нужен (#16 хвост)
 	}
+	$ttNode = $node.SelectSingleNode("lf:ToolTip", $ns)
+	if ($ttNode) { $tt = Get-LangText $ttNode; if ($null -ne $tt) { $obj['tooltip'] = $tt } }
 	$ev = Get-Events $node $elName
 	if ($ev) { $obj['events'] = $ev }
 }

docs/form-dsl-spec.md

@@ -116,6 +116,7 @@
 | `readOnly` | bool | `true` → `<ReadOnly>true</ReadOnly>` |
 | `events` | object | Обработчики событий: `{ "ИмяСобытия": "ИмяОбработчика" }` — тот же формат, что у событий формы (§3). Значение `null` → имя по конвенции (§4.2). См. §4.2 |
 | `titleLocation` | string | Расположение заголовка: `none`/`left`/`right`/`top`/`bottom`/`auto`. Эмитится при наличии (input, labelField, picField, table, calendar). У `check`/`radio` — особая семантика с умным дефолтом (см. их разделы) |
+| `tooltip` | string/object | Всплывающая подсказка элемента (`<ToolTip>`). Строка → ru, объект `{ "ru": …, "en": … }` → мультиязычный (как `title`). Эмитится сразу после `title` |
 
 ### 4.1a. Общие layout-свойства
 

tests/skills/cases/form-compile/input-fields.json

@@ -16,7 +16,7 @@
   "input": {
     "title": "Поля ввода",
     "elements": [
-      { "input": "ОбычноеПоле", "path": "ОбычноеПоле", "title": "Обычное поле", "editMode": "EnterOnInput" },
+      { "input": "ОбычноеПоле", "path": "ОбычноеПоле", "title": "Обычное поле", "tooltip": "Введите значение поля", "editMode": "EnterOnInput" },
       { "labelField": "Ссылка", "path": "ОбычноеПоле", "titleLocation": "left", "hyperlink": true },
       { "input": "МногострочноеПоле", "path": "МногострочноеПоле", "multiLine": true, "height": 5, "title": "Комментарий" },
       { "input": "ПолеПароля", "path": "ПолеПароля", "passwordMode": true, "title": "Пароль" },

tests/skills/cases/form-compile/pages.json

@@ -17,11 +17,11 @@
     "title": "Мастер настройки",
     "properties": { "autoTitle": false },
     "elements": [
-      { "pages": "СтраницыМастера", "pagesRepresentation": "None", "children": [
+      { "pages": "СтраницыМастера", "pagesRepresentation": "None", "tooltip": "Страницы мастера настройки", "children": [
         { "page": "Шаг1", "title": "", "children": [
           { "input": "Параметр1", "path": "Параметр1" }
         ]},
-        { "page": "Шаг2", "title": "Результат", "children": [
+        { "page": "Шаг2", "title": "Результат", "tooltip": "Шаг \"Результат\"", "children": [
           { "input": "Итог", "path": "Итог", "readOnly": true }
         ]}
       ]},

tests/skills/cases/form-compile/snapshots/input-fields/DataProcessors/ПоляВвода/Forms/Форма/Ext/Form.xml

@@ -17,6 +17,12 @@
 					<v8:content>Обычное поле</v8:content>
 				</v8:item>
 			</Title>
+			<ToolTip>
+				<v8:item>
+					<v8:lang>ru</v8:lang>
+					<v8:content>Введите значение поля</v8:content>
+				</v8:item>
+			</ToolTip>
 			<EditMode>EnterOnInput</EditMode>
 			<ContextMenu name="ОбычноеПолеКонтекстноеМеню" id="2"/>
 			<ExtendedTooltip name="ОбычноеПолеРасширеннаяПодсказка" id="3"/>

tests/skills/cases/form-compile/snapshots/pages/DataProcessors/Мастер/Forms/Форма/Ext/Form.xml

@@ -10,6 +10,12 @@
 	<AutoCommandBar name="ФормаКоманднаяПанель" id="-1"/>
 	<ChildItems>
 		<Pages name="СтраницыМастера" id="1">
+			<ToolTip>
+				<v8:item>
+					<v8:lang>ru</v8:lang>
+					<v8:content>Страницы мастера настройки</v8:content>
+				</v8:item>
+			</ToolTip>
 			<PagesRepresentation>None</PagesRepresentation>
 			<ExtendedTooltip name="СтраницыМастераРасширеннаяПодсказка" id="2"/>
 			<ChildItems>
@@ -30,6 +36,12 @@
 							<v8:content>Результат</v8:content>
 						</v8:item>
 					</Title>
+					<ToolTip>
+						<v8:item>
+							<v8:lang>ru</v8:lang>
+							<v8:content>Шаг "Результат"</v8:content>
+						</v8:item>
+					</ToolTip>
 					<ExtendedTooltip name="Шаг2РасширеннаяПодсказка" id="9"/>
 					<ChildItems>
 						<InputField name="Итог" id="10">