@baiyibai-antora/extensions 1.21.1 → 1.22.0

package/CHANGELOG.adoc

@@ -3,6 +3,12 @@
 
 All notable changes to this project will be documented in this file.
 
+== [1.22.0] - 2026-09-09
+
+=== Added
+
+* xref-it: a new extension. A bare cross-component cross reference to a titled block or section, `+xref:component::page.adoc#id[]+` or `+<<component::page.adoc#id>>+`, rendered its raw resource spec as link text, because Antora's converter fills an empty reference that carries a fragment with the spec itself. At `contentClassified` the extension loads every page once through Antora's own `loadAsciiDoc`, with the page's component attributes and no Asciidoctor extensions, and collects its registered references by id: the `reftext` attribute when set, otherwise the raw block or section title, attribute references resolved in the page's own context. An Asciidoctor tree processor, registered in the site AsciiDoc config, then rewrites the empty text of a bare fragment reference whose target page belongs to another component while the page converts, for site HTML and the Confluence export alike, so the link text is the title alone, without a `Table N` or `Figure N` counter prefix. An Antora Assembler load is left untouched: the Assembler flattens the assembly into one document, where such a reference is a same-document xref and `xrefstyle` applies natively. The catalog source is never modified, a syntax example in a listing, literal, comment, or passthrough block is never seen, a reference inside an included partial resolves in the context of the including page, and a same-component, explicit-text, self, or fragment-free reference is left to Antora. A fragment the target does not define, or that names a block without a title or reftext, stays as written with a warning carrying the source location. The `signifier` option, off by default, prefixes the title with the signifier Asciidoctor itself uses for the block, read from the target page's own document attributes with the image block mapped to `figure-caption` explicitly, so a page's `:table-caption:` override is honored and an unset caption attribute yields the title alone; `signifier_separator` sets the text between the two; a `reftext` replaces the whole link text, signifier included. Eighteen tests drive a real content catalog and Antora's real loader and converter; the demonstration cross-references a table and a figure on a page of the extensions component from the docs component, and back
+
 == [1.21.1] - 2026-09-09
 
 === Fixed

package/README.adoc

@@ -10,7 +10,7 @@ https://baiyibai-antora.gitlab.io
 
 == Overview
 
-This package provides eleven Antora extensions:
+This package provides twelve Antora extensions:
 
 [cols="1,3"]
 |===
@@ -48,6 +48,9 @@ This package provides eleven Antora extensions:
 
 |<<user-content-list-of-site,list-of-site>>
 |Replaces `list-of::element[site]` placeholders with cross-page lists spanning the entire site
+
+|<<user-content-xref-it,xref-it>>
+|Renders a bare cross-component xref to a titled block or section with the target's own title or reftext as link text
 |===
 
 == Installation
@@ -200,6 +203,11 @@ include::docs/modules/ROOT/partials/trademark-it.adoc[tags=reference,leveloffset
 
 include::docs/modules/ROOT/partials/lists-extended-site.adoc[tags=reference,leveloffset=+2]
 
+[[user-content-xref-it]]
+=== xref-it
+
+include::docs/modules/ROOT/partials/xref-it.adoc[tags=reference,leveloffset=+2]
+
 == Vendorization
 
 To vendorize extensions into a project:
@@ -255,7 +263,8 @@ baiyibai-extensions/
 │   │   ├── asciidoctorconfig/
 │   │   ├── attribute-distiller/
 │   │   ├── trademark-it/
-│   │   └── list-of-site/
+│   │   ├── list-of-site/
+│   │   └── xref-it/
 │   └── lib/                   # Shared helpers
 └── dist/                      # Built output
 ----

package/dist/extensions/xref-it/index.d.ts

@@ -0,0 +1,200 @@
+/**
+ * @baiyibai-antora/extensions - xref-it
+ *
+ * Antora pipeline extension that renders a bare CROSS-COMPONENT xref to a
+ * block or section with the target's own reftext or title as link text, with
+ * no "Table N"/"Figure N" counter prefix.
+ *
+ * Antora's converter fills an empty `xref:component::page.adoc#id[]` with the
+ * raw resource spec (`compb::tables.adoc#fruit-table`) whenever a fragment is
+ * present, because the target page's block titles are unknown to it. This
+ * extension supplies them.
+ *
+ * Two halves:
+ *   contentClassified - every page is loaded ONCE through Antora's own
+ *            loadAsciiDoc (includes, conditionals, and component attributes
+ *            resolve exactly as in the real conversion; registered Asciidoctor
+ *            extensions are left out so nothing with side effects runs twice)
+ *            and its registered references are collected by id: the `reftext`
+ *            attribute when set, otherwise the raw block or section title,
+ *            attribute references resolved in the target's own context.
+ *   conversion - an Asciidoctor tree processor, registered in the site's
+ *            AsciiDoc config, walks the parsed page and rewrites the empty
+ *            text of a bare fragment xref whose target page belongs to
+ *            ANOTHER component. It runs for ordinary page conversion (site
+ *            HTML, and the Confluence export, which loads pages the same way)
+ *            and steps aside for an Antora Assembler load: the Assembler
+ *            flattens the assembly into one document, where such a reference
+ *            becomes a same-document xref and xrefstyle applies natively.
+ *
+ * The catalog source is never modified. Working on the parsed tree means a
+ * syntax example in a listing, literal, comment, or passthrough block is never
+ * seen, and an xref inside an included partial is resolved in the context of
+ * the page that includes it.
+ *
+ * Registration in the playbook (list it AFTER extensions that generate the
+ * partials a page includes, such as autoterm or cite-it, so those partials
+ * exist when the pages are loaded for caption collection):
+ *   antora:
+ *     extensions:
+ *       - require: '@baiyibai-antora/extensions/xref-it'
+ *         xref_it:
+ *           enabled: true
+ *           quiet: true
+ *           signifier: false
+ *           signifier_separator: ': '
+ *
+ * With `signifier: true` the link text is prefixed by Asciidoctor's own
+ * signifier for the block, read from the target page's document attributes
+ * (`table-caption`, `figure-caption`, `listing-caption`, `example-caption`,
+ * `section-refsig`, `appendix-caption`), so a document that overrides its
+ * own word, `:table-caption: Tabelle`, is honored. No counter follows it:
+ * numbering is per document. A `reftext` replaces the whole text, signifier
+ * included, exactly as it does for Asciidoctor's own xrefstyle.
+ */
+interface Src {
+    component: string;
+    version: string;
+    module: string;
+    family: string;
+    relative: string;
+}
+interface VirtualFile {
+    src: Src;
+    contents?: Buffer;
+    mediaType?: string;
+    path?: string;
+}
+interface AsciiDocConfig {
+    attributes?: Record<string, unknown>;
+    extensions?: unknown[];
+    [key: string]: unknown;
+}
+interface ComponentVersion {
+    asciidoc?: AsciiDocConfig;
+}
+interface ContentCatalog {
+    getFiles: (filter?: (file: VirtualFile) => boolean) => VirtualFile[];
+    getPages: (filter?: (file: VirtualFile) => boolean) => VirtualFile[];
+    resolveResource: (spec: string, context: Src, defaultFamily?: string, permittedFamilies?: string[]) => VirtualFile | false | undefined;
+    getComponentVersion: (component: string, version: string) => ComponentVersion | undefined;
+}
+/** The subset of an Asciidoctor.js node reachable from Document#getRefs(). */
+interface RefNode {
+    getContext?: () => string;
+    getAttribute?: (name: string) => unknown;
+    getSectionName?: () => string | undefined;
+    /** Raw, unconverted `@title` instance variable; a Ruby nil arrives as an object. */
+    title?: unknown;
+    /** Raw reftext of an inline anchor node. */
+    text?: unknown;
+}
+interface SourceLocation {
+    getLineNumber?: () => number;
+}
+interface LogMessageOptions {
+    source_location?: SourceLocation | undefined;
+}
+interface DocLogger {
+    warn: (message: unknown) => void;
+}
+/** The subset of an Asciidoctor.js block tree node the tree processor walks. */
+interface TreeNode {
+    getContext: () => string;
+    getBlocks?: () => TreeNode[];
+    getItems?: () => Array<TreeNode | TreeNode[]>;
+    getRows?: () => {
+        getHead: () => TreeNode[][];
+        getBody: () => TreeNode[][];
+        getFoot: () => TreeNode[][];
+    };
+    getStyle?: () => string | undefined;
+    getInnerDocument?: () => TreeNode | undefined;
+    getSubstitutions?: () => string[];
+    getSourceLocation?: () => SourceLocation | undefined;
+    /** Raw source lines of a simple or verse block. */
+    lines?: unknown;
+    /** Raw principal text of a list item or table cell. */
+    text?: unknown;
+}
+interface LoadedDocument extends TreeNode {
+    getRefs: () => Record<string, RefNode>;
+    getAttribute: (name: string) => unknown;
+    $sub_attributes?: (text: string) => string;
+    getLogger: () => DocLogger;
+    createLogMessage: (message: string, options: LogMessageOptions) => unknown;
+}
+interface ExtensionEntry {
+    require?: string;
+    [key: string]: unknown;
+}
+interface Playbook {
+    antora?: {
+        extensions?: ExtensionEntry[];
+    };
+}
+interface AntoraContext {
+    playbook: Playbook;
+    contentCatalog: ContentCatalog;
+    siteAsciiDocConfig?: AsciiDocConfig;
+}
+interface AntoraLogger {
+    debug?: (msg: string) => void;
+    info?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error?: (msg: string) => void;
+}
+interface Registry {
+    getLogger?: (name: string) => AntoraLogger;
+    getFunctions?: () => Record<string, unknown>;
+    replaceFunctions?: (updates: Record<string, unknown>) => void;
+    require?: (request: string) => unknown;
+    on: (event: string, callback: (context: AntoraContext) => void) => void;
+    once?: (event: string, callback: (context: AntoraContext) => void) => void;
+}
+export interface XrefItConfig {
+    enabled: boolean;
+    quiet: boolean;
+    signifier: boolean;
+    signifier_separator: string;
+}
+export interface Caption {
+    /** The reftext, or the raw title with attribute references resolved. */
+    text: string;
+    /** True when `text` is a reftext, which replaces the whole link text, signifier included. */
+    explicit: boolean;
+    /** The target document's own signifier for the block, when it defines one. */
+    signifier?: string;
+}
+export interface CaptionIndex {
+    /** id -> caption, for every reference that carries a reftext or title. */
+    captions: Map<string, Caption>;
+    /** Every registered id, captioned or not, so a missing id and a captionless one warn differently. */
+    ids: Set<string>;
+}
+export declare function readConfig(playbook: Playbook | undefined): XrefItConfig;
+/**
+ * Escapes caption text for use as the sole positional attribute of an xref
+ * macro: a `]` is backslash-escaped, and text holding a comma or an equals
+ * sign is double-quoted so Asciidoctor's attribute list parser keeps it whole.
+ */
+export declare function escapeXrefText(text: string): string;
+/**
+ * The document attribute holding the signifier for a referenced node: the
+ * block's caption attribute, `section-refsig` for a section, and
+ * `appendix-caption` for an appendix section.
+ */
+export declare function signifierAttributeName(node: RefNode): string | undefined;
+/**
+ * Collects the id-to-caption map of a loaded document: the `reftext`
+ * attribute when set, otherwise the raw block or section title, otherwise
+ * an inline anchor's own reftext (an Inline node has no title; its context
+ * is `anchor` and its raw text is the reftext). Attribute references inside
+ * the caption resolve against the document that owns the caption.
+ */
+export declare function collectCaptions(doc: LoadedDocument): CaptionIndex;
+/** The link text for a caption under the given configuration. */
+export declare function linkTextFor(caption: Caption, cfg: Pick<XrefItConfig, 'signifier' | 'signifier_separator'>): string;
+export declare function register(context: Registry): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/xref-it/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/xref-it/index.ts"],"names":[],"mappings":"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"}

package/dist/extensions/xref-it/index.js

@@ -0,0 +1,395 @@
+"use strict";
+/**
+ * @baiyibai-antora/extensions - xref-it
+ *
+ * Antora pipeline extension that renders a bare CROSS-COMPONENT xref to a
+ * block or section with the target's own reftext or title as link text, with
+ * no "Table N"/"Figure N" counter prefix.
+ *
+ * Antora's converter fills an empty `xref:component::page.adoc#id[]` with the
+ * raw resource spec (`compb::tables.adoc#fruit-table`) whenever a fragment is
+ * present, because the target page's block titles are unknown to it. This
+ * extension supplies them.
+ *
+ * Two halves:
+ *   contentClassified - every page is loaded ONCE through Antora's own
+ *            loadAsciiDoc (includes, conditionals, and component attributes
+ *            resolve exactly as in the real conversion; registered Asciidoctor
+ *            extensions are left out so nothing with side effects runs twice)
+ *            and its registered references are collected by id: the `reftext`
+ *            attribute when set, otherwise the raw block or section title,
+ *            attribute references resolved in the target's own context.
+ *   conversion - an Asciidoctor tree processor, registered in the site's
+ *            AsciiDoc config, walks the parsed page and rewrites the empty
+ *            text of a bare fragment xref whose target page belongs to
+ *            ANOTHER component. It runs for ordinary page conversion (site
+ *            HTML, and the Confluence export, which loads pages the same way)
+ *            and steps aside for an Antora Assembler load: the Assembler
+ *            flattens the assembly into one document, where such a reference
+ *            becomes a same-document xref and xrefstyle applies natively.
+ *
+ * The catalog source is never modified. Working on the parsed tree means a
+ * syntax example in a listing, literal, comment, or passthrough block is never
+ * seen, and an xref inside an included partial is resolved in the context of
+ * the page that includes it.
+ *
+ * Registration in the playbook (list it AFTER extensions that generate the
+ * partials a page includes, such as autoterm or cite-it, so those partials
+ * exist when the pages are loaded for caption collection):
+ *   antora:
+ *     extensions:
+ *       - require: '@baiyibai-antora/extensions/xref-it'
+ *         xref_it:
+ *           enabled: true
+ *           quiet: true
+ *           signifier: false
+ *           signifier_separator: ': '
+ *
+ * With `signifier: true` the link text is prefixed by Asciidoctor's own
+ * signifier for the block, read from the target page's document attributes
+ * (`table-caption`, `figure-caption`, `listing-caption`, `example-caption`,
+ * `section-refsig`, `appendix-caption`), so a document that overrides its
+ * own word, `:table-caption: Tabelle`, is honored. No counter follows it:
+ * numbering is per document. A `reftext` replaces the whole text, signifier
+ * included, exactly as it does for Asciidoctor's own xrefstyle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readConfig = readConfig;
+exports.escapeXrefText = escapeXrefText;
+exports.signifierAttributeName = signifierAttributeName;
+exports.collectCaptions = collectCaptions;
+exports.linkTextFor = linkTextFor;
+exports.register = register;
+const log_time_1 = require("../../lib/log-time");
+// ── Configuration ─────────────────────────────────────────────────────────────
+function pick(raw, keys, fallback) {
+    for (const key of keys) {
+        if (key in raw && raw[key] !== undefined)
+            return raw[key];
+    }
+    return fallback;
+}
+function readConfig(playbook) {
+    const entries = playbook?.antora?.extensions ?? [];
+    const me = entries.find((entry) => String(entry?.require ?? '').includes('xref-it')) ?? {};
+    const candidate = me.xrefIt ?? me.xref_it ?? me.xrefit;
+    const raw = (candidate && typeof candidate === 'object' ? candidate : {});
+    return {
+        enabled: pick(raw, ['enabled'], true),
+        quiet: pick(raw, ['quiet'], true),
+        signifier: pick(raw, ['signifier'], false),
+        signifier_separator: String(pick(raw, ['signifier_separator', 'signifierSeparator'], ': ')),
+    };
+}
+// ── Xref detection and text escaping ──────────────────────────────────────────
+// A bare fragment xref: a page spec ending in .adoc, a fragment, and empty text.
+const XREF_MACRO_RE = /(?<![\\+])xref:([^\s[\]#]*\.adoc)#([^\s[\]#]+)\[\]/g;
+const XREF_SHORTHAND_RE = /(?<![\\+])<<([^\s<>,#]*\.adoc)#([^\s<>,#]+)>>/g;
+/**
+ * Escapes caption text for use as the sole positional attribute of an xref
+ * macro: a `]` is backslash-escaped, and text holding a comma or an equals
+ * sign is double-quoted so Asciidoctor's attribute list parser keeps it whole.
+ */
+function escapeXrefText(text) {
+    let escaped = text.replace(/\]/g, '\\]');
+    if (/[,=]/.test(escaped))
+        escaped = `"${escaped.replace(/"/g, '\\"')}"`;
+    return escaped;
+}
+// ── Caption collection ────────────────────────────────────────────────────────
+function rawString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : undefined;
+}
+// Asciidoctor's own CAPTION_ATTRIBUTE_NAMES is keyed by the caption kind, where
+// a real image block is 'figure' while its context is 'image', so the image
+// case is mapped explicitly rather than looked up by context.
+const CAPTION_ATTRIBUTE_NAMES = {
+    example: 'example-caption',
+    figure: 'figure-caption',
+    listing: 'listing-caption',
+    table: 'table-caption',
+};
+/**
+ * The document attribute holding the signifier for a referenced node: the
+ * block's caption attribute, `section-refsig` for a section, and
+ * `appendix-caption` for an appendix section.
+ */
+function signifierAttributeName(node) {
+    const context = node.getContext?.();
+    if (context === 'image')
+        return 'figure-caption';
+    if (context === 'section')
+        return node.getSectionName?.() === 'appendix' ? 'appendix-caption' : 'section-refsig';
+    return context ? CAPTION_ATTRIBUTE_NAMES[context] : undefined;
+}
+/**
+ * Collects the id-to-caption map of a loaded document: the `reftext`
+ * attribute when set, otherwise the raw block or section title, otherwise
+ * an inline anchor's own reftext (an Inline node has no title; its context
+ * is `anchor` and its raw text is the reftext). Attribute references inside
+ * the caption resolve against the document that owns the caption.
+ */
+function collectCaptions(doc) {
+    const captions = new Map();
+    const ids = new Set();
+    const refs = doc.getRefs() ?? {};
+    for (const [id, node] of Object.entries(refs)) {
+        if (!node || typeof node !== 'object')
+            continue;
+        ids.add(id);
+        const reftext = rawString(node.getAttribute?.('reftext'));
+        let text = reftext ?? rawString(node.title);
+        if (text === undefined && node.getContext?.() === 'anchor')
+            text = rawString(node.text);
+        if (text === undefined)
+            continue;
+        if (text.includes('{') && typeof doc.$sub_attributes === 'function')
+            text = doc.$sub_attributes(text);
+        const caption = { text: text.trim(), explicit: reftext !== undefined };
+        const attributeName = signifierAttributeName(node);
+        const signifier = attributeName ? rawString(doc.getAttribute(attributeName)) : undefined;
+        if (signifier)
+            caption.signifier = signifier.trim();
+        captions.set(id, caption);
+    }
+    return { captions, ids };
+}
+/** The link text for a caption under the given configuration. */
+function linkTextFor(caption, cfg) {
+    if (!cfg.signifier || caption.explicit || !caption.signifier)
+        return caption.text;
+    return `${caption.signifier}${cfg.signifier_separator}${caption.text}`;
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function resolveLoader(context) {
+    const fromContextRequire = (() => {
+        try {
+            return context.require?.('@antora/asciidoc-loader')?.loadAsciiDoc;
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    const fromFunctions = context.getFunctions?.().loadAsciiDoc;
+    const fromRequire = (() => {
+        try {
+            return require('@antora/asciidoc-loader').loadAsciiDoc;
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    const loader = fromContextRequire ?? fromFunctions ?? fromRequire;
+    return typeof loader === 'function' ? loader : undefined;
+}
+function describe(file) {
+    const { component, version, module, family, relative } = file.src;
+    const versionPart = version ? `${version}@` : '';
+    return `${versionPart}${component}:${module}:${family}$${relative}`;
+}
+function isAsciiDocPage(file) {
+    if (file.src?.family !== 'page' || !file.contents)
+        return false;
+    return file.mediaType === 'text/asciidoc' || /\.adoc$/.test(file.src.relative);
+}
+/** True for a load the Antora Assembler performs while flattening an assembly. */
+function isAssemblerLoad(config) {
+    const attributes = config?.attributes;
+    return !!attributes && 'loader-assembler' in attributes && attributes['loader-assembler'] !== false;
+}
+// ── Extension ─────────────────────────────────────────────────────────────────
+function register(context) {
+    const antoraLogger = context.getLogger?.('xref-it');
+    const warn = (message) => {
+        if (antoraLogger?.warn)
+            antoraLogger.warn(message);
+        else
+            console.warn(`[${(0, log_time_1.nowLocal)()}] WARN (xref-it): ${message}`);
+    };
+    const info = (message) => {
+        console.log(`[${(0, log_time_1.nowLocal)()}] \x1b[94mEVENT\x1b[0m (xref-it): \x1b[94m${message}\x1b[0m`);
+    };
+    let enabled = true;
+    let cfg = readConfig(undefined);
+    let loadAsciiDoc;
+    let catalogRef;
+    let siteConfigRef;
+    const captionCache = new Map();
+    const indexFor = (target) => {
+        if (captionCache.has(target))
+            return captionCache.get(target);
+        let index = null;
+        if (loadAsciiDoc && catalogRef) {
+            try {
+                const scoped = catalogRef.getComponentVersion(target.src.component, target.src.version)?.asciidoc;
+                const baseConfig = scoped ?? siteConfigRef ?? {};
+                // Registered Asciidoctor extensions, this one included, are left out:
+                // this load exists to read titles, and a block processor with side
+                // effects, such as a diagram fetch, would otherwise run twice.
+                const config = Object.assign({}, baseConfig, { extensions: [] });
+                index = collectCaptions(loadAsciiDoc(target, catalogRef, config));
+            }
+            catch (err) {
+                warn(`${describe(target)}: load failed while collecting captions (${err.message})`);
+            }
+        }
+        captionCache.set(target, index);
+        return index;
+    };
+    // ── The conversion-time half: an Asciidoctor tree processor ────────────────
+    const asciidoctorExtension = {
+        register(registry, { file, contentCatalog, config }) {
+            if (!enabled || !file || file.src?.family !== 'page' || isAssemblerLoad(config))
+                return;
+            registry.treeProcessor(function () {
+                this.process((doc) => rewriteDocument(doc, file, contentCatalog));
+            });
+        },
+    };
+    function rewriteDocument(doc, file, contentCatalog) {
+        const logMissing = (node, message) => {
+            try {
+                doc.getLogger().warn(doc.createLogMessage(message, { source_location: node.getSourceLocation?.() }));
+            }
+            catch {
+                warn(`${describe(file)}: ${message}`);
+            }
+        };
+        const rewriteText = (node, text) => {
+            const replace = (match, spec, fragment) => {
+                const target = contentCatalog.resolveResource(spec, file.src, 'page', ['page']);
+                if (!target || target === file || target.src.component === file.src.component)
+                    return match;
+                const index = indexFor(target);
+                if (!index)
+                    return match;
+                const caption = index.captions.get(fragment);
+                if (caption === undefined) {
+                    const reason = index.ids.has(fragment) ? 'carries no title or reftext' : 'is not defined';
+                    logMissing(node, `xref-it: fragment #${fragment} ${reason} in ${spec}; xref left as written`);
+                    return match;
+                }
+                return `xref:${spec}#${fragment}[${escapeXrefText(linkTextFor(caption, cfg))}]`;
+            };
+            return text.replace(XREF_MACRO_RE, replace).replace(XREF_SHORTHAND_RE, replace);
+        };
+        const rewriteLines = (node) => {
+            const lines = node.lines;
+            if (!Array.isArray(lines))
+                return;
+            for (let idx = 0; idx < lines.length; idx++) {
+                const line = lines[idx];
+                if (typeof line === 'string' && line.includes('.adoc#'))
+                    lines[idx] = rewriteText(node, line);
+            }
+        };
+        const rewritePrincipalText = (node) => {
+            if (typeof node.text === 'string' && node.text.includes('.adoc#'))
+                node.text = rewriteText(node, node.text);
+        };
+        const walk = (node) => {
+            if (!node || typeof node.getContext !== 'function')
+                return;
+            const ctx = node.getContext();
+            if (ctx === 'table') {
+                const rows = node.getRows?.();
+                if (rows) {
+                    for (const row of [...rows.getHead(), ...rows.getBody(), ...rows.getFoot()]) {
+                        for (const cell of row) {
+                            const inner = cell.getStyle?.() === 'asciidoc' ? cell.getInnerDocument?.() : undefined;
+                            if (inner)
+                                walk(inner);
+                            else
+                                rewritePrincipalText(cell);
+                        }
+                    }
+                }
+                return;
+            }
+            if (ctx === 'dlist') {
+                for (const item of node.getItems?.() ?? []) {
+                    if (Array.isArray(item)) {
+                        const [terms, description] = item;
+                        for (const term of Array.isArray(terms) ? terms : [terms])
+                            rewritePrincipalText(term);
+                        if (description)
+                            walk(description);
+                    }
+                }
+                return;
+            }
+            if (ctx === 'list_item') {
+                rewritePrincipalText(node);
+            }
+            else if (Array.isArray(node.lines)) {
+                // A simple or verse block carries its raw source lines; only rewrite
+                // where the macros substitution is active, so a listing or literal
+                // block that shows the syntax is left alone.
+                const subs = node.getSubstitutions?.();
+                if (Array.isArray(subs) && subs.includes('macros'))
+                    rewriteLines(node);
+            }
+            for (const child of node.getBlocks?.() ?? [])
+                walk(child);
+        };
+        walk(doc);
+    }
+    const install = (config) => {
+        if (!config)
+            return;
+        if (!Array.isArray(config.extensions))
+            config.extensions = [];
+        if (!config.extensions.includes(asciidoctorExtension))
+            config.extensions.push(asciidoctorExtension);
+    };
+    // Register the tree processor in the site AsciiDoc config the moment Antora
+    // resolves it, before any component-version config is derived from it.
+    context.once?.('contextStarted', () => {
+        const delegate = context.getFunctions?.().resolveAsciiDocConfig;
+        if (typeof delegate !== 'function' || !context.replaceFunctions)
+            return;
+        context.replaceFunctions({
+            resolveAsciiDocConfig: (playbook) => {
+                const config = delegate(playbook);
+                install(config);
+                return config;
+            },
+        });
+    });
+    // ── The classification-time half: collect every page's captions ───────────
+    context.on('contentClassified', ({ playbook, contentCatalog, siteAsciiDocConfig }) => {
+        cfg = readConfig(playbook);
+        enabled = cfg.enabled;
+        if (!enabled)
+            return;
+        if (!contentCatalog) {
+            warn('contentCatalog not available; no xref rewritten');
+            enabled = false;
+            return;
+        }
+        // Component-version configs share the site config's extensions array by
+        // reference, so this late install still reaches them when contextStarted
+        // was unavailable.
+        install(siteAsciiDocConfig);
+        loadAsciiDoc = resolveLoader(context);
+        if (!loadAsciiDoc) {
+            warn('@antora/asciidoc-loader not resolvable; no xref rewritten');
+            enabled = false;
+            return;
+        }
+        catalogRef = contentCatalog;
+        siteConfigRef = siteAsciiDocConfig;
+        let pageCount = 0;
+        let captionCount = 0;
+        for (const page of contentCatalog.getPages(isAsciiDocPage)) {
+            const index = indexFor(page);
+            if (!index)
+                continue;
+            pageCount++;
+            captionCount += index.captions.size;
+        }
+        if (!cfg.quiet)
+            info(`Collected ${captionCount} caption(s) from ${pageCount} page(s)`);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/xref-it/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/xref-it/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baiyibai-antora/extensions",
-  "version": "1.21.1",
+  "version": "1.22.0",
   "description": "Antora extensions and AsciiDoc macros for Baiyibai documentation",
   "keywords": [
     "antora",
@@ -51,6 +51,10 @@
       "require": "./dist/extensions/list-of-site/index.js",
       "types": "./dist/extensions/list-of-site/index.d.ts"
     },
+    "./xref-it": {
+      "require": "./dist/extensions/xref-it/index.js",
+      "types": "./dist/extensions/xref-it/index.d.ts"
+    },
     "./trademark-it": {
       "require": "./dist/extensions/trademark-it/index.js",
       "types": "./dist/extensions/trademark-it/index.d.ts"