confluence-md-sync 0.8.1 → 0.8.3

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 = {}) {
@@ -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;
@@ -355,7 +361,7 @@ class Converter {
                 if (norm === null)
                     return null;
                 const cand = `::: properties${dp.join('')}\n${norm.md}\n:::`;
-                if (!this.verifyNormalizedDetails(cand, norm.rows))
+                if (!this.readable && !this.verifyNormalizedDetails(cand, norm.rows))
                     return null;
                 this.stats.normalized++;
                 return cand; // канонической эквивалентности нет по построению — верифицирован текст
@@ -402,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 — посторонние дети. */
@@ -438,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) {
@@ -1226,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);
@@ -1446,8 +1472,32 @@ function escapeMdText(raw, ctx, readable = false) {
     out += escapePlain(collapsed.slice(last), ctx, readable);
     return out;
 }
+const ESCAPE_SPECIALS = '\\`*[]{}~';
+// Буква/цифра любого алфавита (вкл. кириллицу). Внутрисловное `_` между двумя
+// такими символами по CommonMark не открывает и не закрывает акцент, поэтому
+// экранировать его НЕ нужно.
+const WORDCHAR_RE = /[\p{L}\p{N}]/u;
 function escapePlain(s, _ctx, readable = false) {
-    const esc = s.replace(/[\\`*_[\]{}~]/g, (c) => '\\' + c);
+    let esc = '';
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (c === '_') {
+            // Экранируем `_` только на границе слова (snake_case НЕ трогаем — иначе
+            // выходят уродливые `BA\_M1\_…`). Внутрисловное `_` литерально и в
+            // CommonMark, round-trip остаётся канонически эквивалентным.
+            const prev = s[i - 1];
+            const next = s[i + 1];
+            const intraword = prev !== undefined && next !== undefined &&
+                WORDCHAR_RE.test(prev) && WORDCHAR_RE.test(next);
+            esc += intraword ? '_' : '\\_';
+        }
+        else if (ESCAPE_SPECIALS.includes(c)) {
+            esc += '\\' + c;
+        }
+        else {
+            esc += c;
+        }
+    }
     // Пайпы здесь НЕ трогаем — они экранируются один раз на границе ячейки
     // (cellMd / readableTable), иначе плейсхолдеры {{img:…|…}} двоились бы.
     // readable: неразрывный пробел → обычный; faithful: → entity (переживает

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.1",
+  "version": "0.8.3",
   "description": "Publish Markdown to Confluence (Data Center & Cloud): idempotent page sync, attachment dedup, tables and a pluggable macro system",
   "keywords": [
     "confluence",