@dogsbay/format-asciidoc 0.2.0-beta.48

package/dist/loaders/antora.js

@@ -0,0 +1,254 @@
+/**
+ * Antora corpus loader (component mode).
+ *
+ * Detects: presence of `antora.yml` at the source root. Reads the
+ * component manifest (name + version + nav file list + asciidoc
+ * attribute defaults), walks `modules/<name>/pages/**\/*.adoc`, and
+ * builds nav from the referenced `nav.adoc` files.
+ *
+ * **Scope of this MVP — what's covered:**
+ *
+ * - Single-component mode (one antora.yml).
+ * - All modules under `modules/<name>/pages/` — ROOT pages get no
+ *   slug prefix; other modules' pages get a `<module-name>/` prefix.
+ * - nav.adoc parsing: depth-based list items (`*`, `**`, `***`), three
+ *   shapes — `* xref:path[label]`, `** xref:path[]` (empty brackets →
+ *   label from filename), `* Text` (no xref → group header).
+ * - Per-component attribute defaults from `antora.yml`'s
+ *   `asciidoc.attributes:` block are surfaced on every
+ *   `PageSource.attributes`.
+ * - Component name + version surfaced on `LoaderResult.component`.
+ *
+ * **Deliberately out of scope (deferred):**
+ *
+ * - Playbook mode (`antora-playbook.yml`) — pulls in git-resolved
+ *   sources + multi-component aggregation. Component mode covers the
+ *   common single-repo case; playbook mode is a follow-up.
+ * - Cross-module xref resolution (`xref:module:path[label]`). The
+ *   engine emits the xref as text or `{% include %}` per its rules;
+ *   format-astro's downstream link audit will surface the unresolved
+ *   refs.
+ * - Version axis emission. The component's version is surfaced as
+ *   data but not wired into format-astro's version-axis machinery
+ *   (per plans/asciidoc-corpus-loaders.md open question — same
+ *   deferral as asciibinder distros).
+ *
+ * Sample antora.yml shape:
+ *
+ *   name: product
+ *   title: My Product
+ *   version: '2.0'        # null / ~ also valid (unversioned)
+ *   nav:
+ *     - modules/ROOT/nav.adoc
+ *     - modules/admin/nav.adoc
+ *   asciidoc:
+ *     attributes:
+ *       page-component-name: product
+ *
+ * Sample nav.adoc:
+ *
+ *   * xref:index.adoc[Introduction]
+ *   * Getting Started
+ *   ** xref:install.adoc[]
+ *   ** xref:configure.adoc[Configuration]
+ *
+ * See plans/asciidoc-corpus-loaders.md "Antora" section.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, join, relative } from "node:path";
+import YAML from "yaml";
+import { prettifyName } from "./util.js";
+const ANTORA_YML = "antora.yml";
+const ROOT_MODULE = "ROOT";
+function walkPagesUnderModule(modulesDir, moduleName) {
+    const pagesDir = join(modulesDir, moduleName, "pages");
+    if (!existsSync(pagesDir))
+        return [];
+    const out = [];
+    function walk(dir) {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+            }
+            else if (entry.name.endsWith(".adoc")) {
+                const relFromPages = relative(pagesDir, full).replace(/\\/g, "/");
+                const pageSlug = relFromPages.replace(/\.adoc$/, "");
+                // ROOT pages get no module prefix; other modules get one.
+                const slug = moduleName === ROOT_MODULE ? pageSlug : `${moduleName}/${pageSlug}`;
+                out.push({ filePath: full, slug });
+            }
+        }
+    }
+    walk(pagesDir);
+    return out;
+}
+function listModules(sourceDir) {
+    const modulesDir = join(sourceDir, "modules");
+    if (!existsSync(modulesDir))
+        return [];
+    try {
+        return readdirSync(modulesDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse a nav.adoc file into a NavItem[] tree.
+ *
+ * Each line of the form `*+ <content>` is a nav item. The number of
+ * leading `*` characters is the depth (1-based). Content is either:
+ *   - `xref:<path>.adoc[<label>]`  → leaf; label may be empty (use filename)
+ *   - `xref:<module>:<path>.adoc[<label>]`  → leaf in another module
+ *   - plain text                    → group header (no link)
+ *
+ * Algorithm: stack-of-parents per depth. Lines that aren't `*+ ...`
+ * are ignored (blank lines, `.Section` headings, prose).
+ *
+ * `moduleName` is the module the nav lives in — xrefs without an
+ * explicit module prefix resolve under this module's pages/.
+ * `hrefPrefix` prepends every leaf href.
+ */
+function parseNavAdoc(content, moduleName, hrefPrefix) {
+    const root = [];
+    // Stack[d] = the children-array we should push into for a depth-(d+1)
+    // item. stack[0] is `root` (depth 1 items go here).
+    const stack = [root];
+    const lineRe = /^(\*+)\s+(.+)$/;
+    for (const rawLine of content.split("\n")) {
+        const line = rawLine.replace(/\s+$/, "");
+        const m = line.match(lineRe);
+        if (!m)
+            continue;
+        const depth = m[1].length;
+        const text = m[2].trim();
+        const item = parseNavItem(text, moduleName, hrefPrefix);
+        // Find the parent array — if depth exceeds current stack length,
+        // we're going deeper than any actual parent; clamp to current top.
+        const parentIdx = Math.min(depth - 1, stack.length - 1);
+        const parent = stack[parentIdx];
+        parent.push(item);
+        // This item becomes the parent for depth+1 items. Allocate its
+        // children array up-front (so we can push later); if it stays
+        // empty, we strip it before returning.
+        if (!item.children)
+            item.children = [];
+        // Trim deeper-than-current entries; replace stack[depth] with our children.
+        stack.length = depth;
+        stack.push(item.children);
+    }
+    // Clean up: drop empty `children: []` arrays so leaves don't look
+    // like empty groups to downstream consumers.
+    function strip(items) {
+        for (const it of items) {
+            if (it.children && it.children.length === 0) {
+                delete it.children;
+            }
+            else if (it.children) {
+                strip(it.children);
+            }
+        }
+    }
+    strip(root);
+    return root;
+}
+function parseNavItem(text, moduleName, hrefPrefix) {
+    // xref:<path>[<label>] or xref:<module>:<path>[<label>]
+    const xrefRe = /^xref:(?:([^:\s]+):)?([^\[\s]+)\[([^\]]*)\]$/;
+    const m = text.match(xrefRe);
+    if (!m) {
+        // Plain text — group header.
+        return { label: text };
+    }
+    const xrefModule = m[1] || moduleName;
+    const xrefPath = m[2].replace(/\.adoc$/, "");
+    const label = m[3].trim() || prettifyName(basename(xrefPath));
+    const slug = xrefModule === ROOT_MODULE ? xrefPath : `${xrefModule}/${xrefPath}`;
+    return { label, href: `${hrefPrefix}/${slug}` };
+}
+export const antoraLoader = {
+    name: "antora",
+    detect(sourceDir) {
+        if (!existsSync(sourceDir))
+            return false;
+        try {
+            const st = statSync(sourceDir);
+            if (!st.isDirectory())
+                return false;
+            return existsSync(join(sourceDir, ANTORA_YML));
+        }
+        catch {
+            return false;
+        }
+    },
+    async load(sourceDir, opts) {
+        const ymlPath = join(sourceDir, ANTORA_YML);
+        if (!existsSync(ymlPath)) {
+            throw new Error(`antora loader: ${ANTORA_YML} not found in ${sourceDir}`);
+        }
+        let parsed;
+        try {
+            parsed = YAML.parse(readFileSync(ymlPath, "utf-8"));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`antora loader: cannot parse ${ANTORA_YML}: ${msg}`);
+        }
+        if (!parsed || typeof parsed !== "object" || !parsed.name) {
+            throw new Error(`antora loader: ${ANTORA_YML} must declare at least a 'name' field`);
+        }
+        const hrefPrefix = opts.hrefPrefix ?? "";
+        const componentAttrs = parsed.asciidoc?.attributes ?? {};
+        // Walk every module's pages/ to assemble PageSources. We don't
+        // restrict to modules listed in nav: — a corpus can have pages
+        // not referenced by nav (orphans), and the audit will surface
+        // them; the loader's job is to enumerate them all.
+        const modulesDir = join(sourceDir, "modules");
+        const moduleNames = listModules(sourceDir);
+        const pages = [];
+        for (const moduleName of moduleNames) {
+            for (const { filePath, slug } of walkPagesUnderModule(modulesDir, moduleName)) {
+                const page = { filePath, slug };
+                if (Object.keys(componentAttrs).length > 0) {
+                    page.attributes = { ...componentAttrs };
+                }
+                pages.push(page);
+            }
+        }
+        // Build nav by parsing each referenced nav.adoc file. Concatenate
+        // multiple nav files at the top level — that's Antora's
+        // convention (each nav.adoc is a "section" of the overall nav).
+        const nav = [];
+        for (const navPath of parsed.nav ?? []) {
+            const navFullPath = join(sourceDir, navPath);
+            if (!existsSync(navFullPath)) {
+                // eslint-disable-next-line no-console
+                console.warn(`antora loader: nav file not found, skipping: ${navPath}`);
+                continue;
+            }
+            // Module name from the nav file's path — `modules/<name>/nav.adoc`.
+            const navRelative = relative(modulesDir, navFullPath).replace(/\\/g, "/");
+            const moduleName = navRelative.split("/")[0] ?? ROOT_MODULE;
+            try {
+                const content = readFileSync(navFullPath, "utf-8");
+                nav.push(...parseNavAdoc(content, moduleName, hrefPrefix));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                // eslint-disable-next-line no-console
+                console.warn(`antora loader: cannot read ${navPath}: ${msg}`);
+            }
+        }
+        const result = { pages, nav };
+        result.component = {
+            name: parsed.name,
+            ...(parsed.title ? { title: parsed.title } : {}),
+            ...(parsed.version ? { version: String(parsed.version) } : {}),
+        };
+        return result;
+    },
+};
+//# sourceMappingURL=antora.js.map

package/dist/loaders/antora.js.map

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

package/dist/loaders/asciibinder.d.ts

@@ -0,0 +1,3 @@
+import type { CorpusLoader } from "./types.js";
+export declare const asciibinderLoader: CorpusLoader;
+//# sourceMappingURL=asciibinder.d.ts.map

package/dist/loaders/asciibinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asciibinder.d.ts","sourceRoot":"","sources":["../../src/loaders/asciibinder.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AA+GpB,eAAO,MAAM,iBAAiB,EAAE,YAwF/B,CAAC"}

package/dist/loaders/asciibinder.js

@@ -0,0 +1,206 @@
+/**
+ * AsciiBinder corpus loader (OpenShift docs convention).
+ *
+ * Detects: presence of `_topic_maps/_topic_map.yml` at the source
+ * root. Optionally consumes a sibling `_topic_maps/_distro_map.yml`
+ * to surface the corpus's distro set on the LoaderResult.
+ *
+ * Topology shape (YAML):
+ *
+ *   - Name: Welcome
+ *     Dir: welcome
+ *     Topics:
+ *       - Name: About OpenShift
+ *         File: index
+ *       - Name: Architecture
+ *         File: architecture
+ *         Distros: openshift-enterprise,openshift-online
+ *   - Name: Getting Started
+ *     Dir: getting-started
+ *     Topics:
+ *       - ...
+ *
+ * Translation:
+ *   - Each entry is either a **group** (has `Topics`, no `File`) or a
+ *     **leaf** (has `File`, no `Topics`). The plan allows both fields
+ *     in theory, but the real-world OpenShift corpora always pick one.
+ *   - `Dir` accumulates down the topic tree to form the page slug:
+ *     a leaf at `Topics[0].Topics[1]` with the chain
+ *     `Dir: welcome` → `Dir: gettingstarted` → `File: quickstart`
+ *     becomes slug `welcome/gettingstarted/quickstart`.
+ *   - `Distros` on a leaf is parsed (comma-separated) and surfaced as
+ *     `PageSource.attributes.distros: string[]`. The aggregate union is
+ *     also stashed on `LoaderResult.distros` for future distro-axis
+ *     emission (Phase 9b doesn't yet wire that through format-astro;
+ *     see plans/asciidoc-corpus-loaders.md open question #1).
+ *
+ * Missing files (topic references a file that's not on disk) get
+ * warn-and-skip semantics, matching the master-adoc loader. The
+ * audit catches the wider issue.
+ *
+ * See plans/asciidoc-corpus-loaders.md "AsciiBinder" section.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+const TOPIC_MAP_PATH = "_topic_maps/_topic_map.yml";
+const DISTRO_MAP_PATH = "_topic_maps/_distro_map.yml";
+/**
+ * Walk a TopicEntry[] subtree. Pushes leaves into `pages` + matching
+ * NavItem links into `nav`; pushes group entries (entries with
+ * `Topics`) as nested NavItem groups whose children come from a
+ * recursive walk.
+ *
+ * `parentDirSegments` is the directory chain accumulated from
+ * ancestor `Dir:` fields; concatenated with the entry's own `Dir:`
+ * (if any) and the leaf's `File:` to form the slug.
+ *
+ * `distroAcc` is the set of distros encountered anywhere in the
+ * tree — surfaced on LoaderResult.distros.
+ */
+function walkTopics(entries, parentDirSegments, pages, hrefPrefix, sourceRoot, distroAcc) {
+    const nav = [];
+    for (const entry of entries) {
+        const label = entry.Name ?? "Untitled";
+        const dirSegments = entry.Dir
+            ? [...parentDirSegments, entry.Dir]
+            : parentDirSegments;
+        if (entry.File !== undefined) {
+            const slug = [...dirSegments, entry.File].filter(Boolean).join("/");
+            const filePath = join(sourceRoot, `${slug}.adoc`);
+            if (!existsSync(filePath)) {
+                // eslint-disable-next-line no-console
+                console.warn(`asciibinder loader: topic_map references missing file, skipping: ${slug}.adoc`);
+                continue;
+            }
+            const distros = parseDistros(entry.Distros);
+            for (const d of distros)
+                distroAcc.add(d);
+            const page = { filePath, slug };
+            if (distros.length > 0) {
+                page.attributes = { distros };
+            }
+            pages.push(page);
+            nav.push({ label, href: `${hrefPrefix}/${slug}` });
+            continue;
+        }
+        if (entry.Topics && entry.Topics.length > 0) {
+            const children = walkTopics(entry.Topics, dirSegments, pages, hrefPrefix, sourceRoot, distroAcc);
+            nav.push({ label, children });
+            continue;
+        }
+        // Entry has neither File nor Topics — malformed but tolerated.
+        // Emit a stub nav entry so the user notices the gap rather than
+        // a silent skip.
+        nav.push({ label });
+    }
+    return nav;
+}
+function parseDistros(raw) {
+    if (!raw || typeof raw !== "string")
+        return [];
+    return raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Read the optional _distro_map.yml to learn the corpus's full
+ * distro set. Treated as informational — we surface the union of
+ * what the topic map declares AND what the distro map declares,
+ * so consumers see every distro name the source author cared about.
+ */
+function readDistroMap(sourceDir) {
+    const path = join(sourceDir, DISTRO_MAP_PATH);
+    if (!existsSync(path))
+        return [];
+    try {
+        const yml = YAML.parse(readFileSync(path, "utf-8"));
+        if (yml && typeof yml === "object" && !Array.isArray(yml)) {
+            return Object.keys(yml);
+        }
+    }
+    catch {
+        // Malformed map — ignore, fall back to topic-map-derived distros only.
+    }
+    return [];
+}
+export const asciibinderLoader = {
+    name: "asciibinder",
+    detect(sourceDir) {
+        if (!existsSync(sourceDir))
+            return false;
+        try {
+            const st = statSync(sourceDir);
+            if (!st.isDirectory())
+                return false;
+            return existsSync(join(sourceDir, TOPIC_MAP_PATH));
+        }
+        catch {
+            return false;
+        }
+    },
+    async load(sourceDir, opts) {
+        const topicMapPath = join(sourceDir, TOPIC_MAP_PATH);
+        if (!existsSync(topicMapPath)) {
+            throw new Error(`asciibinder loader: ${TOPIC_MAP_PATH} not found in ${sourceDir}`);
+        }
+        // AsciiBinder's `_topic_map.yml` is a stream of YAML documents
+        // separated by `---` (each document is one top-level topic
+        // group). The file's own header documents this:
+        //   "--- <= Record delimiter"
+        // Real-world corpora (OpenShift docs etc.) rely on it. We
+        // accept either shape:
+        //   (a) the conventional multi-doc stream — each `---` group
+        //       contributes one entry to the topic list, OR
+        //   (b) a single doc with a top-level list — what our earlier
+        //       tests / synthesized fixtures used.
+        let parsed;
+        try {
+            const raw = readFileSync(topicMapPath, "utf-8");
+            const docs = YAML.parseAllDocuments(raw);
+            // parseAllDocuments doesn't throw on bad YAML — it attaches
+            // errors to each Document. Surface the first one with a
+            // clear message.
+            for (const doc of docs) {
+                if (doc.errors && doc.errors.length > 0) {
+                    throw new Error(doc.errors[0].message);
+                }
+            }
+            // Skip empty documents (a trailing `---` produces a null one)
+            // and unwrap each Document to its JS value.
+            const values = docs
+                .map((d) => d.toJS())
+                .filter((v) => v !== null && v !== undefined);
+            if (values.length === 1 && Array.isArray(values[0])) {
+                // Shape (b) — single doc that already wraps the list.
+                parsed = values[0];
+            }
+            else {
+                // Shape (a) — each doc is a topic-group object; flatten
+                // into a list. Defensive: if any single doc is itself a
+                // list (mixed shape), spread it.
+                parsed = values.flatMap((v) => (Array.isArray(v) ? v : [v]));
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`asciibinder loader: cannot parse ${TOPIC_MAP_PATH}: ${msg}`);
+        }
+        if (!Array.isArray(parsed) || parsed.length === 0) {
+            throw new Error(`asciibinder loader: ${TOPIC_MAP_PATH} must contain at least one topic-group entry ` +
+                `(either as a single top-level list, or as a stream of YAML documents separated by \`---\`)`);
+        }
+        const hrefPrefix = opts.hrefPrefix ?? "";
+        const pages = [];
+        const distroAcc = new Set();
+        const nav = walkTopics(parsed, [], pages, hrefPrefix, sourceDir, distroAcc);
+        for (const d of readDistroMap(sourceDir))
+            distroAcc.add(d);
+        const result = { pages, nav };
+        if (distroAcc.size > 0)
+            result.distros = [...distroAcc].sort();
+        return result;
+    },
+};
+//# sourceMappingURL=asciibinder.js.map

package/dist/loaders/asciibinder.js.map

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

package/dist/loaders/master-adoc.d.ts

@@ -0,0 +1,3 @@
+import type { CorpusLoader } from "./types.js";
+export declare const masterAdocLoader: CorpusLoader;
+//# sourceMappingURL=master-adoc.d.ts.map

package/dist/loaders/master-adoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-adoc.d.ts","sourceRoot":"","sources":["../../src/loaders/master-adoc.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAmDpB,eAAO,MAAM,gBAAgB,EAAE,YAiG9B,CAAC"}

package/dist/loaders/master-adoc.js

@@ -0,0 +1,168 @@
+/**
+ * AAP master.adoc corpus loader.
+ *
+ * AAP (Ansible Automation Platform) and adjacent Red Hat docs use a
+ * convention where each "title" is a directory containing a single
+ * `master.adoc` file. That master.adoc is pure structure — typically
+ * an `:attribute:` block plus a sequence of `include::` directives
+ * pointing at module `.adoc` files (usually shared across titles
+ * under a sibling `modules/` tree).
+ *
+ * Phase 9a — first non-plain corpus loader, simplest topology
+ * (no central topo file like AsciiBinder's `_topic_map.yml`).
+ *
+ * Behaviour:
+ *  - Walk the source dir for `master.adoc` files (recursive).
+ *  - For each master, parse its `include::` directives in order;
+ *    each include becomes a `PageSource` (filePath resolved relative
+ *    to the master, slug derived from the resolved path so siblings
+ *    sharing a module map to the same slug — last-write-wins is
+ *    fine; the corpus is conceptually merged).
+ *  - Build a per-title nav group: the title comes from the master's
+ *    parent directory name (prettified); children are the includes
+ *    in source order, labelled by their filename (prettified).
+ *  - Master.adoc files themselves do NOT become pages — they're
+ *    pure structure, not user-facing content.
+ *
+ * Lineage: md2md's `convert-all-titles.sh` is the shell prototype
+ * of this discovery pattern.
+ *
+ * See plans/asciidoc-corpus-loaders.md "AAP master.adoc" section.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { prettifyName } from "./util.js";
+function walkMasterAdocs(dir, out = []) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkMasterAdocs(full, out);
+        }
+        else if (entry.name === "master.adoc") {
+            out.push(full);
+        }
+    }
+    return out;
+}
+/**
+ * Extract include:: directives from an AsciiDoc source.
+ *
+ * Matches the shape `include::path[attr=value,...]`. Multi-line
+ * include blocks are not supported (the engine handles those at
+ * convert time; the loader only needs to enumerate top-level
+ * module references). Returns `null` for the `leveloffset` attribute
+ * when absent.
+ */
+function extractIncludes(adoc) {
+    const out = [];
+    const re = /^include::([^\[\s]+)\[([^\]]*)\]\s*$/gm;
+    for (const m of adoc.matchAll(re)) {
+        const path = m[1];
+        const attrs = m[2];
+        let leveloffset;
+        const lvl = /leveloffset\s*=\s*([+-]?\d+)/.exec(attrs);
+        if (lvl)
+            leveloffset = Number(lvl[1]);
+        out.push({ path, leveloffset });
+    }
+    return out;
+}
+/**
+ * Resolve an include path against the directory containing the
+ * including file. AsciiDoc semantics: paths are relative to the
+ * source file, NOT to the document root. `..` and `.` segments are
+ * normalised by `node:path/resolve`.
+ */
+function resolveIncludePath(includingFile, includePath) {
+    return resolve(dirname(includingFile), includePath);
+}
+export const masterAdocLoader = {
+    name: "master-adoc",
+    detect(sourceDir) {
+        if (!existsSync(sourceDir))
+            return false;
+        try {
+            const st = statSync(sourceDir);
+            if (!st.isDirectory())
+                return false;
+            // Walk subtree for any master.adoc — bail as soon as we find one.
+            function probe(dir) {
+                for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                    if (entry.isDirectory()) {
+                        if (probe(join(dir, entry.name)))
+                            return true;
+                    }
+                    else if (entry.name === "master.adoc") {
+                        return true;
+                    }
+                }
+                return false;
+            }
+            return probe(sourceDir);
+        }
+        catch {
+            return false;
+        }
+    },
+    async load(sourceDir, opts) {
+        if (!existsSync(sourceDir)) {
+            throw new Error(`Source directory not found: ${sourceDir}`);
+        }
+        const hrefPrefix = opts.hrefPrefix ?? "";
+        const masters = walkMasterAdocs(sourceDir).sort();
+        if (masters.length === 0) {
+            throw new Error(`master-adoc loader: no master.adoc files found under ${sourceDir}`);
+        }
+        // Track unique PageSources by resolved filePath so a module
+        // included from multiple titles produces ONE page (last-write-wins
+        // for the leveloffset / attributes hint — typically all titles use
+        // the same shape anyway).
+        const pageByPath = new Map();
+        const navGroups = [];
+        for (const masterPath of masters) {
+            const titleDir = dirname(masterPath);
+            const titleLabel = prettifyName(basename(titleDir));
+            let adoc;
+            try {
+                adoc = readFileSync(masterPath, "utf-8");
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new Error(`master-adoc loader: cannot read ${masterPath}: ${msg}`);
+            }
+            const includes = extractIncludes(adoc);
+            const navChildren = [];
+            for (const inc of includes) {
+                const resolvedPath = resolveIncludePath(masterPath, inc.path);
+                if (!existsSync(resolvedPath)) {
+                    // Skip dangling includes; surface to the user via a warning
+                    // rather than fail the whole load. The engine ALSO logs
+                    // "Include file not found" so the user gets a second signal.
+                    // eslint-disable-next-line no-console
+                    console.warn(`master-adoc loader: include not found, skipping: ${inc.path} (from ${masterPath})`);
+                    continue;
+                }
+                // Slug = resolved path relative to source root, without .adoc.
+                // Forward slashes for URL safety on Windows.
+                const slug = relative(sourceDir, resolvedPath)
+                    .replace(/\\/g, "/")
+                    .replace(/\.adoc$/, "");
+                if (!pageByPath.has(resolvedPath)) {
+                    pageByPath.set(resolvedPath, {
+                        filePath: resolvedPath,
+                        slug,
+                        ...(inc.leveloffset !== undefined ? { leveloffset: inc.leveloffset } : {}),
+                    });
+                }
+                navChildren.push({
+                    label: prettifyName(basename(slug)),
+                    href: `${hrefPrefix}/${slug}`,
+                });
+            }
+            navGroups.push({ label: titleLabel, children: navChildren });
+        }
+        const pages = [...pageByPath.values()];
+        return { pages, nav: navGroups };
+    },
+};
+//# sourceMappingURL=master-adoc.js.map