radiant-docs 0.1.64 → 0.1.66

package/template/scripts/generate-og-metadata.mjs

@@ -1,206 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import {
-  DEFAULT_TEXT_FONT_PRESET,
-  FONT_PRESET_OPTIONS,
-} from "radiant-docs-validator";
-
-const CWD = process.cwd();
-const DIST_DIR = path.join(CWD, "dist");
-const DOCS_CONFIG_PATH = path.join(CWD, "src/content/docs/docs.json");
-const OUTPUT_DIR = path.join(DIST_DIR, "_og");
-const OUTPUT_PATH = path.join(OUTPUT_DIR, "meta.json");
-const FONT_PRESET_ID_SET = new Set(FONT_PRESET_OPTIONS);
-
-function readDocsConfig() {
-  if (!fs.existsSync(DOCS_CONFIG_PATH)) {
-    return {};
-  }
-
-  try {
-    const raw = fs.readFileSync(DOCS_CONFIG_PATH, "utf8");
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
-}
-
-function findHtmlFiles(dir, files = []) {
-  if (!fs.existsSync(dir)) return files;
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      findHtmlFiles(fullPath, files);
-      continue;
-    }
-
-    if (entry.isFile() && entry.name.endsWith(".html")) {
-      files.push(fullPath);
-    }
-  }
-
-  return files;
-}
-
-function normalizeRoutePath(routePath) {
-  if (!routePath || routePath === "/") return "/";
-  if (!routePath.startsWith("/")) routePath = `/${routePath}`;
-  return routePath.endsWith("/") ? routePath : `${routePath}/`;
-}
-
-function routePathFromHtmlPath(filePath) {
-  const relative = path.relative(DIST_DIR, filePath).replace(/\\/g, "/");
-
-  if (relative === "index.html") return "/";
-  if (relative.endsWith("/index.html")) {
-    const base = relative.slice(0, -"/index.html".length);
-    return normalizeRoutePath(base);
-  }
-
-  if (relative.endsWith(".html")) {
-    return normalizeRoutePath(relative.slice(0, -".html".length));
-  }
-
-  return "/";
-}
-
-function matchMetaContent(html, attrName, attrValue) {
-  const regex = new RegExp(
-    `<meta\\s+[^>]*${attrName}\\s*=\\s*["']${attrValue}["'][^>]*content\\s*=\\s*["']([^"']*)["'][^>]*>`,
-    "i",
-  );
-  const reverseRegex = new RegExp(
-    `<meta\\s+[^>]*content\\s*=\\s*["']([^"']*)["'][^>]*${attrName}\\s*=\\s*["']${attrValue}["'][^>]*>`,
-    "i",
-  );
-  return html.match(regex)?.[1] ?? html.match(reverseRegex)?.[1] ?? "";
-}
-
-function decodeHtmlEntities(value) {
-  if (!value || typeof value !== "string") return "";
-
-  const named = {
-    amp: "&",
-    lt: "<",
-    gt: ">",
-    quot: '"',
-    apos: "'",
-    nbsp: " ",
-  };
-
-  return value
-    .replace(/&#(\d+);/g, (_, dec) => {
-      const code = Number.parseInt(dec, 10);
-      return Number.isFinite(code) ? String.fromCodePoint(code) : _;
-    })
-    .replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => {
-      const code = Number.parseInt(hex, 16);
-      return Number.isFinite(code) ? String.fromCodePoint(code) : _;
-    })
-    .replace(/&([a-zA-Z]+);/g, (entity, name) => {
-      const decoded = named[name.toLowerCase()];
-      return decoded ?? entity;
-    });
-}
-
-function getLogoImagePath(variant) {
-  if (typeof variant === "string") return variant.trim();
-  if (!variant || typeof variant !== "object") return "";
-  return typeof variant.image === "string" ? variant.image.trim() : "";
-}
-
-function normalizeFontPresetId(value) {
-  if (typeof value !== "string") return undefined;
-  const normalized = value.trim().toLowerCase();
-  return FONT_PRESET_ID_SET.has(normalized) ? normalized : undefined;
-}
-
-function resolveOgFonts(docsConfig) {
-  const theme =
-    docsConfig?.theme && typeof docsConfig.theme === "object"
-      ? docsConfig.theme
-      : {};
-  const fonts =
-    theme.fonts && typeof theme.fonts === "object" && !Array.isArray(theme.fonts)
-      ? theme.fonts
-      : {};
-  const text = normalizeFontPresetId(fonts.text) ?? DEFAULT_TEXT_FONT_PRESET;
-
-  return {
-    text,
-    heading: normalizeFontPresetId(fonts.heading) ?? text,
-  };
-}
-
-function extractTitle(html) {
-  const ogTitle = decodeHtmlEntities(
-    matchMetaContent(html, "property", "og:title"),
-  ).trim();
-  if (ogTitle) return ogTitle;
-  return decodeHtmlEntities(
-    html.match(/<title>([^<]*)<\/title>/i)?.[1] ?? "",
-  ).trim();
-}
-
-function extractDescription(html) {
-  const description = decodeHtmlEntities(
-    matchMetaContent(html, "name", "description"),
-  ).trim();
-  if (description) return description;
-  return decodeHtmlEntities(
-    matchMetaContent(html, "property", "og:description"),
-  ).trim();
-}
-
-function main() {
-  if (!fs.existsSync(DIST_DIR)) {
-    console.warn("Skipping OG metadata generation: dist directory not found.");
-    return;
-  }
-
-  const docsConfig = readDocsConfig();
-  const logo = typeof docsConfig.logo === "object" && docsConfig.logo
-    ? docsConfig.logo
-    : {};
-
-  const htmlFiles = findHtmlFiles(DIST_DIR);
-  htmlFiles.sort();
-  const pages = {};
-
-  for (const filePath of htmlFiles) {
-    const routePath = routePathFromHtmlPath(filePath);
-    const html = fs.readFileSync(filePath, "utf8");
-
-    pages[routePath] = {
-      title: extractTitle(html),
-      description: extractDescription(html),
-    };
-  }
-
-  const metadata = {
-    defaults: {
-      siteName:
-        typeof docsConfig.title === "string" ? docsConfig.title.trim() : "",
-      logoLight: getLogoImagePath(logo.light),
-      logoDark: getLogoImagePath(logo.dark),
-      background:
-        typeof docsConfig.ogBackground === "string"
-          ? docsConfig.ogBackground.trim()
-          : "",
-      primaryColor:
-        typeof docsConfig.primaryColor === "string"
-          ? docsConfig.primaryColor.trim()
-          : "",
-      fonts: resolveOgFonts(docsConfig),
-    },
-    pages,
-  };
-
-  fs.mkdirSync(OUTPUT_DIR, { recursive: true });
-  fs.writeFileSync(OUTPUT_PATH, JSON.stringify(metadata, null, 2), "utf8");
-  console.log(`✅ Generated OG metadata at ${OUTPUT_PATH}`);
-}
-
-main();

package/template/scripts/generate-proxy-allowed-origins.mjs

@@ -1,48 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { buildAllowedOrigins } from "../src/lib/proxy-allowed-origins.mjs";
-
-const CWD = process.cwd();
-const OUTPUT_DIR = path.join(CWD, ".radiant");
-const OUTPUT_FILE = path.join(OUTPUT_DIR, "proxy-allowed-origins.json");
-
-async function run() {
-  let allowedOrigins = [];
-
-  try {
-    allowedOrigins = await buildAllowedOrigins({
-      cwd: CWD,
-      onSourceError(source, error) {
-        console.warn(
-          `⚠️ Failed to extract OpenAPI server origins from "${source}":`,
-          error instanceof Error ? error.message : String(error),
-        );
-      },
-    });
-  } catch (error) {
-    console.warn(
-      "⚠️ Failed to generate proxy allowed origins. Falling back to empty allowlist.",
-      error instanceof Error ? error.message : String(error),
-    );
-    allowedOrigins = [];
-  }
-
-  await fs.mkdir(OUTPUT_DIR, { recursive: true });
-  await fs.writeFile(
-    OUTPUT_FILE,
-    `${JSON.stringify(allowedOrigins, null, 2)}\n`,
-    "utf8",
-  );
-
-  console.log(
-    `✅ Wrote ${allowedOrigins.length} proxy allowed origins to ${path.relative(CWD, OUTPUT_FILE)}`,
-  );
-}
-
-run().catch((error) => {
-  console.error(
-    "❌ Failed to write proxy allowed origins manifest:",
-    error instanceof Error ? error.message : String(error),
-  );
-  process.exit(1);
-});

package/template/scripts/generate-robots-txt.mjs

@@ -1,47 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-
-const CWD = process.cwd();
-const DIST_DIR = path.join(CWD, "dist");
-const ROBOTS_TXT_PATH = path.join(DIST_DIR, "robots.txt");
-const ASTRO_SITEMAP_INDEX_FILENAME = "sitemap-index.xml";
-const PUBLIC_SITEMAP_FILENAME = "sitemap.xml";
-
-function buildSitemapUrl() {
-  const configuredSiteUrl = process.env.DOCS_SITE_URL?.trim();
-  if (!configuredSiteUrl) {
-    return `/${PUBLIC_SITEMAP_FILENAME}`;
-  }
-
-  try {
-    const baseUrl = configuredSiteUrl.endsWith("/")
-      ? configuredSiteUrl
-      : `${configuredSiteUrl}/`;
-    return new URL(PUBLIC_SITEMAP_FILENAME, baseUrl).toString();
-  } catch {
-    return `/${PUBLIC_SITEMAP_FILENAME}`;
-  }
-}
-
-function main() {
-  if (!fs.existsSync(DIST_DIR)) {
-    console.log("Skipping robots.txt generation: dist directory not found.");
-    return;
-  }
-
-  const astroSitemapIndexPath = path.join(
-    DIST_DIR,
-    ASTRO_SITEMAP_INDEX_FILENAME,
-  );
-  const publicSitemapPath = path.join(DIST_DIR, PUBLIC_SITEMAP_FILENAME);
-  if (fs.existsSync(astroSitemapIndexPath)) {
-    fs.copyFileSync(astroSitemapIndexPath, publicSitemapPath);
-    console.log("✅ sitemap.xml alias generated.");
-  }
-
-  const robotsTxt = `User-agent: *\nAllow: /\nSitemap: ${buildSitemapUrl()}\n`;
-  fs.writeFileSync(ROBOTS_TXT_PATH, robotsTxt, "utf8");
-  console.log("✅ robots.txt generated.");
-}
-
-main();