@baiyibai-antora/extensions 1.0.0

package/dist/extensions/asciidoctorconfig/index.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * @baiyibai-antora/docs-extensions - asciidoctorconfig
+ *
+ * Copies .asciidoctorconfig.adoc and .asciidoctorconfig files from the content
+ * catalog to the project root for AsciiDoctor tooling.
+ *
+ * Configuration in antora-playbook.yml:
+ *
+ * antora:
+ *   extensions:
+ *     - require: '@baiyibai-antora/docs-extensions/asciidoc-extensions/asciidoctorconfig'
+ *       asciidoctorconfig:
+ *         enabled: true
+ *         quiet: false
+ *         version: ''
+ *         component: 'asciidoctorconfig'
+ *         module: 'ROOT'
+ *         location: 'partial$'
+ *         asciidoctorconfig_adoc_filename: 'asciidoctorconfig.adoc'
+ *         asciidoctorconfig_filename: 'asciidoctorconfig'
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("path"));
+const colors = {
+    blue: (s) => `\x1b[94m${s}\x1b[0m`,
+};
+let quietMode = true;
+function timestamp() {
+    return new Date().toISOString().split('T')[1].replace('Z', '');
+}
+function logEvent(message) {
+    console.log(`[${timestamp()}] ${colors.blue('EVENT')} (antora-asciidoctorconfig): ${colors.blue(message)}`);
+}
+function makeLogger(hostLogger) {
+    const log = hostLogger || console;
+    return {
+        debug: (m) => {
+            if (!quietMode)
+                (log.debug ? log.debug(m) : console.debug(m));
+        },
+        info: (m) => {
+            if (!quietMode)
+                (log.info ? log.info(m) : console.log(m));
+        },
+        warn: (m) => {
+            (log.warn ? log.warn(m) : console.warn(m));
+        },
+        error: (m) => {
+            (log.error ? log.error(m) : console.error(m));
+        },
+        event: (m) => logEvent(m),
+    };
+}
+function pick(obj, keys, def) {
+    for (const k of keys) {
+        if (obj && obj[k] !== undefined)
+            return obj[k];
+    }
+    return def;
+}
+function readConfig(playbook) {
+    const defaults = {
+        enabled: true,
+        quiet: true,
+        version: '',
+        component: 'asciidoctorconfig',
+        module: 'ROOT',
+        location: 'partial$',
+        asciidoctorconfig_adoc_filename: undefined,
+        asciidoctorconfig_filename: undefined,
+    };
+    const extEntries = playbook?.antora?.extensions || [];
+    const me = extEntries.find((e) => {
+        const req = e && e.require ? String(e.require) : '';
+        return req.includes('asciidoctorconfig');
+    }) || {};
+    const raw = (me.asciidoctorconfig && typeof me.asciidoctorconfig === 'object'
+        ? me.asciidoctorconfig
+        : {});
+    return {
+        enabled: pick(raw, ['enabled'], defaults.enabled),
+        quiet: pick(raw, ['quiet'], defaults.quiet),
+        version: pick(raw, ['version'], defaults.version),
+        component: pick(raw, ['component'], defaults.component),
+        module: pick(raw, ['module'], defaults.module),
+        location: pick(raw, ['location'], defaults.location),
+        asciidoctorconfig_adoc_filename: pick(raw, ['asciidoctorconfig_adoc_filename', 'asciidoctorconfigAdocFilename', 'asciidoctorconfigadocfilename'], defaults.asciidoctorconfig_adoc_filename),
+        asciidoctorconfig_filename: pick(raw, ['asciidoctorconfig_filename', 'asciidoctorconfigFilename', 'asciidoctorconfigfilename'], defaults.asciidoctorconfig_filename),
+    };
+}
+function buildResourceId(cfg, filename) {
+    const versionPrefix = cfg.version ? `${cfg.version}@` : '';
+    return `${versionPrefix}${cfg.component}:${cfg.module}:${cfg.location}${filename}`;
+}
+async function copyConfigFile(contentCatalog, cfg, filename, targetFilename, logger) {
+    const resourceId = buildResourceId(cfg, filename);
+    logger.debug(`Looking for resource: ${resourceId}`);
+    let file = contentCatalog.resolveResource(resourceId);
+    if (!file) {
+        const allFiles = contentCatalog.getFiles();
+        file = allFiles.find((f) => {
+            return f.src?.component === cfg.component &&
+                f.src?.module === cfg.module &&
+                (f.src?.basename === filename || f.src?.relative?.endsWith(filename));
+        });
+    }
+    if (!file) {
+        logger.debug(`Resource not found: ${resourceId}`);
+        return { success: false, targetFilename };
+    }
+    const targetPath = path.resolve(process.cwd(), targetFilename);
+    try {
+        await fs.writeFile(targetPath, file.contents);
+        logger.debug(`Copied ${filename} -> ${targetFilename}`);
+        return { success: true, targetFilename };
+    }
+    catch (err) {
+        logger.error(`Failed to write ${targetFilename}: ${err.message}`);
+        return { success: false, targetFilename };
+    }
+}
+function register(context) {
+    const antoraLogger = context.getLogger ? context.getLogger('antora-asciidoctorconfig') : undefined;
+    const logger = makeLogger(antoraLogger);
+    context.once('contentClassified', async ({ playbook, contentCatalog }) => {
+        const cfg = readConfig(playbook);
+        quietMode = cfg.quiet;
+        logger.debug('=== asciidoctorconfig configuration ===');
+        logger.debug(JSON.stringify(cfg, null, 2));
+        if (!cfg.enabled) {
+            logger.debug('AsciiDoctorConfig extension disabled');
+            return;
+        }
+        if (!contentCatalog) {
+            logger.warn('contentCatalog not available');
+            return;
+        }
+        let adocResult = { success: false, targetFilename: '.asciidoctorconfig.adoc' };
+        if (cfg.asciidoctorconfig_adoc_filename) {
+            adocResult = await copyConfigFile(contentCatalog, cfg, cfg.asciidoctorconfig_adoc_filename, '.asciidoctorconfig.adoc', logger);
+        }
+        else {
+            logger.debug('asciidoctorconfig_adoc_filename not configured, skipping .asciidoctorconfig.adoc');
+        }
+        let configResult = { success: false, targetFilename: '.asciidoctorconfig' };
+        if (cfg.asciidoctorconfig_filename) {
+            configResult = await copyConfigFile(contentCatalog, cfg, cfg.asciidoctorconfig_filename, '.asciidoctorconfig', logger);
+        }
+        else {
+            logger.debug('asciidoctorconfig_filename not configured, skipping .asciidoctorconfig');
+        }
+        const copiedFiles = [];
+        if (adocResult.success)
+            copiedFiles.push(adocResult.targetFilename);
+        if (configResult.success)
+            copiedFiles.push(configResult.targetFilename);
+        if (copiedFiles.length > 0) {
+            const filename = cfg.asciidoctorconfig_filename || cfg.asciidoctorconfig_adoc_filename || 'asciidoctorconfig';
+            const resourceId = buildResourceId(cfg, filename);
+            const filesStr = copiedFiles.join(' and ');
+            logger.event(`Copied ${filesStr} from ${resourceId}`);
+        }
+        else if (!cfg.asciidoctorconfig_adoc_filename && !cfg.asciidoctorconfig_filename) {
+            logger.debug('No filename keys configured, nothing to copy');
+        }
+        else {
+            logger.warn('No AsciiDoctor config files found to copy');
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/asciidoctorconfig/index.js.map

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

package/dist/extensions/assembler-rename-pdf/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @baiyibai-antora/docs-extensions - assembler-rename-pdf
+ *
+ * Renames exported PDF files based on document attributes and copies to target directory.
+ *
+ * Configuration in antora-playbook.yml:
+ *
+ * antora:
+ *   extensions:
+ *     - require: '@baiyibai-antora/docs-extensions/extensions/assembler-rename-pdf'
+ *       renamer:
+ *         enabled: true
+ *         quiet: false
+ *         pdf_filename_attribute: 'pdf-filename'
+ *         assembler_base_dir: 'build/assembler-pdf'
+ *         site_base_dir: 'build/site'
+ *         exports_subdir: '_exports'
+ *         copy_target_dir: '.'
+ */
+interface RenamerConfig {
+    enabled: boolean;
+    quiet: boolean;
+    pdf_filename_attribute: string;
+    assembler_base_dir: string;
+    site_base_dir: string | null;
+    exports_subdir: string;
+    copy_target_dir: string | null;
+}
+interface AntoraLogger {
+    debug?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error?: (msg: string) => void;
+}
+interface ExtensionEntry {
+    require?: string;
+    renamer?: Partial<RenamerConfig>;
+}
+interface Playbook {
+    dir?: string;
+    antora?: {
+        extensions?: ExtensionEntry[];
+    };
+    output?: {
+        dir?: string;
+    };
+}
+interface VirtualFile {
+    src?: {
+        component?: string;
+        version?: string;
+    };
+    pub?: {
+        url?: string;
+    };
+    out?: {
+        path?: string;
+    };
+}
+interface ComponentVersion {
+    asciidoc?: {
+        attributes?: Record<string, string>;
+    };
+}
+interface ContentCatalog {
+    findBy: (criteria: {
+        family: string;
+    }) => VirtualFile[];
+    getComponentVersion: (component?: string, version?: string) => ComponentVersion | undefined;
+}
+interface Registry {
+    getLogger?: (name: string) => AntoraLogger;
+    on: (event: string, callback: (context: {
+        contentCatalog: ContentCatalog;
+        playbook: Playbook;
+    }) => void) => void;
+}
+export declare function register(context: Registry): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/assembler-rename-pdf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/assembler-rename-pdf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAQD,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAED,UAAU,QAAQ;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;KAC/B,CAAC;IACF,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,CAAC;CACH;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,WAAW,EAAE,CAAC;IACxD,mBAAmB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;CAC7F;AAED,UAAU,QAAQ;IAChB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC;IAC3C,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,cAAc,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,KAAK,IAAI,KAAK,IAAI,CAAC;CAClH;AA0FD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CA2JhD"}

package/dist/extensions/assembler-rename-pdf/index.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * @baiyibai-antora/docs-extensions - assembler-rename-pdf
+ *
+ * Renames exported PDF files based on document attributes and copies to target directory.
+ *
+ * Configuration in antora-playbook.yml:
+ *
+ * antora:
+ *   extensions:
+ *     - require: '@baiyibai-antora/docs-extensions/extensions/assembler-rename-pdf'
+ *       renamer:
+ *         enabled: true
+ *         quiet: false
+ *         pdf_filename_attribute: 'pdf-filename'
+ *         assembler_base_dir: 'build/assembler-pdf'
+ *         site_base_dir: 'build/site'
+ *         exports_subdir: '_exports'
+ *         copy_target_dir: '.'
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const colors = {
+    green: (s) => `\x1b[0;32m${s}\x1b[0m`,
+    blue: (s) => `\x1b[94m${s}\x1b[0m`,
+};
+let quietMode = true;
+function timestamp() {
+    return new Date().toISOString().split('T')[1].replace('Z', '');
+}
+function logFinished(newFilename, copyTargetDir) {
+    const level = colors.green('FINISHED');
+    let msg;
+    if (copyTargetDir) {
+        msg = colors.green(`Renamed PDF and copied to ${copyTargetDir}/${newFilename}`);
+    }
+    else {
+        msg = colors.green(`Renamed PDF to ${newFilename}`);
+    }
+    console.log(`[${timestamp()}] ${level} (antora-rename-pdf): ${msg}`);
+}
+function makeLogger(hostLogger) {
+    const log = hostLogger || console;
+    return {
+        debug: (m) => {
+            if (!quietMode) {
+                (log.debug ? log.debug(m) : console.debug(m));
+            }
+        },
+        warn: (m) => {
+            (log.warn ? log.warn(m) : console.warn(m));
+        },
+        error: (m) => {
+            (log.error ? log.error(m) : console.error(m));
+        },
+    };
+}
+function safeJoin(baseDir, relPath) {
+    const clean = String(relPath || '').replace(/^[/\\]+/, '');
+    return path.join(baseDir, clean);
+}
+function ensureDir(dirPath) {
+    try {
+        fs.mkdirSync(dirPath, { recursive: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readRenamerConfig(playbook) {
+    const defaults = {
+        enabled: true,
+        quiet: true,
+        pdf_filename_attribute: 'pdf-filename',
+        assembler_base_dir: 'build/assembler-pdf',
+        site_base_dir: null,
+        exports_subdir: '_exports',
+        copy_target_dir: null,
+    };
+    const extEntries = playbook?.antora?.extensions || [];
+    const me = extEntries.find((e) => {
+        const req = e && e.require ? String(e.require) : '';
+        return req.includes('assembler-rename-pdf');
+    }) || {};
+    const raw = me.renamer && typeof me.renamer === 'object' ? me.renamer : {};
+    const renamerCfg = {
+        enabled: raw.enabled,
+        quiet: raw.quiet,
+        pdf_filename_attribute: (raw.pdf_filename_attribute ?? raw.pdfFilenameAttribute ?? raw.pdffilenameattribute),
+        assembler_base_dir: (raw.assembler_base_dir ?? raw.assemblerBaseDir ?? raw.assemblerbasedir),
+        site_base_dir: (raw.site_base_dir ?? raw.siteBaseDir ?? raw.sitebasedir),
+        exports_subdir: (raw.exports_subdir ?? raw.exportsSubdir ?? raw.exportssubdir),
+        copy_target_dir: (raw.copy_target_dir ?? raw.copyTargetDir ?? raw.copytargetdir),
+    };
+    Object.keys(renamerCfg).forEach((k) => {
+        if (renamerCfg[k] === undefined) {
+            delete renamerCfg[k];
+        }
+    });
+    return { ...defaults, ...renamerCfg };
+}
+function register(context) {
+    const antoraLogger = context.getLogger ? context.getLogger('antora-rename-pdf') : undefined;
+    const logger = makeLogger(antoraLogger);
+    context.on('sitePublished', ({ contentCatalog, playbook }) => {
+        try {
+            const cfg = readRenamerConfig(playbook);
+            quietMode = !!cfg.quiet;
+            if (!cfg.enabled) {
+                logger.debug('Rename PDF Extension Enabled: false (skipped)');
+                return;
+            }
+            logger.debug('=== assembler-rename-pdf configuration ===');
+            logger.debug(JSON.stringify(cfg, null, 2));
+            const siteBaseDir = cfg.site_base_dir
+                ? path.resolve(process.cwd(), cfg.site_base_dir)
+                : playbook?.output?.dir
+                    ? path.resolve(process.cwd(), playbook.output.dir)
+                    : path.resolve(process.cwd(), 'build', 'site');
+            const assemblerBaseDir = path.resolve(process.cwd(), cfg.assembler_base_dir);
+            const copyTargetDir = cfg.copy_target_dir ? path.resolve(process.cwd(), cfg.copy_target_dir) : null;
+            const exportsSubdir = String(cfg.exports_subdir);
+            const pdfFilenameAttribute = String(cfg.pdf_filename_attribute || 'pdf-filename');
+            if (!contentCatalog) {
+                logger.error('contentCatalog is missing');
+                return;
+            }
+            const exportFiles = contentCatalog.findBy({ family: 'export' }) || [];
+            logger.debug(`exportFiles count=${exportFiles.length}`);
+            const pdfExports = exportFiles.filter((vf) => {
+                const pubUrlLC = (vf?.pub?.url || '').toLowerCase();
+                const outPathLC = (vf?.out?.path || '').toLowerCase();
+                return pubUrlLC.endsWith('.pdf') || outPathLC.endsWith('.pdf');
+            });
+            if (pdfExports.length === 0) {
+                logger.warn('No PDF exports found.');
+                return;
+            }
+            pdfExports.forEach((pdfFile) => {
+                try {
+                    const { component, version } = pdfFile.src || {};
+                    const componentVersion = contentCatalog.getComponentVersion(component, version);
+                    const attrs = componentVersion?.asciidoc?.attributes || {};
+                    logger.debug(`found export: component=${component}, version=${version}, pub.url=${pdfFile?.pub?.url}, out.path=${pdfFile?.out?.path}`);
+                    const docFilenameRaw = attrs[pdfFilenameAttribute];
+                    if (!docFilenameRaw) {
+                        logger.warn(`Missing ${pdfFilenameAttribute} attribute for ${component}@${version}`);
+                        return;
+                    }
+                    const newFilename = docFilenameRaw.endsWith('.pdf') ? docFilenameRaw : `${docFilenameRaw}.pdf`;
+                    const pubUrl = pdfFile?.pub?.url;
+                    const outPathCurrent = pdfFile?.out?.path;
+                    if (!pubUrl) {
+                        logger.warn(`publish url missing for ${component}@${version} — skipping`);
+                        return;
+                    }
+                    const pubParts = pubUrl.split('/');
+                    const currentFilename = pubParts[pubParts.length - 1];
+                    if (currentFilename !== newFilename) {
+                        pubParts[pubParts.length - 1] = newFilename;
+                        const newPubUrl = pubParts.join('/');
+                        const newSiteOutPath = newPubUrl.startsWith('/') ? newPubUrl.slice(1) : newPubUrl;
+                        if (pdfFile.pub)
+                            pdfFile.pub.url = newPubUrl;
+                        if (pdfFile.out)
+                            pdfFile.out.path = newSiteOutPath;
+                        const absOldSite = safeJoin(siteBaseDir, outPathCurrent || pubUrl.replace(/^[/\\]+/, ''));
+                        const absNewSite = safeJoin(siteBaseDir, newSiteOutPath);
+                        if (fs.existsSync(absOldSite) && !fs.existsSync(absNewSite)) {
+                            ensureDir(path.dirname(absNewSite));
+                            try {
+                                fs.renameSync(absOldSite, absNewSite);
+                                logger.debug(`rename site: ${absOldSite} -> ${absNewSite}`);
+                            }
+                            catch (e) {
+                                logger.error(`SITE rename failed: ${e.message}`);
+                            }
+                        }
+                        const absOldAsm = safeJoin(assemblerBaseDir, path.join(component || '', version || '', exportsSubdir, 'index.pdf'));
+                        const absNewAsm = safeJoin(assemblerBaseDir, path.join(component || '', version || '', exportsSubdir, newFilename));
+                        if (fs.existsSync(absOldAsm) && !fs.existsSync(absNewAsm)) {
+                            ensureDir(path.dirname(absNewAsm));
+                            try {
+                                fs.renameSync(absOldAsm, absNewAsm);
+                                logger.debug(`rename asm: ${absOldAsm} -> ${absNewAsm}`);
+                            }
+                            catch (e2) {
+                                logger.error(`ASM rename failed: ${e2.message}`);
+                            }
+                        }
+                    }
+                    const absNewAsmFinal = safeJoin(assemblerBaseDir, path.join(component || '', version || '', exportsSubdir, newFilename));
+                    const absNewSiteFinal = safeJoin(siteBaseDir, path.join(component || '', version || '', exportsSubdir, newFilename));
+                    if (copyTargetDir) {
+                        const copyTarget = path.join(copyTargetDir, newFilename);
+                        try {
+                            if (fs.existsSync(absNewAsmFinal)) {
+                                ensureDir(path.dirname(copyTarget));
+                                fs.copyFileSync(absNewAsmFinal, copyTarget);
+                                logger.debug(`copyAsm->target: ${absNewAsmFinal} -> ${copyTarget}`);
+                                logFinished(newFilename, copyTargetDir);
+                            }
+                            else if (fs.existsSync(absNewSiteFinal)) {
+                                ensureDir(path.dirname(copyTarget));
+                                fs.copyFileSync(absNewSiteFinal, copyTarget);
+                                logger.debug(`copySite->target: ${absNewSiteFinal} -> ${copyTarget}`);
+                                logFinished(newFilename, copyTargetDir);
+                            }
+                            else {
+                                logger.warn(`COPY skipped: source not found for ${newFilename}`);
+                            }
+                        }
+                        catch (eCp) {
+                            logger.error(`COPY failed: ${eCp.message}`);
+                        }
+                    }
+                    else {
+                        logFinished(newFilename);
+                    }
+                }
+                catch (ePdf) {
+                    logger.error(`exception: ${ePdf?.message}`);
+                }
+            });
+        }
+        catch (e) {
+            logger.error(`top-level exception: ${e?.message}`);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/assembler-rename-pdf/index.js.map

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

package/dist/extensions/assembler-ruby-preflight/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @baiyibai-antora/docs-extensions - assembler-ruby-preflight
+ *
+ * Coordinates Ruby/Ghostscript version checks and gem bundling for PDF generation.
+ * Supports per-platform configuration (Windows, Linux, macOS).
+ *
+ * Configuration in antora-playbook.yml:
+ *
+ * antora:
+ *   extensions:
+ *     - require: '@baiyibai-antora/docs-extensions/extensions/assembler-ruby-preflight'
+ *       preflight:
+ *         enabled: true
+ *         quiet: true
+ *         gemfile_path: './assembler-themes/Gemfile'
+ *         use_system_gems: false
+ *         platforms:
+ *           win32:
+ *             ruby_version: '3.3.8'
+ *             gs_version: '10.05.1'
+ *             check_ruby: true
+ *             check_gs: true
+ *           linux:
+ *             ruby_version: '3.3.8'
+ *             check_ruby: true
+ *           darwin:
+ *             ruby_version: '3.3.8'
+ *             gs_version: '10.05.1'
+ *             check_ruby: true
+ *             check_gs: true
+ */
+type Platform = 'win32' | 'linux' | 'darwin';
+interface PlatformConfig {
+    ruby_version?: string;
+    ruby_revision?: string;
+    ruby_guidance?: string;
+    gs_version?: string;
+    gs_guidance?: string;
+    check_ruby: boolean;
+    check_gs: boolean;
+}
+interface PreflightConfig {
+    enabled: boolean;
+    quiet: boolean;
+    gemfile_path: string;
+    use_system_gems: boolean;
+    platforms: Record<Platform, PlatformConfig>;
+}
+interface AntoraLogger {
+    debug?: (msg: string) => void;
+    info?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error?: (msg: string) => void;
+}
+interface ExtensionEntry {
+    require?: string;
+    preflight?: Partial<PreflightConfig>;
+}
+interface Playbook {
+    dir?: string;
+    antora?: {
+        extensions?: ExtensionEntry[];
+    };
+}
+interface Registry {
+    getLogger?: (name: string) => AntoraLogger;
+    on: (event: string, callback: (context: {
+        playbook: Playbook;
+    }) => void) => void;
+    once: (event: string, callback: (context: {
+        playbook: Playbook;
+    }) => Promise<void>) => void;
+}
+export declare function register(context: Registry): void;
+export {};
+//# sourceMappingURL=index.d.ts.map