confluence-md-sync 0.1.1

package/dist/macros/index.d.ts

@@ -0,0 +1,44 @@
+export { paramMap, type MacroDefinition, type MacroParam, type MacroPlugin, type MacroRenderer, type RendererContext, } from './types.js';
+export { MacroBuilder, macro, escapeParamValue, unescapeParamValue } from './builder.js';
+export { MacroRegistry, processMacros } from './registry.js';
+export { escapeXmlAttr, generateMacroId, structuredMacro, pageLinkValue, type StructuredMacroOptions, } from './xml.js';
+export { coreMacrosPlugin, extractPlainText } from './plugins/core.js';
+export { tableFilterPlugin, TABLE_FILTER_DEFAULTS } from './plugins/table-filter.js';
+import { MacroRegistry } from './registry.js';
+import { anchor, children, codeBlock, excerpt, excerptInclude, expand, includePage, jiraIssue, panel, status, toc } from './plugins/core.js';
+import { tableExcerpt, tableExcerptInclude, tableFilter } from './plugins/table-filter.js';
+/** Creates a registry pre-loaded with all built-in plugins. */
+export declare function createDefaultRegistry(): MacroRegistry;
+/**
+ * Глобальный реестр по умолчанию (core + table-filter). Используется,
+ * если в publishPage/processMacros не передан свой registry.
+ */
+export declare const defaultMacroRegistry: MacroRegistry;
+/** Возвращает глобальный реестр макросов. */
+export declare function getMacroRegistry(): MacroRegistry;
+/**
+ * Namespace с построителями макросов — генерируют маркеры в Markdown.
+ *
+ * @example
+ *   macros.tableFilter(macros.tableExcerpt(tableMd, 'jira_fact'), { totalrow: ',,Sum' })
+ */
+export declare const macros: {
+    expand: typeof expand;
+    note: (body: import("../index.js").Markdown | string, title?: string) => import("../index.js").Markdown;
+    info: (body: import("../index.js").Markdown | string, title?: string) => import("../index.js").Markdown;
+    warning: (body: import("../index.js").Markdown | string, title?: string) => import("../index.js").Markdown;
+    tip: (body: import("../index.js").Markdown | string, title?: string) => import("../index.js").Markdown;
+    panel: typeof panel;
+    codeBlock: typeof codeBlock;
+    status: typeof status;
+    toc: typeof toc;
+    jiraIssue: typeof jiraIssue;
+    anchor: typeof anchor;
+    children: typeof children;
+    includePage: typeof includePage;
+    excerpt: typeof excerpt;
+    excerptInclude: typeof excerptInclude;
+    tableExcerpt: typeof tableExcerpt;
+    tableFilter: typeof tableFilter;
+    tableExcerptInclude: typeof tableExcerptInclude;
+};

package/dist/macros/index.js

@@ -0,0 +1,50 @@
+export { paramMap, } from './types.js';
+export { MacroBuilder, macro, escapeParamValue, unescapeParamValue } from './builder.js';
+export { MacroRegistry, processMacros } from './registry.js';
+export { escapeXmlAttr, generateMacroId, structuredMacro, pageLinkValue, } from './xml.js';
+export { coreMacrosPlugin, extractPlainText } from './plugins/core.js';
+export { tableFilterPlugin, TABLE_FILTER_DEFAULTS } from './plugins/table-filter.js';
+import { MacroRegistry } from './registry.js';
+import { coreMacrosPlugin } from './plugins/core.js';
+import { tableFilterPlugin } from './plugins/table-filter.js';
+import { anchor, children, codeBlock, excerpt, excerptInclude, expand, includePage, info, jiraIssue, note, panel, status, tip, toc, warning, } from './plugins/core.js';
+import { tableExcerpt, tableExcerptInclude, tableFilter } from './plugins/table-filter.js';
+/** Creates a registry pre-loaded with all built-in plugins. */
+export function createDefaultRegistry() {
+    return new MacroRegistry().use(coreMacrosPlugin).use(tableFilterPlugin);
+}
+/**
+ * Глобальный реестр по умолчанию (core + table-filter). Используется,
+ * если в publishPage/processMacros не передан свой registry.
+ */
+export const defaultMacroRegistry = createDefaultRegistry();
+/** Возвращает глобальный реестр макросов. */
+export function getMacroRegistry() {
+    return defaultMacroRegistry;
+}
+/**
+ * Namespace с построителями макросов — генерируют маркеры в Markdown.
+ *
+ * @example
+ *   macros.tableFilter(macros.tableExcerpt(tableMd, 'jira_fact'), { totalrow: ',,Sum' })
+ */
+export const macros = {
+    expand,
+    note,
+    info,
+    warning,
+    tip,
+    panel,
+    codeBlock,
+    status,
+    toc,
+    jiraIssue,
+    anchor,
+    children,
+    includePage,
+    excerpt,
+    excerptInclude,
+    tableExcerpt,
+    tableFilter,
+    tableExcerptInclude,
+};

package/dist/macros/plugins/core.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Core plugin: built-in Confluence macros available out of the box.
+ *
+ * Rich-body macros (expand, note, panel, …) wrap already-rendered XHTML.
+ * Bodyless macros (toc, status, jira, …) pass their params through.
+ */
+import { Markdown } from '../../markdown/markdown.js';
+import { type MacroPlugin } from '../types.js';
+/** Unwraps `<pre><code>…</code></pre>` / `<p>…</p>` and decodes HTML entities. */
+export declare function extractPlainText(body: string): string;
+export declare const coreMacrosPlugin: MacroPlugin;
+/** Обёртывает markdown в макрос "развернуть". */
+export declare function expand(body: Markdown | string, title?: string): Markdown;
+/** Обёртывает markdown в макрос "примечание". */
+export declare const note: (body: Markdown | string, title?: string) => Markdown;
+/** Обёртывает markdown в макрос "информация". */
+export declare const info: (body: Markdown | string, title?: string) => Markdown;
+/** Обёртывает markdown в макрос "предупреждение". */
+export declare const warning: (body: Markdown | string, title?: string) => Markdown;
+/** Обёртывает markdown в макрос "совет". */
+export declare const tip: (body: Markdown | string, title?: string) => Markdown;
+/** Обёртывает markdown в панель с произвольными параметрами (title, borderColor, bgColor, …). */
+export declare function panel(body: Markdown | string, opts?: Record<string, string | undefined>): Markdown;
+/** Блок кода с подсветкой. Тело — сырой текст программы. */
+export declare function codeBlock(source: string, opts?: {
+    language?: string;
+    title?: string;
+    linenumbers?: boolean;
+    collapse?: boolean;
+}): Markdown;
+/** Статус-лейбл: status('Green', 'ON TRACK'). */
+export declare function status(colour: string, title: string, subtle?: boolean): Markdown;
+/** Оглавление страницы. Параметры — как у Confluence toc (maxLevel, minLevel, style, …). */
+export declare function toc(opts?: Record<string, string | undefined>): Markdown;
+/** Ссылка-карточка на задачу Jira по ключу. */
+export declare function jiraIssue(key: string, opts?: Record<string, string | undefined>): Markdown;
+/** Якорь для внутристраничных ссылок. */
+export declare function anchor(name: string): Markdown;
+/** Список дочерних страниц. */
+export declare function children(opts?: Record<string, string | undefined>): Markdown;
+/** Включение другой страницы целиком. */
+export declare function includePage(page: string, space?: string): Markdown;
+/** Именованный excerpt (переиспользуемый фрагмент страницы). */
+export declare function excerpt(body: Markdown | string, hidden?: boolean): Markdown;
+/** Включение excerpt с другой страницы. */
+export declare function excerptInclude(page: string, opts?: {
+    space?: string;
+    nopanel?: boolean;
+}): Markdown;

package/dist/macros/plugins/core.js

@@ -0,0 +1,214 @@
+/**
+ * Core plugin: built-in Confluence macros available out of the box.
+ *
+ * Rich-body macros (expand, note, panel, …) wrap already-rendered XHTML.
+ * Bodyless macros (toc, status, jira, …) pass their params through.
+ */
+import { macro } from '../builder.js';
+import { paramMap } from '../types.js';
+import { pageLinkValue, structuredMacro } from '../xml.js';
+/** Rich-body macro that forwards the listed params (if present). */
+function richBodyMacro(name, allowedParams) {
+    return {
+        name,
+        render: (ctx) => {
+            const params = ctx.params
+                .filter((p) => !allowedParams || allowedParams.includes(p.name))
+                .map((p) => ({ name: p.name, value: p.value }));
+            return structuredMacro(name, ctx.macroId, { params, richBody: ctx.body });
+        },
+    };
+}
+/** Bodyless macro: params pass through, body (if any) is discarded. */
+function bodylessMacro(name) {
+    return {
+        name,
+        render: (ctx) => structuredMacro(name, ctx.macroId, { params: ctx.params }),
+    };
+}
+/**
+ * `code` macro: the body must be plain text inside CDATA. By the time
+ * processMacros runs, markdown-it has already rendered the body — a fenced
+ * code block becomes `<pre><code>…</code></pre>` with escaped entities.
+ * We unwrap that and decode entities back to raw source text.
+ */
+const codeMacro = {
+    name: 'code',
+    render: (ctx) => {
+        const map = paramMap(ctx.params);
+        const params = ctx.params.filter((p) => ['language', 'title', 'linenumbers', 'collapse', 'firstline', 'theme'].includes(p.name));
+        void map;
+        return structuredMacro('code', ctx.macroId, {
+            params,
+            plainBody: extractPlainText(ctx.body),
+        });
+    },
+};
+/** Unwraps `<pre><code>…</code></pre>` / `<p>…</p>` and decodes HTML entities. */
+export function extractPlainText(body) {
+    let text = body.trim();
+    const pre = text.match(/^<pre[^>]*><code[^>]*>([\s\S]*?)<\/code><\/pre>$/);
+    if (pre) {
+        text = pre[1].replace(/\n$/, '');
+    }
+    else {
+        const p = text.match(/^<p[^>]*>([\s\S]*?)<\/p>$/);
+        if (p)
+            text = p[1];
+    }
+    return text
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&#39;/g, "'")
+        .replace(/&amp;/g, '&');
+}
+/** `anchor`: the anchor name goes into the unnamed (`""`) parameter. */
+const anchorMacro = {
+    name: 'anchor',
+    render: (ctx) => {
+        const map = paramMap(ctx.params);
+        return structuredMacro('anchor', ctx.macroId, {
+            params: [{ name: '', value: map.name ?? '' }],
+        });
+    },
+};
+/** `include`: includes another page; page reference goes into the unnamed param as ac:link. */
+const includeMacro = {
+    name: 'include',
+    render: (ctx) => {
+        const map = paramMap(ctx.params);
+        return structuredMacro('include', ctx.macroId, {
+            params: [{ name: '', value: pageLinkValue(map.page ?? '', map.space), raw: true }],
+        });
+    },
+};
+/** `excerpt-include`: transcludes a named excerpt from another page. */
+const excerptIncludeMacro = {
+    name: 'excerpt-include',
+    render: (ctx) => {
+        const map = paramMap(ctx.params);
+        const params = [
+            { name: '', value: pageLinkValue(map.page ?? '', map.space), raw: true },
+        ];
+        if (map.nopanel)
+            params.push({ name: 'nopanel', value: map.nopanel });
+        return structuredMacro('excerpt-include', ctx.macroId, { params });
+    },
+};
+export const coreMacrosPlugin = {
+    name: 'core',
+    macros: [
+        // Rich-body containers
+        richBodyMacro('expand', ['title']),
+        richBodyMacro('note', ['title', 'icon']),
+        richBodyMacro('info', ['title', 'icon']),
+        richBodyMacro('warning', ['title', 'icon']),
+        richBodyMacro('tip', ['title', 'icon']),
+        richBodyMacro('panel'),
+        richBodyMacro('excerpt', ['hidden', 'atlassian-macro-output-type']),
+        // Plain-text body
+        codeMacro,
+        // Bodyless
+        bodylessMacro('toc'),
+        bodylessMacro('status'),
+        bodylessMacro('jira'),
+        bodylessMacro('children'),
+        bodylessMacro('pagetree'),
+        bodylessMacro('recently-updated'),
+        anchorMacro,
+        includeMacro,
+        excerptIncludeMacro,
+    ],
+};
+// ── Convenience builders (produce macro markers in Markdown) ────────────
+/** Обёртывает markdown в макрос "развернуть". */
+export function expand(body, title) {
+    const builder = macro('expand').body(body);
+    if (title)
+        builder.param('title', title);
+    return builder.toMarkdown();
+}
+function admonition(name) {
+    return (body, title) => {
+        const builder = macro(name).body(body);
+        if (title)
+            builder.param('title', title);
+        return builder.toMarkdown();
+    };
+}
+/** Обёртывает markdown в макрос "примечание". */
+export const note = admonition('note');
+/** Обёртывает markdown в макрос "информация". */
+export const info = admonition('info');
+/** Обёртывает markdown в макрос "предупреждение". */
+export const warning = admonition('warning');
+/** Обёртывает markdown в макрос "совет". */
+export const tip = admonition('tip');
+/** Обёртывает markdown в панель с произвольными параметрами (title, borderColor, bgColor, …). */
+export function panel(body, opts = {}) {
+    return macro('panel').withParams(opts).body(body).toMarkdown();
+}
+/** Блок кода с подсветкой. Тело — сырой текст программы. */
+export function codeBlock(source, opts = {}) {
+    const builder = macro('code');
+    if (opts.language)
+        builder.param('language', opts.language);
+    if (opts.title)
+        builder.param('title', opts.title);
+    if (opts.linenumbers)
+        builder.param('linenumbers', 'true');
+    if (opts.collapse)
+        builder.param('collapse', 'true');
+    // Тело оборачиваем в fenced block, чтобы markdown-it не тронул содержимое
+    // и code-renderer смог вытащить plain text из <pre><code>.
+    return builder.body('```\n' + source + '\n```').toMarkdown();
+}
+/** Статус-лейбл: status('Green', 'ON TRACK'). */
+export function status(colour, title, subtle = false) {
+    const builder = macro('status').param('colour', colour).param('title', title);
+    if (subtle)
+        builder.param('subtle', 'true');
+    return builder.toMarkdown();
+}
+/** Оглавление страницы. Параметры — как у Confluence toc (maxLevel, minLevel, style, …). */
+export function toc(opts = {}) {
+    return macro('toc').withParams(opts).toMarkdown();
+}
+/** Ссылка-карточка на задачу Jira по ключу. */
+export function jiraIssue(key, opts = {}) {
+    return macro('jira').param('key', key).withParams(opts).toMarkdown();
+}
+/** Якорь для внутристраничных ссылок. */
+export function anchor(name) {
+    return macro('anchor').param('name', name).toMarkdown();
+}
+/** Список дочерних страниц. */
+export function children(opts = {}) {
+    return macro('children').withParams(opts).toMarkdown();
+}
+/** Включение другой страницы целиком. */
+export function includePage(page, space) {
+    const builder = macro('include').param('page', page);
+    if (space)
+        builder.param('space', space);
+    return builder.toMarkdown();
+}
+/** Именованный excerpt (переиспользуемый фрагмент страницы). */
+export function excerpt(body, hidden = false) {
+    const builder = macro('excerpt').body(body);
+    if (hidden)
+        builder.param('hidden', 'true');
+    return builder.toMarkdown();
+}
+/** Включение excerpt с другой страницы. */
+export function excerptInclude(page, opts = {}) {
+    const builder = macro('excerpt-include').param('page', page);
+    if (opts.space)
+        builder.param('space', opts.space);
+    if (opts.nopanel)
+        builder.param('nopanel', 'true');
+    return builder.toMarkdown();
+}

package/dist/macros/plugins/table-filter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Plugin for the "Table Filter and Charts for Confluence" app macros:
+ * table-excerpt, table-filter, table-excerpt-include.
+ */
+import { Markdown } from '../../markdown/markdown.js';
+import { type MacroPlugin } from '../types.js';
+export declare const TABLE_FILTER_DEFAULTS: Record<string, string>;
+export declare const tableFilterPlugin: MacroPlugin;
+/**
+ * Обёртывает markdown в макрос "выборка таблицы".
+ *
+ * @example
+ *   tableExcerpt(tableMarkdown, 'jira_fact', true)
+ */
+export declare function tableExcerpt(body: Markdown | string, name?: string, hide?: boolean): Markdown;
+/**
+ * Обёртывает markdown в макрос "фильтрация таблицы".
+ *
+ * Применяет полный набор дефолтов, какой Confluence-редактор сохраняет
+ * при создании макроса — в том числе пустые-присутствие параметры
+ * (`fixedCols`, `column`, etc). Без них макрос рендерит контролы как
+ * отдельную панель НАД таблицей; с дефолтом `hidePane=Table header`
+ * фильтры встают в шапку колонок. Caller перекрывает что нужно через
+ * `opts` (например `totalrow`); пустая строка в opts означает «оставить
+ * как пустое-присутствие», не удаление.
+ *
+ * @example
+ *   tableFilter(tableExcerptMd, { totalrow: ',,,Sum,Sum,Sum' })
+ */
+export declare function tableFilter(body: Markdown | string, opts?: Record<string, string | undefined>): Markdown;
+/** Включение table-excerpt с другой страницы по имени выборки. */
+export declare function tableExcerptInclude(name: string, page: string, opts?: {
+    space?: string;
+    type?: string;
+}): Markdown;

package/dist/macros/plugins/table-filter.js

@@ -0,0 +1,155 @@
+/**
+ * Plugin for the "Table Filter and Charts for Confluence" app macros:
+ * table-excerpt, table-filter, table-excerpt-include.
+ */
+import { macro } from '../builder.js';
+import { paramMap } from '../types.js';
+import { pageLinkValue, structuredMacro } from '../xml.js';
+// Дефолты table-filter из Confluence-редактора (нашли реверсом).
+// Особенно важен hidePane=Table header — без него фильтры рендерятся
+// отдельной панелью НАД таблицей; с ним — встают в шапку колонок.
+// Пустые-присутствие нужны, чтобы редактор не «потерял» эти контролы
+// при следующем открытии и сохранении страницы.
+export const TABLE_FILTER_DEFAULTS = {
+    hidelabels: 'false',
+    sparkName: 'Sparkline',
+    hidePane: 'Table header',
+    sparkline: 'false',
+    isFirstTimeEnter: 'true',
+    hideColumns: 'false',
+    customNoTableMsg: 'false',
+    disabled: 'false',
+    enabledInEditor: 'false',
+    globalFilter: 'false',
+    hideControls: 'false',
+    numbering: 'Dynamic Ascending',
+    disableSave: 'false',
+    separator: 'Point (.)',
+    datepattern: "d M yy 'г'.",
+    updateSelectOptions: 'false',
+    worklog: '365|5|8|y w d h m|y w d h m',
+    isOR: 'AND',
+    fixedCols: '',
+    ddSeparator: '',
+    customNoTableMsgText: '',
+    limitHeight: '',
+    default: '',
+    'cell-width': '',
+    totalRowName: '',
+    totalColName: '',
+    iconfilter: '',
+    order: '',
+    inverse: '',
+    datefilter: '',
+    column: '',
+    sort: '',
+    totalcol: '',
+    rowsPerPage: '',
+    labels: '',
+    thousandSeparator: '',
+    ignoreFirstNrows: '',
+    ddOperator: '',
+    userfilter: '',
+    numberfilter: '',
+    heightValue: '',
+    hideFilters: '',
+    showNRowsifNotFiltered: '',
+};
+export const tableFilterPlugin = {
+    name: 'table-filter',
+    macros: [
+        {
+            // Макрос "Выборка таблицы" (table-excerpt).
+            // Параметры: name — название выборки; hide — скрывать ли содержимое.
+            name: 'table-excerpt',
+            render: (ctx) => {
+                const map = paramMap(ctx.params);
+                const params = [];
+                if (map.hide === 'true')
+                    params.push({ name: 'hide', value: 'true' });
+                if (map.name)
+                    params.push({ name: 'name', value: map.name });
+                return structuredMacro('table-excerpt', ctx.macroId, { params, richBody: ctx.body });
+            },
+        },
+        {
+            // Макрос "Фильтрация таблицы" (table-filter). Оборачивает контент
+            // (обычно table-excerpt с готовой таблицей) в Confluence-фильтр.
+            // Все ключи параметров пробрасываются как есть — Confluence для
+            // не указанных применяет дефолты. Часто используемые:
+            //   - totalrow: ",,,Sum,Sum,…" — операции по колонкам (пустое — пропуск).
+            //   - numbering: "Dynamic Ascending" — нумерация строк.
+            //   - separator: "Point (.)" / "Comma (,)" — десятичный разделитель.
+            //   - hideControls / hidelabels / globalFilter: "true" / "false".
+            //   - totalRowName: подпись строки итогов.
+            name: 'table-filter',
+            render: (ctx) => structuredMacro('table-filter', ctx.macroId, {
+                params: ctx.params,
+                richBody: ctx.body,
+            }),
+        },
+        {
+            // Включение table-excerpt с другой страницы.
+            name: 'table-excerpt-include',
+            render: (ctx) => {
+                const map = paramMap(ctx.params);
+                const params = [
+                    { name: 'name', value: map.name ?? '' },
+                    { name: 'page', value: pageLinkValue(map.page ?? '', map.space), raw: true },
+                    { name: 'type', value: map.type ?? 'page' },
+                ];
+                return structuredMacro('table-excerpt-include', ctx.macroId, { params });
+            },
+        },
+    ],
+};
+// ── Convenience builders ────────────────────────────────────────────────
+/**
+ * Обёртывает markdown в макрос "выборка таблицы".
+ *
+ * @example
+ *   tableExcerpt(tableMarkdown, 'jira_fact', true)
+ */
+export function tableExcerpt(body, name, hide) {
+    const builder = macro('table-excerpt').body(body);
+    if (name)
+        builder.param('name', name);
+    if (hide)
+        builder.param('hide', 'true');
+    return builder.toMarkdown();
+}
+/**
+ * Обёртывает markdown в макрос "фильтрация таблицы".
+ *
+ * Применяет полный набор дефолтов, какой Confluence-редактор сохраняет
+ * при создании макроса — в том числе пустые-присутствие параметры
+ * (`fixedCols`, `column`, etc). Без них макрос рендерит контролы как
+ * отдельную панель НАД таблицей; с дефолтом `hidePane=Table header`
+ * фильтры встают в шапку колонок. Caller перекрывает что нужно через
+ * `opts` (например `totalrow`); пустая строка в opts означает «оставить
+ * как пустое-присутствие», не удаление.
+ *
+ * @example
+ *   tableFilter(tableExcerptMd, { totalrow: ',,,Sum,Sum,Sum' })
+ */
+export function tableFilter(body, opts = {}) {
+    const merged = { ...TABLE_FILTER_DEFAULTS };
+    for (const [k, v] of Object.entries(opts)) {
+        if (v !== undefined)
+            merged[k] = v;
+    }
+    const builder = macro('table-filter').body(body);
+    for (const [k, v] of Object.entries(merged)) {
+        builder.param(k, v);
+    }
+    return builder.toMarkdown();
+}
+/** Включение table-excerpt с другой страницы по имени выборки. */
+export function tableExcerptInclude(name, page, opts = {}) {
+    const builder = macro('table-excerpt-include').param('name', name).param('page', page);
+    if (opts.space)
+        builder.param('space', opts.space);
+    if (opts.type)
+        builder.param('type', opts.type);
+    return builder.toMarkdown();
+}

package/dist/macros/registry.d.ts

@@ -0,0 +1,29 @@
+import { Markdown } from '../markdown/markdown.js';
+import type { MacroPlugin, MacroRenderer } from './types.js';
+/**
+ * Реестр макросов. Пустой при создании — наполняется плагинами через
+ * {@link use} или точечной регистрацией через {@link register}.
+ *
+ * @example
+ *   const registry = new MacroRegistry()
+ *     .use(coreMacrosPlugin)
+ *     .use(tableFilterPlugin)
+ *     .register('my-macro', (ctx) => `<ac:structured-macro ...>`);
+ */
+export declare class MacroRegistry {
+    private renderers;
+    private pluginNames;
+    /** Registers all macros of a plugin. Later registrations win on name clash. */
+    use(plugin: MacroPlugin): this;
+    register(name: string, renderer: MacroRenderer): this;
+    has(name: string): boolean;
+    getRenderer(name: string): MacroRenderer | undefined;
+    getAllRenderers(): Map<string, MacroRenderer>;
+    /** Names of plugins registered via {@link use} (for diagnostics). */
+    get plugins(): string[];
+}
+/**
+ * Преобразует маркеры макросов в XHTML storage format.
+ * Обрабатывает вложенные макросы снизу вверх (от inner к outer).
+ */
+export declare function processMacros(storage: Markdown | string, registry: MacroRegistry): Markdown;