@deot/docs-launch 1.0.1 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @deot/docs-launch
 
-轻量浏览器启动入口：并发探测 CDN，选定唯一节点，先注入四份 CSS，再注入 Client module。
+轻量浏览器启动入口：使用 HTML 选定的 CDN，先注入完整的 Client CSS，再注入 Client module。
 
 ```html
 <div id="app"></div>
@@ -8,8 +8,8 @@
 	window.$docs = {
 		locales: { 'zh-CN': { label: '简体中文' } },
 		routes: { '/:name': { content: 'default' } },
-		// 可省略，以下是默认候选。
-		cdns: ['https://cdn.jsdelivr.net/npm/', 'https://esm.unpkg.com/'],
+		// 可省略，launch 缺省使用 jsDelivr。
+		runtime: { mode: 'production', cdn: 'https://cdn.jsdelivr.net/npm/' },
 		resolve: {
 			cdn: ({ url }) => url
 		}
@@ -18,18 +18,18 @@
 <script type="module" src="https://cdn.jsdelivr.net/npm/@deot/docs-launch/+esm"></script>
 ```
 
-省略或清空 `cdns` 时使用默认候选。探针请求同一份固定小文件 `@deot/docs-theme@1.1.4/package.json?raw`，最先完整读取成功响应的节点胜出，每个请求超时 5 秒，随后取消剩余探针。结果写入 `$docs.runtime.cdn`，同一页面重复启动复用同一任务。
+CDN 选择由 HTML 负责。本仓库的 [`index.html`](../../index.html) 并发下载 jsDelivr、ESM UNPKG 的 launch 入口，首个完整下载成功的 JavaScript 响应胜出，随后取消其余请求、将对应 npm CDN 前缀写入 `$docs.runtime.cdn`，并将下载的代码注入为 module。只执行胜出的入口，无需再次下载；全部失败或超过 15 秒时显示刷新重试提示。launch 是自包含 ESM，无需额外探针、节点缓存或 `cdns` 配置。
 
-选中节点保存在 `localStorage['@deot/docs-launch:cdn']`。有缓存且该节点仍在当前候选中时，立即使用缓存启动，同时静默探测并更新缓存，供下次页面启动使用；本次页面的节点和资源保持不变。没有可用缓存时，先探测再加载。后台探测失败时保留原缓存；存储不可用时仍可正常探测和启动。
+launch 读取 `$docs.runtime.cdn`，缺省使用 `https://cdn.jsdelivr.net/npm/`，补全 production 运行模式；同一页面重复启动复用同一任务。启动器先插入 Client stylesheet link，再插入 Client module script，不等待 CSS load 事件才请求 JS。Client 浏览器 CSS 已包含主应用使用的 Renderer、Markdown、Playground 和延迟页面样式，无需再加载三个子包的 CSS。
 
-启动器按 Client、Renderer、Markdown、Playground 的顺序插入 stylesheet link，再插入 Client module script；不等待 CSS load 事件才请求 JS。所有地址先按选中节点生成，再经过用户可选的同步 `resolve.cdn({ url })`。返回 `null`、`undefined` 或空字符串时保留原地址，钩子本身不会被启动器替换，探针不经过钩子。
+两个 CDN 都显式加载 `/@deot/docs-client/dist/bundle/index.js` 和 `/@deot/docs-client/dist/bundle/index.style.css`。Bundle 由 `--bundle-package client` 生成，普通 ES 继续供项目打包器使用。所有地址先按选中节点生成，再经过用户可选的同步 `resolve.cdn({ url })`。返回 `null`、`undefined` 或空字符串时保留原地址，钩子本身不会被启动器替换。
 
 Client 与 Playground 内置 jsDelivr / UNPKG 地址转换，继续使用选中的同一节点，再调用用户钩子。原配置与缓存保留原始地址。转换服务内部模块引用及重定向仍交给浏览器处理。
 
-没有可用缓存且全部探针失败时不启动应用；选定后的资源加载失败只报告错误，不跨 CDN 回退。每次页面启动只探测一次，不提供持续测速或网络代理。启动器自身首次下载由 HTML 的脚本地址决定。自定义候选默认使用 jsDelivr 兼容路径，特殊资源入口通过最终钩子调整。
+任一 Client 启动资源加载失败，或 CSS、JS 两份资源在 30 秒内未全部加载完成时，输出控制台错误，并在尚未挂载的 `#app` 中显示刷新重试提示。launch 不切换 CDN 或自动重载页面。
 
 包没有运行时依赖，通过 `--minify-package 'launch'` 生成单个自包含的普通压缩 ESM，体积预算为 3 KiB、gzip 后 1.5 KiB。无需 eval 或解压器。聚合包不会重导出自动启动入口。
 
-本仓库 `doc dev` 继续使用本地 Client；`doc preview` 构建并映射本地 launch 和 Client，预览适配会先调用用户钩子，再映射本地 Client URL。消费项目仍使用声明的发布地址。
+本仓库 `doc dev` 确认 Client 包名、源码入口及真实路径边界后，将 HTML 的 launch 地址改写到本地 Client 源码，交给 Vite 编译；`doc preview` 映射预先构建的本地 launch 和 Client Bundle，先执行 `npm run build`，预览适配会先调用用户钩子，再映射本地 Client URL。消费项目仍使用声明的发布地址。
 
-发布顺序：先发布支持 `runtime.cdn` / `resolve.cdn` 的 Playground 与 Client，再发布 launch，最后迁移 HTML 入口。
+发布顺序：先发布包含完整 CSS 的 Client，确认两个 CDN 均能提供新产物，再发布读取 `runtime.cdn` 的 launch，最后更新 HTML 入口、开发服务与聚合包。

package/dist/index.js

@@ -1,54 +1,30 @@
 //#region packages/launch/src/index.ts
-var e = ["https://cdn.jsdelivr.net/npm/", "https://esm.unpkg.com/"], t = Symbol.for("@deot/docs-launch"), n = "@deot/docs-launch:cdn", r = (r = window) => {
-	let i = r;
-	return i[t] ??= (async () => {
-		let t = i.$docs ||= {}, r = t.cdns?.map((e) => e.trim()).filter(Boolean), a = [...new Set((r?.length ? r : e).map((e) => `${e.replace(/\/+$/u, "")}/`))], o = (async () => {
-			let e = a.map(() => new AbortController());
-			try {
-				return await Promise.any(a.map(async (t, n) => {
-					let r = e[n], i = setTimeout(() => r.abort(), 5e3);
-					try {
-						let e = await fetch(`${t}@deot/docs-theme@1.1.4/package.json?raw`, { signal: r.signal });
-						if (!e.ok) throw Error(`${e.status} ${t}`);
-						return await e.text(), t;
-					} finally {
-						clearTimeout(i);
-					}
-				}));
-			} finally {
-				e.forEach((e) => e.abort());
-			}
-		})().then((e) => {
-			try {
-				i.localStorage.setItem(n, e);
-			} catch {}
-			return e;
-		}), s = "";
-		try {
-			s = i.localStorage.getItem(n) || "";
-		} catch {}
-		a.includes(s) ? o.catch(() => {}) : s = await o, t.runtime = {
-			...t.runtime,
-			mode: t.runtime?.mode || "production",
-			cdn: s
+var e = Symbol.for("@deot/docs-launch"), t = (t = window) => {
+	let n = t;
+	return n[e] ??= (async () => {
+		let e = n.$docs ||= {}, t = `${(e.runtime?.cdn?.trim() || "https://cdn.jsdelivr.net/npm/").replace(/\/+$/u, "")}/`;
+		e.runtime = {
+			...e.runtime,
+			mode: e.runtime?.mode || "production",
+			cdn: t
 		};
-		let c = (e) => {
-			let n = `${s}${e}`;
-			return t.resolve?.cdn?.({ url: n }) || n;
-		}, l = i.document;
-		for (let e of [
-			"client",
-			"renderer",
-			"markdown",
-			"playground"
-		]) {
-			let t = l.createElement("link");
-			t.rel = "stylesheet", t.href = c(`@deot/docs-${e}/dist/index.style.css`), t.onerror = () => console.error(`[docs-launch] Failed to load ${t.href}`), l.head.appendChild(t);
-		}
-		let u = l.createElement("script");
-		u.type = "module", u.src = c(`@deot/docs-client${new URL(s).hostname === "esm.unpkg.com" ? "" : "/+esm"}`), u.onerror = () => console.error(`[docs-launch] Failed to load ${u.src}`), l.body.appendChild(u);
+		let r = (n) => {
+			let r = `${t}${n}`;
+			return e.resolve?.cdn?.({ url: r }) || r;
+		}, i = n.document, a = i.createElement("link");
+		a.rel = "stylesheet", a.href = r("@deot/docs-client/dist/bundle/index.style.css");
+		let o = i.createElement("script");
+		o.type = "module", o.src = r("@deot/docs-client/dist/bundle/index.js");
+		let s = [a, o], c = s.length, l = !1, u = setTimeout(() => d(), 3e4), d = (e) => {
+			if (l || e?.type === "load" && --c || (l = !0, clearTimeout(u), e?.type === "load")) return;
+			console.error("[docs-launch] Failed to load", t, e);
+			let n = i.querySelector("#app:not([data-v-app])");
+			n && (n.textContent = "文档资源加载失败，请刷新重试。");
+		};
+		for (let e of s) e.addEventListener("load", d), e.addEventListener("error", d);
+		i.head.appendChild(a), i.body.appendChild(o);
 	})();
 };
-typeof window < "u" && document.querySelector("#app") && r().catch((e) => console.error("[docs-launch] Failed to launch", e));
+typeof window < "u" && document.querySelector("#app") && t().catch((e) => console.error("[docs-launch] Failed to launch", e));
 //#endregion
-export { r as launch };
+export { t as launch };

package/package.json

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

package/dist/index.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=[`https://cdn.jsdelivr.net/npm/`,`https://esm.unpkg.com/`],t=Symbol.for(`@deot/docs-launch`),n=`@deot/docs-launch:cdn`,r=(r=window)=>{let i=r;return i[t]??=(async()=>{let t=i.$docs||={},r=t.cdns?.map(e=>e.trim()).filter(Boolean),a=[...new Set((r?.length?r:e).map(e=>`${e.replace(/\/+$/u,``)}/`))],o=(async()=>{let e=a.map(()=>new AbortController);try{return await Promise.any(a.map(async(t,n)=>{let r=e[n],i=setTimeout(()=>r.abort(),5e3);try{let e=await fetch(`${t}@deot/docs-theme@1.1.4/package.json?raw`,{signal:r.signal});if(!e.ok)throw Error(`${e.status} ${t}`);return await e.text(),t}finally{clearTimeout(i)}}))}finally{e.forEach(e=>e.abort())}})().then(e=>{try{i.localStorage.setItem(n,e)}catch{}return e}),s=``;try{s=i.localStorage.getItem(n)||``}catch{}a.includes(s)?o.catch(()=>{}):s=await o,t.runtime={...t.runtime,mode:t.runtime?.mode||`production`,cdn:s};let c=e=>{let n=`${s}${e}`;return t.resolve?.cdn?.({url:n})||n},l=i.document;for(let e of[`client`,`renderer`,`markdown`,`playground`]){let t=l.createElement(`link`);t.rel=`stylesheet`,t.href=c(`@deot/docs-${e}/dist/index.style.css`),t.onerror=()=>console.error(`[docs-launch] Failed to load ${t.href}`),l.head.appendChild(t)}let u=l.createElement(`script`);u.type=`module`,u.src=c(`@deot/docs-client${new URL(s).hostname===`esm.unpkg.com`?``:`/+esm`}`),u.onerror=()=>console.error(`[docs-launch] Failed to load ${u.src}`),l.body.appendChild(u)})()};typeof window<`u`&&document.querySelector(`#app`)&&r().catch(e=>console.error(`[docs-launch] Failed to launch`,e)),exports.launch=r;