@deot/docs-dever 1.1.5 → 1.1.6

package/README.md

@@ -103,7 +103,7 @@ preview 与 production 不提供该入口；`/__docs/*` 在 preview 下返回 40
 - 原始源码中间件会校验真实路径，拒绝目录穿越和逃逸 workspace 的符号链接。
 - preview 不启动 Vite、watcher、HMR 或 SSE，不注入开发 runtime，且 `/__docs/*`（含页面保存入口）返回 404。
 - 根 workspace 构建会跳过隐藏目录、`node_modules`、`coverage`、常见构建缓存目录和当前 outDir。
-- 在本仓库预览时会复用统一 DDC 构建，并按 `@deot/docs-client[@version]/dist/index.*` 与 jsDelivr `/+esm`（映射到 `dist/index.js`）改写成本地 Client，本地地址保留 `dist/`；不限制 unpkg、jsDelivr 等 CDN 域名；其他项目保留 HTML 中声明的发布包 URL。
+- 在本仓库预览时会复用统一 DDC 构建，提供本地 launch 与 Client。HTML 的 launch 地址映射到本地适配入口，先调用用户 CDN 钩子，再将动态生成的 Client JS/CSS 地址映射到当前 dist；支持 jsDelivr `/+esm` 和 ESM UNPKG 包根入口。已有 Client `dist/index.*` 地址仍直接改写，本地地址保留 `dist/`。其他项目保留 HTML 中声明的发布包 URL。
 
 ## 仓库内验证
 

package/dist/index.cjs

@@ -518,7 +518,7 @@ var createRuntimePlugin = (options, resolvedWorkspace) => ({
 	name: "docs-runtime",
 	transformIndexHtml: options.build || options.preview ? void 0 : {
 		order: "pre",
-		handler() {
+		handler(html = "") {
 			const workspace = (resolvedWorkspace || resolveDocsWorkspace(process.cwd(), options.workspace)).urlBase;
 			const localClientEntry = node_path.resolve(process.cwd(), "packages/client/src/index.ts");
 			const runtime = JSON.stringify({
@@ -526,7 +526,7 @@ var createRuntimePlugin = (options, resolvedWorkspace) => ({
 				workspace,
 				events: "/__docs/events"
 			}).replace(/</g, "\\u003c");
-			const styles = node_fs.existsSync(localClientEntry) ? [] : [
+			const styles = node_fs.existsSync(localClientEntry) || html.includes("@deot/docs-launch") ? [] : [
 				"https://cdn.jsdelivr.net/npm/@deot/docs-client/dist/index.style.css",
 				"https://cdn.jsdelivr.net/npm/@deot/docs-renderer/dist/index.style.css",
 				"https://cdn.jsdelivr.net/npm/@deot/docs-markdown/dist/index.style.css",
@@ -831,7 +831,10 @@ var plugins_default = (options = {}, resolvedWorkspace) => (0, vite.defineConfig
 //#endregion
 //#region packages/dever/src/preview.ts
 var CLIENT_PREFIX = "/@deot/docs-client/";
+var LAUNCH_PREFIX = "/@deot/docs-launch/";
+var LAUNCH_ASSET_PATTERN = /https?:\/\/[^/"'\s<>]+(?:\/[^/"'\s<>?#]+)*\/@deot\/docs-launch(?:@[^/"'\s<>?#]+)?(?:\/\+esm|\/dist\/index\.js)?(?=["'\s<>?#]|$)/gu;
 var CLIENT_ENTRY = "dist/index.js";
+var UNPKG_CLIENT_ENTRY_PATTERN = /https?:\/\/esm\.unpkg\.com\/@deot\/docs-client(?:@[^/"'\x60\s<>?#]+)?(?=["'\x60\s<>?#]|$)/gu;
 var CLIENT_ASSET_PATTERN = new RegExp([
 	String.raw`(?:https?:)?//[^/"'\x60\s<>]+`,
 	String.raw`(?:/[^/"'\x60\s<>?#]+)*/@deot/docs-client`,
@@ -933,9 +936,40 @@ var ensureLocalClientDist = async (cwd) => {
 	if (!node_fs.existsSync(output)) throw new Error(`Local client build did not create: ${output}`);
 	return localClient.clientDist;
 };
-var rewriteLocalClient = (html, clientDist) => clientDist ? Buffer.from(html.toString("utf8").replace(CLIENT_ASSET_PATTERN, (_url, asset, suffix) => `${CLIENT_PREFIX}${asset === "/+esm" ? CLIENT_ENTRY : asset.slice(1)}${suffix}`)) : html;
+var rewriteLocalClient = (html, clientDist) => clientDist ? Buffer.from(html.toString("utf8").replace(CLIENT_ASSET_PATTERN, (_url, asset, suffix) => `${CLIENT_PREFIX}${asset === "/+esm" ? CLIENT_ENTRY : asset.slice(1)}${suffix}`).replace(UNPKG_CLIENT_ENTRY_PATTERN, `${CLIENT_PREFIX}${CLIENT_ENTRY}`)) : html;
+var ensureLocalLaunchDist = async (cwd) => {
+	const source = node_path.resolve(cwd, "packages/launch/src");
+	if (!node_fs.existsSync(source)) return void 0;
+	const dist = node_path.resolve(cwd, "packages/launch/dist");
+	const output = node_path.join(dist, "index.js");
+	const inputTime = Math.max(...[
+		source,
+		node_path.resolve(cwd, "packages/launch/package.json"),
+		node_path.resolve(cwd, "z.build.config.ts")
+	].map(getLatestModification));
+	if (getLatestModification(output) < inputTime) await _deot_dev_shared.Shell.spawn("npm", [
+		"run",
+		"build",
+		"--",
+		"--package-name",
+		"launch"
+	], { cwd });
+	if (!node_fs.existsSync(output)) throw new Error(`Local launch build did not create: ${output}`);
+	return dist;
+};
+var localLaunchEntry = [
+	"const config = window.$docs ||= {};",
+	"const custom = config.resolve?.cdn;",
+	`const pattern = new RegExp(${JSON.stringify(CLIENT_ASSET_PATTERN.source)}, 'gu');`,
+	`const unpkg = new RegExp(${JSON.stringify(UNPKG_CLIENT_ENTRY_PATTERN.source)}, 'gu');`,
+	"config.resolve = {...config.resolve, cdn(context) {",
+	"const url = custom?.(context) || context.url;",
+	`return url.replace(pattern, (_url, asset, suffix) => ${JSON.stringify(CLIENT_PREFIX)} + (asset === '/+esm' ? ${JSON.stringify(CLIENT_ENTRY)} : asset.slice(1)) + suffix).replace(unpkg, ${JSON.stringify(CLIENT_PREFIX + CLIENT_ENTRY)});`,
+	"}};",
+	`import('${LAUNCH_PREFIX}dist/index.js');`
+].join("\n");
 var createEtag = (content) => `W/"${(0, node_crypto.createHash)("sha1").update(content).digest("hex")}"`;
-var sendFile = (req, res, filename, root, clientDist) => {
+var sendFile = (req, res, filename, root, clientDist, launchDist) => {
 	if (!node_fs.existsSync(filename) || !node_fs.statSync(filename).isFile()) return false;
 	const realRoot = node_fs.realpathSync(root);
 	const realFilename = node_fs.realpathSync(filename);
@@ -947,7 +981,8 @@ var sendFile = (req, res, filename, root, clientDist) => {
 	const stat = node_fs.statSync(realFilename);
 	const extension = node_path.extname(realFilename).toLowerCase();
 	const rawContent = node_fs.readFileSync(realFilename);
-	const content = extension === ".html" ? rewriteLocalClient(rawContent, clientDist) : rawContent;
+	let content = extension === ".html" ? rewriteLocalClient(rawContent, clientDist) : rawContent;
+	if (extension === ".html" && launchDist) content = Buffer.from(content.toString("utf8").replace(LAUNCH_ASSET_PATTERN, `${LAUNCH_PREFIX}+esm`));
 	const etag = createEtag(content);
 	const lastModified = stat.mtime.toUTCString();
 	res.setHeader("Cache-Control", "no-cache");
@@ -976,6 +1011,7 @@ var sendFile = (req, res, filename, root, clientDist) => {
 var createPreviewRequestHandler = (options) => {
 	const workspace = node_path.resolve(options.workspace);
 	const clientDist = options.clientDist && node_path.resolve(options.clientDist);
+	const launchDist = options.launchDist && node_path.resolve(options.launchDist);
 	return (req, res) => {
 		try {
 			if (req.method !== "GET" && req.method !== "HEAD") {
@@ -985,6 +1021,12 @@ var createPreviewRequestHandler = (options) => {
 				return;
 			}
 			const pathname = decodeRequestPath(req.url || "/");
+			if (launchDist && pathname === `${LAUNCH_PREFIX}+esm`) {
+				res.setHeader("Content-Type", "text/javascript; charset=utf-8");
+				res.setHeader("Cache-Control", "no-cache");
+				res.end(req.method === "HEAD" ? void 0 : localLaunchEntry);
+				return;
+			}
 			const isPreviewPage = /^\/__docs\/(?:preview|raw-editor|markdown-editor)$/.test(pathname) && String(req.headers.accept || "").includes("text/html");
 			if (pathname.startsWith("/__docs/") && !isPreviewPage) {
 				res.statusCode = 404;
@@ -998,6 +1040,10 @@ var createPreviewRequestHandler = (options) => {
 				const rest = pathname.slice(19);
 				relative = rest === "+esm" ? "index.js" : rest.replace(/^dist\//u, "");
 			}
+			if (launchDist && pathname.startsWith(LAUNCH_PREFIX)) {
+				root = launchDist;
+				relative = pathname.slice(19).replace(/^dist\//u, "");
+			}
 			let filename = node_path.resolve(root, relative || "index.html");
 			if (!isInside(root, filename)) {
 				res.statusCode = 403;
@@ -1005,9 +1051,9 @@ var createPreviewRequestHandler = (options) => {
 				return;
 			}
 			if (node_fs.existsSync(filename) && node_fs.statSync(filename).isDirectory()) filename = node_path.join(filename, "index.html");
-			if (sendFile(req, res, filename, root, clientDist)) return;
+			if (sendFile(req, res, filename, root, clientDist, launchDist)) return;
 			if (String(req.headers.accept || "").includes("text/html")) {
-				if (sendFile(req, res, node_path.join(workspace, "index.html"), workspace, clientDist)) return;
+				if (sendFile(req, res, node_path.join(workspace, "index.html"), workspace, clientDist, launchDist)) return;
 			}
 			res.statusCode = 404;
 			res.end("Not Found");
@@ -1037,9 +1083,11 @@ var startPreviewServer = async (options) => {
 	const cwd = process.cwd();
 	const workspace = resolveDocsWorkspace(cwd, options.workspace);
 	const clientDist = await ensureLocalClientDist(cwd);
+	const launchDist = await ensureLocalLaunchDist(cwd);
 	const server = node_http.createServer(createPreviewRequestHandler({
 		workspace: workspace.root,
-		clientDist
+		clientDist,
+		launchDist
 	}));
 	const port = Number(options.port ?? 4173);
 	const host = String(options.host || "0.0.0.0");

package/dist/index.js

@@ -489,7 +489,7 @@ var createRuntimePlugin = (options, resolvedWorkspace) => ({
 	name: "docs-runtime",
 	transformIndexHtml: options.build || options.preview ? void 0 : {
 		order: "pre",
-		handler() {
+		handler(html = "") {
 			const workspace = (resolvedWorkspace || resolveDocsWorkspace(process.cwd(), options.workspace)).urlBase;
 			const localClientEntry = path.resolve(process.cwd(), "packages/client/src/index.ts");
 			const runtime = JSON.stringify({
@@ -497,7 +497,7 @@ var createRuntimePlugin = (options, resolvedWorkspace) => ({
 				workspace,
 				events: "/__docs/events"
 			}).replace(/</g, "\\u003c");
-			const styles = fs$1.existsSync(localClientEntry) ? [] : [
+			const styles = fs$1.existsSync(localClientEntry) || html.includes("@deot/docs-launch") ? [] : [
 				"https://cdn.jsdelivr.net/npm/@deot/docs-client/dist/index.style.css",
 				"https://cdn.jsdelivr.net/npm/@deot/docs-renderer/dist/index.style.css",
 				"https://cdn.jsdelivr.net/npm/@deot/docs-markdown/dist/index.style.css",
@@ -802,7 +802,10 @@ var plugins_default = (options = {}, resolvedWorkspace) => defineConfig({ plugin
 //#endregion
 //#region packages/dever/src/preview.ts
 var CLIENT_PREFIX = "/@deot/docs-client/";
+var LAUNCH_PREFIX = "/@deot/docs-launch/";
+var LAUNCH_ASSET_PATTERN = /https?:\/\/[^/"'\s<>]+(?:\/[^/"'\s<>?#]+)*\/@deot\/docs-launch(?:@[^/"'\s<>?#]+)?(?:\/\+esm|\/dist\/index\.js)?(?=["'\s<>?#]|$)/gu;
 var CLIENT_ENTRY = "dist/index.js";
+var UNPKG_CLIENT_ENTRY_PATTERN = /https?:\/\/esm\.unpkg\.com\/@deot\/docs-client(?:@[^/"'\x60\s<>?#]+)?(?=["'\x60\s<>?#]|$)/gu;
 var CLIENT_ASSET_PATTERN = new RegExp([
 	String.raw`(?:https?:)?//[^/"'\x60\s<>]+`,
 	String.raw`(?:/[^/"'\x60\s<>?#]+)*/@deot/docs-client`,
@@ -904,9 +907,40 @@ var ensureLocalClientDist = async (cwd) => {
 	if (!fs$1.existsSync(output)) throw new Error(`Local client build did not create: ${output}`);
 	return localClient.clientDist;
 };
-var rewriteLocalClient = (html, clientDist) => clientDist ? Buffer.from(html.toString("utf8").replace(CLIENT_ASSET_PATTERN, (_url, asset, suffix) => `${CLIENT_PREFIX}${asset === "/+esm" ? CLIENT_ENTRY : asset.slice(1)}${suffix}`)) : html;
+var rewriteLocalClient = (html, clientDist) => clientDist ? Buffer.from(html.toString("utf8").replace(CLIENT_ASSET_PATTERN, (_url, asset, suffix) => `${CLIENT_PREFIX}${asset === "/+esm" ? CLIENT_ENTRY : asset.slice(1)}${suffix}`).replace(UNPKG_CLIENT_ENTRY_PATTERN, `${CLIENT_PREFIX}${CLIENT_ENTRY}`)) : html;
+var ensureLocalLaunchDist = async (cwd) => {
+	const source = path.resolve(cwd, "packages/launch/src");
+	if (!fs$1.existsSync(source)) return void 0;
+	const dist = path.resolve(cwd, "packages/launch/dist");
+	const output = path.join(dist, "index.js");
+	const inputTime = Math.max(...[
+		source,
+		path.resolve(cwd, "packages/launch/package.json"),
+		path.resolve(cwd, "z.build.config.ts")
+	].map(getLatestModification));
+	if (getLatestModification(output) < inputTime) await Shell.spawn("npm", [
+		"run",
+		"build",
+		"--",
+		"--package-name",
+		"launch"
+	], { cwd });
+	if (!fs$1.existsSync(output)) throw new Error(`Local launch build did not create: ${output}`);
+	return dist;
+};
+var localLaunchEntry = [
+	"const config = window.$docs ||= {};",
+	"const custom = config.resolve?.cdn;",
+	`const pattern = new RegExp(${JSON.stringify(CLIENT_ASSET_PATTERN.source)}, 'gu');`,
+	`const unpkg = new RegExp(${JSON.stringify(UNPKG_CLIENT_ENTRY_PATTERN.source)}, 'gu');`,
+	"config.resolve = {...config.resolve, cdn(context) {",
+	"const url = custom?.(context) || context.url;",
+	`return url.replace(pattern, (_url, asset, suffix) => ${JSON.stringify(CLIENT_PREFIX)} + (asset === '/+esm' ? ${JSON.stringify(CLIENT_ENTRY)} : asset.slice(1)) + suffix).replace(unpkg, ${JSON.stringify(CLIENT_PREFIX + CLIENT_ENTRY)});`,
+	"}};",
+	`import('${LAUNCH_PREFIX}dist/index.js');`
+].join("\n");
 var createEtag = (content) => `W/"${createHash("sha1").update(content).digest("hex")}"`;
-var sendFile = (req, res, filename, root, clientDist) => {
+var sendFile = (req, res, filename, root, clientDist, launchDist) => {
 	if (!fs$1.existsSync(filename) || !fs$1.statSync(filename).isFile()) return false;
 	const realRoot = fs$1.realpathSync(root);
 	const realFilename = fs$1.realpathSync(filename);
@@ -918,7 +952,8 @@ var sendFile = (req, res, filename, root, clientDist) => {
 	const stat = fs$1.statSync(realFilename);
 	const extension = path.extname(realFilename).toLowerCase();
 	const rawContent = fs$1.readFileSync(realFilename);
-	const content = extension === ".html" ? rewriteLocalClient(rawContent, clientDist) : rawContent;
+	let content = extension === ".html" ? rewriteLocalClient(rawContent, clientDist) : rawContent;
+	if (extension === ".html" && launchDist) content = Buffer.from(content.toString("utf8").replace(LAUNCH_ASSET_PATTERN, `${LAUNCH_PREFIX}+esm`));
 	const etag = createEtag(content);
 	const lastModified = stat.mtime.toUTCString();
 	res.setHeader("Cache-Control", "no-cache");
@@ -947,6 +982,7 @@ var sendFile = (req, res, filename, root, clientDist) => {
 var createPreviewRequestHandler = (options) => {
 	const workspace = path.resolve(options.workspace);
 	const clientDist = options.clientDist && path.resolve(options.clientDist);
+	const launchDist = options.launchDist && path.resolve(options.launchDist);
 	return (req, res) => {
 		try {
 			if (req.method !== "GET" && req.method !== "HEAD") {
@@ -956,6 +992,12 @@ var createPreviewRequestHandler = (options) => {
 				return;
 			}
 			const pathname = decodeRequestPath(req.url || "/");
+			if (launchDist && pathname === `${LAUNCH_PREFIX}+esm`) {
+				res.setHeader("Content-Type", "text/javascript; charset=utf-8");
+				res.setHeader("Cache-Control", "no-cache");
+				res.end(req.method === "HEAD" ? void 0 : localLaunchEntry);
+				return;
+			}
 			const isPreviewPage = /^\/__docs\/(?:preview|raw-editor|markdown-editor)$/.test(pathname) && String(req.headers.accept || "").includes("text/html");
 			if (pathname.startsWith("/__docs/") && !isPreviewPage) {
 				res.statusCode = 404;
@@ -969,6 +1011,10 @@ var createPreviewRequestHandler = (options) => {
 				const rest = pathname.slice(19);
 				relative = rest === "+esm" ? "index.js" : rest.replace(/^dist\//u, "");
 			}
+			if (launchDist && pathname.startsWith(LAUNCH_PREFIX)) {
+				root = launchDist;
+				relative = pathname.slice(19).replace(/^dist\//u, "");
+			}
 			let filename = path.resolve(root, relative || "index.html");
 			if (!isInside(root, filename)) {
 				res.statusCode = 403;
@@ -976,9 +1022,9 @@ var createPreviewRequestHandler = (options) => {
 				return;
 			}
 			if (fs$1.existsSync(filename) && fs$1.statSync(filename).isDirectory()) filename = path.join(filename, "index.html");
-			if (sendFile(req, res, filename, root, clientDist)) return;
+			if (sendFile(req, res, filename, root, clientDist, launchDist)) return;
 			if (String(req.headers.accept || "").includes("text/html")) {
-				if (sendFile(req, res, path.join(workspace, "index.html"), workspace, clientDist)) return;
+				if (sendFile(req, res, path.join(workspace, "index.html"), workspace, clientDist, launchDist)) return;
 			}
 			res.statusCode = 404;
 			res.end("Not Found");
@@ -1008,9 +1054,11 @@ var startPreviewServer = async (options) => {
 	const cwd = process.cwd();
 	const workspace = resolveDocsWorkspace(cwd, options.workspace);
 	const clientDist = await ensureLocalClientDist(cwd);
+	const launchDist = await ensureLocalLaunchDist(cwd);
 	const server = http.createServer(createPreviewRequestHandler({
 		workspace: workspace.root,
-		clientDist
+		clientDist,
+		launchDist
 	}));
 	const port = Number(options.port ?? 4173);
 	const host = String(options.host || "0.0.0.0");

package/package.json

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