confluence-md-sync 0.8.0 → 0.8.1

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

@@ -79,7 +79,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;
@@ -334,19 +334,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.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'))
@@ -518,6 +531,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 });

package/package.json

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