@dogsbay/format-vitepress 0.2.0-beta.133 → 0.2.0-beta.135

package/dist/import.d.ts

@@ -24,5 +24,7 @@ export interface VitepressCorpusImport {
     components: Record<string, number>;
     /** Per-page constructs mapped with caveats, pages that failed, and the loader's warnings. */
     ledger: ImportLedgerEntry[];
+    /** The corpus file each page was converted from: `sources[i]` is `pages[i]`'s. */
+    sources: string[];
 }
 export declare function importVitepressCorpus(corpus: Corpus, opts?: VitepressLoadOptions): VitepressCorpusImport;

package/dist/import.js

@@ -8,6 +8,7 @@ export function importVitepressCorpus(corpus, opts = {}) {
     const pages = [];
     const components = {};
     const ledger = [];
+    const sources = [];
     for (const ps of loaded.pages) {
         try {
             const content = corpus.text(ps.path);
@@ -30,6 +31,7 @@ export function importVitepressCorpus(corpus, opts = {}) {
             const heroName = typeof frontmatter.hero?.name === "string"
                 ? (frontmatter.hero.name)
                 : undefined;
+            sources.push(ps.path);
             pages.push({
                 slug: ps.slug,
                 title: fmTitle || h1?.text || heroName || titleFromSlug(ps.slug),
@@ -72,5 +74,6 @@ export function importVitepressCorpus(corpus, opts = {}) {
         warnings: loaded.warnings,
         components,
         ledger,
+        sources,
     };
 }

package/dist/migrate.js

@@ -1,5 +1,5 @@
-import { corpusFromMap, unfetchedMessage } from "@dogsbay/corpus";
-import { dogsbayMdPageFiles, mountCopies } from "@dogsbay/format-dogsbay-md/browser";
+import { corpusFromMap, pageSources, pendingCopies, unfetchedMessage, withPages } from "@dogsbay/corpus";
+import { dogsbayMdPageFiles, dogsbayMdPagePath, mountCopies } from "@dogsbay/format-dogsbay-md/browser";
 import { importVitepressCorpus } from "./import.js";
 /** The ledger line for a conversion that still needs files, or nothing. */
 function unfetchedLedger(read, stoppedOn) {
@@ -53,31 +53,42 @@ export async function migrate(input) {
         // A file it needed was not given: that, not the error, is the answer
         const read = corpus.missing();
         if (read.length)
-            return { files: new Map(), ledger: unfetchedLedger(read, e), unfetched: { read, copy: [] } };
+            return { files: new Map(), ledger: unfetchedLedger(read, e), unfetched: { read, copy: [], copyTo: [] } };
         throw e;
     }
     const siteName = input.siteName?.trim() || imported.siteName?.trim() || "Docs";
     const files = new Map();
     // Assets first, then the pages: `convert` copies the mounts before it writes the pages, so a
     // page wins over a file at the same path
+    const pageFiles = dogsbayMdPageFiles(imported.pages, imported.nav);
+    // One file per output path, the last mount's (public/ and .vitepress/public/ both land in
+    // _assets/), whether its bytes were given or not; a page at the same path wins
+    const winners = new Map();
+    for (const { from, to } of mountCopies(corpus.paths, imported.assetDirs))
+        winners.set(to, from);
     const copy = [];
-    for (const { from, to } of mountCopies(corpus.paths, imported.assetDirs)) {
+    for (const [to, from] of winners) {
+        if (pageFiles.has(to))
+            continue;
         const bytes = input.files.get(from);
         if (bytes !== undefined)
             files.set(`content/${to}`, bytes);
         else
-            copy.push(from);
+            copy.push({ from, to: `content/${to}` });
     }
-    for (const [path, text] of dogsbayMdPageFiles(imported.pages, imported.nav))
+    for (const [path, text] of pageFiles)
         files.set(`content/${path}`, text);
+    // Each note about a page's file names the page written from it
+    const pageOf = pageSources(imported.pages.map((p, i) => ({ file: imported.sources[i], path: `content/${dogsbayMdPagePath(p)}` })));
+    const ledger = withPages(imported.ledger, pageOf);
     files.set("dogsbay.config.yml", buildConfig(siteName, input.siteUrl));
     files.set("MIGRATION.md", migrationNotes({
         siteName,
         sourceLabel: input.sourceLabel ?? "VitePress project",
         pages: imported.pages.length,
         navSource: imported.navSource,
-        ledger: imported.ledger,
+        ledger,
     }));
     const read = corpus.missing();
-    return { files, ledger: [...unfetchedLedger(read), ...imported.ledger], unfetched: { read, copy: copy.sort() } };
+    return { files, ledger: [...unfetchedLedger(read), ...ledger], unfetched: { read, ...pendingCopies(copy) } };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dogsbay/format-vitepress",
-  "version": "0.2.0-beta.133",
+  "version": "0.2.0-beta.135",
   "description": "VitePress format plugin for Dogsbay — imports VitePress docs projects into TreeNode[] by translating VitePress containers, code-fence conventions, snippets and includes to Dogsbay-MD.",
   "type": "module",
   "main": "dist/index.js",
@@ -24,11 +24,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@dogsbay/corpus": "0.2.0-beta.133",
-    "@dogsbay/format-dogsbay-md": "0.2.0-beta.133",
-    "@dogsbay/detect": "0.2.0-beta.133",
-    "@dogsbay/literal": "0.2.0-beta.133",
-    "@dogsbay/types": "0.2.0-beta.133"
+    "@dogsbay/corpus": "0.2.0-beta.135",
+    "@dogsbay/detect": "0.2.0-beta.135",
+    "@dogsbay/types": "0.2.0-beta.135",
+    "@dogsbay/format-dogsbay-md": "0.2.0-beta.135",
+    "@dogsbay/literal": "0.2.0-beta.135"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",