@gitpagedocs/cli 1.1.54 → 1.1.56

package/builders/version-config-builder.mjs

@@ -1,151 +1,186 @@
-/** Build version config (routes, menus) for each doc version */
-
-import {
-  ROUTE_PATHS,
-  VIDEO_IDS,
-  PAGE2_AUDIO,
-  SOURCE_VIEWER_META,
-} from "../data/path-mappings.mjs";
-import {
-  ROUTE_META_ID1,
-  ROUTE_META_ID2,
-  ROUTE_META_ID3,
-  ROUTE_META_ID4,
-  ROUTE_META_ID5,
-  ROUTE_META_ID6,
-  VIDEO_META_ID1,
-  VIDEO_META_ID2,
-  VIDEO_META_ID3,
-  VIDEO_META_ID4,
-  DEFAULT_HIERARCHY,
-} from "../data/route-metas.mjs";
-import { buildMdRoute, buildHtmlRoute, buildVideoRoute } from "./route-builders.mjs";
-
-const ROUTE_METAS = {
-  1: ROUTE_META_ID1,
-  2: ROUTE_META_ID2,
-  3: ROUTE_META_ID3,
-  4: ROUTE_META_ID4,
-  5: ROUTE_META_ID5,
-  6: ROUTE_META_ID6,
-};
-const VIDEO_METAS = { 1: VIDEO_META_ID1, 2: VIDEO_META_ID2, 3: VIDEO_META_ID3, 4: VIDEO_META_ID4 };
-
-function buildVersionMdRoutes(versionId) {
-  const base = `gitpagedocs/docs/versions/${versionId}`;
-  return [1, 2, 3, 4, 5, 6].map((id) => {
-    const paths = ROUTE_PATHS[id];
-    const meta = ROUTE_METAS[id];
-    const pathByLang = {
-      pt: `${base}/pt/${paths.pt}`,
-      en: `${base}/en/${paths.en}`,
-      es: `${base}/es/${paths.es}`,
-    };
-    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,
-      "youtube",
-      VIDEO_IDS[id - 1],
-      VIDEO_METAS[id].title,
-      VIDEO_METAS[id].description,
-      {
-        authorization: {
-          requireExternalAuth: true,
-          allowedProviders: ["authjs", "clerk", "firebase", "jwt"],
-        },
-      },
-    )
-  );
-}
-
-function buildVersionMenus(versionId) {
-  const base = `gitpagedocs/docs/versions/${versionId}`;
-  const menuMd = [1, 2, 3, 4, 5, 6].map((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 = [
-    {
-      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` },
-    },
-  ];
-  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 };
-}
-
-/**
- * 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
- */
-export function buildVersionConfig(versionId) {
-  return {
-    auth: {
-      accessKeys: {
-        "docs-key": "open-gitpagedocs-docs",
-        "source-viewer-key": "open-source-viewer",
-      },
-      rolesStorageKey: "git-page-docs:route-auth:roles",
-      providers: [
-        { type: "authjs", enabled: true, sessionEndpoint: "/api/auth/session", rolesClaimPath: "user.roles" },
-        { type: "clerk", enabled: true, rolesClaimPath: "claims.publicMetadata.roles" },
-        { type: "firebase", enabled: true, tokenStorageKey: "git-page-docs:firebase-token", rolesClaimPath: "roles" },
-        { type: "jwt", enabled: true, tokenStorageKey: "git-page-docs:jwt-token", rolesClaimPath: "roles" },
-      ],
-    },
-    "routes-md": buildVersionMdRoutes(versionId),
-    "routes-html": buildVersionHtmlRoutes(versionId),
-    "routes-video": buildVersionVideoRoutes(versionId),
-    "menus-header-md": buildVersionMenus(versionId).md,
-    "menus-header-html": buildVersionMenus(versionId).html,
-    "menus-header-video": buildVersionMenus(versionId).video,
-    hierarchyPage: DEFAULT_HIERARCHY,
-    hierarchyMenu: DEFAULT_HIERARCHY,
-  };
-}
+/** Build version config (routes, menus) for each doc version */
+
+import {
+  ROUTE_PATHS,
+  VIDEO_IDS,
+  AUDIO_IDS,
+  PAGE2_AUDIO,
+} from "../data/path-mappings.mjs";
+import {
+  ROUTE_META_ID1,
+  ROUTE_META_ID2,
+  ROUTE_META_ID3,
+  ROUTE_META_ID4,
+  ROUTE_META_ID5,
+  ROUTE_META_ID6,
+  VIDEO_META_ID1,
+  VIDEO_META_ID2,
+  VIDEO_META_ID3,
+  VIDEO_META_ID4,
+  AUDIO_META_ID12,
+  SOURCE_VIEWER_META,
+  DEFAULT_HIERARCHY,
+} from "../data/route-metas.mjs";
+import { buildAudioRoute, buildMdRoute, buildSourceViewerRoute, buildVideoRoute } from "./route-builders.mjs";
+import { resolveSourceViewerPath } from "./project-links.mjs";
+
+/** Demo route protections showcasing the "Authorized Routes" feature. They are
+ * applied only to the official (non-parameterized) scaffold — user sites
+ * generated with --owner/--repo stay public, since visitors of those sites
+ * have no discoverable unlock recipe. */
+const EXTERNAL_AUTH_PROVIDERS = ["authjs", "clerk", "firebase", "jwt"];
+const DOCS_ACCESS_KEY_ID = "docs-key";
+const MAINTAINER_ROLE = "maintainer";
+const VIDEO_ROUTE_AUTHORIZATION = {
+  requireExternalAuth: true,
+  allowedProviders: EXTERNAL_AUTH_PROVIDERS,
+};
+
+const ROUTE_METAS = {
+  1: ROUTE_META_ID1,
+  2: ROUTE_META_ID2,
+  3: ROUTE_META_ID3,
+  4: ROUTE_META_ID4,
+  5: ROUTE_META_ID5,
+  6: ROUTE_META_ID6,
+};
+const VIDEO_METAS = { 1: VIDEO_META_ID1, 2: VIDEO_META_ID2, 3: VIDEO_META_ID3, 4: VIDEO_META_ID4 };
+
+function buildVersionMdRoutes(versionId, includeDemoAuthorization) {
+  const base = `gitpagedocs/docs/versions/${versionId}`;
+  return [1, 2, 3, 4, 5, 6].map((id) => {
+    const paths = ROUTE_PATHS[id];
+    const meta = ROUTE_METAS[id];
+    const pathByLang = {
+      pt: `${base}/pt/${paths.pt}`,
+      en: `${base}/en/${paths.en}`,
+      es: `${base}/es/${paths.es}`,
+    };
+    const routeOptions = {
+      ...(id === 2 ? { audio: PAGE2_AUDIO } : {}),
+      ...(includeDemoAuthorization && id === 3
+        ? { authorization: { requiredRoles: [MAINTAINER_ROLE] } }
+        : {}),
+      ...(includeDemoAuthorization && id === 6
+        ? {
+            authorization: {
+              accessKeyId: DOCS_ACCESS_KEY_ID,
+              requiredRoles: [MAINTAINER_ROLE],
+              requireExternalAuth: true,
+              allowedProviders: EXTERNAL_AUTH_PROVIDERS,
+            },
+          }
+        : {}),
+    };
+    return buildMdRoute(versionId, id, pathByLang, meta.titles, meta.descriptions, routeOptions);
+  });
+}
+
+function buildVersionVideoRoutes(versionId, includeDemoAuthorization) {
+  return [1, 2, 3, 4].map((id) =>
+    buildVideoRoute(
+      versionId,
+      id + 7,
+      "youtube",
+      VIDEO_IDS[id - 1],
+      VIDEO_METAS[id].title,
+      VIDEO_METAS[id].description,
+      includeDemoAuthorization ? { authorization: VIDEO_ROUTE_AUTHORIZATION } : {},
+    )
+  );
+}
+
+function buildVersionAudioRoutes(versionId) {
+  return [
+    buildAudioRoute(
+      versionId,
+      AUDIO_META_ID12.id,
+      "youtube",
+      AUDIO_IDS[0],
+      AUDIO_META_ID12.title,
+      AUDIO_META_ID12.description,
+    ),
+  ];
+}
+
+function buildVersionSourceViewerRoutes(options = {}) {
+  return [
+    buildSourceViewerRoute(
+      SOURCE_VIEWER_META.id,
+      resolveSourceViewerPath(options.githubOwner, options.githubRepo),
+      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,
+    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 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: 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 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.1.54"
+ * @param {object} [options] - { githubOwner, githubRepo } for the source-viewer link
+ * @returns {object} Version config with routes, menus, and hierarchy
+ */
+export function buildVersionConfig(versionId, options = {}) {
+  const includeDemoAuthorization = !options.githubOwner && !options.githubRepo;
+  const menus = buildVersionMenus(versionId);
+
+  return {
+    auth: {
+      accessKeys: {
+        "docs-key": "open-gitpagedocs-docs",
+      },
+      rolesStorageKey: "git-page-docs:route-auth:roles",
+      providers: [
+        { type: "authjs", enabled: true, sessionEndpoint: "/api/auth/session", rolesClaimPath: "user.roles" },
+        { type: "clerk", enabled: true, rolesClaimPath: "claims.publicMetadata.roles" },
+        { type: "firebase", enabled: true, tokenStorageKey: "git-page-docs:firebase-token", rolesClaimPath: "roles" },
+        { type: "jwt", enabled: true, tokenStorageKey: "git-page-docs:jwt-token", rolesClaimPath: "roles" },
+      ],
+    },
+    "routes-md": buildVersionMdRoutes(versionId, includeDemoAuthorization),
+    "routes-source-viewer": buildVersionSourceViewerRoutes(options),
+    "routes-html": [],
+    "routes-video": buildVersionVideoRoutes(versionId, includeDemoAuthorization),
+    "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

@@ -1,3 +1,5 @@
+import { PACKAGE_VERSION } from "../contracts/doc-versions.mjs";
+
 export const docsEn = {
     index: `# Git Page Docs
 
@@ -144,7 +146,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 +153,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:
+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.
 
-- 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
+- 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)
 
@@ -180,7 +181,7 @@ The CLI generates a **Source code** page per version. It scans \`src/\`, \`cli/\
 
 ## AI assistant
 
-The docs ship an AI assistant in two surfaces: an in-docs **chat drawer** (the ✨ button in the sidebar, enabled via \`site.AiChatEnabled\`) and a dedicated **\`/ai\` console** page.
+The docs ship an AI assistant in two surfaces: an in-docs **chat drawer** (the AI chat button in the sidebar, enabled via \`site.AiChatEnabled\`) and a dedicated **\`/ai\` console** page.
 
 - **14 providers** via one shared core: OpenAI, Anthropic, Gemini, OpenRouter, Ollama, Azure OpenAI, Mistral, DeepSeek, Cohere, Groq, xAI, Together, Fireworks, Perplexity.
 - **Model selection** — pick from each provider's catalog (\`gitpagedocs models <provider>\`) or type a custom id.
@@ -296,9 +297,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/${PACKAGE_VERSION}/en/authorized-routes.md",
+        "pt": "gitpagedocs/docs/versions/${PACKAGE_VERSION}/pt/authorized-routes.md",
+        "es": "gitpagedocs/docs/versions/${PACKAGE_VERSION}/es/authorized-routes.md"
       },
       "authorization": {
         "accessKeyId": "docs-key",
@@ -348,6 +349,7 @@ Behavior:
 - \`id\`
 - \`path\`
 - optional metadata links (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- optional source viewer metadata (\`source-viewer\`, \`source-viewer-path\`)
 
 ## Navigation
 
@@ -367,13 +369,14 @@ Behavior:
 Version configs support multiple content types:
 
 - \`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 +392,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:
+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 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
+- 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)
 
@@ -202,6 +201,7 @@ Claves principales:
 - \`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
 
@@ -221,13 +221,14 @@ Claves principales:
 Los configs de version soportan multiples tipos:
 
 - \`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:
+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 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
+- 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)
 
@@ -202,6 +201,7 @@ Principais chaves:
 - \`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
 
@@ -221,13 +221,14 @@ Principais chaves:
 Configs de versao suportam multiplos tipos:
 
 - \`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.56";
+
+export const DOC_VERSIONS = [PACKAGE_VERSION];