@docubook/flame 2.0.0-beta.0 → 2.0.0-beta.2

package/.docu/lib/chunk-D3QTSBR4.js

@@ -1,434 +0,0 @@
-import {
-  BuildPluginBuilder,
-  DocsLayout,
-  DocsPage,
-  IndexPage,
-  NotFoundPage,
-  buildClientBundle,
-  captureException,
-  compileMdx,
-  computeInlineThemeCss,
-  errorHtml,
-  frontmatterField,
-  generateSearchIndex,
-  hmrScript,
-  htmlShell,
-  initSentry,
-  loadPlugins
-} from "./chunk-LXJLSXQI.js";
-import {
-  SECURITY_HEADERS,
-  generateNonce,
-  getContentType,
-  htmlResponse,
-  isPathSafe,
-  isSlugSafe,
-  stripDocsHtmlSuffix,
-  wrapPluginResponse
-} from "./chunk-EOK6KATZ.js";
-import {
-  logger
-} from "./chunk-IVM5UM44.js";
-import {
-  DIST_DIR,
-  DOCS_DIR,
-  PROJECT_ROOT,
-  loadDocuConfig
-} from "./chunk-4IQXHHPF.js";
-
-// .docu/node/server.impl.ts
-import { watch, existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { createRequire } from "node:module";
-
-// .docu/node/server-routes.ts
-import { readFile, stat } from "node:fs/promises";
-import { resolve } from "node:path";
-import { readFileSync, statSync } from "node:fs";
-import React from "react";
-import { renderToString } from "react-dom/server";
-function createHtmlResponse(title, description, body, status, state, depth = 0) {
-  const nonce = generateNonce();
-  const favicon = state.docuConfig.meta?.favicon || "/favicon.ico";
-  const html = htmlShell({
-    title,
-    description,
-    body,
-    favicon,
-    css: state.assetManifest.css,
-    js: state.assetManifest.js,
-    nonce,
-    extraScripts: hmrScript(nonce),
-    themeCss: state.inlineThemeCss,
-    depth,
-    // 404 pages can be requested at arbitrary depths (e.g. a noLink section
-    // path typed in the address bar) — relative asset paths would resolve
-    // against the wrong directory and break CSS/JS.
-    absoluteAssets: status === 404
-  });
-  return htmlResponse(html, nonce, status, true);
-}
-var docsCache = /* @__PURE__ */ new Map();
-async function getDocsForSlug(slug, state) {
-  if (!isSlugSafe(slug, DOCS_DIR)) return null;
-  const paths = [
-    resolve(DOCS_DIR, slug, "index.mdx"),
-    resolve(DOCS_DIR, `${slug}.mdx`),
-    resolve(DOCS_DIR, slug, "index.md"),
-    resolve(DOCS_DIR, `${slug}.md`)
-  ];
-  const resolvedDocsDir = resolve(DOCS_DIR);
-  let filePath = null;
-  let raw = null;
-  for (const p of paths) {
-    const resolvedCandidate = resolve(p);
-    if (resolvedCandidate !== resolvedDocsDir && !resolvedCandidate.startsWith(resolvedDocsDir + "/")) {
-      continue;
-    }
-    try {
-      raw = await readFile(resolvedCandidate, "utf-8");
-      filePath = resolvedCandidate;
-      break;
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-  if (!filePath || !raw) return null;
-  const relPath = filePath.replace(PROJECT_ROOT + "/", "");
-  const mtimeMs = (await stat(filePath)).mtimeMs;
-  const cached = docsCache.get(relPath);
-  if (cached && cached.mtimeMs === mtimeMs) {
-    return cached.doc;
-  }
-  let content = raw;
-  if (state.builder) {
-    const transformed = await state.builder.runOnLoad(relPath, content);
-    if (transformed?.contents) {
-      content = transformed.contents;
-    }
-  }
-  const remarkPlugins = state.builder?.collectRemarkPlugins();
-  const rehypePlugins = state.builder?.collectRehypePlugins();
-  const result = await compileMdx(content, relPath, void 0, remarkPlugins, rehypePlugins);
-  let frontmatter = result.frontmatter;
-  if (state.builder) {
-    frontmatter = await state.builder.runTransformFrontmatterChain(frontmatter, {
-      slug: slug || "/",
-      filePath: relPath,
-      content
-    });
-  }
-  const doc = {
-    content: result.content,
-    compiledSource: result.compiledSource,
-    frontmatter,
-    tocs: result.tocs,
-    filePath: relPath,
-    resolvedContent: content
-  };
-  docsCache.set(relPath, { mtimeMs, doc });
-  return doc;
-}
-async function renderDocsServerPage(doc, slug, pathname, state) {
-  const title = frontmatterField(doc.frontmatter, "title") || slug.join("/") || "Docs";
-  const description = frontmatterField(doc.frontmatter, "description");
-  const page = React.createElement(
-    DocsLayout,
-    { repoUrl: state.docuConfig.repo?.url, pathname },
-    React.createElement(DocsPage, {
-      slug,
-      title,
-      description,
-      date: frontmatterField(doc.frontmatter, "date") || void 0,
-      // Same root-relative SSR as build — see build.ts.
-      content: renderToString(doc.content),
-      tocs: doc.tocs,
-      filePath: doc.filePath,
-      repoUrl: state.docuConfig.repo?.url,
-      compiledSource: doc.compiledSource
-    })
-  );
-  const body = renderToString(page);
-  const depth = slug.length || 1;
-  if (state.builder) {
-    const ctx = {
-      slug: slug.join("/") || "/",
-      filePath: doc.filePath,
-      frontmatter: doc.frontmatter,
-      content: doc.resolvedContent,
-      config: state.docuConfig
-    };
-    const headExtra = state.builder.collectHead(ctx);
-    const bodyExtra = state.builder.collectBody(ctx);
-    const nonce = generateNonce();
-    const favicon = state.docuConfig.meta?.favicon || "/favicon.ico";
-    let html = htmlShell({
-      title,
-      description,
-      body,
-      favicon,
-      css: state.assetManifest.css,
-      js: state.assetManifest.js,
-      nonce,
-      extraScripts: hmrScript(nonce),
-      themeCss: state.inlineThemeCss,
-      headExtra,
-      bodyExtra,
-      depth
-    });
-    html = await state.builder.runTransformHtmlChain(html, ctx);
-    return htmlResponse(html, nonce, 200, true);
-  }
-  return createHtmlResponse(title, description, body, 200, state, depth);
-}
-function renderPage(Component, title, description, status, state, props = {}, depth = 0) {
-  const page = React.createElement(
-    DocsLayout,
-    { repoUrl: state.docuConfig.repo?.url, pathname: "/docs" },
-    React.createElement(Component, props)
-  );
-  const body = renderToString(page);
-  return createHtmlResponse(title, description, body, status, state, depth);
-}
-async function handleDocsIndex(state) {
-  const doc = await getDocsForSlug("", state);
-  if (!doc) return renderPage(NotFoundPage, "404 - Not Found", "", 404, state, {}, 1);
-  return renderDocsServerPage(doc, [], "/docs", state);
-}
-async function handleDocsRoute(slug, state) {
-  const path = slug.join("/");
-  const doc = await getDocsForSlug(path, state);
-  if (!doc)
-    return renderPage(NotFoundPage, "404 - Not Found", "", 404, state, {}, slug.length || 1);
-  return renderDocsServerPage(doc, slug, `/docs/${path}`, state);
-}
-function handleIndex(state) {
-  const page = React.createElement(IndexPage);
-  const body = renderToString(page);
-  return createHtmlResponse(
-    state.docuConfig.meta?.title || "DocuBook",
-    state.docuConfig.meta?.description || "",
-    body,
-    200,
-    state
-  );
-}
-function handleNotFound(state, depth = 0) {
-  return renderPage(NotFoundPage, "404 - Not Found", "", 404, state, {}, depth);
-}
-function serveStatic(pathname) {
-  let decoded;
-  try {
-    decoded = decodeURIComponent(pathname);
-  } catch {
-    return null;
-  }
-  if (!isPathSafe(pathname, DIST_DIR)) return null;
-  const assetPath = resolve(DIST_DIR, decoded.slice(1));
-  try {
-    const s = statSync(assetPath);
-    if (s.isFile()) {
-      return new Response(readFileSync(assetPath), {
-        headers: { "Content-Type": getContentType(pathname) }
-      });
-    }
-  } catch (err) {
-    if (err.code !== "ENOENT") throw err;
-  }
-  if (decoded.startsWith("/docs/assets/")) {
-    const docsAssetsDir = resolve(DOCS_DIR, "assets");
-    const requestedRelative = decoded.slice("/docs/assets/".length);
-    const docsAsset = resolve(docsAssetsDir, requestedRelative);
-    const docsAssetsDirWithSep = docsAssetsDir.endsWith("/") ? docsAssetsDir : docsAssetsDir + "/";
-    if (docsAsset !== docsAssetsDir && !docsAsset.startsWith(docsAssetsDirWithSep)) return null;
-    try {
-      const s = statSync(docsAsset);
-      if (s.isFile()) {
-        return new Response(readFileSync(docsAsset), {
-          headers: { "Content-Type": getContentType(pathname) }
-        });
-      }
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-  }
-  return null;
-}
-function serverErrorResponse(error) {
-  const msg = error instanceof Error ? error.message : "Unknown error";
-  const st = process.env.NODE_ENV !== "production" && error instanceof Error ? error.stack : void 0;
-  return new Response(errorHtml(msg, st), {
-    status: 500,
-    headers: {
-      "Content-Type": "text/html",
-      ...SECURITY_HEADERS,
-      "Content-Security-Policy": "default-src 'none'; style-src 'unsafe-inline'"
-    }
-  });
-}
-
-// .docu/node/server.impl.ts
-async function runServer(adapter) {
-  const docuConfig = loadDocuConfig();
-  const parsedPort = parseInt(process.env.PORT ?? "3000", 10);
-  const PORT = Number.isInteger(parsedPort) && parsedPort > 0 && parsedPort <= 65535 ? parsedPort : 3e3;
-  logger.buildStart();
-  await initSentry();
-  logger.bundleStart();
-  let t = performance.now();
-  const assetManifest = await buildClientBundle();
-  logger.bundleDone(Math.round(performance.now() - t));
-  const inlineThemeCss = computeInlineThemeCss();
-  logger.indexStart();
-  t = performance.now();
-  const records = await generateSearchIndex();
-  logger.indexDone(records, Math.round(performance.now() - t));
-  logger.routes();
-  const pluginsConfig = docuConfig.plugins ?? [];
-  const builder = pluginsConfig.length > 0 ? new BuildPluginBuilder(docuConfig) : null;
-  if (builder) {
-    const plugins = await loadPlugins(pluginsConfig);
-    for (const plugin of plugins) {
-      await plugin.setup(builder);
-    }
-  }
-  const state = {
-    docuConfig,
-    assetManifest,
-    inlineThemeCss,
-    builder
-  };
-  const hmrClients = /* @__PURE__ */ new Set();
-  const require2 = createRequire(import.meta.url);
-  function resolveMdxContentSrc() {
-    try {
-      const pkgDir = dirname(require2.resolve("@docubook/markdown/package.json"));
-      const src = join(pkgDir, "src");
-      return existsSync(src) ? src : null;
-    } catch {
-      return null;
-    }
-  }
-  let hmrTimeout = null;
-  const watcher = watch(DOCS_DIR, { recursive: true }, (_event, filename) => {
-    if (!filename || !filename.endsWith(".mdx") && !filename.endsWith(".md")) return;
-    if (hmrTimeout) clearTimeout(hmrTimeout);
-    hmrTimeout = setTimeout(() => {
-      for (const client of [...hmrClients]) {
-        try {
-          client.enqueue(new TextEncoder().encode("data: reload\n\n"));
-        } catch {
-          hmrClients.delete(client);
-        }
-      }
-    }, 300);
-  });
-  let srcHmrTimeout = null;
-  const mdxContentSrc = resolveMdxContentSrc();
-  const srcWatcher = mdxContentSrc ? watch(mdxContentSrc, { recursive: true }, (_event, filename) => {
-    if (!filename || !/\.(ts|tsx|js|jsx|css)$/.test(filename)) return;
-    if (srcHmrTimeout) clearTimeout(srcHmrTimeout);
-    srcHmrTimeout = setTimeout(async () => {
-      try {
-        state.assetManifest = await buildClientBundle();
-        logger.warn("[hmr] client bundle rebuilt (component change)");
-      } catch (e) {
-        logger.warn(
-          `[hmr] bundle rebuild failed: ${e instanceof Error ? e.message : String(e)}`
-        );
-      }
-      for (const client of [...hmrClients]) {
-        try {
-          client.enqueue(new TextEncoder().encode("data: reload\n\n"));
-        } catch {
-          hmrClients.delete(client);
-        }
-      }
-    }, 300);
-  }) : null;
-  process.on("SIGINT", () => {
-    watcher.close();
-    srcWatcher?.close();
-    process.exit(0);
-  });
-  process.on("SIGTERM", () => {
-    watcher.close();
-    srcWatcher?.close();
-    process.exit(0);
-  });
-  let handle = null;
-  const fetchHandler = async (req) => {
-    const url = new URL(req.url);
-    const pathname = stripDocsHtmlSuffix(url.pathname);
-    const startTime = performance.now();
-    if (builder) {
-      const pluginResponse = await builder.runHandleRequest(req, {
-        port: handle?.port ?? PORT,
-        hostname: handle?.hostname ?? "localhost"
-      });
-      if (pluginResponse) {
-        const securedResponse = wrapPluginResponse(pluginResponse, true);
-        logger.request(
-          req.method,
-          pathname,
-          securedResponse.status,
-          Math.round(performance.now() - startTime)
-        );
-        return securedResponse;
-      }
-    }
-    try {
-      if (pathname === "/__hmr") {
-        const stream = new ReadableStream({
-          start(controller) {
-            hmrClients.add(controller);
-            controller.enqueue(new TextEncoder().encode("data: connected\n\n"));
-          },
-          cancel(controller) {
-            hmrClients.delete(controller);
-          }
-        });
-        return new Response(stream, {
-          headers: {
-            "Content-Type": "text/event-stream",
-            "Cache-Control": "no-cache",
-            Connection: "keep-alive"
-          }
-        });
-      }
-      if (pathname.startsWith("/assets/") || /\.\w+$/.test(pathname)) {
-        const staticRes = serveStatic(pathname);
-        if (staticRes) return staticRes;
-      }
-      let response;
-      if (pathname === "/") {
-        response = handleIndex(state);
-      } else if (pathname === "/docs" || pathname === "/docs/") {
-        response = await handleDocsIndex(state);
-      } else if (pathname.startsWith("/docs/")) {
-        const slug = pathname.slice("/docs/".length).split("/").filter(Boolean);
-        response = slug.length === 0 ? await handleDocsIndex(state) : await handleDocsRoute(slug, state);
-      } else {
-        response = handleNotFound(state);
-      }
-      logger.request(
-        req.method,
-        pathname,
-        response.status,
-        Math.round(performance.now() - startTime)
-      );
-      return response;
-    } catch (err) {
-      captureException(err, { method: req.method, pathname });
-      logger.request(req.method, pathname, 500, Math.round(performance.now() - startTime));
-      return serverErrorResponse(err);
-    }
-  };
-  handle = await adapter.serve(fetchHandler, { port: PORT, idleTimeout: 255 });
-  logger.ready(handle.port, true);
-  return handle;
-}
-
-export {
-  runServer
-};

package/.docu/lib/chunk-EOK6KATZ.js

@@ -1,191 +0,0 @@
-// .docu/node/security.ts
-import { randomBytes } from "node:crypto";
-import { resolve } from "node:path";
-import { realpathSync } from "node:fs";
-var SECURITY_HEADERS = {
-  "Strict-Transport-Security": "max-age=63072000; includeSubDomains; preload",
-  "X-Frame-Options": "DENY",
-  "X-Content-Type-Options": "nosniff",
-  "Referrer-Policy": "strict-origin-when-cross-origin",
-  "Permissions-Policy": "camera=(), microphone=(), geolocation=()"
-};
-function generateNonce() {
-  return randomBytes(16).toString("base64");
-}
-function cspHeader(nonce, allowEval = false) {
-  const scriptSrc = allowEval ? `script-src 'self' 'nonce-${nonce}' 'unsafe-eval'` : `script-src 'self' 'nonce-${nonce}'`;
-  return [
-    "default-src 'self'",
-    scriptSrc,
-    "style-src 'self' 'unsafe-inline'",
-    "img-src 'self' https: data:",
-    "font-src 'self' data:",
-    "connect-src 'self' https:",
-    "frame-src https://www.youtube-nocookie.com",
-    "frame-ancestors 'none'"
-  ].join("; ");
-}
-function isPathSafe(pathname, baseDir) {
-  const decoded = decodeURIComponent(pathname);
-  const resolved = resolve(baseDir, decoded.slice(1));
-  const baseDirSlash = baseDir.endsWith("/") ? baseDir : baseDir + "/";
-  if (!(resolved === baseDir || resolved.startsWith(baseDirSlash))) {
-    return false;
-  }
-  if (resolved === baseDir) return true;
-  try {
-    const real = realpathSync(resolved);
-    const realBase = realpathSync(baseDir);
-    const realBaseDirSlash = realBase.endsWith("/") ? realBase : realBase + "/";
-    return real.startsWith(realBaseDirSlash);
-  } catch (err) {
-    const nodeErr = err;
-    if (nodeErr.code === "ENOENT") {
-      return true;
-    }
-    console.error(
-      `[security] isPathSafe error for pathname="${pathname}": ${nodeErr.message} (code=${nodeErr.code})`
-    );
-    return false;
-  }
-}
-function isSlugSafe(slug, docsDir) {
-  const resolved = resolve(docsDir, slug);
-  const docsDirSlash = docsDir.endsWith("/") ? docsDir : docsDir + "/";
-  if (!(resolved === docsDir || resolved.startsWith(docsDirSlash))) {
-    return false;
-  }
-  if (resolved === docsDir) return true;
-  try {
-    const real = realpathSync(resolved);
-    const realDocsDir = realpathSync(docsDir);
-    const realDocsDirSlash = realDocsDir.endsWith("/") ? realDocsDir : realDocsDir + "/";
-    return real.startsWith(realDocsDirSlash);
-  } catch (err) {
-    const nodeErr = err;
-    if (nodeErr.code === "ENOENT") {
-      return true;
-    }
-    console.error(
-      `[security] isSlugSafe error for slug="${slug}": ${nodeErr.message} (code=${nodeErr.code})`
-    );
-    return false;
-  }
-}
-function normalizeImporterPath(importer) {
-  return resolve(importer).replace(/\\/g, "/");
-}
-function injectNonce(html, nonce) {
-  return html.replace(/<script\b(?![^>]*\bsrc\s*=)([^>]*)>/gi, (match) => {
-    if (/nonce\s*=/i.test(match)) {
-      return match.replace(/nonce="[^"]*"/i, `nonce="${nonce}"`);
-    }
-    return match.replace(/>$/, ` nonce="${nonce}">`);
-  });
-}
-function wrapPluginResponse(pluginResponse, allowEval = false) {
-  const securedHeaders = new Headers(pluginResponse.headers);
-  for (const [key, value] of Object.entries(SECURITY_HEADERS)) {
-    if (!securedHeaders.has(key)) {
-      securedHeaders.set(key, value);
-    }
-  }
-  let body = pluginResponse.body;
-  const contentType = securedHeaders.get("Content-Type") || "";
-  if (contentType.includes("text/html") && !securedHeaders.has("Content-Security-Policy")) {
-    const nonce = generateNonce();
-    securedHeaders.set("Content-Security-Policy", cspHeader(nonce, allowEval));
-    if (typeof body === "string") {
-      body = injectNonce(body, nonce);
-    }
-  }
-  return new Response(body, {
-    status: pluginResponse.status,
-    statusText: pluginResponse.statusText,
-    headers: securedHeaders
-  });
-}
-function htmlResponse(html, nonce, status = 200, allowEval = false) {
-  return new Response(html, {
-    status,
-    headers: {
-      "Content-Type": "text/html",
-      ...SECURITY_HEADERS,
-      "Content-Security-Policy": cspHeader(nonce, allowEval)
-    }
-  });
-}
-
-// .docu/node/utils.ts
-import { cn, parseDate, formatDate, formatDate2 } from "@docubook/core";
-import { readdir, stat } from "node:fs/promises";
-import { join } from "node:path";
-async function scanMdxFiles(dir, baseDir = "") {
-  const files = [];
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    const relativePath = baseDir ? `${baseDir}/${entry.name}` : entry.name;
-    if (entry.isDirectory()) {
-      if (entry.name === "assets" || entry.name.startsWith(".")) continue;
-      files.push(...await scanMdxFiles(fullPath, relativePath));
-    } else if (entry.name.endsWith(".mdx") || entry.name.endsWith(".md")) {
-      if (entry.name === "index.mdx" && !baseDir) continue;
-      const stats = await stat(fullPath);
-      let path = relativePath.replace(/\.(mdx|md)$/, "");
-      if (/\/index$/.test(path)) {
-        path = path.replace(/\/index$/, "");
-      }
-      files.push({ path, absPath: fullPath, mtime: stats.mtimeMs });
-    }
-  }
-  return files;
-}
-function isExternalUrl(url) {
-  return /^(https?:\/\/|\/\/)/.test(url);
-}
-function docsHtmlHref(path) {
-  return `${path}.html`;
-}
-function stripDocsHtmlSuffix(pathname) {
-  if (pathname === "/docs.html") return "/docs";
-  if (pathname.startsWith("/docs/") && pathname.endsWith(".html"))
-    return pathname.slice(0, -".html".length);
-  return pathname;
-}
-var MIME_TYPES = {
-  html: "text/html",
-  css: "text/css",
-  js: "application/javascript",
-  json: "application/json",
-  png: "image/png",
-  jpg: "image/jpeg",
-  jpeg: "image/jpeg",
-  svg: "image/svg+xml",
-  ico: "image/x-icon",
-  woff: "font/woff",
-  woff2: "font/woff2"
-};
-function getContentType(pathname) {
-  const ext = pathname.split(".").pop()?.toLowerCase();
-  return MIME_TYPES[ext || ""] || "application/octet-stream";
-}
-
-export {
-  SECURITY_HEADERS,
-  generateNonce,
-  cspHeader,
-  isPathSafe,
-  isSlugSafe,
-  normalizeImporterPath,
-  injectNonce,
-  wrapPluginResponse,
-  htmlResponse,
-  scanMdxFiles,
-  isExternalUrl,
-  docsHtmlHref,
-  stripDocsHtmlSuffix,
-  getContentType,
-  cn,
-  formatDate2
-};