comarkserv 0.1.0

package/dist/build-CsToYJrU.mjs

@@ -0,0 +1,2 @@
+import { n as build } from "./build-Cv5aO0CB.mjs";
+export { build };

package/dist/build-Cv5aO0CB.mjs

@@ -0,0 +1,205 @@
+import { D as join, E as extname, O as relative, S as getAssets, T as dirname, b as renderReadme, c as SKIPPED_GLOBS, f as isMarkdown, h as readDirectory, k as resolve, l as crumbsFor, m as mapLimit, o as createSearchIndex, r as createThemeStore, v as renderListing, w as basename, y as renderPage } from "./themes-mEufQ_3e.mjs";
+import { n as glob } from "./dist-BvdNTrap.mjs";
+import { t as createMarkdownRenderer } from "./markdown-BqKed1Vq.mjs";
+import { existsSync } from "node:fs";
+import { copyFile, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+//#region src/build.ts
+/** The directory in the site for the files of comarkserv. */
+const ASSETS_DIR = "_comarkserv";
+const MARKER = `${ASSETS_DIR}/build.json`;
+const CONCURRENCY = 16;
+const EXTERNAL = /^(?:[a-z][a-z\d+.-]*:|\/\/|#|\?)/i;
+/** Changes the path of a markdown file to the path of its HTML page. */
+function toHtmlPath(path) {
+	return `${path.slice(0, path.length - extname(path).length)}.html`;
+}
+/**
+* Returns a link transform for a page in `directory` (from the root, `""` for the root).
+* Links to markdown files go to their HTML pages, and links to directories go to their `index.html`.
+*/
+function staticLinkTransform(directory) {
+	return (href) => {
+		if (!href || EXTERNAL.test(href)) return href;
+		const cut = href.search(/[?#]/);
+		let path = cut < 0 ? href : href.slice(0, cut);
+		const suffix = cut < 0 ? "" : href.slice(cut);
+		if (path.startsWith("/")) {
+			const isDirectory = path.endsWith("/");
+			path = relative(`/${directory}`, path) || ".";
+			if (isDirectory) path = `${path}/`;
+		}
+		if (isMarkdown(path)) path = toHtmlPath(path);
+		else if (path.endsWith("/")) path = `${path}index.html`;
+		else if (path === "." || path === "..") path = `${path}/index.html`;
+		return path + suffix;
+	};
+}
+const staticLinks = {
+	directory: (name) => `${encodeURIComponent(name)}/index.html`,
+	markdown: (name) => encodeURIComponent(toHtmlPath(name))
+};
+async function prepareOutDir(outDir) {
+	if ((await readdir(outDir).catch(() => [])).length > 0) {
+		if (!existsSync(join(outDir, MARKER))) throw new Error(`The output directory ${outDir} is not empty, and it is not an earlier comarkserv build. Delete it, or choose another directory.`);
+		await rm(outDir, {
+			recursive: true,
+			force: true
+		});
+	}
+	await mkdir(join(outDir, ASSETS_DIR), { recursive: true });
+}
+function parentOf(path) {
+	const parent = dirname(path);
+	return parent === "." ? "" : parent;
+}
+async function write(path, content) {
+	await mkdir(dirname(path), { recursive: true });
+	await writeFile(path, content);
+}
+/** Builds a static HTML site from a directory. */
+async function build(options = {}) {
+	const started = performance.now();
+	const root = resolve(options.root ?? process.cwd());
+	const outDir = resolve(options.outDir ?? "dist");
+	if (outDir === root || root.startsWith(`${outDir}/`)) throw new Error("The output directory must not be the root or a parent of the root.");
+	const themeStore = options.themeStore ?? createThemeStore();
+	const theme = await themeStore.load(options.theme ?? "github", process.cwd());
+	const warnings = [];
+	const catalog = options.themeCatalog === false ? void 0 : await themeStore.catalog().catch((error) => {
+		const reason = error instanceof Error ? error.message : String(error);
+		warnings.push(`The theme catalog is not available (${reason}). The theme picker shows only the built-in themes.`);
+	});
+	await prepareOutDir(outDir);
+	const dotfiles = options.dotfiles ?? false;
+	const rootName = basename(root) || root;
+	const render = createMarkdownRenderer(options);
+	const assets = getAssets();
+	const outInRoot = outDir.startsWith(`${root}/`) ? relative(root, outDir) : void 0;
+	const ignore = [...SKIPPED_GLOBS, ...outInRoot ? [`${outInRoot}/**`] : []];
+	const files = await glob(dotfiles ? ["**/*"] : ["**/*", ".well-known/**"], {
+		cwd: root,
+		dot: dotfiles,
+		ignore,
+		onlyFiles: true,
+		expandDirectories: false
+	});
+	const fileSet = new Set(files);
+	const directories = /* @__PURE__ */ new Set([""]);
+	for (const file of files) for (let directory = parentOf(file); directory; directory = parentOf(directory)) directories.add(directory);
+	let usesMath = false;
+	const page = (url, kind, input) => {
+		const prefix = "../".repeat(url.split("/").length - 1);
+		const base = `${prefix}${ASSETS_DIR}/`;
+		return renderPage({
+			...input,
+			theme,
+			home: `${prefix}index.html`,
+			assets: {
+				css: `${base}app.css?v=${assets["app.css"].version}`,
+				js: `${base}app.js?v=${assets["app.js"].version}`,
+				katex: `${base}katex/katex.min.css?v=${assets.katexVersion}`
+			},
+			config: {
+				root: prefix,
+				search: `${base}search.json`,
+				events: "",
+				themes: catalog ? `${base}themes/catalog.json` : "",
+				edit: "",
+				share: "",
+				local: "",
+				source: `/${url}`,
+				kind
+			}
+		});
+	};
+	const crumbs = (pathname) => crumbsFor(pathname, rootName).map((crumb) => crumb.href === void 0 ? crumb : {
+		...crumb,
+		href: `${crumb.href}index.html`
+	});
+	const renderMarkdown = async (file) => {
+		const source = await readFile(join(root, file), "utf8");
+		const rendered = await render(source, { transformLink: staticLinkTransform(parentOf(file)) });
+		usesMath ||= rendered.features.math;
+		return rendered;
+	};
+	const markdownPages = files.filter((file) => isMarkdown(file));
+	await mapLimit(markdownPages, CONCURRENCY, async (file) => {
+		const rendered = await renderMarkdown(file);
+		const url = toHtmlPath(file);
+		const directory = parentOf(file);
+		const isIndex = basename(file) === "index.md";
+		const html = page(url, "markdown", {
+			title: rendered.title ?? basename(file),
+			description: rendered.description,
+			content: rendered.html,
+			toc: rendered.toc,
+			crumbs: crumbs(isIndex ? `/${directory ? `${directory}/` : ""}` : `/${file}`),
+			features: rendered.features,
+			rawHref: encodeURIComponent(basename(file))
+		});
+		await write(join(outDir, url), html);
+	});
+	const listings = [...directories].filter((directory) => !fileSet.has(join(directory, "index.md")) && !fileSet.has(join(directory, "index.html")));
+	await mapLimit(listings, CONCURRENCY, async (directory) => {
+		const listing = await readDirectory(join(root, directory), {
+			dotfiles,
+			links: staticLinks
+		});
+		const entries = listing.entries.filter((entry) => {
+			const path = join(directory, entry.name);
+			return entry.kind === "dir" ? directories.has(path) : fileSet.has(path);
+		});
+		let content = renderListing(entries, directory ? "../index.html" : void 0);
+		let readme;
+		if (listing.readme) {
+			readme = await renderMarkdown(join(directory, listing.readme));
+			content += renderReadme(listing.readme, readme.html);
+		}
+		const url = join(directory, "index.html");
+		const html = page(url, "directory", {
+			title: directory ? `${directory}/` : rootName,
+			content,
+			contentClass: "cms-directory",
+			toc: readme?.toc,
+			crumbs: crumbs(`/${directory ? `${directory}/` : ""}`),
+			features: readme?.features
+		});
+		await write(join(outDir, url), html);
+	});
+	await mapLimit(files, 32, async (file) => {
+		await mkdir(join(outDir, parentOf(file)), { recursive: true });
+		if (isMarkdown(file) || !existsSync(join(outDir, file))) await copyFile(join(root, file), join(outDir, file));
+	});
+	const search = createSearchIndex({
+		root,
+		dotfiles,
+		ignore,
+		toUrl: toHtmlPath
+	});
+	await Promise.all([
+		write(join(outDir, ASSETS_DIR, "app.css"), assets["app.css"].body),
+		write(join(outDir, ASSETS_DIR, "app.js"), assets["app.js"].body),
+		write(join(outDir, ASSETS_DIR, "search.json"), JSON.stringify(await search.get())),
+		...catalog ? [write(join(outDir, ASSETS_DIR, "themes", "catalog.json"), JSON.stringify(catalog))] : [],
+		write(join(outDir, MARKER), JSON.stringify({
+			generator: "comarkserv",
+			date: (/* @__PURE__ */ new Date()).toISOString()
+		}))
+	]);
+	if (usesMath) {
+		const katexFiles = await glob(["katex.min.css", "fonts/*.woff2"], { cwd: assets.katexDir });
+		await Promise.all(katexFiles.map(async (file) => {
+			await mkdir(dirname(join(outDir, ASSETS_DIR, "katex", file)), { recursive: true });
+			await copyFile(join(assets.katexDir, file), join(outDir, ASSETS_DIR, "katex", file));
+		}));
+	}
+	return {
+		outDir,
+		pages: markdownPages.length + listings.length,
+		files: files.length - markdownPages.length,
+		ms: performance.now() - started,
+		warnings
+	};
+}
+//#endregion
+export { toHtmlPath as i, build as n, staticLinkTransform as r, ASSETS_DIR as t };

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}