@deot/docs-dever 1.1.2 → 1.1.3

package/dist/index.cjs

@@ -35,6 +35,7 @@ _vitejs_plugin_vue_jsx = __toESM(_vitejs_plugin_vue_jsx, 1);
 let node_fs = require("node:fs");
 node_fs = __toESM(node_fs, 1);
 let node_crypto = require("node:crypto");
+let node_module = require("node:module");
 let node_http = require("node:http");
 node_http = __toESM(node_http, 1);
 //#region packages/dever/src/workspace.ts
@@ -324,6 +325,48 @@ var respondWorkspaceModule = async (req, res, projectRoot) => {
 	return true;
 };
 //#endregion
+//#region packages/dever/src/plugins/optional-dependencies.ts
+var resolveOptionalDependency = (id, importer) => {
+	if (!importer || !node_path.isAbsolute(importer) || /^[./]|:/.test(id)) return;
+	const filename = importer.split("?")[0];
+	const name = id.startsWith("@") ? id.split("/").slice(0, 2).join("/") : id.split("/")[0];
+	let directory = node_path.dirname(filename);
+	while (true) {
+		const manifest = node_path.join(directory, "package.json");
+		if (node_fs.existsSync(manifest)) {
+			const pkg = JSON.parse(node_fs.readFileSync(manifest, "utf8"));
+			if (!pkg.peerDependencies?.[name] || !pkg.peerDependenciesMeta?.[name]?.optional) return;
+			try {
+				(0, node_module.createRequire)(filename).resolve(id);
+			} catch (reason) {
+				if (reason.code === "MODULE_NOT_FOUND") return {
+					id: `https://cdn.jsdelivr.net/npm/${id}/+esm`,
+					external: true
+				};
+			}
+			return;
+		}
+		const parent = node_path.dirname(directory);
+		if (parent === directory) return;
+		directory = parent;
+	}
+};
+/**
+* 本地包未安装的 optional peer 由浏览器按需从 CDN 加载。
+* @returns 同时用于 Vite 模块转换与依赖预打包的解析插件。
+*/
+var createOptionalDependenciesPlugin = () => {
+	const resolver = {
+		name: "docs-optional-dependencies",
+		resolveId: resolveOptionalDependency
+	};
+	return {
+		...resolver,
+		enforce: "pre",
+		config: () => ({ optimizeDeps: { rolldownOptions: { plugins: [resolver] } } })
+	};
+};
+//#endregion
 //#region packages/dever/src/plugins/index.ts
 var innerPathRegex = /^\/(@|__)/;
 var directResourceExtensions = /* @__PURE__ */ new Set([".md", ".json"]);
@@ -522,6 +565,7 @@ var configureWorkspaceServer = (options, resolvedWorkspace) => (server) => {
 		let realResourceRoot = realWorkspace;
 		try {
 			const rawPathname = getRawPathname(req.url || "/");
+			if (/^\/__docs\/preview(?:-config-generate)?$/.test(rawPathname) && String(req.headers.accept || "").includes("text/html")) return next();
 			if (!options.preview && rawPathname.startsWith("/__docs/module/")) {
 				respondWorkspaceModule(req, res, resolved.projectRoot).catch((reason) => {
 					if (res.writableEnded) return;
@@ -701,15 +745,17 @@ var createHistoryPlugin = (options, resolvedWorkspace) => ({
 		server.middlewares.use(async (req, res, next) => {
 			const requestUrl = req.url || "/";
 			const url = requestUrl.replace(/\/+/g, "/").replace(/[?#].*$/s, "") || "";
+			const accept = String(req.headers?.accept || "text/html");
+			const isPreviewPage = /^\/__docs\/preview(?:-config-generate)?$/.test(url) && accept.includes("text/html");
 			const candidate = node_path.resolve(root, `.${url}`);
 			const isFile = node_fs.existsSync(candidate) && node_fs.statSync(candidate).isFile();
-			if (options.preview && url.startsWith("/__docs/")) {
+			if (options.preview && url.startsWith("/__docs/") && !isPreviewPage) {
 				res.statusCode = 404;
 				res.end("Not Found");
 				return;
 			}
-			if (res.writableEnded || requestUrl.includes("html-proxy&") || innerPathRegex.test(url) || isFile) return next();
-			if (!String(req.headers?.accept || "text/html").includes("text/html")) return next();
+			if (res.writableEnded || requestUrl.includes("html-proxy&") || innerPathRegex.test(url) && !isPreviewPage || isFile) return next();
+			if (!accept.includes("text/html")) return next();
 			const indexFile = resolvedWorkspace?.entry || resolveDocsWorkspace(options.preview ? root : process.cwd(), options.preview ? "." : options.workspace).entry;
 			if (!node_fs.existsSync(indexFile)) {
 				res.statusCode = 404;
@@ -774,6 +820,7 @@ var createStaticCopyPlugin = (options, resolvedWorkspace) => ({
 	}
 });
 var plugins_default = (options = {}, resolvedWorkspace) => (0, vite.defineConfig)({ plugins: [
+	createOptionalDependenciesPlugin(),
 	createRuntimePlugin(options, resolvedWorkspace),
 	createWorkspacePlugin(options, resolvedWorkspace),
 	createHistoryPlugin(options, resolvedWorkspace),
@@ -938,7 +985,8 @@ var createPreviewRequestHandler = (options) => {
 				return;
 			}
 			const pathname = decodeRequestPath(req.url || "/");
-			if (pathname.startsWith("/__docs/")) {
+			const isPreviewPage = /^\/__docs\/preview(?:-config-generate)?$/.test(pathname) && String(req.headers.accept || "").includes("text/html");
+			if (pathname.startsWith("/__docs/") && !isPreviewPage) {
 				res.statusCode = 404;
 				res.end("Not Found");
 				return;

package/dist/index.js

@@ -7,6 +7,7 @@ import vue from "@vitejs/plugin-vue";
 import vueJsx from "@vitejs/plugin-vue-jsx";
 import * as fs$1 from "node:fs";
 import { createHash } from "node:crypto";
+import { createRequire } from "node:module";
 import * as http from "node:http";
 //#region packages/dever/src/workspace.ts
 /**
@@ -295,6 +296,48 @@ var respondWorkspaceModule = async (req, res, projectRoot) => {
 	return true;
 };
 //#endregion
+//#region packages/dever/src/plugins/optional-dependencies.ts
+var resolveOptionalDependency = (id, importer) => {
+	if (!importer || !path.isAbsolute(importer) || /^[./]|:/.test(id)) return;
+	const filename = importer.split("?")[0];
+	const name = id.startsWith("@") ? id.split("/").slice(0, 2).join("/") : id.split("/")[0];
+	let directory = path.dirname(filename);
+	while (true) {
+		const manifest = path.join(directory, "package.json");
+		if (fs$1.existsSync(manifest)) {
+			const pkg = JSON.parse(fs$1.readFileSync(manifest, "utf8"));
+			if (!pkg.peerDependencies?.[name] || !pkg.peerDependenciesMeta?.[name]?.optional) return;
+			try {
+				createRequire(filename).resolve(id);
+			} catch (reason) {
+				if (reason.code === "MODULE_NOT_FOUND") return {
+					id: `https://cdn.jsdelivr.net/npm/${id}/+esm`,
+					external: true
+				};
+			}
+			return;
+		}
+		const parent = path.dirname(directory);
+		if (parent === directory) return;
+		directory = parent;
+	}
+};
+/**
+* 本地包未安装的 optional peer 由浏览器按需从 CDN 加载。
+* @returns 同时用于 Vite 模块转换与依赖预打包的解析插件。
+*/
+var createOptionalDependenciesPlugin = () => {
+	const resolver = {
+		name: "docs-optional-dependencies",
+		resolveId: resolveOptionalDependency
+	};
+	return {
+		...resolver,
+		enforce: "pre",
+		config: () => ({ optimizeDeps: { rolldownOptions: { plugins: [resolver] } } })
+	};
+};
+//#endregion
 //#region packages/dever/src/plugins/index.ts
 var innerPathRegex = /^\/(@|__)/;
 var directResourceExtensions = /* @__PURE__ */ new Set([".md", ".json"]);
@@ -493,6 +536,7 @@ var configureWorkspaceServer = (options, resolvedWorkspace) => (server) => {
 		let realResourceRoot = realWorkspace;
 		try {
 			const rawPathname = getRawPathname(req.url || "/");
+			if (/^\/__docs\/preview(?:-config-generate)?$/.test(rawPathname) && String(req.headers.accept || "").includes("text/html")) return next();
 			if (!options.preview && rawPathname.startsWith("/__docs/module/")) {
 				respondWorkspaceModule(req, res, resolved.projectRoot).catch((reason) => {
 					if (res.writableEnded) return;
@@ -672,15 +716,17 @@ var createHistoryPlugin = (options, resolvedWorkspace) => ({
 		server.middlewares.use(async (req, res, next) => {
 			const requestUrl = req.url || "/";
 			const url = requestUrl.replace(/\/+/g, "/").replace(/[?#].*$/s, "") || "";
+			const accept = String(req.headers?.accept || "text/html");
+			const isPreviewPage = /^\/__docs\/preview(?:-config-generate)?$/.test(url) && accept.includes("text/html");
 			const candidate = path.resolve(root, `.${url}`);
 			const isFile = fs$1.existsSync(candidate) && fs$1.statSync(candidate).isFile();
-			if (options.preview && url.startsWith("/__docs/")) {
+			if (options.preview && url.startsWith("/__docs/") && !isPreviewPage) {
 				res.statusCode = 404;
 				res.end("Not Found");
 				return;
 			}
-			if (res.writableEnded || requestUrl.includes("html-proxy&") || innerPathRegex.test(url) || isFile) return next();
-			if (!String(req.headers?.accept || "text/html").includes("text/html")) return next();
+			if (res.writableEnded || requestUrl.includes("html-proxy&") || innerPathRegex.test(url) && !isPreviewPage || isFile) return next();
+			if (!accept.includes("text/html")) return next();
 			const indexFile = resolvedWorkspace?.entry || resolveDocsWorkspace(options.preview ? root : process.cwd(), options.preview ? "." : options.workspace).entry;
 			if (!fs$1.existsSync(indexFile)) {
 				res.statusCode = 404;
@@ -745,6 +791,7 @@ var createStaticCopyPlugin = (options, resolvedWorkspace) => ({
 	}
 });
 var plugins_default = (options = {}, resolvedWorkspace) => defineConfig({ plugins: [
+	createOptionalDependenciesPlugin(),
 	createRuntimePlugin(options, resolvedWorkspace),
 	createWorkspacePlugin(options, resolvedWorkspace),
 	createHistoryPlugin(options, resolvedWorkspace),
@@ -909,7 +956,8 @@ var createPreviewRequestHandler = (options) => {
 				return;
 			}
 			const pathname = decodeRequestPath(req.url || "/");
-			if (pathname.startsWith("/__docs/")) {
+			const isPreviewPage = /^\/__docs\/preview(?:-config-generate)?$/.test(pathname) && String(req.headers.accept || "").includes("text/html");
+			if (pathname.startsWith("/__docs/") && !isPreviewPage) {
 				res.statusCode = 404;
 				res.end("Not Found");
 				return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deot/docs-dever",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",