@iowarp/clio-coder 0.4.7 → 0.4.8

package/dist/docs-BL7ROUFN.js

@@ -1,292 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  printError,
-  printHeader,
-  source_default
-} from "./chunk-3T4DXWP6.js";
-import {
-  resolvePackageRoot
-} from "./chunk-E3LEPLQ2.js";
-import {
-  init_esm_shims
-} from "./chunk-ECBHH7LU.js";
-
-// src/cli/docs.ts
-init_esm_shims();
-import { spawn } from "node:child_process";
-import { createReadStream, readdirSync, realpathSync, statSync } from "node:fs";
-import { createServer } from "node:http";
-import { relative, resolve } from "node:path";
-var HOST = "127.0.0.1";
-var HELP = `clio-coder docs [topic] [--no-open]
-
-Serve Clio Coder's interactive HTML documentation locally and open it in a
-browser. The blueprints live in docs/html of a source checkout; the npm package
-ships the categorized Markdown reference tree under docs/ and excludes HTML.
-The server binds an ephemeral port on
-127.0.0.1, keeps no state, runs no daemon, and reaches no external network.
-Press Ctrl+C to stop it.
-
-Arguments:
-  [topic]      deep-link a specific blueprint (for example: safety, configuration,
-               tools). Omit to open the documentation menu.
-
-Flags:
-  --no-open    do not launch a browser; just print the URL.
-  --help, -h   this message.
-`;
-var CONTENT_TYPES = {
-  ".html": "text/html; charset=utf-8",
-  ".htm": "text/html; charset=utf-8",
-  ".css": "text/css; charset=utf-8",
-  ".js": "text/javascript; charset=utf-8",
-  ".mjs": "text/javascript; charset=utf-8",
-  ".json": "application/json; charset=utf-8",
-  ".svg": "image/svg+xml",
-  ".png": "image/png",
-  ".webp": "image/webp",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".ico": "image/x-icon",
-  ".woff": "font/woff",
-  ".woff2": "font/woff2",
-  ".ttf": "font/ttf",
-  ".map": "application/json; charset=utf-8",
-  ".txt": "text/plain; charset=utf-8"
-};
-function resolveDocsHtmlDir() {
-  return resolve(resolvePackageRoot(), "docs", "html");
-}
-function contentTypeFor(filePath) {
-  const dot = filePath.lastIndexOf(".");
-  if (dot === -1) return "application/octet-stream";
-  return CONTENT_TYPES[filePath.slice(dot).toLowerCase()] ?? "application/octet-stream";
-}
-function resolveRequestPath(rawUrl) {
-  const pathPart = (rawUrl.split(/[?#]/, 1)[0] ?? "").trim();
-  let decoded;
-  try {
-    decoded = decodeURIComponent(pathPart);
-  } catch {
-    return { ok: false, reason: "bad-request" };
-  }
-  if (decoded.includes("\0")) return { ok: false, reason: "forbidden" };
-  const segments = decoded.split(/[/\\]/).filter((segment) => segment.length > 0 && segment !== ".");
-  if (segments.length === 0) return { ok: true, relative: "index.html" };
-  for (const segment of segments) {
-    if (segment === "..") return { ok: false, reason: "forbidden" };
-  }
-  return { ok: true, relative: segments.join("/") };
-}
-function titleize(topic) {
-  return topic.split(/[-_]+/).filter((word) => word.length > 0).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-}
-function synthesizeMenu(fileNames) {
-  const entries = [];
-  for (const name of fileNames) {
-    if (!name.toLowerCase().endsWith(".html")) continue;
-    if (name.toLowerCase() === "index.html") continue;
-    const topic = name.replace(/\.html$/i, "").replace(/_blueprint$/i, "");
-    entries.push({ topic, file: name, label: titleize(topic) });
-  }
-  entries.sort((a, b) => a.topic.localeCompare(b.topic));
-  return entries;
-}
-function topicToFile(topic, fileNames) {
-  const wanted = topic.trim().toLowerCase().replace(/\.html$/i, "");
-  if (wanted.length === 0) return null;
-  for (const candidate of [`${wanted}.html`, `${wanted}_blueprint.html`]) {
-    const match = fileNames.find((name) => name.toLowerCase() === candidate);
-    if (match) return match;
-  }
-  const hit = synthesizeMenu(fileNames).find((entry) => entry.topic.toLowerCase() === wanted);
-  return hit ? hit.file : null;
-}
-function isWithin(child, parent) {
-  const rel = relative(parent, child);
-  return rel === "" || !rel.startsWith("..") && !rel.startsWith(`..${"/"}`) && !/^([A-Za-z]:)?[/\\]/.test(rel);
-}
-function listHtmlFiles(htmlDir) {
-  try {
-    return readdirSync(htmlDir).filter((name) => name.toLowerCase().endsWith(".html")).sort((a, b) => a.localeCompare(b));
-  } catch {
-    return [];
-  }
-}
-function createDocsRequestHandler(htmlDir) {
-  const root = realpathSync(resolve(htmlDir));
-  return (req, res) => {
-    if (req.method !== "GET" && req.method !== "HEAD") {
-      res.writeHead(405, { "content-type": "text/plain; charset=utf-8", allow: "GET, HEAD" });
-      res.end("method not allowed");
-      return;
-    }
-    const resolved = resolveRequestPath(req.url ?? "/");
-    if (!resolved.ok) {
-      const status = resolved.reason === "forbidden" ? 403 : 400;
-      res.writeHead(status, { "content-type": "text/plain; charset=utf-8" });
-      res.end(resolved.reason);
-      return;
-    }
-    const requestedTarget = resolve(root, resolved.relative);
-    if (!isWithin(requestedTarget, root)) {
-      res.writeHead(403, { "content-type": "text/plain; charset=utf-8" });
-      res.end("forbidden");
-      return;
-    }
-    let size = null;
-    let target = null;
-    try {
-      target = realpathSync(requestedTarget);
-      if (!isWithin(target, root)) {
-        res.writeHead(403, { "content-type": "text/plain; charset=utf-8" });
-        res.end("forbidden");
-        return;
-      }
-      const stat = statSync(target);
-      if (stat.isFile()) size = stat.size;
-    } catch {
-      size = null;
-    }
-    if (size === null || target === null) {
-      res.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
-      res.end("not found");
-      return;
-    }
-    const headers = {
-      "content-type": contentTypeFor(target),
-      "content-length": String(size),
-      "cache-control": "no-store"
-    };
-    if (req.method === "HEAD") {
-      res.writeHead(200, headers);
-      res.end();
-      return;
-    }
-    res.writeHead(200, headers);
-    const stream = createReadStream(target);
-    stream.on("error", () => {
-      if (!res.writableEnded) res.end();
-    });
-    stream.pipe(res);
-  };
-}
-async function startDocsServer(options) {
-  const host = options.host ?? HOST;
-  const server = createServer(createDocsRequestHandler(options.htmlDir));
-  await new Promise((resolveListen, rejectListen) => {
-    const onError = (err) => rejectListen(err);
-    server.once("error", onError);
-    server.listen(options.port ?? 0, host, () => {
-      server.removeListener("error", onError);
-      resolveListen();
-    });
-  });
-  const address = server.address();
-  const port = address.port;
-  return {
-    server,
-    port,
-    url: `http://${host}:${port}/`,
-    close: () => new Promise((resolveClose) => server.close(() => resolveClose()))
-  };
-}
-function openBrowser(url) {
-  const platform = process.platform;
-  const command = platform === "darwin" ? "open" : platform === "win32" ? "cmd" : "xdg-open";
-  const args = platform === "win32" ? ["/c", "start", "", url] : [url];
-  try {
-    const child = spawn(command, args, { stdio: "ignore", detached: true });
-    child.on("error", () => {
-    });
-    child.unref();
-  } catch {
-  }
-}
-function waitForShutdown() {
-  return new Promise((resolveShutdown) => {
-    const onSignal = () => {
-      process.removeListener("SIGINT", onSignal);
-      process.removeListener("SIGTERM", onSignal);
-      resolveShutdown();
-    };
-    process.once("SIGINT", onSignal);
-    process.once("SIGTERM", onSignal);
-  });
-}
-async function runDocsCommand(args = []) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(HELP);
-    return 0;
-  }
-  let noOpen = false;
-  const positionals = [];
-  for (const arg of args) {
-    if (arg === "--no-open") {
-      noOpen = true;
-      continue;
-    }
-    if (arg.startsWith("-")) {
-      printError(`unknown flag: ${arg}`);
-      process.stdout.write(HELP);
-      return 2;
-    }
-    positionals.push(arg);
-  }
-  if (positionals.length > 1) {
-    printError("docs accepts at most one [topic]");
-    process.stdout.write(HELP);
-    return 2;
-  }
-  let htmlDir;
-  try {
-    htmlDir = resolveDocsHtmlDir();
-  } catch (err) {
-    printError(`could not resolve the docs HTML root: ${err instanceof Error ? err.message : String(err)}`);
-    return 1;
-  }
-  const files = listHtmlFiles(htmlDir);
-  if (files.length === 0) {
-    printError(`no HTML docs at ${htmlDir}`);
-    process.stdout.write(
-      `  the npm package ships only the categorized Markdown reference tree: ${resolve(resolvePackageRoot(), "docs")}
-  the interactive blueprints are in a source checkout and at https://github.com/iowarp/clio-coder/tree/main/docs/html
-`
-    );
-    return 1;
-  }
-  let landing = "index.html";
-  const topic = positionals[0];
-  if (topic !== void 0) {
-    const file = topicToFile(topic, files);
-    if (!file) {
-      printError(`unknown docs topic: ${topic}`);
-      const topics = synthesizeMenu(files).map((entry) => entry.topic);
-      if (topics.length > 0) process.stdout.write(`  available topics: ${topics.join(", ")}
-`);
-      return 2;
-    }
-    landing = file;
-  }
-  const handle = await startDocsServer({ htmlDir });
-  const landingUrl = landing === "index.html" ? handle.url : `${handle.url}${landing}`;
-  printHeader("Clio docs viewer");
-  process.stdout.write(`  serving HTML root ${htmlDir}
-`);
-  process.stdout.write(`  open ${source_default.cyan(landingUrl)}
-`);
-  process.stdout.write("  bound to 127.0.0.1 only: no external network, no daemon, no state.\n");
-  process.stdout.write("  press Ctrl+C to stop.\n");
-  if (!noOpen) openBrowser(landingUrl);
-  await waitForShutdown();
-  await handle.close();
-  process.stdout.write("docs viewer stopped.\n");
-  return 0;
-}
-export {
-  createDocsRequestHandler,
-  runDocsCommand,
-  waitForShutdown
-};
-//# sourceMappingURL=docs-BL7ROUFN.js.map