@baiyibai-antora/extensions 1.0.0

package/dist/extensions/collector-writer/index.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * @baiyibai-antora/docs-extensions - collector-writer
+ *
+ * Copies assets discovered by @antora/collector-extension from the Antora
+ * content catalog into local folders for downstream use (themes, vale rules, etc.).
+ *
+ * Configuration in antora-playbook.yml:
+ *
+ * antora:
+ *   extensions:
+ *     - require: '@antora/collector-extension'
+ *     - require: '@baiyibai-antora/docs-extensions/extensions/collector-writer'
+ *       collectorWriter:
+ *         enabled: true
+ *         quiet: false
+ *         targets:
+ *           - component: vale-styles
+ *             write_dir: ./vale-rules
+ *             ephemeral: true
+ *           - component: pdf-themes
+ *             write_dir: ./assembler-themes
+ *             ephemeral: false
+ */
+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 fsp = __importStar(require("node:fs/promises"));
+const path = __importStar(require("path"));
+function timestamp() {
+    return new Date().toISOString().split('T')[1].replace('Z', '');
+}
+function logEvent(message) {
+    console.log(`[${timestamp()}] \x1b[94mEVENT\x1b[0m (antora-collector-writer): \x1b[94m${message}\x1b[0m`);
+}
+let quietMode = true;
+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));
+        },
+    };
+}
+function toBool(v) {
+    if (v === true)
+        return true;
+    if (v === false)
+        return false;
+    if (typeof v === 'string') {
+        const s = v.trim().toLowerCase();
+        if (['true', '1', 'yes', 'on'].includes(s))
+            return true;
+        if (['false', '0', 'no', 'off'].includes(s))
+            return false;
+    }
+    return Boolean(v);
+}
+function pick(obj, keys, def) {
+    for (const k of keys) {
+        if (obj && obj[k] !== undefined)
+            return obj[k];
+    }
+    return def;
+}
+function ensureArray(v) {
+    return Array.isArray(v) ? v : v ? [v] : [];
+}
+function register(context) {
+    const logger = makeLogger(context.getLogger ? context.getLogger('antora-collector-writer') : undefined);
+    let cfg = {
+        enabled: true,
+        quiet: true,
+        output_dir: 'vale-output',
+        targets: [],
+        required: [],
+    };
+    context.once('playbookBuilt', async ({ playbook }) => {
+        try {
+            const extArray = Array.isArray(playbook?.antora?.extensions) ? playbook.antora.extensions : [];
+            const selected = extArray.find((ext) => String(ext.require || '').includes('collector-writer')) || {};
+            const extConf = selected.collectorWriter || selected.collectorwriter || {};
+            cfg = {
+                enabled: toBool(pick(extConf, ['enabled'], cfg.enabled)),
+                quiet: toBool(pick(extConf, ['quiet'], cfg.quiet)),
+                output_dir: String(pick(extConf, ['output_dir', 'outputdir'], cfg.output_dir)) || 'vale-output',
+                targets: ensureArray(pick(extConf, ['targets'], cfg.targets)),
+                required: ensureArray(pick(extConf, ['required'], cfg.required)),
+            };
+            quietMode = !!cfg.quiet;
+            logger.debug('=== collector-writer configuration ===');
+            logger.debug(JSON.stringify(cfg, null, 2));
+        }
+        catch (err) {
+            logger.error(`Config discovery failed: ${err.message}`);
+        }
+    });
+    context.once('contentClassified', async ({ playbook, contentCatalog }) => {
+        try {
+            if (!cfg.enabled) {
+                logger.debug('Collector Writer Disabled (skipped)');
+                return;
+            }
+            if (!contentCatalog) {
+                logger.error('contentCatalog is missing');
+                return;
+            }
+            const allFiles = contentCatalog.getFiles();
+            logger.debug(`=== CATALOG INSPECTION ===`);
+            logger.debug(`Total files in catalog: ${allFiles.length}`);
+            const byComponent = {};
+            allFiles.forEach((f) => {
+                const comp = f.src?.component || 'unknown';
+                if (!byComponent[comp])
+                    byComponent[comp] = [];
+                byComponent[comp].push(f);
+            });
+            Object.keys(byComponent)
+                .sort()
+                .forEach((comp) => {
+                logger.debug(`Component '${comp}': ${byComponent[comp].length} files`);
+                byComponent[comp].slice(0, 10).forEach((f) => {
+                    logger.debug(`  - ${f.src?.relative || f.path} (ext: '${f.src?.extname || 'none'}', basename: '${f.src?.basename || 'none'}')`);
+                });
+                if (byComponent[comp].length > 10) {
+                    logger.debug(`  ... and ${byComponent[comp].length - 10} more files`);
+                }
+            });
+            const projectRoot = path.resolve(playbook?.dir || process.cwd());
+            const cleanupPaths = new Set();
+            const effectiveTargets = [];
+            for (const t of cfg.targets) {
+                const tObj = t;
+                const writeDir = pick(tObj, ['write_dir', 'writeDir', 'writedir'], 'target');
+                effectiveTargets.push({
+                    component: String(t.component || '').trim(),
+                    write_dir: path.resolve(projectRoot, String(writeDir)),
+                    ephemeral: toBool(pick(tObj, ['ephemeral'], true)),
+                });
+            }
+            for (const r of cfg.required) {
+                const component = String(r.component || '').trim();
+                const target = String(r.target || '').trim();
+                if (!component || !target)
+                    continue;
+                effectiveTargets.push({
+                    component,
+                    write_dir: path.resolve(projectRoot, target),
+                    ephemeral: toBool(pick(r, ['ephemeral'], true)),
+                });
+            }
+            logger.debug('=== Effective targets ===');
+            logger.debug(JSON.stringify(effectiveTargets, null, 2));
+            let totalWrites = 0;
+            for (const t of effectiveTargets) {
+                const { component, write_dir, ephemeral } = t;
+                if (!component) {
+                    logger.warn(`Target '${component || write_dir}': component not specified — skipping`);
+                    continue;
+                }
+                await fsp.rm(write_dir, { recursive: true, force: true });
+                await fsp.mkdir(write_dir, { recursive: true });
+                logger.debug(`Cleared and recreated: ${write_dir}`);
+                if (ephemeral)
+                    cleanupPaths.add(write_dir);
+                const files = contentCatalog.getFiles().filter((f) => f.src?.component === component);
+                logger.debug(`=== ALL FILES in catalog for component '${component}' ===`);
+                files.forEach((f) => {
+                    logger.debug(`  - ${f.path || f.src?.relative || 'unknown'}`);
+                    logger.debug(`    basename: '${f.src?.basename}', stem: '${f.src?.stem}', extname: '${f.src?.extname}'`);
+                });
+                const noExtFiles = files.filter((f) => !f.src?.extname || f.src.extname === '');
+                logger.debug(`=== FILES WITHOUT EXTENSION (${noExtFiles.length}) ===`);
+                noExtFiles.forEach((f) => {
+                    logger.debug(`  - ${f.path || f.src?.relative}`);
+                });
+                logger.debug(`Target '${component}' matched ${files.length} file(s)`);
+                for (const f of files) {
+                    let rel = String(f.src?.relative || '').replace(/\\/g, '/');
+                    const targetPath = path.join(write_dir, rel);
+                    await fsp.mkdir(path.dirname(targetPath), { recursive: true });
+                    await fsp.writeFile(targetPath, Buffer.from(f.contents));
+                    totalWrites++;
+                    logger.debug(`wrote: ${targetPath}`);
+                }
+            }
+            logEvent(`Collector wrote ${totalWrites} temporary file(s) to disk`);
+            context.once('sitePublished', async () => {
+                for (const p of cleanupPaths) {
+                    try {
+                        await fsp.rm(p, { recursive: true, force: true });
+                        logger.debug(`Cleaned up ephemeral target: ${p}`);
+                    }
+                    catch (err) {
+                        logger.warn(`Could not clean up '${p}': ${err.message}`);
+                    }
+                }
+            });
+        }
+        catch (e) {
+            logger.error(`Collector Writer failed: ${e.message}`);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/collector-writer/index.js.map

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

package/dist/extensions/external-asset-downloader/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @baiyibai-antora/docs-extensions - external-asset-downloader
+ *
+ * Downloads external assets (images) from HTTP/HTTPS URLs into component directories.
+ * Supports both individual file URLs and HTTP directory listings (Apache autoindex style).
+ *
+ * Configuration in antora-playbook.yml:
+ *
+ * antora:
+ *   extensions:
+ *     - require: '@baiyibai-antora/docs-extensions/extensions/external-asset-downloader'
+ *       assetDownloader:
+ *         enabled: true
+ *         quiet: false
+ *         attribute_prefix: 'image'
+ *         include_commented: true
+ *         target_dir: 'modules/ROOT/images'
+ *         overwrite: 'never'
+ *         concurrency: 5
+ *         directory_listing: true
+ *         url_replace:
+ *           - pattern: '/artifactory/'
+ *             replacement: '/artifactory/api/storage/'
+ */
+interface UrlReplaceRule {
+    pattern: string;
+    replacement: string;
+}
+interface AssetDownloaderConfig {
+    enabled: boolean;
+    quiet: boolean;
+    attribute_prefix: string;
+    include_commented: boolean;
+    target_dir: string;
+    overwrite: 'never' | 'always';
+    concurrency: number;
+    directory_listing: boolean;
+    url_replace: UrlReplaceRule[];
+}
+interface AntoraLogger {
+    debug?: (msg: string) => void;
+    info?: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error?: (msg: string) => void;
+}
+interface ExtensionEntry {
+    require?: string;
+    assetDownloader?: Partial<AssetDownloaderConfig>;
+    assetdownloader?: Partial<AssetDownloaderConfig>;
+}
+interface Playbook {
+    dir?: string;
+    antora?: {
+        extensions?: ExtensionEntry[];
+    };
+}
+interface ComponentVersionConfig {
+    name?: string;
+    version?: string;
+    asciidoc?: {
+        attributes?: Record<string, string>;
+    };
+}
+interface Registry {
+    getLogger?: (name: string) => AntoraLogger;
+    on: (event: string, callback: (context: {
+        playbook: Playbook;
+        contentAggregate?: ComponentVersionConfig[];
+    }) => Promise<void>) => void;
+}
+export declare function register(context: Registry): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/external-asset-downloader/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/external-asset-downloader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAUD,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,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,eAAe,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAClD;AAED,UAAU,QAAQ;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;KAC/B,CAAC;CACH;AAED,UAAU,sBAAsB;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,CAAC;CACH;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,QAAQ,EAAE,QAAQ,CAAC;QAAC,gBAAgB,CAAC,EAAE,sBAAsB,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;CACxI;AA2UD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAuDhD"}