@gitpagedocs/cli 1.1.62 → 1.1.63

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

@@ -1,64 +1,64 @@
-/** 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";
-
-export function reportConfigOnlySuccess(options) {
-  return [`Generated: ${options.outputDir}/ (config-only)`, "No index.html/index.js generated."];
-}
-
-export function reportLayoutConfig(options) {
-  const layoutsDir = normalizeLayoutsDir(options.layoutsDir);
-  if (options.useLocalLayoutConfig) {
-    return [`Local layouts generated in ${layoutsDir}/ (--layoutconfig).`];
-  }
-  return [`Using official remote layouts config by default (no local ${layoutsDir}/ generated).`];
-}
-
-export function reportRenderingUrl(options) {
-  if (options.githubOwner && options.githubRepo) {
-    return [
-      `Configured rendering URL: ${resolveRenderingUrl(options.githubOwner, options.githubRepo)}`,
-      `Official viewer remains available: https://vidigal-code.github.io/git-page-docs/${options.githubOwner}/${options.githubRepo}?modetheme=light&lang=pt`,
-    ];
-  }
-  return [];
-}
-
-export function reportPushMode() {
-  return [
-    "Generated: .github/workflows/gitpagedocs-pages.yml",
-    "Push mode enabled: committed and pushed gitpagedocs/ + workflow to origin.",
-  ];
-}
-
-export function reportBuildFlag() {
-  return ["`--build` keeps compatibility flag but output remains gitpagedocs/."];
-}
-
-export function reportFullOrServeSkipped() {
-  return ["External commands were skipped (no prebuilt copy and no local serve spawn)."];
-}
-
-export function reportPrebuiltDetected() {
-  return ["`prebuilt/` detected, but ignored by config-only generator."];
-}
-
-export function reportAll(options, prebuiltDetected) {
-  const lines = [];
-  lines.push(...reportConfigOnlySuccess(options));
-  lines.push(...reportLayoutConfig(options));
-  lines.push(...reportRenderingUrl(options));
-  if (options.shouldPush) {
-    lines.push(...reportPushMode());
-  }
-  if (options.isBuild) {
-    lines.push(...reportBuildFlag());
-  }
-  if (options.mode === "full" || options.isServe) {
-    lines.push(...reportFullOrServeSkipped());
-  }
-  if (prebuiltDetected) {
-    lines.push(...reportPrebuiltDetected());
-  }
-  return lines;
-}
+/** 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";
+
+export function reportConfigOnlySuccess(options) {
+  return [`Generated: ${options.outputDir}/ (config-only)`, "No index.html/index.js generated."];
+}
+
+export function reportLayoutConfig(options) {
+  const layoutsDir = normalizeLayoutsDir(options.layoutsDir);
+  if (options.useLocalLayoutConfig) {
+    return [`Local layouts generated in ${layoutsDir}/ (--layoutconfig).`];
+  }
+  return [`Using official remote layouts config by default (no local ${layoutsDir}/ generated).`];
+}
+
+export function reportRenderingUrl(options) {
+  if (options.githubOwner && options.githubRepo) {
+    return [
+      `Configured rendering URL: ${resolveRenderingUrl(options.githubOwner, options.githubRepo)}`,
+      `Official viewer remains available: https://vidigal-code.github.io/git-page-docs/${options.githubOwner}/${options.githubRepo}?modetheme=light&lang=pt`,
+    ];
+  }
+  return [];
+}
+
+export function reportPushMode() {
+  return [
+    "Generated: .github/workflows/gitpagedocs-pages.yml",
+    "Push mode enabled: committed and pushed gitpagedocs/ + workflow to origin.",
+  ];
+}
+
+export function reportBuildFlag() {
+  return ["`--build` keeps compatibility flag but output remains gitpagedocs/."];
+}
+
+export function reportFullOrServeSkipped() {
+  return ["External commands were skipped (no prebuilt copy and no local serve spawn)."];
+}
+
+export function reportPrebuiltDetected() {
+  return ["`prebuilt/` detected, but ignored by config-only generator."];
+}
+
+export function reportAll(options, prebuiltDetected) {
+  const lines = [];
+  lines.push(...reportConfigOnlySuccess(options));
+  lines.push(...reportLayoutConfig(options));
+  lines.push(...reportRenderingUrl(options));
+  if (options.shouldPush) {
+    lines.push(...reportPushMode());
+  }
+  if (options.isBuild) {
+    lines.push(...reportBuildFlag());
+  }
+  if (options.mode === "full" || options.isServe) {
+    lines.push(...reportFullOrServeSkipped());
+  }
+  if (prebuiltDetected) {
+    lines.push(...reportPrebuiltDetected());
+  }
+  return lines;
+}

package/application/use-cases/dispatch-mode.ts

@@ -1,18 +1,18 @@
-import type { CliOptions } from "../../domain/models/cli-options";
-import type { CliCommandRunner, CliRuntimeParams } from "../ports/cli-runtime-ports";
-
-export async function dispatchMode(
-  options: CliOptions,
-  params: CliRuntimeParams,
-  runner: CliCommandRunner,
-): Promise<void> {
-  if (options.mode === "ai") {
-    await runner.runAi({ ...params, options });
-    return;
-  }
-  if (options.mode === "home") {
-    await runner.runHome({ ...params, options });
-    return;
-  }
-  await runner.runConfigOnly({ ...params, options });
-}
+import type { CliOptions } from "../../domain/models/cli-options";
+import type { CliCommandRunner, CliRuntimeParams } from "../ports/cli-runtime-ports";
+
+export async function dispatchMode(
+  options: CliOptions,
+  params: CliRuntimeParams,
+  runner: CliCommandRunner,
+): Promise<void> {
+  if (options.mode === "ai") {
+    await runner.runAi({ ...params, options });
+    return;
+  }
+  if (options.mode === "home") {
+    await runner.runHome({ ...params, options });
+    return;
+  }
+  await runner.runConfigOnly({ ...params, options });
+}

package/builders/config-orchestrator.mjs

@@ -1,34 +1,34 @@
-/** Orchestrate build of config artifacts for gitpagedocs */
-
-import { LAYOUTS, FALLBACK_LAYOUTS } from "../data/layouts.mjs";
-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";
-
-/**
- * Build all config artifacts (root, layouts, versions, docs).
- * @param {object} options - { useLocalLayoutConfig, githubOwner, githubRepo, root }
- * @returns {object} { rootConfig, layoutsConfig, fallbackLayoutsConfig, docs, docsHtml, versionConfigs }
- */
-export function buildConfigArtifacts(options = {}) {
-  const root = options.root ?? process.cwd();
-
-  const rootConfig = buildRootConfig(options);
-  const layoutsConfig = { layouts: LAYOUTS };
-  const fallbackLayoutsConfig = { layouts: FALLBACK_LAYOUTS };
-
-  const versionConfigs = {};
-  for (const versionId of DOC_VERSIONS) {
-    versionConfigs[versionId] = buildVersionConfig(versionId, options);
-  }
-
-  return {
-    rootConfig,
-    layoutsConfig,
-    fallbackLayoutsConfig,
-    docs: DOCS,
-    docsHtml: {},
-    versionConfigs,
-  };
-}
+/** Orchestrate build of config artifacts for gitpagedocs */
+
+import { LAYOUTS, FALLBACK_LAYOUTS } from "../data/layouts.mjs";
+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";
+
+/**
+ * Build all config artifacts (root, layouts, versions, docs).
+ * @param {object} options - { useLocalLayoutConfig, githubOwner, githubRepo, root }
+ * @returns {object} { rootConfig, layoutsConfig, fallbackLayoutsConfig, docs, docsHtml, versionConfigs }
+ */
+export function buildConfigArtifacts(options = {}) {
+  const root = options.root ?? process.cwd();
+
+  const rootConfig = buildRootConfig(options);
+  const layoutsConfig = { layouts: LAYOUTS };
+  const fallbackLayoutsConfig = { layouts: FALLBACK_LAYOUTS };
+
+  const versionConfigs = {};
+  for (const versionId of DOC_VERSIONS) {
+    versionConfigs[versionId] = buildVersionConfig(versionId, options);
+  }
+
+  return {
+    rootConfig,
+    layoutsConfig,
+    fallbackLayoutsConfig,
+    docs: DOCS,
+    docsHtml: {},
+    versionConfigs,
+  };
+}

package/builders/project-links.mjs

@@ -1,50 +1,50 @@
-/** Shared derivation of project URLs from CLI options (single source of truth
- * for root and version config builders). */
-
-import { layoutsArtifactPaths } from "../contracts/layouts-paths.mjs";
-
-export const DEFAULT_PROJECT_LINK = "https://github.com/Vidigal-code/git-page-docs";
-export const DEFAULT_RENDERING_URL = "https://vidigal-code.github.io/git-page-docs/";
-
-export function resolveProjectLink(githubOwner, githubRepo) {
-  return githubOwner && githubRepo
-    ? `https://github.com/${githubOwner}/${githubRepo}`
-    : DEFAULT_PROJECT_LINK;
-}
-
-export function resolveRenderingUrl(githubOwner, githubRepo) {
-  return githubOwner && githubRepo
-    ? `https://${githubOwner}.github.io/${githubRepo}/`
-    : DEFAULT_RENDERING_URL;
-}
-
-/**
- * Where the viewer should look for locally generated layouts.
- *
- * Mirrors resolveSourceViewerPath: user repositories use the symbolic HEAD ref
- * so any default branch resolves. Without an owner/repo pair there is no URL to
- * build, so the repo-relative path is returned - the viewer reads it directly in
- * local mode and still discovers it by probing the repository otherwise.
- *
- * @param {string} githubOwner
- * @param {string} githubRepo
- * @param {string} layoutsDir Repo-relative layouts home.
- * @returns {{ config: string, templates: string }}
- */
-export function resolveLayoutsLinks(githubOwner, githubRepo, layoutsDir) {
-  const paths = layoutsArtifactPaths(layoutsDir);
-  if (!githubOwner || !githubRepo) {
-    return { config: paths.config, templates: paths.templates };
-  }
-  const base = `${resolveProjectLink(githubOwner, githubRepo)}/blob/HEAD`;
-  return { config: `${base}/${paths.config}`, templates: `${base}/${paths.templates}` };
-}
-
-export function resolveSourceViewerPath(githubOwner, githubRepo) {
-  // User repositories use the symbolic HEAD ref so any default branch works
-  // (github.com, the trees API and raw.githubusercontent all accept it);
-  // the official repository keeps its stable main link.
-  return githubOwner && githubRepo
-    ? `${resolveProjectLink(githubOwner, githubRepo)}/tree/HEAD`
-    : `${DEFAULT_PROJECT_LINK}/tree/main`;
-}
+/** Shared derivation of project URLs from CLI options (single source of truth
+ * for root and version config builders). */
+
+import { layoutsArtifactPaths } from "../contracts/layouts-paths.mjs";
+
+export const DEFAULT_PROJECT_LINK = "https://github.com/Vidigal-code/git-page-docs";
+export const DEFAULT_RENDERING_URL = "https://vidigal-code.github.io/git-page-docs/";
+
+export function resolveProjectLink(githubOwner, githubRepo) {
+  return githubOwner && githubRepo
+    ? `https://github.com/${githubOwner}/${githubRepo}`
+    : DEFAULT_PROJECT_LINK;
+}
+
+export function resolveRenderingUrl(githubOwner, githubRepo) {
+  return githubOwner && githubRepo
+    ? `https://${githubOwner}.github.io/${githubRepo}/`
+    : DEFAULT_RENDERING_URL;
+}
+
+/**
+ * Where the viewer should look for locally generated layouts.
+ *
+ * Mirrors resolveSourceViewerPath: user repositories use the symbolic HEAD ref
+ * so any default branch resolves. Without an owner/repo pair there is no URL to
+ * build, so the repo-relative path is returned - the viewer reads it directly in
+ * local mode and still discovers it by probing the repository otherwise.
+ *
+ * @param {string} githubOwner
+ * @param {string} githubRepo
+ * @param {string} layoutsDir Repo-relative layouts home.
+ * @returns {{ config: string, templates: string }}
+ */
+export function resolveLayoutsLinks(githubOwner, githubRepo, layoutsDir) {
+  const paths = layoutsArtifactPaths(layoutsDir);
+  if (!githubOwner || !githubRepo) {
+    return { config: paths.config, templates: paths.templates };
+  }
+  const base = `${resolveProjectLink(githubOwner, githubRepo)}/blob/HEAD`;
+  return { config: `${base}/${paths.config}`, templates: `${base}/${paths.templates}` };
+}
+
+export function resolveSourceViewerPath(githubOwner, githubRepo) {
+  // User repositories use the symbolic HEAD ref so any default branch works
+  // (github.com, the trees API and raw.githubusercontent all accept it);
+  // the official repository keeps its stable main link.
+  return githubOwner && githubRepo
+    ? `${resolveProjectLink(githubOwner, githubRepo)}/tree/HEAD`
+    : `${DEFAULT_PROJECT_LINK}/tree/main`;
+}

package/builders/root-config-builder.mjs

@@ -1,61 +1,61 @@
-/** Build root config for gitpagedocs */
-import { OFFICIAL_LAYOUTS_CONFIG_URL, OFFICIAL_LAYOUTS_TEMPLATES_URL } from "../data/urls.mjs";
-import {
-  resolveProjectLink,
-  resolveRenderingUrl,
-  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 = {}) {
-  const useLocalLayoutConfig = Boolean(options.useLocalLayoutConfig);
-  const useOfficialLayouts = !useLocalLayoutConfig;
-  const githubOwner = options.githubOwner;
-  const githubRepo = options.githubRepo;
-  const repositorySearchHome = true;
-  const renderingUrl = resolveRenderingUrl(githubOwner, githubRepo);
-  const projectLink = resolveProjectLink(githubOwner, githubRepo);
-  const sourceViewerPath = resolveSourceViewerPath(githubOwner, githubRepo);
-  const layoutsLinks = resolveLayoutsLinks(githubOwner, githubRepo, options.layoutsDir);
-
-  const versionEntries = DOC_VERSIONS.map((id) => ({
-    id,
-    path: `gitpagedocs/docs/versions/${id}/config.json`,
-    ProjectLink: projectLink,
-    PathConfig: `gitpagedocs/docs/versions/${id}/config.json`,
-    PreviewProject: "",
-    UpdateDate: "",
-    branch: "",
-    release: "",
-    commit: "",
-    "source-viewer": true,
-    "source-viewer-path": sourceViewerPath,
-  }));
-
-  const baseSiteConfig = getDefaultSiteConfig(DOCS, projectLink);
-
-  return {
-    site: {
-      ...baseSiteConfig,
-      layoutsConfigPathOficial: useOfficialLayouts,
-      layoutsConfigPathTemplatesOficial: useOfficialLayouts ? OFFICIAL_LAYOUTS_TEMPLATES_URL : "",
-      layoutsConfigPathOficialUrl: useOfficialLayouts ? OFFICIAL_LAYOUTS_CONFIG_URL : "",
-      layoutsConfigPath: useLocalLayoutConfig ? layoutsLinks.config : "",
-      layoutsConfigPathTemplates: useLocalLayoutConfig ? layoutsLinks.templates : "",
-      repositorySearchHome,
-      rendering: renderingUrl,
-      AiChatEnabled: true,
-      docsAccess: { enabled: false, publicKey: "" },
-      langmenu: defaultLangMenu,
-    },
-    VersionControl: {
-      versions: versionEntries,
-    },
-    translations: defaultTranslations,
-  };
-}
+/** Build root config for gitpagedocs */
+import { OFFICIAL_LAYOUTS_CONFIG_URL, OFFICIAL_LAYOUTS_TEMPLATES_URL } from "../data/urls.mjs";
+import {
+  resolveProjectLink,
+  resolveRenderingUrl,
+  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 = {}) {
+  const useLocalLayoutConfig = Boolean(options.useLocalLayoutConfig);
+  const useOfficialLayouts = !useLocalLayoutConfig;
+  const githubOwner = options.githubOwner;
+  const githubRepo = options.githubRepo;
+  const repositorySearchHome = true;
+  const renderingUrl = resolveRenderingUrl(githubOwner, githubRepo);
+  const projectLink = resolveProjectLink(githubOwner, githubRepo);
+  const sourceViewerPath = resolveSourceViewerPath(githubOwner, githubRepo);
+  const layoutsLinks = resolveLayoutsLinks(githubOwner, githubRepo, options.layoutsDir);
+
+  const versionEntries = DOC_VERSIONS.map((id) => ({
+    id,
+    path: `gitpagedocs/docs/versions/${id}/config.json`,
+    ProjectLink: projectLink,
+    PathConfig: `gitpagedocs/docs/versions/${id}/config.json`,
+    PreviewProject: "",
+    UpdateDate: "",
+    branch: "",
+    release: "",
+    commit: "",
+    "source-viewer": true,
+    "source-viewer-path": sourceViewerPath,
+  }));
+
+  const baseSiteConfig = getDefaultSiteConfig(DOCS, projectLink);
+
+  return {
+    site: {
+      ...baseSiteConfig,
+      layoutsConfigPathOficial: useOfficialLayouts,
+      layoutsConfigPathTemplatesOficial: useOfficialLayouts ? OFFICIAL_LAYOUTS_TEMPLATES_URL : "",
+      layoutsConfigPathOficialUrl: useOfficialLayouts ? OFFICIAL_LAYOUTS_CONFIG_URL : "",
+      layoutsConfigPath: useLocalLayoutConfig ? layoutsLinks.config : "",
+      layoutsConfigPathTemplates: useLocalLayoutConfig ? layoutsLinks.templates : "",
+      repositorySearchHome,
+      rendering: renderingUrl,
+      AiChatEnabled: true,
+      docsAccess: { enabled: false, publicKey: "" },
+      langmenu: defaultLangMenu,
+    },
+    VersionControl: {
+      versions: versionEntries,
+    },
+    translations: defaultTranslations,
+  };
+}