@alfacapital-tech/c4builder 0.3.0-rc.1 → 0.3.0-rc.3

package/dist/util/utils.js

@@ -1,30 +1,15 @@
 import fs from 'node:fs';
 import zlib from 'node:zlib';
-// makeDirectory намеренно резолвится и при ошибке mkdir (легаси-поведение — не чинить).
-const makeDirectory = (path) => new Promise((resolve) => {
-    fs.mkdir(path, () => {
-        return resolve();
-    });
-});
-// type не передаётся ни одним вызовом → encoding отсутствует → data приходит Buffer'ом;
-// сохраняем union из оверлоада fs (потребители зовут .toString()/шаблоны).
-const readFile = (path, type) => new Promise((resolve, reject) => {
-    fs.readFile(path, type, (err, data) => {
-        if (err)
-            return reject(err);
-        return resolve(data);
-    });
-});
-const writeFile = (path, data) => new Promise((resolve, reject) => {
-    // res опционален: fs.writeFile отдаёт NoParamCallback, второй аргумент — всегда undefined.
-    fs.writeFile(path, data, (err, res) => {
-        if (err)
-            return reject(err);
-        return resolve(res);
-    });
-});
-// _fn игнорируется (легаси-заглушка — не чинить).
-const writeOnSameLine = async (message, _fn) => {
+// mkdir -p: недостающие родители создаются, существующий каталог — не ошибка.
+// Реальные сбои (EACCES/EROFS) пробрасываются — раньше глотались молча, и сборка
+// падала позже невнятной ошибкой записи в несуществующий каталог.
+const makeDirectory = async (path) => {
+    await fs.promises.mkdir(path, { recursive: true });
+};
+// Кодировка не передаётся ни одним вызовом → всегда Buffer (потребители зовут .toString()).
+const readFile = (path) => fs.promises.readFile(path);
+const writeFile = (path, data) => fs.promises.writeFile(path, data);
+const writeOnSameLine = async (message) => {
     process.stdout.write(`${message}\r`);
 };
 const encodeURIPath = (path) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfacapital-tech/c4builder",
-  "version": "0.3.0-rc.1",
+  "version": "0.3.0-rc.3",
   "description": "A CLI tool designed to compile a folder structure of markdowns and plant uml files into a site, single file markdown or a collection of markdowns with links",
   "type": "module",
   "main": "dist/index.js",
@@ -10,6 +10,8 @@
   "files": [
     "dist/",
     "template/",
+    "!template/docs",
+    "!template/.c4builder",
     "vendor/",
     "README.MD",
     "license"
@@ -34,6 +36,8 @@
     "check": "biome ci .",
     "pretest": "npm run build",
     "test": "vitest run",
+    "pretest:unit": "npm run build",
+    "test:unit": "vitest run --exclude \"**/golden.test.mjs\"",
     "test:golden": "npm run build && vitest run test/golden.test.mjs",
     "test:golden:update": "npm run build && UPDATE_GOLDEN=1 vitest run test/golden.test.mjs"
   },

package/vendor/fonts/README.md

@@ -1,17 +1,20 @@
 # Вендорные шрифты
 
-## Liberation Sans
+## Nimbus Sans
 
-`LiberationSans-{Regular,Bold,Italic,BoldItalic}.ttf`
+`NimbusSans-{Regular,Bold,Italic,BoldItalic}.otf`
 
 - **Назначение:** детерминизм метрик текста в SVG. Ширина текста (`textLength`)
   считается PlantUML из AWT-метрик шрифта; системный `sans-serif` резолвится
   по-разному на разных машинах. Шрифт отдаётся JVM через
-  `-Dsun.java2d.fontpath=prepend:` + `-SdefaultFontName=Liberation Sans`, чтобы
-  метрики не зависели от машины (см. `build.js`).
-- **Происхождение:** пакет `ttf-liberation` / `fonts-liberation`, версия 2.1.5
-  (font version 2.1). Метрически совместим с Arial; та же версия поставляется на
-  CI-раннере `ubuntu-24.04`.
-- **Лицензия:** SIL Open Font License 1.1 (разрешает вендоринг и распространение).
-  Полный текст: <https://openfontlicense.org/> · апстрим:
-  <https://github.com/liberationfonts/liberation-fonts>.
+  `-Dsun.java2d.fontpath=prepend:` + `-SdefaultFontName=Nimbus Sans` и resvg через
+  `fontDirs` (см. `src/core/render/fonts.ts`). Пин снимается ключом `useSystemFonts`
+  в `.c4builder` / флагом `--system-fonts` — тогда рендер идёт системным шрифтом и
+  перестаёт быть машинонезависимым.
+- **Происхождение:** URW base35 (Artifex), релиз 20200910 — файлы побайтно совпадают
+  с пакетом `gsfonts` этой версии. Метрически совместим с Helvetica, содержит
+  кириллицу и греческий. Апстрим:
+  <https://github.com/ArtifexSoftware/urw-base35-fonts>.
+- **Лицензия:** AGPL-3.0-only с шрифтовым исключением
+  (`PS-or-PDF-font-exception-20170817`): встраивание шрифта в документы не делает их
+  производными работами. Полный текст — в апстрим-репозитории (`LICENSE`).