@gitpagedocs/cli 0.0.9 → 0.0.10

package/content/practical-pt.mjs

@@ -0,0 +1,116 @@
+import { HTML_ROUTE_JSON, RECIPE_ROOT_JSON, RECIPE_VERSION_JSON } from "./configuration-examples.mjs";
+
+export const practicalPt = {
+  htmlContainers: `# Containers HTML e exemplos interativos
+
+Uma rota HTML exibe um documento local ou uma página externa dentro de um iframe. Use-a para uma demonstração interativa confiável que o Markdown não consegue representar. O scaffold inclui **DOOM: exemplo HTML**, rota 29, com título, descrição e botão traduzidos. O player externo só é carregado quando o visitante decide jogar. O jogo continua hospedado pelo provedor; o pacote npm inclui a página HTML de apresentação, não os arquivos do jogo.
+
+## Configure uma rota HTML local
+
+Adicione esta rota ao array \`routes-html\` existente na configuração da versão. Preserve as demais rotas e use um ID distinto para cada destino. Crie cada arquivo referenciado como HTML UTF-8 ou gere o exemplo incluído pela CLI.
+
+\`\`\`json
+${HTML_ROUTE_JSON}
+\`\`\`
+
+Adicione um item traduzido em \`menus-header-html\`. Cada \`path-click\` deve corresponder ao caminho da rota no mesmo idioma, como \`gitpagedocs/docs/versions/0.0.10/pt/doom.html\`; não substitua esse caminho HTML local por \`page:29\`. Um rótulo de menu não cria uma rota. HTML aceita a mesma estrutura recursiva \`submenus\` dos outros menus.
+
+## Dimensões, conteúdo e URLs externas
+
+\`container: "full"\` aplica uma altura mínima relacionada à janela; um número positivo define a altura em pixels. Omita-o para usar o container normal. \`fullscreenEnabled\` controla a ação de tela cheia do visualizador. Título e descrição da rota são independentes dos títulos escritos dentro do próprio HTML.
+
+Para uma página hospedada, use \`url: { "en": "https://example.com/demo", "pt": "https://example.com/demo", "es": "https://example.com/demo" }\` no lugar de \`path\`. Uma rota URL navega o iframe; o HTML local é carregado em \`srcDoc\`. No conteúdo local, prefira estilos incluídos no documento e URLs HTTPS explícitas: srcDoc não resolve automaticamente os recursos relativos ao diretório do arquivo original.
+
+O servidor externo pode impedir incorporação por CSP ou X-Frame-Options. Hosts conhecidos que bloqueiam iframe recebem uma alternativa para abrir em nova aba; falhas de qualquer servidor não são detectadas universalmente. Teste o destino real no site publicado. \`blockLink: true\` define nova aba como destino padrão dos links no HTML local; não impede navegação feita por scripts ou links com destino próprio.
+
+## Use e mantenha o exemplo do jogo
+
+Escolha o item HTML no menu, leia o aviso sobre o provedor e pressione o botão de carregamento. É necessária conexão; depois siga os controles de início e teclado do próprio player. A página inclui um link direto ao provedor caso a incorporação falhe. Teste foco de teclado, telas pequenas, tela cheia e retorno à documentação. Disponibilidade do player e recursos do navegador podem mudar independentemente do GitPageDocs.
+
+Revise o HTML e suas dependências antes de publicar. O iframe atual permite scripts e conteúdo de mesma origem, portanto não funciona como barreira de segurança para HTML arbitrário não confiável. Não inclua segredos em HTML, URLs ou configuração do cliente. A hospedagem estática expõe os arquivos independentemente da visibilidade do menu ou autorização da rota. No ambiente local e no Pages, versione a página com a configuração correspondente e valide os caminhos gerados antes da publicação.
+`,
+  configurationRecipes: `# Receitas de configuração
+
+Este guia monta um site pequeno em três idiomas, com duas páginas Markdown e menu com três níveis. Comece pela configuração gerada, revise as mudanças e mantenha os arquivos originais no controle de versão. Os exemplos usam os IDs 101 e 102 para distingui-los das páginas incluídas no scaffold.
+
+## 1. Gere e confira a estrutura
+
+Execute \`npx --yes @gitpagedocs/cli@0.0.10 --no-interactive --owner SEU_USUARIO --repo SEU_REPOSITORIO\` em um diretório de projeto novo. Neste repositório de código-fonte, \`node cli/index.mjs\` executa a versão do checkout. A geração grava configuração e documentação; ela não inicia o visualizador Next.js.
+
+O JSON completo abaixo é um exemplo mínimo de \`gitpagedocs/config.json\`. Em um site existente, mescle os campos relevantes e preserve a identidade do repositório, opções de publicação, temas e demais versões.
+
+\`\`\`json
+${RECIPE_ROOT_JSON}
+\`\`\`
+
+As oito entradas herdam a apresentação comum de \`icons.defaults\`. Para mostrar texto em uma ação, acrescente \`"reactIcon": false\` à entrada correspondente. Não altere um default compartilhado apenas para mudar um botão. Campos planos antigos de ícones prevalecem sobre os compactos; remova ou atualize um campo conflitante somente depois de confirmar sua intenção.
+
+## 2. Crie a configuração da versão
+
+Salve o próximo JSON completo no caminho do config da versão indicado acima. Uma categoria de menu tem título e \`submenus\`; uma folha tem \`path-click\` localizado. Categorias não precisam de rota. Destinos Markdown apontam para os caminhos reais dos arquivos, sem usar o alias \`page:<id>\`.
+
+\`\`\`json
+${RECIPE_VERSION_JSON}
+\`\`\`
+
+Crie \`start.md\` e \`next-steps.md\` nas pastas \`en\`, \`pt\` e \`es\` dessa versão: seis arquivos ao todo. Escreva no idioma correspondente e salve em UTF-8. Comece cada página com um título e acrescente seções \`##\` para testar o modo foco. Os bundles gerados em \`langs/\` contêm os textos da interface, separados do conteúdo dos documentos.
+
+## 3. Mude a apresentação sem perder destinos
+
+Com \`nestedMenusEnabled: true\`, o leitor expande Guias → Primeiros passos → página. Com \`false\`, os mesmos destinos aparecem em uma lista plana. Acrescente \`submenus\` recursivamente quando a organização do conteúdo justificar; não há limite fixo de profundidade configurado. Mantenha identidades distintas entre irmãos e evite repetir destinos apenas para aumentar a árvore.
+
+Breadcrumbs usam \`site.RouteGuide\`, depois \`routeDefaults.RouteGuide\` da versão e por último a rota individual. O valor explícito mais específico prevalece. \`RouteguideBrand\` é o índice separado de títulos. As setas Voltar/Próximo do rodapé seguem os destinos disponíveis; \`ActiveNavigation\` controla a navegação rápida e Ctrl+K.
+
+## 4. Inclua mídia e valide
+
+Consulte Documentos PDF para adicionar \`routes-pdf\` e \`menus-header-pdf\`; o exemplo \`page:23\` aponta para o guia em inglês incluído. Prévia, download e nova aba são independentes da aparência dos ícones. PDFs externos precisam permitir CORS nas três ações; PDFs locais dentro de \`gitpagedocs/\` são preparados ao executar ou compilar o Next.js.
+
+Confira todos os idiomas, expanda cada categoria e percorra as folhas. Teste URLs diretas, alterações entre texto e ícone, primeiro/anterior/próximo/último no foco e direções desabilitadas nas extremidades. Inspecione o config da versão quando o rótulo aparece mas o destino falha. Faça commit da configuração revisada junto com os documentos e anexos referenciados.
+`,
+  contributing: `# Contribuição e testes
+
+Use o repositório de código-fonte para alterar o runtime, a CLI, as ferramentas compartilhadas ou o MCP. Um repositório que apenas consome o visualizador normalmente edita seu próprio conteúdo e configuração. Trabalhe em uma branch focada e descreva o comportamento visível ao usuário e sua validação.
+
+## Altere o pacote responsável
+
+\`frontend/\` contém o visualizador Next.js App Router e segue Feature-Sliced Design. Primitivos visuais compartilhados ficam em \`shared\`, dados e schemas de documentação em \`entities\`, recursos do usuário em \`features\` e a composição do leitor em \`widgets\`. Mantenha carregamento de arquivos e repositórios fora dos componentes de apresentação.
+
+\`cli/\` é responsável pelo scaffold, comandos, defaults e templates autorais. \`tools/\` fornece lógica reutilizável de configuração, documentação e serviços. \`mcp/\` expõe essas capacidades pelo Model Context Protocol. Uma correção visual normalmente pertence ao frontend; um default do scaffold deve mudar na fonte da CLI e ser regenerado.
+
+## Edite as fontes, não as cópias geradas
+
+| Mudança | Fonte de verdade | Resultado gerado |
+| --- | --- | --- |
+| Opções do site e textos de idioma | \`cli/data/\` | Config raiz e \`gitpagedocs/langs/\` |
+| Rotas e seções do menu | Builders da CLI, metadados, mapeamentos e \`menu-sections.mjs\` | Config da versão |
+| Textos da documentação | \`cli/content/docs-{en,pt,es}.mjs\` e módulos importados | Markdown versionado |
+| Regiões gerenciadas | \`tools/src/documentation/sections.ts\` | README, CONTRIBUTING e SECURITY |
+| Definições de layouts | \`gitpagelayouts/v2/\` | Templates e documentação de layouts |
+
+Após alterar CLI/conteúdo, execute \`node cli/index.mjs\`, copie \`gitpagedocs/\` para \`tools/gitpagedocs/\` sem excluir versões históricas e execute \`pnpm run baseline:create\`. Use \`node cli/index.mjs docs\` nas regiões gerenciadas e \`pnpm run layouts:sync\` para layouts. Revise o diff: a geração não deve substituir silenciosamente material customizado que você queria manter.
+
+## Teste pelas interfaces públicas
+
+Escreva uma regressão que falha antes de implementar. Teste o contrato observável: configuração e arquivos gerados na CLI, respostas de tools/resources no MCP, controles e teclado na UI, interações reais do navegador em navegação e mídia. Evite testes que apenas repetem o algoritmo de um helper interno.
+
+Cubra sucesso, recursos indisponíveis, entradas inválidas e limites relevantes. Exemplos: tradução ausente, rota negada, título PDF vazio, pop-up bloqueado, falha CORS, limites primeiro/último e lista vazia de vozes nativas. Use pastas temporárias isoladas para geradores. Simule rede ou APIs do navegador na fronteira pública; mantenha colaboradores do projeto reais quando possível.
+
+\`\`\`sh
+pnpm install --frozen-lockfile
+pnpm run typecheck
+pnpm run lint
+pnpm exec vitest run
+pnpm run smoke:all
+pnpm run build
+pnpm exec cross-env PORT=3100 pnpm run test:e2e
+\`\`\`
+
+A configuração E2E usa as portas 3100 e 3101; preserve o serviço existente na 3000. \`smoke:all\` inclui contratos da CLI, serviços compartilhados, descoberta MCP, documentação e \`baseline:check\`. \`pnpm run test:cov\` acrescenta cobertura. O build local de produção é diferente do ambiente de exportação estática do Pages, que também deve ser validado quando caminhos de publicação mudam.
+
+## Revise e publique
+
+Revise acessibilidade, autorização, validação de entrada, erros, liberação de recursos e consistência dos arquivos gerados. Analise cada fonte alterada no projeto SonarQube configurado com o escopo correto de teste ou produção; use parser/linter da stack nos formatos sem suporte. Não inclua credenciais ou artefatos temporários nos commits.
+
+Os pacotes publicáveis são \`@gitpagedocs/tools\`, \`@gitpagedocs/mcp\` e \`@gitpagedocs/cli\`; raiz e frontend são privados. Sincronize versões, dependências internas e lockfile, inspecione os pacotes e conclua a validação antes do push. O workflow npm atual roda em pushes para main e publica em ordem de dependência quando a versão da CLI é nova. Confirme npm e Pages depois; um build local verde não equivale à publicação.
+`,
+};

package/contracts/doc-versions.mjs

@@ -1,3 +1,3 @@
-export const PACKAGE_VERSION = "0.0.9";
+export const PACKAGE_VERSION = "0.0.10";
 
 export const DOC_VERSIONS = [PACKAGE_VERSION];

package/data/default-site-config.mjs

@@ -14,7 +14,7 @@ export function getDefaultSiteConfig(projectLink, languageToggles = buildLanguag
         ThemeDefault: "aurora-dark",
         ThemeModeDefault: "dark",
         ActiveNavigation: true,
-        IconQuickNavigationReactIcones: false,
+        IconQuickNavigationReactIcones: true,
         IconQuickNavigationReactIconesTag: "FiSearch",
         IconQuickNavigationReactIconesTagColorDark: "currentColor",
         IconQuickNavigationReactIconesTagColorLight: "currentColor",
@@ -38,21 +38,41 @@ export function getDefaultSiteConfig(projectLink, languageToggles = buildLanguag
             enabled: true,
             narration: { enabled: true, defaultRate: 1, defaultVolume: 1 },
         },
-        IconLanguageSelectorReactIcones: false,
+        IconLanguageSelectorReactIcones: true,
         IconLanguageSelectorReactIconesTag: "FiGlobe",
         IconLanguageSelectorReactIconesTagColorDark: "currentColor",
         IconLanguageSelectorReactIconesTagColorLight: "currentColor",
         IconLanguageSelectorReactIconesTagSize: "22px",
-        IconThemeSelectorReactIcones: false,
+        IconThemeSelectorReactIcones: true,
         IconThemeSelectorReactIconesTag: "BsSunFill",
         IconThemeSelectorReactIconesTagColorDark: "currentColor",
         IconThemeSelectorReactIconesTagColorLight: "currentColor",
         IconThemeSelectorReactIconesTagSize: "22px",
-        IconFocusModeReactIcones: false,
+        IconFocusModeReactIcones: true,
         IconFocusModeReactIconesTag: "MdFullscreen",
         IconFocusModeReactIconesTagColorDark: "currentColor",
         IconFocusModeReactIconesTagColorLight: "currentColor",
         IconFocusModeReactIconesTagSize: "22px",
+        IconPdfDownloadReactIcones: true,
+        IconPdfDownloadReactIconesTag: "FiDownload",
+        IconPdfDownloadReactIconesTagColorDark: "currentColor",
+        IconPdfDownloadReactIconesTagColorLight: "currentColor",
+        IconPdfDownloadReactIconesTagSize: "22px",
+        IconPdfOpenInNewTabReactIcones: true,
+        IconPdfOpenInNewTabReactIconesTag: "FiExternalLink",
+        IconPdfOpenInNewTabReactIconesTagColorDark: "currentColor",
+        IconPdfOpenInNewTabReactIconesTagColorLight: "currentColor",
+        IconPdfOpenInNewTabReactIconesTagSize: "22px",
+        IconDocumentPreviousReactIcones: true,
+        IconDocumentPreviousReactIconesTag: "FiChevronLeft",
+        IconDocumentPreviousReactIconesTagColorDark: "currentColor",
+        IconDocumentPreviousReactIconesTagColorLight: "currentColor",
+        IconDocumentPreviousReactIconesTagSize: "22px",
+        IconDocumentNextReactIcones: true,
+        IconDocumentNextReactIconesTag: "FiChevronRight",
+        IconDocumentNextReactIconesTagColorDark: "currentColor",
+        IconDocumentNextReactIconesTagColorLight: "currentColor",
+        IconDocumentNextReactIconesTagSize: "22px",
         FooterEnabled: true,
         FooterLinkName: "GitPageDocs",
         FooterLinkUrl: projectLink,

package/data/i18n-langmenu.mjs

@@ -3,6 +3,7 @@ export const defaultLangMenu = {
           titleHeaderMenuPdf: "PDF",
           PdfDownload: "Baixar PDF",
           PdfOpenInNewTab: "Abrir PDF em nova aba",
+          PdfOpenError: "Não foi possível abrir o PDF. Verifique o arquivo, permita pop-ups e tente novamente.",
           PdfUnavailable: "A prévia do PDF depende do navegador. Use as ações disponíveis para abrir ou baixar o documento.",
           PdfDownloadError: "Não foi possível baixar o PDF. Tente abrir o documento em uma nova aba.",
           PdfDownloading: "Baixando PDF...",
@@ -25,6 +26,10 @@ export const defaultLangMenu = {
           typeToNavigate: "Digite para navegar...",
           noNavigationResults: "Nenhum resultado de navegacao.",
           focusMode: "Modo foco",
+          focusFirstDocument: "Primeiro documento",
+          focusLastDocument: "Último documento",
+          focusFirstSection: "Primeira seção",
+          focusLastSection: "Última seção",
           focusSectionsLabel: "Seções",
           focusDocumentsLabel: "Documentos",
           focusPreviousSectionLabel: "Seção anterior",
@@ -167,6 +172,7 @@ export const defaultLangMenu = {
           titleHeaderMenuPdf: "PDF",
           PdfDownload: "Download PDF",
           PdfOpenInNewTab: "Open PDF in a new tab",
+          PdfOpenError: "Could not open PDF. Check the file and allow pop-ups, then try again.",
           PdfUnavailable: "PDF preview depends on your browser. Use the available actions to open or download the document.",
           PdfDownloadError: "The PDF could not be downloaded. Try opening the document in a new tab.",
           PdfDownloading: "Downloading PDF...",
@@ -189,6 +195,10 @@ export const defaultLangMenu = {
           typeToNavigate: "Type to navigate...",
           noNavigationResults: "No navigation results.",
           focusMode: "Focus mode",
+          focusFirstDocument: "First document",
+          focusLastDocument: "Last document",
+          focusFirstSection: "First section",
+          focusLastSection: "Last section",
           focusSectionsLabel: "Sections",
           focusDocumentsLabel: "Documents",
           focusPreviousSectionLabel: "Previous section",
@@ -331,6 +341,7 @@ export const defaultLangMenu = {
           titleHeaderMenuPdf: "PDF",
           PdfDownload: "Descargar PDF",
           PdfOpenInNewTab: "Abrir PDF en una pestaña nueva",
+          PdfOpenError: "No se pudo abrir el PDF. Comprueba el archivo, permite ventanas emergentes e inténtalo de nuevo.",
           PdfUnavailable: "La vista previa del PDF depende del navegador. Usa las acciones disponibles para abrir o descargar el documento.",
           PdfDownloadError: "No se pudo descargar el PDF. Intenta abrir el documento en una pestaña nueva.",
           PdfDownloading: "Descargando PDF...",
@@ -353,6 +364,10 @@ export const defaultLangMenu = {
           typeToNavigate: "Escribe para navegar...",
           noNavigationResults: "Sin resultados de navegacion.",
           focusMode: "Modo foco",
+          focusFirstDocument: "Primer documento",
+          focusLastDocument: "Último documento",
+          focusFirstSection: "Primera sección",
+          focusLastSection: "Última sección",
           focusSectionsLabel: "Secciones",
           focusDocumentsLabel: "Documentos",
           focusPreviousSectionLabel: "Sección anterior",

package/data/menu-sections.mjs

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

package/data/path-mappings.mjs

@@ -1,6 +1,7 @@
 /** 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 = {
   1: { pt: "getting-started.md", en: "getting-started.md", es: "getting-started.md" },
@@ -20,6 +21,11 @@ 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" },
 };
 
 export const VIDEO_IDS = ["bdIJkGr2NV0", "c67GaAkf1BE", "N3my6W_Rdwg", "r8jQ9hVA2qs"];

package/data/route-metas.mjs

@@ -83,6 +83,36 @@ 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" },
+  },
+};
+
+export const HTML_DOOM_META = {
+  id: 29,
+  titles: { pt: "DOOM: exemplo HTML", en: "DOOM: HTML example", es: "DOOM: ejemplo HTML" },
+  descriptions: {
+    pt: "Um container HTML com título, descrição e um jogo carregado apenas ao clicar.",
+    en: "An HTML container with a title, description and a game loaded only after clicking.",
+    es: "Un contenedor HTML con título, descripción y un juego que se carga solo al hacer clic.",
+  },
 };
 
 export const SOURCE_VIEWER_META = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitpagedocs/cli",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "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.10",
+    "@gitpagedocs/tools": "^0.0.10",
     "tsx": "^4.21.0"
   },
   "repository": {

package/runtime/doc-path-resolver.mjs

@@ -19,6 +19,11 @@ 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"],
 ]);
 
 export function parseDocFileToKey(fileName) {
@@ -28,6 +33,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;
 }