@docsector/docsector-reader 2.0.7 → 2.2.0

package/src/components/DPageMeta.vue

@@ -20,7 +20,17 @@ function normalizeEditBaseUrl (url = '') {
 
 const base = normalizeEditBaseUrl(docsectorConfig.github?.editBaseUrl || '')
 
+function getCurrentSubpageName () {
+  const relative = store.state.page.relative || '/overview'
+  return String(relative).replace(/^\/+|\/+$/g, '') || 'overview'
+}
+
 function routePathToSourcePath (path = '') {
+  const sourcePathBase = route.matched?.[0]?.meta?.sourcePathBase
+  if (typeof sourcePathBase === 'string' && sourcePathBase.length > 0) {
+    return `/${sourcePathBase}.${getCurrentSubpageName()}`
+  }
+
   const cleanPath = String(path)
     .replace(/\/index\.html$/, '')
     .replace(/\/+$/, '')
@@ -44,7 +54,7 @@ const URL = computed(() => {
   return `${base}${path}.${locale.value}.md`
 })
 const color = computed(() => {
-  if (status.value === 'done') {
+  if (status.value === 'done' || status.value === 'new') {
     return 'white'
   } else if (status.value === 'draft') {
     return 'warning'
@@ -53,7 +63,7 @@ const color = computed(() => {
   }
 })
 const icon = computed(() => {
-  if (status.value === 'done') {
+  if (status.value === 'done' || status.value === 'new') {
     return 'edit'
   } else if (status.value === 'draft') {
     return 'border_color'
@@ -131,34 +141,38 @@ const languages = computed(() => {
   return `${i18nLocalesAvailable}/${i18nLocales.length}`
 })
 
-const prev = computed(() => {
-  const base = store.state.page.base
-  const routes = router.options.routes.slice(0, -2)
-
-  for (let i = 0; i < routes.length; i++) {
-    if ('/' + base === routes[i].path) {
-      if (i > 0) {
-        return routes[i - 1].path
-      }
-    }
+const normalizeRoutePath = (path) => {
+  const normalized = String(path || '').trim()
+  if (normalized === '' || normalized === '/') {
+    return '/'
   }
 
-  return ''
+  const sanitized = normalized.replace(/\/+$/, '')
+  return sanitized === '' ? '/' : sanitized
+}
+
+const getVersionSiblingPath = (offset) => {
+  const versionId = route.matched?.[0]?.meta?.version ?? null
+  const currentPath = normalizeRoutePath(route.matched?.[0]?.path || `/${store.state.page.base}`)
+  const routes = router.options.routes
+    .slice(0, -2)
+    .filter(item => !versionId || item?.meta?.version === versionId)
+
+  const index = routes.findIndex(item => normalizeRoutePath(item.path) === currentPath)
+  if (index < 0) return ''
+
+  const sibling = routes[index + offset]
+  if (!sibling) return ''
+
+  return sibling.path
+}
+
+const prev = computed(() => {
+  return getVersionSiblingPath(-1)
 })
 
 const next = computed(() => {
-  const base = store.state.page.base
-  const routes = router.options.routes.slice(0, -2)
-
-  for (let i = 0; i < routes.length; i++) {
-    if ('/' + base === routes[i].path) {
-      if (typeof routes[i + 1] !== 'undefined') {
-        return routes[i + 1].path
-      }
-    }
-  }
-
-  return ''
+  return getVersionSiblingPath(1)
 })
 
 const hideRemoteHomeFooterMeta = computed(() => {
@@ -180,7 +194,7 @@ const getRouteTitle = (path) => {
     <div id="d-page-edit" class="col">
       <q-btn dense no-caps text-color="black" :color="color" @click="openURL(URL)" aria-label="Edit page on Github">
         <q-icon class="q-mr-xs" name="fab fa-github" size="20px" />
-        <span class="hm" v-if="status === 'done'">{{ $t('page.edit.github.edit') }}</span>
+        <span class="hm" v-if="status === 'done' || status === 'new'">{{ $t('page.edit.github.edit') }}</span>
         <span class="hm" v-else-if="status === 'draft'">{{ $t('page.edit.github.complete') }}</span>
         <span class="hm" v-else-if="status === 'empty'">{{ $t('page.edit.github.start') }}</span>
       </q-btn>

package/src/i18n/helpers.js

@@ -25,6 +25,7 @@ const engineDefaults = {
   'en-US': {
     page: {
       lastUpdated: 'Last updated',
+      newVersion: 'New in',
       copyPage: 'Copy page',
       copyPageCaption: 'Copy page as Markdown for LLMs',
       copied: 'Copied!',
@@ -44,11 +45,36 @@ const engineDefaults = {
       connectClaudeCodeCaption: 'Use this MCP in Claude Code',
       connectCodex: 'Connect to Codex',
       connectCodexCaption: 'Use this MCP in Codex'
+    },
+    menu: {
+      status: {
+        empty: {
+          _: 'empty',
+          tooltip: 'This page is empty!'
+        },
+        draft: {
+          _: 'draft',
+          tooltip: 'This page is under construction.'
+        },
+        new: {
+          _: 'new',
+          tooltip: 'This page is new.',
+          tooltipVersion: 'New in {version}'
+        }
+      },
+      version: {
+        status: {
+          released: 'released',
+          draft: 'draft',
+          deprecated: 'deprecated'
+        }
+      }
     }
   },
   'pt-BR': {
     page: {
       lastUpdated: 'Última atualização',
+      newVersion: 'Novo em',
       copyPage: 'Copiar página',
       copyPageCaption: 'Copiar página como Markdown para LLMs',
       copied: 'Copiado!',
@@ -68,6 +94,30 @@ const engineDefaults = {
       connectClaudeCodeCaption: 'Use este MCP no Claude Code',
       connectCodex: 'Conectar ao Codex',
       connectCodexCaption: 'Use este MCP no Codex'
+    },
+    menu: {
+      status: {
+        empty: {
+          _: 'vazia',
+          tooltip: 'Esta página está vazia!'
+        },
+        draft: {
+          _: 'rascunho',
+          tooltip: 'Esta página está em construção.'
+        },
+        new: {
+          _: 'novo',
+          tooltip: 'Esta página é nova.',
+          tooltipVersion: 'Novo na {version}'
+        }
+      },
+      version: {
+        status: {
+          released: 'publicada',
+          draft: 'rascunho',
+          deprecated: 'obsoleta'
+        }
+      }
     }
   }
 }
@@ -116,12 +166,13 @@ export function filter (source) {
  * @param {Object} options.mdModules - Result of recursively globbing markdown files under ../pages with eager raw imports
  * @param {Object} [options.pages] - Legacy merged page registry from virtual:docsector-books (allPages)
  * @param {Object} [options.books] - Book registry from virtual:docsector-books (preferred, avoids path collisions)
+ * @param {Array} [options.pageEntries] - Version-aware page entries from virtual:docsector-books
  * @param {Object} options.boot - Boot meta from pages/boot.js
  * @param {string[]} [options.langs] - Language codes to process (auto-detected from langModules if omitted)
  * @param {Object<string,string>} [options.homePageOverride] - Optional per-language Home markdown override
  * @returns {Object} Complete i18n messages object keyed by locale
  */
-export function buildMessages ({ langModules, mdModules, pages, books, boot, langs, homePageOverride = {} }) {
+export function buildMessages ({ langModules, mdModules, pages, books, pageEntries, boot, langs, homePageOverride = {} }) {
   // Auto-detect languages from HJSON files if not provided
   if (!langs) {
     langs = Object.keys(langModules).map(key => {
@@ -133,8 +184,9 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
 
   const i18n = {}
 
-  function load (topPage, path, subpage, lang) {
-    const key = `../pages/${topPage}/${path}.${subpage}.${lang}.md`
+  function load (topPage, path, subpage, lang, sourceRoot = '') {
+    const normalizedSourceRoot = String(sourceRoot || '').replace(/^\/+|\/+$/g, '')
+    const key = `../pages/${normalizedSourceRoot ? normalizedSourceRoot + '/' : ''}${topPage}/${path}.${subpage}.${lang}.md`
     const content = mdModules[key]
 
     if (!content) {
@@ -200,20 +252,30 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
     return match[1].trim()
   }
 
-  const pageEntries = []
+  const resolvedPageEntries = []
 
-  if (books && typeof books === 'object' && Object.keys(books).length > 0) {
+  if (Array.isArray(pageEntries) && pageEntries.length > 0) {
+    for (const entry of pageEntries) {
+      resolvedPageEntries.push({
+        key: entry.pagePath,
+        page: entry.page,
+        fallbackBook: entry.book,
+        sourceRoot: entry.sourceRoot || '',
+        i18nSegments: entry.i18nSegments
+      })
+    }
+  } else if (books && typeof books === 'object' && Object.keys(books).length > 0) {
     for (const [bookId, book] of Object.entries(books)) {
       const routes = book?.routes || {}
       const fallbackBook = book?.config?.id || bookId || 'manual'
 
       for (const [key, page] of Object.entries(routes)) {
-        pageEntries.push({ key, page, fallbackBook })
+        resolvedPageEntries.push({ key, page, fallbackBook })
       }
     }
   } else {
     for (const [key, page] of Object.entries(pages || {})) {
-      pageEntries.push({ key, page, fallbackBook: null })
+      resolvedPageEntries.push({ key, page, fallbackBook: null })
     }
   }
 
@@ -249,8 +311,8 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
     i18n[lang]._.home.overview.source = loadHomepage(lang)
 
     // @ Iterate pages
-    for (const entry of pageEntries) {
-      const { key, page, fallbackBook } = entry
+    for (const entry of resolvedPageEntries) {
+      const { key, page, fallbackBook, sourceRoot = '', i18nSegments: entryI18nSegments } = entry
       const path = key.startsWith('/') ? key.slice(1) : key
 
       const config = page.config
@@ -258,13 +320,13 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
       const meta = page.meta || boot.meta
 
       const topPage = config?.book ?? config?.type ?? fallbackBook ?? 'manual'
-      if (i18n[lang]._[topPage] === undefined) {
-        i18n[lang]._[topPage] = {}
-      }
+      const i18nSegments = Array.isArray(entryI18nSegments) && entryI18nSegments.length > 0
+        ? entryI18nSegments
+        : [topPage, ...path.split('/').filter(Boolean)]
 
       // ---
 
-      const _ = path.split('/').reduce((accumulator, current) => {
+      const _ = i18nSegments.reduce((accumulator, current, index) => {
         let node = accumulator[current]
 
         // Set object if not exists
@@ -275,7 +337,7 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
 
         // @ Set metadata
         // title
-        if (node._ === undefined) {
+        if (index === i18nSegments.length - 1 && node._ === undefined) {
           node._ = data?.[lang]?.title || data?.['*']?.title || data?.['en-US']?.title || ''
         }
 
@@ -283,6 +345,10 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
           return node
         }
 
+        if (index < i18nSegments.length - 1) {
+          return node
+        }
+
         // Set subpages sources if not exists
         if (node.overview === undefined) {
           node.overview = {
@@ -307,7 +373,7 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
         }
 
         return node
-      }, i18n[lang]._[topPage])
+      }, i18n[lang]._)
 
       // ---
 
@@ -322,14 +388,14 @@ export function buildMessages ({ langModules, mdModules, pages, books, boot, lan
 
       // @ Subpages
       // Overview
-      _.overview.source = load(topPage, path, 'overview', lang)
+      _.overview.source = load(topPage, path, 'overview', lang, sourceRoot)
       // showcase
       if (config.subpages?.showcase === true) {
-        _.showcase.source = load(topPage, path, 'showcase', lang)
+        _.showcase.source = load(topPage, path, 'showcase', lang, sourceRoot)
       }
       // Vs
       if (config.subpages?.vs === true) {
-        _.vs.source = load(topPage, path, 'vs', lang)
+        _.vs.source = load(topPage, path, 'vs', lang, sourceRoot)
       }
     }
   }

package/src/i18n/index.js

@@ -5,10 +5,12 @@ import homePageOverride from 'virtual:docsector-homepage-override'
 // @ Import language HJSON files (Vite-compatible eager import)
 const langModules = import.meta.glob('./languages/*.hjson', { eager: true })
 // @ Import markdown files (Vite-compatible eager import as raw strings)
-const mdModules = import.meta.glob('../pages/**/*.md', { eager: true, query: '?raw', import: 'default' })
+const currentMdModules = import.meta.glob('../pages/**/*.md', { eager: true, query: '?raw', import: 'default' })
+const oldMdModules = import.meta.glob('../pages/.old/**/*.md', { eager: true, query: '?raw', import: 'default' })
+const mdModules = { ...currentMdModules, ...oldMdModules }
 
 // @ Import pages
 import boot from 'pages/boot'
-import { books } from 'virtual:docsector-books'
+import { books, pageEntries } from 'virtual:docsector-books'
 
-export default buildMessages({ langModules, mdModules, books, boot, homePageOverride })
+export default buildMessages({ langModules, mdModules, books, pageEntries, boot, homePageOverride })

package/src/i18n/languages/en-US.hjson

@@ -32,6 +32,7 @@
       next: 'Next page'
     },
     lastUpdated: 'Last updated',
+    newVersion: 'New in',
     copyPage: 'Copy page',
     copyPageCaption: 'Copy page as Markdown for LLMs',
     copied: 'Copied!',
@@ -60,6 +61,19 @@
       draft: {
         _: 'draft',
         tooltip: 'This page is under constrution.'
+      },
+      new: {
+        _: 'new',
+        tooltip: 'This page is new.',
+        tooltipVersion: 'New in {version}'
+      }
+    },
+
+    version: {
+      status: {
+        released: 'released',
+        draft: 'draft',
+        deprecated: 'deprecated'
       }
     },
 

package/src/i18n/languages/pt-BR.hjson

@@ -31,6 +31,7 @@
       next: 'Próxima página'
     },
     lastUpdated: 'Última atualização',
+    newVersion: 'Novo em',
     copyPage: 'Copiar página',
     copyPageCaption: 'Copiar página como Markdown para LLMs',
     copied: 'Copiado!',
@@ -59,6 +60,19 @@
       draft: {
         _: 'rascunho',
         tooltip: 'Esta página está em construção.'
+      },
+      new: {
+        _: 'novo',
+        tooltip: 'Esta página é nova.',
+        tooltipVersion: 'Novo na {version}'
+      }
+    },
+
+    version: {
+      status: {
+        released: 'publicada',
+        draft: 'rascunho',
+        deprecated: 'obsoleta'
       }
     },
 

package/src/i18n/path.js

@@ -73,6 +73,19 @@ export function splitDotPathSegments (dotPath) {
   return normalized.split('.').filter(Boolean)
 }
 
+function splitI18nPathSegments (path) {
+  if (Array.isArray(path)) {
+    return normalizeSegments(path)
+  }
+
+  const normalized = String(path || '').trim()
+  if (normalized.includes('/')) {
+    return splitRoutePathSegments(normalized)
+  }
+
+  return splitDotPathSegments(normalized)
+}
+
 export function routeTitleI18nPath (routePath) {
   return buildI18nPath('_', ...splitRoutePathSegments(routePath), '_')
 }
@@ -82,11 +95,11 @@ export function routeSubpageSourceI18nPath (routePath, subpage = 'overview') {
 }
 
 export function pageTitleI18nPath (basePath) {
-  return buildI18nPath('_', ...splitDotPathSegments(basePath), '_')
+  return buildI18nPath('_', ...splitI18nPathSegments(basePath), '_')
 }
 
 export function pageValueI18nPath (absolutePath, key = 'source') {
-  return buildI18nPath('_', ...splitDotPathSegments(absolutePath), key)
+  return buildI18nPath('_', ...splitI18nPathSegments(absolutePath), key)
 }
 
 export function namespacedLabelI18nPath (book, nodePath) {

package/src/index.js

@@ -27,7 +27,7 @@
  * @param {string} config.branding.name - Project name displayed in sidebar
  * @param {string} config.branding.version - Version label
  * @param {string} [config.branding.description] - Project description (used in llms.txt)
- * @param {string[]} [config.branding.versions] - Available versions for dropdown
+ * @param {Array<string|Object>} [config.branding.versions] - Available versions for dropdown. Current docs keep unprefixed routes; archived versions can live in src/pages/.old/<version>/ and use /<version>/ route prefixes. Version objects may set released:false/status:'draft', status:'deprecated'/deprecated:true, or badge:{label,color,textColor} for selector badges.
  * @param {Object} config.links - External links
  * @param {string} [config.links.github] - GitHub repository URL
  * @param {string} [config.links.discussions] - GitHub discussions URL
@@ -111,7 +111,7 @@ export function createDocsector (config = {}) {
       logo: '/images/logo.png',
       name: 'My Project',
       version: 'v0.0.1',
-      versions: ['v0.0.1'],
+      versions: [{ id: 'v0.0.1', current: true, released: false }],
       ...config.branding
     },
 

package/src/layouts/DefaultLayout.vue

@@ -59,7 +59,7 @@ import { useMeta, colors } from 'quasar'
 
 import DMenu from '../components/DMenu.vue'
 import docsectorConfig from 'docsector.config.js'
-import { allBooks } from 'virtual:docsector-books'
+import { allBooks, booksByVersion } from 'virtual:docsector-books'
 import { pageTitleI18nPath } from '../i18n/path'
 
 defineOptions({ name: 'LayoutDefault' })
@@ -178,8 +178,20 @@ const getBookTabStyle = (book) => {
   }
 }
 
+const activeVersionId = computed(() => {
+  return route.matched?.[0]?.meta?.version ?? route.meta?.version ?? null
+})
+
+const activeVersionBooks = computed(() => {
+  if (activeVersionId.value && booksByVersion?.[activeVersionId.value]?.allBooks) {
+    return booksByVersion[activeVersionId.value].allBooks
+  }
+
+  return allBooks || []
+})
+
 const sortedBooks = computed(() => {
-  return [...(allBooks || [])]
+  return [...activeVersionBooks.value]
     .filter(book => book && typeof book.id === 'string' && book.id.length > 0)
     .sort((a, b) => {
       const orderA = Number.isFinite(a.order) ? a.order : Number.MAX_SAFE_INTEGER
@@ -261,10 +273,12 @@ function openSettingsDialog () {
 
 function getFirstRoutePathByBook (bookId) {
   const routes = router.options?.routes || []
+  const versionId = activeVersionId.value
   let fallbackPath = null
 
   for (const topRoute of routes) {
     if (!topRoute || typeof topRoute.path !== 'string') continue
+    if (versionId && topRoute.meta?.version !== versionId) continue
     if ((topRoute.meta?.book ?? topRoute.meta?.type) !== bookId) continue
 
     const children = Array.isArray(topRoute.children) ? topRoute.children : []

package/src/pages/.old/v0.x/guide/getting-started.overview.en-US.md

@@ -0,0 +1,7 @@
+## Archived Version
+
+This page is a minimal archived `v0.x` fixture used to validate Docsector Reader version switching.
+
+## Current Behavior
+
+Selecting `v0.x` in the sidebar keeps the active book and page when an archived equivalent exists, then serves this Markdown from `src/pages/.old/v0.x`.

package/src/pages/.old/v0.x/guide/getting-started.overview.pt-BR.md

@@ -0,0 +1,7 @@
+## Versao Arquivada
+
+Esta pagina e um fixture minimo arquivado `v0.x` usado para validar a troca de versoes do Docsector Reader.
+
+## Comportamento Atual
+
+Ao selecionar `v0.x` no menu lateral, o leitor preserva o book e a pagina ativos quando existe um equivalente arquivado, entao serve este Markdown a partir de `src/pages/.old/v0.x`.

package/src/pages/.old/v0.x/guide.book.js

@@ -0,0 +1,12 @@
+import { defineBook } from '../../../index.js'
+
+export default defineBook({
+  id: 'guide',
+  label: 'Guide',
+  icon: 'history_edu',
+  order: 1,
+  color: {
+    active: 'white',
+    inactive: 'white'
+  }
+})

package/src/pages/.old/v0.x/guide.index.js

@@ -0,0 +1,28 @@
+export default {
+  '/getting-started': {
+    config: {
+      icon: 'history',
+      status: 'done',
+      meta: {
+        description: {
+          'en-US': 'Getting Started - Archived v0.x documentation of Docsector Reader',
+          'pt-BR': 'Comecando - Documentacao arquivada v0.x do Docsector Reader'
+        }
+      },
+      book: 'guide',
+      menu: {
+        header: {
+          icon: 'history_edu',
+          label: 'Archived v0.x'
+        }
+      },
+      subpages: {
+        showcase: false
+      }
+    },
+    data: {
+      'en-US': { title: 'Getting Started v0.x' },
+      'pt-BR': { title: 'Comecando v0.x' }
+    }
+  }
+}

package/src/pages/guide/configuration.overview.en-US.md

@@ -9,10 +9,17 @@ branding: {
   logo: '/images/logo.png',   // Path to logo in public/
   name: 'My Project',         // Project name shown in sidebar
   version: 'v1.0.0',          // Current version badge
-  versions: ['v1.0.0']        // Version dropdown options
+  versions: [
+    { id: 'v1.0.0', current: true, released: false },
+    { id: 'v0.x', released: true, status: 'deprecated' }
+  ] // Version dropdown options
 }
 ```
 
+The current version keeps unprefixed routes such as `/guide/getting-started/overview/`. Archived major versions can live under `src/pages/.old/&#123;version&#125;/` using the same book registry and Markdown layout, and are exposed at `/<version>/...`, for example `/v0.x/guide/getting-started/overview/`.
+
+Every version shows a release badge next to the version in the selector. Released versions default to `released`; versions with `released: false` or `status: 'draft'` default to `draft`; versions with `status: 'deprecated'` or `deprecated: true` default to `deprecated` in red. Use `badge: &#123; label, color, textColor &#125;` to customize the badge.
+
 The `logo` path is relative to the `public/` folder. Recommended size: **85×85px**.
 
 ## Links
@@ -84,7 +91,11 @@ export default &#123;
     logo: '/images/logo.png',
     name: 'Acme Docs',
     version: 'v2.1.0',
-    versions: ['v2.1.0', 'v2.0.0', 'v1.0.0']
+    versions: [
+      &#123; id: 'v2.1.0', current: true, released: false &#125;,
+      &#123; id: 'v2.0.0', released: true &#125;,
+      &#123; id: 'v1.0.0', released: true, status: 'deprecated' &#125;
+    ]
   &#125;,
   links: &#123;
     github: 'https://github.com/acme/acme',

package/src/pages/guide/configuration.overview.pt-BR.md

@@ -9,10 +9,17 @@ branding: {
   logo: '/images/logo.png',   // Caminho do logo em public/
   name: 'Meu Projeto',        // Nome exibido na sidebar
   version: 'v1.0.0',          // Badge de versão atual
-  versions: ['v1.0.0']        // Opções do dropdown de versão
+  versions: [
+    { id: 'v1.0.0', current: true, released: false },
+    { id: 'v0.x', released: true, status: 'deprecated' }
+  ] // Opções do dropdown de versão
 }
 ```
 
+A versão atual mantém rotas sem prefixo, como `/guide/getting-started/overview/`. Versões major arquivadas podem ficar em `src/pages/.old/&#123;version&#125;/` usando o mesmo layout de book registry e Markdown, e são expostas em `/<version>/...`, por exemplo `/v0.x/guide/getting-started/overview/`.
+
+Toda versão mostra um badge de release ao lado da versão no seletor. Versões lançadas usam `released` por padrão; versões com `released: false` ou `status: 'draft'` usam `draft`; versões com `status: 'deprecated'` ou `deprecated: true` usam `deprecated` em vermelho. Use `badge: &#123; label, color, textColor &#125;` para customizar o badge.
+
 O caminho do `logo` é relativo à pasta `public/`. Tamanho recomendado: **85×85px**.
 
 ## Links
@@ -84,7 +91,11 @@ export default &#123;
     logo: '/images/logo.png',
     name: 'Acme Docs',
     version: 'v2.1.0',
-    versions: ['v2.1.0', 'v2.0.0', 'v1.0.0']
+    versions: [
+      &#123; id: 'v2.1.0', current: true, released: false &#125;,
+      &#123; id: 'v2.0.0', released: true &#125;,
+      &#123; id: 'v1.0.0', released: true, status: 'deprecated' &#125;
+    ]
   &#125;,
   links: &#123;
     github: 'https://github.com/acme/acme',

package/src/pages/guide/pages-and-routing.overview.en-US.md

@@ -8,7 +8,8 @@ Documentation pages are defined in split registries such as `src/pages/guide.ind
 '/my-page': {
   config: {
     icon: 'description',
-    status: 'done',
+    status: 'new',
+    version: 'v2.1.0',
     book: 'guide',
     menu: {},
     subpages: { showcase: false }
@@ -23,7 +24,8 @@ Documentation pages are defined in split registries such as `src/pages/guide.ind
 ## Config Properties
 
 - **book** — Route prefix: `'guide'`, `'manual'`, or `'API'` (legacy `type` is still supported)
-- **status** — Page status: `'done'`, `'draft'`, or `'empty'`
+- **status** — Page status: `'done'`, `'draft'`, `'empty'`, or `'new'`; `new` is shown in green
+- **version** — Optional version where the page was introduced, shown under the last updated date as `New in: ...` (for example, `'v2.1.0'`)
 - **icon** — Material Design icon name shown in the sidebar
 - **menu** — Object controlling menu display (header, subheader, separator)
 - **subpages** — Enable additional tabs: `showcase`, `vs`
@@ -83,3 +85,5 @@ Routes are automatically generated from the page registry. A page with path `/my
 - `/guide/my-page/overview` — Main content tab
 - `/guide/my-page/showcase` — Showcase tab (if enabled)
 - `/guide/my-page/vs` — Comparison tab (if enabled)
+
+Archived major versions use the same structure under `src/pages/.old/{version}/`. A page registered in `src/pages/.old/v0.x/guide.index.js` produces `/v0.x/guide/my-page/overview` while the current version remains `/guide/my-page/overview`.

package/src/pages/guide/pages-and-routing.overview.pt-BR.md

@@ -8,7 +8,8 @@ As páginas de documentação são definidas em registros separados, como `src/p
 '/minha-pagina': {
   config: {
     icon: 'description',
-    status: 'done',
+    status: 'new',
+    version: 'v2.1.0',
     book: 'guide',
     menu: {},
     subpages: { showcase: false }
@@ -23,7 +24,8 @@ As páginas de documentação são definidas em registros separados, como `src/p
 ## Propriedades do Config
 
 - **book** — Prefixo da rota: `'guide'`, `'manual'` ou `'API'` (compatível com `type` legado)
-- **status** — Status da página: `'done'`, `'draft'` ou `'empty'`
+- **status** — Status da página: `'done'`, `'draft'`, `'empty'` ou `'new'`; `new` é exibido em verde
+- **version** — Versão opcional em que a página foi introduzida, exibida abaixo da data de última atualização como `Novo em: ...` (por exemplo, `'v2.1.0'`)
 - **icon** — Nome do ícone Material Design exibido no menu lateral
 - **menu** — Objeto controlando exibição do menu (header, subheader, separator)
 - **subpages** — Ativar abas adicionais: `showcase`, `vs`
@@ -83,3 +85,5 @@ Rotas são geradas automaticamente a partir do registro de páginas. Uma página
 - `/guide/my-page/overview` — Aba de conteúdo principal
 - `/guide/my-page/showcase` — Aba de demonstração (se habilitada)
 - `/guide/my-page/vs` — Aba de comparação (se habilitada)
+
+Versões major arquivadas usam a mesma estrutura em `src/pages/.old/{version}/`. Uma página registrada em `src/pages/.old/v0.x/guide.index.js` produz `/v0.x/guide/my-page/overview`, enquanto a versão atual continua em `/guide/my-page/overview`.