@ox-content/vite-plugin 2.11.0 → 2.13.0

package/dist/github.mjs

@@ -1,640 +1,2 @@
-import { c as __exportAll } from "./mermaid.mjs";
-import { unified } from "unified";
-import rehypeParse from "rehype-parse";
-import rehypeStringify from "rehype-stringify";
-import { Buffer } from "node:buffer";
-//#region src/plugins/github.ts
-/**
-* GitHub Plugin - Repository and source code embedding
-*
-* Transforms <GitHub> components into static repository and source code cards
-* by fetching data from GitHub API at build time.
-*/
-var github_exports = /* @__PURE__ */ __exportAll({
-	collectGitHubRepos: () => collectGitHubRepos,
-	collectGitHubSources: () => collectGitHubSources,
-	createGitHubPermalink: () => createGitHubPermalink,
-	fetchGitHubSource: () => fetchGitHubSource,
-	fetchRepoData: () => fetchRepoData,
-	isSafeGitHubRepo: () => isSafeGitHubRepo,
-	parseGitHubLineRange: () => parseGitHubLineRange,
-	parseGitHubPermalink: () => parseGitHubPermalink,
-	prefetchGitHubRepos: () => prefetchGitHubRepos,
-	prefetchGitHubSources: () => prefetchGitHubSources,
-	transformGitHub: () => transformGitHub
-});
-const defaultOptions = {
-	token: "",
-	cache: true,
-	cacheTTL: 36e5,
-	maxSourceBytes: 2e5,
-	maxSourceLines: 120
-};
-const repoCache = /* @__PURE__ */ new Map();
-const sourceCache = /* @__PURE__ */ new Map();
-const GITHUB_REPO_RE = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
-const GITHUB_COMPONENT_RE = /<github\b([^>]*)>/gi;
-const ATTRIBUTE_RE = /([:\w-]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>/]+)))?/g;
-const CONTROL_CHAR_RE = /[\u0000-\u001f\u007f]/;
-const EXTENSION_LANGUAGE_MAP = new Map([
-	["cjs", "javascript"],
-	["css", "css"],
-	["go", "go"],
-	["html", "html"],
-	["js", "javascript"],
-	["json", "json"],
-	["jsx", "jsx"],
-	["md", "markdown"],
-	["mdx", "mdx"],
-	["mjs", "javascript"],
-	["py", "python"],
-	["rb", "ruby"],
-	["rs", "rust"],
-	["sh", "shell"],
-	["svelte", "svelte"],
-	["toml", "toml"],
-	["ts", "typescript"],
-	["tsx", "tsx"],
-	["vue", "vue"],
-	["yaml", "yaml"],
-	["yml", "yaml"]
-]);
-function isSafeGitHubRepo(repo) {
-	return GITHUB_REPO_RE.test(repo) && !repo.split("/").some((part) => part === "." || part === "..");
-}
-function isSafeGitHubRef(ref) {
-	return Boolean(ref) && !CONTROL_CHAR_RE.test(ref) && !hasUnsafePathSegment(ref);
-}
-function isSafeGitHubPath(path) {
-	return Boolean(path) && !CONTROL_CHAR_RE.test(path) && !hasUnsafePathSegment(path);
-}
-function hasUnsafePathSegment(value) {
-	return value.split("/").some((part) => !part || part === "." || part === ".." || part.includes("\\"));
-}
-function encodePath(path) {
-	return path.split("/").map(encodeURIComponent).join("/");
-}
-function sourceKey(source) {
-	return `${source.repo}@${source.ref}:${source.path}`;
-}
-function formatLineRange(lines) {
-	return lines.start === lines.end ? `L${lines.start}` : `L${lines.start}-L${lines.end}`;
-}
-function parseGitHubLineRange(value) {
-	if (!value) return void 0;
-	const match = value.trim().match(/^#?L?(\d+)(?:-L?(\d+))?$/i);
-	if (!match) return void 0;
-	const start = Number.parseInt(match[1], 10);
-	const end = match[2] ? Number.parseInt(match[2], 10) : start;
-	if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start < 1 || end < start) return;
-	return {
-		start,
-		end
-	};
-}
-function createGitHubPermalink(source) {
-	const fragment = source.lines ? `#${formatLineRange(source.lines)}` : "";
-	return `https://github.com/${source.repo}/blob/${encodeURIComponent(source.ref)}/${encodePath(source.path)}${fragment}`;
-}
-function parseGitHubPermalink(value) {
-	let url;
-	try {
-		url = new URL(value);
-	} catch {
-		return null;
-	}
-	if (url.protocol !== "https:" || url.hostname !== "github.com") return null;
-	let parts;
-	try {
-		parts = url.pathname.split("/").filter(Boolean).map((part) => decodeURIComponent(part));
-	} catch {
-		return null;
-	}
-	if (parts.length < 5 || parts[2] !== "blob") return null;
-	const repo = `${parts[0]}/${parts[1]}`;
-	const ref = parts[3];
-	const path = parts.slice(4).join("/");
-	if (!isSafeGitHubRepo(repo) || !isSafeGitHubRef(ref) || !isSafeGitHubPath(path)) return null;
-	const source = {
-		repo,
-		ref,
-		path,
-		lines: parseGitHubLineRange(url.hash)
-	};
-	return {
-		...source,
-		permalink: createGitHubPermalink(source)
-	};
-}
-/**
-* Get element attribute value.
-*/
-function getAttribute(el, name) {
-	const value = el.properties?.[name];
-	if (typeof value === "string") return value;
-	if (Array.isArray(value)) return value.join(" ");
-}
-/**
-* Format number with K/M suffix.
-*/
-function formatNumber(num) {
-	if (num >= 1e6) return `${(num / 1e6).toFixed(1)}M`;
-	if (num >= 1e3) return `${(num / 1e3).toFixed(1)}k`;
-	return String(num);
-}
-/**
-* Fetch repository data from GitHub API.
-*/
-async function fetchRepoData(repo, options) {
-	if (!isSafeGitHubRepo(repo)) return null;
-	if (options.cache) {
-		const cached = repoCache.get(repo);
-		if (cached && Date.now() - cached.timestamp < options.cacheTTL) return cached.data;
-	}
-	try {
-		const headers = {
-			Accept: "application/vnd.github.v3+json",
-			"User-Agent": "ox-content-github-plugin"
-		};
-		if (options.token) headers.Authorization = `Bearer ${options.token}`;
-		const response = await fetch(`https://api.github.com/repos/${repo}`, { headers });
-		if (!response.ok) {
-			console.warn(`Failed to fetch GitHub repo ${repo}: ${response.status}`);
-			return null;
-		}
-		const data = await response.json();
-		if (options.cache) repoCache.set(repo, {
-			data,
-			timestamp: Date.now()
-		});
-		return data;
-	} catch (error) {
-		console.warn(`Error fetching GitHub repo ${repo}:`, error);
-		return null;
-	}
-}
-/**
-* Fetch source file data from GitHub API.
-*/
-async function fetchGitHubSource(source, options) {
-	if (!isSafeGitHubRepo(source.repo) || !isSafeGitHubRef(source.ref) || !isSafeGitHubPath(source.path)) return null;
-	const key = sourceKey(source);
-	if (options.cache) {
-		const cached = sourceCache.get(key);
-		if (cached && Date.now() - cached.timestamp < options.cacheTTL) return cached.data;
-	}
-	try {
-		const headers = {
-			Accept: "application/vnd.github.v3+json",
-			"User-Agent": "ox-content-github-plugin"
-		};
-		if (options.token) headers.Authorization = `Bearer ${options.token}`;
-		const apiUrl = `https://api.github.com/repos/${source.repo}/contents/${encodePath(source.path)}?ref=${encodeURIComponent(source.ref)}`;
-		const response = await fetch(apiUrl, { headers });
-		if (!response.ok) {
-			console.warn(`Failed to fetch GitHub source ${source.permalink}: ${response.status}`);
-			return null;
-		}
-		const data = await response.json();
-		if (data.type !== "file" || data.encoding !== "base64" || !data.content || (data.size ?? 0) > options.maxSourceBytes) return null;
-		const content = Buffer.from(data.content.replace(/\s/g, ""), "base64").toString("utf8");
-		if (Buffer.byteLength(content) > options.maxSourceBytes) return null;
-		const sourceData = {
-			repo: source.repo,
-			ref: source.ref,
-			path: source.path,
-			permalink: source.permalink,
-			content,
-			size: data.size ?? Buffer.byteLength(content),
-			html_url: data.html_url ?? source.permalink,
-			language: inferLanguage(source.path)
-		};
-		if (options.cache) sourceCache.set(key, {
-			data: sourceData,
-			timestamp: Date.now()
-		});
-		return sourceData;
-	} catch (error) {
-		console.warn(`Error fetching GitHub source ${source.permalink}:`, error);
-		return null;
-	}
-}
-/**
-* Create GitHub card element from repo data.
-*/
-function createGitHubCard(repoData) {
-	const statsChildren = [];
-	if (repoData.language) statsChildren.push({
-		type: "element",
-		tagName: "span",
-		properties: { className: ["ox-github-language"] },
-		children: [{
-			type: "element",
-			tagName: "span",
-			properties: {
-				className: ["ox-github-language-color"],
-				"data-lang": repoData.language.toLowerCase()
-			},
-			children: []
-		}, {
-			type: "text",
-			value: repoData.language
-		}]
-	});
-	statsChildren.push({
-		type: "element",
-		tagName: "span",
-		properties: { className: ["ox-github-stat"] },
-		children: [{
-			type: "element",
-			tagName: "svg",
-			properties: {
-				viewBox: "0 0 16 16",
-				fill: "currentColor"
-			},
-			children: [{
-				type: "element",
-				tagName: "path",
-				properties: { d: "M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25Z" },
-				children: []
-			}]
-		}, {
-			type: "text",
-			value: formatNumber(repoData.stargazers_count)
-		}]
-	});
-	statsChildren.push({
-		type: "element",
-		tagName: "span",
-		properties: { className: ["ox-github-stat"] },
-		children: [{
-			type: "element",
-			tagName: "svg",
-			properties: {
-				viewBox: "0 0 16 16",
-				fill: "currentColor"
-			},
-			children: [{
-				type: "element",
-				tagName: "path",
-				properties: { d: "M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0ZM5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Zm6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5Zm-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z" },
-				children: []
-			}]
-		}, {
-			type: "text",
-			value: formatNumber(repoData.forks_count)
-		}]
-	});
-	return {
-		type: "element",
-		tagName: "a",
-		properties: {
-			className: ["ox-github-card"],
-			href: repoData.html_url,
-			target: "_blank",
-			rel: "noopener noreferrer"
-		},
-		children: [
-			{
-				type: "element",
-				tagName: "div",
-				properties: { className: ["ox-github-header"] },
-				children: [{
-					type: "element",
-					tagName: "svg",
-					properties: {
-						className: ["ox-github-icon"],
-						viewBox: "0 0 16 16",
-						fill: "currentColor"
-					},
-					children: [{
-						type: "element",
-						tagName: "path",
-						properties: { d: "M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.495 2.495 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.486 2.486 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.249.249 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z" },
-						children: []
-					}]
-				}, {
-					type: "element",
-					tagName: "span",
-					properties: { className: ["ox-github-repo"] },
-					children: [{
-						type: "text",
-						value: repoData.full_name
-					}]
-				}]
-			},
-			...repoData.description ? [{
-				type: "element",
-				tagName: "p",
-				properties: { className: ["ox-github-description"] },
-				children: [{
-					type: "text",
-					value: repoData.description
-				}]
-			}] : [],
-			{
-				type: "element",
-				tagName: "div",
-				properties: { className: ["ox-github-stats"] },
-				children: statsChildren
-			}
-		]
-	};
-}
-/**
-* Create fallback element when repo data is unavailable.
-*/
-function createFallbackCard(repo) {
-	return {
-		type: "element",
-		tagName: "a",
-		properties: {
-			className: ["ox-github-card", "error"],
-			href: isSafeGitHubRepo(repo) ? `https://github.com/${repo}` : "#",
-			target: "_blank",
-			rel: "noopener noreferrer"
-		},
-		children: [{
-			type: "element",
-			tagName: "div",
-			properties: { className: ["ox-github-header"] },
-			children: [{
-				type: "element",
-				tagName: "svg",
-				properties: {
-					className: ["ox-github-icon"],
-					viewBox: "0 0 16 16",
-					fill: "currentColor"
-				},
-				children: [{
-					type: "element",
-					tagName: "path",
-					properties: { d: "M8 0c4.42 0 8 3.58 8 8a8.013 8.013 0 0 1-5.45 7.59c-.4.08-.55-.17-.55-.38 0-.27.01-1.13.01-2.2 0-.75-.25-1.23-.54-1.48 1.78-.2 3.65-.88 3.65-3.95 0-.88-.31-1.59-.82-2.15.08-.2.36-1.02-.08-2.12 0 0-.67-.22-2.2.82-.64-.18-1.32-.27-2-.27-.68 0-1.36.09-2 .27-1.53-1.03-2.2-.82-2.2-.82-.44 1.1-.16 1.92-.08 2.12-.51.56-.82 1.28-.82 2.15 0 3.06 1.86 3.75 3.64 3.95-.23.2-.44.55-.51 1.07-.46.21-1.61.55-2.33-.66-.15-.24-.6-.83-1.23-.82-.67.01-.27.38.01.53.34.19.73.9.82 1.13.16.45.68 1.31 2.69.94 0 .67.01 1.3.01 1.49 0 .21-.15.45-.55.38A7.995 7.995 0 0 1 0 8c0-4.42 3.58-8 8-8Z" },
-					children: []
-				}]
-			}, {
-				type: "element",
-				tagName: "span",
-				properties: { className: ["ox-github-repo"] },
-				children: [{
-					type: "text",
-					value: repo
-				}]
-			}]
-		}]
-	};
-}
-function inferLanguage(path) {
-	const fileName = path.split("/").at(-1)?.toLowerCase() ?? "";
-	if (fileName === "dockerfile") return "dockerfile";
-	if (fileName === "makefile") return "makefile";
-	const extension = fileName.includes(".") ? fileName.split(".").at(-1) : void 0;
-	return extension ? EXTENSION_LANGUAGE_MAP.get(extension) ?? extension : null;
-}
-function normalizeSourceLines(content) {
-	const lines = content.replace(/\r\n?/g, "\n").split("\n");
-	if (lines.length > 1 && lines.at(-1) === "") lines.pop();
-	return lines.length > 0 ? lines : [""];
-}
-function createGitHubSourceCard(source, lines, options) {
-	const allLines = normalizeSourceLines(source.content);
-	const start = Math.min(lines?.start ?? 1, allLines.length);
-	const end = lines ? Math.min(lines.end, allLines.length) : Math.min(allLines.length, options.maxSourceLines);
-	const selectedLines = allLines.slice(start - 1, end);
-	const lineRange = {
-		start,
-		end
-	};
-	const loc = selectedLines.length;
-	const rangeLabel = formatLineRange(lineRange);
-	const locLabel = !lines && end < allLines.length ? `${rangeLabel} of ${allLines.length} LOC` : `${rangeLabel} - ${loc} LOC`;
-	const languageClass = source.language ? [`language-${source.language}`] : [];
-	return {
-		type: "element",
-		tagName: "figure",
-		properties: {
-			className: ["ox-github-code"],
-			"data-loc": String(loc),
-			"data-source": source.permalink
-		},
-		children: [{
-			type: "element",
-			tagName: "figcaption",
-			properties: { className: ["ox-github-code-header"] },
-			children: [{
-				type: "element",
-				tagName: "a",
-				properties: {
-					className: ["ox-github-code-title"],
-					href: source.permalink,
-					target: "_blank",
-					rel: "noopener noreferrer"
-				},
-				children: [{
-					type: "text",
-					value: `${source.repo}/${source.path}`
-				}]
-			}, {
-				type: "element",
-				tagName: "span",
-				properties: { className: ["ox-github-code-loc"] },
-				children: [{
-					type: "text",
-					value: locLabel
-				}]
-			}]
-		}, {
-			type: "element",
-			tagName: "pre",
-			properties: {
-				className: ["ox-github-code-block", ...languageClass],
-				...source.language ? { "data-language": source.language } : {}
-			},
-			children: [{
-				type: "element",
-				tagName: "code",
-				properties: { className: languageClass },
-				children: selectedLines.map((line, index) => {
-					const lineNumber = start + index;
-					return {
-						type: "element",
-						tagName: "span",
-						properties: {
-							className: ["line", "ox-github-code-line"],
-							"data-line": String(lineNumber)
-						},
-						children: [{
-							type: "element",
-							tagName: "span",
-							properties: { className: ["ox-github-code-line-number"] },
-							children: [{
-								type: "text",
-								value: String(lineNumber)
-							}]
-						}, {
-							type: "element",
-							tagName: "span",
-							properties: { className: ["ox-github-code-line-content"] },
-							children: [{
-								type: "text",
-								value: line || " "
-							}]
-						}]
-					};
-				})
-			}]
-		}]
-	};
-}
-/**
-* Collect all GitHub repos from HTML for pre-fetching.
-*/
-async function collectGitHubRepos(html) {
-	const repos = [];
-	GITHUB_COMPONENT_RE.lastIndex = 0;
-	let match;
-	while ((match = GITHUB_COMPONENT_RE.exec(html)) !== null) {
-		const attrs = parseAttributes(match[1]);
-		if (attrs.path || attrs.file || attrs.permalink || attrs.url || attrs.href) continue;
-		const repo = attrs.repo;
-		if (repo && isSafeGitHubRepo(repo)) repos.push(repo);
-	}
-	return repos;
-}
-/**
-* Collect all GitHub source references from HTML for pre-fetching.
-*/
-async function collectGitHubSources(html) {
-	const sources = [];
-	GITHUB_COMPONENT_RE.lastIndex = 0;
-	let match;
-	while ((match = GITHUB_COMPONENT_RE.exec(html)) !== null) {
-		const source = sourceRefFromAttributes(parseAttributes(match[1]));
-		if (source) sources.push(source);
-	}
-	return sources;
-}
-function parseAttributes(raw) {
-	const attrs = {};
-	ATTRIBUTE_RE.lastIndex = 0;
-	let match;
-	while ((match = ATTRIBUTE_RE.exec(raw)) !== null) attrs[match[1].toLowerCase()] = match[2] ?? match[3] ?? match[4] ?? "";
-	return attrs;
-}
-function attributesFromElement(el) {
-	const attrs = {};
-	for (const name of [
-		"permalink",
-		"url",
-		"href",
-		"repo",
-		"path",
-		"file",
-		"ref",
-		"sha",
-		"branch",
-		"loc",
-		"lines",
-		"line"
-	]) {
-		const value = getAttribute(el, name);
-		if (value !== void 0) attrs[name] = value;
-	}
-	return attrs;
-}
-function sourceRefFromAttributes(attrs) {
-	const permalink = attrs.permalink ?? attrs.url ?? attrs.href;
-	if (permalink) return parseGitHubPermalink(permalink);
-	const repo = attrs.repo;
-	const path = attrs.path ?? attrs.file;
-	if (!repo || !path || !isSafeGitHubRepo(repo) || !isSafeGitHubPath(path)) return null;
-	const ref = attrs.ref ?? attrs.sha ?? attrs.branch ?? "main";
-	if (!isSafeGitHubRef(ref)) return null;
-	const source = {
-		repo,
-		ref,
-		path,
-		lines: parseGitHubLineRange(attrs.loc ?? attrs.lines ?? attrs.line)
-	};
-	return {
-		...source,
-		permalink: createGitHubPermalink(source)
-	};
-}
-/**
-* Pre-fetch all GitHub repos data.
-*/
-async function prefetchGitHubRepos(repos, options) {
-	const mergedOptions = {
-		...defaultOptions,
-		...options
-	};
-	const results = /* @__PURE__ */ new Map();
-	await Promise.all(Array.from(new Set(repos)).map(async (repo) => {
-		const data = await fetchRepoData(repo, mergedOptions);
-		results.set(repo, data);
-	}));
-	return results;
-}
-/**
-* Pre-fetch all GitHub source files.
-*/
-async function prefetchGitHubSources(sources, options) {
-	const mergedOptions = {
-		...defaultOptions,
-		...options
-	};
-	const results = /* @__PURE__ */ new Map();
-	const uniqueSources = Array.from(new Map(sources.map((source) => [sourceKey(source), source])).values());
-	await Promise.all(uniqueSources.map(async (source) => {
-		const data = await fetchGitHubSource(source, mergedOptions);
-		results.set(sourceKey(source), data);
-	}));
-	return results;
-}
-/**
-* Rehype plugin to transform GitHub components.
-*/
-function rehypeGitHub(repoDataMap, sourceDataMap, options) {
-	return (tree) => {
-		const visit = (node) => {
-			if ("children" in node) for (let i = 0; i < node.children.length; i++) {
-				const child = node.children[i];
-				if (child.type === "element") if (child.tagName.toLowerCase() === "github") {
-					const attrs = attributesFromElement(child);
-					const source = sourceRefFromAttributes(attrs);
-					if (source) {
-						const sourceData = sourceDataMap.get(sourceKey(source));
-						node.children[i] = sourceData ? createGitHubSourceCard(sourceData, source.lines, options) : createFallbackCard(source.permalink);
-						continue;
-					}
-					const repo = attrs.repo;
-					if (repo) {
-						const repoData = repoDataMap.get(repo);
-						const cardElement = repoData ? createGitHubCard(repoData) : createFallbackCard(repo);
-						node.children[i] = cardElement;
-					}
-				} else visit(child);
-			}
-		};
-		visit(tree);
-	};
-}
-/**
-* Transform GitHub components in HTML.
-*/
-async function transformGitHub(html, repoDataMap, options) {
-	const mergedOptions = {
-		...defaultOptions,
-		...options
-	};
-	let dataMap = repoDataMap;
-	if (!dataMap) dataMap = await prefetchGitHubRepos(await collectGitHubRepos(html), mergedOptions);
-	const sourceDataMap = await prefetchGitHubSources(await collectGitHubSources(html), mergedOptions);
-	const result = await unified().use(rehypeParse, { fragment: true }).use(rehypeGitHub, dataMap, sourceDataMap, mergedOptions).use(rehypeStringify).process(html);
-	return String(result);
-}
-//#endregion
-export { github_exports as a, prefetchGitHubRepos as c, fetchRepoData as i, prefetchGitHubSources as l, collectGitHubSources as n, parseGitHubLineRange as o, fetchGitHubSource as r, parseGitHubPermalink as s, collectGitHubRepos as t, transformGitHub as u };
-
-//# sourceMappingURL=github.mjs.map
+import { d as transformGitHub } from "./github2.mjs";
+export { transformGitHub };