@gitpagedocs/cli 0.0.7 → 0.0.8

package/builders/route-builders.mjs

@@ -1,21 +1,49 @@
 /** Build route objects for md, html, and video content types */
 
+/** Title/description styling every content route starts from (key order is part of the output). */
+const ROUTE_TEXT_DEFAULTS = {
+  titleCss: "font-size: 1.85rem; font-weight: 700;",
+  titleDarkCss: "font-size: 1.85rem; font-weight: 700; color: var(--text);",
+  titleLightCss: "font-size: 1.85rem; font-weight: 700; color: var(--text);",
+  titlePosition: "center",
+  titleIsVisible: true,
+  descriptionCss: "font-size: 1.2rem; font-weight: 500;",
+  descriptionDarkCss: "font-size: 1.2rem; font-weight: 500; color: var(--text-secondary);",
+  descriptionLightCss: "font-size: 1.2rem; font-weight: 500; color: var(--text-secondary);",
+  descriptionPosition: "center",
+  descriptionIsVisible: true,
+};
+
+/** Container frame settings every content route starts from. */
+const ROUTE_FRAME_DEFAULTS = {
+  fullscreenEnabled: true,
+  marginTop: "",
+  marginBottom: "",
+  blockLink: true,
+};
+
+/** Each default key, taking the option value when it is set. */
+function withDefaults(defaults, options) {
+  return Object.fromEntries(
+    Object.entries(defaults).map(([key, value]) => [key, options[key] === undefined ? value : options[key]]),
+  );
+}
+
+/** A single value becomes the same value for every language. */
+function perLanguage(value) {
+  return typeof value === "string" ? { pt: value, en: value, es: value } : value;
+}
+
+/** Copies only the fields that are set. */
+function assignDefined(target, fields) {
+  for (const [key, value] of Object.entries(fields)) {
+    if (value !== undefined) target[key] = value;
+  }
+  return target;
+}
+
 export function buildMdRoute(versionId, routeId, pathByLang, titles, descriptions, options = {}) {
   const {
-    titleCss = "font-size: 1.85rem; font-weight: 700;",
-    titleDarkCss = "font-size: 1.85rem; font-weight: 700; color: var(--text);",
-    titleLightCss = "font-size: 1.85rem; font-weight: 700; color: var(--text);",
-    titlePosition = "center",
-    titleIsVisible = true,
-    descriptionCss = "font-size: 1.2rem; font-weight: 500;",
-    descriptionDarkCss = "font-size: 1.2rem; font-weight: 500; color: var(--text-secondary);",
-    descriptionLightCss = "font-size: 1.2rem; font-weight: 500; color: var(--text-secondary);",
-    descriptionPosition = "center",
-    descriptionIsVisible = true,
-    fullscreenEnabled = true,
-    marginTop = "",
-    marginBottom = "",
-    blockLink = true,
     container,
     browseAll = false,
     RouteguideBrand = true,
@@ -24,26 +52,15 @@ export function buildMdRoute(versionId, routeId, pathByLang, titles, description
     RouteguideBrandContainerTop = false,
     audio,
     authorization,
+    hierarchyPage,
   } = options;
   const out = {
     id: routeId,
     title: titles ?? { pt: "Documentação", en: "Documentation", es: "Documentación" },
     description: descriptions ?? { pt: "Descrição da página", en: "Page description", es: "Descripción de la página" },
-    titleCss,
-    titleDarkCss,
-    titleLightCss,
-    titlePosition,
-    titleIsVisible,
-    descriptionCss,
-    descriptionDarkCss,
-    descriptionLightCss,
-    descriptionPosition,
-    descriptionIsVisible,
+    ...withDefaults(ROUTE_TEXT_DEFAULTS, options),
     path: pathByLang,
-    fullscreenEnabled,
-    marginTop,
-    marginBottom,
-    blockLink,
+    ...withDefaults(ROUTE_FRAME_DEFAULTS, options),
     container,
     browseAll,
     RouteguideBrand,
@@ -51,10 +68,7 @@ export function buildMdRoute(versionId, routeId, pathByLang, titles, description
     RouteguideBrandPosition,
     RouteguideBrandContainerTop,
   };
-  if (container !== undefined) out.container = container;
-  if (audio !== undefined) out.audio = audio;
-  if (authorization !== undefined) out.authorization = authorization;
-  return out;
+  return assignDefined(out, { container, audio, authorization, hierarchyPage });
 }
 
 export function buildHtmlRoute(versionId, routeId, pathByLang, titles, descriptions, options = {}) {
@@ -63,61 +77,25 @@ export function buildHtmlRoute(versionId, routeId, pathByLang, titles, descripti
 }
 
 export function buildVideoRoute(versionId, routeId, videoType, pathVideo, titles, descriptions, options = {}) {
-  const {
-    titleCss = "font-size: 1.85rem; font-weight: 700;",
-    titleDarkCss = "font-size: 1.85rem; font-weight: 700; color: var(--text);",
-    titleLightCss = "font-size: 1.85rem; font-weight: 700; color: var(--text);",
-    titlePosition = "center",
-    titleIsVisible = true,
-    descriptionCss = "font-size: 1.2rem; font-weight: 500;",
-    descriptionDarkCss = "font-size: 1.2rem; font-weight: 500; color: var(--text-secondary);",
-    descriptionLightCss = "font-size: 1.2rem; font-weight: 500; color: var(--text-secondary);",
-    descriptionPosition = "center",
-    descriptionIsVisible = true,
-    fullscreenEnabled = true,
-    marginTop = "",
-    marginBottom = "",
-    blockLink = true,
-    container,
-    browseAll = false,
-    authorization,
-  } = options;
-  const videoTypeByLang = typeof videoType === "string" ? { pt: videoType, en: videoType, es: videoType } : videoType;
-  const pathVideoByLang = typeof pathVideo === "string" ? { pt: pathVideo, en: pathVideo, es: pathVideo } : pathVideo;
+  const { container, browseAll = false, authorization } = options;
   const obj = {
     id: routeId,
     title: titles ?? { pt: "Vídeo", en: "Video", es: "Vídeo" },
     description: descriptions ?? { pt: "Descrição do vídeo", en: "Video description", es: "Descripción del vídeo" },
-    titleCss,
-    titleDarkCss,
-    titleLightCss,
-    titlePosition,
-    titleIsVisible,
-    descriptionCss,
-    descriptionDarkCss,
-    descriptionLightCss,
-    descriptionPosition,
-    descriptionIsVisible,
-    fullscreenEnabled,
-    marginTop,
-    marginBottom,
-    blockLink,
+    ...withDefaults(ROUTE_TEXT_DEFAULTS, options),
+    ...withDefaults(ROUTE_FRAME_DEFAULTS, options),
     browseAll,
-    video: { videoType: videoTypeByLang, pathVideo: pathVideoByLang },
+    video: { videoType: perLanguage(videoType), pathVideo: perLanguage(pathVideo) },
   };
-  if (container !== undefined) obj.container = container;
-  if (authorization !== undefined) obj.authorization = authorization;
-  return obj;
+  return assignDefined(obj, { container, authorization });
 }
 
 export function buildAudioRoute(versionId, routeId, audioType, pathAudio, titles, descriptions, options = {}) {
   const base = buildVideoRoute(versionId, routeId, audioType, pathAudio, titles, descriptions, options);
-  const audioTypeByLang = typeof audioType === "string" ? { pt: audioType, en: audioType, es: audioType } : audioType;
-  const pathAudioByLang = typeof pathAudio === "string" ? { pt: pathAudio, en: pathAudio, es: pathAudio } : pathAudio;
   const { video, ...rest } = base;
   return {
     ...rest,
-    audio: { audioType: audioTypeByLang, pathAudio: pathAudioByLang },
+    audio: { audioType: perLanguage(audioType), pathAudio: perLanguage(pathAudio) },
   };
 }
 

package/builders/version-config-builder.mjs

@@ -20,6 +20,7 @@ import {
   AUDIO_META_ID12,
   SOURCE_VIEWER_META,
   DEFAULT_HIERARCHY,
+  VIDEO_FIRST_HIERARCHY,
 } from "../data/route-metas.mjs";
 import { buildAudioRoute, buildMdRoute, buildSourceViewerRoute, buildVideoRoute } from "./route-builders.mjs";
 import { resolveSourceViewerPath } from "./project-links.mjs";
@@ -35,6 +36,14 @@ const VIDEO_ROUTE_AUTHORIZATION = {
   requireExternalAuth: true,
   allowedProviders: EXTERNAL_AUTH_PROVIDERS,
 };
+/** Video route left open so the scaffold always shows a playable video (GitHub's introduction to Git). */
+const PUBLIC_VIDEO_ROUTE_ID = 11;
+/** Video routes follow the six markdown pages and the source viewer (ids 8-11). */
+const VIDEO_ROUTE_ID_OFFSET = 7;
+/** Markdown page that also shows the public video, in a video container above its text. */
+const VIDEO_PAGE_ROUTE_ID = 5;
+/** VIDEO_IDS / VIDEO_METAS entry of the public video (GitHub's introduction to Git). */
+const PUBLIC_VIDEO_INDEX = PUBLIC_VIDEO_ROUTE_ID - VIDEO_ROUTE_ID_OFFSET;
 
 const ROUTE_METAS = {
   1: ROUTE_META_ID1,
@@ -58,6 +67,7 @@ function buildVersionMdRoutes(versionId, includeDemoAuthorization) {
     };
     const routeOptions = {
       ...(id === 2 ? { audio: PAGE2_AUDIO } : {}),
+      ...(id === VIDEO_PAGE_ROUTE_ID ? { hierarchyPage: VIDEO_FIRST_HIERARCHY } : {}),
       ...(includeDemoAuthorization && id === 3
         ? { authorization: { requiredRoles: [MAINTAINER_ROLE] } }
         : {}),
@@ -76,18 +86,33 @@ function buildVersionMdRoutes(versionId, includeDemoAuthorization) {
   });
 }
 
+/** Video container shown on the markdown page VIDEO_PAGE_ROUTE_ID (no menu entry of its own). */
+function buildPageVideoRoute(versionId) {
+  return buildVideoRoute(
+    versionId,
+    VIDEO_PAGE_ROUTE_ID,
+    "youtube",
+    VIDEO_IDS[PUBLIC_VIDEO_INDEX - 1],
+    VIDEO_METAS[PUBLIC_VIDEO_INDEX].title,
+    VIDEO_METAS[PUBLIC_VIDEO_INDEX].description,
+  );
+}
+
 function buildVersionVideoRoutes(versionId, includeDemoAuthorization) {
-  return [1, 2, 3, 4].map((id) =>
-    buildVideoRoute(
+  const menuVideoRoutes = [1, 2, 3, 4].map((id) => {
+    const routeId = id + VIDEO_ROUTE_ID_OFFSET;
+    const isGuarded = includeDemoAuthorization && routeId !== PUBLIC_VIDEO_ROUTE_ID;
+    return buildVideoRoute(
       versionId,
-      id + 7,
+      routeId,
       "youtube",
       VIDEO_IDS[id - 1],
       VIDEO_METAS[id].title,
       VIDEO_METAS[id].description,
-      includeDemoAuthorization ? { authorization: VIDEO_ROUTE_AUTHORIZATION } : {},
-    )
-  );
+      isGuarded ? { authorization: VIDEO_ROUTE_AUTHORIZATION } : {},
+    );
+  });
+  return [buildPageVideoRoute(versionId), ...menuVideoRoutes];
 }
 
 function buildVersionAudioRoutes(versionId) {
@@ -122,12 +147,15 @@ function buildVersionMenus(versionId) {
     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 menuVideo = [1, 2, 3, 4].map((id) => {
+    const routeId = id + VIDEO_ROUTE_ID_OFFSET;
+    return {
+      id: routeId,
+      pt: { title: `${VIDEO_METAS[id].title.pt.slice(0, 40)}...`, "path-click": `page:${routeId}` },
+      en: { title: `${VIDEO_METAS[id].title.en.slice(0, 40)}...`, "path-click": `page:${routeId}` },
+      es: { title: `${VIDEO_METAS[id].title.es.slice(0, 40)}...`, "path-click": `page:${routeId}` },
+    };
+  });
   const menuAudio = [
     {
       id: AUDIO_META_ID12.id,

package/content/docs-en.mjs

@@ -102,7 +102,7 @@ Git Page Docs is a **pnpm + turborepo monorepo** that turns a repository's \`git
 - 14-provider AI system (OpenAI, Anthropic, Gemini, Ollama, Mistral, DeepSeek, Cohere, Groq, xAI, and more) with streaming
 - AI API keys stored **encrypted at rest** (AES-256-GCM) behind a local password gate — never plaintext
 - In-docs **AI chat drawer** plus a dedicated **\`/ai\` console**
-- 36-theme layout system; local and GitHub Pages execution modes
+- 64-theme layout system (dark and light variants); local and GitHub Pages execution modes
 `,
     functionalities: `# Functionalities
 
@@ -119,10 +119,13 @@ Complete reference of CLI options, configuration keys, and runtime features.
 | \`gitpagedocs --interactive\` / \`-i\` | Interactive mode with prompts (the default in a terminal) |
 | \`gitpagedocs --no-interactive\` / \`--yes\` / \`-y\` | Never prompt; use flags and defaults |
 | \`gitpagedocs ai\` | Interactive AI documentation generator |
+| \`gitpagedocs chat [question]\` | Streaming AI chat in the terminal (REPL on a TTY; one-shot with a question or piped stdin) |
 | \`gitpagedocs provider [id]\` / \`models [provider]\` | List AI providers / catalog models |
 | \`gitpagedocs document[:repo\\|:file\\|:folder]\` | Generate documentation with AI |
 | \`gitpagedocs deploy\` / \`pages [actions\\|deploy]\` | Configure GitHub Pages via Actions + push |
 | \`gitpagedocs docs\` | Refresh README/CONTRIBUTING/SECURITY managed regions |
+| \`gitpagedocs password\` | Set a documentation access password (public key in \`site.docsAccess\`) |
+| \`gitpagedocs config\` / \`config clear\` | Show the resolved config / delete the stored config and key vault |
 | \`gitpagedocs doctor\` / \`version\` / \`update\` | Diagnostics / version / registry update check |
 | \`gitpagedocs mcp start\` | Start the MCP server over stdio |
 
@@ -140,6 +143,7 @@ Install globally with \`npm install -g @gitpagedocs/cli\`, or run one-off with \
 | \`--layoutconfig\` | Generate local layouts in \`gitpagelayouts/\` |
 | \`--layouts-dir <dir>\` | Folder for local layouts (default: \`gitpagelayouts\`) |
 | \`--push\` | Create workflow, commit artifacts, push |
+| \`--pages-actions\` | Only switch GitHub Pages to GitHub Actions (same as \`pages actions\`) |
 | \`--home\` | Generate \`gitpagedocshome/\` (static + .env + Dockerfile) |
 
 ## Generated output
@@ -177,6 +181,12 @@ The version config can render a **Source code** container through \`routes-sourc
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
 - Languages: \`site.languages\` (enable/disable each one); UI strings: \`gitpagedocs/langs/<lang>.json\`
 
+## Media playback (one sound at a time)
+
+\`site.mediaExclusivePlayback\` (default \`true\`): playing a route video pauses the radio and the audio tracks, and playing the radio or an audio track pauses the video. It works with YouTube and Vimeo (through their player APIs), native files (\`mp4\`, \`webm\`, …) and any other embed.
+
+To show a video without sound while the radio or an audio track explains it, set \`"muted": true\` in that route's \`video\` object: the video plays only the picture and stays out of the rule. \`"mediaExclusivePlayback": false\` turns the rule off for the whole site.
+
 ## Environment variables
 
 - \`GITPAGEDOCS_REPOSITORY_SEARCH\` – repository search (local)

package/content/docs-es.mjs

@@ -95,7 +95,7 @@ Git Page Docs es un monorepo pnpm + turborepo que convierte la carpeta \`gitpage
 - Sistema de IA con 14 proveedores (OpenAI, Anthropic, Gemini, Ollama, Mistral, DeepSeek, Cohere, Groq, xAI y mas) con streaming
 - Claves de IA **cifradas en reposo** (AES-256-GCM) detras de una contrasena local — nunca en texto plano
 - **Panel de chat de IA** en los docs + una **consola \`/ai\`** dedicada
-- Sistema de 36 temas; ejecucion local y en GitHub Pages
+- Sistema de 64 temas (variantes oscuras y claras); ejecucion local y en GitHub Pages
 `,
     functionalities: `# Funcionalidades
 
@@ -110,7 +110,19 @@ Referencia completa de opciones CLI, claves de configuracion y funciones del run
 | \`npx @gitpagedocs/cli --home\` | Distribucion standalone (\`gitpagedocshome/\`) |
 | \`npx @gitpagedocs/cli --push --owner X --repo Y\` | Configura workflow, commit, push |
 | \`npx @gitpagedocs/cli --interactive\` / \`-i\` | Modo interactivo con prompts (por defecto en una terminal) |
-| \`npx @gitpagedocs/cli --no-interactive\` / \`-y\` | Nunca pregunta; usa flags y valores por defecto |
+| \`npx @gitpagedocs/cli --no-interactive\` / \`--yes\` / \`-y\` | Nunca pregunta; usa flags y valores por defecto |
+| \`gitpagedocs ai\` | Generador interactivo de documentacion con IA |
+| \`gitpagedocs chat [pregunta]\` | Chat de IA con streaming en la terminal (REPL en TTY; respuesta unica con pregunta o stdin) |
+| \`gitpagedocs provider [id]\` / \`models [provider]\` | Lista proveedores de IA / modelos del catalogo |
+| \`gitpagedocs document[:repo\\|:file\\|:folder]\` | Genera documentacion con IA |
+| \`gitpagedocs deploy\` / \`pages [actions\\|deploy]\` | Configura GitHub Pages via Actions + push |
+| \`gitpagedocs docs\` | Actualiza las regiones gestionadas de README/CONTRIBUTING/SECURITY |
+| \`gitpagedocs password\` | Define la contrasena de acceso a la documentacion (clave publica en \`site.docsAccess\`) |
+| \`gitpagedocs config\` / \`config clear\` | Muestra la config resuelta / borra la config guardada y la boveda de claves |
+| \`gitpagedocs doctor\` / \`version\` / \`update\` | Diagnostico / version / comprobacion de actualizacion en el registro |
+| \`gitpagedocs mcp start\` | Inicia el servidor MCP por stdio |
+
+Instala globalmente con \`npm install -g @gitpagedocs/cli\` o ejecuta sin instalar con \`npx @gitpagedocs/cli\`.
 
 ## Opciones CLI
 
@@ -124,6 +136,7 @@ Referencia completa de opciones CLI, claves de configuracion y funciones del run
 | \`--layoutconfig\` | Genera layouts locales en \`gitpagelayouts/\` |
 | \`--layouts-dir <dir>\` | Carpeta de layouts locales (por defecto: \`gitpagelayouts\`) |
 | \`--push\` | Crea workflow, commit de artefactos, push |
+| \`--pages-actions\` | Solo cambia la fuente de GitHub Pages a GitHub Actions (igual que \`pages actions\`) |
 | \`--home\` | Genera \`gitpagedocshome/\` (estatico + .env + Dockerfile) |
 
 ## Salida generada
@@ -161,6 +174,12 @@ El config de version puede renderizar un contenedor **Codigo fuente** via \`rout
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
 - Idiomas: \`site.languages\` (activa/desactiva cada uno); textos de la UI: \`gitpagedocs/langs/<lang>.json\`
 
+## Reproduccion de medios (un sonido a la vez)
+
+\`site.mediaExclusivePlayback\` (por defecto \`true\`): reproducir un video de ruta pausa la radio y las pistas de audio, y reproducir la radio o una pista de audio pausa el video. Funciona con YouTube y Vimeo (mediante las APIs de sus reproductores), archivos nativos (\`mp4\`, \`webm\`, …) y cualquier otro embed.
+
+Para mostrar un video sin sonido mientras la radio o una pista de audio lo explica, usa \`"muted": true\` en el objeto \`video\` de la ruta: el video reproduce solo la imagen y queda fuera de la regla. \`"mediaExclusivePlayback": false\` desactiva la regla en todo el sitio.
+
 ## Variables de entorno
 
 - \`GITPAGEDOCS_REPOSITORY_SEARCH\` – busqueda de repositorio (local)

package/content/docs-pt.mjs

@@ -95,7 +95,7 @@ Git Page Docs e um monorepo pnpm + turborepo que transforma a pasta \`gitpagedoc
 - Sistema de IA com 14 provedores (OpenAI, Anthropic, Gemini, Ollama, Mistral, DeepSeek, Cohere, Groq, xAI e mais) com streaming
 - Chaves de IA **criptografadas em repouso** (AES-256-GCM) atras de uma senha local — nunca em texto puro
 - **Drawer de chat de IA** nos docs + um **console \`/ai\`** dedicado
-- Sistema de 36 temas; execucao local e no GitHub Pages
+- Sistema de 64 temas (variantes escuras e claras); execucao local e no GitHub Pages
 `,
     functionalities: `# Funcionalidades
 
@@ -110,7 +110,19 @@ Referencia completa de opcoes da CLI, chaves de configuracao e recursos do runti
 | \`npx @gitpagedocs/cli --home\` | Distribuicao standalone (\`gitpagedocshome/\`) |
 | \`npx @gitpagedocs/cli --push --owner X --repo Y\` | Configura workflow, commit, push |
 | \`npx @gitpagedocs/cli --interactive\` / \`-i\` | Modo interativo com prompts (padrao em um terminal) |
-| \`npx @gitpagedocs/cli --no-interactive\` / \`-y\` | Nunca pergunta; usa flags e padroes |
+| \`npx @gitpagedocs/cli --no-interactive\` / \`--yes\` / \`-y\` | Nunca pergunta; usa flags e padroes |
+| \`gitpagedocs ai\` | Gerador interativo de documentacao com IA |
+| \`gitpagedocs chat [pergunta]\` | Chat de IA com streaming no terminal (REPL em TTY; resposta unica com pergunta ou stdin) |
+| \`gitpagedocs provider [id]\` / \`models [provider]\` | Lista provedores de IA / modelos do catalogo |
+| \`gitpagedocs document[:repo\\|:file\\|:folder]\` | Gera documentacao com IA |
+| \`gitpagedocs deploy\` / \`pages [actions\\|deploy]\` | Configura GitHub Pages via Actions + push |
+| \`gitpagedocs docs\` | Atualiza as regioes gerenciadas de README/CONTRIBUTING/SECURITY |
+| \`gitpagedocs password\` | Define a senha de acesso a documentacao (chave publica em \`site.docsAccess\`) |
+| \`gitpagedocs config\` / \`config clear\` | Mostra a config resolvida / apaga a config salva e o cofre de chaves |
+| \`gitpagedocs doctor\` / \`version\` / \`update\` | Diagnostico / versao / verificacao de atualizacao no registro |
+| \`gitpagedocs mcp start\` | Inicia o servidor MCP via stdio |
+
+Instale globalmente com \`npm install -g @gitpagedocs/cli\` ou rode sem instalar com \`npx @gitpagedocs/cli\`.
 
 ## Opcoes da CLI
 
@@ -124,6 +136,7 @@ Referencia completa de opcoes da CLI, chaves de configuracao e recursos do runti
 | \`--layoutconfig\` | Gera layouts locais em \`gitpagelayouts/\` |
 | \`--layouts-dir <dir>\` | Pasta dos layouts locais (padrao: \`gitpagelayouts\`) |
 | \`--push\` | Cria workflow, commit de artefatos, push |
+| \`--pages-actions\` | Apenas muda a fonte do GitHub Pages para GitHub Actions (igual a \`pages actions\`) |
 | \`--home\` | Gera \`gitpagedocshome/\` (estatico + .env + Dockerfile) |
 
 ## Saida gerada
@@ -161,6 +174,12 @@ O config da versao pode renderizar um container **Codigo fonte** via \`routes-so
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
 - Idiomas: \`site.languages\` (liga/desliga cada um); textos da UI: \`gitpagedocs/langs/<lang>.json\`
 
+## Reproducao de midia (um som por vez)
+
+\`site.mediaExclusivePlayback\` (padrao \`true\`): dar play num video de rota pausa o radio e as trilhas de audio, e dar play no radio ou numa trilha de audio pausa o video. Funciona com YouTube e Vimeo (pelas APIs dos players), arquivos nativos (\`mp4\`, \`webm\`, …) e qualquer outro embed.
+
+Para mostrar um video sem som enquanto o radio ou uma trilha de audio o explica, use \`"muted": true\` no objeto \`video\` da rota: o video roda so a imagem e fica fora da regra. \`"mediaExclusivePlayback": false\` desliga a regra no site inteiro.
+
 ## Variaveis de ambiente
 
 - \`GITPAGEDOCS_REPOSITORY_SEARCH\` – busca de repositorio (local)

package/contracts/doc-versions.mjs

@@ -1,3 +1,3 @@
-export const PACKAGE_VERSION = "0.0.7";
+export const PACKAGE_VERSION = "0.0.8";
 
 export const DOC_VERSIONS = [PACKAGE_VERSION];

package/data/default-site-config.mjs

@@ -138,6 +138,7 @@ export function getDefaultSiteConfig(projectLink, languageToggles = buildLanguag
         audioSequentialPlayback: false,
         audioPopoverHideSource: false,
         audioPopoverShowMinutes: true,
+        mediaExclusivePlayback: true,
         AiChatAutoLockSeconds: 30,
         audioTracks: [
             {

package/data/route-metas.mjs

@@ -1,6 +1,8 @@
 /** Route and video metadata for doc versions */
 
 export const DEFAULT_HIERARCHY = { md: 0, "source-viewer": 1, html: 2, video: 3, audio: 4 };
+/** Page order that puts the video container above the markdown. */
+export const VIDEO_FIRST_HIERARCHY = { video: 0, md: 1, "source-viewer": 2, html: 3, audio: 4 };
 
 export const ROUTE_META_ID1 = {
   titles: { pt: "Primeiros passos", en: "Getting Started", es: "Primeros pasos" },

package/package.json

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