@gitpagedocs/cli 1.1.55 → 1.1.58

package/builders/version-config-builder.mjs

@@ -1,157 +1,186 @@
-/** 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";
-
-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 } : {}),
-    };
-    return buildMdRoute(versionId, id, pathByLang, meta.titles, meta.descriptions, routeOptions);
-  });
-}
-
-function buildVersionVideoRoutes(versionId) {
-  return [1, 2, 3, 4].map((id) =>
-    buildVideoRoute(
-      versionId,
-      id + 7,
-      "youtube",
-      VIDEO_IDS[id - 1],
-      VIDEO_METAS[id].title,
-      VIDEO_METAS[id].description,
-    )
-  );
-}
-
-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,
-    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"
- * @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",
-      },
-      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-source-viewer": buildVersionSourceViewerRoutes(),
-    "routes-html": [],
-    "routes-video": buildVersionVideoRoutes(versionId),
-    "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,
-  };
-}
+/** 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
 
@@ -151,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\` | local \`path\` or external \`url\` |
+| 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 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
+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)
 
@@ -179,7 +181,7 @@ The version config can render a **Source code** container through \`routes-sourc
 
 ## 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.
@@ -295,9 +297,9 @@ Supported adapters:
     {
       "id": 6,
       "path": {
-        "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"
+        "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",
@@ -344,10 +346,10 @@ Behavior:
 
 \`VersionControl.versions\` defines:
 
-- \`id\`
-- \`path\`
-- optional metadata links (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
-- optional source viewer metadata (\`source-viewer\`, \`source-viewer-path\`)
+- \`id\`
+- \`path\`
+- optional metadata links (\`ProjectLink\`, \`branch\`, \`release\`, \`commit\`)
+- optional source viewer metadata (\`source-viewer\`, \`source-viewer-path\`)
 
 ## Navigation
 
@@ -366,15 +368,15 @@ 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-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-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 }\`
+- \`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\`.
 
@@ -390,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) or \`url\` for external URLs. When \`url\` is set, the iframe loads the external page; no local file is generated.
+- **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

@@ -137,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\` local 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
 
-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
+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)
 
@@ -198,10 +198,10 @@ Claves principales:
 
 \`VersionControl.versions\` define:
 
-- \`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\`)
+- \`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,15 +220,15 @@ 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-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-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 }\`
+- \`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\`.
 
@@ -244,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) o \`url\` para URLs externas. Con \`url\`, el iframe carga la pagina externa; no se genera archivo local.
+- **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

@@ -137,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\` local 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
 
-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
+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)
 
@@ -198,10 +198,10 @@ Principais chaves:
 
 \`VersionControl.versions\` define:
 
-- \`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\`)
+- \`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,15 +220,15 @@ 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-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-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 }\`
+- \`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\`.
 
@@ -244,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) ou \`url\` para URLs externas. Com \`url\`, o iframe carrega a pagina externa; nenhum arquivo local e gerado.
+- **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,3 +1,3 @@
-export const PACKAGE_VERSION = "1.1.54";
-
-export const DOC_VERSIONS = [PACKAGE_VERSION];
+export const PACKAGE_VERSION = "1.1.58";
+
+export const DOC_VERSIONS = [PACKAGE_VERSION];