Meridian Draw — спецификация приложения

Документ приложения по разделу 8 библии (docs/00-foundation.md). Версия 0.1 · 2026-10-03. Собственный формат: .mvx (шаблон .mvt, плоский XML .mvxf), пространство имён urn:meridian:office:draw:1, MIME application/vnd.meridian.draw. Цвет приложения --app-draw #0E8A8A, значок — узел-коннектор. Крейты ядра: kernel/crates/meridian-draw (документ: страницы, слои, трафареты, данные фигур), meridian-scene (общая графика сцены: фигуры, геометрия prstGeom/custGeom, стили, группы, текст в фигурах — делится со Slides/Write/Sheets), meridian-route (маршрутизация коннекторов), meridian-graph-layout (Sugiyama, деревья, круговая, радиальная, силовая), meridian-geom (булевы операции, упрощение, подгонка кривых, hit-testing; обёртка над kurbo), meridian-chart, meridian-codecs-{vsdx,vsd,svg,dxf,drawio,emf,odf}; оболочка — shell/src/draw/ (QML/C++); скрипты — meridian-script. Фаза по библии: 3 (12–22 мес от старта, вместе со Slides). Редакция: Feature::AppDraw (Home+); в Free документы Draw открываются на просмотр, печать и экспорт в PDF (см. §11); Feature::DrawVsdxExport и Feature::DrawStencilsPro — Pro.

Содержание

1. Назначение и аналоги
2. Функции (по группам, P0/P1/P2)
3. Экраны
4. Модель данных
5. Алгоритмы
6. MeridianScript API для Draw
7. Форматы
8. Горячие клавиши
9. Критерии готовности 1.0
10. Риски
11. Вопросы к библии

1. Назначение и аналоги

Meridian Draw — редактор векторной графики и схем: блок-схемы, UML/BPMN, организационные диаграммы, сетевые и электрические схемы, планы помещений, mind map, а также свободная векторная графика (кривые Безье, булевы операции, текст по пути). Главное отличие от «рисовалок» — коннекторы с автомаршрутизацией, трафареты с параметрическими фигурами и данные фигур, связанные с таблицами.

1.1 Аналоги

1.2 Чем Draw будет лучше — конкретно

1.3 Границы версии 1.0

В 1.0 — все P0. Бинарный .vsd, силовая раскладка, проверка диаграмм (validation), совместная работа, AWS/Azure-наборы и .cdr — P1/P2 по разделам ниже.

2. Функции

2.1 Документ и страницы

2.2 Слои

2.3 Сетка, линейки, направляющие, привязки

2.4 Фигуры и кривые

2.5 Булевы операции над контурами

2.6 Текст

2.7 Коннекторы

2.8 Трафареты и библиотеки

Трафарет — документ Draw с ролью stencil: набор мастеров (прототипов) с именем, описанием, значком, данными и поведением. Панель «Фигуры» (DR-10) показывает открытые трафареты, поиск по всем встроенным, «Избранное», «Недавние», «Мои фигуры» (личный трафарет, куда можно перетаскивать фигуры). Встроенные библиотеки 1.0:

2.9 Размерные линии

2.10 Контейнеры, списки, дорожки

2.11 Данные фигур и связывание

2.12 Автоматическая раскладка

2.13 Стили и темы

2.14 Изображения

Вставка растров и SVG (как в Slides §2.6–2.7), обрезка, коррекция, прозрачный цвет; «трассировка» растра в контуры (потенциальная функция Paint — P2); EMF/WMF импортируются как векторные группы.

2.15 Экспорт и импорт

2.16 Навигация и представление

2.17 Рецензирование и совместная работа

Комментарии к фигурам/страницам с ответами и статусом (P0), рукописные пометки (P1), сравнение страниц (P2); совместная работа CRDT (фаза 6, [Pro: CloudCollab]): сцена страницы — CRDT-карта узлов, присутствие, история версий.

2.18 Доступность

Дерево доступности: фигуры в порядке чтения (настраиваемом), текст, данные; alt-текст у фигур и страниц; полная клавиатурная навигация (переход между фигурами, по коннекторам «к следующей соединённой фигуре»); высокая контрастность; экспорт PDF/UA с тегами и описанием схемы; проверка доступности (P1).

2.19 Скрипты и Assist

Вкладка «Скрипты» ([Home+]), API §6, события (открытие, изменение данных, добавление фигуры, соединение); Assist ([Pro], фаза 7): «схема из текста» (описание процесса → блок-схема), автоподписи, перевод текста фигур.

3. Экраны

Идентификаторы: DR-01…DR-09 — главное окно, виды и режимы; DR-10…DR-19 — панели; DR-20…DR-59 — диалоги; DR-60…DR-69 — контекстные меню; DR-70+ — всплывающие элементы. Макет — mockups/draw.html.

3.1 DR-01 Главное окно

┌────────────────────────────────────────────────────────────────────────────────────────┐
│ [⌁] Сеть офиса.mvx — Meridian Draw                  [⌘K Поиск команд]  [☁ Сохранено] [👤] │
├────────────────────────────────────────────────────────────────────────────────────────┤
│ Файл  Главная  Вставка  Дизайн  Данные  Рецензирование  Вид  Скрипты        │ Коннектор │
│ [Буфер][Шрифт][Абзац][Сервис][Стили фигур][Упорядочение][Редактирование]            [⌄] │
├──────────────┬─────────────────────────────────────────────────────────┬───────────────┤
│ ФИГУРЫ       │   ╷0        ╷50       ╷100      ╷150 мм                   │ Данные фигуры │
│ 🔍 поиск     │ ─ ┌───────────────────────────────────────────────────┐  │ Имя: SW-01    │
│ ▸ Избранное  │ 0 │   ┌──────┐          ┌──────┐                      │  │ IP: 10.0.0.2  │
│ ▾ Сетевые    │   │   │Роутер│──────────│Коммут│──┐                   │  │ Стойка: A3    │
│  [▭][▭][▭]   │ 50│   └──────┘          └──┬───┘  │                   │  │ Порты: 48     │
│  [▭][▭][▭]   │   │                        │      └──▶┌──────┐        │  ├───────────────┤
│ ▸ Блок-схема │100│                  ┌─────┴────┐     │Сервер│        │  │ Слои          │
│ ▸ UML        │   │                  │  ПК ×12  │     └──────┘        │  │ ☑ 🔓 Сеть     │
│ ▸ Мои фигуры │   └───────────────────────────────────────────────────┘  │ ☑ 🔒 Фон      │
├──────────────┴──┬───────────┬───────────┬──────────────────────────────┴───────────────┤
│ ◂ ▸ │ Этаж 1 │ Этаж 2 │ Фон-рамка ▪ │ ⊕ │              [Внешние данные ▲]              │
├────────────────────────────────────────────────────────────────────────────────────────┤
│ Стр. 1 из 3 · Слой: Сеть · Выделено 2 · 120,0 × 45,0 мм · ∠0° · Масштаб 1:50 │ ─●─ 75 % ⤢ │
└────────────────────────────────────────────────────────────────────────────────────────┘

Холст: линейки сверху/слева (единицы чертежа, маркеры курсора), сетка, направляющие, страница с тенью; маркеры выделения (8 размерных, поворот, центр вращения, регуляторы, точки приклеивания при наведении с коннектором), синие стрелки AutoConnect (DR-71), подсветка фигуры-цели при приклеивании (рамка --app-draw), синяя пунктирная рамка контейнера при перетаскивании внутрь, подсказки координат/размеров/угла у курсора (--m-sun).

3.2 Остальные виды и режимы

3.3 Ribbon — вкладки и группы

3.4 Панели

3.5 Диалоги

4. Модель данных

4.1 Пакет .mvx

mimetype                        application/vnd.meridian.draw
manifest.xml                    части, версия, role = document | stencil | template
meta.xml                        Dublin Core + статистика (страницы, фигуры)
document.xml                    настройки документа: единицы, тема, порядок страниц, фоновые ссылки, стили маршрутизации по умолчанию
pages/page-<ulid>.xml           страница: размер, масштаб, слои, узлы (фигуры/группы/коннекторы/текст/изображения), направляющие
masters/master-<ulid>.xml       встроенные мастера (копии использованных мастеров трафаретов + свои)
stencil.xml                     только для role=stencil: список мастеров, порядок, значки, ключевые слова
styles.xml                      именованные стили фигур/линий/текста, стили размеров, стили данных
data/sources.xml                источники внешних данных и кэш строк (data/cache-<ulid>.msx)
media/<sha256>.<ext>            изображения, значки мастеров (thumbnails/master-<ulid>.png)
objects/chart-<ulid>.msx        данные диаграмм, objects/*.meq — формулы
thumbnail.png                   первая страница 256 px
history/, scripts/, signatures/, settings.xml

4.2 Структуры ядра (Rust, meridian-draw)

// kernel/crates/meridian-draw/src/model.rs
use meridian_scene::{Geometry, Fill, Line, Effects, TextBody, Theme, Transform2D};
use kurbo::{Affine, Point, Rect, Vec2};

pub struct Document {
    pub id: Ulid,
    pub role: DocRole,                              // Document | Stencil | Template
    pub pages: IndexMap<Ulid, Page>,                // порядок = порядок вкладок / tab order
    pub masters: IndexMap<Ulid, Master>,            // встроенные мастера / embedded masters
    pub styles: StyleSheet,                         // именованные стили / named styles
    pub theme: Theme,
    pub units: Units,                               // Mm | Cm | M | In | Ft | Pt | Px
    pub data_sources: Vec<DataSource>,
    pub routing_defaults: RoutingOptions,
    pub dim_styles: Vec<DimStyle>,
    pub meta: DocMeta,
}

pub struct Page {
    pub id: Ulid,
    pub name: String,
    pub kind: PageKind,                             // Foreground | Background
    pub background: Option<Ulid>,                   // фоновая страница / background page
    pub size: Size,                                 // в единицах страницы (мм) / page units
    pub scale: DrawingScale,                        // 1:50 → page_mm / drawing_unit
    pub auto_size: bool,
    pub layers: Vec<Layer>,
    pub nodes: SlotMap<NodeId, Node>,
    pub roots: Vec<NodeId>,                         // z-порядок корневых узлов / root z-order
    pub guides: Vec<Guide>,
    pub routing: RoutingOptions,
    pub index: RTree<NodeId>,                       // пространственный индекс (не сериализуется) / spatial index
    pub revision: u64,
}

pub struct Layer { pub id: LayerId, pub name: String, pub color: Option<Color>, pub visible: bool, pub locked: bool, pub printable: bool, pub snappable: bool, pub opacity: f32 }

pub struct Node { pub base: NodeBase, pub kind: NodeKind }

pub struct NodeBase {
    pub id: NodeId,
    pub name: String,
    pub layers: SmallVec<[LayerId; 2]>,
    pub transform: Affine,                          // локальные → родительские координаты / local → parent
    pub size: Size,                                 // локальный bbox 0..w, 0..h / local box
    pub style: StyleRef,                            // именованный стиль + переопределения / named + overrides
    pub fill: Option<Fill>, pub line: Option<Line>, pub effects: Option<Effects>,
    pub text: Option<TextBlock>,                    // текст + положение блока / text + block placement
    pub data: ShapeData,                            // §4.4
    pub master: Option<MasterRef>,                  // экземпляр мастера / master instance
    pub glue_points: Vec<GluePoint>,
    pub hyperlinks: Vec<Hyperlink>,
    pub locks: Locks,
    pub alt_text: AltText,
    pub parent: Option<NodeId>,
    pub container: Option<NodeId>,                  // членство в контейнере (не родитель!) / container membership
    pub ext: Vec<ExtensionBlob>,
}

pub enum NodeKind {
    Shape { geometry: Geometry, behaviour: ShapeBehaviour },          // 2D-фигура / 2D shape
    Line1D { geometry: Geometry, begin: Point, end: Point },          // 1D-фигура (стена, труба) / 1D shape
    Group { children: Vec<NodeId>, child_space: Rect },               // группа / group
    Connector(Connector),
    Text { body: TextBody, auto_size: AutoSize },                     // независимая надпись / standalone text
    TextOnPath { body: TextBody, path: Geometry, params: PathTextParams },
    Image { media: MediaRef, crop: Rect, effects: PicEffects },
    Container(Container),                                             // контейнер / список / дорожки
    Dimension(Dimension),
    Chart(ChartRef), Math(MathRef),
}

pub struct GluePoint { pub id: u16, pub pos: GluePos /* Abs(Point) | Rel(f64,f64) | Formula(GuideRef) */, pub dir: GlueDir /* Auto | Angle(f64) */, pub kind: GlueKind /* In | Out | InOut */, pub name: Option<String> }

pub struct Connector {
    pub routing: RoutingKind,                        // Straight | Orthogonal | Curved
    pub ends: [ConnectorEnd; 2],
    pub waypoints: Vec<Waypoint>,                    // ручные ограничения: Fixed{axis, value} | Point
    pub path: BezPath,                               // вычисленный маршрут (кэш, в мировых коорд.) / computed route
    pub path_rev: u64,                               // ревизия, на которой посчитан / revision of computation
    pub markers: (Marker, Marker),
    pub labels: Vec<ConnectorLabel>,                 // { text, t: 0..1, offset, rotate_along }
    pub jumps: JumpStyle,
    pub corner_radius: f64,
}
pub enum ConnectorEnd { Free(Point), Glued { node: NodeId, point: GlueRef /* Fixed(u16) | Dynamic */ } }

pub struct Master {
    pub id: Ulid, pub name: String, pub prompt: String, pub keywords: Vec<String>,
    pub icon: MediaRef,
    pub prototype: Page,                             // поддерево узлов в локальной системе / prototype subtree
    pub behaviour: ShapeBehaviour,                   // OneD/TwoD, scaling, text position, glue defaults
    pub data_defaults: Vec<DataField>,
    pub layers: Vec<String>,                         // слои, создаваемые при вставке / auto-created layers
    pub origin: MasterOrigin,                        // Builtin(stencil, ver) | User | Imported(vsdx, …)
    pub formulas: Option<FormulaSet>,                // параметрическое поведение (из vsdx или свои) / parametric rules
}
pub struct MasterRef { pub master: Ulid, pub overrides: Overrides }  // что изменено в экземпляре / instance overrides

Инварианты: roots и Group.children не пересекаются; container ссылается только на узел Container той же страницы; коннектор с Glued концами хранит NodeId, при удалении фигуры концы становятся Free с последней точкой; index перестраивается инкрементально (вставка/удаление/изменение bbox).

4.3 Страница в XML

<page xmlns="urn:meridian:office:draw:1" id="01J9R0…" name="Этаж 1" width="420mm" height="297mm" scale="1:50" units="m">
  <layers><layer id="1" name="Сеть" color="#0E8A8A"/><layer id="2" name="Фон" locked="true"/></layers>
  <nodes>
    <shape id="12" name="Роутер" layers="1" master="01J9R0M…" transform="1 0 0 1 40 60" w="30" h="18">
      <geom preset="roundRect"><adj name="adj" val="16667"/></geom>
      <text pos="below"><p><r>RT-01</r></p></text>
      <data><field name="IP" type="string">10.0.0.1</field><field name="Rack" type="string">A3</field></data>
      <glue><pt id="1" rel="0.5 0" dir="auto" kind="inout"/><pt id="2" rel="1 0.5"/><pt id="3" rel="0.5 1"/><pt id="4" rel="0 0.5"/></glue>
    </shape>
    <connector id="13" name="Линк 1" routing="orthogonal" layers="1">
      <end glued="12" point="2"/><end glued="15" point="dynamic"/>
      <waypoint axis="y" value="69"/>
      <marker end="arrow" size="m"/>
      <label t="0.5">1 Гбит/с</label>
      <path cache="M 70 69 L 110 69 L 110 95 L 140 95"/>
    </connector>
  </nodes>
  <guides><guide axis="x" value="40"/></guides>
</page>

Элемент <path cache> хранит последний вычисленный маршрут — документ открывается без немедленного пересчёта; пересчёт выполняется лениво при изменениях.

4.4 Данные фигур и связи

pub struct ShapeData { pub fields: IndexMap<SmolStr, DataField>, pub link: Option<DataLink> }
pub struct DataField { pub name: SmolStr, pub label: String, pub kind: DataKind, pub value: DataValue, pub format: Option<String>, pub prompt: String, pub hidden: bool, pub sort_key: u16, pub inherited: bool /* из мастера / from master */ }
pub enum DataKind { Str, Num, Currency(Iso4217), Date, Duration, Bool, FixedList(Vec<String>), VarList(Vec<String>) }
pub struct DataSource { pub id: Ulid, pub kind: SourceKind /* Sheets{path, sheet, range} | Xlsx{..} | Csv{path, delimiter} | Base{db, table|query} */, pub columns: Vec<Column>, pub key: Vec<usize>, pub refresh: RefreshPolicy, pub cache: Ulid /* data/cache-*.msx */ }
pub struct DataLink { pub source: Ulid, pub key: DataValue, pub last_sync: DateTime, pub state: LinkState /* Linked | Changed | Missing */ }
pub struct DataGraphic { pub rules: Vec<DataRule>, pub legend: bool }
pub enum DataRule { Text { field, pos: GraphicPos, style }, Icons { field, set: IconSet, thresholds: Vec<(Cmp, DataValue)>, pos }, FillByValue { field, scale: ColorScale }, Bar { field, min, max, pos } }

4.5 Трафарет как документ-библиотека

Трафарет — Document { role: Stencil }: страницы не используются, masters — содержимое, stencil.xml — порядок, группы, «быстрые фигуры». Открытый трафарет живёт в панели DR-10; вставка на холст копирует мастер в Document.masters документа (если такого (origin, version) ещё нет) и создаёт узел с MasterRef. Изменение мастера в трафарете не меняет документы автоматически; «Обновить из трафарета» сравнивает версии. Экземпляр хранит только Overrides (изменённые свойства) — размер, трансформация, текст, данные, стиль; геометрия и точки приклеивания берутся из мастера (при formulas — пересчитываются по размеру экземпляра, §5.14).

5. Алгоритмы

5.1 Ортогональная маршрутизация коннекторов

Вход: страница, коннектор с портами Port { pos, dir: Option<Dir> } (направление — из точки приклеивания или Auto), набор препятствий (bbox видимых узлов на слоях с snappable, кроме источника/цели и фигур, помеченных «не обходить»), RoutingOptions { shape_margin, line_gap, bend_penalty, crossing_penalty, stub_len, avoid_shapes }.

Шаг 1 — ортогональный граф видимости (OVG). Интересные координаты: для каждого препятствия x0−m, x1+m, y0−m, y1+m (m = shape_margin), для портов — их координаты и точка «отступа» pos + dir·stub_len. Через каждую интересную x проводится вертикальная линия, через каждую y — горизонтальная; линии обрезаются препятствиями (sweep line по отсортированным событиям, O((n + k) log n)). Узлы графа — пересечения оставшихся отрезков, рёбра — соседние узлы на одном отрезке. Для страницы с 2 000 фигур граф ≈ 10⁵ узлов; при маршрутизации одного коннектора область ограничивается прямоугольником портов, расширенным на 2 × наибольшую сторону препятствий (разворачивается до всей страницы, если путь не найден).

Шаг 2 — поиск A*. Состояние — (узел, направление входа), стоимость перехода: len + bend_penalty·[поворот] + crossing_penalty·crossings(ребро) + overlap_penalty·[совпадает с чужим сегментом]; эвристика — манхэттенское расстояние + bend_penalty·min_bends(узел → цель) (0, если на одной линии с портом и направление совпадает, иначе 1 или 2) — допустимая. Первый шаг — обязательно в направлении порта (stub); последний — вход в порт цели против его направления.

// kernel/crates/meridian-route/src/orthogonal.rs
pub fn route(ovg: &Ovg, src: Port, dst: Port, opt: &RoutingOptions, others: &SegmentIndex) -> Option<Vec<Point>> {
    let start = ovg.node_at(src.stub_point(opt.stub_len))?; let goal = ovg.node_at(dst.stub_point(opt.stub_len))?;
    let mut open = BinaryHeap::new(); let mut best: HashMap<(NodeIx, Dir), f64> = HashMap::new(); let mut came: HashMap<(NodeIx, Dir), (NodeIx, Dir)> = HashMap::new();
    open.push(State { f: h(ovg, start, goal, opt), g: 0.0, node: start, dir: src.dir_or_auto() });
    while let Some(s) = open.pop() {
        if s.node == goal { return Some(rebuild(&came, (s.node, s.dir), start, &src, &dst)); }
        if best.get(&(s.node, s.dir)).is_some_and(|&g| g < s.g) { continue; }
        for (next, dir, len) in ovg.neighbors(s.node) {
            let bend = if dir != s.dir { opt.bend_penalty } else { 0.0 };
            let cross = opt.crossing_penalty * others.crossings(ovg.segment(s.node, next)) as f64;
            let overlap = if others.overlaps(ovg.segment(s.node, next)) { opt.overlap_penalty } else { 0.0 };
            let g = s.g + len + bend + cross + overlap;
            if best.get(&(next, dir)).map_or(true, |&old| g < old) {
                best.insert((next, dir), g); came.insert((next, dir), (s.node, s.dir));
                open.push(State { f: g + h(ovg, next, goal, opt), g, node: next, dir });
            }
        }
    }
    None   // резерв: простой маршрут без обхода / fallback: simple route ignoring obstacles
}

Шаг 3 — пост-обработка. Удаление коллинеарных вершин; nudging: все сегменты всех коннекторов группируются по каналам (горизонтальный канал = интервал между соседними препятствиями по y), внутри канала сегменты упорядочиваются так, чтобы их концы не создавали новых пересечений (сортировка по положению предыдущего/следующего сегмента), затем раскладываются с шагом line_gap симметрично относительно центра канала; одиночный сегмент — по центру канала. Скругление углов (corner_radius) и перекрёстки (дуги радиуса jump_size в точках пересечения с коннекторами выше по z) применяются при построении BezPath.

Шаг 4 — инкрементальность. Препятствия — в RTree страницы. При изменении узла грязная область dirty = old_bbox ∪ new_bbox (с m). Пересчитываются: коннекторы, приклеенные к узлу (всегда), и коннекторы, чей path.bbox пересекает dirty. Во время перетаскивания — «быстрый режим»: только приклеенные коннекторы, маршрут Z/L-образный без обхода (< 0,1 мс), на каждом кадре. После отпускания (или через 60 мс простоя) — полный пересчёт в фоновом потоке (rayon) со снимком препятствий и ревизией страницы; результат применяется, если ревизия не изменилась, иначе отбрасывается и запускается заново. OVG кэшируется и обновляется локально (линии только в dirty).

Ручные ограничения. Waypoint::Fixed { axis: Y, value } требует, чтобы один горизонтальный сегмент лежал на y = value: маршрут ищется как два A*-прохода (порт → точка на линии, точка → порт) с перебором узлов OVG на этой линии в пределах окна; Waypoint::Point — обязательная вершина.

5.2 Прямые и кривые коннекторы

Прямой: отрезок между портами; при Dynamic конце — точка пересечения луча (центр цели → центр источника) с контуром цели (kurbo пересечение луча с BezPath по сегментам), чтобы линия заканчивалась на границе фигуры. Кривой: кубическая Безье P1 = P0 + d0·k·L, P2 = P3 − d3·k·L, где d — единичные направления портов (при Auto — по относительному положению: горизонтальное, если |Δx| ≥ |Δy|), L = |P3 − P0|, k = 0,4; при ручной правке — рукоятки редактируются как узлы Безье и запоминаются в waypoints.

5.3 Привязка и умные направляющие

Кандидаты (как в Slides §5.3) расширены: вершины и середины сегментов контуров, центры, точки приклеивания, пересечения направляющих, продолжения сторон (линии через стороны соседних фигур), сетка с динамическим шагом step = {1, 2, 5}·10ⁿ единиц чертежа такой, что step·zoom ≥ 12 px. Радиус привязки tol = 6 px / zoom, приоритет: точки приклеивания (при перетаскивании конца коннектора; подсветка точки и фигуры) > геометрия > направляющие > умные линии фигур > равные интервалы/размеры > сетка. Кандидаты собираются из R-дерева по окну viewport ∪ bbox(drag) и кэшируются на время операции. При рисовании линий — угловая привязка: angle = round(θ / 15°)·15° при Shift. Подсказка DR-73 показывает Δ и расстояние до ближайшей фигуры по оси движения.

5.4 Hit-testing

pub fn hit_test(page: &Page, p_world: Point, zoom: f64, mode: Mode) -> Option<Hit> {
    let tol = 3.0 / zoom;
    // 1. Ручки активного выделения — приоритет / handles of current selection first
    if let Some(h) = page.selection_handles().iter().find(|h| h.rect(zoom).contains(p_world)) { return Some(Hit::Handle(h.kind, h.index)); }
    // 2. Кандидаты из R-дерева, обход в обратном z-порядке / candidates from R-tree, top-most first
    for id in page.index.locate_at(p_world).sorted_by_z_desc() {
        let node = &page.nodes[id];
        if !page.layer_hittable(node) { continue; }
        let inv = page.world_transform(id).inverse();
        let p = inv * p_world;
        let hit = match &node.kind {
            NodeKind::Group { children, .. } => children.iter().rev().find_map(|c| hit_test_node(page, *c, p, tol)),
            NodeKind::Connector(c) => (c.path.nearest_distance(p_world) <= tol.max(c.line_width() / 2.0)).then(|| Hit::Connector(id, c.path.segment_at(p_world))),
            _ => hit_test_node(page, id, p, tol),
        };
        if hit.is_some() { return hit; }
    }
    None
}

fn hit_test_node(page: &Page, id: NodeId, p: Point /* локальные */, tol: f64) -> Option<Hit> {
    let node = &page.nodes[id];
    let paths = page.geometry_cache(id);                       // Vec<(BezPath, PathStyle)> в локальных координатах
    if let Some(tb) = node.text_block_rect() { if tb.contains(p) && node.has_text() { return Some(Hit::Text(id)); } }
    for (path, st) in paths {
        if st.fill != PathFill::None && node.has_fill() && path.winding(p) != 0 { return Some(Hit::Body(id)); }   // nonzero
        let w = if st.stroke { node.line_width() / 2.0 } else { 0.0 };
        if path.segments().any(|seg| seg.bounding_box().inflate(w + tol, w + tol).contains(p) && seg.nearest(p, 1e-3).distance_sq <= (w + tol).powi(2)) { return Some(Hit::Outline(id)); }
    }
    if node.has_fill_none_but_clickable() && node.local_box().contains(p) && page.option_click_transparent() { return Some(Hit::Body(id)); }
    None
}

Режим редактирования узлов проверяет сначала узлы и рукоятки (радиус 5 px), затем сегменты (для добавления узла двойным щелчком — ближайшая t). Выделение рамкой — пересечение/вхождение bbox (с учётом поворота — по контуру при Alt), лассо — точка-в-полигоне для центров либо пересечение контуров.

5.5 Булевы операции над контурами

Конвейер meridian-geom::boolean(op, a: &[BezPath], b: &[BezPath]) -> Vec<BezPath>:

1. Контуры приводятся в мировые координаты (аффинная трансформация точек Безье точна).
2. Флаттенинг каждого сегмента с допуском ε = 0,005 мм (kurbo::flatten), каждая точка помечается (contour, segment, t) — происхождение.
3. Полигональная операция — алгоритм Мартинеса–Руэды–Фейто (sweep line с событиями пересечения; устойчив к самопересечениям, касаниям и совпадающим рёбрам; поддерживает union/intersection/difference/xor; O((n+k) log n)). Реализация своя (в meridian-geom), с арифметикой в f64 после нормализации координат в единичный квадрат и «снапом» точек пересечения к сетке 2⁻³⁰; альтернатива для оценки на фазе прототипа — крейт i_overlay (целочисленный, устойчивый). Выбор фиксируется по результатам фаззинга (10⁶ случайных пар контуров без паник и с корректной площадью ± 10⁻⁶).
4. Восстановление кривых: цепочки точек результата, происходящие из одного исходного сегмента (одинаковые (contour, segment), монотонные t), заменяются точной подкривой segment.subsegment(t_a..t_b); точки пересечения уточняются решением curve_curve_intersections (kurbo) в окрестности приближённой точки. Участки, собранные из разных сегментов (не бывает при корректной операции, но бывает при снапе), подгоняются алгоритмом Шнайдера (§5.8).
5. Правило заливки результата — nonzero; ориентация внешних контуров — по часовой, отверстий — против.

«Разделить» = все грани планарного разбиения (xor + intersection всех пар с помощью той же развёртки — одна операция «overlay», возвращающая грани с метками принадлежности). «Обрезать» — разбиение открытых путей в точках пересечения (без заливки). Стиль результата — верхней фигуры; текст — верхней; данные — объединение полей.

5.6 Слоистая раскладка (Sugiyama)

// kernel/crates/meridian-graph-layout/src/sugiyama.rs
pub fn layout(g: &Graph, sizes: &[Size], o: &LayeredOptions) -> Vec<Point> {
    // 1. Удаление циклов: DFS, обратные рёбра переворачиваются (эвристика Eades–Lin–Smyth для плотных графов)
    let (dag, reversed) = break_cycles(g);
    // 2. Слои: longest-path, затем уплотнение сетевым симплексом (Gansner) при n ≤ 2000, иначе — Coffman–Graham с лимитом ширины
    let mut layers = assign_layers(&dag, o.width_limit);
    // 3. Длинные рёбра → цепочки фиктивных узлов / long edges → dummy node chains
    let (dag2, dummies) = insert_dummies(&dag, &mut layers);
    // 4. Минимизация пересечений: 24 прохода вниз/вверх медианной эвристикой + transpose, лучший результат сохраняется
    let order = minimize_crossings(&dag2, &layers, 24);
    // 5. Координаты: Brandes–Köpf (4 выравнивания, медиана) — прямые длинные рёбра, компактность
    let xs = brandes_koepf(&dag2, &layers, &order, sizes, o.node_gap);
    let ys = layer_positions(&layers, sizes, o.layer_gap);      // с учётом максимальной высоты в слое
    // 6. Удаление фиктивных узлов: их координаты → точки маршрута рёбер; обратные рёбра — восстановление направления
    finalize(xs, ys, dummies, reversed, o.direction)             // поворот для LR/BT/RL
}

Коннекторы после раскладки — ортогональные с портами «низ → верх» (по направлению), маршрутизация §5.1 с готовыми точками фиктивных узлов как Waypoint::Point (убирает лишние обходы). Сохранение порядка пользователя: начальный порядок в слоях — по текущим x (если раскладка повторная). Группы и контейнеры — как один узел (размер контейнера), внутри — рекурсивная раскладка.

5.7 Деревья, круговая, радиальная, mind map, силовая

• Дерево (Walker, в формулировке Buchheim–Jünger–Leipert, O(n)): предварительные x снизу вверх с «нитями» для контуров поддеревьев, смещения mod, второй проход сверху вниз; интервалы node_gap, level_gap; варианты для организационных диаграмм: «по сторонам» (дети в ряд), «вертикально» (дети колонкой под родителем со смещением — колонка занимает одну единицу ширины), «помощники» (отдельный слой между родителем и детьми, слева/справа от линии).
• Круговая: узлы на окружности R = max(n·(d + gap) / 2π, R_min); порядок — по барицентру соседей (3 итерации) для уменьшения пересечений хорд; связные компоненты — отдельные круги, упакованные по спирали.
• Радиальная: BFS от корня (или центра графа — узел минимального эксцентриситета); уровень k — окружность радиуса k·level_gap; угловые секторы распределяются пропорционально числу листьев поддерева; узлы размещаются в середине сектора; при переполнении окружности радиус увеличивается.
• Mind map: корень в центре; дети делятся на правую и левую группы жадно по суммарной высоте поддеревьев (балансировка); каждая сторона — Walker с горизонтальной ориентацией; коннекторы — кривые (Безье) из правой/левой точки приклеивания; цвет ветви наследуется.
• Силовая (P1): Fruchterman–Reingold, k = C·√(area/n), 300 итераций с охлаждением, Barnes–Hut (θ = 0,8) при n > 500, отталкивание с учётом размеров узлов (расстояние между bbox), фиксированные узлы по выбору пользователя, начальное положение — текущее.

5.8 Упрощение контуров и подгонка кривых

Карандаш: входные точки (с давлением) → Ramer–Douglas–Peucker с ε = 0,75 px / zoom → подгонка кубическими Безье по Шнайдеру (Graphics Gems, 1990): касательные на концах по соседним точкам, параметризация по хордам, подбор коэффициентов методом наименьших квадратов, оценка ошибки, при превышении ε_fit = 1,5 px / zoom — переразбиение в точке максимальной ошибки (рекурсивно, с перепараметризацией Ньютона–Рафсона до 4 итераций). Узлы результата — «гладкие». Команда «Упростить» для существующих кривых: флаттенинг → RDP → Шнайдер; ползунок допуска с предпросмотром. Для сглаживания штрихов в реальном времени — Catmull-Rom по последним 4 точкам (как в Notes).

5.9 Текст по пути

1. Раскладка текста движком text-layout в бесконечную строку → глифы с позициями x_i, ширинами adv_i.
2. Параметризация пути по длине дуги (kurbo::ParamCurveArclen): L = len(path); стартовое смещение s0 = start_offset + align(L − text_width) (Start → 0, Center → (L − w)/2, End → L − w).
3. Для глифа i: центр s_i = s0 + x_i + adv_i/2; t = inv_arclen(s_i); точка P = path.eval(t), касательная T = path.deriv(t).normalize(), нормаль N = T.rot90()·side; глиф ставится в P + N·(baseline_offset) с поворотом atan2(T.y, T.x), якорь — середина advance.
4. Глифы с s_i > L (текст длиннее пути) не рисуются; в режиме «замкнутый путь» — продолжают по кругу (s mod L).
5. Для рендера текст превращается в контуры глифов (SkPath из font.getPath) с трансформацией — так же экспортируется в SVG (<textPath>) и PDF (как текст с матрицами глифов, с сохранением извлекаемости).

5.10 Контейнеры и списки

Членство: при отпускании перетаскиваемых узлов — для каждого контейнера под курсором (сверху вниз) проверка «центр узла внутри тела контейнера» (или ≥ 50 % площади по настройке); при входе — base.container = Some(c), при выходе — None. Перемещение контейнера применяет ту же Δ ко всем членам (одной транзакцией undo); удаление — с членами (по подтверждению). Авторазмер: AlwaysFit — после каждой операции над членами bbox(members) + padding → размер контейнера (только рост при OnDrop). Список: члены упорядочены; при вставке вычисляется индекс по положению курсора вдоль оси списка; все члены перекладываются: pos_i = start + Σ_{j<i}(size_j + gap) с выравниванием по второй оси; при перетаскивании над списком показывается «место вставки» (оранжевая линия --m-sun), остальные члены раздвигаются (анимация 120 мс). Дорожки: пул — список контейнеров-дорожек; изменение ширины дорожки сдвигает последующие; фазы — вертикальные разделители пула с собственными заголовками. Коннекторы, входящие в контейнер, маршрутизируются с контейнером как препятствием только если «обходить контейнеры» включено (по умолчанию выключено — коннекторы входят внутрь).

5.11 Связывание с данными

pub fn refresh(doc: &mut Document, src_id: Ulid) -> RefreshReport {
    let src = doc.data_source(src_id);
    let rows = src.read()?;                                        // Sheets/CSV/xlsx/Base через кодеки
    let key_of = |r: &Row| src.key.iter().map(|&i| r[i].clone()).collect::<Vec<_>>();
    let mut by_key: HashMap<Vec<DataValue>, &Row> = rows.iter().map(|r| (key_of(r), r)).collect();
    let mut report = RefreshReport::default();
    for page in doc.pages.values_mut() {
        for node in page.nodes.values_mut().filter(|n| n.base.data.link.as_ref().is_some_and(|l| l.source == src_id)) {
            let link = node.base.data.link.as_mut().unwrap();
            match by_key.remove(&link.key) {
                Some(row) => { let changed = apply_row(&mut node.base.data, src, row); link.state = if changed { LinkState::Changed } else { LinkState::Linked }; report.updated += changed as usize; }
                None => { link.state = LinkState::Missing; report.missing += 1; }     // строка удалена / row removed
            }
        }
    }
    report.new_rows = by_key.into_keys().collect();                 // строки без фигур → «создать фигуры» / unlinked rows
    doc.update_cache(src_id, &rows);                                 // data/cache-<ulid>.msx для офлайн-открытия
    report
}

Политика конфликтов: поле, изменённое вручную после последней синхронизации (отметка времени на поле), при расхождении со строкой — вопрос пользователю (применить внешнее / оставить своё / для всех). «Автосвязь» — сопоставление по равенству значения поля фигуры и столбца-ключа. «Создать фигуры из строк» — мастер по умолчанию трафарета, раскладка §5.6/§5.7 при наличии столбца «родитель» (организационная диаграмма из таблицы: столбцы «Имя», «Руководитель», «Должность»).

5.12 Размерные линии

Dimension { kind, anchors: [Anchor; 2] /* Anchor = Free(Point) | NodePoint { node, point: GeomPointRef } */, offset, text_override, style }. Значение: v = |P2 − P1| · scale (линейный — проекция на ось), угловой — угол между лучами, радиус — от центра дуги (определяется по трём точкам контура). Геометрия размерной фигуры — параметрический контур (как custGeom с направляющими: выносные линии от якорей на offset, размерная линия, стрелки, текст по центру с зазором). Якоря NodePoint обновляются по событию изменения узла (подписка через индекс зависимостей node → dimensions). Текст — формат {value:0.0} мм с единицами чертежа, text_override может содержать <> для подстановки значения (как в CAD).

5.13 Рендер на Skia с кэшированием

Page → (видимые слои, порядок) → culling по viewport (R-tree) → DisplayList (ядро Meridian Render) → Skia

Кэши:

Dirty-rect: каждая операция ставит в очередь old_bbox ∪ new_bbox (мировые, с учётом эффектов — тень расширяет bbox на blur·3 + distance); кадр перерисовывает объединение прямоугольников через canvas.clipRect. Интерактивный слой (выделение, ручки, направляющие, «резиновый» маршрут при перетаскивании, подсказки) — отдельный QQuickItem поверх холста, не инвалидирует документ-слой. При панорамировании/масштабировании со скоростью > 1 экран/с — прогрессивный рендер: сначала кэшированные тайлы/растры с билинейным масштабированием, затем полная перерисовка через 80 мс простоя. Цель: 60 к/с при 10 000 фигур на странице при панорамировании, 60 к/с при перетаскивании фигуры с 50 коннекторами.

5.14 Подмножество формул ShapeSheet при импорте vsdx

Каждая ячейка vsdx имеет значение V и формулу F. Отображение строится по V (точно). Для «живого» поведения экземпляра (регуляторы, изменение размера с сохранением частей) интерпретируется подмножество F: операторы + − * / ^ & = <> < >, функции Width Height PinX PinY LocPinX LocPinY Angle FlipX FlipY TxtWidth TxtHeight, MIN MAX ABS SQRT SIN COS TAN ATAN2 PI INT ROUND MOD IF AND OR NOT GUARD SETATREF (игнор), ссылки Scratch.X1.., User.*, Prop.*, Controls.Row_N, Connections.X1, Geometry1.X1, ThePage!PageWidth, TheDoc!DocLangID (константа). Неподдерживаемые формулы (CALLTHIS, DEPENDSON, SETF, ссылки на другие фигуры Sheet.N!) — ячейка «замораживается» на V. Результат — FormulaSet мастера (§4.2); вычисление — топологическая сортировка зависимостей, пересчёт при изменении размера/регулятора (~ 50–300 ячеек на мастер, < 50 мкс).

6. MeridianScript API для Draw

Пространство имён meridian.draw. Одна скриптовая транзакция — один шаг отмены.

// Организационная диаграмма из таблицы Sheets / Org chart from a Sheets table
import { sheets, draw } from "meridian";
const rows = (await sheets.open("Сотрудники.msx")).sheet("Штат").range("A2:C200").values as [string, string, string][];
const doc = draw.activeDocument;
const page = doc.pages.add("Структура");
const stencil = await draw.Stencil.open("builtin:orgchart");
const byName = new Map<string, draw.Node>();
for (const [name, manager, title] of rows) {
  const n = stencil.masters.byName("Должность").drop(page, { x: 0, y: 0 });
  n.text.text = `${name}\n${title}`;
  n.data.set("Руководитель", manager);
  byName.set(name, n);
}
for (const [name, manager] of rows) if (byName.has(manager)) page.nodes.addConnector(byName.get(manager)!, byName.get(name)!, { routing: "orthogonal" });
draw.layout.tree(byName.get(rows[0][0])!, { direction: "down", levelGap: 20, nodeGap: 10, units: "mm" });
page.fitToContent();

// Экспорт всех страниц в SVG и PNG / Export every page to SVG and PNG
for (const p of draw.activeDocument.pages) {
  await p.export("svg", { path: `out/${p.name}.svg`, textAsPaths: false, layersAsGroups: true });
  await p.export("png", { path: `out/${p.name}.png`, dpi: 200, transparent: true });
}

// Перекраска сетевых устройств по данным и перемаршрутизация / Recolor by data and reroute
const page = draw.ui.activePage;
for (const n of page.nodes.select(n => n.master?.stencil === "network" && n.data.get("Статус") === "down")) n.fill = { color: "#C92A2A" };
for (const c of page.nodes.select(n => n.type === "connector")) (c as draw.Connector).reroute();

7. Форматы

7.1 .mvx

См. §4.1. Плоский .mvxf — один XML с теми же элементами и медиа в base64 (для git-диффов). Шаблон .mvt — пакет с ролью template. Трафарет — пакет с ролью stencil (расширение — см. §11).

7.2 SVG

Чтение: svg/g/path/rect/circle/ellipse/line/polyline/polygon/text/tspan/textPath/image/use/symbol/defs/linearGradient/ radialGradient/pattern/clipPath/mask/marker/style (CSS-подмножество: селекторы по тегу/классу/id, свойства представления), transform, viewBox, единицы; фильтры feGaussianBlur, feDropShadow → эффекты; прочие фильтры — растрируются (resvg) как изображение-резерв. Группы → группы; id/class → имя/теги; слои Inkscape (inkscape:groupmode="layer") → слои. Запись: страница → <svg viewBox> в мм; слои → <g data-m-layer="…">; фигуры → <path> (prstGeom разворачивается в путь) с data-m-preset/data-m-adj для обратного импорта; текст → <text> с font-family и резервом; коннекторы → <path> с маркерами <marker>; данные фигур → <metadata> (пространство имён urn:meridian:office:draw:1) при включённой опции; изображения — встроенные data: или ссылки.

7.3 VSDX (чтение P0, запись P1 [Pro])

OPC-пакет: visio/document.xml (стили, цвета, шрифты, DocumentSheet), visio/pages/pages.xml + pageN.xml (PageSheet: PageWidth/PageHeight/DrawingScale/PageScale/DrawingSizeType/ShdwOffsetX…/PageLineJumpDirX/LineJumpStyle/ LineRouteExt/RouteStyle/AvoidPageBreaks), Shapes/Shape (Type=Shape|Group|Guide|Foreign, Master, MasterShape, ячейки PinX/PinY/Width/Height/LocPinX/LocPinY/Angle/FlipX/FlipY/BeginX…EndY, секции Geometry (MoveTo LineTo ArcTo EllipticalArcTo Ellipse InfiniteLine NURBSTo SplineStart SplineKnot PolylineTo RelMoveTo RelLineTo RelCubBezTo RelQuadBezTo RelEllipticalArcTo → BezPath; NURBS → аппроксимация кубиками; NoFill/NoLine/NoShow), Character/Paragraph/Tabs/ TextBlock/TextXForm, Text с cp/pp/tp/fld, Connection (точки приклеивания X/Y/DirX/DirY/Type/AutoGen), Controls, Property (Prop.*: Label/Prompt/Type/Format/Value/SortKey/Invisible), User, Layer/LayerMember, Hyperlink, Protection, Actions (игнор), Connects/Connect (FromSheet/FromCell/ToSheet/ToCell/FromPart/ToPart), visio/masters/masters.xml + masterN.xml (наследование ячеек: пустая ячейка экземпляра = значение мастера — слияние при чтении), visio/theme/themeN.xml + ячейки QuickStyle*, visio/data/ (DataConnection, DataRecordSet, connections.xml, recordsets.xml → DataSource + кэш), comments.xml, windows.xml, validation.xml (P2), solutions/ (round-trip), media/. Единицы — дюймы (DrawingScale/PageScale); все координаты переводятся в мм. Запись (подмножество): страницы, фигуры с геометрией Geometry (из наших контуров), текст, стили, слои, коннекторы с Connect, данные Prop.*, мастера документа; формулы — только тривиальные (Width*0.5) для точек приклеивания.

7.4 VSD (бинарный, P1)

OLE2: поток VisioDocument (заголовок, таблица указателей на «chunks»: Shape, Page, Master, Text, Geometry, XForm, Line, Fill, Para, Char, Connect, Layer, Prop), сжатие LZ-подобное у части потоков, кодировки текста (UTF-16/ANSI), Visio 6 (2000/2002) и 11 (2003–2010) различаются структурами. Ориентир — поведение libvisio (MPL, не линкуем, собственная реализация на Rust). Чтение: страницы, мастера, фигуры (геометрия, стили, текст), коннекторы, слои, данные. Запись не планируется.

7.5 drawio

mxfile/diagram (несколько страниц; содержимое — mxGraphModel в открытом XML либо deflate + base64 + URL-encoding), mxCell (vertex/edge, parent для групп/слоёв — слой = дочерний mxCell корня 1), mxGeometry (x y width height, relative, sourcePoint/targetPoint, points — маршрут), style — строка key=value;… (shape=, rounded, whiteSpace, html, fillColor, strokeColor, strokeWidth, dashed, fontSize, fontFamily, align, verticalAlign, edgeStyle= orthogonalEdgeStyle|elbowEdgeStyle|entityRelationEdgeStyle, startArrow/endArrow, exitX/exitY/entryX/entryY — точки приклеивания, image=, shape=mxgraph.<lib>.<name>), value — HTML-разметка текста (подмножество → наш текст), UserObject с атрибутами → данные фигур. Сопоставление shape= → наши мастера: таблица для flowchart, basic, bpmn, uml, er, network/cisco, office, mscae/aws*/gcp*/azure (при наличии пакетов), electrical, floorplan, mockup, lean_mapping, sysml (частично); неизвестные — ближайшая базовая фигура + сохранение исходного style для экспорта обратно; встроенные image=data: — изображения. Экспорт (P1): обратная таблица, наши prstGeom → shape= draw.io, маршруты коннекторов → points.

7.6 DXF

Секции HEADER ($INSUNITS, $EXTMIN/$EXTMAX, $DIMSTYLE), TABLES (LAYER, LTYPE, STYLE, DIMSTYLE, BLOCK_RECORD), BLOCKS, ENTITIES (LINE, LWPOLYLINE с выпуклостью bulge → дуги, POLYLINE/VERTEX, CIRCLE, ARC, ELLIPSE, SPLINE (NURBS → кубики), TEXT, MTEXT (форматные коды \P \f \H \C — подмножество), INSERT (блоки → мастера/группы, масштаб/поворот/массивы), DIMENSION (из блока *D → группа линий + наша размерная линия при распознавании типа), HATCH (сплошная и простые паттерны ANSI31… → штриховки), SOLID, POINT, ATTRIB/ATTDEF → данные фигур), цвета ACI (256) и TrueColor, толщины, типы линий (DASHED и т.д. → штрихи), слои с OFF/FROZEN/LOCKED. Единицы по $INSUNITS, размер страницы по экстенту. Экспорт (P1): LWPOLYLINE/SPLINE/TEXT/LAYER/блоки из мастеров, версия AC1015 (2000) для совместимости.

7.7 EMF/WMF, ODG, CDR

EMF — записи GDI (EMR_POLYBEZIER*, EMR_POLYLINE*, EMR_RECTANGLE, EMR_ELLIPSE, EMR_ARC*, EMR_EXTTEXTOUTW, EMR_BITBLT/STRETCHDIBITS, пути BEGINPATH..ENDPATH, трансформации SETWORLDTRANSFORM, перья/кисти/шрифты; EMF+ (GDI+ записи внутри EMR_COMMENT) — базовые примитивы, остальные через GDI-дубли); WMF — 16-битные аналоги; запись EMF — собственный писатель (кроссплатформенный) для буфера обмена Windows и экспорта. ODG — ODF Drawing (draw:page, draw:layer-set, draw:custom-shape+draw:enhanced-geometry, draw:connector с draw:type line/lines/curve/standard и точками приклеивания draw:glue-point, draw:measure размерные линии, draw:text-box, draw:frame/draw:image, svg: атрибуты) — полное чтение/запись; трафареты — как draw:page с мастерами в отдельном .odg. CDR (P2) — RIFF-контейнер, подмножество версий X4–2021 (кривые, заливки, текст, страницы) по образцу libcdr.

8. Горячие клавиши

Схема по умолчанию: инструменты — как в Visio (Ctrl+цифра), остальное — общие соглашения пакета (см. docs/apps/slides.md §8).

Отличия от Office-схемы: Ctrl+H — отражение (как в Visio), замена — Ctrl+Shift+H; Ctrl+B/Ctrl+I/Ctrl+U действуют только в режиме редактирования текста. В схеме «LibreOffice» клавиши инструментов Ctrl+цифра не назначены.

9. Критерии готовности 1.0

10. Риски

11. Вопросы к библии

1. Расширение трафарета. В §3.2 библии у Draw только .mvx/.mvt/.mvxf. Трафарет здесь — пакет .mvx с manifest.xml/@role="stencil". Предложение: отдельное расширение .mvs (как .vssx у Visio), чтобы трафареты отличались в проводнике и Hub; MIME application/vnd.meridian.draw.stencil.
2. Free и Draw. Библия включает Draw в Home+. Принято здесь: в Free документы Draw (.mvx, .vsdx, .drawio, .svg) открываются для просмотра, печати и экспорта в PDF (принцип «документы никогда не блокируются»), редактирование — Feature::AppDraw. Нужно подтверждение.
3. Meridian Scene как именованный модуль. Крейт общей графики сцены (meridian-scene) используют Write, Sheets, Slides, Draw; предлагается добавить его в таблицу §2.2 библии и завести docs/algorithms/scene.md (см. также docs/apps/slides.md §11).
4. Экспорт vsdx и Pro. docs/10-licensing-accounts.md относит draw_vsdx_export к Pro, тогда как библия §3.3 указывает .vsdx в экспорте Draw без оговорок. Нужно решение, как и для slides_video_export.
5. Матрица форматов. В §3.3 библии у Draw в чтении нет .vssx (трафареты Visio) и .odg-трафаретов; предлагается добавить .vssx/.vssm в колонку «Чтение».