@gitpagedocs/cli 1.1.54 → 1.1.55

package/README.md

@@ -38,36 +38,36 @@ The AI-CLI implementation lives in `cli/ai/` (relocated from the frontend so the
 
 ```
 cli/
-├── index.mjs                          # Node entry (bootstraps TS presentation via tsx)
-├── package.json                       # the published `gitpagedocs` package
-├── ai/                                # AI documentation CLI (provider/model/paths → markdown)
-├── contracts/                         # Stable contracts for external tooling
-│   └── doc-versions.mjs
-│
-├── presentation/                      # Interface/composition root
-│   ├── index.ts
-│   ├── options/
-│   └── ui/
-│
-├── application/                       # Use-cases and ports
-│   ├── config-only/handler.mjs
-│   ├── home/handler.mjs
-│   ├── report/config-only-reporter.mjs
-│   ├── use-cases/dispatch-mode.ts
-│   └── ports/cli-runtime-ports.ts
-│
-├── domain/                            # Business rules
-│   └── services/sanitize-segment.mjs
-│
-├── infrastructure/                    # Side effects and adapters
-│   ├── config-only/runtime.mjs
-│   └── home/runtime.mjs
-│
-├── builders/                          # Pure config builders
-├── data/                              # Constants and metadata
-├── content/                           # Static docs content
-├── runtime/                           # Low-level runtime helpers
-└── home/                              # Home templates/files
+|-- index.mjs                          # Node entry (bootstraps TS presentation via tsx)
+|-- package.json                       # the published `gitpagedocs` package
+|-- ai/                                # AI documentation CLI (provider/model/paths → markdown)
+|-- contracts/                         # Stable contracts for external tooling
+|   `-- doc-versions.mjs
+|
+|-- presentation/                      # Interface/composition root
+|   |-- index.ts
+|   |-- options/
+|   `-- ui/
+|
+|-- application/                       # Use-cases and ports
+|   |-- config-only/handler.mjs
+|   |-- home/handler.mjs
+|   |-- report/config-only-reporter.mjs
+|   |-- use-cases/dispatch-mode.ts
+|   `-- ports/cli-runtime-ports.ts
+|
+|-- domain/                            # Business rules
+|   `-- services/sanitize-segment.mjs
+|
+|-- infrastructure/                    # Side effects and adapters
+|   |-- config-only/runtime.mjs
+|   `-- home/runtime.mjs
+|
+|-- builders/                          # Pure config builders
+|-- data/                              # Constants and metadata
+|-- content/                           # Static docs content
+|-- runtime/                           # Low-level runtime helpers
+`-- home/                              # Home templates/files
 ```
 
 ## SOLID Principles

package/builders/config-orchestrator.mjs

@@ -5,7 +5,6 @@ import { DOCS } from "../content/docs.mjs";
 import { DOC_VERSIONS } from "../data/version-constants.mjs";
 import { buildRootConfig } from "./root-config-builder.mjs";
 import { buildVersionConfig } from "./version-config-builder.mjs";
-import { generateSourceViewerHtml } from "./source-viewer.mjs";
 
 /**
  * Build all config artifacts (root, layouts, versions, docs).
@@ -19,11 +18,6 @@ export function buildConfigArtifacts(options = {}) {
   const layoutsConfig = { layouts: LAYOUTS };
   const fallbackLayoutsConfig = { layouts: FALLBACK_LAYOUTS };
 
-  const sourceViewerHtml = generateSourceViewerHtml(root);
-  const docsHtml = {
-    sourceViewer: { pt: sourceViewerHtml, en: sourceViewerHtml, es: sourceViewerHtml },
-  };
-
   const versionConfigs = {};
   for (const versionId of DOC_VERSIONS) {
     versionConfigs[versionId] = buildVersionConfig(versionId);
@@ -34,7 +28,7 @@ export function buildConfigArtifacts(options = {}) {
     layoutsConfig,
     fallbackLayoutsConfig,
     docs: DOCS,
-    docsHtml,
+    docsHtml: {},
     versionConfigs,
   };
 }

package/builders/root-config-builder.mjs

@@ -11,15 +11,16 @@ export function buildRootConfig(options = {}) {
   const useOfficialLayouts = !useLocalLayoutConfig;
   const githubOwner = options.githubOwner;
   const githubRepo = options.githubRepo;
-  const repositorySearchHome = false;
+  const repositorySearchHome = true;
   const renderingUrl =
     githubOwner && githubRepo
       ? `https://${githubOwner}.github.io/${githubRepo}/`
       : "https://vidigal-code.github.io/git-page-docs/";
-  const projectLink =
-    githubOwner && githubRepo
-      ? `https://github.com/${githubOwner}/${githubRepo}`
-      : "https://github.com/Vidigal-code/git-page-docs";
+  const projectLink =
+    githubOwner && githubRepo
+      ? `https://github.com/${githubOwner}/${githubRepo}`
+      : "https://github.com/Vidigal-code/git-page-docs";
+  const sourceViewerPath = `${projectLink}/tree/main`;
 
   const versionEntries = DOC_VERSIONS.map((id) => ({
     id,
@@ -28,10 +29,12 @@ export function buildRootConfig(options = {}) {
     PathConfig: `gitpagedocs/docs/versions/${id}/config.json`,
     PreviewProject: "",
     UpdateDate: "",
-    branch: "",
-    release: "",
-    commit: "",
-  }));
+    branch: "",
+    release: "",
+    commit: "",
+    "source-viewer": true,
+    "source-viewer-path": sourceViewerPath,
+  }));
 
   const baseSiteConfig = getDefaultSiteConfig(DOCS, projectLink);
 

package/builders/route-builders.mjs

@@ -109,3 +109,28 @@ export function buildVideoRoute(versionId, routeId, videoType, pathVideo, titles
   if (authorization !== undefined) obj.authorization = authorization;
   return obj;
 }
+
+export function buildAudioRoute(versionId, routeId, audioType, pathAudio, titles, descriptions, options = {}) {
+  const base = buildVideoRoute(versionId, routeId, audioType, pathAudio, titles, descriptions, options);
+  const audioTypeByLang = typeof audioType === "string" ? { pt: audioType, en: audioType, es: audioType } : audioType;
+  const pathAudioByLang = typeof pathAudio === "string" ? { pt: pathAudio, en: pathAudio, es: pathAudio } : pathAudio;
+  const { video, ...rest } = base;
+  return {
+    ...rest,
+    audio: { audioType: audioTypeByLang, pathAudio: pathAudioByLang },
+  };
+}
+
+export function buildSourceViewerRoute(routeId, sourceViewerPath, titles, descriptions, options = {}) {
+  const base = buildMdRoute("", routeId, {}, titles, descriptions, {
+    ...options,
+    fullscreenEnabled: false,
+    RouteguideBrand: false,
+  });
+  delete base.path;
+  return {
+    ...base,
+    "source-viewer": true,
+    "source-viewer-path": sourceViewerPath,
+  };
+}

package/builders/theme-template.mjs

@@ -9,7 +9,7 @@ export function createThemeTemplate(layout, themeColors = THEME_COLORS) {
     id: layout.id,
     name: layout.name,
     author: layout.author,
-    version: "1.0.0",
+    version: "1.1.54",
     mode: layout.mode,
     supportsLightAndDarkModes: layout.supportsLightAndDarkModes,
     colors,

package/builders/version-config-builder.mjs

@@ -3,8 +3,8 @@
 import {
   ROUTE_PATHS,
   VIDEO_IDS,
+  AUDIO_IDS,
   PAGE2_AUDIO,
-  SOURCE_VIEWER_META,
 } from "../data/path-mappings.mjs";
 import {
   ROUTE_META_ID1,
@@ -17,9 +17,11 @@ import {
   VIDEO_META_ID2,
   VIDEO_META_ID3,
   VIDEO_META_ID4,
+  AUDIO_META_ID12,
+  SOURCE_VIEWER_META,
   DEFAULT_HIERARCHY,
 } from "../data/route-metas.mjs";
-import { buildMdRoute, buildHtmlRoute, buildVideoRoute } from "./route-builders.mjs";
+import { buildAudioRoute, buildMdRoute, buildSourceViewerRoute, buildVideoRoute } from "./route-builders.mjs";
 
 const ROUTE_METAS = {
   1: ROUTE_META_ID1,
@@ -43,93 +45,93 @@ function buildVersionMdRoutes(versionId) {
     };
     const routeOptions = {
       ...(id === 2 ? { audio: PAGE2_AUDIO } : {}),
-      ...(id === 3 ? { authorization: { requiredRoles: ["maintainer"] } } : {}),
-      ...(id === 6
-        ? {
-            authorization: {
-              accessKeyId: "docs-key",
-              requiredRoles: ["maintainer"],
-              requireExternalAuth: true,
-              allowedProviders: ["authjs", "clerk", "firebase", "jwt"],
-            },
-          }
-        : {}),
     };
     return buildMdRoute(versionId, id, pathByLang, meta.titles, meta.descriptions, routeOptions);
   });
 }
 
-function buildVersionHtmlRoutes(versionId) {
-  const base = `gitpagedocs/docs/versions/${versionId}`;
-  const pathByLangSource = {
-    pt: `${base}/pt/source-viewer`,
-    en: `${base}/en/source-viewer`,
-    es: `${base}/es/source-viewer`,
-  };
-  return [
-    buildHtmlRoute(versionId, 1, pathByLangSource, SOURCE_VIEWER_META.titles, SOURCE_VIEWER_META.descriptions, {
-      container: "full",
-      blockLink: true,
-      authorization: { accessKeyId: "source-viewer-key" },
-    }),
-  ];
-}
-
 function buildVersionVideoRoutes(versionId) {
   return [1, 2, 3, 4].map((id) =>
     buildVideoRoute(
       versionId,
-      id,
+      id + 7,
       "youtube",
       VIDEO_IDS[id - 1],
       VIDEO_METAS[id].title,
       VIDEO_METAS[id].description,
-      {
-        authorization: {
-          requireExternalAuth: true,
-          allowedProviders: ["authjs", "clerk", "firebase", "jwt"],
-        },
-      },
     )
   );
 }
 
+function buildVersionAudioRoutes(versionId) {
+  return [
+    buildAudioRoute(
+      versionId,
+      AUDIO_META_ID12.id,
+      "youtube",
+      AUDIO_IDS[0],
+      AUDIO_META_ID12.title,
+      AUDIO_META_ID12.description,
+    ),
+  ];
+}
+
+function buildVersionSourceViewerRoutes() {
+  return [
+    buildSourceViewerRoute(
+      SOURCE_VIEWER_META.id,
+      "https://github.com/Vidigal-code/git-page-docs/tree/main",
+      SOURCE_VIEWER_META.titles,
+      SOURCE_VIEWER_META.descriptions,
+    ),
+  ];
+}
+
 function buildVersionMenus(versionId) {
   const base = `gitpagedocs/docs/versions/${versionId}`;
   const menuMd = [1, 2, 3, 4, 5, 6].map((id) => ({
-    id: id,
+    id,
     pt: { title: ROUTE_METAS[id].titles.pt, "path-click": `${base}/pt/${ROUTE_PATHS[id].pt}` },
     en: { title: ROUTE_METAS[id].titles.en, "path-click": `${base}/en/${ROUTE_PATHS[id].en}` },
     es: { title: ROUTE_METAS[id].titles.es, "path-click": `${base}/es/${ROUTE_PATHS[id].es}` },
   }));
-  const menuHtml = [
+  const menuVideo = [1, 2, 3, 4].map((id) => ({
+    id: id + 7,
+    pt: { title: `${VIDEO_METAS[id].title.pt.slice(0, 40)}...`, "path-click": `page:${id + 7}` },
+    en: { title: `${VIDEO_METAS[id].title.en.slice(0, 40)}...`, "path-click": `page:${id + 7}` },
+    es: { title: `${VIDEO_METAS[id].title.es.slice(0, 40)}...`, "path-click": `page:${id + 7}` },
+  }));
+  const menuAudio = [
     {
-      id: 1,
-      pt: { title: "Código fonte", "path-click": `${base}/pt/source-viewer` },
-      en: { title: "Source code", "path-click": `${base}/en/source-viewer` },
-      es: { title: "Código fuente", "path-click": `${base}/es/source-viewer` },
+      id: AUDIO_META_ID12.id,
+      pt: { title: AUDIO_META_ID12.title.pt, "path-click": `page:${AUDIO_META_ID12.id}` },
+      en: { title: AUDIO_META_ID12.title.en, "path-click": `page:${AUDIO_META_ID12.id}` },
+      es: { title: AUDIO_META_ID12.title.es, "path-click": `page:${AUDIO_META_ID12.id}` },
     },
   ];
-  const menuVideo = [1, 2, 3, 4].map((id) => ({
-    id: id,
-    pt: { title: VIDEO_METAS[id].title.pt.slice(0, 40) + "...", "path-click": `page:${id}` },
-    en: { title: VIDEO_METAS[id].title.en.slice(0, 40) + "...", "path-click": `page:${id}` },
-    es: { title: VIDEO_METAS[id].title.es.slice(0, 40) + "...", "path-click": `page:${id}` },
-  }));
-  return { md: menuMd, html: menuHtml, video: menuVideo };
+  const menuSourceViewer = [
+    {
+      id: SOURCE_VIEWER_META.id,
+      pt: { title: SOURCE_VIEWER_META.titles.pt, "path-click": `page:${SOURCE_VIEWER_META.id}` },
+      en: { title: SOURCE_VIEWER_META.titles.en, "path-click": `page:${SOURCE_VIEWER_META.id}` },
+      es: { title: SOURCE_VIEWER_META.titles.es, "path-click": `page:${SOURCE_VIEWER_META.id}` },
+    },
+  ];
+  return { md: menuMd, sourceViewer: menuSourceViewer, html: [], video: menuVideo, audio: menuAudio };
 }
 
 /**
  * Build version config for a single doc version.
- * @param {string} versionId - e.g. "1.0.0", "1.1.0", "1.1.1"
- * @returns {object} Version config with routes-md, routes-html, routes-video, menus, hierarchy
+ * @param {string} versionId - e.g. "1.1.54"
+ * @returns {object} Version config with routes, menus, and hierarchy
  */
 export function buildVersionConfig(versionId) {
+  const menus = buildVersionMenus(versionId);
+
   return {
     auth: {
       accessKeys: {
         "docs-key": "open-gitpagedocs-docs",
-        "source-viewer-key": "open-source-viewer",
       },
       rolesStorageKey: "git-page-docs:route-auth:roles",
       providers: [
@@ -140,11 +142,15 @@ export function buildVersionConfig(versionId) {
       ],
     },
     "routes-md": buildVersionMdRoutes(versionId),
-    "routes-html": buildVersionHtmlRoutes(versionId),
+    "routes-source-viewer": buildVersionSourceViewerRoutes(),
+    "routes-html": [],
     "routes-video": buildVersionVideoRoutes(versionId),
-    "menus-header-md": buildVersionMenus(versionId).md,
-    "menus-header-html": buildVersionMenus(versionId).html,
-    "menus-header-video": buildVersionMenus(versionId).video,
+    "routes-audio": buildVersionAudioRoutes(versionId),
+    "menus-header-md": menus.md,
+    "menus-header-source-viewer": menus.sourceViewer,
+    "menus-header-html": menus.html,
+    "menus-header-video": menus.video,
+    "menus-header-audio": menus.audio,
     hierarchyPage: DEFAULT_HIERARCHY,
     hierarchyMenu: DEFAULT_HIERARCHY,
   };

package/content/docs-en.mjs

@@ -144,7 +144,6 @@ Install globally with \`npm install -g gitpagedocs\`, or run one-off with \`npx
 - \`gitpagedocs/icon.svg\` – default icon
 - \`gitpagedocs/docs/versions/<ver>/config.json\` – per-version routes
 - \`gitpagedocs/docs/versions/<ver>/{en,pt,es}/*.md\` – markdown docs
-- \`gitpagedocs/docs/versions/<ver>/{en,pt,es}/source-viewer\` – GitHub-style source code viewer
 - \`gitpagedocs/layouts/\` – only with \`--layoutconfig\`
 
 ## Content types
@@ -152,20 +151,20 @@ Install globally with \`npm install -g gitpagedocs\`, or run one-off with \`npx
 | Type | Config key | Description |
 |------|------------|-------------|
 | Markdown | \`routes-md\` | .md files with \`path\` per language |
-| HTML | \`routes-html\` | \`path\` (e.g. source-viewer) or \`url\` for external |
+| HTML | \`routes-html\` | local \`path\` or external \`url\` |
 | Video | \`routes-video\` | \`video.pathVideo\`, \`video.videoType\` |
 | Audio | \`routes-audio\` | \`audio.pathAudio\`, \`audio.audioType\` |
 
 ## Source code viewer
 
-The CLI generates a **Source code** page per version. It scans \`src/\`, \`cli/\`, and root files (README.md, package.json, next.config.ts, etc.) and builds a GitHub-style dark viewer with:
-
-- File tree sidebar with folder collapse/expand
-- Search filter for files
-- Syntax highlighting (TypeScript, JavaScript, JSON, CSS, Markdown)
-- Copy button, line numbers
-- README.md preview/code toggle
-- Expand all / Collapse all controls
+The version config can render a **Source code** container through \`routes-source-viewer\` and \`menus-header-source-viewer\`. The viewer reads GitHub repository trees at runtime and applies the current documentation theme.
+
+- Repository tree from \`source-viewer-path\`; branch defaults to \`main\`
+- Folder navigation and file filtering
+- GitHub-style directory listing
+- Code rendering with line numbers
+- Markdown preview/code toggle, including \`README.md\`
+- Collapsible folders in the sidebar
 
 ## Config keys (site)
 
@@ -296,9 +295,9 @@ Supported adapters:
     {
       "id": 6,
       "path": {
-        "en": "gitpagedocs/docs/versions/1.1.1/en/authorized-routes.md",
-        "pt": "gitpagedocs/docs/versions/1.1.1/pt/authorized-routes.md",
-        "es": "gitpagedocs/docs/versions/1.1.1/es/authorized-routes.md"
+        "en": "gitpagedocs/docs/versions/1.1.54/en/authorized-routes.md",
+        "pt": "gitpagedocs/docs/versions/1.1.54/pt/authorized-routes.md",
+        "es": "gitpagedocs/docs/versions/1.1.54/es/authorized-routes.md"
       },
       "authorization": {
         "accessKeyId": "docs-key",
@@ -345,9 +344,10 @@ Behavior:
 
 \`VersionControl.versions\` defines:
 
-- \`id\`
-- \`path\`
-- optional metadata links (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- \`id\`
+- \`path\`
+- optional metadata links (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- optional source viewer metadata (\`source-viewer\`, \`source-viewer-path\`)
 
 ## Navigation
 
@@ -366,14 +366,15 @@ Behavior:
 
 Version configs support multiple content types:
 
-- \`routes-md\`: Markdown routes with optional \`title\`, \`description\` (centered via \`titlePosition\`, \`descriptionPosition\`)
-- \`routes-html\`: HTML page paths per language
+- \`routes-md\`: Markdown routes with optional \`title\`, \`description\` (centered via \`titlePosition\`, \`descriptionPosition\`)
+- \`routes-source-viewer\`: Source viewer containers with \`source-viewer: true\` and \`source-viewer-path\`
+- \`routes-html\`: HTML page paths per language
 - \`routes-video\`: Video config with \`video.videoType\` (youtube, vimeo, mp4, etc.) and \`video.pathVideo\`
 - \`routes-audio\`: Audio config with \`audio.audioType\` (youtube, mp3, etc.) and \`audio.pathAudio\`
 - \`authorization\` (md/html/video): route guard by access key, roles, and external auth
-- \`menus-header-md\`, \`menus-header-html\`, \`menus-header-video\`, \`menus-header-audio\`: menus per type
-- \`hierarchyPage\`: container order on page \`{ md: 0, html: 1, video: 2, audio: 3 }\`
-- \`hierarchyMenu\`: menu section order \`{ md: 0, html: 1, video: 2, audio: 3 }\`
+- \`menus-header-md\`, \`menus-header-source-viewer\`, \`menus-header-html\`, \`menus-header-video\`, \`menus-header-audio\`: menus per type
+- \`hierarchyPage\`: container order on page \`{ md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 }\`
+- \`hierarchyMenu\`: menu section order \`{ md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 }\`
 
 Each route can include \`title\`, \`description\` (per language), \`titleCss\`, \`titlePosition: "center"\`, \`descriptionPosition: "center"\`, \`titleIsVisible\`, \`descriptionIsVisible\`.
 
@@ -389,7 +390,7 @@ Per-route options for \`routes-md\`, \`routes-html\`, \`routes-video\`, and \`ro
 ## Content types: path vs url (HTML)
 
 - **Markdown (\`routes-md\`)**: always uses \`path\` pointing to local \`.md\` files.
-- **HTML (\`routes-html\`)**: uses \`path\` for local HTML files (no \`.html\` extension in config, e.g. \`source-viewer\`) or \`url\` for external URLs. When \`url\` is set, the iframe loads the external page; no local file is generated. The CLI generates a **Source code** viewer (GitHub-style) per version.
+- **HTML (\`routes-html\`)**: uses \`path\` for local HTML files (no \`.html\` extension in config) or \`url\` for external URLs. When \`url\` is set, the iframe loads the external page; no local file is generated.
 - **Video (\`routes-video\`)**: uses \`video.pathVideo\` and \`video.videoType\` (youtube, vimeo, mp4, etc.).
 - **Audio (\`routes-audio\`)**: uses \`audio.pathAudio\` and \`audio.audioType\` (youtube, mp3, etc.). No autoplay by default.
 

package/content/docs-es.mjs

@@ -130,7 +130,6 @@ Referencia completa de opciones CLI, claves de configuracion y funciones del run
 - \`gitpagedocs/icon.svg\` – icono por defecto
 - \`gitpagedocs/docs/versions/<ver>/config.json\` – rutas por version
 - \`gitpagedocs/docs/versions/<ver>/{en,pt,es}/*.md\` – docs en markdown
-- \`gitpagedocs/docs/versions/<ver>/{en,pt,es}/source-viewer\` – visor de codigo (estilo GitHub)
 - \`gitpagedocs/layouts/\` – solo con \`--layoutconfig\`
 
 ## Tipos de contenido
@@ -138,20 +137,20 @@ Referencia completa de opciones CLI, claves de configuracion y funciones del run
 | Tipo | Clave config | Descripcion |
 |------|--------------|-------------|
 | Markdown | \`routes-md\` | Archivos .md con \`path\` por idioma |
-| HTML | \`routes-html\` | \`path\` (ej: source-viewer) o \`url\` externa |
+| HTML | \`routes-html\` | \`path\` local o \`url\` externa |
 | Video | \`routes-video\` | \`video.pathVideo\`, \`video.videoType\` |
 | Audio | \`routes-audio\` | \`audio.pathAudio\`, \`audio.audioType\` |
 
 ## Visor de codigo fuente
 
-La CLI genera una pagina **Codigo fuente** por version. Escanea \`src/\`, \`cli/\` y archivos raiz (README.md, package.json, next.config.ts, etc.) y construye un visor estilo GitHub en modo oscuro con:
-
-- Arbol de archivos en barra lateral con expandir/colapsar carpetas
-- Filtro de busqueda
-- Resaltado de sintaxis (TypeScript, JavaScript, JSON, CSS, Markdown)
-- Boton copiar, numeros de linea
-- Alternar vista previa/codigo del README.md
-- Controles Expandir todo / Colapsar todo
+El config de version puede renderizar un contenedor **Codigo fuente** via \`routes-source-viewer\` y \`menus-header-source-viewer\`. El viewer lee el arbol del repositorio en GitHub en tiempo de ejecucion y aplica el tema actual de la documentacion.
+
+- Arbol del repositorio desde \`source-viewer-path\`; la branch por defecto es \`main\`
+- Navegacion por carpetas y filtro de archivos
+- Listado de directorios estilo GitHub
+- Renderizado de codigo con numeros de linea
+- Alternancia vista previa/codigo para Markdown, incluido \`README.md\`
+- Carpetas colapsables en la barra lateral
 
 ## Claves de config (site)
 
@@ -199,9 +198,10 @@ Claves principales:
 
 \`VersionControl.versions\` define:
 
-- \`id\`: identificador de version
-- \`path\`: ruta de config de version
-- links opcionales (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- \`id\`: identificador de version
+- \`path\`: ruta de config de version
+- links opcionales (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- metadatos opcionales del source viewer (\`source-viewer\`, \`source-viewer-path\`)
 
 ## Navegacion y rutas
 
@@ -220,14 +220,15 @@ Claves principales:
 
 Los configs de version soportan multiples tipos:
 
-- \`routes-md\`: Rutas markdown con \`title\`, \`description\` (centrados via \`titlePosition\`, \`descriptionPosition\`)
-- \`routes-html\`: Rutas de paginas HTML por idioma
+- \`routes-md\`: Rutas markdown con \`title\`, \`description\` (centrados via \`titlePosition\`, \`descriptionPosition\`)
+- \`routes-source-viewer\`: Contenedores de codigo fuente con \`source-viewer: true\` y \`source-viewer-path\`
+- \`routes-html\`: Rutas de paginas HTML por idioma
 - \`routes-video\`: Config de video con \`video.videoType\` (youtube, vimeo, mp4, etc.) y \`video.pathVideo\`
 - \`routes-audio\`: Config de audio con \`audio.audioType\` (youtube, mp3, etc.) y \`audio.pathAudio\`
 - \`authorization\` (md/html/video): guardia de acceso por clave, roles y autenticacion externa
-- \`menus-header-md\`, \`menus-header-html\`, \`menus-header-video\`, \`menus-header-audio\`: menus por tipo
-- \`hierarchyPage\`: orden de contenedores en la pagina \`{ md: 0, html: 1, video: 2, audio: 3 }\`
-- \`hierarchyMenu\`: orden de secciones del menu \`{ md: 0, html: 1, video: 2, audio: 3 }\`
+- \`menus-header-md\`, \`menus-header-source-viewer\`, \`menus-header-html\`, \`menus-header-video\`, \`menus-header-audio\`: menus por tipo
+- \`hierarchyPage\`: orden de contenedores en la pagina \`{ md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 }\`
+- \`hierarchyMenu\`: orden de secciones del menu \`{ md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 }\`
 
 Cada ruta puede incluir \`title\`, \`description\` (por idioma), \`titleCss\`, \`titlePosition: "center"\`, \`descriptionPosition: "center"\`, \`titleIsVisible\`, \`descriptionIsVisible\`.
 
@@ -243,7 +244,7 @@ Opciones por ruta en \`routes-md\`, \`routes-html\` y \`routes-video\`:
 ## Tipos de contenido: path vs url (HTML)
 
 - **Markdown (\`routes-md\`)**: usa \`path\` apuntando a archivos \`.md\` locales.
-- **HTML (\`routes-html\`)**: usa \`path\` para archivos HTML locales (sin extension .html en config, ej: \`source-viewer\`) o \`url\` para URLs externas. Con \`url\`, el iframe carga la pagina externa; no se genera archivo local. La CLI genera un visor **Codigo fuente** (estilo GitHub) por version.
+- **HTML (\`routes-html\`)**: usa \`path\` para archivos HTML locales (sin extension .html en config) o \`url\` para URLs externas. Con \`url\`, el iframe carga la pagina externa; no se genera archivo local.
 - **Video (\`routes-video\`)**: usa \`video.pathVideo\` y \`video.videoType\` (youtube, vimeo, mp4, etc.).
 
 ## Variables de entorno

package/content/docs-pt.mjs

@@ -130,7 +130,6 @@ Referencia completa de opcoes da CLI, chaves de configuracao e recursos do runti
 - \`gitpagedocs/icon.svg\` – icone padrao
 - \`gitpagedocs/docs/versions/<ver>/config.json\` – rotas por versao
 - \`gitpagedocs/docs/versions/<ver>/{en,pt,es}/*.md\` – docs em markdown
-- \`gitpagedocs/docs/versions/<ver>/{en,pt,es}/source-viewer\` – visualizador de codigo (estilo GitHub)
 - \`gitpagedocs/layouts/\` – apenas com \`--layoutconfig\`
 
 ## Tipos de conteudo
@@ -138,20 +137,20 @@ Referencia completa de opcoes da CLI, chaves de configuracao e recursos do runti
 | Tipo | Chave config | Descricao |
 |------|--------------|-----------|
 | Markdown | \`routes-md\` | Arquivos .md com \`path\` por idioma |
-| HTML | \`routes-html\` | \`path\` (ex: source-viewer) ou \`url\` externa |
+| HTML | \`routes-html\` | \`path\` local ou \`url\` externa |
 | Video | \`routes-video\` | \`video.pathVideo\`, \`video.videoType\` |
 | Audio | \`routes-audio\` | \`audio.pathAudio\`, \`audio.audioType\` |
 
 ## Visualizador de codigo fonte
 
-A CLI gera uma pagina **Codigo fonte** por versao. Escaneia \`src/\`, \`cli/\` e arquivos raiz (README.md, package.json, next.config.ts, etc.) e constroi um visualizador estilo GitHub em modo escuro com:
-
-- Arvore de arquivos na lateral com expandir/recolher pastas
-- Filtro de busca
-- Destaque de sintaxe (TypeScript, JavaScript, JSON, CSS, Markdown)
-- Botao copiar, numeros de linha
-- Alternar preview/codigo do README.md
-- Controles Expandir tudo / Recolher tudo
+O config da versao pode renderizar um container **Codigo fonte** via \`routes-source-viewer\` e \`menus-header-source-viewer\`. O viewer le a arvore do repositorio no GitHub em tempo de execucao e aplica o tema atual da documentacao.
+
+- Arvore do repositorio a partir de \`source-viewer-path\`; a branch padrao e \`main\`
+- Navegacao por pastas e filtro de arquivos
+- Listagem de diretorios no estilo GitHub
+- Renderizacao de codigo com numeros de linha
+- Alternancia preview/codigo para Markdown, incluindo \`README.md\`
+- Pastas recolhiveis na lateral
 
 ## Chaves de config (site)
 
@@ -199,9 +198,10 @@ Principais chaves:
 
 \`VersionControl.versions\` define:
 
-- \`id\`: identificador da versao
-- \`path\`: caminho do config da versao
-- links opcionais (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- \`id\`: identificador da versao
+- \`path\`: caminho do config da versao
+- links opcionais (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- metadados opcionais do source viewer (\`source-viewer\`, \`source-viewer-path\`)
 
 ## Navegacao e rotas
 
@@ -220,14 +220,15 @@ Principais chaves:
 
 Configs de versao suportam multiplos tipos:
 
-- \`routes-md\`: Rotas markdown com \`title\`, \`description\` (centralizados via \`titlePosition\`, \`descriptionPosition\`)
-- \`routes-html\`: Caminhos de paginas HTML por idioma
+- \`routes-md\`: Rotas markdown com \`title\`, \`description\` (centralizados via \`titlePosition\`, \`descriptionPosition\`)
+- \`routes-source-viewer\`: Containers de codigo fonte com \`source-viewer: true\` e \`source-viewer-path\`
+- \`routes-html\`: Caminhos de paginas HTML por idioma
 - \`routes-video\`: Config de video com \`video.videoType\` (youtube, vimeo, mp4, etc.) e \`video.pathVideo\`
 - \`routes-audio\`: Config de audio com \`audio.audioType\` (youtube, mp3, etc.) e \`audio.pathAudio\`
 - \`authorization\` (md/html/video): guarda de acesso por chave, papeis e autenticacao externa
-- \`menus-header-md\`, \`menus-header-html\`, \`menus-header-video\`, \`menus-header-audio\`: menus por tipo
-- \`hierarchyPage\`: ordem dos containers na pagina \`{ md: 0, html: 1, video: 2, audio: 3 }\`
-- \`hierarchyMenu\`: ordem das secoes do menu \`{ md: 0, html: 1, video: 2, audio: 3 }\`
+- \`menus-header-md\`, \`menus-header-source-viewer\`, \`menus-header-html\`, \`menus-header-video\`, \`menus-header-audio\`: menus por tipo
+- \`hierarchyPage\`: ordem dos containers na pagina \`{ md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 }\`
+- \`hierarchyMenu\`: ordem das secoes do menu \`{ md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 }\`
 
 Cada rota pode incluir \`title\`, \`description\` (por idioma), \`titleCss\`, \`titlePosition: "center"\`, \`descriptionPosition: "center"\`, \`titleIsVisible\`, \`descriptionIsVisible\`.
 
@@ -243,7 +244,7 @@ Opcoes por rota em \`routes-md\`, \`routes-html\` e \`routes-video\`:
 ## Tipos de conteudo: path vs url (HTML)
 
 - **Markdown (\`routes-md\`)**: usa \`path\` apontando para arquivos \`.md\` locais.
-- **HTML (\`routes-html\`)**: usa \`path\` para arquivos HTML locais (sem extensao .html no config, ex: \`source-viewer\`) ou \`url\` para URLs externas. Com \`url\`, o iframe carrega a pagina externa; nenhum arquivo local e gerado. A CLI gera um visualizador **Codigo fonte** (estilo GitHub) por versao.
+- **HTML (\`routes-html\`)**: usa \`path\` para arquivos HTML locais (sem extensao .html no config) ou \`url\` para URLs externas. Com \`url\`, o iframe carrega a pagina externa; nenhum arquivo local e gerado.
 - **Video (\`routes-video\`)**: usa \`video.pathVideo\` e \`video.videoType\` (youtube, vimeo, mp4, etc.).
 
 ## Variaveis de ambiente

package/contracts/doc-versions.mjs

@@ -1 +1,3 @@
-export const DOC_VERSIONS = ["1.0.0", "1.1.0", "1.1.1"];
+export const PACKAGE_VERSION = "1.1.54";
+
+export const DOC_VERSIONS = [PACKAGE_VERSION];