@docsector/docsector-reader 2.0.0 → 2.0.1

package/bin/docsector.js

@@ -23,7 +23,7 @@ const packageRoot = resolve(__dirname, '..')
 const args = process.argv.slice(2)
 const command = args[0]
 
-const VERSION = '2.0.0'
+const VERSION = '2.0.1'
 
 const HELP = `
   Docsector Reader v${VERSION}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docsector/docsector-reader",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "A documentation rendering engine built with Vue 3, Quasar v2 and Vite. Transform Markdown into beautiful, navigable documentation sites.",
   "productName": "Docsector Reader",
   "author": "Rodrigo de Araujo Vieira",

package/src/quasar.factory.js

@@ -347,6 +347,32 @@ async function loadBooksRegistry (projectRoot) {
   }
 }
 
+/**
+ * Return page entries while preserving the book that contributed each route.
+ *
+ * Why: `allPages` is a legacy flattened registry and cannot represent two
+ * books that reuse the same route key, such as `/getting-started` in both
+ * `guide.index.js` and `manual.index.js`. Build artifacts that need concrete
+ * URLs must iterate per book instead.
+ */
+function getBookPageEntries (books = {}) {
+  const pageEntries = []
+
+  for (const [bookId, book] of Object.entries(books || {})) {
+    const fallbackBook = book?.config?.id || bookId || 'manual'
+
+    for (const [pagePath, page] of Object.entries(book?.routes || {})) {
+      pageEntries.push({
+        book: resolvePageBook(page?.config, fallbackBook),
+        pagePath,
+        page
+      })
+    }
+  }
+
+  return pageEntries
+}
+
 /**
  * Check if a file path is a book registry definition file.
  */
@@ -463,7 +489,8 @@ function createPrerenderMetaPlugin (projectRoot) {
       // Dynamic import books registry and docsector config
       const configUrl = pathToFileURL(resolve(projectRoot, 'docsector.config.js')).href
 
-      const { allPages: pages } = await loadBooksRegistry(projectRoot)
+      const { books } = await loadBooksRegistry(projectRoot)
+      const pageEntries = getBookPageEntries(books)
       const { default: config } = await import(configUrl)
 
       const brandingName = config.branding?.name || ''
@@ -481,10 +508,9 @@ function createPrerenderMetaPlugin (projectRoot) {
 
       let count = 0
 
-      for (const [pagePath, page] of Object.entries(pages)) {
+      for (const { book, pagePath, page } of pageEntries) {
         if (page.config === null) continue
 
-        const book = resolvePageBook(page.config, 'manual')
         const titleData = page.data?.[defaultLang] || page.data?.['*'] || page.data?.['en-US'] || Object.values(page.data || {})[0]
         const title = titleData?.title || ''
         const fullTitle = title
@@ -1075,17 +1101,16 @@ function createMarkdownBuildPlugin (projectRoot) {
       const configUrl = pathToFileURL(resolve(projectRoot, 'docsector.config.js')).href
 
       const { default: config } = await import(configUrl)
-      const { allPages: pages } = await loadBooksRegistry(projectRoot)
+      const { books } = await loadBooksRegistry(projectRoot)
+      const pageEntries = getBookPageEntries(books)
 
       const defaultLang = config.defaultLanguage || config.languages?.[0]?.value || 'en-US'
       let count = 0
 
-      for (const [pagePath, page] of Object.entries(pages)) {
+      for (const { book, pagePath, page } of pageEntries) {
         if (page.config === null) continue
         if (page.config.status === 'empty') continue
 
-        const book = resolvePageBook(page.config, 'manual')
-
         const subpages = ['overview']
         if (page.config.subpages?.showcase) subpages.push('showcase')
         if (page.config.subpages?.vs) subpages.push('vs')
@@ -1129,12 +1154,10 @@ function createMarkdownBuildPlugin (projectRoot) {
         const today = new Date().toISOString().split('T')[0]
         let urls = ''
 
-        for (const [pagePath, page] of Object.entries(pages)) {
+        for (const { book, pagePath, page } of pageEntries) {
           if (page.config === null) continue
           if (page.config.status === 'empty') continue
 
-          const book = resolvePageBook(page.config, 'manual')
-
           const subpages = ['overview']
           if (page.config.subpages?.showcase) subpages.push('showcase')
           if (page.config.subpages?.vs) subpages.push('vs')
@@ -1162,11 +1185,10 @@ function createMarkdownBuildPlugin (projectRoot) {
 
         const llmsSections = {}
 
-        for (const [pagePath, page] of Object.entries(pages)) {
+        for (const { book, pagePath, page } of pageEntries) {
           if (page.config === null) continue
           if (page.config.status === 'empty') continue
 
-          const book = resolvePageBook(page.config, 'manual')
           const title = page.data?.['*']?.title
             || page.data?.[defaultLang]?.title
             || page.data?.['en-US']?.title
@@ -1783,11 +1805,10 @@ export async function onRequest (context) {
 
         // Collect page index for MCP
         const mcpPages = []
-        for (const [pagePath, page] of Object.entries(pages)) {
+        for (const { book, pagePath, page } of pageEntries) {
           if (page.config === null) continue
           if (page.config.status === 'empty') continue
 
-          const book = resolvePageBook(page.config, 'manual')
           const defaultTitle = page.data?.['*']?.title
             || page.data?.[defaultLang]?.title
             || page.data?.['en-US']?.title