| name | mxl-compile |
| description | 1C MXL layout - compile tabular document from JSON. |
$mxl-compile — Компилятор макета из DSL
Принимает компактное JSON-определение макета и генерирует корректный Template.xml для табличного документа 1С. Агент описывает что нужно (области, параметры, стили), скрипт обеспечивает корректность XML (палитры, индексы, объединения, namespace).
Использование
$mxl-compile <JsonPath> <OutputPath>
Параметры
| Параметр | Обязательный | Описание |
|---|
| JsonPath | да | Путь к JSON-определению макета |
| OutputPath | да | Путь для генерации Template.xml |
Команда
python .agents/skills/mxl-compile/scripts/mxl-compile.py -JsonPath "<путь>.json" -OutputPath "<путь>/Template.xml"
Рабочий процесс
- Агент пишет JSON-определение (Write tool) → файл
.json
- Агент вызывает
$mxl-compile для генерации Template.xml
- Агент вызывает
$mxl-validate для проверки корректности
- Агент вызывает
$mxl-info для верификации структуры
Если макет создаётся по изображению (скриншот, скан печатной формы) — сначала вызвать $img-grid для наложения сетки, по ней определить границы колонок и пропорции, затем использовать "Nx" ширины + "page" для автоматического расчёта размеров.
JSON-схема DSL
Полная спецификация формата: docs/mxl-dsl-spec.md (прочитать через Read tool перед написанием JSON).
Краткая структура:
{ columns, page, defaultWidth, columnWidths,
fonts: { name: { face, size, bold, italic, underline, strikeout } },
styles: { name: { font, align, valign, border, borderWidth, wrap, format } },
areas: [{ name, rows: [{ height, rowStyle, cells: [
{ col, span, rowspan, style, param, detail, text, template }
]}]}]
}
Ключевые правила:
page — формат страницы ("A4-landscape", "A4-portrait" или число). Автоматически вычисляет defaultWidth из суммы пропорций "Nx"
col — 1-based позиция колонки
rowStyle — автозаполнение пустот стилем (рамки по всей ширине)
- Тип заполнения определяется автоматически:
param → Parameter, text → Text, template → Template
rowspan — объединение строк вниз (rowStyle учитывает занятые ячейки)