@ox-content/vite-plugin 2.30.0 → 2.31.0

package/dist/index.cjs

@@ -5,6 +5,7 @@ const require_mermaid = require("./mermaid.cjs");
 const require_tabs = require("./tabs.cjs");
 require("./pm.cjs");
 const require_youtube = require("./youtube.cjs");
+require("./media.cjs");
 const require_github = require("./github.cjs");
 const require_ogp = require("./ogp.cjs");
 const require_vitepress = require("./vitepress.cjs");
@@ -19,6 +20,11 @@ let shiki = require("shiki");
 let node_module = require("node:module");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path, 1);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_chunk.__toESM(node_fs_promises, 1);
+let node_os = require("node:os");
+let node_util = require("node:util");
+let node_child_process = require("node:child_process");
 let fs_promises = require("fs/promises");
 fs_promises = require_chunk.__toESM(fs_promises, 1);
 let crypto = require("crypto");
@@ -26,8 +32,6 @@ crypto = require_chunk.__toESM(crypto, 1);
 let fs = require("fs");
 fs = require_chunk.__toESM(fs, 1);
 let glob = require("glob");
-let node_fs_promises = require("node:fs/promises");
-node_fs_promises = require_chunk.__toESM(node_fs_promises, 1);
 //#region src/markdown.ts
 const DEFAULT_MARKDOWN_EXTENSIONS = [
 	".md",
@@ -281,14 +285,14 @@ async function highlightCode(html, theme = "github-dark", langs = []) {
 * Transform all enabled plugins in HTML content.
 */
 async function transformAllPlugins(html, options = {}) {
-	const { tabs = true, pm = true, youtube = true, github = true, ogp, openGraph, mermaid = true, githubToken } = options;
+	const { tabs = true, pm = false, youtube = true, github = true, ogp, openGraph, mermaid = true, githubToken, spotify = false, stackBlitz = false, twitter = false, bluesky = false, webContainer = false } = options;
 	let result = html;
 	const ogpOptions = openGraph ?? ogp ?? true;
 	if (tabs) {
 		const { transformTabs } = await Promise.resolve().then(() => require("./tabs.cjs")).then((n) => n.tabs_exports);
 		result = await transformTabs(result);
 	}
-	if (pm !== false) {
+	if (pm) {
 		const { transformPm } = await Promise.resolve().then(() => require("./pm.cjs")).then((n) => n.pm_exports);
 		result = await transformPm(result, typeof pm === "object" ? pm : {});
 	}
@@ -307,6 +311,17 @@ async function transformAllPlugins(html, options = {}) {
 		const { transformOgp } = await Promise.resolve().then(() => require("./ogp.cjs")).then((n) => n.ogp_exports);
 		result = await transformOgp(result, void 0, typeof ogpOptions === "object" ? ogpOptions : {});
 	}
+	const mediaOptions = {
+		spotify,
+		stackBlitz,
+		twitter,
+		bluesky,
+		webContainer
+	};
+	if (Object.values(mediaOptions).some(Boolean)) {
+		const { transformMediaEmbeds } = await Promise.resolve().then(() => require("./media.cjs")).then((n) => n.media_exports);
+		result = await transformMediaEmbeds(result, mediaOptions);
+	}
 	if (mermaid) {
 		const { transformMermaidStatic } = await Promise.resolve().then(() => require("./mermaid.cjs")).then((n) => n.mermaid_exports);
 		result = await transformMermaidStatic(result);
@@ -329,6 +344,21 @@ async function transformBuiltinEmbeds(html, options) {
 		const { transformOgp } = await Promise.resolve().then(() => require("./ogp.cjs")).then((n) => n.ogp_exports);
 		result = await transformOgp(result, void 0, options.openGraph);
 	}
+	if (options.pm) {
+		const { transformPm } = await Promise.resolve().then(() => require("./pm.cjs")).then((n) => n.pm_exports);
+		result = await transformPm(result, typeof options.pm === "object" ? options.pm : {});
+	}
+	const mediaOptions = {
+		spotify: options.spotify,
+		stackBlitz: options.stackBlitz,
+		twitter: options.twitter,
+		bluesky: options.bluesky,
+		webContainer: options.webContainer
+	};
+	if (Object.values(mediaOptions).some(Boolean)) {
+		const { transformMediaEmbeds } = await Promise.resolve().then(() => require("./media.cjs")).then((n) => n.media_exports);
+		result = await transformMediaEmbeds(result, mediaOptions);
+	}
 	return result;
 }
 //#endregion
@@ -386,6 +416,94 @@ function restoreMermaidSvgs(html, svgs) {
 	});
 }
 //#endregion
+//#region src/code-blocks.ts
+const execFileAsync = (0, node_util.promisify)(node_child_process.execFile);
+async function extractCodeBlocks(source) {
+	return (await require_napi.importNapiModule()).extractCodeBlocks(source).map(normalizeBlock);
+}
+async function lintCodeBlocks(source, options = {}) {
+	return (await require_napi.importNapiModule()).lintCodeBlocks(source, {
+		enabled: true,
+		languages: options.languages,
+		requireLanguage: options.requireLanguage,
+		trailingSpaces: options.trailingSpaces
+	}).map(normalizeDiagnostic);
+}
+async function extractDocsTests(source, options = {}) {
+	return (await require_napi.importNapiModule()).extractDocsTests(source, {
+		enabled: true,
+		languages: options.languages,
+		requireMeta: options.requireMeta
+	}).map(normalizeBlock);
+}
+async function typecheckCodeBlocks(source, options = {}) {
+	if (!source.includes("```")) return [];
+	const languages = new Set((options.languages ?? ["ts", "tsx"]).map((language) => language.toLowerCase()));
+	const blocks = (await extractCodeBlocks(source)).filter((block) => {
+		if (!languages.has(block.language.toLowerCase())) return false;
+		return options.requireMeta === false || hasTypecheckMeta(block.meta);
+	});
+	if (blocks.length === 0) return [];
+	const temp = await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), "ox-content-code-blocks-"));
+	try {
+		const files = [];
+		await Promise.all(blocks.map(async (block, index) => {
+			const file = (0, node_path.join)(temp, `snippet-${index}.${block.language.toLowerCase() === "tsx" ? "tsx" : "ts"}`);
+			files.push(file);
+			await (0, node_fs_promises.writeFile)(file, block.code);
+		}));
+		try {
+			await execFileAsync(options.tsgoCommand ?? "tsgo", [
+				"--noEmit",
+				"--pretty",
+				"false",
+				...files
+			], {
+				cwd: process.cwd(),
+				maxBuffer: 1024 * 1024 * 4
+			});
+			return [];
+		} catch (error) {
+			return [{
+				ruleId: "code-block-typecheck",
+				severity: "error",
+				message: commandOutput(error) || "TypeScript code block type-checking failed.",
+				line: blocks[0]?.startLine ?? 1,
+				column: 1,
+				endLine: blocks[0]?.startLine ?? 1,
+				endColumn: 1,
+				language: "ts"
+			}];
+		}
+	} finally {
+		await (0, node_fs_promises.rm)(temp, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function hasTypecheckMeta(meta) {
+	return meta.split(/\s+/).some((token) => token === "typecheck" || token === "twoslash" || token.startsWith("typecheck="));
+}
+function commandOutput(error) {
+	if (!error || typeof error !== "object") return "";
+	const value = error;
+	return [
+		value.stdout,
+		value.stderr,
+		value.message
+	].filter((part) => typeof part === "string" && part.trim().length > 0).join("\n").trim();
+}
+function normalizeBlock(block) {
+	return block;
+}
+function normalizeDiagnostic(diagnostic) {
+	return {
+		...diagnostic,
+		severity: diagnostic.severity === "error" || diagnostic.severity === "info" ? diagnostic.severity : "warning"
+	};
+}
+//#endregion
 //#region src/transform.ts
 /**
 * Cached NAPI bindings instance.
@@ -452,6 +570,8 @@ async function loadNapiBindings() {
 async function transformMarkdown(source, filePath, options, ssgOptions) {
 	const napi = await loadNapiBindings();
 	if (!napi) throw new Error("[ox-content] NAPI bindings not available. Please ensure @ox-content/napi is built.");
+	runCodeBlockLint(source, napi, options);
+	await runCodeBlockTypecheck(source, options);
 	const result = napi.transform(source, {
 		gfm: options.gfm,
 		footnotes: options.footnotes,
@@ -463,10 +583,32 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		convertMdLinks: ssgOptions?.convertMdLinks,
 		baseUrl: ssgOptions?.baseUrl,
 		sourcePath: ssgOptions?.sourcePath ?? filePath,
-		codeAnnotations: options.codeAnnotations.enabled,
-		codeAnnotationMetaKey: options.codeAnnotations.metaKey,
-		codeAnnotationSyntax: options.codeAnnotations.notation,
-		codeAnnotationDefaultLineNumbers: options.codeAnnotations.defaultLineNumbers
+		codeAnnotations: options.codeAnnotations?.enabled ?? false,
+		codeAnnotationMetaKey: options.codeAnnotations?.metaKey ?? "annotate",
+		codeAnnotationSyntax: options.codeAnnotations?.notation ?? "attribute",
+		codeAnnotationDefaultLineNumbers: options.codeAnnotations?.defaultLineNumbers ?? false,
+		wikiLinks: options.wikiLinks?.enabled ? {
+			enabled: true,
+			baseUrl: options.wikiLinks.baseUrl
+		} : void 0,
+		emojiShortcodes: options.emojiShortcodes?.enabled ? {
+			enabled: true,
+			custom: options.emojiShortcodes.custom
+		} : void 0,
+		attributes: options.attrs?.enabled ? { enabled: true } : void 0,
+		cjkEmphasis: options.cjkEmphasis ?? false,
+		codeImports: options.codeImports?.enabled ? {
+			enabled: true,
+			rootDir: options.codeImports.rootDir
+		} : void 0,
+		sanitize: void 0,
+		editThisPage: options.editThisPage?.enabled ? {
+			enabled: true,
+			repoUrl: options.editThisPage.repoUrl,
+			branch: options.editThisPage.branch,
+			rootDir: options.editThisPage.rootDir,
+			label: options.editThisPage.label
+		} : void 0
 	});
 	if (result.errors.length > 0) console.warn("[ox-content] Transform warnings:", result.errors);
 	let html = result.html;
@@ -485,6 +627,7 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		openGraph: {}
 	});
 	html = restoreMermaidSvgs(html, svgs);
+	if (options.sanitize?.enabled) html = napi.sanitizeHtml(html, toJsSanitizeOptions(options.sanitize));
 	return {
 		code: generateModuleCode(html, frontmatter, toc, filePath, options),
 		html,
@@ -492,6 +635,43 @@ async function transformMarkdown(source, filePath, options, ssgOptions) {
 		toc
 	};
 }
+async function runCodeBlockTypecheck(source, options) {
+	const typecheck = options.codeBlockTypecheck;
+	if (!typecheck?.enabled || !source.includes("```")) return;
+	const diagnostics = await typecheckCodeBlocks(source, {
+		languages: typecheck.languages,
+		requireMeta: typecheck.requireMeta,
+		tsgoCommand: typecheck.tsgoCommand
+	});
+	if (diagnostics.length === 0) return;
+	const message = diagnostics.slice(0, 3).map((diagnostic) => `${diagnostic.ruleId} at ${diagnostic.line}: ${diagnostic.message}`).join("\n");
+	if (typecheck.mode === "error") throw new Error(`[ox-content] Code block type-checking failed:\n${message}`);
+	console.warn(`[ox-content] Code block type-checking warnings:\n${message}`);
+}
+function runCodeBlockLint(source, napi, options) {
+	const lint = options.codeBlockLint;
+	if (!lint?.enabled || !source.includes("```")) return;
+	const diagnostics = napi.lintCodeBlocks(source, {
+		enabled: true,
+		languages: lint.languages,
+		requireLanguage: lint.requireLanguage,
+		trailingSpaces: lint.trailingSpaces
+	});
+	if (diagnostics.length === 0) return;
+	const message = diagnostics.slice(0, 5).map((diagnostic) => {
+		return `${diagnostic.ruleId} at ${diagnostic.line}:${diagnostic.column} ${diagnostic.message}`;
+	}).join("\n");
+	if (lint.mode === "error") throw new Error(`[ox-content] Code block lint failed:\n${message}`);
+	console.warn(`[ox-content] Code block lint warnings:\n${message}`);
+}
+function toJsSanitizeOptions(options) {
+	return {
+		enabled: true,
+		allowedTags: options.allowedTags,
+		allowedAttributes: options.allowedAttributes,
+		allowedUrlSchemes: options.allowedUrlSchemes
+	};
+}
 function parseFrontmatterJson(json) {
 	if (!json) return {};
 	try {
@@ -1962,6 +2142,12 @@ async function transformSsgHtml(html, options) {
 		youtube: true,
 		github: options.embeds.github,
 		openGraph: options.embeds.openGraph,
+		pm: options.embeds.pm,
+		spotify: options.embeds.spotify,
+		stackBlitz: options.embeds.stackBlitz,
+		twitter: options.embeds.twitter,
+		bluesky: options.embeds.bluesky,
+		webContainer: options.embeds.webContainer,
 		mermaid: true,
 		githubToken: process.env.GITHUB_TOKEN
 	});
@@ -2271,6 +2457,12 @@ async function renderPage$1(filePath, options, navGroups, siteName, base, root)
 		youtube: true,
 		github: options.embeds.github,
 		openGraph: options.embeds.openGraph,
+		pm: options.embeds.pm,
+		spotify: options.embeds.spotify,
+		stackBlitz: options.embeds.stackBlitz,
+		twitter: options.embeds.twitter,
+		bluesky: options.embeds.bluesky,
+		webContainer: options.embeds.webContainer,
 		mermaid: true,
 		githubToken: process.env.GITHUB_TOKEN
 	});
@@ -3936,6 +4128,16 @@ function resolveOptions(options) {
 		highlightTheme: options.highlightTheme ?? "github-dark",
 		highlightLangs: options.highlightLangs ?? [],
 		codeAnnotations: resolveCodeAnnotationsOptions(options.codeAnnotations),
+		wikiLinks: resolveWikiLinkOptions(options.wikiLinks, options.base ?? "/"),
+		emojiShortcodes: resolveEmojiShortcodeOptions(options.emojiShortcodes),
+		attrs: resolveAttrsOptions(options.attrs),
+		codeImports: resolveCodeImportOptions(options.codeImports),
+		sanitize: resolveSanitizeOptions(options.sanitize),
+		editThisPage: resolveEditThisPageOptions(options.editThisPage),
+		cjkEmphasis: options.cjkEmphasis ?? false,
+		codeBlockLint: resolveCodeBlockLintOptions(options.codeBlockLint),
+		codeBlockTypecheck: resolveCodeBlockTypecheckOptions(options.codeBlockTypecheck),
+		docsTests: resolveDocsTestOptions(options.docsTests),
 		mermaid: options.mermaid ?? false,
 		frontmatter: options.frontmatter ?? true,
 		toc: options.toc ?? true,
@@ -3953,11 +4155,23 @@ function resolveOptions(options) {
 function resolveBuiltinEmbedOptions(options) {
 	if (options === false) return {
 		github: false,
-		openGraph: false
+		openGraph: false,
+		pm: false,
+		spotify: false,
+		stackBlitz: false,
+		twitter: false,
+		bluesky: false,
+		webContainer: false
 	};
 	return {
 		github: resolveSingleEmbedOptions(options?.github),
-		openGraph: resolveSingleEmbedOptions(options?.openGraph)
+		openGraph: resolveSingleEmbedOptions(options?.openGraph),
+		pm: resolvePmOptions(options?.pm),
+		spotify: options?.spotify === true,
+		stackBlitz: options?.stackBlitz === true,
+		twitter: options?.twitter === true,
+		bluesky: options?.bluesky === true,
+		webContainer: options?.webContainer === true
 	};
 }
 function resolveSingleEmbedOptions(options) {
@@ -3965,6 +4179,157 @@ function resolveSingleEmbedOptions(options) {
 	if (options === true || options === void 0) return {};
 	return options;
 }
+function resolvePmOptions(options) {
+	if (options === false || options === void 0) return false;
+	if (options === true) return {};
+	return options;
+}
+function resolveWikiLinkOptions(options, baseUrl) {
+	if (!options) return {
+		enabled: false,
+		baseUrl
+	};
+	if (options === true) return {
+		enabled: true,
+		baseUrl
+	};
+	return {
+		enabled: true,
+		baseUrl: options.baseUrl ?? baseUrl
+	};
+}
+function resolveEmojiShortcodeOptions(options) {
+	if (!options) return {
+		enabled: false,
+		custom: {}
+	};
+	if (options === true) return {
+		enabled: true,
+		custom: {}
+	};
+	return {
+		enabled: true,
+		custom: options.custom ?? {}
+	};
+}
+function resolveAttrsOptions(options) {
+	if (!options) return { enabled: false };
+	if (options === true) return { enabled: true };
+	return { enabled: options.enabled ?? true };
+}
+function resolveCodeImportOptions(options) {
+	if (!options) return { enabled: false };
+	if (options === true) return { enabled: true };
+	return {
+		enabled: true,
+		rootDir: options.rootDir
+	};
+}
+function resolveSanitizeOptions(options) {
+	if (!options) return { enabled: false };
+	if (options === true) return { enabled: true };
+	return {
+		enabled: true,
+		allowedTags: options.allowedTags,
+		allowedAttributes: options.allowedAttributes,
+		allowedUrlSchemes: options.allowedUrlSchemes
+	};
+}
+function resolveEditThisPageOptions(options) {
+	if (!options) return {
+		enabled: false,
+		branch: "main",
+		label: "Edit this page"
+	};
+	if (options === true) return {
+		enabled: false,
+		branch: "main",
+		label: "Edit this page"
+	};
+	return {
+		enabled: Boolean(options.repoUrl),
+		repoUrl: options.repoUrl,
+		branch: options.branch ?? "main",
+		rootDir: options.rootDir,
+		label: options.label ?? "Edit this page"
+	};
+}
+function resolveCodeBlockLintOptions(options) {
+	if (!options) return {
+		enabled: false,
+		requireLanguage: false,
+		trailingSpaces: true,
+		mode: "warn"
+	};
+	if (options === true) return {
+		enabled: true,
+		requireLanguage: false,
+		trailingSpaces: true,
+		mode: "warn"
+	};
+	return {
+		enabled: true,
+		languages: options.languages,
+		requireLanguage: options.requireLanguage ?? false,
+		trailingSpaces: options.trailingSpaces ?? true,
+		mode: options.mode ?? "warn"
+	};
+}
+function resolveCodeBlockTypecheckOptions(options) {
+	if (!options) return {
+		enabled: false,
+		languages: ["ts", "tsx"],
+		requireMeta: true,
+		tsgoCommand: "tsgo",
+		mode: "warn"
+	};
+	if (options === true) return {
+		enabled: true,
+		languages: ["ts", "tsx"],
+		requireMeta: true,
+		tsgoCommand: "tsgo",
+		mode: "warn"
+	};
+	return {
+		enabled: true,
+		languages: options.languages ?? ["ts", "tsx"],
+		requireMeta: options.requireMeta ?? true,
+		tsgoCommand: options.tsgoCommand ?? "tsgo",
+		mode: options.mode ?? "warn"
+	};
+}
+function resolveDocsTestOptions(options) {
+	if (!options) return {
+		enabled: false,
+		languages: [
+			"js",
+			"jsx",
+			"ts",
+			"tsx"
+		],
+		requireMeta: true
+	};
+	if (options === true) return {
+		enabled: true,
+		languages: [
+			"js",
+			"jsx",
+			"ts",
+			"tsx"
+		],
+		requireMeta: true
+	};
+	return {
+		enabled: true,
+		languages: options.languages ?? [
+			"js",
+			"jsx",
+			"ts",
+			"tsx"
+		],
+		requireMeta: options.requireMeta ?? true
+	};
+}
 function resolveCodeAnnotationsOptions(options) {
 	if (!options) return {
 		enabled: false,
@@ -4055,7 +4420,9 @@ exports.createTheme = createTheme;
 exports.defaultTheme = require_vitepress.defaultTheme;
 exports.defineTheme = require_vitepress.defineTheme;
 exports.each = each;
+exports.extractCodeBlocks = extractCodeBlocks;
 exports.extractDocs = extractDocs;
+exports.extractDocsTests = extractDocsTests;
 exports.extractIslandInfo = extractIslandInfo;
 exports.extractVideoId = require_youtube.extractVideoId;
 exports.fetchGitHubSource = require_github.fetchGitHubSource;
@@ -4075,6 +4442,7 @@ exports.inferType = inferType;
 exports.isMarkdownFilePath = isMarkdownFilePath;
 exports.jsx = jsx;
 exports.jsxs = jsxs;
+exports.lintCodeBlocks = lintCodeBlocks;
 exports.lintMarkdown = lintMarkdown;
 exports.lintMarkdownAsync = lintMarkdownAsync;
 exports.lintMarkdownFile = lintMarkdownFile;
@@ -4111,6 +4479,7 @@ exports.transformMermaidStatic = require_mermaid.transformMermaidStatic;
 exports.transformOgp = require_ogp.transformOgp;
 exports.transformTabs = require_tabs.transformTabs;
 exports.transformYouTube = require_youtube.transformYouTube;
+exports.typecheckCodeBlocks = typecheckCodeBlocks;
 exports.useIsActive = useIsActive;
 exports.useNav = useNav;
 exports.usePageProps = usePageProps;