Открытый код для форматов, Sheets и данных (Codecs, meridian-calc, Base)

Отчёт исследования, 2026-10-04. Область: чтение/запись форматов, CFB и шифрование Office, движок таблиц и функций, числовые форматы, потоки данных, поиск решения, статистика, даты, десятичные; MOffice Base. Правила и классы лицензий — docs/research/BRIEF.md, docs/12-license-policy.md.

1. Выводы

Главное. Для Sheets и кодеков есть готовая основа классов 0–1 почти на всё, кроме OneNote, Visio/Publisher/iWork (там только MPL-библиотеки — решение владельца — или своя работа по спецификациям с разрешительными референсами). Три находки меняют component-map.md: (1) outlook-pst — эталонная реализация [MS-PST] от самой Microsoft на Rust, MIT; (2) jetdb — чтение .mdb/.accdb на чистом Rust, MIT OR Apache-2.0; (3) formualizer — второй движок таблиц на Rust (MIT OR Apache-2.0) с инкрементальным графом зависимостей и многопоточным пересчётом, то есть ровно с тем, чего нет у IronCalc. Ещё одна поправка: formulajs и Univer почти не нужны как источник функций. Скрипт сравнения показал, что IronCalc уже покрывает 492 из 518 имён каталога (§3.1–3.2), поэтому ценность этих двух проектов — в тестах.

Базис для оценки экономии. В 08-roadmap.md трудоёмкость по эпикам не разбита, поэтому база эпика = численность подкоманды × длительность эпика (инкремент = 6 недель). Получается так: E2.2 «Движок формул» ≈ 21 чел.-мес. (2,5 Rust × I05–I10); E2.4 «Кодеки Sheets» ≈ 19 (2 × I05–I11); E1.4 «Кодеки Write» ≈ 21 (2,5 × I03–I08); E3.4 «Кодеки Slides/Draw» ≈ 24 (2,5 × I09–I15); E5.6 «Кодеки PIM» ≈ 17 (2 × I17–I22); E5.4 Base ≈ 24, из них Rust ≈ 10.

Итого ≈ 44–58 чел.-мес. против базиса roadmap (41–54, если владелец не разрешит MPL для OneNote); с мелочами из §2 — ≈ 47–62. Кроме того, снимается главный риск фазы 2: по оценке §3.1, 500 функций «с нуля» — это 28–35 чел.-мес., а в roadmap на весь E2.2 заложено ≈ 21. Высвобожденные 1–2 Rust FTE стоит отдать на сводные таблицы и Chart: это риск «сводные объёмнее оценки» из §3.2 roadmap.

2. Таблицы по подобластям

Данные о лицензиях, звёздах, загрузках и датах взяты из oss-verified.tsv (проверка 2026-10-04); для того, чего там нет, стоит пометка. Даты последнего коммита — по клонам (git log -1) или по pushed_at. Сокращения: ★ — звёзды GitHub, «загр.» — загрузки с crates.io; стратегии — по BRIEF.

2.1 OOXML, ODF и общий фундамент кодеков

2.2 Бинарные форматы MS Office, CFB, шифрование

2.3 RTF, Markdown, HTML, EPUB, FB2

2.4 PIM, Access, iWork, Visio, Publisher

2.5 Движок таблиц, функции, числовые форматы

2.6 Данные, поиск решения, статистика, даты, десятичные

2.7 MOffice Base

3. Глубокие разборы

3.1 IronCalc как основа meridian-calc

Клон oss-src/ironcalc_IronCalc — коммит 9b1ae3f от 2026-10-02, workspace base, xlsx, bindings/{wasm,python,nodejs}. Зависимости base: serde, ryu, chrono(+tz), bitcode, csv, statrs, rand, regex — все класса 1.

Структура и объём (строк Rust, без тестов): base/src/functions — 35,3 тыс. (по категориям, functions/mod.rs — enum Function на 496 вариантов и диспетчер evaluate_function); expressions — 7,9 тыс. (лексер lexer/mod.rs в режимах A1 и R1C1, lexer/structured_references.rs, парсер parser/mod.rs — AST Node, parser/static_analysis.rs — 2,2 тыс., stringify.rs с to_rc_format и to_localized_string, move_formula.rs); formatter — 2,3 тыс.; user_model (undo, автозаполнение, буфер обмена) — 8,7 тыс.; model.rs — 3,9 тыс.; evaluation.rs — 1,1 тыс.; xlsx/src/import — 4,8 тыс., export — 3,8 тыс. Тесты: 288 файлов, 52 тыс. строк, 2 768 #[test], плюс 211 эталонных xlsx в xlsx/tests/calc_tests/<КАТЕГОРИЯ>/ (значения, вычисленные Excel).

Как это устроено и что из этого следует для нас.

Сравнение функций (скрипт fncov.py лежит в scratchpad сессии и в репозиторий не кладётся: он разбирает таблицы §5.23 sheets.md и сопоставляет их с languages.json IronCalc, function-map.ts Univer без закомментированных заглушек, экспортами src/*.js formulajs и fn name() в builtins formualizer). Каталог MOffice: 518 имён = P0 331 (317 + 14 алиасов) + P1 171 (147 + 24) + P2 16. Все 496 функций IronCalc входят в каталог; 4 из них — FORECAST.ETS, .CONFINT, .SEASONALITY, .STAT — заглушки #N/IMPL! (functions/statistical/forecast.rs:85).

Для сравнения покрытие каталога другими движками: formualizer — 428, Univer — 493, formulajs — 403. Оговорка о качестве: «есть в IronCalc» ≠ «полностью как в Excel». В functions/ 33 места возвращают #N/IMPL! для частных случаев. 18 из них — «Arrays not supported yet»: массивы в аргументах AND/OR, COUNTIF-семейства, D-функций, SUBTOTAL, текстовых и дат-функций. Остальные — LAMBDA в аргументах, неявное пересечение в текстовых функциях и частичные INFO, CELL, SHEETS (functions/information/mod.rs:381–496). Закрыть этот список — ≈1 чел.-мес.

Многопоточность и производительность. У IronCalc их нет: однопоточный полный пересчёт. Для цели R1 из roadmap (1 млн формул ≤ 2 с, пересчёт после правки — мгновенный) нужен свой граф. Для сравнения: formualizer заявляет 1 млн формул за 0,38 с и 52 мс на пересчёт после правки одной ячейки (README, проверено 2026-10-04). Его engine/ даёт референс класса 1: interval_tree.rs — диапазонные слушатели, csr_edges.rs/delta_edges.rs — рёбра графа, scheduler.rs/topo/ — порядок, lookup_index_cache.rs — хэш-индекс для VLOOKUP/MATCH (§5.24 sheets.md).

Стратегия fork → kernel/crates/meridian-calc. (1) Снимок 9b1ae3f в ветку upstream/ironcalc; из двойной лицензии выбираем MIT; копирайт «Nicolás Hatcher и авторы IronCalc» — в NOTICE и в заголовках файлов. (2) I05, 3 недели: выделить parse/ и functions/, ввести трейты CellSource и EvalContext, прогнать 2 768 тестов и 211 xlsx на адаптере. (3) I05–I06: граф §5.4 и планировщик §5.5 с референсом formualizer. (4) I06–I07: 3D-ссылки, объединение, пересечение, внешние ссылки; ru-локаль; AGGREGATE (порт formualizer-eval/src/builtins/math/aggregate.rs); массивы в аргументах. (5) I07–I08: GROUPBY и PIVOTBY (builtins/lookup/dynamic.rs), IMAGE, FILTERXML, BAHTTEXT, DBCS (Univer), FORECAST.ETS* (statsmodels), GETPIVOTDATA (после сводных). (6) Раз в квартал переносить исправления из апстрима (≈0,25 чел.-мес.); для этого раскладка functions/ остаётся близкой к оригиналу.

Альтернатива — formualizer как движок целиком. Плюсы: граф и потоки уже есть. Минусы: покрытие каталога 428 против 492, хранение по столбцам Arrow вместо наших чанков 256×256, движок 0.10 переписан в 2026 году, ★187. Рекомендация — спайк на 2 недели в I05: прогнать 211 xlsx IronCalc и бенчмарк «1 млн формул» на обоих; решение зафиксировать в 03-architecture.md.

Экономия. С нуля 492 функции — это 28–35 чел.-мес. (1,2–1,5 чел.-дня на функцию с тестами и сверкой с Excel), парсер с локалями — 3–4, тесты — 6–8; всего 35–45. Против базиса E2.2 (≈ 21) остаётся 8–10: адаптер 1,5; граф и пересчёт 3–4; синтаксис 1–1,5; 26 функций 1,5–2; массивы 1; ru 0,3. Экономия 11–13 чел.-мес., и цель «500 функций» сдвигается с I08 на I06.

3.2 Источники недостающих функций: formulajs и Univer

Главный результат сравнения: портировать из JS/TS почти нечего. Из 26 функций, которых нет у IronCalc, Univer даёт 6, formualizer (Rust) — 3, formulajs — только AGGREGATE, которая есть и у двух других.

Univer engine-formula (Apache-2.0, oss-src/dream-num_univer/packages/engine-formula, коммит 2026-10-02):

• Функции: src/functions/<категория>/<имя>/index.ts, регистрация в <категория>/function-map.ts, имена — в function-names.ts. Реализовано 516 имён: в это число входят 6 операторов из meta, 2 из array и около 15 собственных функций Univer и Google Sheets (ISEMAIL, ISURL, REGEXMATCH, FLATTEN, ROUNDBANK, TO_DATE…). Ещё 22 заглушки NotImplementedFunction закомментированы в картах: CUBE* ×7, FORECAST.ETS* ×4, GETPIVOTDATA, RTD, WEBSERVICE, EUROCONVERT, PHONETIC, CALL, REGISTER.ID, INFO, ISOMITTED, AMORDEGRC, ISO.CEILING. Объём: функции — 52 тыс. строк TS, engine/ — 19,7 тыс. (лексер, AST, интерпретатор, engine/dependency/dependency-tree.ts), services/ — 19,7 тыс.
• Тесты: 475 файлов __tests__/index.spec.ts, 5 563 проверки expect(; тесты есть почти у каждой функции.
• Берём: (1) тесты как независимый оракул — скрипт-конвертер spec → Rust-тест, ≈2 недели QA-автоматизации; (2) порт TS → Rust 4 функций: web/filterxml (99 строк), lookup/image (162), text/bahttext (122), text/dbcs (72), плюс math/aggregate (300) как второй референс.
• Описания функций не берём. src/locale/function-list/<кат>/ru-RU.ts (8,1 тыс. строк; всего 17 языков, 138 тыс. строк) содержит тексты в стиле справки Excel со ссылками на support.microsoft.com/ru-ru/…. Вероятное происхождение — справка Microsoft, поэтому лицензия Apache-2.0 на них не распространяется. Описания и имена параметров для «Мастера функций» пишем сами: 518 × ≈15 мин ≈ 3 чел.-недели на язык, это работа техписателей.

formulajs (MIT, oss-src/formulajs_formulajs, v4.6.1, коммит 2026-10-01): src/*.js — 12,3 тыс. строк, 437 имён (403 из каталога), тесты test/*.js — 3 084 проверки, зависимости jstat (MIT) и bessel (лицензия не проверена). Уникальных для нас функций нет. Семантика JS: диапазоны — это массивы, пустые ячейки и текст в диапазонах приводятся не как в Excel. Поэтому ожидания из тестов прогоняем как третий оракул с фильтром: расхождение с IronCalc → разбор вручную, а не «истина».

Поправка в component-map.md. Было: «formulajs (411), Univer (502) — port — полный каталог». Нужно: «formualizer (AGGREGATE, GROUPBY, PIVOTBY) + Univer (IMAGE, FILTERXML, BAHTTEXT, DBCS) — port 7 функций; Univer + formulajs — тест-оракулы (≈8,6 тыс. проверок)». Экономия ≈1,5 чел.-мес.: 0,5 — функции, 1 — эталоны для стенда формул E2.6.

3.3 Числовые форматы: SheetJS SSF → meridian-numfmt

oss-src/SheetJS_ssf: Apache-2.0, последний коммит 2023-02-22 — репозиторий заморожен, развитие идёт в монорепо SheetJS (не проверено). Собранный ssf.js — 966 строк; исходники лежат в bits/*.js (1 146 строк). Главная ценность — эталоны, снятые с Excel: test/valid.tsv (442 кода), general.json (516), implied.json (756 — встроенные id), fraction.json (121), oddities.json (180), is_date.json (447), exp.tsv (46), dates.tsv (≈296 тыс. строк), times.tsv и cal.tsv (по 1 048 576 строк). Всего ≈2,4 млн проверок, 186 МБ — они лежат в тестовом репозитории, не в продукте.

Итого ≈3 тыс. строк и ≈29 рабочих дней, то есть 1,3–1,5 чел.-мес. С нуля, вместе со сбором эталонов, — 2,5–3. Экономия 1–1,5 чел.-мес. Сами дописываем то, чего в SSF нет: *x (заполнитель) и _x (отступ шириной символа) возвращаются как fill и pad в DisplayString, ширину считает рендер по метрике шрифта; [ColorN] — палитра из 56 цветов; японские эры g/gg/ggg (P2). meridian-numfmt заменяет formatter/ IronCalc и становится единым механизмом для отображения, TEXT(), экспорта CSV «как отображено», Base и Forms. В NOTICE: «SheetJS SSF, © SheetJS LLC, Apache-2.0»; в файлах — заголовок «основано на SheetJS SSF».

3.4 Бинарные форматы: POI, calamine, cfb, шифрование, RTF

Apache POI (Apache-2.0, ★2,3k, коммит 12c3688 от 2026-10-03; частичный клон для подсчёта — scratchpad/fmt-src/apache_poi). Объём модулей Java приведён как «файлов / строк / строк кода без комментариев».

Итого порт ≈ 15–17 чел.-мес. против 30–37 по спецификациям [MS-DOC], [MS-XLS], [MS-PPT] «с нуля». Экономия против базиса E1.4, E2.4 и E3.4 — 9–12 чел.-мес.: doc 3–4, xls 3–4, ppt 2–3, vsd/vsdx 1–1,5. Порядок: фаза 1 — DDF, HPSF, HWPF (doc R — P0); фаза 2 — записи HSSF и PTG (xls R — P0, W — P1; xlsb R через тот же PTG); фаза 3 — HSLF (ppt R), HDGF/XDGF, HPBF. Приём порта: не копировать ООП-иерархию POI, а описать записи декларативно (структуры плюс таблица «sid → декодер»). Запись doc и ppt у POI слабая, поэтому писатели делаем свои (doc W — P1, ppt W — P2). Вторым референсом поведения служат фильтры Apache OpenOffice (Apache-2.0): ww8, sc/source/filter/excel, sd/source/filter/ppt — пути не проверены.

calamine (MIT, v0.36.1, коммит 2026-09-02, 17,3 тыс. строк, scratchpad/fmt-src/tafia_calamine): src/xls.rs (2,0k), src/xlsb/ (1,3k), src/xlsx/ (5,2k), src/ods.rs (0,8k), src/vba.rs (467 строк: распаковка [MS-OVBA] и извлечение модулей), src/formats.rs (дата ли это по формату). Читает значения, формулы (PTG → текст для xls и xlsb), объединения, имена, VBA и изображения; стилей, условного форматирования, проверки данных и диаграмм нет. Стратегия: adopt для лёгких сценариев только-чтения (импорт в Base, источник «Excel» в потоках данных, предпросмотр в Hub, Forms) и fork vba.rs в meridian-script/vba, чтобы транслятор VBA получал исходники модулей из xlsm, xls, doc и accdb. Кодек Sheets — свой. Экономия 1–2 чел.-мес.

CFB: adopt крейта cfb (MIT, 68 млн загрузок, чтение и запись v3/v4). Шифрование — модуль codec-core/offcrypto:

• adopt office-crypto (MIT) для расшифровки Agile, Standard и RC4 CryptoAPI в doc и ppt и ms-offcrypto-writer (MIT OR Apache-2.0) для записи Agile AES-256/SHA-512, как требует §4.1 04-file-formats.md;
• порт из msoffcrypto-tool (MIT, scratchpad/fmt-src/nolze_msoffcrypto-tool, 4,6 тыс. строк Python): method/xor_obfuscation.py (354), method/rc4.py (97), format/xls97.py (683 — расшифровка BIFF с открытыми записями BOF, FILEPASS…), format/doc97.py (501), format/ppt97.py (838), Agile на SHA-1/256/384 — всего ≈1,5 тыс. строк Rust; тестовые файлы tests/inputs/* — в корпус. Итого 1 чел.-мес. вместо 2–2,5, экономия 1–1,5.

RTF: своя реализация по спецификации Microsoft RTF 1.9.1. Ридер ≈4–5 тыс. строк: группы, ≈1 500 управляющих слов, \trowd, \listtable, \field, \pict, \uN, кодовые страницы через encoding_rs. Писатель — 2–3 тыс. Всего 3–3,5 чел.-мес. Референсы класса 1: токенизатор rtf-parser (MIT) и RTF-фильтры Apache OpenOffice (svtools/source/svrtf, sw/source/filter/rtf; не проверено). Классы 2–3 не трогаем: pandoc (GPL), writerfilter LibreOffice (MPL). Сжатый RTF (LZFu) из PST и MSG — свой, ≈200 строк по [MS-OXRTFCP].

3.5 Access: jackcess → codec-access

jackcess (Apache-2.0, ★120, коммит 2026-09-13, oss-src/jahlborn_jackcess): 194 файла в src/main (≈56 тыс. строк) и 45 тестовых классов; 86 тестовых баз .mdb/.accdb (Apache-2.0) — их берём в корпус. Карта кода src/main/java/com/healthmarketscience/jackcess/:

• impl/ (65 файлов, 30,5 тыс. строк):
  • формат и страницы: JetFormat (1 199 — константы Jet3/Jet4/ACE12–16), PageChannel (466 — страницы, маска заголовка, шифрование), UsageMap (1 112);
  • таблицы и значения: TableImpl (3 739 — TDEF и строки), ColumnImpl (2 933 — MONEY, NUMERIC, DATETIME, сжатый Unicode), LongValueColumnImpl (547 — LVAL);
  • индексы: IndexData/IndexImpl/IndexPageCache (≈5,3 тыс.), GeneralLegacyIndexCodes + resources/index_codes_*.txt (таблицы сортировки);
  • каталог и свойства: DatabaseImpl (3 042 — MSysObjects, связи), PropertyMaps (559 — LvProp), OleUtil (838);
• impl/query/ (1,8 тыс.) — SQL из MSysQueries для SELECT, UNION, CROSSTAB, APPEND, UPDATE, DELETE, MAKETABLE, DDL;
• impl/complex/ (2,0 тыс.) — вложения, многозначные поля, история версий;
• impl/expr/ (9,0 тыс.) — язык выражений Access: парсер и около 120 функций (Default*Functions).

jetdb (MIT OR Apache-2.0, crates.io 0.3.3, ★13, коммит 2026-10-03; проверено 2026-10-04 по README) — то, что base.md §6.2 собирался писать сам. Это чистый Rust, Access 97 (Jet3) … 2019 (ACE17): каталог, схема (столбцы, индексы, связи), строки, генерация DDL для SQLite/PG/MySQL, восстановление SQL сохранённых запросов, исходники VBA, макросы в виде текста SaveAsText, LvProp, расшифровка (RC4 Jet, Agile, RC4 CryptoAPI, Standard AES), сборка под wasm32. Ограничения: только чтение, полный скан без индексов, все строки грузятся в память. Тестовые базы взяты из jackcess. Юридическая оговорка: автор благодарит mdbtools за HACKING.md — это документация формата, не код. Факты о формате не охраняются, но перед fork нужна короткая проверка, что кода mdbtools в jetdb нет; затем — запись в реестр.

План codec-access:

1. Fork jetdb в kernel/crates/codecs/codec-access, исправления по возможности отдаём в апстрим. 0,3 чел.-мес.
2. Доработки: потоковый итератор строк вместо Vec, кодовая страница Jet3 из заголовка (cp1251 для русских баз через encoding_rs — проверить, есть ли она в jetdb), сопоставление типов Access → SQLite (§4.3 base.md), пакетный импорт в .mbx транзакциями по 10 тыс. строк. 0,5 чел.-мес.
3. Порт из jackcess по необходимости: impl/complex/* → вложения в дочерние таблицы, многозначные поля в JSON (0,3); impl/query/* — сверка с восстановлением SQL у jetdb (0,2).
4. impl/expr/* не портируем. Список функций Default*Functions служит спецификацией для слоя совместимости «выражения Access» в meridian-calc (IIf, Nz, Format, DateDiff, DLookup…), как предлагает вопрос 10.2 base.md. 0,5 чел.-мес.
5. CI: сверка jetdb ↔︎ jackcess (Java как инструмент тестов, не в продукте) на 86 базах + 100 реальных из §9 base.md.

Итого 1,8–2 чел.-мес. вместо 4–5. Экономия 3–4 чел.-мес. (E5.6). Если jetdb не пройдёт проверку — порт чтения jackcess (≈12–15 тыс. строк Java → 9–11 тыс. Rust, 2,5–3,5 чел.-мес.), экономия 1,5–2. mdbtools (GPL-2.0) и обёртку mdbsql не используем ни как код, ни как «референс»: ссылки на mdbtools в base.md (§6.2, §9) и 04-file-formats.md (§4.10) нужно убрать (§7).

3.6 OneNote, PST, MSG

OneNote — onenote.rs / onenote_parser (MPL-2.0, класс 2, v2.0.0, коммит 2026-08-06, oss-src/msiemens_onenote.rs). Объём crates/parser — 18,6 тыс. строк Rust:

• src/onenote (4,6k) — модель: книжка, раздел, страница, outline, rich text, таблица, изображение, вложение, чернила, формулы;
• src/one/property_set (2,3k), src/one/property (1,8k) — объекты и свойства [MS-ONE];
• src/fsshttpb/* (1,9k) и src/onestore/fsshttpb (0,85k) — пакеты FSSHTTPB для книжек, скачанных из OneDrive;
• src/onestore/{shared,desktop} (1,1k) — revision store формата desktop;
• src/fs, src/shared (0,9k).

Тестов почти нет (276 строк); записи нет. Чернила и формулы разобраны реверсом — в спецификации их нет.

Своя реализация по [MS-ONESTORE] и [MS-ONE] (Open Specification Promise). Хранилище ревизий (заголовок, FileNodeList, ≈40 типов FileNode, манифесты ObjectSpace и Revision, ExtendedGUID и CompactID, журнал транзакций, FileDataStore) — 3–4 тыс. строк. Объекты jcid* (Page, Outline, OutlineElement, RichText с TextRunFormatting, Image, Table, EmbeddedFile) — 5–6 тыс. Отображение в n:page/n:outline/t:p/tb:table — 1–2 тыс. FSSHTTPB для OneDrive — 2–3 тыс. (P2). Итого 11–15 тыс. строк, 4–6 чел.-мес., плюс 1 на чернила и формулы реверсом. Референс класса 1 — pyOneNote (Apache-2.0, ★153, последний коммит 2024-07-11, проверено 2026-10-04; полнота не проверена). Варианты решения для владельца — §4.

PST — outlook-pst (MIT; crates.io 1.2.0, 175 тыс. загрузок; github microsoft/outlook-pst-rs, ★36, коммит 2026-09-30; проверено 2026-10-04). README называет его «clean room»-реализацией [MS-PST] от Microsoft, совместимой с mspst32.dll и переносимой между ОС. Adopt. codec-mail/pst — тонкий адаптер по §4.9 04-file-formats.md: папки → mm:folder; сообщения → .eml (MIME собирается из MAPI-свойств, RTF → HTML с де-инкапсуляцией [MS-OXRTFEX] и распаковкой LZFu); встречи → VEVENT (AppointmentRecurrencePattern → RRULE через rust-rrule); контакты → vCard. Это 1–1,5 чел.-мес. вместо своих NDB/LTP/Messaging (≈15–20 тыс. строк, 5–6 чел.-мес.). Экономия 4–5. Не проверено: OST, запись, потоковое чтение 50-гигабайтных файлов — первая задача спайка в I17. Альтернативы не нужны: libpff (LGPL-3), java-libpst (Apache/LGPL, заброшен с 2022), XstReader (MS-PL, 2021).

MSG ([MS-OXMSG]: CFB, потоки __substg1.0_*, __properties_version1.0): msg_parser (MIT, 303 тыс. загрузок, ★10) подходит для быстрого старта; целевой вариант — своя реализация ≈1 тыс. строк на крейте cfb с общим слоем MAPI-свойств вместе с PST. Референс — POI HSMF. Экономия ≈0,5.

3.7 iWork, Visio, Publisher

iWork (IWA, iWork 2013 и новее). Устройство: ZIP или папка-пакет с Index/*.iwa. Каждый .iwa — кадры snappy в варианте Apple (без CRC), внутри — varint-длина, TSP.ArchiveInfo и protobuf-сообщения объектов со ссылками по идентификаторам. Рядом лежат Data/* (медиа) и preview.jpg. Что есть класса 1:

• obriensp/iWorkFileFormat (MIT, 2016) — описание контейнера и утилита proto-dump, которая извлекает схемы;
• masaccio/numbers-parser (MIT, коммит 2026-10-03) — актуальные .proto-схемы TSP, TSK, TSD, TSS, TST (таблицы), TSCE (формулы), TN, а также логика тайлов ячеек v4/v5, таблиц строк и форматов, AST формул и записи;
• DevExzh/litchi (Apache-2.0) — IWA на Rust, пригоден как пример связки snappy + prost.

keynote-parser без лицензии — не берём. libetonyek (MPL-2.0) нужен был бы только ради старых XML-форматов iWork '09 — их предлагаем не поддерживать.

План codec-iwork: контейнер (snap + prost) — 1,5 тыс. строк; Numbers — таблицы, формулы TSCE → наш AST, стили — 4 тыс.; Pages — TSWP: текст, стили, списки, таблицы, изображения — 4–5 тыс.; Keynote — слайды, мастера, фигуры, текст, анимации в P2 — 4 тыс. Итого 13–15 тыс. строк, 5–6 чел.-мес. вместо 7–9 вслепую, экономия 2–3. Риск: схемы .proto машинно извлечены из приложений Apple. Это функциональное описание формата для совместимости, но нужно юридическое заключение в фазе 0 вместе с вопросом об OSP.

Visio. VSDX: спецификация [MS-VSDX] (OSP) плюс порт POI XDGF (poi-ooxml/…/xdgf: 56 файлов, 4,5 тыс. строк кода — страницы, мастера, наследование ячеек ShapeSheet, геометрия MoveTo/LineTo/ArcTo/NURBSTo/PolylineTo…, текст). Порт ≈3 тыс. строк Rust в codec-ooxml/vsdx — 0,8 чел.-мес. вместо 2; запись vsdx — своя (≈2 чел.-мес.). VSD (бинарный) спецификации не имеет. POI HDGF (2,7 тыс. строк: распаковка HDGFLZW, потоки и чанки, таблица разбора chunks_parse_cmds.tbl) даёт структуру и текст. Ячейки ShapeSheet в VSD — те же, что в [MS-VSDX], поэтому остальное восстанавливаем «чистой комнатой» по парам файлов, сохранённых из Visio в VSD и VSDX, — 3–4 чел.-мес. Экономия 1–1,5. Фразу «R* через портирование подхода libvisio» в §4.4 04-file-formats.md заменить (libvisio — класс 2, §4).

Publisher. Спецификации нет. POI HPBF (1,6 тыс. строк: QuillContents — текст и гиперссылки, EscherStm — фигуры) за 0,2 чел.-мес. даёт R* «только текст»: поиск и индекс в Hub, импорт текста в Write. Полный R* (страницы, рамки, связанные фреймы, стили) — 3–4 чел.-мес. своими силами или libmspub (MPL-2.0) — решение владельца (§4). Рекомендация: в 1.x — только текст через HPBF; полный импорт решить в фазе 7 по запросам пользователей.

3.8 Base: SQLite, SQLCipher, sqlparser-rs, коннекторы, отчёты

Хранилище. SQLite (public domain, класс 0) через rusqlite (MIT, 0.40.2). SQLCipher Community — BSD-3-Clause, © Zetetic LLC (текст LICENSE.md проверен 2026-10-04), класс 1. Обязательство одно: уведомление в документации бинарного дистрибутива, то есть в окне «О программе». Формат SQLCipher 4 (AES-256-CBC, HMAC-SHA512, PBKDF2 на 256 000 итераций) совпадает с §2.6 base.md. Ответ на вопрос 10.4 base.md: статическая сборка через rusqlite bundled-sqlcipher-vendored-openssl (OpenSSL 3 — Apache-2.0) на Windows и Linux и CommonCrypto на macOS; провайдер NSS (MPL) не используем. Важно для архитектуры (не проверено в коде, по документации rusqlite): фичи bundled и bundled-sqlcipher собирают один и тот же libsqlite3-sys и не совмещаются в одном процессе. Поэтому весь пакет — Base, Mail, Notes, индекс Hub — переводим на сборку SQLCipher: без ключа она работает как обычный SQLite. Это нужно записать в 03-architecture.md.

sqlparser-rs (Apache-2.0, 0.63.0) — уже выбран в §5.2 base.md. Подтверждаем и уточняем, где он применяется: SQL → AST → QueryDesign, если запрос укладывается в подмножество QBE; QBE → SQL через AST с кавычками по диалекту; перевод Jet-SQL из MSysQueries — свой предпроцессор для #дат#, */? в LIKE и IIf, а скобки [Таблица].[Поле] разбирает диалект MsSql; разбор HSQLDB-скриптов из .odb — диалектом Generic. Ограничение: комментарии и форматирование теряются, поэтому исходный текст SQL храним всегда.

Коннекторы — adopt за трейтом DbBackend (§4.7 base.md):

• tokio-postgres — PostgreSQL;
• mysql_async — MySQL/MariaDB;
• tiberius — MS SQL (TDS 7.2+, Azure SQL, TLS через rustls);
• odbc-api — ODBC. Драйвер-менеджер: на Windows системный odbc32.dll, на Linux и macOS — системный unixODBC или iODBC. unixODBC под LGPL-2.1 (не проверено), его не поставляем, только загружаем, и делаем запись в реестр.

sqlx не берём: был бы второй стек драйверов, а поддержку MS SQL из него убрали. DuckDB (MIT) — отдельный плагин «связанные таблицы Parquet/CSV и аналитические запросы»; в базовую установку его вместе с Polars не тянем.

Отчёты — свой банд-движок (§5.10 base.md). Референсы:

• FastReport Open Source (MIT, C#, ★3,1k, коммит 2026-09-11; проверено 2026-10-04) — движок полос, групп, итогов, KeepTogether, повтора заголовка группы, CanGrow/CanShrink и двухпроходной пагинации для «Страница N из M»; формат .frx даёт идеи для report_xml. Конкретные файлы движка не проверены. Порт алгоритмов без UI — 0,5–1 чел.-мес. экономии.
• JasperReports (LGPL-3.0) и BIRT (EPL-2.0) — только документация (модели JRXML и ROM), без копирования (§4).
• Grist (Apache-2.0) — референс формульных столбцов: зависимости между столбцами и таблицами, trigger formulas (формула при вводе), summary tables. Нужен для вычисляемых полей и итоговых запросов Base, ≈0,3–0,5.
• dbeaver (Apache-2.0) — раскладка ER-схемы и конструктор запросов, референс для окна «Схема данных».

Экономия по Base против плана — 2–3 чел.-мес.: SQLite, sqlparser-rs и драйверы уже заложены в base.md; новое здесь — готовый SQLCipher, FastReport и Grist как референсы, DuckDB-плагин. jetdb (§3.5) считается отдельно.

4. Класс 2 — решения владельца

В колонке «Вариант A» — взять компонент по правилам его лицензии. В колонке «Вариант B» — замена классов 0–1 или своя работа.

5. Запрещено (класс 3) и замены

6. Что переносим кодом

Правило для всех строк: в заголовок каждого перенесённого файла — «основано на <проект> (), © авторы <проект>»; в NOTICE и в окно «О программе → Лицензии» — точный текст копирайта из LICENSE/NOTICE источника. Если у источника двойная лицензия «MIT OR Apache-2.0», выбираем MIT: у неё нет требования по NOTICE.

7. Предложения в библию и план

1. component-map.md.
   • «Sheets / недостающие функции» переписать: formualizer (3) и Univer (4) — port; Univer и formulajs — тест-оракулы (§3.2).
   • «Sheets / движок»: добавить formualizer как референс графа и спайк «IronCalc против formualizer» в I05.
   • «CFB и шифрование»: cfb + office-crypto + ms-offcrypto-writer (adopt) + порт msoffcrypto-tool для бинарных форматов.
   • Access → «jetdb fork + jackcess port частей». PST → «outlook-pst (Microsoft, MIT) adopt» вместо «своего по [MS-PST]».
   • Новые строки: iWork (numbers-parser, iWorkFileFormat — ref), Visio (POI XDGF/HDGF — port), Publisher (POI HPBF — port), отчёты Base (FastReport — ref), EPUB (свой; epub — GPL, epub-builder — MPL).
2. base.md.
   • §6.2 вместо «референсы: mdbtools, Jackcess…» — «fork jetdb + jackcess; mdbtools (GPL) не используется».
   • §9 вместо «сверка с mdbtools/Jackcess» — «сверка jetdb ↔︎ jackcess».
   • Ответ на §10.4: единая SQLCipher-сборка SQLite на весь пакет, провайдер — OpenSSL 3 или CommonCrypto (§3.8).
3. 04-file-formats.md.
   • §4.10: убрать «по подходу MDB Tools».
   • §4.4: VSD — «POI HDGF + [MS-VSDX], libvisio — класс 2».
   • §5.1: добавить outlook-pst, jetdb, office-crypto, ms-offcrypto-writer; для calamine — «adopt для R-сценариев + fork vba.rs».
   • §1.3, корпус, добавить: 211 xlsx и 2 768 тестов IronCalc, ≈2,4 млн эталонов SSF, 86 баз jackcess, тестовые файлы msoffcrypto-tool, ≈8,6 тыс. проверок Univer и formulajs.
4. sheets.md.
   • §4.6: старт — интерпретатор AST (Arc<Node>, общие формулы) из IronCalc, байткод — после бенчмарков.
   • §5.10: meridian-numfmt — порт SSF, эталоны SSF прогоняются в CI.
   • §5.16: симплекс, ветви и границы и отчёты устойчивости — HiGHS через highs/good_lp без coin_cbc; GRG — argmin (L-BFGS) + свой слой активных ограничений; QP — Clarabel.
   • §5.21: csv + encoding_rs + chardetng вместо своей статистики байтов; Polars — для «большого режима» и потоков данных.
   • §5.23: у каждой функции указать источник (IronCalc / formualizer / Univer / своё); 19 своих функций — по списку §3.1.
   • Мастер функций: описания пишем сами.
5. 08-roadmap.md, E2.2.
   • I05: fork IronCalc + адаптер, ≈490 функций (вместо «150 функций»); I06: граф, пересчёт, 500+ функций.
   • Высвобожденные 1–2 Rust FTE — на сводные таблицы и Chart; в I05 — двухнедельный спайк IronCalc против formualizer.
   • E1.4: порт HWPF в I03–I05.
   • E5.6: PST и accdb через outlook-pst и jetdb — эпик дешевле на 7–9 чел.-мес.; есть смысл поднять pst и accdb из P1 в P0 фазы 5.
6. 12-license-policy.md.
   • MS-PL — в класс 2.
   • При двойной лицензии (например, Apache-2.0/LGPL у java-libpst) выбираем разрешительную.
   • Новый особый случай: тексты справки Microsoft внутри чужих проектов (описания функций Univer) не берём; машинно извлечённые схемы (.proto iWork) — только после юридического заключения.
7. deny.toml (фаза 0).
   • Запретить epub (GPL), coin_cbc/coin-cbc-sys (EPL), cssparser/selectors/lightningcss (MPL).
   • onenote_parser — добавить в exceptions после решения владельца.
8. 03-architecture.md.
   • «Один SQLite на процесс — сборка SQLCipher».
   • codec-host — место для изолированных компонентов класса 2, если владелец их одобрит.

8. Непроверенное

Ниже — то, что в этой сессии не проверено. Остальные факты либо есть в oss-verified.tsv, либо проверены 2026-10-04: по клонам, через API crates.io и GitHub или по тексту LICENSE.

Дополнительных веб-запросов в этой сессии — около 45: API crates.io и GitHub, 4 README, LICENSE SQLCipher и 4 клона: POI (частичный), calamine, msoffcrypto-tool, formualizer. Это чуть выше лимита BRIEF (~40); последние запросы ушли на лицензионно значимые вопросы (good_lp, SQLCipher).