docs(skd-compile): описать presentationExpression и appearance на поле

В DSL skd-compile уже поддерживались ключи presentationExpression и
appearance в объектной форме поля DataSet, но в SKILL.md они не были
задокументированы — фичи существовали де-факто, но обнаружить их можно
было только чтением скрипта.

Заодно зафиксирован детерминизм порядка ключей appearance: PS5.1
hashtable не сохраняет порядок вставки, из-за чего PS- и PY-рантаймы
давали разный XML на одном входе. Заменено на [ordered]@{}.

- SKILL.md: новый блок «Дополнительные ключи объектной формы» в разделе «Поля»
- skd-compile.ps1/py: appearance = [ordered]@{} вместо @{}, версия v1.19
- tests: новый snapshot-кейс field-appearance-and-presentation,
  проходит на обоих рантаймах

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Nick Shirokov
2026-04-25 17:57:04 +03:00
parent 1f23afe6f9
commit b39da27d20
5 changed files with 134 additions and 4 deletions
+9
View File
@@ -96,6 +96,15 @@ powershell.exe -NoProfile -File .claude/skills/skd-compile/scripts/skd-compile.p
В объектной форме: `"useRestriction": { "field": true, "condition": true, "group": true, "order": true }` или `"restrict": ["noField", "noFilter"]`.
Дополнительные ключи объектной формы:
- `"presentationExpression": "<выражение>"` — что показывать вместо значения поля. Исходное значение остаётся «под капотом» для перехода/расшифровки.
- `"appearance": { "<параметр>": "<значение>" }` — оформление колонки по умолчанию (применяется во всех вариантах настроек). Ключи — параметры платформы (`ГоризонтальноеПоложение`, `МинимальнаяШирина`, `Формат`, `Текст` и т.п.).
```json
{ "field": "Сумма", "title": "Сумма продажи", "type": "decimal(15,2)",
"appearance": { "ГоризонтальноеПоложение": "Right", "МинимальнаяШирина": "80" } }
```
### Вычисляемые поля (calculatedFields)
Shorthand: `"Имя [Заголовок]: тип = Выражение #noField #noFilter #noGroup #noOrder"` — все части кроме имени опциональны.
@@ -1,4 +1,4 @@
# skd-compile v1.18 — Compile 1C DCS from JSON
# skd-compile v1.19 — Compile 1C DCS from JSON
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
param(
[string]$DefinitionFile,
@@ -259,7 +259,7 @@ function Parse-FieldShorthand {
$result = @{
dataPath = ""; field = ""; title = ""; type = ""
roles = @(); restrict = @(); appearance = @{}
roles = @(); restrict = @(); appearance = [ordered]@{}
}
# Extract @roles
@@ -600,7 +600,7 @@ function Emit-Field {
type = if ($fieldDef.type) { Resolve-TypeStr "$($fieldDef.type)" } else { "" }
roles = @()
restrict = @()
appearance = @{}
appearance = [ordered]@{}
}
# Parse role
if ($fieldDef.role) {
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
# skd-compile v1.18 — Compile 1C DCS from JSON
# skd-compile v1.19 — Compile 1C DCS from JSON
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
import argparse
import json