@dogsbay/format-hugo 0.2.0-beta.101

package/dist/builtins.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hugo builtin + Docsy theme shortcodes.
+ *
+ * Every mapping here is evidence-backed: the counts in the comments are
+ * measured occurrences in `kubernetes/website/content/en`. A shortcode whose
+ * semantics could not be verified from real content is deliberately NOT mapped
+ * — an unmapped shortcode is preserved verbatim with a ledger entry, which is
+ * honest, whereas a guessed mapping silently misrepresents the source.
+ */
+import { type ShortcodeRegistry } from "./registry.js";
+export declare const BUILTIN_SHORTCODES: ShortcodeRegistry;
+//# sourceMappingURL=builtins.d.ts.map

package/dist/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../src/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAgBlF,eAAO,MAAM,kBAAkB,EAAE,iBAuMhC,CAAC"}

package/dist/builtins.js

@@ -0,0 +1,207 @@
+/**
+ * Hugo builtin + Docsy theme shortcodes.
+ *
+ * Every mapping here is evidence-backed: the counts in the comments are
+ * measured occurrences in `kubernetes/website/content/en`. A shortcode whose
+ * semantics could not be verified from real content is deliberately NOT mapped
+ * — an unmapped shortcode is preserved verbatim with a ledger entry, which is
+ * honest, whereas a guessed mapping silently misrepresents the source.
+ */
+import { arg, attrBlock, directive } from "./registry.js";
+import { lookupParam } from "./config.js";
+import { looksLikeFile } from "./resolve.js";
+/** Docsy `alert` colours → Dogsbay callout types. */
+const ALERT_COLOURS = {
+    primary: "info",
+    secondary: "note",
+    info: "info",
+    success: "success",
+    warning: "warning",
+    danger: "danger",
+    dark: "note",
+    light: "note",
+};
+export const BUILTIN_SHORTCODES = {
+    // ── Hugo builtins ───────────────────────────────────────
+    //
+    // `{{< highlight go "linenos=table" >}}` — a code block with a language and
+    // Chroma options. 29 uses. The options are Chroma-specific and have no
+    // Dogsbay equivalent, so they are recorded rather than guessed at.
+    highlight: (node, ctx) => {
+        const lang = node.args.positional[0] ?? "";
+        const options = node.args.positional.slice(1).join(" ");
+        if (options) {
+            ctx.report({
+                shortcode: "highlight",
+                action: "degraded",
+                note: `Chroma options dropped (${options}) — no equivalent outside Hugo`,
+                line: node.line,
+            });
+        }
+        const body = node.inner.replace(/^\n+|\n+$/g, "");
+        const fence = "`".repeat(Math.max(3, ...[...body.matchAll(/`{3,}/g)].map((m) => m[0].length + 1)));
+        return `${fence}${lang}\n${body}\n${fence}`;
+    },
+    // `{{< figure src="x.png" alt="…" caption="…" >}}` — 232 uses.
+    figure: (node) => {
+        const src = arg(node.args, "src") ?? "";
+        const alt = node.args.named.alt ?? node.args.named.title ?? "";
+        const caption = node.args.named.caption;
+        const image = `![${alt}](${src})`;
+        return caption ? directive("figure", attrBlock({ caption }), image) : image;
+    },
+    // `{{< youtube dQw4w9WgXcQ >}}` — 15 uses. `id=` is also accepted.
+    youtube: (node) => {
+        const id = arg(node.args, "id") ?? "";
+        return id ? directive("youtube", attrBlock({ id }), "") : null;
+    },
+    // `{{< param "version" >}}` / `{{< param version.next >}}` — 120 uses.
+    // Substitutes from site params. An unresolved param must be RECORDED, never
+    // written out as the string "undefined".
+    param: (node, ctx) => {
+        const key = arg(node.args, "name") ?? "";
+        const value = lookupParam(ctx.config.params, key);
+        if (value === undefined) {
+            ctx.report({
+                shortcode: "param",
+                action: "degraded",
+                note: `site param "${key}" is not defined in the Hugo config — substituted as empty`,
+                line: node.line,
+            });
+            return "";
+        }
+        return value;
+    },
+    // `{{< ref "docs/concepts/_index.md" >}}` — 2570 uses, by far the most
+    // common shortcode in the corpus. It resolves a page reference to its URL.
+    // Unresolved, every one of these becomes a broken link, so the resolver is
+    // wired from the page set rather than guessed from the path.
+    ref: (node, ctx) => {
+        const target = arg(node.args, "path") ?? "";
+        const href = ctx.resolveRef?.(target, ctx.file);
+        if (href !== undefined)
+            return href;
+        ctx.report({
+            shortcode: "ref",
+            action: "degraded",
+            note: `could not resolve reference "${target}" — emitted as a relative path`,
+            line: node.line,
+        });
+        // Better a path than nothing: the link still points somewhere plausible
+        // and a link checker can find it.
+        return `/${target.replace(/^\//, "").replace(/(?:\/_?index)?\.md$/, "")}`;
+    },
+    // `{{< relref "other.md" >}}` — 13 uses. Same resolution, relative result.
+    relref: (node, ctx) => {
+        const target = arg(node.args, "path") ?? "";
+        const href = ctx.resolveRef?.(target, ctx.file);
+        if (href !== undefined)
+            return href;
+        ctx.report({
+            shortcode: "relref",
+            action: "degraded",
+            note: `could not resolve reference "${target}" — emitted as a relative path`,
+            line: node.line,
+        });
+        return target.replace(/(?:\/_?index)?\.md$/, "");
+    },
+    // ── Callouts ────────────────────────────────────────────
+    //
+    // Hugo/Docsy sites all grow the same three, and Kubernetes uses them 1,071
+    // times between them. The body may be markdown (`{{% note %}}`) or raw
+    // (`{{< note >}}`); either way it is content and gets translated.
+    note: (node, ctx) => directive("note", "", ctx.translate(node.inner)),
+    caution: (node, ctx) => directive("caution", "", ctx.translate(node.inner)),
+    warning: (node, ctx) => directive("warning", "", ctx.translate(node.inner)),
+    // Docsy's own callout. 91 uses. `color=` selects the variant and `title=`
+    // is a heading on the box.
+    alert: (node, ctx) => {
+        const colour = (node.args.named.color ?? "").toLowerCase();
+        const type = ALERT_COLOURS[colour] ?? "note";
+        if (colour && !ALERT_COLOURS[colour]) {
+            ctx.report({
+                shortcode: "alert",
+                action: "degraded",
+                note: `unknown alert colour "${colour}" → :::note`,
+                line: node.line,
+            });
+        }
+        return directive(type, attrBlock({ title: node.args.named.title }), ctx.translate(node.inner));
+    },
+    // Docsy `pageinfo` — a page-level banner. Same shape as an alert.
+    pageinfo: (node, ctx) => directive(ALERT_COLOURS[(node.args.named.color ?? "").toLowerCase()] ?? "info", "", ctx.translate(node.inner)),
+    // ── Tabs ────────────────────────────────────────────────
+    //
+    // `{{< tabs name="x" >}}` wrapping `{{% tab name="Linux" %}}`. 117 groups,
+    // 287 tabs. Note the delimiter mix: the wrapper is angle, the tabs are
+    // percent, which is exactly why the scanner has to handle both.
+    tabs: (node, ctx) => directive("tabs", "", ctx.translate(node.inner)),
+    tab: (node, ctx) => {
+        const title = arg(node.args, "name", "header", "title") ?? "";
+        // `{{< tab name="x" include="file.md" />}}` — the kubeadm reference pages
+        // use this 118 times to pull in generated content.
+        // `include=` is not always a path: `{{< feature-gate-table include="alpha,beta" >}}`
+        // uses the same attribute name as a FILTER, and treating that as a file
+        // produced a guaranteed-failing read plus a misleading ledger entry.
+        const include = node.args.named.include;
+        if (looksLikeFile(include)) {
+            const content = ctx.readContentFile?.(include, ctx.file);
+            if (content !== undefined) {
+                return directive("tab", attrBlock({ title }), ctx.translate(content));
+            }
+            ctx.report({
+                shortcode: "tab",
+                action: "degraded",
+                note: `could not read included file "${include}" — tab is empty`,
+                line: node.line,
+            });
+            return directive("tab", attrBlock({ title }), "");
+        }
+        return directive("tab", attrBlock({ title }), ctx.translate(node.inner));
+    },
+    // Docsy's newer tab syntax.
+    tabpane: (node, ctx) => directive("tabs", "", ctx.translate(node.inner)),
+    "tab-pane": (node, ctx) => directive("tab", attrBlock({ title: arg(node.args, "header", "title", "name") }), ctx.translate(node.inner)),
+    // ── Other block constructs ──────────────────────────────
+    //
+    // 53 uses. A mermaid diagram is a code block with a `mermaid` language
+    // everywhere outside Hugo.
+    mermaid: (node) => {
+        const body = node.inner.replace(/^\n+|\n+$/g, "");
+        return `\`\`\`mermaid\n${body}\n\`\`\``;
+    },
+    // 59 uses. `{{< table caption="…" >}}` wraps a markdown table to caption it.
+    table: (node, ctx) => {
+        const caption = node.args.named.caption;
+        const body = ctx.translate(node.inner).replace(/^\n+|\n+$/g, "");
+        // Dogsbay-MD captions a table with a trailing `{caption}` line.
+        return caption ? `${body}\n{${caption}}` : body;
+    },
+    // `{{< include "file.md" >}}` — 171 uses. Pulls in another content file.
+    include: (node, ctx) => {
+        const target = arg(node.args, "file", "path") ?? "";
+        const content = ctx.readContentFile?.(target, ctx.file);
+        if (content === undefined) {
+            ctx.report({
+                shortcode: "include",
+                action: "degraded",
+                note: `could not read included file "${target}"`,
+                line: node.line,
+            });
+            return "";
+        }
+        return ctx.translate(content);
+    },
+    // 12 uses. An author note that never renders — dropping it is correct, and
+    // recording the drop is what makes it not-silent.
+    comment: (node, ctx) => {
+        ctx.report({
+            shortcode: "comment",
+            action: "stripped",
+            note: "author comment — not rendered by Hugo either",
+            line: node.line,
+        });
+        return null;
+    },
+};
+//# sourceMappingURL=builtins.js.map

package/dist/builtins.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,33 @@
+import type { FormatPlugin, ExportPage, NavItem } from "@dogsbay/types";
+import type { HugoLedgerEntry } from "./registry.js";
+export interface HugoImportResult {
+    pages: ExportPage[];
+    nav: NavItem[];
+    /** What could not be carried across, per shortcode. */
+    ledger: HugoLedgerEntry[];
+    /** Site title from the Hugo config, when it declared one. */
+    siteTitle?: string;
+    /** Languages the site declares — the choices for `--lang`. */
+    languages: string[];
+    /**
+     * Absolute directory the page slugs are relative to: the content dir,
+     * narrowed by `--lang` and `--section`. Recomputing it from the config
+     * alone drops both narrowings and resolves includes to the wrong file.
+     */
+    contentRoot: string;
+    /** Docs roots to mirror non-`.md` assets from (dir + slug prefix). */
+    assetRoots: {
+        dir: string;
+        prefix: string;
+    }[];
+}
+export declare function importHugo(source: string, opts: Record<string, unknown>): Promise<HugoImportResult>;
+/** Group the ledger for a human-readable report. */
+export declare function summariseHugoLedger(ledger: HugoLedgerEntry[]): Array<{
+    shortcode: string;
+    action: string;
+    count: number;
+    note?: string;
+}>;
+export declare const plugin: FormatPlugin;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAMxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,uDAAuD;IACvD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA2I3B;AAED,oDAAoD;AACpD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EAAE,GACxB,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAS5E;AAED,eAAO,MAAM,MAAM,EAAE,YAyBpB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,190 @@
+/**
+ * FormatPlugin for Hugo as a source format.
+ *
+ * Orchestrates: detect site → load config → collect pages → build nav and the
+ * ref resolver from the page set → translate each page → parse to TreeNode.
+ *
+ * The ref resolver has to exist BEFORE any page is translated, because
+ * `{{< ref >}}` is the most common shortcode in a real Hugo corpus (2,570 uses
+ * on kubernetes/website) and resolving it needs the whole page set. That is
+ * why this is two passes, not one.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { dogsbayMdToTree, extractHeadings } from "@dogsbay/format-dogsbay-md";
+import { detectHugo, loadHugoConfig, contentDirFor } from "./config.js";
+import { collectHugoPages, buildHugoNav, makeRefResolver, splitFrontmatter } from "./nav.js";
+import { makeContentResolver } from "./resolve.js";
+import { translateHugo } from "./translate.js";
+export async function importHugo(source, opts) {
+    if (!existsSync(source)) {
+        throw new Error(`Source directory not found: ${source}`);
+    }
+    const config = loadHugoConfig(source);
+    if (config.parseErrors.length > 0) {
+        // Not fatal, but never silent: params feed `{{< param >}}` and
+        // `{{< skew >}}`, so a config we fell back on turns those into nothing.
+        for (const e of config.parseErrors) {
+            console.warn(`  warning: could not parse ${e.file} — ${e.message}`);
+        }
+    }
+    const lang = typeof opts.lang === "string" ? opts.lang : undefined;
+    const section = typeof opts.section === "string" ? opts.section.replace(/^\/+|\/+$/g, "") : undefined;
+    const hrefPrefix = typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : "";
+    const langRoot = resolve(source, contentDirFor(config, lang));
+    // `--section docs` imports one subtree. On a site like kubernetes the blog
+    // is ~1,500 dated pages that Hugo renders through a SEPARATE layout, so
+    // pulling everything into one docs sidebar is faithful to the file tree and
+    // useless to a reader.
+    const contentRoot = section ? resolve(langRoot, section) : langRoot;
+    if (!existsSync(contentRoot)) {
+        const choices = config.languages.map((l) => l.code).join(", ");
+        throw new Error(`Content directory not found: ${contentRoot}` +
+            (section ? `\n(--section ${section} resolved against ${langRoot})` : "") +
+            (choices ? `\nDeclared languages: ${choices}` : ""));
+    }
+    // PASS 1 — the page set. Nav and ref resolution both need all of it before
+    // any page can be translated.
+    const hugoPages = collectHugoPages(contentRoot, config.permalinks, config.sectionPermalinks);
+    const nav = buildHugoNav(hugoPages, hrefPrefix);
+    const resolveRef = makeRefResolver(hugoPages, hrefPrefix);
+    const readContentFile = makeContentResolver({ contentRoot });
+    // PASS 2 — translate and parse.
+    const ledger = [];
+    const pages = [];
+    const seen = new Set();
+    for (const page of hugoPages) {
+        if (page.hidden && opts.includeDrafts !== true)
+            continue;
+        // An `.html` content page is a Go template, not markdown. It is still a
+        // page — it has a title, a slug and a place in the nav — so it is emitted
+        // as a stub and RECORDED, rather than skipped. Skipping left kubernetes
+        // with no home page at all (its home is `content/en/_index.html`) and the
+        // site root redirecting to whatever sorted first.
+        if (page.unrenderable) {
+            ledger.push({
+                shortcode: "(page)",
+                action: "degraded",
+                note: `${page.rel} is an HTML content page (Go template, no markdown) — emitted as a titled stub`,
+                line: 0,
+                file: page.rel,
+            });
+            pages.push({
+                slug: page.slug,
+                title: page.title,
+                tree: [],
+                headings: [],
+                frontmatter: page.frontmatter,
+            });
+            seen.add(page.slug);
+            continue;
+        }
+        const source_ = readFileSync(page.file, "utf-8");
+        const { body } = splitFrontmatter(source_);
+        const { markdown, ledger: entries } = translateHugo(body, {
+            config,
+            file: page.rel,
+            resolveRef,
+            readContentFile,
+            kubernetes: opts.kubernetes !== false,
+        });
+        ledger.push(...entries);
+        let tree;
+        try {
+            ({ tree } = dogsbayMdToTree(markdown));
+        }
+        catch (err) {
+            // A page that will not parse must be REPORTED, not dropped: it is the
+            // one failure mode a page count cannot show.
+            ledger.push({
+                shortcode: "(page)",
+                action: "degraded",
+                note: `could not parse the translated markdown — ${err instanceof Error ? err.message : String(err)}`,
+                line: 0,
+                file: page.rel,
+            });
+            continue;
+        }
+        // Two source files can resolve to one slug (a `url:` override colliding
+        // with a real path). Silently overwriting one with the other loses a page.
+        let slug = page.slug;
+        if (seen.has(slug)) {
+            let n = 2;
+            while (seen.has(`${slug}-${n}`))
+                n++;
+            ledger.push({
+                shortcode: "(page)",
+                action: "degraded",
+                note: `slug "${slug}" is claimed by more than one source file — emitted as "${slug}-${n}"`,
+                line: 0,
+                file: page.rel,
+            });
+            slug = `${slug}-${n}`;
+        }
+        seen.add(slug);
+        pages.push({
+            slug,
+            title: page.title,
+            tree,
+            headings: extractHeadings(tree),
+            frontmatter: page.frontmatter,
+            // Include fragments are emitted so their text is not lost, but marked so
+            // the CLI writes them as include targets rather than routable pages.
+            ...(page.fragment ? { fragment: true } : {}),
+        });
+    }
+    return {
+        pages,
+        nav,
+        ledger,
+        // The root slugs are relative to — `content/`, narrowed by `--lang` and
+        // `--section`. Callers must use THIS, not recompute it: an include
+        // resolved against a recomputed `content/` while the pages came from
+        // `content/docs/` silently found a DIFFERENT file of the same name.
+        contentRoot,
+        siteTitle: config.title,
+        languages: config.languages.map((l) => l.code),
+        assetRoots: [{ dir: contentRoot, prefix: "" }],
+    };
+}
+/** Group the ledger for a human-readable report. */
+export function summariseHugoLedger(ledger) {
+    const rows = new Map();
+    for (const entry of ledger) {
+        const key = `${entry.shortcode}\t${entry.action}`;
+        const row = rows.get(key);
+        if (row)
+            row.count++;
+        else
+            rows.set(key, { shortcode: entry.shortcode, action: entry.action, count: 1, note: entry.note });
+    }
+    return [...rows.values()].sort((a, b) => b.count - a.count);
+}
+export const plugin = {
+    name: "hugo",
+    canImport: true,
+    canExport: false,
+    detectSource: (path) => {
+        if (!detectHugo(path))
+            return false;
+        // A Hugo site must also have content; a bare `hugo.toml` in a tools repo
+        // is not a docs corpus.
+        const config = loadHugoConfig(path);
+        return existsSync(join(path, config.contentDir)) || existsSync(join(path, "content"));
+    },
+    importOptions: [
+        { flags: "--lang <code>", description: "language directory to import (multilingual sites)" },
+        { flags: "--section <path>", description: "import only this subtree, e.g. docs" },
+        { flags: "--include-drafts", description: "import pages marked draft/headless" },
+        { flags: "--no-kubernetes", description: "disable the kubernetes.io shortcode layer" },
+    ],
+    async import(source, opts) {
+        const result = await importHugo(source, opts);
+        return {
+            pages: result.pages,
+            nav: result.nav,
+            contentRoot: result.contentRoot,
+        };
+    },
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,72 @@
+export interface HugoLanguage {
+    code: string;
+    /** Content directory for this language, relative to the site root. */
+    contentDir: string;
+    title?: string;
+    weight?: number;
+}
+export interface HugoConfig {
+    title?: string;
+    baseURL?: string;
+    /** Default content directory, relative to the site root. */
+    contentDir: string;
+    /** Site params — the substitution source for `{{< param >}}` / `{{< skew >}}`. */
+    params: Record<string, unknown>;
+    /** Declared languages, empty when the site is monolingual. */
+    languages: HugoLanguage[];
+    /** Theme names, in order. `docsy` here is what selects the Docsy mappings. */
+    themes: string[];
+    /**
+     * `[permalinks]` — per-section URL patterns.
+     *
+     * NOT cosmetic. kubernetes maps `blog = "/:section/:year/:month/:day/:slug/"`,
+     * so `blog/_posts/2018/coredns-ga.md` is served at
+     * `/blog/2018/07/10/coredns-ga/` and the `_posts/2018` directories never
+     * appear in the URL at all. Ignoring this produced slugs containing
+     * `_posts`, which Docusaurus then refused entirely — it reserves a leading
+     * `_` for partials — and the build failed on 400+ "sidebar document ids do
+     * not exist".
+     */
+    permalinks: Record<string, string>;
+    /**
+     * `[permalinks.section]` — patterns for SECTION pages (`_index.md`).
+     *
+     * Kept separate because Hugo keeps them separate, and conflating them is a
+     * real bug: kubernetes declares only `[permalinks.page]`, so applying its
+     * blog pattern to `blog/_index.md` turned the section's own slug into
+     * `blog/blog` and dropped "Blog" to the bottom of the nav.
+     */
+    sectionPermalinks: Record<string, string>;
+    /** Files the config was assembled from, for diagnostics. */
+    sources: string[];
+    /**
+     * Configs that could not be parsed, with the reason.
+     *
+     * This must be SURFACED, not swallowed: `{{< param >}}` and `{{< skew >}}`
+     * substitute from `[params]`, so a config we silently fall back on turns
+     * hundreds of content substitutions into nothing while the import reports
+     * success.
+     */
+    parseErrors: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/** Detect whether a directory looks like a Hugo site. */
+export declare function detectHugo(dir: string): boolean;
+export declare function loadHugoConfig(dir: string): HugoConfig;
+/**
+ * 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 declare function lookupParam(params: Record<string, unknown>, path: string): string | undefined;
+/**
+ * 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 declare function contentDirFor(config: HugoConfig, lang?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,8DAA8D;IAC9D,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;;;;;;;OAUG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;;;;;;;OAOG;IACH,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;;;OAOG;IACH,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAyCD,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ/C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAoFtD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAgBpB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAWvE"}