@dogsbay/format-hugo 0.2.0-beta.101

package/dist/config.js

@@ -0,0 +1,191 @@
+/**
+ * Hugo site configuration.
+ *
+ * Hugo accepts `hugo.toml|yaml|json`, the legacy `config.*` names, and a
+ * `config/_default/**` directory that is merged key-by-key. Kubernetes uses
+ * `hugo.toml` with `contentDir = "content/en"`.
+ *
+ * This is not just metadata. `{{< param "x" >}}` and `{{< skew >}}` read
+ * `[params]`, so the config is required for CONTENT fidelity: without it those
+ * shortcodes have nothing to substitute and 418 calls across the kubernetes
+ * corpus resolve to nothing.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, extname } from "node:path";
+import { parse as parseToml } from "smol-toml";
+import { parse as parseYaml } from "yaml";
+const CONFIG_BASENAMES = ["hugo", "config"];
+const CONFIG_EXTS = [".toml", ".yaml", ".yml", ".json"];
+function parseFile(path, errors, label) {
+    try {
+        const text = readFileSync(path, "utf-8");
+        const ext = extname(path).toLowerCase();
+        if (ext === ".toml")
+            return parseToml(text);
+        if (ext === ".json")
+            return JSON.parse(text);
+        return (parseYaml(text) ?? {});
+    }
+    catch (err) {
+        // A config we cannot read degrades to defaults rather than killing the
+        // import — the content is still worth having — but the caller is told.
+        errors.push({ file: label, message: err instanceof Error ? err.message : String(err) });
+        return null;
+    }
+}
+/** Deep merge, later wins. Hugo merges `config/_default/**` this way. */
+function merge(base, next) {
+    const out = { ...base };
+    for (const [k, v] of Object.entries(next)) {
+        const prev = out[k];
+        out[k] =
+            prev && typeof prev === "object" && !Array.isArray(prev) &&
+                v && typeof v === "object" && !Array.isArray(v)
+                ? merge(prev, v)
+                : v;
+    }
+    return out;
+}
+/** Detect whether a directory looks like a Hugo site. */
+export function detectHugo(dir) {
+    if (!existsSync(dir))
+        return false;
+    for (const base of CONFIG_BASENAMES) {
+        for (const ext of CONFIG_EXTS) {
+            if (existsSync(join(dir, base + ext)))
+                return true;
+        }
+    }
+    return existsSync(join(dir, "config", "_default"));
+}
+export function loadHugoConfig(dir) {
+    const sources = [];
+    const parseErrors = [];
+    let raw = {};
+    // `config/_default/**` first, then a root config file overrides it — which
+    // is Hugo's precedence.
+    const defaults = join(dir, "config", "_default");
+    if (existsSync(defaults) && statSync(defaults).isDirectory()) {
+        for (const name of readdirSync(defaults).sort()) {
+            if (!CONFIG_EXTS.includes(extname(name).toLowerCase()))
+                continue;
+            const parsed = parseFile(join(defaults, name), parseErrors, join("config/_default", name));
+            if (!parsed)
+                continue;
+            sources.push(join("config/_default", name));
+            // `params.yaml` in that directory populates `params`, `menus.yaml`
+            // populates `menus`, and so on — the FILENAME is the key.
+            const key = name.slice(0, -extname(name).length);
+            raw = key === "hugo" || key === "config" ? merge(raw, parsed) : merge(raw, { [key]: parsed });
+        }
+    }
+    for (const base of CONFIG_BASENAMES) {
+        for (const ext of CONFIG_EXTS) {
+            const path = join(dir, base + ext);
+            if (!existsSync(path))
+                continue;
+            const parsed = parseFile(path, parseErrors, base + ext);
+            if (!parsed)
+                continue;
+            sources.push(base + ext);
+            raw = merge(raw, parsed);
+        }
+    }
+    const params = (raw.params ?? {});
+    const contentDir = typeof raw.contentDir === "string" ? raw.contentDir : "content";
+    const languages = [];
+    const langBlock = raw.languages;
+    if (langBlock && typeof langBlock === "object") {
+        for (const [code, cfg] of Object.entries(langBlock)) {
+            languages.push({
+                code,
+                contentDir: typeof cfg?.contentDir === "string" ? cfg.contentDir : contentDir,
+                title: typeof cfg?.title === "string" ? cfg.title : undefined,
+                weight: typeof cfg?.weight === "number" ? cfg.weight : undefined,
+            });
+        }
+        languages.sort((a, b) => (a.weight ?? 0) - (b.weight ?? 0));
+    }
+    // Hugo accepts both `[permalinks] blog = "…"` and the newer
+    // `[permalinks.page] blog = "…"`.
+    const permalinks = {};
+    const sectionPermalinks = {};
+    const permaRaw = (raw.permalinks ?? {});
+    for (const [key, value] of Object.entries(permaRaw)) {
+        // The legacy flat form applies to regular pages.
+        if (typeof value === "string")
+            permalinks[key] = value;
+        else if (value && typeof value === "object" && (key === "page" || key === "section")) {
+            const target = key === "section" ? sectionPermalinks : permalinks;
+            for (const [k, v] of Object.entries(value)) {
+                if (typeof v === "string")
+                    target[k] = v;
+            }
+        }
+    }
+    const themeRaw = raw.theme;
+    const themes = Array.isArray(themeRaw)
+        ? themeRaw.filter((t) => typeof t === "string")
+        : typeof themeRaw === "string"
+            ? [themeRaw]
+            : [];
+    return {
+        title: typeof raw.title === "string" ? raw.title : undefined,
+        baseURL: typeof raw.baseURL === "string" ? raw.baseURL : undefined,
+        contentDir,
+        params,
+        languages,
+        themes,
+        permalinks,
+        sectionPermalinks,
+        sources,
+        parseErrors,
+    };
+}
+/**
+ * Resolve a dotted param path against the site params, the way
+ * `{{< param "version.next" >}}` does. Returns undefined when absent, so the
+ * caller can record the unresolved reference rather than emitting "undefined".
+ */
+export function lookupParam(params, path) {
+    let cursor = params;
+    for (const key of path.split(".")) {
+        if (!cursor || typeof cursor !== "object")
+            return undefined;
+        // Hugo param lookup is case-insensitive.
+        const record = cursor;
+        const match = key in record
+            ? key
+            : Object.keys(record).find((k) => k.toLowerCase() === key.toLowerCase());
+        if (match === undefined)
+            return undefined;
+        cursor = record[match];
+    }
+    if (cursor === null || cursor === undefined)
+        return undefined;
+    if (typeof cursor === "object")
+        return undefined;
+    return String(cursor);
+}
+/**
+ * The content directory to import for a given language.
+ *
+ * A multilingual Hugo site keeps one directory per language
+ * (`content/en`, `content/ja`, …). Kubernetes declares 18. One language per
+ * import run: mixing them produces a page set with colliding slugs.
+ */
+export function contentDirFor(config, lang) {
+    if (!lang)
+        return config.contentDir;
+    const declared = config.languages.find((l) => l.code === lang);
+    if (declared)
+        return declared.contentDir;
+    // Not declared but conventional: `content/<lang>` beside the default.
+    const parts = config.contentDir.split("/");
+    if (parts.length > 1) {
+        parts[parts.length - 1] = lang;
+        return parts.join("/");
+    }
+    return `${config.contentDir}/${lang}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { scanShortcodes, parseArgs, stripContentTypeMarkers, CONTENT_TYPE_MARKERS, type ScanNode, type ShortcodeNode, type TextNode, type ShortcodeArgs, type ShortcodeDelimiter, } from "./shortcodes.js";
+export { detectHugo, loadHugoConfig, lookupParam, contentDirFor, type HugoConfig, type HugoLanguage, } from "./config.js";
+export { arg, attrBlock, directive, composeRegistry, type ShortcodeMapping, type ShortcodeRegistry, type ShortcodeContext, type HugoLedgerEntry, } from "./registry.js";
+export { BUILTIN_SHORTCODES } from "./builtins.js";
+export { KUBERNETES_SHORTCODES } from "./kubernetes.js";
+export { makeContentResolver, looksLikeFile } from "./resolve.js";
+export { translateHugo, type TranslateOptions, type TranslateResult } from "./translate.js";
+export { collectHugoPages, buildHugoNav, makeRefResolver, splitFrontmatter, type HugoPage, } from "./nav.js";
+export { importHugo, summariseHugoLedger, plugin, type HugoImportResult, } from "./cli.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,SAAS,EACT,uBAAuB,EACvB,oBAAoB,EACpB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,GAAG,EACH,SAAS,EACT,SAAS,EACT,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,KAAK,QAAQ,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,MAAM,EACN,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { scanShortcodes, parseArgs, stripContentTypeMarkers, CONTENT_TYPE_MARKERS, } from "./shortcodes.js";
+export { detectHugo, loadHugoConfig, lookupParam, contentDirFor, } from "./config.js";
+export { arg, attrBlock, directive, composeRegistry, } from "./registry.js";
+export { BUILTIN_SHORTCODES } from "./builtins.js";
+export { KUBERNETES_SHORTCODES } from "./kubernetes.js";
+export { makeContentResolver, looksLikeFile } from "./resolve.js";
+export { translateHugo } from "./translate.js";
+export { collectHugoPages, buildHugoNav, makeRefResolver, splitFrontmatter, } from "./nav.js";
+export { importHugo, summariseHugoLedger, plugin, } from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,SAAS,EACT,uBAAuB,EACvB,oBAAoB,GAMrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,aAAa,GAGd,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,GAAG,EACH,SAAS,EACT,SAAS,EACT,eAAe,GAKhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAA+C,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,GAEjB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,MAAM,GAEP,MAAM,UAAU,CAAC"}

package/dist/kubernetes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Kubernetes site shortcodes.
+ *
+ * These are defined in `kubernetes/website/layouts/shortcodes/`, not in Hugo
+ * or Docsy, so they belong in a SITE layer rather than the core — the same
+ * separation the MDX adapters use. They are here because kubernetes/website is
+ * the testbed and because several are extremely common (`glossary_tooltip`
+ * alone is 1,266 uses), so leaving them unmapped would dominate the ledger.
+ *
+ * Counts are measured in `content/en`.
+ */
+import { type ShortcodeRegistry } from "./registry.js";
+export declare const KUBERNETES_SHORTCODES: ShortcodeRegistry;
+//# sourceMappingURL=kubernetes.d.ts.map

package/dist/kubernetes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kubernetes.d.ts","sourceRoot":"","sources":["../src/kubernetes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAWlF,eAAO,MAAM,qBAAqB,EAAE,iBAkKnC,CAAC"}

package/dist/kubernetes.js

@@ -0,0 +1,186 @@
+/**
+ * Kubernetes site shortcodes.
+ *
+ * These are defined in `kubernetes/website/layouts/shortcodes/`, not in Hugo
+ * or Docsy, so they belong in a SITE layer rather than the core — the same
+ * separation the MDX adapters use. They are here because kubernetes/website is
+ * the testbed and because several are extremely common (`glossary_tooltip`
+ * alone is 1,266 uses), so leaving them unmapped would dominate the ledger.
+ *
+ * Counts are measured in `content/en`.
+ */
+import { arg, directive } from "./registry.js";
+import { lookupParam } from "./config.js";
+/** `stable` | `beta` | `alpha` | `deprecated` → a callout type. */
+const STATE_TYPES = {
+    stable: "success",
+    beta: "info",
+    alpha: "warning",
+    deprecated: "caution",
+};
+export const KUBERNETES_SHORTCODES = {
+    // 1,162 uses — the single most structurally important one.
+    //
+    // It returns the TEXT ONLY. The source already supplies the hashes:
+    // `## {{% heading "whatsnext" %}}` — measured, 1,161 of 1,162 calls sit
+    // after a `#` run on the same line. Emitting `## Text` here produced
+    // `## ## Whatsnext` on every one of them, which markdown then rendered as a
+    // heading whose visible text began with two hashes. Caught only by looking
+    // at a real exported page; no fixture would have suggested it.
+    heading: (node, ctx) => {
+        const name = arg(node.args, "name") ?? "";
+        if (!name) {
+            ctx.report({
+                shortcode: "heading",
+                action: "degraded",
+                note: "heading had no name argument",
+                line: node.line,
+            });
+            return "";
+        }
+        // The argument is a translation KEY (`whatsnext`, `prerequisites`); the
+        // rendered text comes from the site's i18n files. Title-casing the key is
+        // a readable, honest approximation and is recorded as one.
+        const text = name
+            .replace(/[_-]+/g, " ")
+            .replace(/\b\w/g, (c) => c.toUpperCase());
+        ctx.report({
+            shortcode: "heading",
+            action: "degraded",
+            note: `i18n heading key "${name}" rendered as "${text}" — the translated string lives in the site's i18n files`,
+            line: node.line,
+        });
+        return text;
+    },
+    // 1,266 uses. A glossary term with a hover definition. The tooltip is a
+    // theme affordance; the LINK and the text are the content.
+    glossary_tooltip: (node) => {
+        const text = arg(node.args, "text") ?? node.args.named.term_id ?? "";
+        const term = node.args.named.term_id;
+        return term ? `[${text}](/docs/reference/glossary/?term=${term})` : text;
+    },
+    // 38 uses. Inlines a glossary term's long description.
+    glossary_definition: (node, ctx) => {
+        const term = node.args.named.term_id ?? "";
+        ctx.report({
+            shortcode: "glossary_definition",
+            action: "degraded",
+            note: `glossary definition for "${term}" is generated from the site's glossary data files — emitted as a link`,
+            line: node.line,
+        });
+        return term ? `[${term}](/docs/reference/glossary/?term=${term})` : "";
+    },
+    // 402 uses. `{{< feature-state for_k8s_version="v1.29" state="stable" >}}`
+    // or the newer `feature_gate_name=` form.
+    "feature-state": (node, ctx) => {
+        const state = (node.args.named.state ?? "").toLowerCase();
+        const version = node.args.named.for_k8s_version;
+        const gate = node.args.named.feature_gate_name;
+        if (gate && !state) {
+            // The state is looked up from the site's feature-gate data files.
+            ctx.report({
+                shortcode: "feature-state",
+                action: "degraded",
+                note: `stability of feature gate "${gate}" comes from the site's data files — emitted without a state`,
+                line: node.line,
+            });
+            return directive("info", "", `Feature gate: \`${gate}\``);
+        }
+        const type = STATE_TYPES[state] ?? "info";
+        const label = [state && state.toUpperCase(), version].filter(Boolean).join(" · ");
+        return directive(type, "", `Feature state: ${label || "unspecified"}`);
+    },
+    // 298 uses. Version-skew arithmetic against the site params
+    // (`{{< skew currentVersion >}}`, `{{< skew latestVersionAddMinor -1 >}}`).
+    skew: (node, ctx) => {
+        const key = node.args.positional[0] ?? "currentVersion";
+        const value = lookupParam(ctx.config.params, key) ??
+            lookupParam(ctx.config.params, "version") ??
+            lookupParam(ctx.config.params, "currentVersion");
+        if (value === undefined) {
+            ctx.report({
+                shortcode: "skew",
+                action: "degraded",
+                note: `version-skew value "${key}" is computed by the site from Hugo params — substituted as empty`,
+                line: node.line,
+            });
+            return "";
+        }
+        if (node.args.positional.length > 1) {
+            ctx.report({
+                shortcode: "skew",
+                action: "degraded",
+                note: `version arithmetic (${node.args.positional.join(" ")}) is not evaluated — emitted as the base version`,
+                line: node.line,
+            });
+        }
+        return value;
+    },
+    // 365 uses. Embeds a file from `content/<lang>/examples/` as a code block.
+    // The file IS the content, so failing to read it is a real loss.
+    code_sample: (node, ctx) => {
+        const file = arg(node.args, "file") ?? "";
+        const lang = node.args.named.language ?? guessLanguage(file);
+        const content = ctx.readContentFile?.(`examples/${file.replace(/^\//, "")}`, ctx.file);
+        if (content === undefined) {
+            ctx.report({
+                shortcode: "code_sample",
+                action: "degraded",
+                note: `could not read example file "${file}" — emitted as a link`,
+                line: node.line,
+            });
+            return `[${file}](/examples/${file.replace(/^\//, "")})`;
+        }
+        const body = content.replace(/\n+$/, "");
+        const fence = "`".repeat(Math.max(3, ...[...body.matchAll(/`{3,}/g)].map((m) => m[0].length + 1)));
+        return `${fence}${lang}\n${body}\n${fence}`;
+    },
+    // Older alias for the same thing.
+    codenew: (node, ctx) => KUBERNETES_SHORTCODES.code_sample(node, ctx),
+    // 96 uses. A version guard around content; for a static export the content
+    // inside is what the reader wants.
+    "version-check": (node, ctx) => {
+        ctx.report({
+            shortcode: "version-check",
+            action: "stripped",
+            note: "runtime version guard — has no meaning in a static export",
+            line: node.line,
+        });
+        return node.inner ? ctx.translate(node.inner) : null;
+    },
+    // 45 uses. A standing disclaimer about third-party content.
+    "thirdparty-content": (node, ctx) => directive("note", "", node.inner
+        ? ctx.translate(node.inner)
+        : "This section links to third party projects that provide functionality required by Kubernetes. The Kubernetes project authors are not responsible for those projects."),
+    // 17 uses. A link into the generated API reference.
+    "api-reference": (node, ctx) => {
+        const kind = node.args.named.kind ?? "";
+        const placeholder = node.args.named.placeholder ?? kind;
+        ctx.report({
+            shortcode: "api-reference",
+            action: "degraded",
+            note: `generated API reference for "${kind}" — emitted as a link, the generator is a separate Go tool`,
+            line: node.line,
+        });
+        return kind ? `[${placeholder}](/docs/reference/kubernetes-api/)` : "";
+    },
+};
+/** Language for a code sample, from its file extension. */
+function guessLanguage(file) {
+    const ext = file.split(".").pop()?.toLowerCase() ?? "";
+    const map = {
+        yaml: "yaml",
+        yml: "yaml",
+        json: "json",
+        sh: "shell",
+        bash: "shell",
+        go: "go",
+        py: "python",
+        js: "javascript",
+        ts: "typescript",
+        xml: "xml",
+        toml: "toml",
+    };
+    return map[ext] ?? "";
+}
+//# sourceMappingURL=kubernetes.js.map

package/dist/kubernetes.js.map

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

package/dist/nav.d.ts

@@ -0,0 +1,88 @@
+import type { NavItem } from "@dogsbay/types";
+export interface HugoPage {
+    /** Absolute path of the source file. */
+    file: string;
+    /** Path relative to the content root, e.g. `docs/concepts/pods.md`. */
+    rel: string;
+    /** Site-root-relative slug with no leading or trailing slash. */
+    slug: string;
+    title: string;
+    /** Nav label — `linkTitle` when present, else `title`. */
+    linkTitle: string;
+    weight?: number;
+    frontmatter: Record<string, unknown>;
+    /** A `_index.md`: this page IS a section and has children. */
+    isSection: boolean;
+    /** A `index.md` leaf bundle: the directory is one page with co-located assets. */
+    isLeafBundle: boolean;
+    /** Whether the page asked not to be listed in nav (`_build`/`draft`/`headless`). */
+    hidden: boolean;
+    /**
+     * The source is an `.html` content page — Go template + HTML, with no
+     * markdown to import. It is still a PAGE (it has a title, a slug and a place
+     * in the nav), so it is collected and emitted as a stub rather than
+     * vanishing: kubernetes' own home is `content/en/_index.html`, and skipping
+     * it left the site with no root at all.
+     */
+    unrenderable: boolean;
+    /**
+     * An include FRAGMENT, not a routable page.
+     *
+     * Hugo has no formal marker for this, but the convention is universal: a
+     * file under `includes/` exists to be pulled in by `{{< include >}}`, and
+     * emitting it as its own page publishes the same text twice — once inside
+     * each of the 131 pages that include it, and once on a URL nobody links to.
+     */
+    fragment: boolean;
+}
+/** Split Hugo frontmatter: `---` YAML, `+++` TOML, or `{ }` JSON. */
+export declare function splitFrontmatter(source: string): {
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+/**
+ * Walk a Hugo content directory into a flat page list.
+ *
+ * Ordinary markdown only — `.html` content pages exist in Hugo but carry no
+ * markdown to import, and pulling them in would emit pages of raw template.
+ */
+/**
+ * Apply a Hugo `[permalinks]` pattern to a page.
+ *
+ * Tokens Hugo defines that matter for docs corpora: `:section`, `:sections`,
+ * `:year`, `:month`, `:day`, `:slug`, `:title`, `:filename`, `:contentbasename`.
+ * An unknown token is left in place rather than silently emitting an empty
+ * segment — a wrong URL you can see beats one you cannot.
+ */
+export declare function applyPermalink(pattern: string, ctx: {
+    section: string;
+    sections: string[];
+    slug: string;
+    filename: string;
+    title: string;
+    date?: Date;
+}): string;
+export declare function collectHugoPages(contentRoot: string, permalinks?: Record<string, string>, sectionPermalinks?: Record<string, string>): HugoPage[];
+/**
+ * Build the nav tree from the page set.
+ *
+ * Ordering is Hugo's: `weight` ascending, then title. Pages with no weight
+ * sort AFTER weighted ones — Hugo treats a missing weight as 0 and then falls
+ * back to date/title, but for docs the practical rule authors rely on is
+ * "weighted items lead, the rest follow alphabetically".
+ */
+export declare function buildHugoNav(pages: HugoPage[], hrefPrefix?: string): NavItem[];
+/**
+ * Resolve a `{{< ref >}}` / `{{< relref >}}` target against the page set.
+ *
+ * 2,570 calls in the kubernetes corpus — the most common shortcode by a wide
+ * margin, and every unresolved one is a broken link. Hugo accepts a lot of
+ * forms for the same page:
+ *
+ *   "/docs/concepts/_index.md"   root-relative with the file name
+ *   "docs/concepts"              root-relative, no extension
+ *   "pods.md"                    relative to the calling page
+ *   "#anchor" / "page.md#anchor" with a fragment
+ */
+export declare function makeRefResolver(pages: HugoPage[], hrefPrefix?: string): (target: string, from?: string) => string | undefined;
+//# sourceMappingURL=nav.d.ts.map

package/dist/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,YAAY,EAAE,OAAO,CAAC;IACtB,oFAAoF;IACpF,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAwBA;AA+CD;;;;;GAKG;AACH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,GACA,MAAM,CAwBR;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACvC,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC7C,QAAQ,EAAE,CA8HZ;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,UAAU,SAAK,GAAG,OAAO,EAAE,CAyD1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,SAAK,GACd,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAqDvD"}