@alfacapital-tech/c4builder 0.5.0-rc.1 → 0.5.1

package/dist/plugins/openspec/render.js

@@ -87,10 +87,13 @@ const FENCE_LANGS = ['plantuml', 'puml', 'd2'];
  * Markdown одного исходного файла → страница сайта: fenced-диаграммы вырезаются, ссылки
  * на другие страницы источника (`target`, `#x` → `?id=x`) — на их адреса, прочие
  * относительные ссылки на существующие файлы источника регистрируются для копирования к
- * странице (картинки docsify грузит относительно страницы, обычные ссылки — от корня сайта).
- * `fromDir` — posix-каталог файла относительно `srcRoot` (ссылки в нём резолвятся от файла).
+ * странице (картинки и embed docsify грузит относительно страницы, обычные ссылки — от корня
+ * сайта). Embed `':include'` markdown-файла встраивается при сборке: сырой файл docsify
+ * показал бы без локального рендера диаграмм и переписывания ссылок.
+ * `fromDir` — posix-каталог файла относительно `srcRoot` (ссылки в нём резолвятся от файла),
+ * `pageDir` — каталог, от которого считаются пути файлов страницы (у встроенного — каталог страницы).
  */
-export const renderMarkdown = (pagePath, base, content, { srcRoot, fromDir = '', target = () => undefined, source, options }) => {
+export const renderMarkdown = (pagePath, base, content, { srcRoot, fromDir = '', pageDir = fromDir, included = new Set(), target = () => undefined, source, options }) => {
     const { markdown, diagrams } = createFenceExtractor(FENCE_LANGS).extract(content, base, source);
     const files = [];
     const rewrite = (t) => t.replace(LINK_RE, (whole, bang, text, href, title = '') => {
@@ -114,10 +117,28 @@ export const renderMarkdown = (pagePath, base, content, { srcRoot, fromDir = '',
         const abs = path.join(srcRoot, rel);
         if (!fs.existsSync(abs) || fs.statSync(abs).isDirectory())
             return whole;
-        files.push({ from: rel, to: decoded });
-        return bang
-            ? `![${inner}](${href}${title})`
-            : `[${inner}](${encodeURIPath(path.posix.join(...pagePath, decoded))}${ignoreTitle(title)})`;
+        const embed = !bang && /:include\b/.test(title);
+        if (embed && /\.md$/i.test(rel) && !included.has(rel)) {
+            const dir = path.posix.dirname(rel);
+            const sub = renderMarkdown(pagePath, base, fs.readFileSync(abs, 'utf8'), {
+                srcRoot,
+                fromDir: dir === '.' ? '' : dir,
+                pageDir,
+                included: new Set([...included, rel]),
+                target,
+                source: relSource(srcRoot, rel),
+                options
+            });
+            diagrams.push(...sub.diagrams);
+            files.push(...sub.files);
+            return sub.markdown;
+        }
+        const sameDir = fromDir === pageDir;
+        const to = sameDir ? decoded : path.posix.relative(pageDir, rel);
+        files.push({ from: rel, to });
+        return bang || embed
+            ? `${bang}[${inner}](${sameDir ? href : encodeURIPath(to)}${title})`
+            : `[${inner}](${encodeURIPath(path.posix.join(...pagePath, to))}${ignoreTitle(title)})`;
     });
     return { path: pagePath, markdown: mapOutsideFences(markdown, rewrite).trim(), diagrams, files };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfacapital-tech/c4builder",
-  "version": "0.5.0-rc.1",
+  "version": "0.5.1",
   "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",