Контракт:
безопасный API ядра для окон (meridian-app-api)
| Владелец | K «Ядро» (по плану П1.5 — S0 «Платформа приложений», решение № 2 не принято) |
| Версия | 0 (черновик) — крейта ещё нет |
| Потребители | новые окна П3: S6b PDF-просмотр, S9 Slides, окно Math (S8); позже — Write и Sheets (Ф5) |
| Как менять | совместимое добавление — новая версия 0.x в этой шапке и строка в
разделе «Изменения» коммитом владельца; ломающее — сначала запись в
журналы дорожек-потребителей
(docs/sessions/lanes/<id>.md, «Следующей сессии»), их
согласие, затем правка с [касание <владелец>], если
правит не владелец. До версии 1 меняется свободно владельцем; с версии 1
— по общему правилу. |
Новый контракт (П0.6, 18.10.2026): пишется до того, как дорожки начнут им пользоваться.
Зачем
Сейчас все окна ходят в ядро через meridian-ffi — это и
C ABI, и Rust-API (205 unsafe в Write и Sheets). Новое окно
добавляло бы файл в ffi и функции в meridian.h. Правило П1:
новые окна зависят от meridian-app-api и никогда не
трогают meridian-ffi и meridian.h; C
ABI остаётся для Qt и внешних потребителей (ffi-abi.md).
Намеченная поверхность (уточнится в П1.5)
Document::open(path) -> Result<Document, AppApiError>,Document::save(&self, path, format);Document::pages() -> impl Iterator<Item = Page>,Page::size_emu();render_page(&Page, scale, &mut meridian_raster::Raster)— тот же растр, что у рендера ядра;- события изменений документа для перерисовки и автосохранения;
- без
unsafeв коде потребителя; ошибки — перечисление с текстом по-русски.
Изменения
- 18.10.2026 — черновик (П0.6).