Mxl Compile

/mxl-compile — Компилятор макета из DSL

Принимает компактное JSON-определение макета (области, параметры, стили) → генерирует Template.xml табличного документа 1С: палитры, индексы, объединения, namespace.

Использование

Copy code
/mxl-compile <JsonPath> <OutputPath>

Параметры

Команда

powershellCopy code
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-compile.ps1" -JsonPath "<путь>.json" -OutputPath "<путь>/Template.xml"

Рабочий процесс

1. Написать JSON-определение (Write tool) → файл .json
2. Вызвать /mxl-compile для генерации Template.xml
3. Вызвать /mxl-validate для проверки корректности
4. Вызвать /mxl-info для верификации структуры

Если макет создаётся по изображению (скриншот, скан печатной формы) — сначала вызвать /img-grid для наложения сетки, по ней определить границы колонок и пропорции, затем использовать "Nx" ширины + "page" для автоматического расчёта размеров.

Что читать под задачу

Ниже — всё, что нужно для типового макета. Остальное лежит по файлу на задачу, читать нужно только свой:

Пример

jsonCopy code
{
  "columns": 5,
  "columnWidths": { "1": 5, "2": 40, "3-5": 12 },
  "fonts": { "жирный": { "face": "Arial", "size": 10, "bold": true } },
  "styles": {
    "шапка":  { "font": "жирный", "horizontalAlignment": "Center", "textPlacement": "Wrap", "border": "Solid" },
    "клетка": { "border": "Solid" },
    "число":  { "border": "Solid", "horizontalAlignment": "Right", "format": "ЧЦ=15; ЧДЦ=2" },
    "итог":   { "font": "жирный", "horizontalAlignment": "Right", "topBorder": "Solid" }
  },
  "areas": [
    { "name": "Заголовок", "rows": [
      { "height": 20, "cells": [{ "col": 1, "span": 5, "style": "шапка", "param": "ЗаголовокОтчёта" }] },
      {}
    ]},
    { "name": "ШапкаТаблицы", "rows": [
      { "rowStyle": "шапка", "cells": ["№", "Номенклатура", "Количество", "Цена", "Сумма"] }
    ]},
    { "name": "Строка", "rows": [
      { "rowStyle": "клетка", "cells": [
        { "col": 1, "param": "НомерСтроки" },
        { "col": 2, "param": "Товар", "detail": "Номенклатура" },
        { "col": 3, "style": "число", "param": "Количество" },
        { "col": 4, "style": "число", "param": "Цена" },
        { "col": 5, "style": "число", "param": "Сумма" }
      ]}
    ]},
    { "name": "Итого", "rows": [
      { "rowStyle": "итог", "cells": [null, null, null, "Итого:", "{Всего}"] }
    ]}
  ]
}

Шапка таблицы и итог записаны позиционно — позиция берётся из порядка, col не нужен; строка таблицы записана ячейками с col, потому что у них разные стили и расшифровка.

Структура DSL

Copy code
{ columns, page, defaultWidth, columnWidths, columnStyles, textLanguages,
  fonts:  { имя: { face, size, bold, italic, underline, strikeout } | { ref } },
  styles: { имя: { font, horizontalAlignment, verticalAlignment, textPlacement,
                   border, leftBorder, topBorder, rightBorder, bottomBorder,
                   borderColor, backColor, textColor, format } },
  areas: [{ name, columnSet, rows: [
    { height, hidden, rowStyle, empty, cells: [
      { col, span, rowspan, style, param, detail, text, template, note,
        valueType, controlType, value, pictureParameter } ] } ] }],
  namedAreas, columnSets, rowGroups, columnGroups, header, footer, printSettings,
  pictures, drawings
}

Верхний уровень: columns обязателен, остальное по необходимости.

Области, строки, ячейки

Область (areas[]) — диапазон подряд идущих строк: name (необязательно; с именем область доступна как Макет.ПолучитьОбласть("Имя")) и rows. Область без имени — просто кусок сетки.

Строка (rows[]): height, hidden, rowStyle, cells. Пустая строка — {}, а { "empty": 3 } заменяет три подряд. height и hidden — свойства самой строки, у ячейки таких нет.

Ячейка (cells[]):

Содержимое задаётся ровно одним ключом из param / text / template; ячейка без них — пустая (нужна, например, ради рамки). Пустая строка "text": "" — это тоже текст, а не отсутствие текста.

Короткая форма: список ячеек позиционно

Позиция берётся из порядка, col не нужен:

jsonCopy code
"rows": [
  ["Вид", "Остаток", ">", "Итог"],
  ["|",   "начало",  "конец", "|"],
  ["{Вид}", "{Нач}", "{Кон}", "{Итог}"]
]

Здесь «Вид» и «Итог» объединены по вертикали, «Остаток» — по горизонтали на две колонки.

Позиционный список — это форма записи ЯЧЕЕК, а не строки. Если у строки нет своих свойств, он и есть строка (как в примере выше). Если нужны height, hidden или rowStyle — тот же список кладётся в cells:

jsonCopy code
{ "rowStyle": "итог", "cells": [null, null, null, "Итого:", "{Всего}"] }

rowStyle — оформление строки

Стиль ложится на ВСЮ ширину строки: колонки без явных ячеек получают его тоже — так выходят сплошные рамки в табличной части. Он же становится оформлением самой строки. Ячейки с rowspan из предыдущих строк при этом пропускаются.

Оформление

Ячейка, строка и колонка ссылаются на один и тот же именованный стиль: ячейка — ключом style, строка — rowStyle, колонка — через columnStyles.

Шрифт (fonts.<имя>): face (Arial), size (10), bold, italic, underline, strikeout. Либо ссылка вместо описания: { "ref": "style:TextFont" }, { "ref": "sys:DefaultGUIFont" }. Шрифт "default" берётся, когда стиль не указал свой.

Частые ключи стиля — имя ключа совпадает с именем свойства в выгрузке, значения перечислений регистр не различают:

Рамка: "Solid" (ширина 1) либо { "style": "Solid", "width": 2 }. Стили линии: None, Solid, Dotted, Dashed, DashDotted, DashDottedDotted, ThinDashed, LargeDashed, ThickDashed, Double. Стороны можно задавать по отдельности всегда: совпавшие четыре компилятор свернёт сам.

Цвет — нотация платформы: #RRGGBB, style:ИмяСтиля (элемент стиля конфигурации), web:Имя, win:Имя. Несуществующее имя платформа отвергнет при загрузке.

jsonCopy code
"styles": {
  "шапка":  { "font": "жирный", "horizontalAlignment": "Center", "backColor": "#EBEBEB" },
  "рамка":  { "border": { "style": "Solid", "width": 2 } },
  "снизу":  { "bottomBorder": "Dotted" }
}