mxl-compile

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"

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

1. Агент пишет JSON-определение (Write tool) → файл .json
2. Агент вызывает $mxl-compile для генерации Template.xml
3. Агент вызывает $mxl-validate для проверки корректности
4. Агент вызывает $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 учитывает занятые ячейки)