dogsbay 0.2.0-beta.130 → 0.2.0-beta.131

package/dist/commands/migrate-gitbook.js

@@ -2,33 +2,24 @@
  * `dogsbay migrate-gitbook <source>` — one-way migrate a GitBook Git Sync
  * corpus to a scaffolded Dogsbay-MD project.
  *
- * Pipeline:
- *   1. importGitbook (format-gitbook plugin): detect the corpus, read
- *      `.gitbook.yaml` + `SUMMARY.md`, translate every page's Git Sync
- *      markdown to Dogsbay-MD, and return pages + nav + redirects +
- *      detected spaces.
- *   2. Write each page to `content/<slug>.md` (source frontmatter + a
- *      title, then the translated body). Fragments (`.gitbook/includes/*`)
- *      are written without frontmatter as `{% include %}` targets.
- *   3. Mirror non-`.md` assets (`.gitbook/assets/**`, images) into
- *      `content/` at matching relative paths so the translated relative
- *      image refs resolve.
- *   4. Write `content/nav.yml` (from SUMMARY), `dogsbay.config.yml`,
- *      scaffold the Astro project, carry `.gitbook.yaml` redirects into
- *      `public/_redirects`, and write `MIGRATION.md`.
+ * The migration itself is format-gitbook's: `importGitbook` (the folder as a
+ * corpus → pages, nav, redirects, ledger) and `gitbookProject` (→ the
+ * project's files, the assets to copy, the redirects). The playground runs
+ * the same two over a map of files (`@dogsbay/format-gitbook/migrate`), so a
+ * migration there is the one this command does. What stays here is the disk:
+ *   1. write the project's files (content/*.md, content/nav.yml,
+ *      dogsbay.config.yml, MIGRATION.md) and copy the assets;
+ *   2. `.gitbook.yaml` redirects → astro/public/_redirects;
+ *   3. scaffold the Astro project, and the console output.
  *
  * Source-of-truth becomes `./content/*.md`; the GitBook source can be
  * deleted. Mirrors migrate-asciidoc / migrate-mkdocs in shape.
  */
-import { copyFileSync, existsSync, mkdirSync, readdirSync, rmSync, realpathSync, statSync, writeFileSync, } from "node:fs";
+import { copyFileSync, existsSync, mkdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import pc from "picocolors";
-import { stringify as stringifyYaml } from "yaml";
 import { emitSiteScaffold } from "@dogsbay/format-astro";
-import { importGitbook } from "@dogsbay/format-gitbook/cli";
-function yamlQuote(s) {
-    return /[:#&*!|>%@`,'"[\]{}]|^\s|\s$/.test(s) ? JSON.stringify(s) : s;
-}
+import { gitbookProject, importGitbook } from "@dogsbay/format-gitbook/cli";
 function prettify(slug) {
     return slug
         .split(/[-_/]/)
@@ -36,147 +27,6 @@ function prettify(slug) {
         .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
         .join(" ");
 }
-/** Serialize NavItem[] to nav.yml (mirrors migrate-asciidoc's navToYaml). */
-function navToYaml(items, indent = 0) {
-    const pad = "  ".repeat(indent);
-    const lines = [];
-    for (const item of items) {
-        const hasChildren = item.children !== undefined && item.children.length > 0;
-        const target = item.href === undefined
-            ? undefined
-            : /^(?:https?:\/\/|mailto:|tel:)/i.test(item.href) || item.href.includes("#")
-                ? item.href
-                : `${item.href.replace(/^\/+/, "")}.md`;
-        if (target !== undefined && !hasChildren) {
-            lines.push(`${pad}- ${yamlQuote(item.label)}: ${target}`);
-        }
-        else {
-            lines.push(`${pad}- ${yamlQuote(item.label)}:`);
-            if (target !== undefined)
-                lines.push(`${pad}    - ${yamlQuote(target)}`);
-            if (hasChildren)
-                lines.push(navToYaml(item.children, indent + 2));
-        }
-    }
-    return lines.join("\n");
-}
-function buildConfig(siteName, siteUrl) {
-    const lines = [
-        `schemaVersion: 1`,
-        `site:`,
-        `  name: ${yamlQuote(siteName)}`,
-        `  basePath: ""`,
-    ];
-    if (siteUrl)
-        lines.push(`  url: ${yamlQuote(siteUrl)}`);
-    lines.push(`content:`, `  sources:`, `    - path: ./content`, `      from: dogsbay-md`, 
-    // `.gitbook/includes` fragments are `{% include %}` targets, not
-    // routable pages. routablesFrom: nav restricts routes to SUMMARY-
-    // named pages; the fragments stay on disk so includes resolve.
-    `  excludeFromRoutes:`, `    - .gitbook`, `  routablesFrom: nav`, ``);
-    return lines.join("\n");
-}
-/**
- * Serialize frontmatter (source keys + a title) as a YAML block.
- *
- * Uses YAML.stringify so array/object values (e.g. `tags: [a, b]`,
- * GitBook `cover:` maps) round-trip instead of being silently dropped
- * (review #4). The title is the source `title:` only when it's a
- * non-empty string; otherwise the computed title (H1 / slug) — a blank
- * or whitespace-only source title must NOT clobber it (review #6).
- */
-function frontmatterBlock(fm, title) {
-    const sourceTitle = typeof fm.title === "string" && fm.title.trim() ? fm.title : undefined;
-    const out = { title: sourceTitle ?? title, ...fm };
-    out.title = sourceTitle ?? title;
-    const body = stringifyYaml(out).replace(/\n$/, "");
-    return `---\n${body}\n---\n\n`;
-}
-/**
- * Mirror non-`.md` assets from each docs root into `content/`, preserving
- * the docs-root-relative layout under the space's slug prefix. Mirroring
- * from the docs root (not the repo root) matters when `.gitbook.yaml`
- * sets `root: ./docs/gitbook/` — otherwise unrelated repo source lands in
- * content/ and the translated relative image refs (`../.gitbook/assets/…`)
- * point at the wrong place.
- */
-function mirrorAssets(roots, contentDir) {
-    let count = 0;
-    for (const root of roots) {
-        const destBase = root.prefix ? join(contentDir, root.prefix) : contentDir;
-        // Only what is inside the space once links resolve: a symlink in someone
-        // else's repo must not copy a file from outside it into content/, where
-        // a `:::openapi` spec, for one, is rendered into the page.
-        let realRoot;
-        try {
-            realRoot = realpathSync(root.dir);
-        }
-        catch {
-            continue;
-        }
-        const inside = (p) => {
-            try {
-                const real = realpathSync(p);
-                return real === realRoot || real.startsWith(realRoot + sep);
-            }
-            catch {
-                return false;
-            }
-        };
-        // Each directory once: two links to `.` made the walk branch twice per level until ELOOP.
-        const seen = new Set([realRoot]);
-        const walk = (dir) => {
-            let entries;
-            try {
-                entries = readdirSync(dir);
-            }
-            catch {
-                return;
-            }
-            for (const name of entries) {
-                if (name === "node_modules" || name === ".git")
-                    continue;
-                const full = join(dir, name);
-                let st;
-                try {
-                    if (!inside(full))
-                        continue;
-                    st = statSync(full);
-                }
-                catch {
-                    continue;
-                }
-                if (st.isDirectory()) {
-                    // Skip hidden dirs EXCEPT `.gitbook` (holds assets + includes).
-                    if (name.startsWith(".") && name !== ".gitbook")
-                        continue;
-                    const real = realpathSync(full);
-                    if (seen.has(real))
-                        continue;
-                    seen.add(real);
-                    walk(full);
-                    continue;
-                }
-                if (name.toLowerCase().endsWith(".md"))
-                    continue; // pages handled separately
-                if (name === ".gitbook.yaml")
-                    continue;
-                const rel = relative(root.dir, full);
-                const dest = join(destBase, rel);
-                try {
-                    mkdirSync(dirname(dest), { recursive: true });
-                    copyFileSync(full, dest);
-                    count += 1;
-                }
-                catch {
-                    /* ignore individual asset copy failures */
-                }
-            }
-        };
-        walk(root.dir);
-    }
-    return count;
-}
 export async function migrateGitbook(source, options) {
     const sourceDir = resolve(source);
     if (!existsSync(sourceDir) || !statSync(sourceDir).isDirectory()) {
@@ -198,16 +48,21 @@ export async function migrateGitbook(source, options) {
     console.log(`Source:  ${sourceDir}`);
     console.log(`Output:  ${outputDir}`);
     console.log();
-    const { pages, nav, redirects, spaces, assetRoots } = await importGitbook(sourceDir, {
-        space: options.space,
-    });
+    const imported = await importGitbook(sourceDir, { space: options.space });
+    const { pages, corpus } = imported;
     if (pages.length === 0) {
         console.log(pc.red(`Error: no GitBook pages found under ${sourceDir}`));
         console.log("Point this at a directory containing a SUMMARY.md or .gitbook.yaml.");
         process.exit(1);
     }
-    const routable = pages.filter((p) => !p.fragment);
-    console.log(`Pages:   ${routable.length}` + (spaces.length > 1 ? ` across ${spaces.length} spaces` : ""));
+    const project = gitbookProject(imported, corpus, {
+        siteName,
+        siteUrl: options.siteUrl,
+        sourceLabel: sourceDir,
+        redirectsFile: "astro/public/_redirects",
+    });
+    const { stats } = project;
+    console.log(`Pages:   ${stats.pages}` + (stats.spaces.length > 1 ? ` across ${stats.spaces.length} spaces` : ""));
     // 1. Output skeleton — clear content/ on a fresh/forced run.
     const contentDir = join(outputDir, "content");
     const astroDir = join(outputDir, "astro");
@@ -215,72 +70,51 @@ export async function migrateGitbook(source, options) {
         rmSync(contentDir, { recursive: true, force: true });
     mkdirSync(contentDir, { recursive: true });
     mkdirSync(astroDir, { recursive: true });
-    // 2. Write pages + fragments. Guard against slug collisions — two
-    //    source files can slugify to the same path (e.g. README.md and
-    //    index.md both → `index`). Keep the first, skip + warn on the rest
-    //    rather than silently overwriting a whole page (review #3).
-    let fragments = 0;
-    let collisions = 0;
-    const written = new Set();
-    for (const page of pages) {
-        const dst = join(contentDir, `${page.slug}.md`);
-        if (written.has(dst)) {
-            collisions += 1;
-            console.warn(`gitbook migrate: slug collision at "${page.slug}" — keeping the first page, skipping a later source that maps to the same file.`);
-            continue;
-        }
-        written.add(dst);
+    // 2. The project's files, then the assets (.gitbook/assets, images) so relative refs resolve.
+    //    Every path is the project's, from someone else's repo: nothing lands outside the output.
+    const inside = (path) => {
+        const dst = resolve(outputDir, path);
+        if (!dst.startsWith(outputDir + sep))
+            throw new Error(`refusing to write outside ${outputDir}: ${path}`);
+        return dst;
+    };
+    for (const [path, text] of project.files) {
+        const dst = inside(path);
         mkdirSync(dirname(dst), { recursive: true });
-        const body = page.bodyMarkdown ?? "";
-        if (page.fragment) {
-            // Fragments: pure body, no frontmatter (they're include targets).
-            writeFileSync(dst, body.endsWith("\n") ? body : body + "\n");
-            fragments += 1;
+        writeFileSync(dst, text);
+    }
+    for (const e of project.ledger.filter((e) => e.code === "slug-collision"))
+        console.warn(`gitbook migrate: ${e.message}`);
+    console.log(pc.green(`Converted`) +
+        ` ${stats.pages} page(s)` +
+        (stats.fragments ? ` + ${stats.fragments} fragment(s)` : "") +
+        (stats.collisions ? pc.yellow(` (${stats.collisions} slug collision(s) skipped)`) : ""));
+    let assetCount = 0;
+    for (const { from, to } of project.assets) {
+        const dst = inside(to);
+        try {
+            mkdirSync(dirname(dst), { recursive: true });
+            copyFileSync(corpus.absolute(from), dst);
+            assetCount += 1;
         }
-        else {
-            const fm = frontmatterBlock(page.frontmatter ?? {}, page.title);
-            writeFileSync(dst, fm + (body.endsWith("\n") ? body : body + "\n"));
+        catch {
+            /* ignore individual asset copy failures */
         }
     }
-    console.log(pc.green(`Converted`) +
-        ` ${routable.length} page(s)` +
-        (fragments ? ` + ${fragments} fragment(s)` : "") +
-        (collisions ? pc.yellow(` (${collisions} slug collision(s) skipped)`) : ""));
-    // 3. Mirror assets (.gitbook/assets, images) so relative refs resolve.
-    const assetCount = mirrorAssets(assetRoots, contentDir);
     if (assetCount > 0)
         console.log(pc.green(`Mirrored`) + ` ${assetCount} asset(s)`);
-    // 4. nav.yml.
-    writeFileSync(join(contentDir, "nav.yml"), `# Migrated by dogsbay migrate-gitbook.\n# Edit freely.\n\n${navToYaml(nav)}\n`);
     console.log(pc.green(`Wrote`) + ` content/nav.yml`);
-    // 5. dogsbay.config.yml.
-    writeFileSync(join(outputDir, "dogsbay.config.yml"), buildConfig(siteName, options.siteUrl));
     console.log(pc.green(`Wrote`) + ` dogsbay.config.yml`);
-    // 6. Redirects → public/_redirects (Netlify/CF Pages style).
-    const redirectKeys = Object.keys(redirects);
-    if (redirectKeys.length > 0) {
+    // 3. Redirects → public/_redirects (Netlify/CF Pages style).
+    if (project.redirects.length > 0) {
         const publicDir = join(astroDir, "public");
         mkdirSync(publicDir, { recursive: true });
-        const lines = redirectKeys.map((from) => {
-            // Normalize target to its served URL: drop ./ + .md, and collapse a
-            // README landing (bare `README` OR `<dir>/README`) to its directory
-            // — a bare `README` maps to the site root `/`, not a dead `/README`
-            // (review #5).
-            const to = redirects[from]
-                .replace(/^\.\//, "")
-                .replace(/\.md$/i, "")
-                .replace(/(^|\/)README$/i, "$1")
-                .replace(/\/$/, "");
-            return `/${from}  /${to}  301`;
-        });
-        writeFileSync(join(publicDir, "_redirects"), lines.join("\n") + "\n");
-        console.log(pc.green(`Wrote`) + ` ${redirectKeys.length} redirect(s) → astro/public/_redirects`);
+        writeFileSync(join(publicDir, "_redirects"), project.redirects.map((r) => `${r.from}  ${r.to}  301`).join("\n") + "\n");
+        console.log(pc.green(`Wrote`) + ` ${project.redirects.length} redirect(s) → astro/public/_redirects`);
     }
-    // 7. Scaffold the Astro project.
+    // 4. Scaffold the Astro project.
     emitSiteScaffold(astroDir, siteName, { siteName, siteUrl: options.siteUrl, basePath: "", llmsTxt: true, mdMirror: true, local: options.local, sourceDir }, true);
     console.log(pc.green(`Scaffolded`) + ` Astro project at ./astro/`);
-    // 8. MIGRATION.md.
-    writeFileSync(join(outputDir, "MIGRATION.md"), buildMigrationNotes({ sourceDir, siteName, pageCount: routable.length, fragments, spaces, redirectCount: redirectKeys.length }));
     console.log(pc.green(`Wrote`) + ` MIGRATION.md`);
     if (!options.quiet) {
         console.log();
@@ -290,34 +124,3 @@ export async function migrateGitbook(source, options) {
         console.log(`  npx dogsbay site check         # audit rules`);
     }
 }
-function buildMigrationNotes(a) {
-    return [
-        `# Migration: ${a.siteName}`,
-        ``,
-        `Migrated from a GitBook Git Sync corpus by \`dogsbay migrate-gitbook\`.`,
-        ``,
-        `- **Source**: \`${a.sourceDir}\``,
-        `- **Pages**: ${a.pageCount}${a.fragments ? ` (+ ${a.fragments} include fragments)` : ""}`,
-        a.spaces.length > 1 ? `- **Spaces**: ${a.spaces.join(", ")} (each a top-level nav section)` : ``,
-        a.redirectCount ? `- **Redirects**: ${a.redirectCount} carried into \`astro/public/_redirects\`` : ``,
-        ``,
-        `## What was converted`,
-        ``,
-        `- GitBook \`{% hint %}\` → \`:::note/:::warning/:::info/:::danger\` callouts`,
-        `- \`{% tabs %}\` / \`{% stepper %}\` / \`{% columns %}\` → \`:::tabs\` / \`:::steps\` / \`:::grid\``,
-        `- \`{% code %}\`, \`{% content-ref %}\`, \`{% embed %}\`, \`{% file %}\`, \`{% page-ref %}\` → native Dogsbay-MD`,
-        `- \`{% include %}\` reusable content preserved (resolved at build time)`,
-        `- \`<figure>\` images, GitBook emoji spans, raw HTML tables handled`,
-        `- \`SUMMARY.md\` → \`content/nav.yml\`; \`.gitbook.yaml\` redirects → \`_redirects\``,
-        ``,
-        `## Known caveats`,
-        ``,
-        `- \`{% openapi %}\` / \`{% swagger %}\` blocks emit \`:::api-endpoint\` placeholders — wire them to the OpenAPI spec for full rendering.`,
-        `- Review any pages flagged in the import ledger (printed during migration).`,
-        ``,
-    ]
-        .filter((l) => l !== ``)
-        .join("\n")
-        .replace(/\n(##)/g, "\n\n$1")
-        .concat("\n");
-}

package/dist/formats.d.ts

@@ -22,24 +22,9 @@
  */
 import type { FormatPlugin } from "@dogsbay/types";
 import { type MdxAdapter } from "@dogsbay/format-mdx";
-/**
- * ORDER IS DETECTION PRECEDENCE — {@link detectFormat} returns the first
- * IMPORTABLE plugin whose `detectSource` claims the path.
- *
- * Config-anchored detectors (mkdocs.yml, docusaurus.config.*, hugo.*, …) come
- * first because they cannot false-positive. The two CATCH-ALL detectors go
- * last-but-one and last-ish, and their relative order is load-bearing:
- *
- *   asciidoc   → a corpus whose `.adoc` files outnumber its `.md` files
- *   dogsbay-md → any `.md` anywhere under the source
- *
- * asciidoc goes FIRST of the two: a real AsciiDoc corpus almost always carries
- * a `README.md` (openshift-docs does), and markdown-first would claim it and
- * import that one file instead of 20k pages. The inverse mistake is prevented
- * inside asciidoc's own detector, which now requires `.adoc` DOMINANCE rather
- * than mere presence — see `format-asciidoc/src/loaders/plain.ts`.
- */
 export declare const FORMATS: FormatPlugin[];
+/** `plugins` in FORMAT_ORDER; throws unless the two name the same formats, once each. */
+export declare function inDetectionOrder(plugins: FormatPlugin[]): FormatPlugin[];
 /**
  * Site adapters are OPTIONAL, and loaded only when named.
  *

package/dist/formats.js

@@ -1,3 +1,4 @@
+import { FORMAT_ORDER } from "@dogsbay/detect";
 import { plugin as mkdocsPlugin } from "@dogsbay/format-mkdocs/cli";
 import { plugin as astroPlugin } from "@dogsbay/format-astro/cli";
 import { plugin as obsidianPlugin } from "@dogsbay/format-obsidian/cli";
@@ -19,20 +20,13 @@ import { fumadocsAdapter, mintlifyAdapter } from "@dogsbay/format-mdx";
  * ORDER IS DETECTION PRECEDENCE — {@link detectFormat} returns the first
  * IMPORTABLE plugin whose `detectSource` claims the path.
  *
- * Config-anchored detectors (mkdocs.yml, docusaurus.config.*, hugo.*, …) come
- * first because they cannot false-positive. The two CATCH-ALL detectors go
- * last-but-one and last-ish, and their relative order is load-bearing:
- *
- *   asciidoc   → a corpus whose `.adoc` files outnumber its `.md` files
- *   dogsbay-md → any `.md` anywhere under the source
- *
- * asciidoc goes FIRST of the two: a real AsciiDoc corpus almost always carries
- * a `README.md` (openshift-docs does), and markdown-first would claim it and
- * import that one file instead of 20k pages. The inverse mistake is prevented
- * inside asciidoc's own detector, which now requires `.adoc` DOMINANCE rather
- * than mere presence — see `format-asciidoc/src/loaders/plain.ts`.
+ * The order is `FORMAT_ORDER` from @dogsbay/detect, which says why each format
+ * sits where it does: the playground's browser import detects in the same
+ * order, so a repo is the same format in both. Every plugin must be named
+ * there exactly once, and nothing else — a missing or extra name throws when
+ * this module loads, rather than leaving a plugin silently undetectable.
  */
-export const FORMATS = [
+const PLUGINS = [
     mkdocsPlugin,
     astroPlugin,
     obsidianPlugin,
@@ -40,41 +34,29 @@ export const FORMATS = [
     mdxPlugin,
     starlightPlugin,
     docusaurusPlugin,
-    // gitbook BEFORE dogsbay-md: GitBook corpora are markdown, so the
-    // generic dogsbay-md detector would claim them first and skip the
-    // {% %} tag translation. gitbook's detector requires SUMMARY.md /
-    // .gitbook.yaml, so it can't false-positive on a real dogsbay-md site.
     gitbookPlugin,
-    // hugo BEFORE dogsbay-md: Hugo content is markdown, so the generic
-    // dogsbay-md detector would claim it first and skip every shortcode.
-    // Hugo's detector requires a hugo.*/config.* file AND a content directory,
-    // so it cannot false-positive on a plain markdown corpus.
     hugoPlugin,
-    // vitepress BEFORE dogsbay-md: VitePress content is markdown, so the
-    // generic dogsbay-md detector would claim it first and skip every `:::`
-    // container, code-group and `<<<` snippet. Its detector requires an actual
-    // `.vitepress/config.*`, so it cannot false-positive on a plain markdown,
-    // MkDocs or GitBook corpus.
     vitepressPlugin,
     rstPlugin,
-    // myst BEFORE dogsbay-md, AFTER gitbook/rst: MyST corpora are markdown,
-    // so the generic dogsbay-md detector would claim them first and skip the
-    // directive/role translation. myst's detector requires an explicit MyST
-    // config (myst.yml / _toc.yml) or MyST-specific syntax, so it can't
-    // false-positive on a plain dogsbay-md or GitBook site.
     mystPlugin,
-    // asciidoc BEFORE dogsbay-md — see the precedence note above.
     asciidocPlugin,
     dogsbayMdPlugin,
     gatsbyPlugin,
-    // openapi LAST. Its directory probe matches a top-level
-    // `openapi.{yaml,yml,json}` / `spec.*`, and plenty of docs corpora ship
-    // exactly that file alongside their pages — dub and ollama both do. In that
-    // case the DOCS format should win and the spec is imported deliberately with
-    // `--from openapi`; auto-detection only claims a bare spec file or a
-    // spec-only directory, where nothing else matches.
     openapiPlugin,
 ];
+export const FORMATS = inDetectionOrder(PLUGINS);
+/** `plugins` in FORMAT_ORDER; throws unless the two name the same formats, once each. */
+export function inDetectionOrder(plugins) {
+    const byName = new Map(plugins.map((p) => [p.name, p]));
+    const missing = FORMAT_ORDER.filter((n) => !byName.has(n));
+    const extra = plugins.filter((p) => !FORMAT_ORDER.includes(p.name)).map((p) => p.name);
+    if (missing.length || extra.length || byName.size !== plugins.length) {
+        throw new Error(`The format registry and @dogsbay/detect's FORMAT_ORDER disagree: ` +
+            `${missing.length ? `no plugin for ${missing.join(", ")}` : ""}${missing.length && extra.length ? "; " : ""}` +
+            `${extra.length ? `not in FORMAT_ORDER: ${extra.join(", ")}` : ""}${byName.size !== plugins.length ? " (a name is registered twice)" : ""}`);
+    }
+    return FORMAT_ORDER.map((n) => byName.get(n));
+}
 export const DOCUSAURUS_ADAPTERS = {
     tigera: { module: "@dogsbay/adapter-tigera", export: "tigeraAdapter" },
     camunda: { module: "@dogsbay/adapter-camunda", export: "camundaAdapter" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dogsbay",
-  "version": "0.2.0-beta.130",
+  "version": "0.2.0-beta.131",
   "description": "CLI for Dogsbay — scaffold, build, and serve documentation sites with markdown / MkDocs / Obsidian / OpenAPI sources",
   "type": "module",
   "bin": {
@@ -43,36 +43,37 @@
     "typescript": "^5.9.3",
     "valibot": "1.1.0",
     "yaml": "^2.9.0",
-    "@dogsbay/adoc2md-modular": "0.2.0-beta.130",
-    "@dogsbay/autodoc-python": "0.2.0-beta.130",
-    "@dogsbay/commands": "0.2.0-beta.130",
-    "@dogsbay/format-asciidoc": "0.2.0-beta.130",
-    "@dogsbay/format-astro": "0.2.0-beta.130",
-    "@dogsbay/format-dita": "0.2.0-beta.130",
-    "@dogsbay/format-docusaurus": "0.2.0-beta.130",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.130",
-    "@dogsbay/format-fluidtopics-markdown": "0.2.0-beta.130",
-    "@dogsbay/format-fluidtopics-rest": "0.2.0-beta.130",
-    "@dogsbay/format-gatsby": "0.2.0-beta.130",
-    "@dogsbay/format-gitbook": "0.2.0-beta.130",
-    "@dogsbay/format-mdx": "0.2.0-beta.130",
-    "@dogsbay/format-hugo": "0.2.0-beta.130",
-    "@dogsbay/format-mkdocs": "0.2.0-beta.130",
-    "@dogsbay/format-myst": "0.2.0-beta.130",
-    "@dogsbay/format-obsidian": "0.2.0-beta.130",
-    "@dogsbay/format-openknowledge": "0.2.0-beta.130",
-    "@dogsbay/format-openapi": "0.2.0-beta.130",
-    "@dogsbay/format-starlight": "0.2.0-beta.130",
-    "@dogsbay/format-topicmap": "0.2.0-beta.130",
-    "@dogsbay/format-rst": "0.2.0-beta.130",
-    "@dogsbay/format-vitepress": "0.2.0-beta.130",
-    "@dogsbay/minja": "0.2.0-beta.130",
-    "@dogsbay/render": "0.2.0-beta.130",
-    "@dogsbay/render-html": "0.2.0-beta.130",
-    "@dogsbay/serialize-core": "0.2.0-beta.130",
-    "@dogsbay/site-check": "0.2.0-beta.130",
-    "@dogsbay/site-files": "0.2.0-beta.130",
-    "@dogsbay/types": "0.2.0-beta.130"
+    "@dogsbay/adoc2md-modular": "0.2.0-beta.131",
+    "@dogsbay/autodoc-python": "0.2.0-beta.131",
+    "@dogsbay/commands": "0.2.0-beta.131",
+    "@dogsbay/detect": "0.2.0-beta.131",
+    "@dogsbay/format-asciidoc": "0.2.0-beta.131",
+    "@dogsbay/format-astro": "0.2.0-beta.131",
+    "@dogsbay/format-dita": "0.2.0-beta.131",
+    "@dogsbay/format-docusaurus": "0.2.0-beta.131",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.131",
+    "@dogsbay/format-fluidtopics-markdown": "0.2.0-beta.131",
+    "@dogsbay/format-gatsby": "0.2.0-beta.131",
+    "@dogsbay/format-fluidtopics-rest": "0.2.0-beta.131",
+    "@dogsbay/format-gitbook": "0.2.0-beta.131",
+    "@dogsbay/format-hugo": "0.2.0-beta.131",
+    "@dogsbay/format-mkdocs": "0.2.0-beta.131",
+    "@dogsbay/format-mdx": "0.2.0-beta.131",
+    "@dogsbay/format-myst": "0.2.0-beta.131",
+    "@dogsbay/format-obsidian": "0.2.0-beta.131",
+    "@dogsbay/format-openapi": "0.2.0-beta.131",
+    "@dogsbay/format-openknowledge": "0.2.0-beta.131",
+    "@dogsbay/format-rst": "0.2.0-beta.131",
+    "@dogsbay/format-starlight": "0.2.0-beta.131",
+    "@dogsbay/format-topicmap": "0.2.0-beta.131",
+    "@dogsbay/format-vitepress": "0.2.0-beta.131",
+    "@dogsbay/minja": "0.2.0-beta.131",
+    "@dogsbay/render": "0.2.0-beta.131",
+    "@dogsbay/render-html": "0.2.0-beta.131",
+    "@dogsbay/serialize-core": "0.2.0-beta.131",
+    "@dogsbay/site-check": "0.2.0-beta.131",
+    "@dogsbay/site-files": "0.2.0-beta.131",
+    "@dogsbay/types": "0.2.0-beta.131"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",