@gitpagedocs/cli 1.1.67 → 1.1.69

package/ai/application/ai-command.ts

@@ -5,7 +5,7 @@
 import { ILLMProvider } from '../core/ports/illm-provider';
 
 export class AiCommandService {
-    constructor(private provider: ILLMProvider) { }
+    constructor(private readonly provider: ILLMProvider) { }
 
     /**
      * Executes the AI Documentation Generation for a specific content

package/ai/application/docs-pattern.ts

@@ -14,21 +14,25 @@ export interface AiDocPage {
   body: string;
 }
 
-const PAGE_DELIMITER = /^===\s*PAGE:\s*(.+?)\s*\|\s*(.*?)\s*===\s*$/;
+// Slug is everything up to the first `|`, title everything up to the closing
+// `===`; both are trimmed by the caller. Kept free of overlapping quantifiers
+// so a hostile line cannot make the match super-linear.
+const PAGE_DELIMITER = /^===\s*PAGE:([^|]*)\|(.*)===\s*$/;
 
 /** Turn an arbitrary heading into a safe lowercase-kebab slug. */
 export function slugify(raw: string): string {
   const slug = (raw ?? "")
     .toLowerCase()
     .normalize("NFKD")
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "")
+    .split(/[^a-z0-9]+/)
+    .filter(Boolean)
+    .join("-")
     .slice(0, 60);
   return slug || "page";
 }
 
 export function parseAiPages(markdown: string): AiDocPage[] {
-  const text = (markdown ?? "").replace(/\r\n/g, "\n").trim();
+  const text = (markdown ?? "").replaceAll("\r\n", "\n").trim();
   if (!text) return [];
 
   const pages: AiDocPage[] = [];
@@ -41,7 +45,7 @@ export function parseAiPages(markdown: string): AiDocPage[] {
   };
 
   for (const line of text.split("\n")) {
-    const match = line.match(PAGE_DELIMITER);
+    const match = PAGE_DELIMITER.exec(line);
     if (match) {
       flush();
       const rawSlug = match[1].trim();

package/ai/application/resolve-chat-credentials.ts

@@ -2,6 +2,7 @@ import { legacyProviderToCatalogId, resolveApiKeyFromEnv } from "@gitpagedocs/to
 import type { AiProviderId } from "@gitpagedocs/tools/ports";
 import { PROVIDER_CATALOG } from "@gitpagedocs/tools";
 import { AiConfigFileRepository } from "../infrastructure/ai-config-file";
+import type { AiCliConfig } from "../core/models/ai-cli-config";
 
 export interface ResolvedChatCredentials {
   readonly providerId: AiProviderId;
@@ -35,12 +36,7 @@ export async function resolveChatCredentials(
   const configRepo = input.configRepo ?? new AiConfigFileRepository({ cwd: input.cwd });
   const stored = await configRepo.read().catch(() => null);
 
-  const providerId = input.providerOverride
-    ? legacyProviderToCatalogId(input.providerOverride)
-    : stored
-      ? legacyProviderToCatalogId(stored.ai.provider)
-      : firstProviderFromEnv(env) ?? "openai";
-
+  const providerId = resolveProviderId(input.providerOverride, stored, env);
   const spec = PROVIDER_CATALOG[providerId];
   const model = input.modelOverride?.trim() || stored?.ai.model?.trim() || spec.defaultModel;
   const baseUrl = stored?.ai.baseUrl?.trim() || undefined;
@@ -52,6 +48,17 @@ export async function resolveChatCredentials(
   return { providerId, model, apiKey, baseUrl };
 }
 
+/** Explicit override > stored config > first provider with an env key > openai. */
+function resolveProviderId(
+  override: string | undefined,
+  stored: AiCliConfig | null,
+  env: Readonly<Record<string, string | undefined>>,
+): AiProviderId {
+  if (override) return legacyProviderToCatalogId(override);
+  if (stored) return legacyProviderToCatalogId(stored.ai.provider);
+  return firstProviderFromEnv(env) ?? "openai";
+}
+
 function firstProviderFromEnv(
   env: Readonly<Record<string, string | undefined>>,
 ): AiProviderId | undefined {

package/ai/core/models/parse-ai-cli-config.ts

@@ -1,8 +1,10 @@
 import { AI_MODEL_DEFAULTS, type AiProviderId } from "../../config";
 import type { AiCliConfig } from "./ai-cli-config";
 
-const SUPPORTED_PROVIDERS = Object.keys(AI_MODEL_DEFAULTS) as AiProviderId[];
-const SUPPORTED_LANGUAGES: ReadonlyArray<AiCliConfig["ai"]["languages"][number]> = ["pt", "en", "es"];
+type SupportedLanguage = AiCliConfig["ai"]["languages"][number];
+
+const SUPPORTED_PROVIDERS: ReadonlySet<string> = new Set(Object.keys(AI_MODEL_DEFAULTS));
+const SUPPORTED_LANGUAGES: ReadonlySet<string> = new Set<SupportedLanguage>(["pt", "en", "es"]);
 
 /** Fallbacks for optional fields, mirroring the interactive prompt defaults. */
 const DEFAULT_LANGUAGES: AiCliConfig["ai"]["languages"] = ["en", "pt", "es"];
@@ -27,17 +29,13 @@ function asPaths(value: unknown): string[] {
 
 function asLanguages(value: unknown): AiCliConfig["ai"]["languages"] {
   const languages = Array.isArray(value)
-    ? value.filter((language): language is AiCliConfig["ai"]["languages"][number] =>
-        SUPPORTED_LANGUAGES.includes(language as AiCliConfig["ai"]["languages"][number]),
-      )
+    ? value.filter((language): language is SupportedLanguage => isString(language) && SUPPORTED_LANGUAGES.has(language))
     : [];
   return languages.length > 0 ? languages : [...DEFAULT_LANGUAGES];
 }
 
 function asProviderId(value: unknown): AiProviderId | null {
-  return isString(value) && SUPPORTED_PROVIDERS.includes(value as AiProviderId)
-    ? (value as AiProviderId)
-    : null;
+  return isString(value) && SUPPORTED_PROVIDERS.has(value) ? (value as AiProviderId) : null;
 }
 
 /**

package/application/home/handler.mjs

@@ -1,6 +1,7 @@
 /** Home distribution use case - static site + auxiliary files */
 
 import { STATIC_OUTPUT_DIR, ARTIFACTS_DIR } from "../../home/constants.mjs";
+import { trimSlashes } from "../../contracts/path-segments.mjs";
 
 /**
  * Execute home distribution use case
@@ -30,7 +31,7 @@ export async function executeHome(params, runtime) {
     runtime.ensureDirEmpty(root, outputDir);
   }
 
-  const pathSegment = basePath ? basePath.replace(/^\/+|\/+$/g, "") : "";
+  const pathSegment = basePath ? trimSlashes(basePath) : "";
   const buildEnv = {
     ...process.env,
     GITHUB_ACTIONS: "true",
@@ -83,3 +84,4 @@ export async function executeHome(params, runtime) {
   runtime.logInfo(`Serve: cd ${cdDir} && npx serve .`);
   runtime.logInfo(`Docker: cd ${cdDir} && docker build -t gitpagedocshome . && docker run -p 3000:80 gitpagedocshome`);
 }
+

package/application/ports/cli-runtime-ports.ts

@@ -16,6 +16,8 @@ export interface LayoutDefinition {
 
 export interface BuiltConfigArtifacts {
   rootConfig: unknown;
+  /** UI-string bundle per language, written to `<outputDir>/langs/<lang>.json`. */
+  languageBundles: Record<string, unknown>;
   layoutsConfig: unknown;
   fallbackLayoutsConfig: unknown;
   docs?: Record<string, Record<string, string>>;

package/application/report/config-only-reporter.mjs

@@ -1,9 +1,16 @@
 /** Config-only command output messages - SRP: single place for all report messages */
 import { resolveRenderingUrl } from "../../builders/project-links.mjs";
 import { normalizeLayoutsDir } from "../../contracts/layouts-paths.mjs";
+import { languageArtifactPaths } from "../../contracts/langs-paths.mjs";
+import { SUPPORTED_LANGUAGES } from "../../contracts/languages.mjs";
 
 export function reportConfigOnlySuccess(options) {
-  return [`Generated: ${options.outputDir}/ (config-only)`, "No index.html/index.js generated."];
+  const langs = languageArtifactPaths(options.outputDir);
+  return [
+    `Generated: ${options.outputDir}/ (config-only)`,
+    `UI strings: ${langs.dir}/{${SUPPORTED_LANGUAGES.join(",")}}.json (enable/disable each language in ${langs.config} -> site.languages)`,
+    "No index.html/index.js generated.",
+  ];
 }
 
 export function reportLayoutConfig(options) {
@@ -44,10 +51,7 @@ export function reportPrebuiltDetected() {
 }
 
 export function reportAll(options, prebuiltDetected) {
-  const lines = [];
-  lines.push(...reportConfigOnlySuccess(options));
-  lines.push(...reportLayoutConfig(options));
-  lines.push(...reportRenderingUrl(options));
+  const lines = [...reportConfigOnlySuccess(options), ...reportLayoutConfig(options), ...reportRenderingUrl(options)];
   if (options.shouldPush) {
     lines.push(...reportPushMode());
   }

package/builders/config-orchestrator.mjs

@@ -5,16 +5,16 @@ import { DOCS } from "../content/docs.mjs";
 import { DOC_VERSIONS } from "../data/version-constants.mjs";
 import { buildRootConfig } from "./root-config-builder.mjs";
 import { buildVersionConfig } from "./version-config-builder.mjs";
+import { buildLanguageArtifacts } from "./language-bundles-builder.mjs";
 
 /**
- * Build all config artifacts (root, layouts, versions, docs).
- * @param {object} options - { useLocalLayoutConfig, githubOwner, githubRepo, root }
- * @returns {object} { rootConfig, layoutsConfig, fallbackLayoutsConfig, docs, docsHtml, versionConfigs }
+ * Build all config artifacts (root, languages, layouts, versions, docs).
+ * @param {object} options - { useLocalLayoutConfig, githubOwner, githubRepo, layoutsDir }
+ * @returns {object} { rootConfig, languageBundles, layoutsConfig, fallbackLayoutsConfig, docs, docsHtml, versionConfigs }
  */
 export function buildConfigArtifacts(options = {}) {
-  const root = options.root ?? process.cwd();
-
-  const rootConfig = buildRootConfig(options);
+  const { languageToggles, languageBundles } = buildLanguageArtifacts();
+  const rootConfig = buildRootConfig({ ...options, languageToggles });
   const layoutsConfig = { layouts: LAYOUTS };
   const fallbackLayoutsConfig = { layouts: FALLBACK_LAYOUTS };
 
@@ -25,6 +25,7 @@ export function buildConfigArtifacts(options = {}) {
 
   return {
     rootConfig,
+    languageBundles,
     layoutsConfig,
     fallbackLayoutsConfig,
     docs: DOCS,

package/builders/language-bundles-builder.mjs

@@ -0,0 +1,24 @@
+/** Build the `site.languages` toggles + per-language UI string bundles for gitpagedocs */
+import { buildLanguageToggles, splitLanguageBundles } from "@gitpagedocs/tools/i18n";
+import { SUPPORTED_LANGUAGES } from "../contracts/languages.mjs";
+import { defaultLangMenu } from "../data/i18n-langmenu.mjs";
+import { defaultTranslations } from "../data/i18n-translations.mjs";
+
+function assertLanguageStrings(languages) {
+  const missing = languages.filter((language) => !defaultLangMenu[language]);
+  if (missing.length > 0) {
+    throw new Error(`No UI strings (i18n-langmenu) for supported language(s): ${missing.join(", ")}`);
+  }
+}
+
+/**
+ * @returns {{ languageToggles: Record<string, boolean>, languageBundles: Record<string, object> }}
+ */
+export function buildLanguageArtifacts() {
+  const languages = [...SUPPORTED_LANGUAGES];
+  assertLanguageStrings(languages);
+  return {
+    languageToggles: buildLanguageToggles(languages),
+    languageBundles: splitLanguageBundles(languages, defaultLangMenu, defaultTranslations),
+  };
+}

package/builders/root-config-builder.mjs

@@ -6,10 +6,7 @@ import {
   resolveSourceViewerPath,
   resolveLayoutsLinks,
 } from "./project-links.mjs";
-import { DOCS } from "../content/docs.mjs";
 import { DOC_VERSIONS } from "../data/version-constants.mjs";
-import { defaultLangMenu } from "../data/i18n-langmenu.mjs";
-import { defaultTranslations } from "../data/i18n-translations.mjs";
 import { getDefaultSiteConfig } from "../data/default-site-config.mjs";
 
 export function buildRootConfig(options = {}) {
@@ -37,7 +34,7 @@ export function buildRootConfig(options = {}) {
     "source-viewer-path": sourceViewerPath,
   }));
 
-  const baseSiteConfig = getDefaultSiteConfig(DOCS, projectLink);
+  const baseSiteConfig = getDefaultSiteConfig(projectLink, options.languageToggles);
 
   return {
     site: {
@@ -51,11 +48,9 @@ export function buildRootConfig(options = {}) {
       rendering: renderingUrl,
       AiChatEnabled: true,
       docsAccess: { enabled: false, publicKey: "" },
-      langmenu: defaultLangMenu,
     },
     VersionControl: {
       versions: versionEntries,
     },
-    translations: defaultTranslations,
   };
 }

package/content/docs-en.mjs

@@ -172,9 +172,10 @@ The version config can render a **Source code** container through \`routes-sourc
 
 ## Config keys (site)
 
-- \`name\`, \`defaultLanguage\`, \`supportedLanguages\`
+- \`name\`, \`defaultLanguage\`
 - \`docsVersion\`, \`rendering\`, \`ThemeDefault\`, \`ThemeModeDefault\`
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
+- Languages: \`site.languages\` (enable/disable each one); UI strings: \`gitpagedocs/langs/<lang>.json\`
 
 ## Environment variables
 
@@ -316,7 +317,14 @@ Supported adapters:
 `,
     configuration: `# Configuration
 
-Runtime configuration lives in \`gitpagedocs/config.json\`.
+Runtime configuration lives in \`gitpagedocs/config.json\`. UI text lives next to it, one file per language.
+
+## Languages (\`site.languages\` + \`langs/\`)
+
+- \`site.languages\` in \`gitpagedocs/config.json\` switches each language on (\`true\`) or off (\`false\`), in menu order: \`{ "languages": { "en": true, "pt": true, "es": false } }\`. A language set to \`false\` disappears from the language selector and its strings are not loaded, even when its docs exist.
+- \`gitpagedocs/langs/<lang>.json\` holds that language's strings: \`langmenu\` (header, search, source viewer, audio player, AI chat and docs-access labels) and \`translations\` (\`notFound\`, \`navigation\`, \`footer\`).
+- To add a language, create \`langs/<lang>.json\` and add \`"<lang>": true\` to \`site.languages\`. There is no \`langs.json\` any more: a manifest left by release 1.1.68 is still read by configs without \`site.languages\`, and the generator removes it.
+- Older \`config.json\` files that still inline \`site.langmenu\` / \`translations\` keep working; when both exist, the \`langs/\` files win and any missing key is backfilled from the current release.
 
 ## \`site\` section
 
@@ -324,7 +332,6 @@ Important keys:
 
 - \`name\`
 - \`defaultLanguage\`
-- \`supportedLanguages\`
 - \`docsVersion\`
 - \`rendering\`
 - \`ThemeDefault\`
@@ -453,7 +460,7 @@ A pnpm + turborepo monorepo where all business logic lives in one shared core (\
 
 - **frontend/** — Next.js viewer (Feature-Sliced: \`app / widgets / features / entities / shared\`); static export.
 - **cli/** — the published \`gitpagedocs\` bin (hexagonal: \`presentation / application / domain / infrastructure\`) + \`cli/ai/\` (the AI documentation CLI).
-- **tools/** — \`@gitpagedocs/tools\`: \`ai/ security/ crypto/ cache/ config/ logger/ errors/ filesystem/ documentation/ ports/\`.
+- **tools/** — \`@gitpagedocs/tools\`: \`ai/ security/ crypto/ cache/ config/ logger/ errors/ filesystem/ documentation/ i18n/ ports/\`.
 - **mcp/** — \`@gitpagedocs/mcp\`: MCP tools + resources delegating to \`tools/\`.
 
 ## Main runtime modules (frontend)

package/content/docs-es.mjs

@@ -156,9 +156,10 @@ El config de version puede renderizar un contenedor **Codigo fuente** via \`rout
 
 ## Claves de config (site)
 
-- \`name\`, \`defaultLanguage\`, \`supportedLanguages\`
+- \`name\`, \`defaultLanguage\`
 - \`docsVersion\`, \`rendering\`, \`ThemeDefault\`, \`ThemeModeDefault\`
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
+- Idiomas: \`site.languages\` (activa/desactiva cada uno); textos de la UI: \`gitpagedocs/langs/<lang>.json\`
 
 ## Variables de entorno
 
@@ -167,7 +168,14 @@ El config de version puede renderizar un contenedor **Codigo fuente** via \`rout
 `,
     configuration: `# Configuracion
 
-La configuracion de runtime esta en \`gitpagedocs/config.json\`.
+La configuracion de runtime esta en \`gitpagedocs/config.json\`. Los textos de la UI viven al lado, un archivo por idioma.
+
+## Idiomas (\`site.languages\` + \`langs/\`)
+
+- \`site.languages\` en \`gitpagedocs/config.json\` activa (\`true\`) o desactiva (\`false\`) cada idioma, en el orden del menu: \`{ "languages": { "en": true, "pt": true, "es": false } }\`. Un idioma en \`false\` desaparece del selector de idiomas y sus textos no se cargan, aunque existan sus docs.
+- \`gitpagedocs/langs/<lang>.json\` guarda los textos de ese idioma: \`langmenu\` (cabecera, busqueda, visor de codigo, reproductor de audio, chat de IA y acceso a los docs) y \`translations\` (\`notFound\`, \`navigation\`, \`footer\`).
+- Para agregar un idioma, crea \`langs/<lang>.json\` y agrega \`"<lang>": true\` en \`site.languages\`. Ya no existe \`langs.json\`: un manifiesto dejado por la version 1.1.68 aun se lee en configs antiguos sin \`site.languages\`, y el generador lo elimina.
+- Los \`config.json\` antiguos que aun traen \`site.langmenu\` / \`translations\` inline siguen funcionando; cuando existen ambos, los archivos de \`langs/\` prevalecen y cualquier clave ausente se completa desde la version actual.
 
 ## Seccion \`site\`
 
@@ -175,7 +183,6 @@ Claves principales:
 
 - \`name\`: titulo del proyecto en UI
 - \`defaultLanguage\`: idioma por defecto
-- \`supportedLanguages\`: lista de idiomas disponibles
 - \`HideThemeSelector\`: ocultar/mostrar selector de tema
 - \`ThemeDefault\`: id del tema inicial
 - \`ThemeModeDefault\`: modo inicial (\`light\` o \`dark\`)
@@ -293,7 +300,7 @@ El proyecto esta organizado por fronteras de feature y responsabilidades de runt
 
 - **frontend/** — visor Next.js (Feature-Sliced: app / widgets / features / entities / shared); export estatico.
 - **cli/** — el bin publicado \`gitpagedocs\` (hexagonal) + \`cli/ai/\` (CLI de documentacion con IA).
-- **tools/** — \`@gitpagedocs/tools\`: ai/ security/ crypto/ cache/ config/ logger/ errors/ filesystem/ documentation/ ports/.
+- **tools/** — \`@gitpagedocs/tools\`: ai/ security/ crypto/ cache/ config/ logger/ errors/ filesystem/ documentation/ i18n/ ports/.
 - **mcp/** — \`@gitpagedocs/mcp\`: herramientas + recursos MCP que delegan a tools/.
 
 ## Modulos principales (frontend)

package/content/docs-pt.mjs

@@ -156,9 +156,10 @@ O config da versao pode renderizar um container **Codigo fonte** via \`routes-so
 
 ## Chaves de config (site)
 
-- \`name\`, \`defaultLanguage\`, \`supportedLanguages\`
+- \`name\`, \`defaultLanguage\`
 - \`docsVersion\`, \`rendering\`, \`ThemeDefault\`, \`ThemeModeDefault\`
 - \`ProjectLink\`, \`layoutsConfigPathOficial\`, \`layoutsConfigPath\`
+- Idiomas: \`site.languages\` (liga/desliga cada um); textos da UI: \`gitpagedocs/langs/<lang>.json\`
 
 ## Variaveis de ambiente
 
@@ -167,7 +168,14 @@ O config da versao pode renderizar um container **Codigo fonte** via \`routes-so
 `,
     configuration: `# Configuracao
 
-A configuracao de runtime fica em \`gitpagedocs/config.json\`.
+A configuracao de runtime fica em \`gitpagedocs/config.json\`. Os textos da UI ficam ao lado, um arquivo por idioma.
+
+## Idiomas (\`site.languages\` + \`langs/\`)
+
+- \`site.languages\` em \`gitpagedocs/config.json\` liga (\`true\`) ou desliga (\`false\`) cada idioma, na ordem do menu: \`{ "languages": { "en": true, "pt": true, "es": false } }\`. Um idioma em \`false\` some do seletor de idiomas e seus textos nao sao carregados, mesmo que os docs existam.
+- \`gitpagedocs/langs/<lang>.json\` guarda os textos daquele idioma: \`langmenu\` (cabecalho, busca, visualizador de codigo, player de audio, chat de IA e acesso aos docs) e \`translations\` (\`notFound\`, \`navigation\`, \`footer\`).
+- Para adicionar um idioma, crie \`langs/<lang>.json\` e inclua \`"<lang>": true\` em \`site.languages\`. Nao existe mais \`langs.json\`: um manifesto deixado pela versao 1.1.68 ainda e lido por configs antigos sem \`site.languages\`, e o gerador o remove.
+- Arquivos \`config.json\` antigos que ainda trazem \`site.langmenu\` / \`translations\` inline continuam funcionando; quando os dois existem, os arquivos de \`langs/\` prevalecem e qualquer chave ausente e preenchida a partir da versao atual.
 
 ## Secao \`site\`
 
@@ -175,7 +183,6 @@ Principais chaves:
 
 - \`name\`: titulo do projeto no UI
 - \`defaultLanguage\`: idioma padrao
-- \`supportedLanguages\`: lista de idiomas disponiveis
 - \`HideThemeSelector\`: esconde/mostra seletor de tema
 - \`ThemeDefault\`: id do tema inicial
 - \`ThemeModeDefault\`: modo inicial (\`light\` ou \`dark\`)
@@ -293,7 +300,7 @@ O projeto e organizado por fronteiras de feature e responsabilidades do runtime.
 
 - **frontend/** — visualizador Next.js (Feature-Sliced: app / widgets / features / entities / shared); export estatico.
 - **cli/** — o bin publicado \`gitpagedocs\` (hexagonal) + \`cli/ai/\` (CLI de documentacao com IA).
-- **tools/** — \`@gitpagedocs/tools\`: ai/ security/ crypto/ cache/ config/ logger/ errors/ filesystem/ documentation/ ports/.
+- **tools/** — \`@gitpagedocs/tools\`: ai/ security/ crypto/ cache/ config/ logger/ errors/ filesystem/ documentation/ i18n/ ports/.
 - **mcp/** — \`@gitpagedocs/mcp\`: ferramentas + recursos MCP que delegam ao tools/.
 
 ## Modulos principais (frontend)

package/contracts/doc-versions.mjs

@@ -1,3 +1,3 @@
-export const PACKAGE_VERSION = "1.1.67";
+export const PACKAGE_VERSION = "1.1.69";
 
 export const DOC_VERSIONS = [PACKAGE_VERSION];

package/contracts/langs-paths.mjs

@@ -0,0 +1,28 @@
+/**
+ * Canonical locations for the language artifacts inside the docs output dir:
+ *
+ *   <outputDir>/config.json        `site.languages` — enable (true) / disable (false) each language
+ *   <outputDir>/langs/<lang>.json  UI strings (langmenu + translations) of one language
+ *
+ * `<outputDir>/langs.json` was the 1.1.68 manifest; `site.languages` replaced
+ * it, so the generator deletes a stale copy. The file names come from
+ * @gitpagedocs/tools so the generator and the viewer never disagree about where
+ * the bundles live.
+ */
+import { LANGS_DIRNAME, LANGS_MANIFEST_FILENAME } from "@gitpagedocs/tools/i18n";
+
+/**
+ * Repo-relative POSIX paths of the language artifacts for a docs output dir.
+ *
+ * @param {string} outputDir Docs output dir (e.g. `gitpagedocs`).
+ * @returns {{ config: string, legacyManifest: string, dir: string, bundle: (language: string) => string }}
+ */
+export function languageArtifactPaths(outputDir) {
+  const dir = `${outputDir}/${LANGS_DIRNAME}`;
+  return {
+    config: `${outputDir}/config.json`,
+    legacyManifest: `${outputDir}/${LANGS_MANIFEST_FILENAME}`,
+    dir,
+    bundle: (language) => `${dir}/${language}.json`,
+  };
+}

package/contracts/languages.mjs

@@ -0,0 +1,6 @@
+/**
+ * Languages the generator ships UI strings and docs for, in menu order. This
+ * is the list written to `gitpagedocs/langs.json`; every entry must have a
+ * `langs/<lang>.json` bundle and a docs content module.
+ */
+export const SUPPORTED_LANGUAGES = Object.freeze(["en", "pt", "es"]);

package/contracts/layouts-paths.mjs

@@ -1,3 +1,5 @@
+import { trimSlashes } from "./path-segments.mjs";
+
 /**
  * Canonical locations for layout artifacts.
  *
@@ -34,10 +36,8 @@ export const LEGACY_LAYOUTS_SUBDIR = "layouts";
  * @returns {string} Normalized path, or `DEFAULT_LAYOUTS_DIR` when empty.
  */
 export function normalizeLayoutsDir(dir) {
-  const normalized = String(dir ?? "")
-    .replace(/[\\/]+/g, "/")
-    .replace(/^\/+|\/+$/g, "")
-    .trim();
+  const collapsed = String(dir ?? "").replace(/[\\/]+/g, "/");
+  const normalized = trimSlashes(collapsed).trim();
   return normalized || DEFAULT_LAYOUTS_DIR;
 }
 

package/contracts/path-segments.d.mts

@@ -0,0 +1,2 @@
+/** Strip every leading and trailing `/` from a path segment. */
+export function trimSlashes(value: string): string;

package/contracts/path-segments.mjs

@@ -0,0 +1,15 @@
+/**
+ * Strip every leading and trailing `/` from a user-supplied path segment in a
+ * single forward/backward scan. Same result as `.replace(/^\/+|\/+$/g, "")`
+ * without the super-linear backtracking that regex incurs on long slash runs.
+ *
+ * @param {string} value Raw segment such as "/docs/" or "///".
+ * @returns {string} The segment without surrounding slashes ("" when only slashes).
+ */
+export function trimSlashes(value) {
+  let start = 0;
+  let end = value.length;
+  while (start < end && value[start] === "/") start += 1;
+  while (end > start && value[end - 1] === "/") end -= 1;
+  return value.slice(start, end);
+}

package/data/default-site-config.mjs

@@ -1,8 +1,15 @@
-export function getDefaultSiteConfig(DOCS, projectLink) {
+/**
+ * Site chrome defaults. `languages` enables (true) / disables (false) each
+ * language; the UI strings themselves live in langs/<lang>.json.
+ */
+import { buildLanguageToggles } from "@gitpagedocs/tools/i18n";
+import { SUPPORTED_LANGUAGES } from "../contracts/languages.mjs";
+
+export function getDefaultSiteConfig(projectLink, languageToggles = buildLanguageToggles(SUPPORTED_LANGUAGES)) {
     return {
         name: "Git Pages Docs",
         defaultLanguage: "en",
-        supportedLanguages: Object.keys(DOCS || { en: 1, pt: 1, es: 1 }),
+        languages: { ...languageToggles },
         HideThemeSelector: false,
         ThemeDefault: "aurora-dark",
         ThemeModeDefault: "dark",

package/domain/services/layouts-migration.mjs

@@ -56,5 +56,19 @@ function toSortedPaths(paths) {
   const normalized = paths
     .filter((entry) => typeof entry === "string" && entry.trim().length > 0)
     .map((entry) => entry.replace(/[\\/]+/g, "/").replace(/^\/+/, ""));
-  return [...new Set(normalized)].sort();
+  return [...new Set(normalized)].sort(compareCodeUnits);
+}
+
+/**
+ * Plain UTF-16 code-unit order (what `sort()` does by default), spelled out so
+ * a plan never depends on the runtime locale.
+ *
+ * @param {string} a
+ * @param {string} b
+ * @returns {number}
+ */
+function compareCodeUnits(a, b) {
+  if (a < b) return -1;
+  if (a > b) return 1;
+  return 0;
 }

package/home/home-file-writer.mjs

@@ -1,8 +1,7 @@
 /** Write .env, Dockerfile, README to home output directory */
 
 import path from "node:path";
-import { mkdir } from "node:fs/promises";
-import { writeFile } from "node:fs/promises";
+import { mkdir, writeFile } from "node:fs/promises";
 import { getEnvTemplate, getDockerfileTemplate, getReadmeTemplate } from "./templates.mjs";
 
 /**
@@ -16,5 +15,5 @@ export async function writeHomeFiles(root, outputDir, opts = {}) {
 
   await writeFile(path.join(basePath, ".env"), getEnvTemplate(opts), "utf-8");
   await writeFile(path.join(basePath, "Dockerfile"), getDockerfileTemplate(), "utf-8");
-  await writeFile(path.join(basePath, "README.md"), getReadmeTemplate({ outputDir }), "utf-8");
+  await writeFile(path.join(basePath, "README.md"), getReadmeTemplate(), "utf-8");
 }

package/home/templates.mjs

@@ -22,8 +22,11 @@ CMD ["nginx", "-g", "daemon off;"]
 `;
 }
 
-export function getReadmeTemplate({ outputDir = "gitpagedocshome" }) {
-  const cdDir = outputDir === "." || outputDir === "./" ? "." : outputDir;
+/**
+ * README shipped next to the static export. Every command runs from the
+ * folder the file lives in, so it never needs to know the output dir name.
+ */
+export function getReadmeTemplate() {
   return `# GitPageDocs Home
 
 Pre-built GitPageDocs static site by Vidigal-code.

package/infrastructure/home/runtime.mjs

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { cpSync, existsSync, readdirSync, rmSync } from "node:fs";
-import { execSync } from "node:child_process";
+import { runExecutable } from "../../runtime/exec.mjs";
 import { writeConfigOnlyOutput, writeText } from "../../runtime/output.mjs";
 import { writeHomeFiles } from "../../home/home-file-writer.mjs";
 import { logInfo, logSuccess } from "../../ui/logger.mjs";
@@ -17,7 +17,7 @@ function copyRecursive(src, dest) {
 }
 
 function runNextBuild(root, env) {
-  execSync("npx next build frontend", { cwd: root, env, stdio: "inherit" });
+  runExecutable("npx", ["next", "build", "frontend"], { cwd: root, env, stdio: "inherit" });
 }
 
 export function createHomeRuntime() {

package/package.json

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