@dogsbay/format-gatsby 0.2.0-beta.101

package/dist/adapter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Gatsby site adapter — the extension point for what a specific Gatsby
+ * docs site invented on top of standard Gatsby MDX.
+ *
+ * The generic importer (cli.ts) handles the Gatsby-shape concerns: the
+ * `title != ""` page/partial split, `_snippets` transclusion, path→slug,
+ * and MDX parsing via `@dogsbay/format-mdx`. Anything site-specific — the
+ * custom component surface (PostHog's `<ProductScreenshot>`), and the nav
+ * (PostHog's hand-written `src/navs/index.js` module) — lives in a
+ * per-site adapter, injected by name (like the Docusaurus/Tigera split).
+ *
+ *   convert ../posthog.com/contents/docs --from gatsby --adapter posthog
+ */
+import type { MdxAdapter, NavItem } from "@dogsbay/format-mdx";
+export interface GatsbyNavContext {
+    /** The docs source directory `convert` was pointed at. */
+    sourceDir: string;
+    /** Prefix for emitted hrefs (the target site's mount, e.g. "/docs"). */
+    hrefPrefix: string;
+}
+export interface GatsbyAdapter {
+    /** Adapter name (e.g. "posthog"). */
+    name: string;
+    /**
+     * The MDX adapter merged into the parser: component mappings,
+     * self-closing tags, inline transforms, preprocess. This is where a
+     * site's `<ProductScreenshot>`/`<CalloutBox>`/… become directives (or
+     * are stripped + ledgered).
+     */
+    mdx?: MdxAdapter;
+    /**
+     * The site's hardcoded mount prefix in internal links (e.g. "/docs").
+     * Links starting with it are rewritten root-relative so they resolve
+     * on the migrated site (which serves at its own root). Same prefix the
+     * nav extractor strips.
+     */
+    linkBase?: string;
+    /**
+     * Origin URL for links that point outside the migrated docs (e.g.
+     * "https://posthog.com"). A docs source links to sibling pages of the
+     * wider site (`/pricing`, `/blog/x`) that aren't migrated; left
+     * root-relative they 404. Any root-relative link whose target is not a
+     * migrated page or synthesized landing is rewritten to
+     * `externalBase + href`. Omit to leave unresolved links as-is.
+     */
+    externalBase?: string;
+    /**
+     * Extract the site's nav from its own nav module (e.g. PostHog's
+     * `src/navs/index.js`) → NavItem[]. Return null to fall back to the
+     * generic directory + frontmatter nav. This is the adapter's headline
+     * job for a hand-maintained-nav site.
+     */
+    extractNav?: (ctx: GatsbyNavContext) => NavItem[] | null;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,OAAO,EAAE,GAAG,IAAI,CAAC;CAC1D"}

package/dist/adapter.js

@@ -0,0 +1,15 @@
+/**
+ * Gatsby site adapter — the extension point for what a specific Gatsby
+ * docs site invented on top of standard Gatsby MDX.
+ *
+ * The generic importer (cli.ts) handles the Gatsby-shape concerns: the
+ * `title != ""` page/partial split, `_snippets` transclusion, path→slug,
+ * and MDX parsing via `@dogsbay/format-mdx`. Anything site-specific — the
+ * custom component surface (PostHog's `<ProductScreenshot>`), and the nav
+ * (PostHog's hand-written `src/navs/index.js` module) — lives in a
+ * per-site adapter, injected by name (like the Docusaurus/Tigera split).
+ *
+ *   convert ../posthog.com/contents/docs --from gatsby --adapter posthog
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import type { FormatPlugin } from "@dogsbay/types";
+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":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AAoTxE,eAAO,MAAM,MAAM,EAAE,YAYpB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,266 @@
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { isAbsolute, join, relative } from "node:path";
+import YAML from "yaml";
+import { parseMeta } from "@dogsbay/types";
+import { parseMdx, extractHeadings, compileComponentConfig, makeExtractMapping, MDX_BUILTIN_HANDLERS, } from "@dogsbay/format-mdx";
+import { transcludeSnippets } from "./transclude.js";
+import { normalizeInternalLinks, rewriteUnresolvedLinks } from "./links.js";
+/** Directories whose files are partials/assets, never pages. */
+const PARTIAL_DIRS = new Set(["_snippets", "_includes", "_media", "_posts"]);
+/**
+ * Detect a Gatsby docs source: a `gatsby-config.*` at the root, or a
+ * directory of `.mdx` content (the `contents/docs` case pointed at
+ * directly with `--from gatsby`).
+ */
+function detectGatsby(path) {
+    try {
+        const entries = readdirSync(path);
+        if (entries.some((e) => /^gatsby-config\.(js|ts|mjs|cjs)$/.test(e)))
+            return true;
+        // A contents dir with mdx + a _snippets sibling anywhere is Gatsby-shaped.
+        const hasMdx = entries.some((e) => e.endsWith(".mdx"));
+        const hasSnippets = entries.includes("_snippets");
+        return hasMdx && hasSnippets;
+    }
+    catch {
+        return false;
+    }
+}
+const FRONTMATTER_RE = /^?---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+function extractFrontmatter(source) {
+    const match = FRONTMATTER_RE.exec(source);
+    if (!match || match[1].trim().length === 0)
+        return undefined;
+    try {
+        const parsed = YAML.parse(match[1]);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function walkDocFiles(dir, root) {
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        const st = statSync(full);
+        if (st.isDirectory()) {
+            out.push(...walkDocFiles(full, root));
+        }
+        else if (/\.(md|mdx)$/.test(entry) && entry !== "llms.txt") {
+            const rel = relative(root, full).replace(/\\/g, "/");
+            const slug = rel.replace(/\.(md|mdx)$/, "");
+            const isPartial = entry.startsWith("_") ||
+                rel.split("/").some((seg) => PARTIAL_DIRS.has(seg));
+            out.push({ filePath: full, slug, isPartial });
+        }
+    }
+    return out;
+}
+/** Build a nested nav from page slugs when no adapter nav is available. */
+function directoryNav(pages, hrefPrefix) {
+    const root = [];
+    const groups = new Map();
+    const pref = hrefPrefix.replace(/\/$/, "");
+    for (const p of [...pages].sort((a, b) => a.slug.localeCompare(b.slug))) {
+        const segs = p.slug.split("/");
+        const item = { label: p.title || segs[segs.length - 1], href: `${pref}/${p.slug}` };
+        if (segs.length === 1) {
+            root.push(item);
+            continue;
+        }
+        const top = segs[0];
+        let group = groups.get(top);
+        if (!group) {
+            group = { label: top.replace(/[-_]/g, " "), children: [] };
+            groups.set(top, group);
+            root.push(group);
+        }
+        (group.children ??= []).push(item);
+    }
+    return root;
+}
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/**
+ * The path a page slug is actually served at: an `x/index` page serves
+ * at `/x`, a top-level `index` at `/`. Link targets and section-root
+ * existence checks compare against this, not the raw file slug.
+ */
+function servedSlug(slug) {
+    if (slug === "index")
+        return "";
+    if (slug.endsWith("/index"))
+        return slug.slice(0, -"/index".length);
+    return slug;
+}
+/** Slug (relative to the docs root) for a nav href, stripping the mount prefix. */
+function slugFromHref(href, pref) {
+    let h = href.replace(/[#?].*$/, "").replace(/\/+$/, "");
+    if (pref && h.startsWith(`${pref}/`))
+        h = h.slice(pref.length);
+    else if (pref && h === pref)
+        h = "";
+    return h.replace(/^\/+/, "");
+}
+/**
+ * Synthesize landing pages for nav "section roots" that have no page of
+ * their own. A Gatsby docs site often renders a product landing (e.g.
+ * `/docs/error-tracking`) from a template with NO backing `index.mdx`;
+ * after migration that URL — and every prose link to it — 404s, and it's
+ * usually a top-level sidebar target. For each nav item that has both an
+ * href and children but no migrated page, and whose slug is a real
+ * section root (a prefix of existing page slugs), emit an index page
+ * listing its child links. Fixes the sidebar clicks and the prose links
+ * together, generically (no per-site config).
+ */
+function synthesizeNavLandings(pageSlugs, nav, hrefPrefix, taxonomyNames) {
+    const pref = hrefPrefix.replace(/\/$/, "");
+    // Existence is by served path — a nav root already covered by an
+    // `x/index` page must not get a second, colliding landing.
+    const served = new Set(pageSlugs.map(servedSlug));
+    const isSectionRoot = (slug) => !!slug && pageSlugs.some((s) => s.startsWith(`${slug}/`));
+    const out = [];
+    const made = new Set();
+    const walk = (items) => {
+        for (const it of items) {
+            const kids = it.children ?? [];
+            if (it.href && kids.length) {
+                const slug = slugFromHref(it.href, pref);
+                if (slug && !served.has(slug) && !made.has(slug) && isSectionRoot(slug)) {
+                    made.add(slug);
+                    const lis = kids
+                        .filter((c) => c.href)
+                        .map((c) => `<li><a href="${c.href}">${escapeHtml(c.label)}</a></li>`)
+                        .join("");
+                    const title = it.label || slug.split("/").pop() || slug;
+                    const frontmatter = { title };
+                    out.push({
+                        slug,
+                        title,
+                        // `type: "html"` (not `{type:"paragraph", html}`) — the
+                        // canonical serializers read raw markup off an html node in
+                        // BOTH the direct tree→astro path and the dogsbay-md
+                        // round-trip; a paragraph's `.html` is only honored on the
+                        // latter, so it would render empty via `convert --to astro`.
+                        tree: [
+                            { type: "html", html: `<p>Pages in this section:</p>` },
+                            { type: "html", html: `<ul>${lis}</ul>` },
+                        ],
+                        headings: [],
+                        frontmatter,
+                        meta: parseMeta(frontmatter, { slug, taxonomyNames }),
+                    });
+                }
+            }
+            if (kids.length)
+                walk(kids);
+        }
+    };
+    walk(nav);
+    return out;
+}
+async function importGatsby(source, opts) {
+    const adapter = opts.adapterInstance;
+    const hrefPrefix = typeof opts.hrefPrefix === "string" ? opts.hrefPrefix : "";
+    const parseOpts = {};
+    const mdxAdapter = adapter?.mdx;
+    if (mdxAdapter)
+        parseOpts.adapter = mdxAdapter;
+    if (opts.componentsConfig) {
+        const compiled = compileComponentConfig(opts.componentsConfig, MDX_BUILTIN_HANDLERS, (spec) => makeExtractMapping(spec, (f) => (isAbsolute(f) ? f : join(source, f))));
+        parseOpts.components = compiled.components;
+        parseOpts.selfClosingTags = compiled.selfClosingTags;
+    }
+    const files = walkDocFiles(source, source);
+    const pages = [];
+    const ledger = [];
+    let skippedPartials = 0;
+    const taxonomyNames = Array.isArray(opts.taxonomyNames)
+        ? opts.taxonomyNames
+        : undefined;
+    const sources = [];
+    for (const { filePath, slug, isPartial } of files) {
+        if (isPartial)
+            continue; // partials are transcluded, never pages
+        const raw = readFileSync(filePath, "utf-8");
+        const frontmatter = extractFrontmatter(raw);
+        const title = typeof frontmatter?.title === "string" ? frontmatter.title : "";
+        // Gatsby's page rule: allMdx filtered to title != "". No title → partial.
+        if (title.trim() === "") {
+            skippedPartials++;
+            continue;
+        }
+        // Resolve _snippets transclusion, then normalize the site's internal
+        // link prefix (e.g. "/docs/x" → "/x").
+        let text = transcludeSnippets(raw, filePath);
+        if (adapter?.linkBase)
+            text = normalizeInternalLinks(text, adapter.linkBase, hrefPrefix);
+        sources.push({ filePath, slug, title, frontmatter, text });
+    }
+    const pageSlugs = sources.map((s) => s.slug);
+    // Nav: adapter extractor (e.g. posthog navs/index.js) → directory fallback.
+    let nav = null;
+    if (adapter?.extractNav) {
+        try {
+            nav = adapter.extractNav({ sourceDir: source, hrefPrefix });
+        }
+        catch {
+            nav = null;
+        }
+    }
+    if (!nav || nav.length === 0)
+        nav = directoryNav(sources, hrefPrefix);
+    // Landing pages for nav section-roots with no backing file, so sidebar
+    // clicks and prose links to them resolve instead of 404ing.
+    const landings = synthesizeNavLandings(pageSlugs, nav, hrefPrefix, taxonomyNames);
+    // Everything the migrated site can serve — used to decide which
+    // root-relative links are off-docs and belong on the origin site. Both
+    // the raw file slug and its served path count (`/x` and `/x/index`).
+    const resolvable = new Set([
+        ...pageSlugs,
+        ...pageSlugs.map(servedSlug),
+        ...landings.map((l) => l.slug),
+    ]);
+    const isResolvable = (slug) => resolvable.has(slug);
+    // Phase 2 — rewrite off-docs links to the origin, then parse.
+    for (const { filePath, slug, title, frontmatter, text: text0 } of sources) {
+        const text = adapter?.externalBase
+            ? rewriteUnresolvedLinks(text0, isResolvable, adapter.externalBase, hrefPrefix)
+            : text0;
+        const result = parseMdx(text, { ...parseOpts, file: relative(source, filePath) });
+        ledger.push(...result.ledger);
+        const headings = extractHeadings(result.tree);
+        const meta = parseMeta(frontmatter, { slug, taxonomyNames });
+        pages.push({ slug, title, tree: result.tree, headings, frontmatter, meta });
+    }
+    if (landings.length)
+        pages.push(...landings);
+    opts.importLedger = ledger;
+    if (opts.report) {
+        console.log(`\nGatsby import: ${pages.length} pages (${landings.length} synthesized landings), ` +
+            `${skippedPartials} partials skipped, ${ledger.length} ledger entries.`);
+    }
+    return { pages, nav };
+}
+export const plugin = {
+    name: "gatsby",
+    canImport: true,
+    canExport: false,
+    detectSource: detectGatsby,
+    importOptions: [
+        { flags: "--adapter <name>", description: "Gatsby site adapter (e.g. posthog)" },
+        { flags: "--components <path>", description: "YAML/JSON declarative component mappings" },
+        { flags: "--report", description: "Print the import summary + fidelity ledger" },
+    ],
+    exportOptions: [],
+    import: importGatsby,
+};
+//# 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/index.d.ts

@@ -0,0 +1,6 @@
+export type { GatsbyAdapter, GatsbyNavContext } from "./adapter.js";
+export { transcludeSnippets } from "./transclude.js";
+export { normalizeInternalLinks, rewriteUnresolvedLinks } from "./links.js";
+export { plugin } from "./cli.js";
+export type { MdxAdapter, ComponentMapping, NavItem, TreeNode } from "@dogsbay/format-mdx";
+//# 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,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { transcludeSnippets } from "./transclude.js";
+export { normalizeInternalLinks, rewriteUnresolvedLinks } from "./links.js";
+export { 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":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/links.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Internal-link normalization. A Gatsby docs site hardcodes its mount
+ * prefix into every internal link (`href="/docs/error-tracking"`,
+ * `[x](/docs/session-replay)`). The migrated site serves content at its
+ * own root (slugs relative to the docs dir), so that prefix must be
+ * stripped or every link 404s. Mirrors the nav extractor's `/docs`
+ * stripping.
+ *
+ * Fence-safe: only prose is rewritten, never fenced code (a code example
+ * containing `/docs/…` is left intact). Rewrites only inside link
+ * contexts (`](…)` and `href="…"`), so bare prose mentions are untouched.
+ */
+/**
+ * Rewrite internal links that start with `base` (e.g. "/docs") to be
+ * root-relative under `hrefPrefix` (default root). `/docs/x` → `/x`,
+ * `/docs` → `/`, `/docs/x#a` → `/x#a`.
+ */
+export declare function normalizeInternalLinks(source: string, base: string, hrefPrefix?: string): string;
+/**
+ * Rewrite root-relative links whose target is NOT a migrated page to an
+ * absolute URL under `externalBase` (the origin site). A docs source
+ * links to sibling pages of the wider site (`/pricing`, `/blog/x`,
+ * `/talk-to-a-human`) that live on the origin, not in the migrated docs;
+ * left as `/pricing` they 404. `isResolvable(slug)` reports whether a
+ * slug maps to a migrated page or synthesized landing.
+ *
+ * Only root-relative link targets are candidates. Anchors (`#x`),
+ * protocol-relative (`//host`), already-absolute (`https://…`),
+ * `mailto:`, and image links (`![](…)`) are left untouched. Fence-safe.
+ */
+export declare function rewriteUnresolvedLinks(source: string, isResolvable: (slug: string) => boolean, externalBase: string, hrefPrefix?: string): string;
+//# sourceMappingURL=links.d.ts.map

package/dist/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../src/links.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,UAAU,SAAK,GACd,MAAM,CAeR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACvC,YAAY,EAAE,MAAM,EACpB,UAAU,SAAK,GACd,MAAM,CAiCR"}

package/dist/links.js

@@ -0,0 +1,88 @@
+/**
+ * Internal-link normalization. A Gatsby docs site hardcodes its mount
+ * prefix into every internal link (`href="/docs/error-tracking"`,
+ * `[x](/docs/session-replay)`). The migrated site serves content at its
+ * own root (slugs relative to the docs dir), so that prefix must be
+ * stripped or every link 404s. Mirrors the nav extractor's `/docs`
+ * stripping.
+ *
+ * Fence-safe: only prose is rewritten, never fenced code (a code example
+ * containing `/docs/…` is left intact). Rewrites only inside link
+ * contexts (`](…)` and `href="…"`), so bare prose mentions are untouched.
+ */
+/** Escape a string for use in a RegExp. */
+function esc(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Apply `fn` to prose only, leaving code untouched — both fenced blocks
+ * (```` ``` ````/`~~~`) and inline spans (single backticks). A code
+ * sample that literally shows link/anchor syntax (`` `[x](/docs/y)` ``)
+ * must not be rewritten. Fenced alternatives come first so a fenced
+ * block's inner backticks can't be mistaken for an inline span.
+ */
+function rewriteProse(source, fn) {
+    const parts = source.split(/(```[\s\S]*?```|~~~[\s\S]*?~~~|`[^`\n]+`)/g);
+    for (let i = 0; i < parts.length; i += 2)
+        parts[i] = fn(parts[i]);
+    return parts.join("");
+}
+/**
+ * Rewrite internal links that start with `base` (e.g. "/docs") to be
+ * root-relative under `hrefPrefix` (default root). `/docs/x` → `/x`,
+ * `/docs` → `/`, `/docs/x#a` → `/x#a`.
+ */
+export function normalizeInternalLinks(source, base, hrefPrefix = "") {
+    if (!base)
+        return source;
+    const b = esc(base.replace(/\/$/, ""));
+    const pref = hrefPrefix.replace(/\/$/, "");
+    // Anchor: after a markdown link `](` or an `href="`/`href='`.
+    const anchor = `(\\]\\(|href=["'])`;
+    const withSlash = new RegExp(`${anchor}${b}/`, "g"); // /docs/x → <pref>/x
+    const bare = new RegExp(`${anchor}${b}(?=[)"'#?\\s])`, "g"); // /docs → <pref>/
+    const rewrite = (text) => text
+        .replace(withSlash, `$1${pref}/`)
+        .replace(bare, `$1${pref}/`);
+    return rewriteProse(source, rewrite);
+}
+/**
+ * Rewrite root-relative links whose target is NOT a migrated page to an
+ * absolute URL under `externalBase` (the origin site). A docs source
+ * links to sibling pages of the wider site (`/pricing`, `/blog/x`,
+ * `/talk-to-a-human`) that live on the origin, not in the migrated docs;
+ * left as `/pricing` they 404. `isResolvable(slug)` reports whether a
+ * slug maps to a migrated page or synthesized landing.
+ *
+ * Only root-relative link targets are candidates. Anchors (`#x`),
+ * protocol-relative (`//host`), already-absolute (`https://…`),
+ * `mailto:`, and image links (`![](…)`) are left untouched. Fence-safe.
+ */
+export function rewriteUnresolvedLinks(source, isResolvable, externalBase, hrefPrefix = "") {
+    if (!externalBase)
+        return source;
+    const base = externalBase.replace(/\/$/, "");
+    const pref = hrefPrefix.replace(/\/$/, "");
+    /** Slug for a root-relative href, or null if not a rewrite candidate. */
+    const toSlug = (href) => {
+        if (!href.startsWith("/") || href.startsWith("//"))
+            return null;
+        let p = href.replace(/[#?].*$/, "").replace(/\/+$/, "");
+        if (pref && (p === pref || p.startsWith(`${pref}/`)))
+            p = p.slice(pref.length);
+        return p.replace(/^\/+/, "");
+    };
+    const rewriteHref = (href) => {
+        const slug = toSlug(href);
+        if (slug === null || slug === "")
+            return href; // not a candidate / site root
+        return isResolvable(slug) ? href : base + href; // off-docs → origin URL
+    };
+    const rewrite = (text) => text
+        // HTML anchors: href="/x" / href='/x' (path may carry #anchor/?query)
+        .replace(/href=("|')(\/[^"']*)\1/g, (_m, q, href) => `href=${q}${rewriteHref(href)}${q}`)
+        // Markdown links [text](/x) or [text](/x "title"); skip images (`!`).
+        .replace(/(!?)\[([^\]]*)\]\((\/[^)\s]*)(\s+"[^"]*")?\)/g, (m, bang, txt, href, title) => bang ? m : `[${txt}](${rewriteHref(href)}${title ?? ""})`);
+    return rewriteProse(source, rewrite);
+}
+//# sourceMappingURL=links.js.map

package/dist/links.js.map

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

package/dist/transclude.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `_snippets` transclusion — the Gatsby MDX pattern PostHog uses on 57%
+ * of files: `import X from './_snippets/x.mdx'` at the top, then `<X/>`
+ * in the body. Gatsby renders the imported component (the partial's MDX)
+ * at that site; without resolution the import is stripped and the
+ * `<X/>` renders empty, silently dropping content.
+ *
+ * This runs BEFORE the MDX parse: it resolves each local `.md/.mdx`
+ * default import, reads + frontmatter-strips + (recursively) transcludes
+ * the partial, and substitutes its body at every `<X/>` / `<X ... />`
+ * usage. Non-`.md(x)` imports (real components) are left for the
+ * component adapter. Cycle-guarded.
+ */
+/**
+ * Inline local `.md(x)` default imports at their `<Ident/>` usage sites.
+ * `filePath` is the absolute path of the file being processed (imports
+ * resolve relative to its directory). `seen` guards cycles.
+ */
+export declare function transcludeSnippets(source: string, filePath: string, seen?: Set<string>): string;
+//# sourceMappingURL=transclude.d.ts.map

package/dist/transclude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transclude.d.ts","sourceRoot":"","sources":["../src/transclude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA8BH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC5B,MAAM,CAiDR"}

package/dist/transclude.js

@@ -0,0 +1,89 @@
+/**
+ * `_snippets` transclusion — the Gatsby MDX pattern PostHog uses on 57%
+ * of files: `import X from './_snippets/x.mdx'` at the top, then `<X/>`
+ * in the body. Gatsby renders the imported component (the partial's MDX)
+ * at that site; without resolution the import is stripped and the
+ * `<X/>` renders empty, silently dropping content.
+ *
+ * This runs BEFORE the MDX parse: it resolves each local `.md/.mdx`
+ * default import, reads + frontmatter-strips + (recursively) transcludes
+ * the partial, and substitutes its body at every `<X/>` / `<X ... />`
+ * usage. Non-`.md(x)` imports (real components) are left for the
+ * component adapter. Cycle-guarded.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+const FRONTMATTER_RE = /^?---\r?\n[\s\S]*?\r?\n---\r?\n/;
+/**
+ * A FRESH regex per call — `transcludeSnippets` recurses, and a shared
+ * `/g` regex's `lastIndex` would be corrupted by inner calls (infinite
+ * loop). Never hoist this to module scope.
+ */
+function importRe() {
+    return /^\s*import\s+([A-Za-z_$][\w$]*)\s+from\s+["']([^"']+)["']\s*;?\s*$/gm;
+}
+function stripFrontmatter(src) {
+    return src.replace(FRONTMATTER_RE, "");
+}
+/** Resolve an import specifier to a partial file path, or null. */
+function resolvePartial(spec, fromDir) {
+    if (!spec.startsWith(".") && !spec.startsWith("/"))
+        return null; // bare pkg / @site alias → not a local partial
+    const base = resolve(fromDir, spec);
+    const candidates = /\.(md|mdx)$/.test(spec)
+        ? [base]
+        : [`${base}.mdx`, `${base}.md`, resolve(base, "index.mdx"), resolve(base, "index.md")];
+    return candidates.find((c) => existsSync(c)) ?? null;
+}
+/**
+ * Inline local `.md(x)` default imports at their `<Ident/>` usage sites.
+ * `filePath` is the absolute path of the file being processed (imports
+ * resolve relative to its directory). `seen` guards cycles.
+ */
+export function transcludeSnippets(source, filePath, seen = new Set()) {
+    const fromDir = dirname(filePath);
+    const inlines = new Map(); // Ident → resolved body
+    // Pass 1: collect + strip local .md(x) imports; leave others in place.
+    const kept = [];
+    const re = importRe();
+    let lastIndex = 0;
+    let m;
+    const drops = [];
+    while ((m = re.exec(source)) !== null) {
+        const [full, ident, spec] = m;
+        const partial = resolvePartial(spec, fromDir);
+        if (!partial)
+            continue; // real component import — keep for the adapter
+        drops.push([m.index, m.index + full.length]);
+        if (seen.has(partial)) {
+            inlines.set(ident, ""); // cycle — drop
+            continue;
+        }
+        const raw = stripFrontmatter(readFileSync(partial, "utf-8"));
+        const next = new Set(seen);
+        next.add(partial);
+        inlines.set(ident, transcludeSnippets(raw, partial, next).trim());
+    }
+    // Remove the collected import lines.
+    if (drops.length) {
+        drops.sort((a, b) => a[0] - b[0]);
+        for (const [s, e] of drops) {
+            kept.push(source.slice(lastIndex, s));
+            lastIndex = e;
+        }
+        kept.push(source.slice(lastIndex));
+        source = kept.join("");
+    }
+    if (inlines.size === 0)
+        return source;
+    // Pass 2: substitute <Ident/> and <Ident …/> (block usage) with the body.
+    for (const [ident, body] of inlines) {
+        const usage = new RegExp(`<${ident}(\\s[^>]*?)?\\s*/>`, "g");
+        source = source.replace(usage, () => `\n\n${body}\n\n`);
+        // Also handle paired <Ident>…</Ident> (rare) → body + inner dropped.
+        const paired = new RegExp(`<${ident}(\\s[^>]*?)?>[\\s\\S]*?</${ident}>`, "g");
+        source = source.replace(paired, () => `\n\n${body}\n\n`);
+    }
+    return source;
+}
+//# sourceMappingURL=transclude.js.map

package/dist/transclude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transclude.js","sourceRoot":"","sources":["../src/transclude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAE1D;;;;GAIG;AACH,SAAS,QAAQ;IACf,OAAO,sEAAsE,CAAC;AAChF,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,mEAAmE;AACnE,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACnD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,+CAA+C;IAChH,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,CAAC,CAAC,CAAC,IAAI,CAAC;QACR,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IACzF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,QAAgB,EAChB,OAAoB,IAAI,GAAG,EAAE;IAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,wBAAwB;IAEnE,uEAAuE;IACvE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,CAAyB,CAAC;IAC9B,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO;YAAE,SAAS,CAAC,+CAA+C;QACvE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe;YACvC,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,qCAAqC;IACrC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;YACtC,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACnC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAEtC,0EAA0E;IAC1E,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,MAAM,CACtB,IAAI,KAAK,oBAAoB,EAC7B,GAAG,CACJ,CAAC;QACF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;QACxD,qEAAqE;QACrE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,4BAA4B,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;QAC9E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@dogsbay/format-gatsby",
+  "version": "0.2.0-beta.101",
+  "description": "GatsbyJS docs importer for Dogsbay — a Gatsby shell over @dogsbay/format-mdx: page-walk (title!=\"\"), _snippets transclusion, and injected site adapters (nav + components).",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "yaml": "^2.9.0",
+    "@dogsbay/format-mdx": "0.2.0-beta.101",
+    "@dogsbay/types": "0.2.0-beta.101"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10",
+    "@dogsbay/format-astro": "0.2.0-beta.101"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}