@ox-content/vite-plugin 2.69.0 → 2.71.0

package/dist/github.mjs

@@ -1,2 +1,622 @@
-import { d as transformGitHub } from "./github2.mjs";
-export { transformGitHub };
+import { unified } from "unified";
+import rehypeParse from "rehype-parse";
+import rehypeStringify from "rehype-stringify";
+import { Buffer } from "node:buffer";
+//#region src/plugins/github/validation.ts
+const GITHUB_REPO_RE = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+function hasControlChar(value) {
+	for (let index = 0; index < value.length; index++) {
+		const code = value.charCodeAt(index);
+		if (code <= 31 || code === 127) return true;
+	}
+	return false;
+}
+function isSafeGitHubRepo(repo) {
+	return GITHUB_REPO_RE.test(repo) && !repo.split("/").some((part) => part === "." || part === "..");
+}
+function isSafeGitHubRef(ref) {
+	return Boolean(ref) && !hasControlChar(ref) && !hasUnsafePathSegment(ref);
+}
+function isSafeGitHubPath(path) {
+	return Boolean(path) && !hasControlChar(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("/");
+}
+//#endregion
+//#region src/plugins/github/source.ts
+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 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)
+	};
+}
+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;
+}
+//#endregion
+//#region src/plugins/github/types.ts
+const defaultOptions = {
+	token: "",
+	cache: true,
+	cacheTTL: 36e5,
+	maxSourceBytes: 2e5,
+	maxSourceLines: 120
+};
+//#endregion
+//#region src/plugins/github/api.ts
+const repoCache = /* @__PURE__ */ new Map();
+const sourceCache = /* @__PURE__ */ new Map();
+function githubHeaders(options) {
+	const headers = {
+		Accept: "application/vnd.github.v3+json",
+		"User-Agent": "ox-content-github-plugin"
+	};
+	if (options.token) headers.Authorization = `Bearer ${options.token}`;
+	return headers;
+}
+/**
+* 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 response = await fetch(`https://api.github.com/repos/${repo}`, { headers: githubHeaders(options) });
+		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 apiUrl = `https://api.github.com/repos/${source.repo}/contents/${encodePath(source.path)}?ref=${encodeURIComponent(source.ref)}`;
+		const response = await fetch(apiUrl, { headers: githubHeaders(options) });
+		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;
+	}
+}
+/**
+* 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;
+}
+//#endregion
+//#region src/plugins/github/attributes.ts
+const GITHUB_COMPONENT_RE = /<github\b([^>]*)>/gi;
+const ATTRIBUTE_RE = /([:\w-]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>/]+)))?/g;
+/**
+* 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 getAttribute(el, name) {
+	const value = el.properties?.[name];
+	if (typeof value === "string") return value;
+	if (Array.isArray(value)) return value.join(" ");
+}
+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)
+	};
+}
+//#endregion
+//#region src/plugins/github/fallback-card.ts
+/**
+* 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
+				}]
+			}]
+		}]
+	};
+}
+//#endregion
+//#region src/plugins/github/repo-card.ts
+function formatNumber(num) {
+	if (num >= 1e6) return `${(num / 1e6).toFixed(1)}M`;
+	if (num >= 1e3) return `${(num / 1e3).toFixed(1)}k`;
+	return String(num);
+}
+function iconPath(d) {
+	return {
+		type: "element",
+		tagName: "svg",
+		properties: {
+			viewBox: "0 0 16 16",
+			fill: "currentColor"
+		},
+		children: [{
+			type: "element",
+			tagName: "path",
+			properties: { d },
+			children: []
+		}]
+	};
+}
+function createStatsChildren(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: [iconPath("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"), {
+			type: "text",
+			value: formatNumber(repoData.stargazers_count)
+		}]
+	});
+	statsChildren.push({
+		type: "element",
+		tagName: "span",
+		properties: { className: ["ox-github-stat"] },
+		children: [iconPath("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"), {
+			type: "text",
+			value: formatNumber(repoData.forks_count)
+		}]
+	});
+	return statsChildren;
+}
+/**
+* Create GitHub card element from repo data.
+*/
+function createGitHubCard(repoData) {
+	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: [{
+					...iconPath("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"),
+					properties: {
+						className: ["ox-github-icon"],
+						viewBox: "0 0 16 16",
+						fill: "currentColor"
+					}
+				}, {
+					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: createStatsChildren(repoData)
+			}
+		]
+	};
+}
+//#endregion
+//#region src/plugins/github/source-card.ts
+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 || " "
+							}]
+						}]
+					};
+				})
+			}]
+		}]
+	};
+}
+//#endregion
+//#region src/plugins/github/transform.ts
+/**
+* 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") continue;
+				if (child.tagName.toLowerCase() !== "github") {
+					visit(child);
+					continue;
+				}
+				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);
+					node.children[i] = repoData ? createGitHubCard(repoData) : createFallbackCard(repo);
+				}
+			}
+		};
+		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 { fetchRepoData as a, createGitHubPermalink as c, isSafeGitHubRepo as d, fetchGitHubSource as i, parseGitHubLineRange as l, collectGitHubRepos as n, prefetchGitHubRepos as o, collectGitHubSources as r, prefetchGitHubSources as s, transformGitHub as t, parseGitHubPermalink as u };
+
+//# sourceMappingURL=github.mjs.map