Контракт: C
ABI ядра (meridian-ffi, meridian.h)
| Владелец | K «Ядро» (kernel/crates/meridian-ffi; по плану 18.10 —
S0 «Платформа приложений», решение владельца № 2 не принято) |
| Версия | C ABI 0.18 (19.10.2026; книги Sheets — v0.12 от
18.10), MERIDIAN_ABI_VERSION = 1 — все добавления
совместимы |
| Потребители | S3 Write (ui/meridian-write), S4 Sheets
(ui/meridian-sheets/src/book.rs), S2 Hub (превью и поиск),
прежняя оболочка Qt (shell/) |
| Как менять | совместимое добавление — новая версия 0.x в этой шапке и строка в
разделе «Изменения» коммитом владельца; ломающее — сначала запись в
журналы дорожек-потребителей
(docs/sessions/lanes/<id>.md, «Следующей сессии»), их
согласие, затем правка с [касание <владелец>], если
правит не владелец. Новые окна (П1) идут через
meridian-app-api (app-api.md), а
не через новые функции здесь. |
Перенесено из
docs/sessions/CONTRACTS.md(разделы «A → B: C ABI» и «C → A», архив —docs/archive/2026-10/sessions-CONTRACTS.md) 18.10.2026, П0.6. A — прежняя сессия «Ядро», B — «Платформа», C — окно Sheets.
Текущий контракт (из раздела «A → B: C ABI ядра»)
Версия: 0.5 (2026-10-05) — рендер документов и книги
Sheets работают; ABI MERIDIAN_ABI_VERSION = 1 (добавления
совместимы). v0.3 добавила оглавление, новый документ по локали и
pub const MERIDIAN_EMU_PER_POINT в Rust-части. Имена
совпадают с shell/src/kernel/meridian_render.h: без
заглушки он просто подключает meridian.h.
MeridianDoc— непрозрачный;meridian_doc_open(const char *path_utf8, MeridianDoc **out) -> int32_t(docx, формат по содержимому; MOP.mwx— с кодеком MOP),meridian_doc_new(MeridianDoc **out)(одна пустая страница),meridian_doc_free(MeridianDoc *)(NULL допустим);meridian_doc_page_count(const MeridianDoc *) -> uint32_t; страницы нумеруются с нуля;meridian_doc_page_size(doc, page, int64_t *w_emu, int64_t *h_emu) -> int32_t;MERIDIAN_EMU_PER_POINT= 12 700;meridian_doc_render_page(doc, page, float scale, uint8_t *rgba, uint32_t stride, uint32_t w, uint32_t h) -> int32_t: RGBA8888 premultiplied, sRGB,strideв байтах (≥ w×4), строки сверху вниз (=QImage::Format_RGBA8888_Premultiplied);scale— пикселей на пункт, 0 < scale ≤ 100; страница от (0,0), остаток буфера — белый;meridian_doc_export_pdf(doc, const char *path_utf8) -> int32_t— PDF/A-2b со слоем текста;meridian_doc_new_locale(const char *locale_bcp47, MeridianDoc **out)(v0.3) — пустой документ с бумагой по локали:ru-RU→ A4 с полями Word 3/1,5/2/2 см, другие A4-страны → A4 с полями 2,54 см,en-US/en/Канада/Мексика и т. п. → Letter; NULL или""— какmeridian_doc_new;meridian_doc_outline_count(doc) -> uint32_t,meridian_doc_outline_item(doc, i, *level, *page, buf, cap, *written)(v0.3) — оглавление для панели «Навигация»: уровень 1–9 (w:outlineLvl+ 1), страница с нуля, текст UTF-8 без NUL; мал буфер —MERIDIAN_E_ARGUMENT, но*level,*page,*writtenзаполнены;meridian_doc_line_count(doc, page),meridian_doc_line(doc, page, i, *para, *x, *y, *w, *h, buf, cap, *len)(v0.5) — текст страниц для экранных чтецов: строки в порядке чтения (основной текст, затем колонтитулы), номер абзаца по документу, рамка в EMU, текст UTF-8; мал буфер —MERIDIAN_E_ARGUMENT, остальное заполнено;meridian_doc_line_kind(doc, page, i)(v0.6) — роль строкиMERIDIAN_LINE_*: основной текст, верхний/нижний колонтитул, сноска, концевая сноска;meridian_last_error(void) -> const char *— текст последней ошибки этого потока (UTF-8, до следующего вызова в потоке, не освобождать);- коды: 0 — успех;
MERIDIAN_E_IO−1,MERIDIAN_E_FORMAT−2,MERIDIAN_E_ARGUMENT−3,MERIDIAN_E_PAGE−4,MERIDIAN_E_PANIC−5 (паника ядра перехвачена, через границу не проходит); - потоки: документ можно рендерить из рабочего потока; вызовы для одного документа — последовательные;
- шрифты: комплект
kernel/fonts/(Liberation, Carlito) вшит в библиотеку, системные шрифты не нужны; - пример на C:
kernel/crates/meridian-ffi/examples/c/render_page.c, собирается и запускается тестомcargo test -p meridian-ffi --test c_example. - книги Sheets (v0.4) —
MeridianBook, свой движок формулmeridian-calcи свой xlsx:meridian_book_new(locale, **out)(один лист «Лист1»/«Sheet1»),meridian_book_open(path, locale, **out)(xlsx, пересчёт своим движком),meridian_book_save_xlsx(book, path)(значения, формулы, имена, числовые форматы),meridian_book_free; листы —sheet_count,sheet_name(book, sheet, buf, cap, *written),add_sheet(book, name|NULL, *index);used_range(book, sheet, *rows, *cols)(от A1, 0×0 — пусто); ячейки (лист, строка, столбец с нуля, предел ExcelMERIDIAN_MAX_ROWS×MERIDIAN_MAX_COLS):cell_text— текст для сетки по числовому формату в локали (1 234,50,ИСТИНА,#ДЕЛ/0!),cell_input— для строки формул (=СУММ(A1:A2;0,25),'007,04.10.2026),cell_value(*kind, *number)(MERIDIAN_VALIGN_*),set_input(book, sheet, row, col, text)— ввод как с клавиатуры в локали книги, затем пересчёт зависимых; ошибка в формуле —MERIDIAN_E_FORMAT, ячейка не меняется;set_format/cell_format— код Excel как в файле (#,##0.00,dd.mm.yyyy,0%; у «Общего»cell_formatотдаёт"", v0.4.1). Строки — вbuf/cap,*written— нужная длина (мал буфер —MERIDIAN_E_ARGUMENT, длина заполнена). Пример на C:examples/c/book.c(тот же тестc_example). - оформление ячеек (v0.5) —
MeridianCellStyle(флагиMERIDIAN_STYLE_*: жирный, курсив, подчёркнутый, зачёркнутый, перенос, заданы цвет/заливка; цвет и заливка0xRRGGBB, кегль в сотых пункта, гарнитура UTF-8 с NUL, выравнивание по горизонтали и вертикали, отступ, четыре границы — вид и цвет),meridian_book_cell_style(book, sheet, row, col, *out),meridian_book_set_cell_style(book, sheet, r1, c1, r2, c2, style|NULL)— область; NULL снимает;meridian_book_range_styles(book, sheet, r1, c1, r2, c2, out, cap)— оформление области построчно одним вызовом. Оформление и шрифт книги по умолчанию читаются из xlsx и пишутся в него. - строки, столбцы, копирование (v0.5) —
meridian_book_insert_rows/delete_rows/insert_cols/delete_cols(book, sheet, at, n): ссылки во всех формулах, именах и таблицах сдвигаются как в Excel (диапазон через место вставки расширяется, ссылка на удалённое —#REF!), форматы и оформление переезжают, книга пересчитывается;meridian_book_copy_cell(book, sheet, from_row, from_col, to_row, to_col)— формула со сдвигом относительных ссылок, значение, формат и оформление. - разметка листа и поиск (v0.5) — ширины столбцов
(
meridian_book_col_width/set_col_width, символы, по умолчанию 8,43) и высоты строк (row_height/set_row_height, пункты, по умолчанию 15; отрицательное — сброс), скрытие (is_hidden/set_hidden), объединения (merge_count,merge_at,merge— пересекающиеся снимаются, ячейки кроме левой верхней очищаются,unmerge), поиск «Найти далее»meridian_book_find(флагиMERIDIAN_FIND_*: регистр, ячейка целиком, в формулах). Всё сохраняется в xlsx и сдвигается при вставке/удалении строк и столбцов. - снимок для отмены (v0.5) —
meridian_book_snapshot(book) -> MeridianBookSnapshot*(полная копия; формулы делят разобранные выражения),meridian_book_restore(book, snap)(снимок остаётся),meridian_book_snapshot_free. - закрепление и автофильтр (v0.6) —
meridian_book_freeze/set_freeze(book, sheet, rows, cols)(0 и 0 — снять),meridian_book_autofilter/set_autofilter(book, sheet, has, r1, c1, r2, c2), значения фильтра по столбцу листа:filter_value_count,filter_value,set_filter_values(book, sheet, col, values, n)(n= 0 — снять). Сохраняются в xlsx и сдвигаются при вставке/удалении; строки скрывает окно, ядро хранит условие. - условное форматирование (v0.7) —
MeridianCondRule(видMERIDIAN_COND_*: значение сop0–7, текст содержит, повторы, уникальные, цветовая шкала 2–3 точки, гистограмма; до 8 областей; формулы сравнения в локали книги; формат — флагиMERIDIAN_STYLE_BOLD/ITALIC/COLOR/FILL,MERIDIAN_COND_STOP),meridian_book_cond_count,cond_rule(book, sheet, i, out),cond_add(последним),cond_remove,cond_clear. Сохраняются в xlsx (conditionalFormatting,dxfs) и сдвигаются при вставке/удалении; применяет правила окно. - печать листа (v0.7) —
MeridianPageSetup(альбомная, код бумаги Excel, масштаб 10–400 % или «вписать вfit_width×fit_heightстраниц», сетка, заголовки, центрирование, поля в мм, область печати),meridian_book_page_setup/set_page_setup(xlsx:pageSetup,pageMargins,printOptions,_xlnm.Print_Area);meridian_book_print_page_count(book, sheet, row_breaks, n_rows, col_breaks, n_cols, *count)иmeridian_book_export_pdf(book, sheet, path, row_breaks, n_rows, col_breaks, n_cols)— векторный PDF/A-2b (страницы сначала вниз, потом вправо; ручной разрыв — новая страница с этой строки/столбца). - операции с листами (v0.8) —
meridian_book_rename_sheet(book, sheet, name)(ссылки следуют за листом),delete_sheet(ссылки —#ССЫЛКА!, единственный нельзя),move_sheet(book, from, to)(ссылки сохраняются),sheet_hidden/set_sheet_hidden(последний видимый скрыть нельзя); всё сохраняется в xlsx. - каталог функций (v0.8) —
meridian_function_count(locale),meridian_function_info(locale, i, out)→MeridianFunctionInfo(имя и подпись в локали, категория, описание по-русски), по порядку местных имён. - подсказка формулы (v0.9) —
meridian_formula_hint(locale, text, len, caret, out)→MeridianFormulaHint(функция под кареткой в локали и её номер в каталоге, номер аргумента с нуля, недописанное имя перед кареткой); строки, имена листов в кавычках, константы{…}и вложенные скобки учитываются. - пользовательский автофильтр (v0.9) —
MeridianFilterCond(MERIDIAN_FILTER_CUSTOM: одно-два условия И/ИЛИ, операторы 0–11 — сравнения, начинается/заканчивается/содержит и их отрицания;MERIDIAN_FILTER_TOP10: первые или последние N элементов или N %),meridian_book_filter_cond/set_filter_cond(book, sheet, col, …)— в xlsxcustomFiltersиtop10;meridian_book_filter_row_visible(book, sheet, row)— строка по всем условиям. - автоподбор высот строк (v0.10) —
meridian_book_auto_row_heights(book, sheet, r1, r2, heights, custom): заданная высота (custom= 1) или автоподбор по кеглю и переносу, как Excel и печать (custom= 0), скрытая — 0. - колонтитулы листа (v0.10) —
meridian_book_header_footer(book, sheet, which, buf, cap, *written)иset_header_footer(book, sheet, which, text)(0 — верхний, 1 — нижний; коды Excel&L &C &R &P &N &D &T &A): xlsxheaderFooter, печать в PDF листа. - разрывы страниц листа (v0.12) —
meridian_book_page_breaks(book, sheet, rows, buf, cap, *n)иset_page_breaks(book, sheet, rows, breaks, n):rows1 — по строкам, 0 — по столбцам; номера с нуля строк или столбцов, с которых начинается новая страница (этоbrk/@idxlsx), по возрастанию;setзаменяет все (0 и выход за лист —MERIDIAN_E_ARGUMENT, до 1026,n == 0— убрать). Хранятся в xlsx, сдвигаются при вставке и удалении строк/столбцов; окно передаёт их вprint_page_count/export_pdf. Автоматические разрывы файла не хранятся. - примечания (v0.10) —
meridian_book_comment_count/comment_at/comment(book, sheet, row, col, 0 текст | 1 автор, …)иset_comment(book, sheet, row, col, text|NULL, author); xlsxcomments+ VML, сдвиг со строками и столбцами. - таблицы ListObject (v0.11) —
meridian_book_table_count/table_at(book, i, out)→MeridianDocTableInfo(имя, лист, область, строки заголовка/итогов, стиль и полосы),add_table(book, sheet, r1, c1, r2, c2, has_header, style, *index),remove_table(book, i),set_table_style(book, i, style, first, last, row_stripes, column_stripes). - строка итогов таблицы (v0.12) —
meridian_book_set_table_totals(book, i, on): строка под таблицей становится итогами (занятая — сначала вставляется строка листа), «Итог»/«Total» в первом столбце, СУММ видимых строк в последнем числовом (иначе количество); выключение очищает ячейки итогов.set_table_total_fn(book, i, col, func)иtable_total_fn(book, i, col, *func): 0 нет, 1 сумма, 2 среднее, 3 количество, 4 количество чисел, 5 максимум, 6 минимум, 7 стандартное отклонение, 8 дисперсия (SUBTOTAL109/101/103/102/104/105/107/110). xlsx:totalsRowCount,totalsRowFunction,totalsRowLabel— читаются и пишутся. - проверка данных и гиперссылки листа (v0.12) —
meridian_book_validation_count/at/text/find(MeridianValidation: первая область, число областей, вид, оператор, флаги, вид сообщения; строки — формулы в локали, подсказка, ошибка, все области),validation_list_items(book, sheet, row, col, …)— строки выпадающего списка (ссылка на диапазон вычисляется),validate_input(book, sheet, row, col, text, *ok, buf…)— до записи ввода,add_validation(снимает прежние правила с этих ячеек) /remove_validation;meridian_book_hyperlink(…, which)— адрес, место в книге, подсказка, текст иset_hyperlink. xlsx:dataValidations,hyperlinks— разобраны, сдвигаются со строками и столбцами. - правка Write (v0.9, запрос D) —
MeridianDocдержитmeridian_edit::Editor; после команды — перевёрстка,meridian_doc_revisionрастёт. Ввод:meridian_doc_insert_text(doc, utf8, len)(и итог IME),paste_text,meridian_doc_key(doc, MERIDIAN_KEY_*, MERIDIAN_MOD_*); курсор:meridian_doc_move(doc, MERIDIAN_MOVE_*, extend)(символ, слово, строка вверх/вниз, Home/End по вёрстке, абзац, документ),meridian_doc_click(doc, page, x, y, clicks, extend)(1 — курсор, 2 — слово, 3 — абзац),select_all; вид:meridian_doc_caret_rect(doc, *page, *x, *y, *h),meridian_doc_selection_rects(doc, page, out, cap, *n)→MeridianRect; оформление:meridian_doc_toggle/is_on(MERIDIAN_TOGGLE_*),set_alignment; отмена:undo/redo(doc, *done),can_undo/can_redo,undo_label;selected_text; файлы:meridian_doc_save_mwx(doc, path, password),meridian_doc_openузнаёт .mwx, зашифрованный →MERIDIAN_E_PASSWORD(−6) иmeridian_doc_open_with_password. docx с паролем Office (MS-OFFCRYPTO) — так же:MERIDIAN_E_PASSWORD, затемmeridian_doc_open_with_password(пароль Office по умолчанию ядро пробует само). - сохранение в docx (v0.12) —
meridian_doc_save_docx(doc, path): своя записьcodec_ooxml::write_docx(модель → WordprocessingML); всё, что ядро читает из docx, пишется обратно — круговой путьread_docx(write_docx(d)) == dна всех 393 открываемых docx корпуса, повторная запись даёт те же байты. С паролем Office —meridian_doc_save_docx_with_password(doc, path, password)(Agile: SHA-512, AES-256-CBC, 100 000 повторов, HMAC-SHA512 целостности, как Office 2013–365); открывается в Word и LibreOffice с паролем, в ядре —meridian_doc_open_with_password. Пустой пароль —MERIDIAN_E_ARGUMENT. - сохранение в OpenDocument (v0.13) —
meridian_doc_save_odt(doc, path): своя записьcodec_odf::write_odt(ODF 1.3: стили, списки, таблицы, картинки, рамки, колонтитулы, разделы, сноски, ссылки, закладки, примечания; диаграммы и объекты OLE — их картинкой-превью). Пункт «OpenDocument (.odt)» в «Сохранить как». Вёрстка Word передаётся флагами совместимости LibreOffice; записанные .odt корпуса открываются в LibreOffice все. Чтение .odt — следующим шагом (meridian_doc_openузнает его поmimetype). - ссылки и примечания Write (v0.12) —
meridian_doc_link_at(doc, page, x, y, buf, cap, *written): гиперссылка под точкой (адрес или#закладка, пусто — нет);meridian_doc_goto_bookmark(doc, name)— курсор в начало закладки. Примечания по порядку значков в тексте:meridian_doc_comment_count,comment_text(doc, i, which, …)(0 текст, 1 автор, 2 инициалы, 3 дата),comment_state(doc, i, *parent, *done, *page, *x, *y)(ответ на, закрыто, место значка;page = UINT32_MAX— значка нет). Правка ссылок и примечаний — команды D (Editor). - правка ссылок, закладок и примечаний Write (v0.12)
—
meridian_doc_insert_link/edit_link/remove_link/ link_at_caret,valid_bookmark_name,insert_bookmark/remove_bookmark/bookmarks,add_comment/reply_comment/ set_comment_done/delete_comment(номера примечаний — порядокcomment_*, дата нового — текущая UTC). Командыmeridian_edit::editor::refs(D) с отменой. - лента Write (v0.10) — стили документа
meridian_doc_style_count/style_info→MeridianStyleInfo(id, имя, вид),meridian_doc_set_para_style(doc, id|NULL),meridian_doc_set_font(doc, family|NULL, size_half_points|0),meridian_doc_set_color(doc, rgb),meridian_doc_clear_char_prop(doc, 1 цвет | 2 кегль | 3 шрифт),meridian_doc_insert_table(doc, rows, cols),meridian_doc_caret_state(doc, out)→MeridianCaretState(итоговые шрифт, кегль, Ж/К/Ч/зачёркнутый, цвет, выравнивание, стиль абзаца). - поиск и замена Write (v0.10) —
meridian_doc_find(doc, text, len, flags, *found)(выделяет найденное, от курсора, с переходом через конец; флагиMERIDIAN_DOC_FIND_MATCH_CASE/WHOLE_WORD/BACKWARD),meridian_doc_replace(…, with, with_len, flags, *found),meridian_doc_replace_all(…, *count). Прежние функцииmeridian_version*,meridian_abi_version,meridian_document_*(заготовка текста) сохранены.
Дополнение A → B от 2026-10-09: восстановление свойств DOCX
C ABI version1 и format4 (DocxParts) сохранены. У
структурно исправного источника с неоднозначными или недопустимыми
metadata values появляется envelope
version='2' mode='opaque'. Typed values пусты, исходные
parts сохраняются целиком.
DocumentProperties::is_read_only() отличает recovery;
точечная правка отвергается без изменения revision/history/redo. Очистка
и валидная whole-source replacement остаются одной Undo-операцией.
Обычный импорт и строгий version1 setter не меняют семантику.
MWX recovery использует binding-version='3' для привязки
пустого structural m:meta; прежние bindings1/2 читаются по
прежним правилам. DOCX/ODT carriers переносят точный version2 envelope.
Старые читатели явно отвергают неизвестные версии. UI следует сохранять
отказ точечной правки и показывать доступный текст документа, не
подставляя выдуманные поля. Контракт, причины и
проверки. Свежие Cargo/full14/FFI/C12/full383 кандидата ещё проходят
отдельную приёмку.
Дополнение A → B от 2026-10-09: геометрия явных разрывов Write
PageItem::LineMark получает внутреннее Rust-поле
flow_height. height остаётся положительной
высотой каретки; только пустой курсорный хвост после page break имеет
flow_height=0. Настоящие пустые строки и абзацы сохраняют
положительную высоту потока. Layout, render и FFI собираются совместно;
смешивать старую Rust-библиотеку и новый consumer нельзя.
Публичный C ABI1 и header неизменны. Click/Up/Down используют flow geometry, caret_rect возвращает прежнюю положительную высоту. Текст и настоящая пустая строка имеют приоритет перед виртуальным хвостом на той же координате. Selection не выделяет виртуальный хвост. Конечный обычный line break создаёт настоящую пустую строку с метриками знака абзаца; она владеет позицией EOF. Нижняя рамка остаётся у последней настоящей части абзаца. Горизонтальные линии соединяются с внешними краями имеющихся боковых рамок; ширина текста и прежняя геометрия рамок без боковых линий сохраняются. Алгоритм и проверки.
Дополнение A → B от 2026-10-17: орфография Write (v0.14, дорожка S3, Б6)
Добавления совместимы, MERIDIAN_ABI_VERSION = 1.
Объявления — в include/meridian.h.
meridian_doc_para_count(doc) -> uint32_t— абзацы тела всех разделов по порядку чтения (тот же обход, что у «Найти»); NULL — 0.meridian_doc_para_text(doc, i, buf, cap, *written)— текст абзаца в единицах: символk= единицаkабзаца (нетекстовые единицы — знак-заменитель, как в «Найти»), UTF-8; мал буфер —MERIDIAN_E_ARGUMENT, длина заполнена.meridian_doc_para_lang(doc, i, buf, cap, *written)— язык абзаца (BCP 47 изw:lang/fo:language, первый текстовый прогон, иначе знак абзаца, с учётом стилей и умолчаний документа); пусто — не задан.meridian_doc_select_para(doc, i, start, end)— выделить единицыstart..endабзацаi(курсор в конце); вне абзаца —MERIDIAN_E_ARGUMENT. Дальшеmeridian_doc_insert_textзаменяет выделенное одним шагом отмены.meridian_doc_line_span(doc, page, i, start, end, *x_emu, *w_emu)— отрезок байтовstart..endтекста строкиi(как его отдаётmeridian_doc_line) по горизонтали: от левого края первого глифа до левого края глифа за концом (у последнего — до правого края строки); нет глифов —MERIDIAN_E_ARGUMENT. Для волнистой линии под словом.meridian_doc_line_lang(doc, page, i, buf, cap, *written)— язык абзаца строки, какpara_lang.
В Rust-части meridian_layout::TextLine получила поле
stops (левые края глифов по байтам строки) и метод
span. Проверка правописания — в окне
(meridian-spell), ядро даёт только текст, язык и
геометрию.
Дополнение A → B от 2026-10-17: оформление абзаца, списки, переносы, примечания (v0.15, S3)
Добавления совместимы, MERIDIAN_ABI_VERSION = 1. Каждая
команда — один шаг отмены (meridian-edit).
meridian_doc_set_highlight(doc, rgb, none)— маркер (w:highlight) на выделение;none= 1 — «Нет цвета» (снимает и унаследованное).meridian_doc_redo_label— подпись шага повтора, какundo_label.MeridianParaProps(maskизMERIDIAN_PARA_*; отступы слева/справа/первой строки — выступ минусом; интервалы перед/после; междустрочныйMERIDIAN_LINE_RULE_MULTIPLEв 240-х долях 24…2400,AT_LEAST/EXACTв EMU),meridian_doc_para_props(doc, *out)— свойства абзаца с курсором с учётом стилей (все биты),meridian_doc_set_para_props(doc, *props)— отмеченные поля абзацам выделения; явный интервал снимает «авто».MeridianTabStop(pos_emu,MERIDIAN_TAB_*выравнивание и заполнитель),meridian_doc_tab_count,meridian_doc_tab_at(doc, i, *out)— позиции абзаца с курсором по возрастанию;meridian_doc_set_tabs(doc, tabs, n)— заменить (до 64): унаследованные от стиля, которых нет в списке, снимаютсяclear, как в Word (W12).meridian_doc_list_kind,meridian_doc_set_list(doc, MERIDIAN_LIST_*)— маркеры/нумерация на выделение (продолжает список предыдущего абзаца того же вида; тот же вид повторно — снять),meridian_doc_list_level(doc, delta)— уровень ±1 (вне списка — отступ на 1,27 см),meridian_doc_restart_list(doc, start)— «Начать заново» с абзаца курсора: новый экземпляр сstartOverrideдля него и следующих абзацев того же списка (W04).meridian_doc_hyphenation,meridian_doc_set_hyphenation(doc, on)— автоматические переносы документа: модельDocSettings::auto_hyphenation, DOCXw:autoHyphenation, ODTfo:hyphenateстиля по умолчанию, MWXauto-hyphenation; вёрстка переносит поmeridian-hyphи языку текста.meridian_doc_set_comment_text(doc, i, text, len)— новый текст примечанияi; автор, дата, ответы и диапазон в тексте сохраняются (W16).
В meridian-edit: Op::SetAbstractNumbering,
Op::SetSettings,
Editor::{set_list, change_list_level, restart_list, list_kind, list_level, set_auto_hyphenation, set_comment_text, map_paragraphs},
ListKind.
Дополнение A → B от 2026-10-17: колонтитулы, страница, сноски, регистр, знаки ¶ (v0.16, S3)
Добавления совместимы, MERIDIAN_ABI_VERSION = 1. Каждая
команда — один шаг отмены (meridian-edit).
- Режим мыши:
meridian_doc_story/meridian_doc_set_story(doc, MERIDIAN_STORY_BODY | _HEADER_FOOTER)— в теле щелчок попадает в тело и сноски, в режиме колонтитулов — только в колонтитулы; выход из режима переносит курсор в начало тела раздела. Изменение поведения: раньше щелчок по колонтитулу ставил курсор в колонтитул.meridian_doc_caret_kind,meridian_doc_kind_at(doc, page, x, y)→MERIDIAN_AT_*(тело, верхний, нижний, сноска, концевая) — для двойного щелчка. meridian_doc_edit_header_footer(doc, page, footer)— в колонтитул, показанный на странице (особый первой, чётный приeven, обычный); нет — создаётся пустой абзац (стильHeader/Footer, если есть); включает режим.meridian_doc_insert_page_field(doc, 0 | 1)— полеPAGE/NUMPAGESу курсора.meridian_doc_set_page_number(doc, page, style)— нижний колонтитул страницы целиком одним шагом: 0 «Страница N из M» по центру, 1 «N / M» по центру, 2 «N» справа, 3 — убрать нижний колонтитул.MeridianSectionProps(размер, поля, колонтитулы, ориентация, колонки и промежуток — EMU,title_page,even_odd),meridian_doc_section_props/meridian_doc_set_section_props— раздел курсора;even_odd— для всего документа: включение копирует обычные колонтитулы в чётные, выключение убирает чётные. Вёрстка берёт чётный колонтитул на чётных номерах страниц (HeaderFooterSet::for_page_number).meridian_doc_insert_footnote(doc)— знак сноски у курсора (только в теле) и текст сноски «знак + пробел»; курсор — в текст сноски (W15). Текст сноски правится щелчком в области сносок.meridian_doc_set_case(doc, 0…4)— регистр выделения (без выделения — слова у курсора) знак в знак.MeridianMark,meridian_doc_format_marks(doc, page, out, cap, *n)— пробелы, табуляции, концы абзацев, разрывы строки и страницы в EMU — для показа знаков ¶ поверх страницы.
В meridian-edit:
Op::{SetHeaderFooter, SetSection, SetFootnote},
Editor::{edit_header_footer, insert_page_field, set_section, set_even_odd, even_odd, insert_footnote, set_case, leave_story, caret_section},
CaseMode.
Дополнение от 2026-10-18: исправления, рисунки, разрыв раздела, удаление колонтитула (v0.17, S3)
Добавления совместимы, MERIDIAN_ABI_VERSION = 1. Каждая
команда — один шаг отмены (meridian-edit).
- Исправления (W17):
meridian_doc_tracking,meridian_doc_set_tracking(doc, author, len)(len= 0 — выключить) — запись: набор становится вставкой автора (подряд — одна вставка), удаление помечается (Backspace подряд — одна пометка), удаление внутри своей вставки стирает, абзацы при записи не склеиваются.meridian_doc_revision_count,meridian_doc_revision_info(doc, i, *kind, buf, cap, *written)— вид (0 вставка, 1 удаление, 2/3 перенос) и «автор\tдата\tтекст»;meridian_doc_resolve_revisions(doc, accept, all)— принять или отклонить все или задетые выделением;meridian_doc_select_revision(doc, forward, *found)— по кругу. - Рисунки (W07, W08):
MeridianPicture(размер,floating,wrapMERIDIAN_WRAP_*: в тексте, вокруг рамки, сверху и снизу, за текстом, перед текстом; смещение от полей; страница и рамка на ней — только чтение),meridian_doc_insert_picture(doc, bytes, len, content_type, w, h, descr)(PNG, JPEG, GIF, BMP, SVG, WebP; рисунок выделяется),meridian_doc_picture_at(doc, page, x, y, *found)— выделить рисунок под точкой,meridian_doc_selected_picture,meridian_doc_set_picture(явное смещение снимает выравнивание). meridian_doc_remove_header_footer(doc, page, footer)— убрать колонтитул, показанный на странице.meridian_doc_insert_section_break(doc, 0 | 1)— разрыв раздела со следующей страницы / на текущей: хвост абзаца и остальное в разделе — в новый раздел с теми же параметрами и колонтитулами.
В meridian-edit (S3): Op::SetMedia,
Editor::{set_tracking, tracking, revisions, resolve_all, resolve_selected, select_revision, insert_picture, selected_picture, select_picture, set_picture, insert_section_break, remove_header_footer},
RevisionSpan, PictureInfo.
Дополнение от 2026-10-19: «Макет таблицы», исправления оформления и перемещения (v0.18, S3)
Добавления совместимы, MERIDIAN_ABI_VERSION = 1. Каждая
команда — один шаг отмены (meridian-edit).
- Таблицы (Ф3):
MeridianDocTableInfo(сетка, ячейка курсора, ширина колонки, высота строки и «точно», заливка или −1,v_alignMERIDIAN_VALIGN_*,merged);meridian_doc_table_info(не в таблице —E_ARGUMENT);meridian_doc_table_command(doc, MERIDIAN_TABLE_*)— строка выше/ниже, столбец слева/справа, удалить строки, столбцы, таблицу, объединить ячейки (текст — в верхнюю левую), разбить объединённую; удаление всех строк убирает таблицу.meridian_doc_set_table_column_width,_set_table_row_height(doc, emu, exact)(0 — авто),_set_cell_shading(doc, rgb | −1),_set_cell_v_align,_set_cell_borders(doc, width_emu, rgb)(0 — без границ). Команды действуют на прямоугольник ячеек выделения. - Исправления: в
meridian_doc_revision_infoвид 4 — оформление (RevisionKind::Format, в модели — прежние свойства знаковRevision.old; DOCXw:rPrChange, MWXt:change kind="rpr", ODT пишется принятым). При записи оформление выделения становится таким исправлением; отклонить — вернуть прежнее. Перемещение (moveFromиmoveToтого же автора с тем же текстом) считается одним исправлением: вmeridian_doc_revision_count— один раз (вид 2), принять или отклонить с курсором на любой стороне — обе стороны.
В meridian-edit (S3):
Editor::{table_info, insert_table_row, insert_table_column, delete_table_rows, delete_table_columns, delete_table, merge_table_cells, split_table_cell, set_table_column_width, set_table_row_height, set_cell_shading, set_cell_v_align, set_cell_borders},
TableInfo, RevisionSpan::moved_to. В модели
(K): RevisionKind::Format, Revision::old.
Открытые запросы окна Sheets к ядру (из раздела «C → A», 2026-10-05)
- защита ячеек и листа (SH-06) — ЗАКРЫТО 2026-10-18 (S4, ветка
claude/sheets-f4-filter-protect-3e1240, C ABI v0.12).meridian_book_cell_protection/_set_cell_protection(xf<protection locked hidden>, по умолчанию «защищаемая»),meridian_book_sheet_protection/_protect_sheet(book, sheet, on, password|NULL, allow)(битыprotect::ALLOW_*, снятие с неверным паролем —MERIDIAN_E_PASSWORD),meridian_book_workbook_protection/_protect_workbook(структура). Хеш — SHA-512 с солью 16 байт и 100 000 повторов по ECMA-376, проверка и SHA-384/256/1 и 16-битного хеша; сверено с файлами Excel из корпуса (POI: «pwd», «test» → CBEB). Ядро отклоняет ввод в защищаемую ячейку и неразрешённые действия; «Скрыть формулы» — пустойcell_input. Всё — круговой путь через xlsx со всеми атрибутами схемы. Окно: «Рецензирование → Защита», плашка, вкладка «Защита». - виды правил условного форматирования (SH-05) — ЗАКРЫТО
2026-10-18 (S4, ветка
claude/sheets-f4-ranges-outline-cond-3e1240, C ABI v0.13). ВMeridianCondRule:MERIDIAN_COND_TOP10(rank, флагиMERIDIAN_COND_BOTTOM,_PERCENT),_AVERAGE(op= ниже + 2·«или равно»,point_value[0]— число σ),_EXPRESSION(формула в локали книги вtext1, относительно левой верхней ячейки первой области),_ICON_SET(имя набора вtext1, пороги «тип значение;…» вtext2, флаги_REVERSE,_ICONS_ONLY),_TIME_PERIOD(op— один из 10 периодов Excel) — чтение и запись xlsx, печать/PDF (кроме значков). Вычисление формул и дат — ядром:meridian_book_cond_formula_hit(book, sheet, rule, row, col); ранги, среднее и пороги значков окно считает по значениям области само. С 2026-10-19 (S4): у_ICON_SETпорог может нести третье слово «набор:номер» — свой значок порога (cfIcon, «NoIcons:0» — без значка; значок нужен у всех порогов или ни у одного); наборы Excel 2010+3Stars,3Triangles,5Boxesи свои наборы читаются из расширения листа x14 и пишутся туда же. Значки печатаются. - диапазоны с паролем и структура в окне (2026-10-18, S4, C
ABI v0.13) —
<protectedRanges>:meridian_book_protected_range_count/_protected_range/_add_protected_range/_remove_protected_range/_unlock_protected_range,meridian_book_cell_edit_state(0 — можно, 1 — защищена, 2 — нужен пароль диапазона); ядро пускает правку в открытый диапазон. Структура:meridian_book_outline_max,_outline_level,_set_outline_level(до 7 уровней),_set_outline_collapsed,_outline_summary/_set_outline_summary. - сводные таблицы (SH-04, §5.14) — крейт
meridian-pivotи C ABI: создать сводную по диапазону-источнику (поля строк, столбцов, значений с итогом «сумма/количество/среднее/макс/мин», фильтр), вычислить её в ячейки листа-назначения, «Обновить» после правки источника, список и параметры сводных листа; pivotCache/pivotTable в xlsx (сейчас части переносятся без изменений). Окно сделает панель полей и ленту «Анализ сводной таблицы». - ярлычки, группировка, имена (SH-01) — цвет ярлычка
листа (
<sheetPr><tabColor>): чтение и запись; уровни группировки строк и столбцов (outlineLevel,collapsed,summaryBelow/Right): задать, снять, свернуть; определённые имена книги и листа (<definedNames>): список, создать, изменить, удалить, и их разбор в формулах (если имена из файлов уже разбираются в формулах — нужен только C ABI) — для «Диспетчера имён», поля имени со списком и кнопок «+/−» структуры. - перенос диапазона и сдвиг ячеек (SH-01) — ЗАКРЫТО 2026-10-17
(S4, ветка
claude/sheets-f4-fixes-3e1240).meridian_book_move_range(book, from, r1, c1, r2, c2, to, to_row, to_col)— «вырезать / вставить» и перетаскивание рамки: ячейки с оформлением, примечаниями, объединениями переезжают, ссылки всех формул, имён и таблиц, целиком лежащие в блоке, следуют за ним (20/20 сценариев LibreOffice,meridian-calc/tests/move_range.rs); отказ — часть объединения или формулы массива.meridian_book_shift_cells(book, sheet, r1, c1, r2, c2, insert, down)— «Вставить / Удалить ячейки со сдвигом» вниз/вверх или вправо/влево: ячейки полосы, форматы, оформление, примечания, объединения, проверки, правила УФ сдвигаются, ссылки поперёк целиком в полосе — тоже, на удалённое —#ССЫЛКА!(14/14 сценариев LibreOffice,tests/shift_cells.rs). Отказ (книга не меняется,MERIDIAN_E_ARGUMENTс русским текстом), как в Excel: сдвиг режет объединение; таблица (ListObject) или формула массива выходят за полосу; вставка внутрь массива; удаление части массива или заголовка таблицы без всей таблицы. Окно: «Вставить / Удалить ячейки», Ctrl+±, Shift-перетаскивание (при отказе любого шага — откат к снимку, без шага отмены). Не сделано: адреса в сырыхextLst/УФ, хранимых как есть, не сдвигаются (уведомление «Сохранение» честное). - фильтр по цвету и по дате (SH-07) — ЗАКРЫТО 2026-10-18 (S4,
C ABI v0.12).
MERIDIAN_FILTER_COLOR(заливка или шрифт,colorFilter+ dxf) иMERIDIAN_FILTER_DYNAMIC(dynamicFilter: сегодня … с начала года, кварталы, месяцы, выше/ниже среднего) вMeridianFilterCond; дерево дат —meridian_book_set_filter_dates/_filter_date_count/_filter_date(узлыdateGroupItemГГГГММДД),meridian_book_cell_date. Отбор строк — ядром, круговой путь через xlsx. Сортировка по цвету — окном (уровень сортировки с цветом). - копия листа (SH-01, 2026-10-06) —
meridian_book_copy_sheet(book, sheet, to_index, name, *index): полная копия, включая то, что окно перенести не может (правила проверки данных, автофильтр с условиями, имена листа, части, которые ядро хранит как есть). Сейчас «Создать копию» окна переносит ячейки, разметку, объединения, закрепление, примечания, ссылки, УФ, параметры страницы, колонтитулы, разрывы и таблицы. - спарклайны и ветки комментариев (SH-03, 2026-10-06)
— чтение и запись
x14:sparklineGroups(вид, диапазон данных, ячейка, цвета, маркеры) иthreadedComments(ветка, ответы, авторы, решено); окно нарисует спарклайны в ячейках и ленту «Вставка → Спарклайны», панель комментариев с ответами. - свойства документа (SH-01, 2026-10-06) —
docProps/core.xmlкниги: название (dc:title), автор (dc:creator), кем изменён (cp:lastModifiedBy), создан и изменён (dcterms:created/modified), тема, ключевые слова — чтение и запись (meridian_book_property(book, key, buf, cap, *written)/meridian_book_set_property), при сохранении — обновление «изменён» и «кем». Окно покажет и даст править их в «Файл → Сведения» (страница уже есть, сейчас — файл, размер, время, листы и сводка). - выравнивание: поворот и автоподбор (SH-01,
2026-10-06) — в
MeridianCellStyleиз<alignment>:textRotation(0–90, 91–180 как в xlsx, 255 — вертикальный текст) иshrinkToFit; плюс двойное подчёркивание (<u val="double">). С чтением и записью xlsx. Окно сделает «Ориентацию ▾» (против/по часовой стрелке, вертикально, вверх, вниз) и флажок «автоподбор ширины» во вкладке «Выравнивание» «Формата ячеек». - сквозные строки и столбцы печати (SH-06,
2026-10-06) — в
MeridianPageSetup:has_title_rows,title_rows [r0, r1],has_title_cols,title_cols [c0, c1]; xlsx — определённое имя_xlnm.Print_Titles('Лист'!$1:$2,'Лист'!$A:$A), чтение и запись;meridian_book_export_pdfи счёт страниц повторяют их на каждой странице (строки сверху, столбцы слева) и учитывают их высоту и ширину при разбиении. Окно сделает «Разметка страницы → Печатать заголовки» (поля «сквозные строки / столбцы» в «Параметрах страницы»), предпросмотр и своё разбиение с ними — без ядра печать (PDF) их не повторит, поэтому окно ждёт. - колонтитулы: первая и чётные страницы, шрифты (SH-06,
2026-10-06) —
<headerFooter differentFirst differentOddEven>сfirstHeader/firstFooter/evenHeader/evenFooter: чтение и запись (meridian_book_header_footer_ex(book, sheet, kind, footer, …), kind: 0 обычный, 1 первая, 2 чётные) и их выбор вexport_pdfпо номеру страницы; там же — коды шрифта в тексте колонтитула (&"Шрифт,Полужирный",&12,&B,&I,&U) при рисовании PDF. Окно сделает флажки «Особый колонтитул для первой страницы» и «Разные колонтитулы для чётных и нечётных страниц» в диалоге колонтитулов и кнопки шрифта. - сценарии «что если» (SH-07, 2026-10-06) —
<scenarios>листа: список сценариев (имя, комментарий, изменяемые ячейки и их значения, автор), чтение и запись (meridian_book_scenario_count/_get/_set/_remove). Окно сделает «Данные → Анализ «что если» → Диспетчер сценариев»: добавить, изменить, «Вывести» (подставить значения одним шагом отмены), «Отчёт» (сводка на новом листе). Без хранения в книге сценарии терялись бы при сохранении, поэтому окно ждёт. - скорость PDF на длинных листах (SH-06, 2026-10-06, найдено
тестом-«обезьяной») —
meridian_book_print_page_countиmeridian_book_export_pdfна листе, где занятая часть доходит до ~1 048 000-й строки (ячейка у конца листа и данные сверху), идут минуты в debug-сборке: по стеку время уходит вsheet_pdf::sheet_pages→row_pt/place_text→ раскладку текста (meridian_shape) для каждой строки. Нужен расчёт страниц без раскладки пустых строк (высоты по умолчанию — арифметикой, раскладка — только строк с текстом и только для видимых на странице ячеек). Окно уже не вызывает счёт страниц в кадре (берёт число из своего разбиения), но экспорт и печать по-прежнему ждут ядро. - печать всей книги одним PDF (SH-06, 2026-10-06) —
как «Печать → Напечатать всю книгу» в Excel: один файл, в котором подряд
идут страницы всех видимых листов (каждый со своими параметрами
страницы, областью печати, ручными разрывами и колонтитулами; сквозная
нумерация
&P/&Nпо книге). Предложение:meridian_book_export_pdf_book(book, path, const MeridianSheetBreaks *sheets, size_t n), где у каждого элемента — номер листа и его разрывы строк/столбцов (как уmeridian_book_export_pdf). Окно сделает в «Печати» выбор «Активные листы / Вся книга / Выделенный фрагмент» и предпросмотр по всем листам; склеивать отдельные PDF своим кодом окно не будет (нумерация объектов и шрифтов — дело ядра), поэтому ждёт. - внешние связи книги (SH-59c, 2026-10-06) — ядро
разбирает
[1]Лист!A1по номеру внешней книги, но окну нужен список источников:meridian_book_external_count/_get(book, k, path, sheet_names…)(путь изexternalLinks/_rels, состояние: найден ли файл), «Обновить значения» (перечитать сохранённые значения из файла-источника), «Изменить источник» (заменить путь) и «Разорвать связь» (формулы с этой книгой → их значения, одним шагом отмены). Окно сделает «Данные → Изменить связи» (список, кнопки, предупреждение при открытии книги со связями «Книга содержит ссылки на внешние источники» в полосе уведомлений SH-09). - скорость правки больших областей (SH-07, 2026-10-06, замер
окна) — сортировка 50 тыс. строк × 4 столбца идёт 3–5 с, и по
профилю (
sample) почти всё время — создание потоков:meridian_book_set_inputпосле каждой ячейки зовётWorkbook::recalc, а тот всегда запускает поток со стеком 512 МБ (eval.rs,spawn_scoped), даже когда грязных и волатильных формул нет. Просьба: (1) быстрый путь — без потока, еслиdirtyпуст и волатильных нет; (2) пакетный ввод с одним пересчётом в конце —meridian_book_set_inputs(book, sheet, const MeridianCellInput *, size_t n)или параmeridian_book_batch_begin/_end(между ними пересчёт откладывается). Окно переведёт на пакет сортировку, заполнение, вставку, «Очистить данные», «Текст по столбцам», отмену. Там же:meridian_book_used_rangeобходит все ячейки листа (O(n)) — окно теперь кэширует его до правки, но границы листа лучше держать в ядре. - оформление: стили линий, диагонали, двойное подчёркивание
(SH-06, 2026-10-06) — в
MeridianCellStyleсейчас 7 видов линии (тонкая, средняя, толстая, штрих, пунктир, двойная, волосяная), а у Excel 13: нужны ещёmediumDashed,dashDot,mediumDashDot,dashDotDot,mediumDashDotDot,slantDashDot; диагональные границы (diagonalUp/Downи линия диагонали); подчёркивание двойное и «учётное» (u val="double"/ "singleAccounting"/"doubleAccounting"). Чтение и запись xlsx, рисование в PDF. Окно добавит их в «Формат ячеек → Граница/Шрифт» и меню «Границы». - печать: порядок страниц и номер первой страницы (SH-06,
2026-10-06) — в
MeridianPageSetupнетpageOrder(«вниз, затем вправо» / «вправо, затем вниз») иfirstPageNumber(useFirstPageNumber), а также печати примечаний («в конце» / «как на листе») и ошибок («как есть» / пусто / «--» / «#Н/Д»). Чтение и запись xlsx<pageSetup>/<printOptions>, учёт вexport_pdfи счёте страниц. Окно добавит их на вкладку «Лист» параметров страницы и в своё разбиение (порядок обхода страниц в предпросмотре). - функция «сумма прописью» (2026-10-06) — частая
потребность в России (счета, акты, платёжки), в Excel — только
надстройками:
СУММАПРОПИСЬ(число; [валюта]; [копейки_словами])→ «Одна тысяча двести тридцать четыре рубля 50 копеек», валюта"RUB"/"USD"/"EUR"/"", иЧИСЛОПРОПИСЬ(число; [род]). Окно уже вставляет такой текст командой «Вставка → Сумма прописью» (свой алгоритмui/meridian-sheets/src/propis.rs— согласование рода и форм, до триллионов, с тестами; можно перенести в ядро как есть), но текст не пересчитывается при смене числа — живой функции нужно ядро. - время расчёта формул (SH-16, 2026-10-06) — для
«профайлера» в «Графе зависимостей»: время последнего пересчёта по
ячейкам или листам (
meridian_book_calc_stats), окно покажет самые долгие формулы.
Изменения
- 18.10.2026 — файл выделен из
CONTRACTS.mdбез изменения содержания (П0.6); перенесены правки той же ночи изmain: дополнение v0.16 (S3, колонтитулы, сноски, регистр, знаки ¶) и закрытие SH-06/SH-07 (S4, книги v0.12). - 18.10.2026 — v0.17 (S3,
[касание K]): исправления, рисунки, разрыв раздела, удаление колонтитула. - 19.10.2026 — v0.18 (S3,
[касание K]): «Макет таблицы», исправления оформления, перемещение как одно исправление.