confluence-md-sync 0.8.0 → 0.8.2

package/README.md

@@ -327,7 +327,7 @@ that doesn't fit falls back to markers/fenced blocks automatically.
 | Macro | Markdown |
 | --- | --- |
 | `info` / `note` / `warning` / `tip` | `> [!INFO] Title?` + quoted body (GitHub-style admonition) |
-| `details` (Page Properties) | `::: properties [id=…] [hidden=true]` + md-table + `:::` |
+| `details` (Page Properties) | `::: properties [id=…] [hidden=true]` + md-table + `:::` — complex Confluence tables are normalized to GFM on export (styling dropped, cell text verified; `stats.normalized`) |
 | `expand` | `::: expand Title` + body + `:::` |
 | `panel` | `::: panel title=… borderColor=…` + body + `:::` |
 | `toc` | `{{toc}}` / `{{toc:maxLevel=3}}` |

package/dist/export/to-markdown.d.ts

@@ -63,6 +63,8 @@ export interface StorageToMarkdownResult {
         lossy: number;
         /** Макросы, выраженные нативным md-синтаксисом (панели, ::: …, {{…}}). */
         native: number;
+        /** details, чья таблица нормализована в GFM (оформление потеряно, текст сверен). */
+        normalized: number;
     };
 }
 /** Конвертирует storage-фрагмент страницы в Markdown. */

package/dist/export/to-markdown.js

@@ -25,6 +25,7 @@ import { processMacros } from '../macros/registry.js';
 import { defaultMacroRegistry } from '../macros/index.js';
 import { renderToStorage } from '../markdown/render.js';
 import { compareStorage } from './canonical.js';
+import { NOTICE_MACRO_ID } from '../publish/notice.js';
 import { decodeEntities, elements, getAttr, hasNamespacedElements, parseStorage, serializeStorage, textContent, } from './xhtml.js';
 /** Конвертирует storage-фрагмент страницы в Markdown. */
 export function storageToMarkdown(storage, opts = {}) {
@@ -79,7 +80,7 @@ class Converter {
     registry;
     images = new Set();
     files = new Set();
-    stats = { markers: 0, fenced: 0, rawHtml: 0, lossy: 0, native: 0 };
+    stats = { markers: 0, fenced: 0, rawHtml: 0, lossy: 0, native: 0, normalized: 0 };
     readable;
     localFiles;
     tablesAsRecords;
@@ -283,7 +284,14 @@ class Converter {
         }
         // p / td / th / li / caption и прочие «инлайн-контейнеры» → инлайн.
         // multiline: это свободный поток (не ячейка) — <br> станет переносом.
-        const inline = this.inlineToMd(el.children, { multiline: true }).trim();
+        let inline = '';
+        try {
+            inline = this.inlineToMd(el.children, { multiline: true }).trim();
+        }
+        catch (e) {
+            if (!(e instanceof Unrepresentable))
+                throw e; /* → голый текст ниже */
+        }
         if (inline !== '')
             return inline.split('\n').map((l) => guardLineStart(l)).join('\n');
         // Совсем ничего не вышло — голый текст (может быть пустым).
@@ -301,8 +309,6 @@ class Converter {
         anchor: 'anchor', detailssummary: 'properties-report',
     };
     tryNativeMd(el, name) {
-        if (this.readable)
-            return null; // readable-путь остаётся прежним
         const parts = this.macroParts(el);
         if (parts === null)
             return null;
@@ -334,19 +340,32 @@ class Converter {
             const nonWs = richBody.children.filter((n) => !(n.kind === 'text' && /^[ \t\r\n]*$/.test(n.raw)));
             if (bodyEls.length !== 1 || nonWs.length !== 1 || bodyEls[0].name !== 'table')
                 return null;
-            let tableMd;
+            const dp = [...pmap.entries()].map(([k, v]) => (oneline(v) && !/["\s]/.test(v) ? ` ${k}=${v}` : null));
+            if (dp.some((x) => x === null))
+                return null;
+            let tableMd = null;
             try {
                 tableMd = this.tableToMd(bodyEls[0]);
             }
             catch (e) {
-                if (e instanceof Unrepresentable)
+                if (!(e instanceof Unrepresentable))
+                    throw e;
+            }
+            if (tableMd !== null) {
+                candidate = `::: properties${dp.join('')}\n${tableMd}\n:::`;
+            }
+            else {
+                // «Свойства страницы» обязаны жить md-таблицей: сложную таблицу
+                // нормализуем в GFM (оформление теряется, текст сверяется рендером).
+                const norm = this.propertiesGridMd(bodyEls[0]);
+                if (norm === null)
                     return null;
-                throw e;
+                const cand = `::: properties${dp.join('')}\n${norm.md}\n:::`;
+                if (!this.readable && !this.verifyNormalizedDetails(cand, norm.rows))
+                    return null;
+                this.stats.normalized++;
+                return cand; // канонической эквивалентности нет по построению — верифицирован текст
             }
-            const dp = [...pmap.entries()].map(([k, v]) => (oneline(v) && !/["\s]/.test(v) ? ` ${k}=${v}` : null));
-            if (dp.some((x) => x === null))
-                return null;
-            candidate = `::: properties${dp.join('')}\n${tableMd}\n:::`;
         }
         else if (name === 'expand' && richBody !== null) {
             if (![...pmap.keys()].every((k) => k === 'title'))
@@ -389,6 +408,8 @@ class Converter {
         }
         if (candidate === null)
             return null;
+        if (this.readable)
+            return candidate; // readable: без канонической верификации (режим и так lossy)
         return this.verifyMacroMarker(el, candidate) ? candidate : null;
     }
     /** Разбирает macro-элемент на параметры и тела; null — посторонние дети. */
@@ -425,6 +446,9 @@ class Converter {
         }
     }
     macroToMd(el) {
+        // Баннер managedNotice — артефакт публикации, в md-источник не попадает никогда.
+        if (getAttr(el, 'ac:macro-id') === NOTICE_MACRO_ID)
+            return '';
         const name = getAttr(el, 'ac:name') ?? '';
         const nativeMd = this.tryNativeMd(el, name);
         if (nativeMd !== null) {
@@ -518,6 +542,110 @@ class Converter {
         return this.verifyMacroMarker(el, markerMd) ? markerMd : null;
     }
     /** Маркер → render-конвейер → канонически равен исходному макросу? */
+    /** Таблица details → нормализованный GFM: пустые колонки (нумерация) отброшены,
+     * заголовок синтезируется («Поле|Значение» для двух колонок). null — не таблица. */
+    /** Убирает ac:/ri:-вставки без текста (упоминания пользователей, эмодзи):
+     * в md им нечем быть, а их присутствие роняло flatten всей ячейки. */
+    stripEmptyNamespaced(nodes) {
+        const out = [];
+        for (const n of nodes) {
+            if (n.kind === 'el') {
+                if (n.name.includes(':') && textContent(n.children).trim() === '')
+                    continue;
+                out.push({ ...n, children: this.stripEmptyNamespaced(n.children) });
+            }
+            else
+                out.push(n);
+        }
+        return out;
+    }
+    /** Таблица details → нормализованный GFM: пустые колонки (нумерация) отброшены,
+     * заголовок синтезируется («Поле|Значение» для двух колонок). Ячейки — readable-
+     * flatten; несовместимые вставки (напр. упоминание пользователя) — в голый текст.
+     * null — не таблица/пусто. */
+    propertiesGridMd(table) {
+        const saved = this.readable;
+        this.readable = true;
+        try {
+            const trs = [];
+            for (const child of elements(table.children)) {
+                if (['thead', 'tbody', 'tfoot'].includes(child.name)) {
+                    for (const tr of elements(child.children))
+                        if (tr.name === 'tr')
+                            trs.push(tr);
+                }
+                else if (child.name === 'tr')
+                    trs.push(child);
+            }
+            if (trs.length === 0)
+                return null;
+            const grid = trs.map((tr) => elements(tr.children)
+                .filter((c) => c.name === 'td' || c.name === 'th')
+                .map((c) => {
+                let flat;
+                try {
+                    flat = this.cellFlatten(this.stripEmptyNamespaced(c.children));
+                }
+                catch (e) {
+                    if (!(e instanceof Unrepresentable))
+                        throw e;
+                    flat = textContent(c.children);
+                }
+                return flat.replace(/\s+/g, ' ').trim();
+            }));
+            const cols = Math.max(...grid.map((r) => r.length));
+            const norm = grid.map((r) => Array.from({ length: cols }, (_, i) => r[i] ?? ''));
+            const keep = Array.from({ length: cols }, (_, i) => norm.some((r) => r[i] !== ''));
+            const rows = norm.map((r) => r.filter((_, i) => keep[i])).filter((r) => r.some((c) => c !== ''));
+            const width = rows[0]?.length ?? 0;
+            if (width === 0 || rows.some((r) => r.length !== width))
+                return null;
+            const esc = (s) => s.replace(/\|/g, '\\|');
+            const header = width === 2 ? ['Поле', 'Значение'] : rows[0].map(() => ' ');
+            const line = (cells) => `| ${cells.map(esc).join(' | ')} |`;
+            const md = [line(header), `| ${header.map(() => '---').join(' | ')} |`, ...rows.map(line)].join('\n');
+            return { md, rows };
+        }
+        finally {
+            this.readable = saved;
+        }
+    }
+    /** Нормализованные details: рендерим кандидата и сверяем ТЕКСТ ячеек с исходным. */
+    verifyNormalizedDetails(candidate, rows) {
+        try {
+            let storage = renderToStorage(candidate, { images: new Map(), files: new Map() }, { imageStyle: 'attachment', fileStyle: 'attachment', linkify: false });
+            storage = processMacros(storage, this.registry).toString();
+            let renderedTable = null;
+            const walk = (ns) => {
+                for (const n of elements(ns)) {
+                    if (renderedTable)
+                        return;
+                    if (n.name === 'table') {
+                        renderedTable = n;
+                        return;
+                    }
+                    walk(n.children);
+                }
+            };
+            walk(parseStorage(storage));
+            if (!renderedTable)
+                return false;
+            const backNorm = this.propertiesGridMd(renderedTable);
+            if (backNorm === null)
+                return false;
+            const back = backNorm.rows;
+            const width = rows[0]?.length ?? 0;
+            const headerIsSynth = back.length > 0 &&
+                (width === 2 ? back[0][0] === 'Поле' && back[0][1] === 'Значение' : back[0].every((c) => c === ''));
+            const body = headerIsSynth ? back.slice(1) : back;
+            if (body.length !== rows.length)
+                return false;
+            return body.every((r, i) => r.length === rows[i].length && r.every((c, j) => c === rows[i][j]));
+        }
+        catch {
+            return false;
+        }
+    }
     verifyMacroMarker(el, markerMd) {
         try {
             let storage = renderToStorage(markerMd, { images: new Map(), files: new Map() }, { imageStyle: 'attachment', fileStyle: 'attachment', linkify: false });
@@ -1109,6 +1237,21 @@ class Converter {
         return `{{img:${filename}${attrStr}}}`;
     }
     acLinkToMd(el) {
+        // readable безотказен: непредставимая ссылка (user-mention, ссылка без цели,
+        // card-appearance) деградирует до своего текста.
+        if (this.readable) {
+            try {
+                return this.acLinkStrict(el);
+            }
+            catch (e) {
+                if (!(e instanceof Unrepresentable))
+                    throw e;
+                return escapeMdText(textContent(el.children), {}, true).trim();
+            }
+        }
+        return this.acLinkStrict(el);
+    }
+    acLinkStrict(el) {
         if (el.attrs.length > 0)
             throw new Unrepresentable();
         const kids = elements(el.children);

package/dist/publish/notice.d.ts

@@ -28,6 +28,7 @@ export interface ManagedNoticeOptions {
 }
 export declare const DEFAULT_MANAGED_NOTICE_TEXT: string;
 export declare const DEFAULT_MANAGED_NOTICE_LINK_TEXT = "docs-studio";
+export declare const NOTICE_MACRO_ID = "0f0e0d0c-0b0a-4009-8008-000000000001";
 /** Строит storage-разметку баннера (одиночный `<ac:structured-macro>`). */
 export declare function buildManagedNotice(opts: ManagedNoticeOptions): string;
 /** Дописывает баннер в начало (top) или конец (bottom) storage-контента. */

package/dist/publish/notice.js

@@ -12,7 +12,7 @@ export const DEFAULT_MANAGED_NOTICE_LINK_TEXT = 'docs-studio';
 // Фиксированный ac:macro-id: баннер обязан давать БАЙТ-В-БАЙТ одинаковый
 // storage при каждой публикации. Со случайным id (generateMacroId) content-
 // hash менялся бы каждый раз → страница вечно считалась бы изменённой.
-const NOTICE_MACRO_ID = '0f0e0d0c-0b0a-4009-8008-000000000001';
+export const NOTICE_MACRO_ID = '0f0e0d0c-0b0a-4009-8008-000000000001';
 /** Собирает `<a href>`-ссылку на источник. */
 function noticeLink(opts) {
     const text = opts.linkText ?? DEFAULT_MANAGED_NOTICE_LINK_TEXT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-md-sync",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Publish Markdown to Confluence (Data Center & Cloud): idempotent page sync, attachment dedup, tables and a pluggable macro system",
   "keywords": [
     "confluence",