@dogsbay/format-vitepress 0.2.0-beta.101

package/README.md

@@ -0,0 +1,46 @@
+# @dogsbay/format-vitepress
+
+VitePress importer for [Dogsbay](https://github.com/dogsbay). Converts a
+VitePress docs project into `TreeNode[]` + `NavItem[]`, ready for export to
+Astro, Obsidian, or canonical Dogsbay Markdown.
+
+```bash
+npx dogsbay convert ./my-vitepress-docs --to astro -o ./out
+```
+
+## What it does
+
+- Translates VitePress markdown to Dogsbay-MD: `:::` containers,
+  `::: code-group`, fence metadata (`[label]`, `{1,3-5}`, `:line-numbers`),
+  `<<<` snippets, `<!--@include:-->`, GitHub alerts, custom anchors.
+- Reads the sidebar out of `.vitepress/config.*` **without executing it** —
+  no `node_modules` needed, no code from the source repo runs.
+- Honours `srcDir`, `srcExclude`, `rewrites`, `base`, `cleanUrls`, and
+  `locales.root.themeConfig`.
+- Removes Vue (`<script setup>`, components, `{{ }}`) and **names every
+  component it removed**, because a silent drop is indistinguishable from a
+  clean import.
+
+Validated on vite, vitest and hono: 391 pages, 100% sidebar recovery, 98.7–99.5%
+content retention, all three building through a real `astro build`.
+
+## Usage
+
+```ts
+import { importVitepress } from "@dogsbay/format-vitepress/cli";
+
+const { pages, nav } = await importVitepress("./docs", { hrefPrefix: "/docs" });
+```
+
+Or the pieces:
+
+```ts
+import { parseVitepress, readConfig, buildNav } from "@dogsbay/format-vitepress";
+```
+
+## Docs
+
+- [Migration guide](../../docs/migrating-vitepress.md)
+- [Internals](../../docs-dev/format-vitepress.md)
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,18 @@
+import type { FormatPlugin, ExportPage, NavItem } from "@dogsbay/types";
+export interface VitepressImportResult {
+    pages: ExportPage[];
+    nav: NavItem[];
+    /** Directory page slugs are relative to (`srcDir`). */
+    srcDir: string;
+    navSource: "sidebar" | "directory";
+    assetMounts: {
+        dir: string;
+        into?: string;
+        mediaOnly?: boolean;
+    }[];
+    /** Site title from the config, when it had one. */
+    siteName?: string;
+}
+export declare function importVitepress(source: string, opts?: Record<string, unknown>): Promise<VitepressImportResult>;
+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":"AAWA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAW,MAAM,gBAAgB,CAAC;AAWjF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC;IACnC,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IACnE,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAgEhC;AAqCD,eAAO,MAAM,MAAM,EAAE,YAiBpB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,114 @@
+/**
+ * FormatPlugin for VitePress as a source format.
+ *
+ * Orchestrates: detect corpus → loadVitepress (config + page walk + nav) →
+ * translate each page (parseVitepress) → assemble ExportPage[] + NavItem[].
+ *
+ * VitePress content is `.md`, so this plugin MUST be registered before the
+ * generic dogsbay-md detector. `detectVitepress` requires an actual
+ * `.vitepress/config.*`, so it cannot claim a plain-Markdown corpus.
+ */
+import { readFileSync } from "node:fs";
+import { extractHeadings } from "@dogsbay/format-dogsbay-md";
+import { parseVitepress } from "./parse.js";
+import { loadVitepress, detectVitepress, translateOptionsFor, titleFromSlug, } from "./loaders/load.js";
+export async function importVitepress(source, opts = {}) {
+    const hrefPrefix = typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : "";
+    const loaded = await loadVitepress(source, {
+        hrefPrefix,
+        evalConfig: opts.evalConfig === true || opts.evalConfig === "true",
+    });
+    const pages = [];
+    const components = {};
+    let ledgerTotal = 0;
+    let failed = 0;
+    for (const ps of loaded.pages) {
+        try {
+            const content = readFileSync(ps.filePath, "utf-8");
+            const tOpts = translateOptionsFor(ps, loaded.srcDir, loaded.root, loaded.warnings);
+            const { tree, frontmatter, body, ledger, components: comps } = parseVitepress(content, tOpts);
+            ledgerTotal += ledger.length;
+            for (const [name, n] of Object.entries(comps)) {
+                components[name] = (components[name] ?? 0) + n;
+            }
+            const headings = extractHeadings(tree);
+            const h1 = headings.find((h) => h.depth === 1);
+            const fmTitle = typeof frontmatter.title === "string" && frontmatter.title.trim()
+                ? frontmatter.title.trim()
+                : undefined;
+            // A `layout: home` page carries its name in `hero.name`, not a heading.
+            const heroName = typeof frontmatter.hero?.name === "string"
+                ? (frontmatter.hero.name)
+                : undefined;
+            pages.push({
+                slug: ps.slug,
+                title: fmTitle || h1?.text || heroName || titleFromSlug(ps.slug),
+                tree,
+                headings,
+                frontmatter,
+                meta: (ledger.length
+                    ? { vitepressLedger: ledger }
+                    : {}),
+                bodyMarkdown: body,
+            });
+        }
+        catch (err) {
+            failed += 1;
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`vitepress import: failed to convert ${ps.filePath} (slug "${ps.slug}"), skipping: ${msg}`);
+        }
+    }
+    reportSummary(loaded.warnings, failed, loaded.pages.length, ledgerTotal, components, loaded.navSource);
+    return {
+        pages,
+        nav: loaded.nav,
+        srcDir: loaded.srcDir,
+        navSource: loaded.navSource,
+        assetMounts: loaded.assetDirs,
+        siteName: loaded.config.title,
+    };
+}
+/**
+ * Say what was lost. Unmapped components are COUNTED AND NAMED rather than
+ * summarized — the format-starlight lesson: a component nested inside a mapped
+ * container is not dropped, its tag leaks into the page as text, and only a
+ * per-tag count makes that visible.
+ */
+function reportSummary(warnings, failed, total, ledgerTotal, components, navSource) {
+    for (const w of warnings.slice(0, 20))
+        console.warn(`vitepress import: ${w}`);
+    if (warnings.length > 20) {
+        console.warn(`vitepress import: …and ${warnings.length - 20} more warnings`);
+    }
+    if (failed > 0) {
+        console.warn(`vitepress import: ${failed} of ${total} page(s) failed and were skipped`);
+    }
+    if (ledgerTotal > 0) {
+        console.warn(`vitepress import: ${ledgerTotal} construct(s) mapped with caveats (see per-page ledger)`);
+    }
+    const comps = Object.entries(components).sort((a, b) => b[1] - a[1]);
+    if (comps.length > 0) {
+        const listed = comps.slice(0, 10).map(([n, c]) => `${n}×${c}`).join(", ");
+        const more = comps.length > 10 ? `, …${comps.length - 10} more` : "";
+        console.warn(`vitepress import: Vue components removed — ${listed}${more}`);
+    }
+    console.warn(`vitepress import: nav built from the ${navSource}`);
+}
+export const plugin = {
+    name: "vitepress",
+    canImport: true,
+    canExport: false,
+    detectSource: (path) => detectVitepress(path),
+    importOptions: [
+        {
+            flags: "--eval-config",
+            description: "execute .vitepress/config.* instead of reading it statically (runs code from the source repo; needs its dependencies installed)",
+        },
+    ],
+    exportOptions: [],
+    async import(source, opts) {
+        const { pages, nav, srcDir, assetMounts } = await importVitepress(source, opts);
+        return { pages, nav, contentRoot: srcDir, assetMounts };
+    },
+};
+//# 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,49 @@
+/** A sidebar/nav entry as VitePress declares it. */
+export interface RawNavItem {
+    text?: string;
+    link?: string;
+    items?: RawNavItem[];
+    collapsed?: boolean;
+    /** `nav` entries use `activeMatch`; useful for pairing nav ↔ sidebar keys. */
+    activeMatch?: string;
+    /** `link` may be `{ text, link }` under a nav dropdown; kept for fidelity. */
+    [key: string]: unknown;
+}
+export type RawSidebar = RawNavItem[] | Record<string, RawNavItem[]>;
+export interface VitePressConfig {
+    title?: string;
+    description?: string;
+    base?: string;
+    srcDir?: string;
+    srcExclude?: string[];
+    rewrites?: Record<string, string>;
+    cleanUrls?: boolean;
+    sidebar?: RawSidebar;
+    nav?: RawNavItem[];
+    /** Locale keys other than `root`, so the loader can report what it skipped. */
+    locales?: string[];
+    /** Absolute path of the config file that was read. */
+    configPath: string;
+    /** Expressions the static reader could not evaluate. */
+    unresolved: string[];
+}
+/**
+ * Locate `.vitepress/config.*`.
+ *
+ * VitePress also permits `.vitepress/config/index.*` — the split-config layout
+ * used by larger sites (Element Plus, Vue's own docs).
+ */
+export declare function findConfigFile(vitepressDir: string): string | undefined;
+/** Read the config file statically (no execution). */
+export declare function readConfig(configPath: string): VitePressConfig;
+/**
+ * Read the config by IMPORTING it. Opt-in (`--eval-config`).
+ *
+ * SECURITY: this EXECUTES JavaScript/TypeScript from the source repository,
+ * and needs a loader that understands TS (`tsx`, or a `.mjs`/`.js` config).
+ * Acceptable for a local migration CLI pointed at a repo you already trust
+ * enough to `npm install`; not acceptable for untrusted input. All execution
+ * funnels through this one function so it can later be sandboxed.
+ */
+export declare function evalConfig(configPath: string): Promise<VitePressConfig>;
+//# 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":"AAaA,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;IACnB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAKD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYvE;AAqHD,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAc9D;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAQ7E"}

package/dist/config.js

@@ -0,0 +1,183 @@
+/**
+ * Read `.vitepress/config.*` into the typed slice this importer needs.
+ *
+ * STATICALLY, by default — see `literal.ts` for why. `--eval-config` swaps in
+ * a real `import()` for repos whose config outruns the literal subset AND
+ * whose dependencies are installed; that path executes code from the source
+ * repository and is therefore opt-in, never the default.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { evaluateModule, asArray, asObject, asString, UNRESOLVED } from "./literal.js";
+const CONFIG_BASENAMES = ["config"];
+const CONFIG_EXTS = [".ts", ".mts", ".mjs", ".js", ".cts", ".cjs"];
+/**
+ * Locate `.vitepress/config.*`.
+ *
+ * VitePress also permits `.vitepress/config/index.*` — the split-config layout
+ * used by larger sites (Element Plus, Vue's own docs).
+ */
+export function findConfigFile(vitepressDir) {
+    for (const base of CONFIG_BASENAMES) {
+        for (const ext of CONFIG_EXTS) {
+            const p = join(vitepressDir, base + ext);
+            if (existsSync(p))
+                return p;
+        }
+    }
+    for (const ext of CONFIG_EXTS) {
+        const p = join(vitepressDir, "config", "index" + ext);
+        if (existsSync(p))
+            return p;
+    }
+    return undefined;
+}
+/**
+ * VitePress merges `locales.root` over the top-level config, and each locale's
+ * `themeConfig` over the top-level `themeConfig`. Vitest puts its entire
+ * sidebar under `locales.root.themeConfig`, so reading only the top level
+ * would find no nav at all and silently fall back to a directory scan.
+ */
+function mergedThemeConfig(root) {
+    const theme = { ...(asObject(root.themeConfig) ?? {}) };
+    const locales = asObject(root.locales);
+    const localeKeys = locales ? Object.keys(locales) : [];
+    if (locales) {
+        const rootLocale = asObject(locales.root);
+        if (rootLocale) {
+            Object.assign(theme, asObject(rootLocale.themeConfig) ?? {});
+        }
+    }
+    return { theme, localeKeys };
+}
+/** Drop UNRESOLVED leaves so callers never see the sentinel. */
+function clean(v) {
+    if (v === UNRESOLVED)
+        return undefined;
+    if (Array.isArray(v)) {
+        const out = v.map(clean).filter((x) => x !== undefined);
+        return out;
+    }
+    const obj = asObject(v);
+    if (obj) {
+        const out = {};
+        for (const [k, val] of Object.entries(obj)) {
+            const c = clean(val);
+            if (c !== undefined)
+                out[k] = c;
+        }
+        return out;
+    }
+    return v;
+}
+function toRawItems(v) {
+    const arr = asArray(v);
+    if (!arr)
+        return undefined;
+    const cleaned = clean(arr);
+    return cleaned.filter((x) => x && typeof x === "object");
+}
+function toRawSidebar(v) {
+    const arr = asArray(v);
+    if (arr)
+        return toRawItems(v);
+    const obj = asObject(v);
+    if (!obj)
+        return undefined;
+    const out = {};
+    for (const [key, val] of Object.entries(obj)) {
+        // A path key may hold either the item array directly, or the
+        // `{ base, items }` form VitePress supports for prefixed sidebars.
+        const items = toRawItems(val);
+        if (items) {
+            out[key] = items;
+            continue;
+        }
+        const nested = asObject(val);
+        if (nested) {
+            const inner = toRawItems(nested.items);
+            if (inner) {
+                const base = asString(nested.base);
+                out[base ? base : key] = inner;
+            }
+        }
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function shapeConfig(root, configPath, unresolved) {
+    const { theme, localeKeys } = mergedThemeConfig(root);
+    const cfg = { configPath, unresolved };
+    const title = asString(root.title);
+    if (title)
+        cfg.title = title;
+    const description = asString(root.description);
+    if (description)
+        cfg.description = description;
+    const base = asString(root.base);
+    if (base)
+        cfg.base = base;
+    const srcDir = asString(root.srcDir);
+    if (srcDir)
+        cfg.srcDir = srcDir;
+    if (typeof root.cleanUrls === "boolean")
+        cfg.cleanUrls = root.cleanUrls;
+    const srcExclude = asArray(root.srcExclude);
+    if (srcExclude) {
+        cfg.srcExclude = srcExclude.filter((x) => typeof x === "string");
+    }
+    const rewrites = asObject(root.rewrites);
+    if (rewrites) {
+        const out = {};
+        for (const [k, v] of Object.entries(rewrites)) {
+            if (typeof v === "string")
+                out[k] = v;
+        }
+        if (Object.keys(out).length > 0)
+            cfg.rewrites = out;
+    }
+    const sidebar = toRawSidebar(theme.sidebar);
+    if (sidebar)
+        cfg.sidebar = sidebar;
+    const nav = toRawItems(theme.nav);
+    if (nav)
+        cfg.nav = nav;
+    if (localeKeys.length > 0)
+        cfg.locales = localeKeys;
+    return cfg;
+}
+/** Read the config file statically (no execution). */
+export function readConfig(configPath) {
+    const src = readFileSync(configPath, "utf-8");
+    const { value, unresolved } = evaluateModule(src);
+    const root = asObject(value);
+    if (!root) {
+        return {
+            configPath,
+            unresolved: [
+                ...unresolved,
+                "the config's default export could not be read as an object literal",
+            ],
+        };
+    }
+    return shapeConfig(root, configPath, unresolved);
+}
+/**
+ * Read the config by IMPORTING it. Opt-in (`--eval-config`).
+ *
+ * SECURITY: this EXECUTES JavaScript/TypeScript from the source repository,
+ * and needs a loader that understands TS (`tsx`, or a `.mjs`/`.js` config).
+ * Acceptable for a local migration CLI pointed at a repo you already trust
+ * enough to `npm install`; not acceptable for untrusted input. All execution
+ * funnels through this one function so it can later be sandboxed.
+ */
+export async function evalConfig(configPath) {
+    const mod = (await import(pathToFileURL(configPath).href));
+    const raw = (mod.default ?? mod);
+    const root = asObject(raw);
+    if (!root) {
+        throw new Error(`${configPath}: default export is not an object`);
+    }
+    return shapeConfig(root, configPath, []);
+}
+//# 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,18 @@
+/**
+ * @dogsbay/format-vitepress — VitePress format plugin.
+ *
+ * Imports a VitePress docs project into TreeNode[] by translating VitePress
+ * containers, code-fence conventions, snippets and includes to Dogsbay-MD,
+ * then parsing with the canonical dogsbay-md parser (zero new node types).
+ *
+ * Nav comes from `.vitepress/config.*`, read STATICALLY — see `literal.ts`.
+ *
+ * See plans/format-vitepress.md.
+ */
+export { parseVitepress, type ParseVitepressResult } from "./parse.js";
+export { vitepressToDogsbayMd, translateFenceInfo, splitRegion, type TranslateResult, type TranslateLedgerEntry, type TranslateOptions, type SnippetRequest, } from "./translate.js";
+export { findConfigFile, readConfig, evalConfig, type VitePressConfig, type RawNavItem, type RawSidebar, } from "./config.js";
+export { evaluateModule, UNRESOLVED, type EvalResult, type LiteralValue, } from "./literal.js";
+export { buildNav, itemsToNav, navFromSlugs, linkToSlug, slugToHref, type NavContext, } from "./nav.js";
+export { loadVitepress, detectVitepress, findVitepressDir, pathToSlug, globToRegExp, extractRegion, dedent, translateOptionsFor, titleFromSlug, type VitepressLoadResult, type VitepressPageSource, type VitepressLoadOptions, } from "./loaders/load.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;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,UAAU,EACV,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,UAAU,EACV,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,KAAK,UAAU,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @dogsbay/format-vitepress — VitePress format plugin.
+ *
+ * Imports a VitePress docs project into TreeNode[] by translating VitePress
+ * containers, code-fence conventions, snippets and includes to Dogsbay-MD,
+ * then parsing with the canonical dogsbay-md parser (zero new node types).
+ *
+ * Nav comes from `.vitepress/config.*`, read STATICALLY — see `literal.ts`.
+ *
+ * See plans/format-vitepress.md.
+ */
+export { parseVitepress } from "./parse.js";
+export { vitepressToDogsbayMd, translateFenceInfo, splitRegion, } from "./translate.js";
+export { findConfigFile, readConfig, evalConfig, } from "./config.js";
+export { evaluateModule, UNRESOLVED, } from "./literal.js";
+export { buildNav, itemsToNav, navFromSlugs, linkToSlug, slugToHref, } from "./nav.js";
+export { loadVitepress, detectVitepress, findVitepressDir, pathToSlug, globToRegExp, extractRegion, dedent, translateOptionsFor, titleFromSlug, } from "./loaders/load.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;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAA6B,MAAM,YAAY,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,GAKZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,UAAU,EACV,UAAU,GAIX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,UAAU,GAGX,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,GAEX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,aAAa,GAId,MAAM,mBAAmB,CAAC"}

package/dist/literal.d.ts

@@ -0,0 +1,55 @@
+/**
+ * A tolerant, execution-free evaluator for the literal subset of a
+ * TypeScript/JavaScript module.
+ *
+ * Why this exists: VitePress keeps the sidebar INSIDE `.vitepress/config.ts`,
+ * so — unlike Docusaurus, whose sidebars live in their own data module — we
+ * cannot punt nav extraction to a separate file. And a real VitePress config
+ * imports theme packages, Shiki transformers and Vite plugins, so *executing*
+ * it needs the source repo's `node_modules` installed and runs arbitrary code
+ * from that repo. (See `format-docusaurus/src/config.ts` for the same call.)
+ *
+ * So we read it instead. This module understands:
+ *
+ *   - object / array / string / number / boolean / null literals
+ *   - template literals with no `${}` interpolation
+ *   - `...spread` of anything else this module can evaluate
+ *   - module-level `const X = <literal>` identifier references
+ *   - zero-arg calls to module-level `function f() { return <literal> }` and
+ *     `const f = () => <literal>` (hono's `sidebar: { '/': sidebars() }`)
+ *   - wrapper calls with a single literal argument (`defineConfig({…})`)
+ *   - member access into an already-evaluated object (`shared.themeConfig`)
+ *   - TS noise: type annotations, `as const`, `as T`, `satisfies T`, generics
+ *
+ * Anything else evaluates to the `UNRESOLVED` sentinel — never to a plausible
+ * wrong value and never to a silent omission. Callers report what they could
+ * not read (`EvalResult.unresolved`), because a sidebar that quietly lost a
+ * section looks exactly like a sidebar that never had one.
+ *
+ * The parser never desyncs: an expression it does not understand is skipped
+ * by balancing delimiters, so the surrounding object continues to parse.
+ */
+/** Sentinel for an expression this evaluator cannot read. */
+export declare const UNRESOLVED: unique symbol;
+export type LiteralValue = string | number | boolean | null | typeof UNRESOLVED | LiteralValue[] | {
+    [key: string]: LiteralValue;
+};
+export interface EvalResult {
+    /** The module's default export, evaluated as far as possible. */
+    value: LiteralValue;
+    /** Human-readable descriptions of expressions that could not be read. */
+    unresolved: string[];
+}
+/**
+ * Evaluate a module's default export as far as the literal subset allows.
+ *
+ * Falls back to the binding named by `fallbackExport` (default `config`) when
+ * there is no `export default`, which covers
+ * `const config = { … }; export { config }`.
+ */
+export declare function evaluateModule(source: string, fallbackExport?: string): EvalResult;
+/** Narrowing helper: a plain object with no UNRESOLVED identity. */
+export declare function asObject(v: LiteralValue): Record<string, LiteralValue> | undefined;
+export declare function asArray(v: LiteralValue): LiteralValue[] | undefined;
+export declare function asString(v: LiteralValue): string | undefined;
+//# sourceMappingURL=literal.d.ts.map

package/dist/literal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"literal.d.ts","sourceRoot":"","sources":["../src/literal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,UAAU,eAAiC,CAAC;AAEzD,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,OAAO,UAAU,GACjB,YAAY,EAAE,GACd;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,KAAK,EAAE,YAAY,CAAC;IACpB,yEAAyE;IACzE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAuxBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,SAAW,GAAG,UAAU,CAQpF;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAKlF;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,GAAG,SAAS,CAEnE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAE5D"}