@gitpagedocs/cli 0.0.9 → 0.0.11

package/data/i18n-translations.mjs

@@ -1,20 +1,20 @@
 export const defaultTranslations = {
       notFound: {
-        title: { pt: "Pagina nao encontrada", en: "Page not found", es: "Pagina no encontrada" },
+        title: { pt: "Página não encontrada", en: "Page not found", es: "Página no encontrada" },
         description: {
-          pt: "A pagina de documentacao solicitada nao existe neste contexto de repositorio.",
+          pt: "A página de documentação solicitada não existe neste contexto de repositório.",
           en: "The requested documentation page does not exist in this repository context.",
-          es: "La pagina de documentacion solicitada no existe en este contexto de repositorio.",
+          es: "La página de documentación solicitada no existe en este contexto de repositorio.",
         },
-        returnHome: { pt: "Voltar para inicio", en: "Return Home", es: "Volver al inicio" },
+        returnHome: { pt: "Voltar para início", en: "Return Home", es: "Volver al inicio" },
       },
       navigation: {
         previous: { pt: "Voltar", en: "Previous", es: "Volver" },
-        next: { pt: "Proximo", en: "Next", es: "Siguiente" },
-        menuOpen: { pt: "Menu", en: "Menu", es: "Menu" },
+        next: { pt: "Próximo", en: "Next", es: "Siguiente" },
+        menuOpen: { pt: "Menu", en: "Menu", es: "Menú" },
         menuClose: { pt: "Fechar", en: "Close", es: "Cerrar" },
         browsePrev: { pt: "Anterior", en: "Previous", es: "Anterior" },
-        browseNext: { pt: "Proximo", en: "Next", es: "Siguiente" },
+        browseNext: { pt: "Próximo", en: "Next", es: "Siguiente" },
       },
       footer: { footerLabel: { pt: "Projeto", en: "Project", es: "Proyecto" } },
     };

package/data/menu-sections.mjs

@@ -0,0 +1,56 @@
+import { COMPOSED_PAGE_MENU } from "./composed-pages.mjs";
+
+export const MARKDOWN_MENU_SECTIONS = [
+  1,
+  2,
+  {
+    id: 1000,
+    routeId: 31,
+    titles: { en: "Guides", pt: "Guias", es: "Guías" },
+    submenus: [
+      {
+        id: 1001,
+        routeId: 32,
+        titles: { en: "Configure your site", pt: "Configure seu site", es: "Configura tu sitio" },
+        submenus: [13, 25, 16, 20],
+      },
+      {
+        id: 1002,
+        routeId: 33,
+        titles: { en: "Read and explore", pt: "Leia e explore", es: "Lee y explora" },
+        submenus: [22, 21, 24, 30, 40, COMPOSED_PAGE_MENU],
+      },
+      {
+        id: 1003,
+        routeId: 34,
+        titles: { en: "Automate and integrate", pt: "Automatize e integre", es: "Automatiza e integra" },
+        submenus: [18, 19, 6],
+      },
+    ],
+  },
+  {
+    id: 1100,
+    routeId: 35,
+    titles: { en: "Operations and development", pt: "Operação e desenvolvimento", es: "Operación y desarrollo" },
+    submenus: [
+      {
+        id: 1101,
+        routeId: 36,
+        titles: { en: "Ship and maintain", pt: "Publique e mantenha", es: "Publica y mantén" },
+        submenus: [14, 26, 27, 17],
+      },
+      {
+        id: 1102,
+        routeId: 37,
+        titles: { en: "Develop the project", pt: "Desenvolva o projeto", es: "Desarrolla el proyecto" },
+        submenus: [15, 28, 3],
+      },
+    ],
+  },
+  {
+    id: 1200,
+    routeId: 38,
+    titles: { en: "Git and GitHub", pt: "Git e GitHub", es: "Git y GitHub" },
+    submenus: [5, 4],
+  },
+];

package/data/path-mappings.mjs

@@ -1,8 +1,10 @@
 /** Path and media mappings for doc versions */
 
 export const PDF_GUIDE_FILENAME = "gitpagedocs-project-guide.pdf";
+export const HTML_DOOM_FILENAME = "doom.html";
 
 export const ROUTE_PATHS = {
+  40: { en: "content-blocks.md", pt: "content-blocks.md", es: "content-blocks.md" },
   1: { pt: "getting-started.md", en: "getting-started.md", es: "getting-started.md" },
   2: { pt: "project-overview.md", en: "project-overview.md", es: "project-overview.md" },
   3: { pt: "functionalities.md", en: "functionalities.md", es: "functionalities.md" },
@@ -20,6 +22,19 @@ export const ROUTE_PATHS = {
   21: { pt: "accessibility.md", en: "accessibility.md", es: "accessibility.md" },
   22: { pt: "focus-mode.md", en: "focus-mode.md", es: "focus-mode.md" },
   24: { pt: "pdf.md", en: "pdf.md", es: "pdf.md" },
+  25: { pt: "configuration-recipes.md", en: "configuration-recipes.md", es: "configuration-recipes.md" },
+  26: { pt: "migration.md", en: "migration.md", es: "migration.md" },
+  27: { pt: "troubleshooting.md", en: "troubleshooting.md", es: "troubleshooting.md" },
+  28: { pt: "contributing.md", en: "contributing.md", es: "contributing.md" },
+  30: { pt: "html-containers.md", en: "html-containers.md", es: "html-containers.md" },
+  31: { pt: "guides.md", en: "guides.md", es: "guides.md" },
+  32: { pt: "configure-your-site.md", en: "configure-your-site.md", es: "configure-your-site.md" },
+  33: { pt: "read-and-explore.md", en: "read-and-explore.md", es: "read-and-explore.md" },
+  34: { pt: "automate-and-integrate.md", en: "automate-and-integrate.md", es: "automate-and-integrate.md" },
+  35: { pt: "operations-and-development.md", en: "operations-and-development.md", es: "operations-and-development.md" },
+  36: { pt: "ship-and-maintain.md", en: "ship-and-maintain.md", es: "ship-and-maintain.md" },
+  37: { pt: "develop-the-project.md", en: "develop-the-project.md", es: "develop-the-project.md" },
+  38: { pt: "git-and-github.md", en: "git-and-github.md", es: "git-and-github.md" },
 };
 
 export const VIDEO_IDS = ["bdIJkGr2NV0", "c67GaAkf1BE", "N3my6W_Rdwg", "r8jQ9hVA2qs"];
@@ -33,7 +48,7 @@ export const PAGE2_AUDIO = {
     {
       url: "https://www.youtube.com/watch?v=0w80F8FffQ4",
       type: "youtube",
-      title: { pt: "Musica pagina 2", en: "Page 2 music", es: "Musica pagina 2" },
+      title: { pt: "Música página 2", en: "Page 2 music", es: "Música página 2" },
     },
   ],
 };

package/data/route-metas.mjs

@@ -39,6 +39,10 @@ export const ROUTE_META_ID6 = {
 };
 
 export const REFERENCE_ROUTE_METAS = {
+  40: {
+    titles: { en: "Ordered content blocks", pt: "Blocos de conteúdo ordenados", es: "Bloques de contenido ordenados" },
+    descriptions: { en: "Combine and repeat content in one page", pt: "Combine e repita conteúdos na mesma página", es: "Combina y repite contenidos en una página" },
+  },
   13: {
     titles: { pt: "Configuração", en: "Configuration", es: "Configuración" },
     descriptions: { pt: "Idiomas, ícones, navegação, foco e acessibilidade", en: "Languages, icons, navigation, focus and accessibility", es: "Idiomas, iconos, navegación, foco y accesibilidad" },
@@ -83,25 +87,87 @@ export const REFERENCE_ROUTE_METAS = {
     titles: { pt: "Documentos PDF", en: "PDF documents", es: "Documentos PDF" },
     descriptions: { pt: "Rotas, prévia, download e publicação de anexos PDF", en: "Routes, previews, downloads and publishing PDF attachments", es: "Rutas, vista previa, descarga y publicación de anexos PDF" },
   },
+  25: {
+    titles: { pt: "Receitas de configuração", en: "Configuration recipes", es: "Recetas de configuración" },
+    descriptions: { pt: "Exemplos completos de configuração e seções aninhadas", en: "Complete configuration and nested-section examples", es: "Ejemplos completos de configuración y secciones anidadas" },
+  },
+  26: {
+    titles: { pt: "Migração e compatibilidade", en: "Migration and compatibility", es: "Migración y compatibilidad" },
+    descriptions: { pt: "Atualize preservando conteúdo e personalizações", en: "Upgrade while preserving content and customizations", es: "Actualiza conservando contenido y personalizaciones" },
+  },
+  27: {
+    titles: { pt: "Solução de problemas", en: "Troubleshooting", es: "Solución de problemas" },
+    descriptions: { pt: "Diagnostique configuração, publicação, PDF e integrações", en: "Diagnose configuration, deployment, PDF and integrations", es: "Diagnostica configuración, publicación, PDF e integraciones" },
+  },
+  28: {
+    titles: { pt: "Contribuição e testes", en: "Contributing and testing", es: "Contribución y pruebas" },
+    descriptions: { pt: "Fontes autorais, contratos, testes e publicação", en: "Authoring sources, contracts, tests and releases", es: "Fuentes, contratos, pruebas y publicación" },
+  },
+  30: {
+    titles: { pt: "Containers HTML", en: "HTML containers", es: "Contenedores HTML" },
+    descriptions: { pt: "Páginas HTML, URLs externas e o exemplo interativo DOOM", en: "HTML pages, external URLs and the interactive DOOM example", es: "Páginas HTML, URLs externas y el ejemplo interactivo DOOM" },
+  },
+  31: {
+    titles: { pt: "Guias", en: "Guides", es: "Guías" },
+    descriptions: { pt: "Escolha um caminho para configurar, ler ou integrar", en: "Choose a path to configure, read or integrate", es: "Elige un recorrido para configurar, leer o integrar" },
+  },
+  32: {
+    titles: { pt: "Configure seu site", en: "Configure your site", es: "Configura tu sitio" },
+    descriptions: { pt: "Organize conteúdo, navegação e apresentação", en: "Organize content, navigation and presentation", es: "Organiza contenido, navegación y presentación" },
+  },
+  33: {
+    titles: { pt: "Leia e explore", en: "Read and explore", es: "Lee y explora" },
+    descriptions: { pt: "Escolha como ler documentos e exemplos interativos", en: "Choose how to read documents and interactive examples", es: "Elige cómo leer documentos y ejemplos interactivos" },
+  },
+  34: {
+    titles: { pt: "Automatize e integre", en: "Automate and integrate", es: "Automatiza e integra" },
+    descriptions: { pt: "Use CLI, MCP e políticas de acesso", en: "Use the CLI, MCP and access policies", es: "Usa la CLI, MCP y políticas de acceso" },
+  },
+  35: {
+    titles: { pt: "Operação e desenvolvimento", en: "Operations and development", es: "Operación y desarrollo" },
+    descriptions: { pt: "Publique, mantenha e desenvolva a documentação", en: "Publish, maintain and develop the documentation", es: "Pública, mantén y desarrolla la documentación" },
+  },
+  36: {
+    titles: { pt: "Publique e mantenha", en: "Ship and maintain", es: "Pública y mantén" },
+    descriptions: { pt: "Prepare a publicação e preserve compatibilidade", en: "Prepare releases and preserve compatibility", es: "Prepara publicaciones y conserva compatibilidad" },
+  },
+  37: {
+    titles: { pt: "Desenvolva o projeto", en: "Develop the project", es: "Desarrolla el proyecto" },
+    descriptions: { pt: "Localize fontes, contratos e verificações", en: "Locate sources, contracts and checks", es: "Localiza fuentes, contratos y comprobaciones" },
+  },
+  38: {
+    titles: { pt: "Git e GitHub", en: "Git and GitHub", es: "Git y GitHub" },
+    descriptions: { pt: "Versione mudanças e organize o trabalho", en: "Version changes and organize the work", es: "Versiona cambios y organiza el trabajo" },
+  },
+};
+
+export const HTML_DOOM_META = {
+  id: 29,
+  titles: { pt: "DOOM: exemplo HTML", en: "DOOM: HTML example", es: "DOOM: ejemplo HTML" },
+  descriptions: {
+    pt: "Jogue DOOM em um container HTML usando os controles do próprio player.",
+    en: "Play DOOM in an HTML container using the player’s native controls.",
+    es: "Juega a DOOM en un contenedor HTML con los controles del reproductor.",
+  },
 };
 
 export const SOURCE_VIEWER_META = {
   id: 7,
-  titles: { pt: "Codigo fonte", en: "Source code", es: "Codigo fuente" },
+  titles: { pt: "Código fonte", en: "Source code", es: "Código fuente" },
   descriptions: {
-    pt: "Explore a arvore do repositorio, navegue por pastas e visualize arquivos diretamente na documentacao.",
+    pt: "Explore a árvore do repositório, navegue por pastas e visualize arquivos diretamente na documentação.",
     en: "Explore the repository tree, browse folders, and preview files directly inside the documentation.",
-    es: "Explora el arbol del repositorio, navega por carpetas y previsualiza archivos directamente en la documentacion.",
+    es: "Explora el árbol del repositorio, navega por carpetas y previsualiza archivos directamente en la documentación.",
   },
 };
 
 export const AUDIO_META_ID12 = {
   id: 12,
-  title: { pt: "Trilha de audio", en: "Audio track", es: "Pista de audio" },
+  title: { pt: "Trilha de áudio", en: "Audio track", es: "Pista de audio" },
   description: {
-    pt: "Ouça uma faixa de exemplo diretamente na documentacao.",
+    pt: "Ouça uma faixa de exemplo diretamente na documentação.",
     en: "Listen to a sample track directly inside the documentation.",
-    es: "Escucha una pista de ejemplo directamente en la documentacion.",
+    es: "Escucha una pista de ejemplo directamente en la documentación.",
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitpagedocs/cli",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "CLI that scaffolds and maintains gitpagedocs documentation, generates docs with AI, configures GitHub Pages, and runs the MCP server.",
   "bin": {
     "gitpagedocs": "index.mjs"
@@ -29,8 +29,8 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.5.1",
-    "@gitpagedocs/mcp": "^0.0.9",
-    "@gitpagedocs/tools": "^0.0.9",
+    "@gitpagedocs/mcp": "^0.0.11",
+    "@gitpagedocs/tools": "^0.0.11",
     "tsx": "^4.21.0"
   },
   "repository": {

package/runtime/doc-path-resolver.mjs

@@ -1,6 +1,9 @@
 /** Map doc paths to content keys and apply version badges */
 
+import { PACKAGE_VERSION } from "../contracts/doc-versions.mjs";
+
 const DOC_FILE_KEYS = new Map([
+  ["content-blocks.md", "contentBlocks"],
   ["index.md", "index"],
   ["getting-started.md", "gettingStarted"],
   ["configuration.md", "configuration"],
@@ -19,6 +22,19 @@ const DOC_FILE_KEYS = new Map([
   ["accessibility.md", "accessibility"],
   ["focus-mode.md", "focusMode"],
   ["pdf.md", "pdf"],
+  ["configuration-recipes.md", "configurationRecipes"],
+  ["migration.md", "migration"],
+  ["troubleshooting.md", "troubleshooting"],
+  ["contributing.md", "contributing"],
+  ["html-containers.md", "htmlContainers"],
+  ["guides.md", "guides"],
+  ["configure-your-site.md", "configureYourSite"],
+  ["read-and-explore.md", "readAndExplore"],
+  ["automate-and-integrate.md", "automateAndIntegrate"],
+  ["operations-and-development.md", "operationsAndDevelopment"],
+  ["ship-and-maintain.md", "shipAndMaintain"],
+  ["develop-the-project.md", "developTheProject"],
+  ["git-and-github.md", "gitAndGitHub"],
 ]);
 
 export function parseDocFileToKey(fileName) {
@@ -28,6 +44,7 @@ export function parseDocFileToKey(fileName) {
 export function parseHtmlFileToKey(fileName) {
   const base = fileName.replace(/\.html$/, "");
   if (base === "source-viewer") return "sourceViewer";
+  if (base === "doom") return "doom";
   return undefined;
 }
 
@@ -37,13 +54,17 @@ export function extractLanguageFromPath(docPath) {
 }
 
 export function withVersionBadge(content, versionId, language) {
-  const normalized = typeof content === "string" ? content : "";
+  const normalized = typeof content === "string"
+    ? content.replaceAll(`/versions/${PACKAGE_VERSION}/`, `/versions/${versionId}/`)
+    : "";
   if (!normalized.trim()) {
     return normalized;
   }
 
   const alreadyTagged =
     normalized.includes(`Version: ${versionId}`) ||
+    normalized.includes(`Versão: ${versionId}`) ||
+    normalized.includes(`Versión: ${versionId}`) ||
     normalized.includes(`Versao: ${versionId}`) ||
     normalized.includes(`Version (ES): ${versionId}`);
   if (alreadyTagged) {
@@ -56,7 +77,7 @@ export function withVersionBadge(content, versionId, language) {
 }
 
 /** Badge wording per language; every other language reads the English form. */
-const VERSION_LABEL_PREFIXES = { pt: "Versao", es: "Version (ES)" };
+const VERSION_LABEL_PREFIXES = { pt: "Versão", es: "Versión" };
 
 function versionLabelPrefix(language) {
   return VERSION_LABEL_PREFIXES[language] ?? "Version";