@deot/docs-playground 1.1.1 → 1.1.3

package/dist/store-D8vwi-HV.js

@@ -0,0 +1,767 @@
+import { a as DEFAULT_CDN_URL, n as createBuiltinImports, r as createBuiltinStyles, s as NEW_SFC_CODE } from "./cdn-DEvdGJu2.js";
+import { r as whenSassReady, t as bindPlaygroundScss } from "./scss-Co2it4vB.js";
+import { nextTick, onBeforeUnmount, ref, unref, watch } from "vue";
+import { File, useStore } from "@vue/repl";
+//#region packages/playground/src/core/preview-scroll.ts
+/** iframe 包装成功后挂在 `html` 上，供样式与 auto-height 识别。 */
+var PREVIEW_SCROLL_HTML_CLASS = "docs-playground-preview-scroll";
+/** Scroller 内容节点 class，auto-height 优先测量该节点。 */
+var PREVIEW_SCROLL_CONTENT_CLASS = "docs-playground-preview-scroll__content";
+/** 重评时先清掉 html class，避免 `await import` 期间仍套用 `height:100%`。 */
+var PREVIEW_SCROLL_RESET_CODE = `document.documentElement.classList.remove("${PREVIEW_SCROLL_HTML_CLASS}");`;
+/** 动态探测 `@deot/vc`；失败时为空对象，不阻断 DocsLink / 预览挂载。 */
+var PREVIEW_SCROLLER_IMPORT_CODE = "const __docsVc=await import(\"@deot/vc\").catch(()=>({}))";
+/**
+* Vue 的 `mount` 闭包的是 `createApp(root)` 时的根组件，改 `app._component` 不会生效。
+* 因此劫持 `app.mount`：等全部 useCode 注册完后，再 `createApp` 包一层 Scroller。
+* 前导分号避免接在 `app.component(...)` 后被 ASI 解析成调用返回值。
+*/
+var PREVIEW_SCROLLER_USE_CODE = [
+	";(()=>{",
+	PREVIEW_SCROLL_RESET_CODE,
+	"const __DocsScroller=__docsVc&&__docsVc.Scroller;",
+	"if(!__DocsScroller)return;",
+	"const UserApp=app._component;",
+	"app.mount=(container,...rest)=>{",
+	"const next=_createApp({",
+	"name:\"DocsPreviewRoot\",",
+	"setup(){return()=>__docsH(__DocsScroller,{",
+	"height:\"100%\",",
+	"native:false,",
+	"autoResize:true,",
+	"showBar:true,",
+	`contentClass:"${PREVIEW_SCROLL_CONTENT_CLASS}"`,
+	"},{default:()=>__docsH(UserApp)})}",
+	"});",
+	"next.config.errorHandler=app.config.errorHandler;",
+	"if(app._context&&next._context){",
+	"if(app._context.components)Object.assign(next._context.components,app._context.components);",
+	"if(app._context.directives)Object.assign(next._context.directives,app._context.directives);",
+	"Object.assign(next._context.provides,app._context.provides);",
+	"next._context.mixins.push(...app._context.mixins);",
+	"}",
+	"window.__app__=next;",
+	`document.documentElement.classList.add("${PREVIEW_SCROLL_HTML_CLASS}");`,
+	"return next.mount(container,...rest)",
+	"}",
+	"})()"
+].join("");
+var PREVIEW_SCROLLER_STYLE = [
+	`html.${PREVIEW_SCROLL_HTML_CLASS},`,
+	`html.${PREVIEW_SCROLL_HTML_CLASS} body,`,
+	`html.${PREVIEW_SCROLL_HTML_CLASS} #app{`,
+	"height:100%;min-height:100%;margin:0;overflow:hidden",
+	"}",
+	`html.${PREVIEW_SCROLL_HTML_CLASS} #app>.vc-scroller{`,
+	"height:100%;max-height:100%;box-sizing:border-box",
+	"}"
+].join("");
+var resolveSandboxContainer = (sandbox) => sandbox?.container ? unref(sandbox.container) : null;
+var resolveSandboxMessageSource = (sandbox) => {
+	const exposed = sandbox?.messageSource ? unref(sandbox.messageSource) : null;
+	if (exposed && typeof exposed.postMessage === "function") return exposed;
+	return (resolveSandboxContainer(sandbox)?.querySelector("iframe"))?.contentWindow ?? null;
+};
+/**
+* iframe 的 contentWindow 在 jsdom 里可能是 null，仍要和旧的元素校验一致。
+* 直接渲染会暴露真实的 messageSource。
+* @param sandbox
+* @param event
+*/
+var isSandboxMessage = (sandbox, event) => {
+	const explicit = sandbox?.messageSource ? unref(sandbox.messageSource) : null;
+	if (explicit && typeof explicit.postMessage === "function") return event.source === explicit;
+	const iframe = resolveSandboxContainer(sandbox)?.querySelector("iframe");
+	return !!iframe && event.source === iframe.contentWindow;
+};
+var resolveScrollContent = (iframeDocument) => {
+	if (!iframeDocument.documentElement.classList.contains("docs-playground-preview-scroll")) return null;
+	return iframeDocument.querySelector(`.${PREVIEW_SCROLL_CONTENT_CLASS}`);
+};
+var useSandboxAutoHeight = (sandboxRef) => {
+	const height = ref(24);
+	let container = null;
+	let iframe = null;
+	let containerObserver = null;
+	let contentObserver = null;
+	let scrollMountObserver = null;
+	let observedScrollNode = null;
+	let frameId = 0;
+	const cancelMeasure = () => {
+		if (!frameId) return;
+		cancelAnimationFrame(frameId);
+		frameId = 0;
+	};
+	const measureDocumentContent = (iframeWindow, iframeDocument) => {
+		const { body, documentElement } = iframeDocument;
+		const bodyStyle = iframeWindow.getComputedStyle(body);
+		const bodyMargins = (Number.parseFloat(bodyStyle.marginTop) || 0) + (Number.parseFloat(bodyStyle.marginBottom) || 0);
+		const rootTop = documentElement.getBoundingClientRect().top;
+		const bodyRect = body.getBoundingClientRect();
+		const collapsedTop = Math.max(0, bodyRect.top - rootTop);
+		let childrenBottom = 0;
+		for (const child of body.children) {
+			if (iframeWindow.getComputedStyle(child).position === "fixed") continue;
+			const rect = child.getBoundingClientRect();
+			const marginBottom = Number.parseFloat(iframeWindow.getComputedStyle(child).marginBottom) || 0;
+			childrenBottom = Math.max(childrenBottom, rect.bottom + marginBottom - rootTop);
+		}
+		const scrollHeight = Math.max(body.scrollHeight, documentElement.scrollHeight);
+		const overflowingHeight = scrollHeight > (iframe?.clientHeight || 0) + 1 ? scrollHeight : 0;
+		return Math.ceil(Math.max(body.offsetHeight + bodyMargins + collapsedTop, bodyRect.height + bodyMargins + collapsedTop, childrenBottom, overflowingHeight));
+	};
+	const measureScrollContent = (scrollContent) => {
+		const contentStyle = scrollContent.ownerDocument.defaultView?.getComputedStyle(scrollContent);
+		const margins = contentStyle ? (Number.parseFloat(contentStyle.marginTop) || 0) + (Number.parseFloat(contentStyle.marginBottom) || 0) : 0;
+		let childrenBottom = 0;
+		const rootTop = scrollContent.getBoundingClientRect().top;
+		for (const child of scrollContent.children) {
+			const rect = child.getBoundingClientRect();
+			const marginBottom = Number.parseFloat(scrollContent.ownerDocument.defaultView?.getComputedStyle(child).marginBottom || "0") || 0;
+			childrenBottom = Math.max(childrenBottom, rect.bottom + marginBottom - rootTop);
+		}
+		return Math.ceil(Math.max(scrollContent.scrollHeight + margins, scrollContent.offsetHeight + margins, childrenBottom + margins));
+	};
+	const isPendingPreviewApp = (iframeDocument) => {
+		const app = iframeDocument.getElementById("app");
+		return app ? app.childElementCount === 0 : !!iframe?.srcdoc;
+	};
+	const releaseBootstrapHeight = (target) => {
+		nextTick(() => {
+			if (iframe === target) target.style.height = "100%";
+		});
+	};
+	const measureElementChildren = (root) => {
+		const view = root.ownerDocument.defaultView || window;
+		const rootTop = root.getBoundingClientRect().top;
+		let childrenBottom = 0;
+		for (const child of root.children) {
+			if (!(child instanceof HTMLElement)) continue;
+			if (view.getComputedStyle(child).position === "fixed") continue;
+			const rect = child.getBoundingClientRect();
+			const marginBottom = Number.parseFloat(view.getComputedStyle(child).marginBottom) || 0;
+			childrenBottom = Math.max(childrenBottom, rect.bottom + marginBottom - rootTop);
+		}
+		const overflowingHeight = root.scrollHeight > root.clientHeight + 1 ? root.scrollHeight : 0;
+		return Math.ceil(Math.max(root.offsetHeight, childrenBottom, overflowingHeight));
+	};
+	const measureLocalContainer = () => {
+		if (!container) return;
+		const scrollContent = container.querySelector(`.${PREVIEW_SCROLL_CONTENT_CLASS}`);
+		const mount = container.querySelector(".docs-playground-local__mount");
+		const target = scrollContent || mount;
+		if (!target || !scrollContent && target.childElementCount === 0) return;
+		const contentHeight = scrollContent ? measureScrollContent(scrollContent) : measureElementChildren(target);
+		const nextHeight = Math.max(contentHeight, 24);
+		if (height.value !== nextHeight) height.value = nextHeight;
+	};
+	const isLocalContainer = (element) => element?.classList.contains("docs-playground-local") === true;
+	const measure = () => {
+		frameId = 0;
+		if (isLocalContainer(container)) {
+			measureLocalContainer();
+			return;
+		}
+		if (!iframe) return;
+		try {
+			const iframeWindow = iframe.contentWindow;
+			const iframeDocument = iframe.contentDocument;
+			if (!iframeWindow || !iframeDocument?.body) return;
+			const scrollContent = resolveScrollContent(iframeDocument);
+			if (!scrollContent && isPendingPreviewApp(iframeDocument)) return;
+			const contentHeight = scrollContent ? measureScrollContent(scrollContent) : measureDocumentContent(iframeWindow, iframeDocument);
+			const nextHeight = Math.max(contentHeight, 24);
+			if (height.value !== nextHeight) height.value = nextHeight;
+			releaseBootstrapHeight(iframe);
+		} catch {
+			if (height.value !== 24) height.value = 24;
+		}
+	};
+	const scheduleMeasure = () => {
+		if (frameId) return;
+		frameId = requestAnimationFrame(measure);
+	};
+	const disconnectContent = () => {
+		contentObserver?.disconnect();
+		contentObserver = null;
+		scrollMountObserver?.disconnect();
+		scrollMountObserver = null;
+		observedScrollNode = null;
+		cancelMeasure();
+	};
+	const observeContent = () => {
+		disconnectContent();
+		if (!iframe) return;
+		try {
+			const iframeWindow = iframe.contentWindow;
+			const iframeDocument = iframe.contentDocument;
+			const Observer = iframeWindow?.ResizeObserver;
+			if (!iframeWindow || !iframeDocument?.body || !Observer) {
+				scheduleMeasure();
+				return;
+			}
+			const observer = new Observer(scheduleMeasure);
+			observer.observe(iframeDocument.documentElement);
+			observer.observe(iframeDocument.body);
+			contentObserver = observer;
+			const attachScrollContent = (node) => {
+				if (!node || !contentObserver) return false;
+				if (observedScrollNode === node) return true;
+				if (observedScrollNode) contentObserver.unobserve(observedScrollNode);
+				observedScrollNode = node;
+				contentObserver.observe(node);
+				return true;
+			};
+			const syncScrollContent = () => {
+				attachScrollContent(resolveScrollContent(iframeDocument));
+				scheduleMeasure();
+			};
+			scrollMountObserver = new MutationObserver(syncScrollContent);
+			scrollMountObserver.observe(iframeDocument.documentElement, {
+				attributes: true,
+				attributeFilter: ["class"]
+			});
+			scrollMountObserver.observe(iframeDocument.body, {
+				childList: true,
+				subtree: true
+			});
+			syncScrollContent();
+		} catch {
+			if (height.value !== 24) height.value = 24;
+		}
+	};
+	const handleIframeLoad = () => observeContent();
+	const setIframe = (nextIframe) => {
+		if (iframe === nextIframe) return;
+		iframe?.removeEventListener("load", handleIframeLoad);
+		disconnectContent();
+		iframe = nextIframe;
+		if (!iframe) {
+			height.value = 24;
+			return;
+		}
+		iframe.addEventListener("load", handleIframeLoad);
+		iframe.style.height = `${Math.max(window.innerHeight, 24)}px`;
+		observeContent();
+	};
+	const observeLocal = () => {
+		disconnectContent();
+		if (!container || typeof ResizeObserver === "undefined") {
+			scheduleMeasure();
+			return;
+		}
+		const observer = new ResizeObserver(scheduleMeasure);
+		observer.observe(container);
+		const mount = container.querySelector(".docs-playground-local__mount");
+		if (mount) observer.observe(mount);
+		contentObserver = observer;
+		scrollMountObserver = new MutationObserver(() => {
+			const nextMount = container?.querySelector(".docs-playground-local__mount");
+			if (nextMount && contentObserver) {
+				contentObserver.observe(nextMount);
+				for (const child of nextMount.children) contentObserver.observe(child);
+			}
+			scheduleMeasure();
+		});
+		scrollMountObserver.observe(container, {
+			childList: true,
+			subtree: true
+		});
+		scheduleMeasure();
+	};
+	const syncIframe = () => {
+		if (isLocalContainer(container)) {
+			iframe?.removeEventListener("load", handleIframeLoad);
+			iframe = null;
+			observeLocal();
+			return;
+		}
+		setIframe(container?.querySelector("iframe") || null);
+	};
+	const setContainer = (nextContainer) => {
+		if (container === nextContainer) return;
+		containerObserver?.disconnect();
+		containerObserver = null;
+		disconnectContent();
+		iframe?.removeEventListener("load", handleIframeLoad);
+		iframe = null;
+		container = nextContainer;
+		if (!container) {
+			height.value = 24;
+			return;
+		}
+		if (isLocalContainer(container)) {
+			observeLocal();
+			return;
+		}
+		containerObserver = new MutationObserver(syncIframe);
+		containerObserver.observe(container, {
+			childList: true,
+			subtree: true
+		});
+		syncIframe();
+	};
+	watch(() => resolveSandboxContainer(sandboxRef.value), setContainer, {
+		flush: "post",
+		immediate: true
+	});
+	onBeforeUnmount(() => {
+		setContainer(null);
+		cancelMeasure();
+	});
+	return height;
+};
+//#endregion
+//#region packages/playground/src/core/runtime/error-guard.ts
+var UNKNOWN_RUNTIME_ERROR = "运行时发生未知错误";
+var MODULE_SPECIFIER_RE = /Failed to resolve module specifier|Error resolving module specifier/u;
+var forwardSandboxRuntimeError = (event) => {
+	if (!(event instanceof ErrorEvent) || event.error != null || !event.message) return;
+	event.stopImmediatePropagation();
+	if (event.message === "ResizeObserver loop limit exceeded" || event.message === "ResizeObserver loop completed with undelivered notifications.") return;
+	window.parent.postMessage({
+		action: "error",
+		value: event.message
+	}, "*");
+};
+var SANDBOX_RUNTIME_ERROR_CAPTURE_HTML = [
+	"<script>",
+	`window.addEventListener('error', ${forwardSandboxRuntimeError.toString()}, true);`,
+	"<\/script>"
+].join("\n");
+var toRuntimeErrorMessage = (value, message) => {
+	if (typeof value === "string" && value) return value;
+	if (value instanceof Error && value.message) return value.message;
+	if (value && typeof value === "object" && "message" in value) {
+		const valueMessage = value.message;
+		if (typeof valueMessage === "string" && valueMessage) return valueMessage;
+	}
+	if (typeof message === "string" && message) return message;
+	if (value !== null && value !== void 0) try {
+		return String(value);
+	} catch {
+		return UNKNOWN_RUNTIME_ERROR;
+	}
+	return UNKNOWN_RUNTIME_ERROR;
+};
+var normalizeRuntimeErrorMessage = (data) => {
+	if (!data || typeof data !== "object") return false;
+	const message = data;
+	if (message.action !== "error") return false;
+	message.value = toRuntimeErrorMessage(message.value, message.message);
+	return true;
+};
+var toErrorText = (value) => {
+	if (typeof value === "string" && value) return value;
+	if (value instanceof Error && value.message) return value.message;
+	return "";
+};
+var formatSandboxRuntimeError = (message, importMapTip) => {
+	if (!MODULE_SPECIFIER_RE.test(message)) return message;
+	return `${message.replace(/\. Relative references must.*$/u, "").replace(/\.$/u, "")}.\n${importMapTip}`;
+};
+var useSandboxRuntimeErrorGuard = (sandboxRef) => {
+	const error = ref("");
+	if (typeof window === "undefined") return error;
+	const handleMessage = (event) => {
+		const source = resolveSandboxMessageSource(sandboxRef.value);
+		if (!source || event.source !== source) return;
+		if (!normalizeRuntimeErrorMessage(event.data)) return;
+		error.value = event.data.value;
+	};
+	window.addEventListener("message", handleMessage, true);
+	onBeforeUnmount(() => window.removeEventListener("message", handleMessage, true));
+	return error;
+};
+//#endregion
+//#region packages/playground/src/import-map.ts
+/**
+* 站点级同步内存：`$docs.modules` / `$docs.styles` 与管理页 import、CSS 覆盖。
+*/
+var normalize = (value) => value.trim();
+var isSafePlaygroundHref = (href) => {
+	const next = href.trim();
+	if (!next) return false;
+	if (/^https?:\/\//iu.test(next)) return true;
+	return next.startsWith("/") && !next.startsWith("//");
+};
+var filterSafeHrefs = (value = {}) => Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[1] === "string" && isSafePlaygroundHref(entry[1])));
+var sanitizeMap = (value = {}) => filterSafeHrefs(Object.fromEntries(Object.entries(value).map(([alias, url]) => [normalize(alias), normalize(url)]).filter(([alias]) => Boolean(alias))));
+var createMapStore = () => {
+	let data = {};
+	const snapshot = () => ({ ...data });
+	const drop = (alias) => {
+		if (data[alias] === void 0) return snapshot();
+		const next = { ...data };
+		delete next[alias];
+		data = next;
+		return snapshot();
+	};
+	return {
+		get: snapshot,
+		set: (value = {}) => {
+			data = sanitizeMap(value);
+		},
+		apply: (alias, url) => {
+			const nextAlias = normalize(alias);
+			const nextUrl = normalize(url);
+			if (!nextAlias) return snapshot();
+			if (!isSafePlaygroundHref(nextUrl)) return drop(nextAlias);
+			data = {
+				...data,
+				[nextAlias]: nextUrl
+			};
+			return snapshot();
+		},
+		remove: (alias) => {
+			const nextAlias = normalize(alias);
+			return nextAlias ? drop(nextAlias) : snapshot();
+		}
+	};
+};
+var siteModules = createMapStore();
+var siteStyles = createMapStore();
+var importOverrides = createMapStore();
+var styleOverrides = createMapStore();
+/**
+* 站点默认 import。合并时夹在内置 CDN 与实例 `builtinImportMap` 之间。
+*/
+var getPlaygroundSiteModules = siteModules.get;
+var setPlaygroundSiteModules = siteModules.set;
+/**
+* 站点默认预览 CSS。合并时夹在内置样式表与管理页覆盖之间。
+*/
+var getPlaygroundSiteStyles = siteStyles.get;
+var setPlaygroundSiteStyles = siteStyles.set;
+var getPlaygroundImportMapOverrides = importOverrides.get;
+var setPlaygroundImportMapOverrides = importOverrides.set;
+var applyPlaygroundImportMapOverride = importOverrides.apply;
+var removePlaygroundImportMapOverride = importOverrides.remove;
+var getPlaygroundStyleOverrides = styleOverrides.get;
+var setPlaygroundStyleOverrides = styleOverrides.set;
+var applyPlaygroundStyleOverride = styleOverrides.apply;
+var removePlaygroundStyleOverride = styleOverrides.remove;
+var clearPlaygroundMaps = () => {
+	[
+		siteModules,
+		siteStyles,
+		importOverrides,
+		styleOverrides
+	].forEach((store) => store.set());
+};
+//#endregion
+//#region packages/playground/src/preview-service.ts
+/** Preview iframe 内的高度服务；class 会被序列化到 iframe 执行。 */
+var PlaygroundService = class {
+	target;
+	vue;
+	session;
+	/* istanbul ignore next -- class 会被序列化到没有覆盖率运行时的 iframe。 */
+	sequence = 0;
+	/* istanbul ignore next -- class 会被序列化到没有覆盖率运行时的 iframe。 */
+	disposed = false;
+	manual;
+	/* istanbul ignore next -- class 会被序列化到没有覆盖率运行时的 iframe。 */
+	requests = /* @__PURE__ */ new Set();
+	/* istanbul ignore next -- class 会被序列化到没有覆盖率运行时的 iframe。 */
+	owners = /* @__PURE__ */ new Set();
+	/**
+	* @param target 当前预览窗口。
+	* @param vue 与预览应用共用的 Vue 实例。
+	*/
+	/* istanbul ignore next -- class 会被序列化到没有覆盖率运行时的 iframe。 */
+	constructor(target, vue) {
+		this.target = target;
+		this.vue = vue;
+		this.session = `${Date.now()}-${Math.random()}`;
+		this.dispose = this.dispose.bind(this);
+		this.post("start");
+		this.target.addEventListener("pagehide", this.dispose);
+	}
+	/**
+	* 申请手动临时高度；新请求会替换上一个手动请求。
+	* @param height iframe 最小高度。
+	* @returns iframe 是否在超时前应用目标高度。
+	*/
+	enable(height) {
+		this.validateHeight(height);
+		this.manual?.release();
+		this.manual = this.createRequest(height);
+		return this.manual.ready;
+	}
+	/** 释放手动临时高度，不影响 `run` 创建的请求。 */
+	disable() {
+		this.manual?.release();
+		this.manual = void 0;
+	}
+	/**
+	* 创建等待高度后执行的事件处理函数。
+	* @param height iframe 最小高度。
+	* @param optionsOrHandler 可见状态配置，或最后一个 handler。
+	* @param lastHandler 使用配置时的最后一个 handler。
+	* @returns 保留 handler 参数和结果的异步事件处理函数。
+	*/
+	run(height, optionsOrHandler, lastHandler) {
+		this.validateHeight(height);
+		if (optionsOrHandler === void 0) return (visible) => {
+			if (visible) return this.enable(height);
+			this.disable();
+			return Promise.resolve(void 0);
+		};
+		const visible = (typeof optionsOrHandler === "function" ? {} : optionsOrHandler).visible;
+		if (visible !== void 0 && !this.vue.isRef(visible) && typeof visible !== "function") throw new TypeError("Playground visible must be a ref or getter");
+		const handler = typeof optionsOrHandler === "function" ? optionsOrHandler : lastHandler ?? (this.vue.isRef(visible) ? () => {
+			visible.value = true;
+		} : void 0);
+		if (typeof handler !== "function") throw new TypeError("Playground run requires a handler");
+		let ownerDisposed = false;
+		let current;
+		let pending;
+		const disposeOwner = () => {
+			ownerDisposed = true;
+			current?.release();
+			this.owners.delete(disposeOwner);
+		};
+		this.owners.add(disposeOwner);
+		if (this.vue.getCurrentScope()) this.vue.onScopeDispose(disposeOwner);
+		return (...args) => {
+			if (this.disposed || ownerDisposed) return Promise.resolve(void 0);
+			if (pending) return pending;
+			const request = current = this.createRequest(height);
+			let executionFinished = false;
+			const unlock = () => {
+				if (executionFinished && request.released && current === request) {
+					pending = void 0;
+					current = void 0;
+				}
+			};
+			request.closed.then(unlock);
+			const execution = (async () => {
+				try {
+					if (!await request.ready || ownerDisposed || this.disposed) return void 0;
+					if (visible) request.watch(visible);
+					const result = await handler(...args);
+					if (!visible || !this.vue.toValue(visible)) request.release();
+					return result;
+				} catch (error) {
+					request.release();
+					throw error;
+				} finally {
+					executionFinished = true;
+					unlock();
+				}
+			})();
+			pending = execution;
+			return execution;
+		};
+	}
+	/** 释放当前预览应用持有的全部高度和监听。 */
+	/* istanbul ignore next -- 注入测试会从序列化后的 iframe class 调用该方法。 */
+	dispose() {
+		if (this.disposed) return;
+		this.disposed = true;
+		for (const disposeOwner of this.owners) disposeOwner();
+		for (const request of this.requests) request.release();
+		this.post("stop");
+		this.target.removeEventListener("pagehide", this.dispose);
+		if (this.target.$docsPlayground === this) delete this.target.$docsPlayground;
+	}
+	/** @param height iframe 最小高度。 */
+	validateHeight(height) {
+		if (!Number.isFinite(height) || height <= 0) throw new TypeError("Playground height must be a positive finite number");
+	}
+	/**
+	* @param operation 请求操作。
+	* @param id 请求标识。
+	* @param height iframe 最小高度。
+	*/
+	/* istanbul ignore next -- 构造和销毁时会从序列化后的 iframe class 调用该方法。 */
+	post(operation, id = 0, height = 0) {
+		this.target.parent.postMessage({
+			action: "docs:height",
+			session: this.session,
+			operation,
+			id,
+			height
+		}, "*");
+	}
+	/**
+	* @param height iframe 最小高度。
+	* @returns 内部等待与释放句柄。
+	*/
+	createRequest(height) {
+		this.validateHeight(height);
+		const id = ++this.sequence;
+		let released = false;
+		let settled = false;
+		let frame = 0;
+		let timer = 0;
+		let stopWatch;
+		let resolveReady;
+		let resolveClosed;
+		const ready = new Promise((resolve) => {
+			resolveReady = resolve;
+		});
+		const closed = new Promise((resolve) => {
+			resolveClosed = resolve;
+		});
+		const stopWaiting = () => {
+			this.target.cancelAnimationFrame(frame);
+			if (timer) {
+				this.target.clearTimeout(timer);
+				timer = 0;
+			}
+			this.target.removeEventListener("message", onMessage);
+		};
+		const release = () => {
+			if (released) return;
+			released = true;
+			stopWaiting();
+			stopWatch?.();
+			resolveReady(false);
+			resolveClosed();
+			this.requests.delete(request);
+			this.post("release", id);
+		};
+		const check = () => {
+			if (released) return;
+			if (this.target.innerHeight >= height) {
+				settled = true;
+				stopWaiting();
+				resolveReady(true);
+			} else frame = this.target.requestAnimationFrame(check);
+		};
+		const onMessage = (event) => {
+			const data = event.data;
+			if (event.source !== this.target.parent || data?.action !== "docs:height:applied" || data.session !== this.session || data.id !== id || settled) return;
+			if (!data.accepted) release();
+			else check();
+		};
+		const request = {
+			ready,
+			closed,
+			get released() {
+				return released;
+			},
+			release,
+			watch: (visible) => {
+				stopWatch = this.vue.watch(() => this.vue.toValue(visible), (value) => {
+					if (!value) release();
+				}, { flush: "sync" });
+			}
+		};
+		this.requests.add(request);
+		if (this.disposed) release();
+		else {
+			this.target.addEventListener("message", onMessage);
+			timer = this.target.setTimeout(() => {
+				timer = 0;
+				release();
+			}, 2e3);
+			this.post("enable", id, height);
+		}
+		return request;
+	}
+};
+var PREVIEW_SERVICE_IMPORT_CODE = "import * as __docsPreviewVue from \"vue\"";
+var PREVIEW_SERVICE_USE_CODE = [
+	`;const __docsPlayground=new (${PlaygroundService.toString()})(window,__docsPreviewVue);`,
+	"app.provide(\"docs:playground\",__docsPlayground);",
+	"window.$docsPlayground=__docsPlayground;",
+	"app.mixin({beforeUnmount(){if(this===this.$root)__docsPlayground.dispose()}});"
+].join("");
+//#endregion
+//#region packages/playground/src/core/store.ts
+var DOCS_LINK_IMPORT_CODE = "import { h as __docsH } from \"vue\"";
+var DOCS_LINK_USE_CODE = [
+	PREVIEW_SCROLL_RESET_CODE,
+	"app.component(\"DocsLink\",{",
+	"props:{to:{type:String,default:\"\"}},",
+	"setup(props,{slots}){return()=>__docsH(\"a\",{",
+	"href:props.to,",
+	"style:{color:\"inherit\",textDecoration:\"none\"},",
+	"onClick(event){event.preventDefault();window.parent.postMessage({action:\"docs:navigate\",to:props.to},\"*\")}",
+	"},slots.default?.())}",
+	"})"
+].join("");
+var escapeHtmlAttr = (value) => value.replace(/&/gu, "&amp;").replace(/"/gu, "&quot;").replace(/'/gu, "&#39;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;");
+/**
+* runtime 画布色。`previewInset` 露出的 padding、iframe chrome 和 sandbox
+* `html`/`body` 必须共用这一变量，暗色下 `--docs-background-color` 与
+* `--vc-background-color-light` 不同，否则会出现色带割裂。
+*/
+var PLAYGROUND_RUNTIME_CANVAS_BACKGROUND = "var(--vc-background-color-light, var(--docs-background-color, #fff))";
+var createRuntimePreviewOptions = (cdnURL = DEFAULT_CDN_URL, options = {}) => {
+	const previewScroller = options.previewScroller === true;
+	const hrefs = Object.values({
+		...createBuiltinStyles(cdnURL),
+		...getPlaygroundSiteStyles(),
+		...getPlaygroundStyleOverrides()
+	});
+	const styleBlocks = [
+		`html,body{height:auto;min-height:0;background:${PLAYGROUND_RUNTIME_CANVAS_BACKGROUND}}`,
+		"body{color:var(--vc-foreground-color,#080f20)}",
+		...previewScroller ? [PREVIEW_SCROLLER_STYLE] : []
+	];
+	return {
+		showRuntimeError: false,
+		showRuntimeWarning: false,
+		headHTML: [
+			SANDBOX_RUNTIME_ERROR_CAPTURE_HTML,
+			"<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">",
+			...hrefs.map((href) => `<link rel="stylesheet" href="${escapeHtmlAttr(href)}">`),
+			"<style>",
+			...styleBlocks,
+			"</style>"
+		].join("\n"),
+		customCode: {
+			importCode: `${DOCS_LINK_IMPORT_CODE}\n${PREVIEW_SERVICE_IMPORT_CODE}`,
+			useCode: `${DOCS_LINK_USE_CODE}\n${PREVIEW_SERVICE_USE_CODE}`
+		}
+	};
+};
+var toReplFilename = (filename) => filename.startsWith("src/") ? filename : `src/${filename}`;
+var createReplFile = (filename, code) => {
+	const replFilename = toReplFilename(filename);
+	return new File(replFilename, code);
+};
+/**
+* 默认 CDN → 站点 modules → 实例 builtinImportMap → 管理页覆盖。
+* iframe import map 与直接渲染加载的是同一份地址表。
+* @param cdnURL
+* @param builtinImportMap
+*/
+var createRuntimeImports = (cdnURL = DEFAULT_CDN_URL, builtinImportMap) => ({
+	...createBuiltinImports(cdnURL),
+	...getPlaygroundSiteModules(),
+	...filterSafeHrefs(builtinImportMap?.imports),
+	...getPlaygroundImportMapOverrides()
+});
+var createRuntimeStore = (files, entry, options) => {
+	const { cdnURL, builtinImportMap, ...storeOptions } = options;
+	const replFiles = ref(Object.fromEntries(Object.entries(files).map(([filename, code]) => {
+		const file = createReplFile(filename, code);
+		return [file.filename, file];
+	})));
+	const mainFile = ref(toReplFilename(entry));
+	const activeFilename = ref(toReplFilename(entry));
+	const store = useStore({
+		...storeOptions,
+		files: replFiles,
+		mainFile,
+		activeFilename,
+		builtinImportMap: ref({
+			...builtinImportMap,
+			imports: createRuntimeImports(cdnURL, builtinImportMap)
+		}),
+		template: ref({
+			welcomeSFC: files[entry],
+			newSFC: NEW_SFC_CODE
+		})
+	});
+	bindPlaygroundScss(store);
+	whenSassReady(files, () => store.init());
+	return store;
+};
+//#endregion
+export { PREVIEW_SCROLLER_USE_CODE as A, toErrorText as C, resolveSandboxMessageSource as D, resolveSandboxContainer as E, PREVIEW_SCROLL_HTML_CLASS as M, PREVIEW_SCROLL_RESET_CODE as N, useSandboxAutoHeight as O, formatSandboxRuntimeError as S, isSandboxMessage as T, removePlaygroundStyleOverride as _, createRuntimeStore as a, setPlaygroundSiteStyles as b, applyPlaygroundImportMapOverride as c, getPlaygroundImportMapOverrides as d, getPlaygroundSiteModules as f, removePlaygroundImportMapOverride as g, isSafePlaygroundHref as h, createRuntimePreviewOptions as i, PREVIEW_SCROLL_CONTENT_CLASS as j, PREVIEW_SCROLLER_IMPORT_CODE as k, applyPlaygroundStyleOverride as l, getPlaygroundStyleOverrides as m, createReplFile as n, toReplFilename as o, getPlaygroundSiteStyles as p, createRuntimeImports as r, PlaygroundService as s, PLAYGROUND_RUNTIME_CANVAS_BACKGROUND as t, clearPlaygroundMaps as u, setPlaygroundImportMapOverrides as v, useSandboxRuntimeErrorGuard as w, setPlaygroundStyleOverrides as x, setPlaygroundSiteModules as y };