@deot/docs-playground 1.0.10 → 1.1.1

package/dist/index.js

@@ -116,7 +116,7 @@ var PLAYGROUND_ICONS = {
 //#endregion
 //#region packages/playground/src/icon/icon.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$7 = ["fill", "stroke"];
-var _hoisted_2$6 = ["d"];
+var _hoisted_2$7 = ["d"];
 //#endregion
 //#region packages/playground/src/icon/icon.vue
 var icon_default = /* @__PURE__ */ defineComponent({
@@ -147,16 +147,16 @@ var icon_default = /* @__PURE__ */ defineComponent({
 				"stroke-linecap": "round",
 				"stroke-linejoin": "round",
 				"aria-hidden": "true"
-			}, [createElementVNode("path", { d: icon.value.path }, null, 8, _hoisted_2$6)], 12, _hoisted_1$7);
+			}, [createElementVNode("path", { d: icon.value.path }, null, 8, _hoisted_2$7)], 12, _hoisted_1$7);
 		};
 	}
 });
 //#endregion
 //#region packages/playground/src/core/code-preview/github.css?inline
-var github_default = "pre code.hljs{display:block;padding:1em;overflow-x:auto}code.hljs{padding:3px 5px}.hljs{color:#24292e;background:#fff}.hljs-doctag,.hljs-keyword,.hljs-meta .hljs-keyword,.hljs-template-tag,.hljs-template-variable,.hljs-type,.hljs-variable.language_{color:#d73a49}.hljs-title,.hljs-title.class_,.hljs-title.class_.inherited__,.hljs-title.function_{color:#6f42c1}.hljs-attr,.hljs-attribute,.hljs-literal,.hljs-meta,.hljs-number,.hljs-operator,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-id,.hljs-variable{color:#005cc5}.hljs-meta .hljs-string,.hljs-regexp,.hljs-string{color:#032f62}.hljs-built_in,.hljs-symbol{color:#e36209}.hljs-code,.hljs-comment,.hljs-formula{color:#6a737d}.hljs-name,.hljs-quote,.hljs-selector-pseudo,.hljs-selector-tag{color:#22863a}.hljs-subst{color:#24292e}.hljs-section{font-weight:700;color:#005cc5}.hljs-bullet{color:#735c0f}.hljs-emphasis{font-style:italic;color:#24292e}.hljs-strong{font-weight:700;color:#24292e}.hljs-addition{color:#22863a;background-color:#f0fff4}.hljs-deletion{color:#b31d28;background-color:#ffeef0}[data-doc-theme=dark] .hljs,[data-vc-theme=dark] .hljs{color:#c9d1d9;background:#0d1117}[data-doc-theme=dark] .hljs-doctag,[data-doc-theme=dark] .hljs-keyword,[data-doc-theme=dark] .hljs-meta .hljs-keyword,[data-doc-theme=dark] .hljs-template-tag,[data-doc-theme=dark] .hljs-template-variable,[data-doc-theme=dark] .hljs-type,[data-doc-theme=dark] .hljs-variable.language_,[data-vc-theme=dark] .hljs-doctag,[data-vc-theme=dark] .hljs-keyword,[data-vc-theme=dark] .hljs-meta .hljs-keyword,[data-vc-theme=dark] .hljs-template-tag,[data-vc-theme=dark] .hljs-template-variable,[data-vc-theme=dark] .hljs-type,[data-vc-theme=dark] .hljs-variable.language_{color:#ff7b72}[data-doc-theme=dark] .hljs-title,[data-doc-theme=dark] .hljs-title.class_,[data-doc-theme=dark] .hljs-title.function_,[data-vc-theme=dark] .hljs-title,[data-vc-theme=dark] .hljs-title.class_,[data-vc-theme=dark] .hljs-title.function_{color:#d2a8ff}[data-doc-theme=dark] .hljs-attr,[data-doc-theme=dark] .hljs-literal,[data-doc-theme=dark] .hljs-number,[data-doc-theme=dark] .hljs-variable,[data-vc-theme=dark] .hljs-attr,[data-vc-theme=dark] .hljs-literal,[data-vc-theme=dark] .hljs-number,[data-vc-theme=dark] .hljs-variable{color:#79c0ff}[data-doc-theme=dark] .hljs-regexp,[data-doc-theme=dark] .hljs-string,[data-vc-theme=dark] .hljs-regexp,[data-vc-theme=dark] .hljs-string{color:#a5d6ff}[data-doc-theme=dark] .hljs-code,[data-doc-theme=dark] .hljs-comment,[data-vc-theme=dark] .hljs-code,[data-vc-theme=dark] .hljs-comment{color:#8b949e}[data-doc-theme=dark] .hljs-name,[data-doc-theme=dark] .hljs-selector-tag,[data-vc-theme=dark] .hljs-name,[data-vc-theme=dark] .hljs-selector-tag{color:#7ee787}";
+var github_default = "pre code.hljs{display:block;padding:1em}code.hljs{padding:3px 5px}.hljs{color:#24292e;background:#fff}.hljs-doctag,.hljs-keyword,.hljs-meta .hljs-keyword,.hljs-template-tag,.hljs-template-variable,.hljs-type,.hljs-variable.language_{color:#d73a49}.hljs-title,.hljs-title.class_,.hljs-title.class_.inherited__,.hljs-title.function_{color:#6f42c1}.hljs-attr,.hljs-attribute,.hljs-literal,.hljs-meta,.hljs-number,.hljs-operator,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-id,.hljs-variable{color:#005cc5}.hljs-meta .hljs-string,.hljs-regexp,.hljs-string{color:#032f62}.hljs-built_in,.hljs-symbol{color:#e36209}.hljs-code,.hljs-comment,.hljs-formula{color:#6a737d}.hljs-name,.hljs-quote,.hljs-selector-pseudo,.hljs-selector-tag{color:#22863a}.hljs-subst{color:#24292e}.hljs-section{font-weight:700;color:#005cc5}.hljs-bullet{color:#735c0f}.hljs-emphasis{font-style:italic;color:#24292e}.hljs-strong{font-weight:700;color:#24292e}.hljs-addition{color:#22863a;background-color:#f0fff4}.hljs-deletion{color:#b31d28;background-color:#ffeef0}[data-doc-theme=dark] .hljs,[data-vc-theme=dark] .hljs{color:#c9d1d9;background:#0d1117}[data-doc-theme=dark] .hljs-doctag,[data-doc-theme=dark] .hljs-keyword,[data-doc-theme=dark] .hljs-meta .hljs-keyword,[data-doc-theme=dark] .hljs-template-tag,[data-doc-theme=dark] .hljs-template-variable,[data-doc-theme=dark] .hljs-type,[data-doc-theme=dark] .hljs-variable.language_,[data-vc-theme=dark] .hljs-doctag,[data-vc-theme=dark] .hljs-keyword,[data-vc-theme=dark] .hljs-meta .hljs-keyword,[data-vc-theme=dark] .hljs-template-tag,[data-vc-theme=dark] .hljs-template-variable,[data-vc-theme=dark] .hljs-type,[data-vc-theme=dark] .hljs-variable.language_{color:#ff7b72}[data-doc-theme=dark] .hljs-title,[data-doc-theme=dark] .hljs-title.class_,[data-doc-theme=dark] .hljs-title.function_,[data-vc-theme=dark] .hljs-title,[data-vc-theme=dark] .hljs-title.class_,[data-vc-theme=dark] .hljs-title.function_{color:#d2a8ff}[data-doc-theme=dark] .hljs-attr,[data-doc-theme=dark] .hljs-literal,[data-doc-theme=dark] .hljs-number,[data-doc-theme=dark] .hljs-variable,[data-vc-theme=dark] .hljs-attr,[data-vc-theme=dark] .hljs-literal,[data-vc-theme=dark] .hljs-number,[data-vc-theme=dark] .hljs-variable{color:#79c0ff}[data-doc-theme=dark] .hljs-regexp,[data-doc-theme=dark] .hljs-string,[data-vc-theme=dark] .hljs-regexp,[data-vc-theme=dark] .hljs-string{color:#a5d6ff}[data-doc-theme=dark] .hljs-code,[data-doc-theme=dark] .hljs-comment,[data-vc-theme=dark] .hljs-code,[data-vc-theme=dark] .hljs-comment{color:#8b949e}[data-doc-theme=dark] .hljs-name,[data-doc-theme=dark] .hljs-selector-tag,[data-vc-theme=dark] .hljs-name,[data-vc-theme=dark] .hljs-selector-tag{color:#7ee787}";
 //#endregion
 //#region packages/playground/src/core/code-preview/code-preview.scss?inline
-var code_preview_default$1 = ".docs-code-preview{position:relative;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;min-height:0;overflow:hidden;background:var(--docs-background-color-soft,var(--vc-background-color,#f7f8fa));border-radius:8px}.docs-code-preview__language{z-index:1;min-width:28px;padding:0 8px;font-size:12px;line-height:18px;white-space:nowrap;-webkit-box-sizing:border-box;box-sizing:border-box;-webkit-transition:opacity .15s ease;transition:opacity .15s ease}.docs-code-preview__copy,.docs-code-preview__language{position:absolute;top:6px;right:12px;display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;height:28px;color:var(--docs-foreground-color-mute,var(--vc-color-dark-extralight,#71717a));-webkit-box-pack:center;-webkit-justify-content:center;-ms-flex-pack:center;justify-content:center;-webkit-box-align:center;-webkit-align-items:center;-ms-flex-align:center;align-items:center}.docs-code-preview__copy{z-index:2;width:28px;padding:0;pointer-events:none;cursor:pointer;background:var(--docs-background-color-soft,var(--vc-background-color,#f7f8fa));border:1px solid var(--docs-border-color,var(--vc-color-light-deeper,#d4d4d8));border-radius:8px;opacity:0;-webkit-transition:opacity .15s ease,background-color .15s ease;transition:opacity .15s ease,background-color .15s ease}.docs-code-preview__copy:hover{background:var(--docs-background-color,var(--vc-background-color-light,#fff))}.docs-code-preview__copy:focus-visible{pointer-events:auto;opacity:1}.docs-code-preview:has(.docs-code-preview__copy:focus-visible) .docs-code-preview__language,.docs-code-preview:hover .docs-code-preview__language{opacity:0}.docs-code-preview:has(.docs-code-preview__copy:focus-visible) .docs-code-preview__copy,.docs-code-preview:hover .docs-code-preview__copy{pointer-events:auto;opacity:1}.docs-code-preview__code{width:100%;min-height:0;margin:0;overflow:auto;-webkit-box-flex:1;-webkit-flex:1 1 auto;-ms-flex:1 1 auto;flex:1 1 auto}.docs-code-preview__code,.docs-code-preview__code code.hljs{background:var(--docs-background-color-soft,var(--vc-background-color,#f7f8fa))}.docs-code-preview__code code.hljs{min-height:100%;padding:12px 96px 12px 24px;-webkit-box-sizing:border-box;box-sizing:border-box}";
+var code_preview_default$1 = ".docs-code-preview{position:relative;display:-webkit-box;display:-webkit-flex;display:-ms-flexbox;display:flex;min-height:0;overflow:hidden;background:var(--docs-background-color-soft,var(--vc-background-color,#f7f8fa));border-radius:8px}.docs-code-preview__language{z-index:1;min-width:28px;padding:0 8px;font-size:12px;line-height:18px;white-space:nowrap;-webkit-box-sizing:border-box;box-sizing:border-box;-webkit-transition:opacity .15s ease;transition:opacity .15s ease}.docs-code-preview__copy,.docs-code-preview__language{position:absolute;top:6px;right:12px;display:-webkit-inline-box;display:-webkit-inline-flex;display:-ms-inline-flexbox;display:inline-flex;height:28px;color:var(--docs-foreground-color-mute,var(--vc-color-dark-extralight,#71717a));-webkit-box-pack:center;-webkit-justify-content:center;-ms-flex-pack:center;justify-content:center;-webkit-box-align:center;-webkit-align-items:center;-ms-flex-align:center;align-items:center}.docs-code-preview__copy{z-index:2;width:28px;padding:0;pointer-events:none;cursor:pointer;background:var(--docs-background-color-soft,var(--vc-background-color,#f7f8fa));border:1px solid var(--docs-border-color,var(--vc-color-light-deeper,#d4d4d8));border-radius:8px;opacity:0;-webkit-transition:opacity .15s ease,background-color .15s ease;transition:opacity .15s ease,background-color .15s ease}.docs-code-preview__copy:hover{background:var(--docs-background-color,var(--vc-background-color-light,#fff))}.docs-code-preview__copy:focus-visible{pointer-events:auto;opacity:1}.docs-code-preview:has(.docs-code-preview__copy:focus-visible) .docs-code-preview__language,.docs-code-preview:hover .docs-code-preview__language{opacity:0}.docs-code-preview:has(.docs-code-preview__copy:focus-visible) .docs-code-preview__copy,.docs-code-preview:hover .docs-code-preview__copy{pointer-events:auto;opacity:1}.docs-code-preview__scroller{width:100%;height:100%;min-width:0;min-height:0;-webkit-box-flex:1;-webkit-flex:1 1 auto;-ms-flex:1 1 auto;flex:1 1 auto}.docs-code-preview__code{width:-webkit-max-content;width:-moz-max-content;width:max-content;margin:0}.docs-code-preview__code,.docs-code-preview__code code.hljs{min-width:100%;min-height:100%;overflow:visible;background:var(--docs-background-color-soft,var(--vc-background-color,#f7f8fa))}.docs-code-preview__code code.hljs{display:block;padding:12px 96px 12px 24px;-webkit-box-sizing:border-box;box-sizing:border-box}";
 //#endregion
 //#region packages/playground/src/core/code-preview/style.ts
 var CODE_PREVIEW_STYLE_ID = "docs-code-preview-style";
@@ -174,9 +174,9 @@ var ensureCodePreviewStyle = () => {
 //#endregion
 //#region packages/playground/src/core/code-preview/code-preview.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$6 = { class: "docs-code-preview" };
-var _hoisted_2$5 = ["title"];
-var _hoisted_3$5 = { class: "docs-code-preview__code" };
-var _hoisted_4$5 = ["innerHTML"];
+var _hoisted_2$6 = ["title"];
+var _hoisted_3$6 = { class: "docs-code-preview__code" };
+var _hoisted_4$6 = ["innerHTML"];
 //#endregion
 //#region packages/playground/src/core/code-preview/code-preview.vue
 var code_preview_default = /* @__PURE__ */ defineComponent({
@@ -212,7 +212,7 @@ var code_preview_default = /* @__PURE__ */ defineComponent({
 					key: 0,
 					class: "docs-code-preview__language",
 					title: languageLabel.value
-				}, toDisplayString(languageLabel.value), 9, _hoisted_2$5)) : createCommentVNode("v-if", true),
+				}, toDisplayString(languageLabel.value), 9, _hoisted_2$6)) : createCommentVNode("v-if", true),
 				createVNode(unref(Clipboard), {
 					class: "docs-code-preview__copy",
 					value: __props.code,
@@ -228,54 +228,32 @@ var code_preview_default = /* @__PURE__ */ defineComponent({
 					"title",
 					"aria-label"
 				]),
-				createCommentVNode(" eslint-disable-next-line vue/no-v-html "),
-				createElementVNode("pre", _hoisted_3$5, [createElementVNode("code", {
-					class: "hljs",
-					innerHTML: highlightedCode.value
-				}, null, 8, _hoisted_4$5)])
+				createVNode(unref(Scroller), {
+					class: "docs-code-preview__scroller",
+					"auto-resize": true,
+					native: false,
+					"show-bar": true,
+					height: "100%"
+				}, {
+					default: withCtx(() => [createCommentVNode(" eslint-disable-next-line vue/no-v-html "), createElementVNode("pre", _hoisted_3$6, [createElementVNode("code", {
+						class: "hljs",
+						innerHTML: highlightedCode.value
+					}, null, 8, _hoisted_4$6)])]),
+					_: 1
+				})
 			]);
 		};
 	}
 });
 //#endregion
-//#region packages/playground/src/utils.ts
-/**
-* 比较两组 playground 文件是否完全一致。
-* @param left 左侧文件表。
-* @param right 右侧文件表。
-* @returns 键集合与各文件内容是否都相同。
-*/
-var filesEqual = (left, right) => {
-	const leftKeys = Object.keys(left);
-	const rightKeys = Object.keys(right);
-	return leftKeys.length === rightKeys.length && leftKeys.every((key) => left[key] === right[key]);
-};
-/**
-* 视图切换条使用的文案键。
-* @param view 当前预览视图。
-* @returns locale 消息键。
-*/
-var playgroundViewMessage = (view) => view === "runtime" ? "playground.runtime.preview" : "playground.runtime.files";
-//#endregion
 //#region packages/playground/src/core/files-preview/files-preview.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$5 = { class: "docs-playground-files" };
-var _hoisted_2$4 = { class: "docs-playground-files__toolbar" };
-var _hoisted_3$4 = ["data-filename", "onClick"];
-var _hoisted_4$4 = {
+var _hoisted_2$5 = { class: "docs-playground-files__tabs-row" };
+var _hoisted_3$5 = ["data-filename", "onClick"];
+var _hoisted_4$5 = {
 	key: 0,
 	class: "docs-playground-files__entry"
 };
-var _hoisted_5$4 = { class: "docs-playground-files__actions" };
-var _hoisted_6$3 = {
-	key: 0,
-	class: "docs-playground__views docs-playground__views--files"
-};
-var _hoisted_7$2 = [
-	"title",
-	"aria-label",
-	"aria-pressed",
-	"onClick"
-];
 //#endregion
 //#region packages/playground/src/core/files-preview/files-preview.vue
 var files_preview_default = /* @__PURE__ */ defineComponent({
@@ -287,28 +265,26 @@ var files_preview_default = /* @__PURE__ */ defineComponent({
 		activeView: {},
 		activeFilename: {}
 	},
-	emits: ["active-change", "view-change"],
+	emits: ["active-change"],
 	setup(__props, { emit: __emit }) {
 		const props = __props;
 		const { t } = useLocale();
-		const getViewText = (view) => t(playgroundViewMessage(view));
 		const emit = __emit;
 		const filenames = computed(() => Object.keys(props.files));
 		const activeCode = computed(() => props.files[props.activeFilename] || "");
 		const handleActive = (filename) => {
 			if (filename !== props.activeFilename) emit("active-change", filename);
 		};
-		const handleView = (view) => emit("view-change", view);
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("div", _hoisted_1$5, [createElementVNode("div", _hoisted_2$4, [createVNode(unref(Scroller), {
+			return openBlock(), createElementBlock("div", _hoisted_1$5, [createElementVNode("div", _hoisted_2$5, [createVNode(unref(Scroller), {
 				class: "docs-playground-files__scroller",
 				"auto-resize": true,
 				native: false,
 				"show-bar": true,
-				height: "44",
+				height: "40",
 				"content-class": "docs-playground-files__tabs",
-				"content-style": "height: 44px; overflow: hidden;",
-				"wrapper-style": "height: 44px; overflow-x: auto; overflow-y: hidden;"
+				"content-style": "height: 40px; overflow: hidden;",
+				"wrapper-style": "height: 40px; overflow-x: auto; overflow-y: hidden;"
 			}, {
 				default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(filenames.value, (filename) => {
 					return openBlock(), createElementBlock("button", {
@@ -317,20 +293,10 @@ var files_preview_default = /* @__PURE__ */ defineComponent({
 						class: normalizeClass(["docs-playground-files__tab", { "is-active": filename === __props.activeFilename }]),
 						"data-filename": filename,
 						onClick: ($event) => handleActive(filename)
-					}, [createElementVNode("span", null, toDisplayString(filename), 1), filename === __props.entry ? (openBlock(), createElementBlock("small", _hoisted_4$4, toDisplayString(unref(t)("playground.files.entry")), 1)) : createCommentVNode("v-if", true)], 10, _hoisted_3$4);
+					}, [createElementVNode("span", null, toDisplayString(filename), 1), filename === __props.entry ? (openBlock(), createElementBlock("small", _hoisted_4$5, toDisplayString(unref(t)("playground.files.entry")), 1)) : createCommentVNode("v-if", true)], 10, _hoisted_3$5);
 				}), 128))]),
 				_: 1
-			}), createElementVNode("div", _hoisted_5$4, [__props.views.length > 1 ? (openBlock(), createElementBlock("div", _hoisted_6$3, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.views, (item) => {
-				return openBlock(), createElementBlock("button", {
-					key: item,
-					type: "button",
-					class: normalizeClass(["docs-playground__view", { "is-active": item === __props.activeView }]),
-					title: getViewText(item),
-					"aria-label": getViewText(item),
-					"aria-pressed": item === __props.activeView,
-					onClick: ($event) => handleView(item)
-				}, [createVNode(unref(icon_default), { name: item }, null, 8, ["name"])], 10, _hoisted_7$2);
-			}), 128))])) : createCommentVNode("v-if", true)])]), createVNode(unref(code_preview_default), {
+			})]), createVNode(unref(code_preview_default), {
 				class: "docs-playground-files__body",
 				code: activeCode.value,
 				filename: __props.activeFilename,
@@ -462,21 +428,21 @@ var Drag = class {
 //#endregion
 //#region packages/playground/src/editor/editor.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$4 = { class: "docs-playground-editor" };
-var _hoisted_2$3 = ["title"];
-var _hoisted_3$3 = { class: "docs-playground-editor__files" };
-var _hoisted_4$3 = [
+var _hoisted_2$4 = ["title"];
+var _hoisted_3$4 = { class: "docs-playground-editor__files" };
+var _hoisted_4$4 = [
 	"data-filename",
 	"onClick",
 	"onDblclick"
 ];
-var _hoisted_5$3 = ["onKeydown"];
-var _hoisted_6$2 = ["title"];
-var _hoisted_7$1 = ["title", "aria-label"];
-var _hoisted_8$1 = ["title", "aria-label"];
-var _hoisted_9 = { class: "docs-playground-editor__actions" };
-var _hoisted_10 = ["title"];
-var _hoisted_11 = ["title", "disabled"];
-var _hoisted_12 = {
+var _hoisted_5$4 = ["onKeydown"];
+var _hoisted_6$3 = ["title"];
+var _hoisted_7$3 = ["title", "aria-label"];
+var _hoisted_8$2 = ["title", "aria-label"];
+var _hoisted_9$2 = { class: "docs-playground-editor__actions" };
+var _hoisted_10$1 = ["title"];
+var _hoisted_11$1 = ["title", "disabled"];
+var _hoisted_12$1 = {
 	key: 0,
 	class: "docs-playground-editor__error"
 };
@@ -728,8 +694,8 @@ var Editor = new Portal(/* @__PURE__ */ defineComponent({
 						title: unref(t)("playground.common.close"),
 						style: { "cursor": "pointer" },
 						onClick: handleHide
-					}, "✕", 8, _hoisted_2$3)], 512),
-					createElementVNode("div", _hoisted_3$3, [createVNode(unref(Scroller), {
+					}, "✕", 8, _hoisted_2$4)], 512),
+					createElementVNode("div", _hoisted_3$4, [createVNode(unref(Scroller), {
 						ref_key: "scroller",
 						ref: scroller,
 						class: "docs-playground-editor__scroller",
@@ -757,11 +723,11 @@ var Editor = new Portal(/* @__PURE__ */ defineComponent({
 								onDblclick: _cache[2] || (_cache[2] = withModifiers(() => {}, ["stop"])),
 								onBlur: handleRenameSubmit,
 								onKeydown: [withKeys(withModifiers(handleRenameSubmit, ["prevent"]), ["enter"]), withKeys(withModifiers(handleRenameCancel, ["prevent"]), ["esc"])]
-							}, null, 40, _hoisted_5$3)), [[vModelText, filenameDraft.value]]) : (openBlock(), createElementBlock(Fragment, { key: 1 }, [
+							}, null, 40, _hoisted_5$4)), [[vModelText, filenameDraft.value]]) : (openBlock(), createElementBlock(Fragment, { key: 1 }, [
 								filename === currentEntry.value ? (openBlock(), createElementBlock("span", {
 									key: 0,
 									title: unref(t)("playground.editor.entry")
-								}, "●", 8, _hoisted_6$2)) : createCommentVNode("v-if", true),
+								}, "●", 8, _hoisted_6$3)) : createCommentVNode("v-if", true),
 								createElementVNode("span", null, toDisplayString(filename), 1),
 								filename === currentEntry.value ? (openBlock(), createElementBlock("button", {
 									key: 1,
@@ -770,7 +736,7 @@ var Editor = new Portal(/* @__PURE__ */ defineComponent({
 									title: unref(t)("playground.editor.entryCannotDelete"),
 									"aria-label": unref(t)("playground.editor.entryCannotDelete"),
 									disabled: ""
-								}, null, 8, _hoisted_7$1)) : (openBlock(), createBlock(unref(Popconfirm), {
+								}, null, 8, _hoisted_7$3)) : (openBlock(), createBlock(unref(Popconfirm), {
 									key: 2,
 									class: "docs-playground-editor__delete",
 									title: unref(t)("playground.editor.confirmDelete", { filename }),
@@ -783,23 +749,23 @@ var Editor = new Portal(/* @__PURE__ */ defineComponent({
 										class: "docs-playground-editor__close",
 										title: unref(t)("playground.editor.deleteFile"),
 										"aria-label": unref(t)("playground.editor.confirmDelete", { filename })
-									}, null, 8, _hoisted_8$1)]),
+									}, null, 8, _hoisted_8$2)]),
 									_: 2
 								}, 1032, ["title", "onOk"]))
-							], 64))], 42, _hoisted_4$3);
+							], 64))], 42, _hoisted_4$4);
 						}), 128))]),
 						_: 1
-					}, 512), createElementVNode("div", _hoisted_9, [createElementVNode("button", {
+					}, 512), createElementVNode("div", _hoisted_9$2, [createElementVNode("button", {
 						type: "button",
 						title: unref(t)("playground.editor.createFile"),
 						onClick: handleCreate
-					}, "＋", 8, _hoisted_10), createElementVNode("button", {
+					}, "＋", 8, _hoisted_10$1), createElementVNode("button", {
 						type: "button",
 						title: unref(t)("playground.editor.setEntry"),
 						disabled: activeFilename.value === currentEntry.value,
 						onClick: handleEntry
-					}, toDisplayString(unref(t)("playground.editor.setEntry")), 9, _hoisted_11)])]),
-					codeErrorText.value ? (openBlock(), createElementBlock("div", _hoisted_12, toDisplayString(codeErrorText.value), 1)) : createCommentVNode("v-if", true),
+					}, toDisplayString(unref(t)("playground.editor.setEntry")), 9, _hoisted_11$1)])]),
+					codeErrorText.value ? (openBlock(), createElementBlock("div", _hoisted_12$1, toDisplayString(codeErrorText.value), 1)) : createCommentVNode("v-if", true),
 					createVNode(unref(Scroller), {
 						ref_key: "editorScroller",
 						ref: editorScroller,
@@ -823,19 +789,156 @@ var Editor = new Portal(/* @__PURE__ */ defineComponent({
 		};
 	}
 }), { aliveRegExp: { className: /(PORTAL_TAG_DISABLE)/ } });
+//#endregion
+//#region packages/playground/src/utils.ts
+/**
+* 比较两组 playground 文件是否完全一致。
+* @param left 左侧文件表。
+* @param right 右侧文件表。
+* @returns 键集合与各文件内容是否都相同。
+*/
+var filesEqual = (left, right) => {
+	const leftKeys = Object.keys(left);
+	const rightKeys = Object.keys(right);
+	return leftKeys.length === rightKeys.length && leftKeys.every((key) => left[key] === right[key]);
+};
+/**
+* 视图切换条使用的文案键。
+* @param view 当前预览视图。
+* @returns locale 消息键。
+*/
+var playgroundViewMessage = (view) => view === "runtime" ? "playground.runtime.preview" : "playground.runtime.files";
+/**
+* 与 markdown-it-anchor 默认 `slugify` 对齐，用于标题锚点 id。
+* @param title 标题文本。
+* @returns 可用作元素 id / hash 的字符串；空标题返回空串。
+*/
+var slugifyPlaygroundTitle = (title) => {
+	const normalized = String(title).trim().toLowerCase().replace(/\s+/g, "-");
+	return normalized ? encodeURIComponent(normalized) : "";
+};
+/**
+* 解析标题锚点 id：显式 id 优先，否则从标题 slugify；必要时避开已占用 id。
+* @param title 标题文本。
+* @param explicitId 可选显式 id。
+* @param isOccupied 返回该 id 是否已被其他元素占用。
+* @returns 锚点 id；无标题时为空串。
+*/
+var resolvePlaygroundTitleId = (title, explicitId = "", isOccupied) => {
+	if (!String(title).trim()) return "";
+	const base = String(explicitId).trim() || slugifyPlaygroundTitle(title);
+	if (!base) return "";
+	if (!isOccupied || !isOccupied(base)) return base;
+	let index = 1;
+	while (isOccupied(`${base}-${index}`)) index += 1;
+	return `${base}-${index}`;
+};
+//#endregion
+//#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);",
+	"}",
+	"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,`,
+	`html.${PREVIEW_SCROLL_HTML_CLASS} #app>.vc-scroller>.vc-scroller__wrapper{`,
+	"height:100%;max-height:100%;box-sizing:border-box",
+	"}"
+].join("");
 var resolveSandboxContainer = (sandbox) => sandbox?.container ? unref(sandbox.container) : null;
+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) {
+			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 isEmptyPreviewApp = (iframeDocument) => {
+		const app = iframeDocument.getElementById("app");
+		return !!app && app.childElementCount === 0;
+	};
 	const measure = () => {
 		frameId = 0;
 		if (!iframe) return;
@@ -843,21 +946,9 @@ var useSandboxAutoHeight = (sandboxRef) => {
 			const iframeWindow = iframe.contentWindow;
 			const iframeDocument = iframe.contentDocument;
 			if (!iframeWindow || !iframeDocument?.body) return;
-			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) {
-				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 + 1 ? scrollHeight : 0;
-			const contentHeight = Math.ceil(Math.max(body.offsetHeight + bodyMargins + collapsedTop, bodyRect.height + bodyMargins + collapsedTop, childrenBottom, overflowingHeight));
+			const scrollContent = resolveScrollContent(iframeDocument);
+			if (!scrollContent && isEmptyPreviewApp(iframeDocument)) return;
+			const contentHeight = scrollContent ? measureScrollContent(scrollContent) : measureDocumentContent(iframeWindow, iframeDocument);
 			const nextHeight = Math.max(contentHeight, 24);
 			if (height.value !== nextHeight) height.value = nextHeight;
 		} catch {
@@ -871,6 +962,9 @@ var useSandboxAutoHeight = (sandboxRef) => {
 	const disconnectContent = () => {
 		contentObserver?.disconnect();
 		contentObserver = null;
+		scrollMountObserver?.disconnect();
+		scrollMountObserver = null;
+		observedScrollNode = null;
 		cancelMeasure();
 	};
 	const observeContent = () => {
@@ -888,7 +982,28 @@ var useSandboxAutoHeight = (sandboxRef) => {
 			observer.observe(iframeDocument.documentElement);
 			observer.observe(iframeDocument.body);
 			contentObserver = observer;
-			scheduleMeasure();
+			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;
 		}
@@ -932,6 +1047,12 @@ var useSandboxAutoHeight = (sandboxRef) => {
 	});
 	return height;
 };
+var resolvePreviewBoxHeight = (contentHeight, verticalInset = 0, borderWidth = 1) => {
+	const content = Number.isFinite(contentHeight) ? Math.max(0, contentHeight) : 0;
+	const inset = Number.isFinite(verticalInset) ? Math.max(0, verticalInset) : 0;
+	const border = Number.isFinite(borderWidth) ? Math.max(0, borderWidth) : 1;
+	return content + inset * 2 + border * 2;
+};
 var CLIPPING_OVERFLOW = /* @__PURE__ */ new Set([
 	"auto",
 	"scroll",
@@ -945,14 +1066,14 @@ var SCROLLABLE_OVERFLOW = /* @__PURE__ */ new Set([
 ]);
 var getWindowInnerHeight = () => typeof window === "undefined" ? 0 : window.innerHeight;
 var getPlaygroundHost = (el) => el?.closest(".docs-playground") ?? el;
-var isPlaygroundExpandEnabled = (expand) => {
-	if (expand === true) return true;
-	return typeof expand === "number" && Number.isFinite(expand) && expand > 0;
+var isPlaygroundExpandable = (value) => {
+	if (value === true) return true;
+	return typeof value === "number" && Number.isFinite(value) && value > 0;
 };
 var resolveRemainingPreviewHeight = ({ viewportHeight, chromeHeight, gap = 16 }) => Math.max(0, Math.round((Number.isFinite(viewportHeight) ? viewportHeight : 0) - (Number.isFinite(chromeHeight) ? Math.max(0, chromeHeight) : 0) - (Number.isFinite(gap) ? gap : 16)));
-var resolveExpandedPreviewHeight = (expand, availableHeight) => {
-	if (expand === true) return Math.max(24, Math.round(Number.isFinite(availableHeight) ? availableHeight : 0));
-	return Math.max(24, Math.round(expand));
+var resolveExpandedPreviewHeight = (expandable, availableHeight) => {
+	if (expandable === true) return Math.max(24, Math.round(Number.isFinite(availableHeight) ? availableHeight : 0));
+	return Math.max(24, Math.round(expandable));
 };
 var getVisibleViewportRect = (el) => {
 	const viewportHeight = getWindowInnerHeight();
@@ -1100,6 +1221,13 @@ var formatViewportLabel = (viewport, autoLabel = "Auto") => {
 	if (viewport === "auto") return autoLabel;
 	return Array.isArray(viewport) ? `${viewport[0]} × ${viewport[1]}px` : `${viewport}px`;
 };
+var resolvePopupScreenInset = (gap = 40) => {
+	const safeGap = Number.isFinite(gap) ? Math.max(0, gap) : 40;
+	return {
+		x: safeGap * 2,
+		y: safeGap
+	};
+};
 var getWindowInnerSize = () => {
 	if (typeof window === "undefined") return {
 		width: 0,
@@ -1111,9 +1239,9 @@ var getWindowInnerSize = () => {
 	};
 };
 var resolvePopupRequestedSize = (viewport, screen = getWindowInnerSize(), gap = 40) => {
-	const safeGap = Number.isFinite(gap) ? Math.max(0, gap) : 40;
-	const maxWidth = Math.max(0, Math.round((Number.isFinite(screen.width) ? screen.width : 0) - safeGap));
-	const maxHeight = Math.max(0, Math.round((Number.isFinite(screen.height) ? screen.height : 0) - safeGap));
+	const inset = resolvePopupScreenInset(gap);
+	const maxWidth = Math.max(0, Math.round((Number.isFinite(screen.width) ? screen.width : 0) - inset.x));
+	const maxHeight = Math.max(0, Math.round((Number.isFinite(screen.height) ? screen.height : 0) - inset.y));
 	const viewportWidth = getViewportWidth(viewport);
 	const viewportHeight = getViewportHeight(viewport);
 	return {
@@ -1124,11 +1252,11 @@ var resolvePopupRequestedSize = (viewport, screen = getWindowInnerSize(), gap =
 	};
 };
 /**
-* 壳层封顶到 `screen - gap`。未设 viewport 边时，画布铺满工具栏以下区域；
-* 请求尺寸大于可用区域时由 Scroller 处理溢出。
+* 壳层封顶到 `screen.width - gap * 2`、`screen.height - gap`。
+* 未设 viewport 边时，画布铺满工具栏以下区域；请求尺寸大于可用区域时由 Scroller 处理溢出。
 * @param viewport 当前 playground 视口配置。
-* @param screen 屏幕可用宽高，默认取 `window.inner*`.
-* @param gap 相对屏幕边缘的留白。
+* @param screen 屏幕可用宽高，默认取 `window.inner*`。
+* @param gap 相对屏幕上下边缘的留白；左右为该值的 2 倍。
 * @returns 壳层、内容区与画布尺寸，以及是否需要滚动。
 */
 var resolvePopupLayout = (viewport, screen = getWindowInnerSize(), gap = 40) => {
@@ -1243,23 +1371,56 @@ var useSandboxTheme = (sandboxRef) => {
 //#endregion
 //#region packages/playground/src/core/runtime/toolbar.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$3 = { class: "docs-playground__tools" };
-var _hoisted_2$2 = ["title", "aria-label"];
-var _hoisted_3$2 = [
+var _hoisted_2$3 = {
+	key: 0,
+	class: "docs-playground__tool-group"
+};
+var _hoisted_3$3 = [
 	"title",
 	"aria-label",
 	"aria-expanded"
 ];
-var _hoisted_4$2 = ["title", "aria-label"];
-var _hoisted_5$2 = ["title", "aria-label"];
-var _hoisted_6$1 = ["title", "aria-label"];
+var _hoisted_4$3 = {
+	key: 1,
+	class: "docs-playground__tool-divider",
+	"aria-hidden": "true"
+};
+var _hoisted_5$3 = ["title", "aria-label"];
+var _hoisted_6$2 = ["title", "aria-label"];
+var _hoisted_7$2 = ["title", "aria-label"];
+var _hoisted_8$1 = {
+	key: 3,
+	class: "docs-playground__tool-divider",
+	"aria-hidden": "true"
+};
+var _hoisted_9$1 = ["aria-label"];
+var _hoisted_10 = [
+	"title",
+	"aria-label",
+	"aria-selected",
+	"aria-pressed",
+	"onClick"
+];
+var _hoisted_11 = {
+	key: 2,
+	class: "docs-playground__tool-divider",
+	"aria-hidden": "true"
+};
+var _hoisted_12 = ["title", "aria-label"];
 //#endregion
 //#region packages/playground/src/core/runtime/toolbar.vue
 var toolbar_default = /* @__PURE__ */ defineComponent({
 	__name: "toolbar",
 	props: {
-		copyValue: {},
+		copyValue: { default: "" },
 		viewport: { default: "auto" },
 		viewportOptions: { default: () => ["auto", 375] },
+		views: { default: () => [] },
+		activeView: { default: "runtime" },
+		showRuntimeActions: {
+			type: Boolean,
+			default: true
+		},
 		showOpenPopup: {
 			type: Boolean,
 			default: false
@@ -1274,14 +1435,20 @@ var toolbar_default = /* @__PURE__ */ defineComponent({
 		"edit",
 		"open-popup",
 		"close-popup",
-		"viewport-change"
+		"viewport-change",
+		"view-change"
 	],
 	setup(__props, { emit: __emit }) {
 		const props = __props;
 		const emit = __emit;
 		const { t } = useLocale();
+		const VIEW_ORDER = ["runtime", "files"];
 		const viewportMenuVisible = ref(false);
+		const orderedViews = computed(() => VIEW_ORDER.filter((view) => props.views.includes(view)));
+		const showViews = computed(() => orderedViews.value.length > 1);
 		const viewportLabel = computed(() => formatViewportLabel(props.viewport, t("playground.runtime.auto")));
+		const getViewAriaLabel = (view) => t(playgroundViewMessage(view));
+		const getViewLabel = (view) => view === "runtime" ? t("playground.runtime.previewLabel") : t("playground.runtime.codeLabel");
 		const handleViewport = (index) => {
 			const viewport = props.viewportOptions[index];
 			if (viewport && !viewportEquals(viewport, props.viewport)) emit("viewport-change", viewport);
@@ -1289,95 +1456,120 @@ var toolbar_default = /* @__PURE__ */ defineComponent({
 		watch(() => props.viewportOptions.length, (length) => {
 			if (length <= 1) viewportMenuVisible.value = false;
 		});
+		watch(() => props.showRuntimeActions, (enabled) => {
+			if (!enabled) viewportMenuVisible.value = false;
+		});
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("div", _hoisted_1$3, [
-				createElementVNode("button", {
-					type: "button",
-					class: "docs-playground__tool docs-playground__refresh",
-					"data-action": "refresh",
-					title: unref(t)("playground.runtime.refresh"),
-					"aria-label": unref(t)("playground.runtime.refresh"),
-					onClick: _cache[0] || (_cache[0] = ($event) => emit("refresh"))
-				}, [createVNode(unref(icon_default), { name: "refresh" })], 8, _hoisted_2$2),
-				__props.viewportOptions.length > 1 ? (openBlock(), createBlock(unref(Dropdown), {
-					key: 0,
-					modelValue: viewportMenuVisible.value,
-					"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => viewportMenuVisible.value = $event),
-					class: "docs-playground__viewport-menu",
-					portal: true,
-					trigger: "click",
-					placement: "bottom-right"
-				}, {
-					content: withCtx(() => [createVNode(unref(DropdownMenu), {
-						class: "docs-playground__viewport-options",
-						role: "menu",
-						"aria-label": unref(t)("playground.runtime.viewportMenu")
+				__props.showRuntimeActions ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
+					__props.viewportOptions.length > 1 ? (openBlock(), createElementBlock("div", _hoisted_2$3, [createVNode(unref(Dropdown), {
+						modelValue: viewportMenuVisible.value,
+						"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => viewportMenuVisible.value = $event),
+						class: "docs-playground__viewport-menu",
+						portal: true,
+						trigger: "click",
+						placement: "bottom-right"
 					}, {
-						default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.viewportOptions, (item, index) => {
-							return openBlock(), createBlock(unref(DropdownItem), {
-								key: unref(getViewportKey)(item),
-								class: "docs-playground__viewport-option",
-								value: index,
-								selected: unref(viewportEquals)(item, __props.viewport),
-								role: "menuitemradio",
-								"aria-checked": unref(viewportEquals)(item, __props.viewport),
-								onClick: ($event) => handleViewport(index)
-							}, {
-								default: withCtx(() => [createTextVNode(toDisplayString(unref(formatViewportLabel)(item, unref(t)("playground.runtime.auto"))), 1)]),
-								_: 2
-							}, 1032, [
-								"value",
-								"selected",
-								"aria-checked",
-								"onClick"
-							]);
-						}), 128))]),
+						content: withCtx(() => [createVNode(unref(DropdownMenu), {
+							class: "docs-playground__viewport-options",
+							role: "menu",
+							"aria-label": unref(t)("playground.runtime.viewportMenu")
+						}, {
+							default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.viewportOptions, (item, index) => {
+								return openBlock(), createBlock(unref(DropdownItem), {
+									key: unref(getViewportKey)(item),
+									class: "docs-playground__viewport-option",
+									value: index,
+									selected: unref(viewportEquals)(item, __props.viewport),
+									role: "menuitemradio",
+									"aria-checked": unref(viewportEquals)(item, __props.viewport),
+									onClick: ($event) => handleViewport(index)
+								}, {
+									default: withCtx(() => [createTextVNode(toDisplayString(unref(formatViewportLabel)(item, unref(t)("playground.runtime.auto"))), 1)]),
+									_: 2
+								}, 1032, [
+									"value",
+									"selected",
+									"aria-checked",
+									"onClick"
+								]);
+							}), 128))]),
+							_: 1
+						}, 8, ["aria-label"])]),
+						default: withCtx(() => [createElementVNode("button", {
+							type: "button",
+							class: normalizeClass(["docs-playground__tool docs-playground__viewport-trigger", { "is-active": __props.viewport !== "auto" }]),
+							title: unref(t)("playground.runtime.viewport", { value: viewportLabel.value }),
+							"aria-label": unref(t)("playground.runtime.viewport", { value: viewportLabel.value }),
+							"aria-expanded": viewportMenuVisible.value,
+							"aria-haspopup": "menu"
+						}, [createVNode(unref(icon_default), { name: "viewport" })], 10, _hoisted_3$3)]),
 						_: 1
-					}, 8, ["aria-label"])]),
-					default: withCtx(() => [createElementVNode("button", {
+					}, 8, ["modelValue"])])) : createCommentVNode("v-if", true),
+					__props.viewportOptions.length > 1 ? (openBlock(), createElementBlock("span", _hoisted_4$3)) : createCommentVNode("v-if", true),
+					createElementVNode("button", {
 						type: "button",
-						class: normalizeClass(["docs-playground__tool docs-playground__viewport-trigger", { "is-active": __props.viewport !== "auto" }]),
-						title: unref(t)("playground.runtime.viewport", { value: viewportLabel.value }),
-						"aria-label": unref(t)("playground.runtime.viewport", { value: viewportLabel.value }),
-						"aria-expanded": viewportMenuVisible.value,
-						"aria-haspopup": "menu"
-					}, [createVNode(unref(icon_default), { name: "viewport" })], 10, _hoisted_3$2)]),
-					_: 1
-				}, 8, ["modelValue"])) : createCommentVNode("v-if", true),
-				createVNode(unref(Clipboard), {
-					class: "docs-playground__tool",
-					value: __props.copyValue,
-					tag: "button",
-					type: "button",
-					title: unref(t)("playground.common.copy"),
-					"aria-label": unref(t)("playground.common.copy")
-				}, {
-					default: withCtx(() => [createVNode(unref(icon_default), { name: "copy" })]),
-					_: 1
-				}, 8, [
-					"value",
-					"title",
-					"aria-label"
-				]),
-				createElementVNode("button", {
-					type: "button",
-					class: "docs-playground__tool docs-playground__editor",
-					"data-action": "edit",
-					title: unref(t)("playground.runtime.editFiles"),
-					"aria-label": unref(t)("playground.runtime.editFiles"),
-					onClick: _cache[2] || (_cache[2] = ($event) => emit("edit"))
-				}, [createVNode(unref(icon_default), { name: "editor" })], 8, _hoisted_4$2),
-				__props.showOpenPopup ? (openBlock(), createElementBlock("button", {
+						class: "docs-playground__tool docs-playground__refresh",
+						"data-action": "refresh",
+						title: unref(t)("playground.runtime.refresh"),
+						"aria-label": unref(t)("playground.runtime.refresh"),
+						onClick: _cache[1] || (_cache[1] = ($event) => emit("refresh"))
+					}, [createVNode(unref(icon_default), { name: "refresh" })], 8, _hoisted_5$3),
+					createElementVNode("button", {
+						type: "button",
+						class: "docs-playground__tool docs-playground__editor",
+						"data-action": "edit",
+						title: unref(t)("playground.runtime.editFiles"),
+						"aria-label": unref(t)("playground.runtime.editFiles"),
+						onClick: _cache[2] || (_cache[2] = ($event) => emit("edit"))
+					}, [createVNode(unref(icon_default), { name: "editor" })], 8, _hoisted_6$2),
+					__props.showOpenPopup ? (openBlock(), createElementBlock("button", {
+						key: 2,
+						type: "button",
+						class: "docs-playground__tool docs-playground__popup",
+						"data-action": "open-popup",
+						title: unref(t)("playground.runtime.openPopup"),
+						"aria-label": unref(t)("playground.runtime.openPopup"),
+						onClick: _cache[3] || (_cache[3] = ($event) => emit("open-popup"))
+					}, [createVNode(unref(icon_default), { name: "popup" })], 8, _hoisted_7$2)) : createCommentVNode("v-if", true),
+					createVNode(unref(Clipboard), {
+						class: "docs-playground__tool",
+						value: __props.copyValue,
+						tag: "button",
+						type: "button",
+						title: unref(t)("playground.common.copy"),
+						"aria-label": unref(t)("playground.common.copy")
+					}, {
+						default: withCtx(() => [createVNode(unref(icon_default), { name: "copy" })]),
+						_: 1
+					}, 8, [
+						"value",
+						"title",
+						"aria-label"
+					]),
+					showViews.value ? (openBlock(), createElementBlock("span", _hoisted_8$1)) : createCommentVNode("v-if", true)
+				], 64)) : createCommentVNode("v-if", true),
+				showViews.value ? (openBlock(), createElementBlock("div", {
 					key: 1,
-					type: "button",
-					class: "docs-playground__tool docs-playground__popup",
-					"data-action": "open-popup",
-					title: unref(t)("playground.runtime.openPopup"),
-					"aria-label": unref(t)("playground.runtime.openPopup"),
-					onClick: _cache[3] || (_cache[3] = ($event) => emit("open-popup"))
-				}, [createVNode(unref(icon_default), { name: "popup" })], 8, _hoisted_5$2)) : createCommentVNode("v-if", true),
+					class: "docs-playground__views",
+					role: "tablist",
+					"aria-label": unref(t)("playground.runtime.views")
+				}, [(openBlock(true), createElementBlock(Fragment, null, renderList(orderedViews.value, (item) => {
+					return openBlock(), createElementBlock("button", {
+						key: item,
+						type: "button",
+						class: normalizeClass(["docs-playground__view", { "is-active": item === __props.activeView }]),
+						role: "tab",
+						title: getViewAriaLabel(item),
+						"aria-label": getViewAriaLabel(item),
+						"aria-selected": item === __props.activeView,
+						"aria-pressed": item === __props.activeView,
+						onClick: ($event) => emit("view-change", item)
+					}, toDisplayString(getViewLabel(item)), 11, _hoisted_10);
+				}), 128))], 8, _hoisted_9$1)) : createCommentVNode("v-if", true),
+				__props.showClose && (__props.showRuntimeActions || showViews.value) ? (openBlock(), createElementBlock("span", _hoisted_11)) : createCommentVNode("v-if", true),
 				__props.showClose ? (openBlock(), createElementBlock("button", {
-					key: 2,
+					key: 3,
 					type: "button",
 					class: "docs-playground__tool docs-playground__popup-close",
 					"data-action": "close-popup",
@@ -1387,7 +1579,7 @@ var toolbar_default = /* @__PURE__ */ defineComponent({
 				}, [..._cache[5] || (_cache[5] = [createElementVNode("span", {
 					class: "docs-playground__popup-close-mark",
 					"aria-hidden": "true"
-				}, "✕", -1)])], 8, _hoisted_6$1)) : createCommentVNode("v-if", true)
+				}, "✕", -1)])], 8, _hoisted_12)) : createCommentVNode("v-if", true)
 			]);
 		};
 	}
@@ -1730,6 +1922,7 @@ var bindPlaygroundScss = (store) => {
 //#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\",{",
@@ -1746,21 +1939,27 @@ var escapeHtmlAttr = (value) => value.replace(/&/gu, "&amp;").replace(/"/gu, "&q
 * `--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) => {
+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\">",
-			...Object.values({
-				...createBuiltinStyles(cdnURL),
-				...getPlaygroundSiteStyles(),
-				...getPlaygroundStyleOverrides()
-			}).map((href) => `<link rel="stylesheet" href="${escapeHtmlAttr(href)}">`),
+			...hrefs.map((href) => `<link rel="stylesheet" href="${escapeHtmlAttr(href)}">`),
 			"<style>",
-			`html,body{height:auto;min-height:0;background:${PLAYGROUND_RUNTIME_CANVAS_BACKGROUND}}`,
-			"body{color:var(--vc-foreground-color,#080f20)}",
+			...styleBlocks,
 			"</style>"
 		].join("\n"),
 		customCode: {
@@ -1808,14 +2007,16 @@ var createRuntimeStore = (files, entry, options) => {
 //#endregion
 //#region packages/playground/src/core/runtime/alone/wrapper.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$2 = ["aria-label"];
-var _hoisted_2$1 = { class: "docs-playground-popup__frame" };
-var _hoisted_3$1 = { class: "docs-playground-popup__header" };
-var _hoisted_4$1 = {
+var _hoisted_2$2 = { class: "docs-playground-popup__frame" };
+var _hoisted_3$2 = { class: "docs-playground-popup__header" };
+var _hoisted_4$2 = ["title"];
+var _hoisted_5$2 = { class: "docs-playground__title-text" };
+var _hoisted_6$1 = {
 	key: 0,
 	class: "docs-playground__runtime-error",
 	role: "alert"
 };
-var _hoisted_5$1 = { class: "docs-playground-popup__body" };
+var _hoisted_7$1 = { class: "docs-playground-popup__body" };
 //#endregion
 //#region packages/playground/src/core/runtime/alone/index.ts
 var Alone = new Portal(/* @__PURE__ */ defineComponent({
@@ -1823,6 +2024,7 @@ var Alone = new Portal(/* @__PURE__ */ defineComponent({
 	props: {
 		store: {},
 		copyValue: {},
+		title: { default: "" },
 		viewport: { default: "auto" },
 		viewportOptions: { default: () => ["auto", 375] },
 		previewOptions: {},
@@ -1923,8 +2125,12 @@ var Alone = new Portal(/* @__PURE__ */ defineComponent({
 			}), createElementVNode("div", {
 				class: "docs-playground-popup__shell",
 				style: normalizeStyle(shellStyle.value)
-			}, [createElementVNode("div", _hoisted_2$1, [
-				createElementVNode("div", _hoisted_3$1, [createVNode(toolbar_default, {
+			}, [createElementVNode("div", _hoisted_2$2, [
+				createElementVNode("div", _hoisted_3$2, [__props.title.trim() ? (openBlock(), createElementBlock("span", {
+					key: 0,
+					class: "docs-playground__title",
+					title: __props.title.trim()
+				}, [createElementVNode("span", _hoisted_5$2, toDisplayString(__props.title.trim()), 1)], 8, _hoisted_4$2)) : createCommentVNode("v-if", true), createVNode(toolbar_default, {
 					"copy-value": __props.copyValue,
 					viewport: currentViewport.value,
 					"viewport-options": __props.viewportOptions,
@@ -1938,8 +2144,8 @@ var Alone = new Portal(/* @__PURE__ */ defineComponent({
 					"viewport",
 					"viewport-options"
 				])]),
-				errorText.value ? (openBlock(), createElementBlock("pre", _hoisted_4$1, toDisplayString(errorText.value), 1)) : createCommentVNode("v-if", true),
-				createElementVNode("div", _hoisted_5$1, [createVNode(unref(Scroller), {
+				errorText.value ? (openBlock(), createElementBlock("pre", _hoisted_6$1, toDisplayString(errorText.value), 1)) : createCommentVNode("v-if", true),
+				createElementVNode("div", _hoisted_7$1, [createVNode(unref(Scroller), {
 					class: "docs-playground-popup__scroller",
 					"content-class": "docs-playground-popup__scroller-content",
 					"auto-resize": true,
@@ -1976,29 +2182,25 @@ var Alone = new Portal(/* @__PURE__ */ defineComponent({
 //#endregion
 //#region packages/playground/src/core/runtime/runtime.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1$1 = { class: "docs-playground-runtime-host" };
-var _hoisted_2 = {
+var _hoisted_2$1 = {
 	key: 0,
 	class: "docs-playground__runtime-error",
 	role: "alert"
 };
-var _hoisted_3 = { class: "docs-playground__header" };
-var _hoisted_4 = {
+var _hoisted_3$1 = {
 	key: 0,
-	class: "docs-playground__views"
+	class: "docs-playground__header"
 };
-var _hoisted_5 = [
-	"title",
-	"aria-label",
-	"aria-pressed",
-	"onClick"
-];
-var _hoisted_6 = {
-	key: 0,
+var _hoisted_4$1 = ["id", "title"];
+var _hoisted_5$1 = ["href"];
+var _hoisted_6 = { class: "docs-playground__title-text" };
+var _hoisted_7 = {
+	key: 1,
 	class: "docs-playground__runtime-error",
 	role: "alert"
 };
-var _hoisted_7 = { class: "docs-playground-runtime__viewport-stage" };
-var _hoisted_8 = [
+var _hoisted_8 = { class: "docs-playground-runtime__viewport-stage" };
+var _hoisted_9 = [
 	"aria-expanded",
 	"title",
 	"aria-label"
@@ -2015,11 +2217,21 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 		options: {},
 		previewInset: { default: 10 },
 		previewOptions: {},
+		previewScroller: {
+			type: Boolean,
+			default: false
+		},
 		styleless: {
 			type: Boolean,
 			default: false
 		},
-		expand: { type: [Boolean, Number] },
+		hideChrome: {
+			type: Boolean,
+			default: false
+		},
+		expandable: { type: [Boolean, Number] },
+		title: { default: "" },
+		id: { default: "" },
 		viewport: { default: "auto" },
 		viewportOptions: { default: () => ["auto", 375] }
 	},
@@ -2029,14 +2241,20 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 		"viewport-change",
 		"navigate"
 	],
-	setup(__props, { emit: __emit }) {
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const props = __props;
 		const { locale, t } = useLocale();
-		const getViewText = (view) => t(playgroundViewMessage(view));
+		const displayTitle = computed(() => props.title.trim());
+		const titleEl = ref(null);
+		const titleId = computed(() => resolvePlaygroundTitleId(displayTitle.value, props.id, (candidate) => {
+			if (typeof document === "undefined") return false;
+			const existing = document.getElementById(candidate);
+			return !!existing && existing !== titleEl.value;
+		}));
 		const emit = __emit;
 		const joinCode = (...values) => values.filter(Boolean).join("\n");
 		const mergePreviewOptions = (extraHeadHTML) => {
-			const runtimePreviewOptions = createRuntimePreviewOptions(props.options.cdnURL);
+			const runtimePreviewOptions = createRuntimePreviewOptions(props.options.cdnURL, { previewScroller: props.previewScroller });
 			return {
 				...runtimePreviewOptions,
 				...props.previewOptions,
@@ -2046,8 +2264,8 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 					extraHeadHTML
 				].filter(Boolean).join("\n"),
 				customCode: {
-					importCode: joinCode(runtimePreviewOptions.customCode?.importCode, props.previewOptions?.customCode?.importCode),
-					useCode: joinCode(runtimePreviewOptions.customCode?.useCode, props.previewOptions?.customCode?.useCode)
+					importCode: joinCode(DOCS_LINK_IMPORT_CODE, props.previewOptions?.customCode?.importCode, props.previewScroller ? PREVIEW_SCROLL_RESET_CODE : void 0, props.previewScroller ? PREVIEW_SCROLLER_IMPORT_CODE : void 0),
+					useCode: joinCode(runtimePreviewOptions.customCode?.useCode, props.previewOptions?.customCode?.useCode, props.previewScroller ? PREVIEW_SCROLLER_USE_CODE : void 0)
 				}
 			};
 		};
@@ -2081,36 +2299,44 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 		};
 		const runtimeRoot = ref(null);
 		const previewExpanded = ref(false);
-		/** `expand: true` 时在展开瞬间冻结，避免滚动重算高度造成抖动。 */
+		/** `expandable: true` 时在展开瞬间冻结，避免滚动重算高度造成抖动。 */
 		const frozenExpandedHeight = ref(0);
 		const measurePreviewChromeHeight = () => {
 			const root = runtimeRoot.value;
 			if (!root) return 0;
-			const header = root.querySelector(".docs-playground__header");
+			const header = (root.closest(".docs-playground") ?? root).querySelector(".docs-playground__header");
 			const error = root.querySelector(".docs-playground__runtime-error");
 			return (header instanceof HTMLElement ? header.offsetHeight : 0) + (error instanceof HTMLElement ? error.offsetHeight : 0);
 		};
+		const normalizedPreviewInset = computed(() => {
+			const value = props.previewInset;
+			if (typeof value === "number") return Number.isFinite(value) && value >= 0 ? [value, value] : [10, 10];
+			if (Array.isArray(value) && value.length === 2 && value.every((item) => typeof item === "number" && Number.isFinite(item) && item >= 0)) return [value[0], value[1]];
+			return [10, 10];
+		});
 		const measureExpandedPreviewHeight = () => {
 			if (typeof window === "undefined") return runtimeHeight.value;
 			const chromeHeight = measurePreviewChromeHeight();
+			const viewport = getVisibleViewportRect(runtimeRoot.value);
+			const [vertical] = normalizedPreviewInset.value;
 			return resolveExpandedPreviewHeight(true, resolveRemainingPreviewHeight({
-				viewportHeight: getVisibleViewportRect(runtimeRoot.value).height,
+				viewportHeight: viewport.height,
 				chromeHeight
-			}));
+			}) - vertical * 2 - 2);
 		};
 		const syncFrozenExpandedHeight = () => {
-			if (!previewExpanded.value || props.expand !== true) return;
+			if (!previewExpanded.value || props.expandable !== true) return;
 			frozenExpandedHeight.value = measureExpandedPreviewHeight();
 		};
 		if (typeof window !== "undefined") {
 			window.addEventListener("message", handleBridgeMessage);
 			window.addEventListener("resize", syncFrozenExpandedHeight);
 		}
-		const canExpandPreview = computed(() => !props.styleless && isPlaygroundExpandEnabled(props.expand));
+		const canExpandPreview = computed(() => !props.styleless && isPlaygroundExpandable(props.expandable));
 		const expandLabel = computed(() => t(previewExpanded.value ? "playground.runtime.collapsePreview" : "playground.runtime.expandPreview"));
 		const desiredViewportHeight = computed(() => {
-			if (previewExpanded.value && props.expand === true) return frozenExpandedHeight.value;
-			if (previewExpanded.value && isPlaygroundExpandEnabled(props.expand)) return resolveExpandedPreviewHeight(props.expand, 0);
+			if (previewExpanded.value && props.expandable === true) return frozenExpandedHeight.value;
+			if (previewExpanded.value && isPlaygroundExpandable(props.expandable)) return resolveExpandedPreviewHeight(props.expandable, 0);
 			const fixedHeight = getViewportHeight(props.viewport);
 			if (fixedHeight) return fixedHeight;
 			return runtimeHeight.value;
@@ -2121,7 +2347,7 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 		const handleTogglePreviewExpand = () => {
 			if (!canExpandPreview.value) return;
 			if (!previewExpanded.value) {
-				if (props.expand === true) frozenExpandedHeight.value = measureExpandedPreviewHeight();
+				if (props.expandable === true) frozenExpandedHeight.value = measureExpandedPreviewHeight();
 				else frozenExpandedHeight.value = 0;
 				previewExpanded.value = true;
 				nextTick(scrollExpandedPreviewIntoView);
@@ -2136,16 +2362,10 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 				frozenExpandedHeight.value = 0;
 			}
 		});
-		const normalizedPreviewInset = computed(() => {
-			const value = props.previewInset;
-			if (typeof value === "number") return Number.isFinite(value) && value >= 0 ? [value, value] : [10, 10];
-			if (Array.isArray(value) && value.length === 2 && value.every((item) => typeof item === "number" && Number.isFinite(item) && item >= 0)) return [value[0], value[1]];
-			return [10, 10];
-		});
 		const previewStyle = computed(() => {
 			const [vertical, horizontal] = normalizedPreviewInset.value;
 			return {
-				height: `${desiredViewportHeight.value + vertical * 2}px`,
+				height: `${resolvePreviewBoxHeight(desiredViewportHeight.value, vertical)}px`,
 				padding: vertical === horizontal ? `${vertical}px` : `${vertical}px ${horizontal}px`,
 				background: PLAYGROUND_RUNTIME_CANVAS_BACKGROUND
 			};
@@ -2210,6 +2430,7 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 			Alone.popup({
 				store,
 				copyValue: copyValue.value,
+				title: props.title,
 				viewport: props.viewport,
 				viewportOptions: props.viewportOptions,
 				previewOptions: popupPreviewOptions.value,
@@ -2219,7 +2440,6 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 				onNavigate: (to) => emit("navigate", to)
 			});
 		};
-		const handleView = (view) => emit("view-change", view);
 		const handleViewportChange = (viewport) => {
 			emit("viewport-change", viewport);
 		};
@@ -2244,6 +2464,11 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 			window.removeEventListener("resize", syncFrozenExpandedHeight);
 			handleClosePopup();
 		});
+		__expose({
+			refresh: handleInlineRefresh,
+			edit: handleEditor,
+			openPopup: handleOpenPopup
+		});
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("div", _hoisted_1$1, [__props.styleless ? (openBlock(), createElementBlock("div", {
 				key: 0,
@@ -2251,7 +2476,7 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 				ref: runtimeRoot,
 				class: "docs-playground-runtime--styleless",
 				style: normalizeStyle(stylelessStyle.value)
-			}, [errorText.value ? (openBlock(), createElementBlock("pre", _hoisted_2, toDisplayString(errorText.value), 1)) : createCommentVNode("v-if", true), createElementVNode("div", {
+			}, [errorText.value ? (openBlock(), createElementBlock("pre", _hoisted_2$1, toDisplayString(errorText.value), 1)) : createCommentVNode("v-if", true), createElementVNode("div", {
 				class: "docs-playground-runtime__viewport",
 				style: normalizeStyle(viewportStyle.value)
 			}, [createVNode(unref(Sandbox), {
@@ -2266,7 +2491,18 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 				ref: runtimeRoot,
 				class: "docs-playground-runtime"
 			}, [
-				createElementVNode("div", _hoisted_3, [createVNode(toolbar_default, {
+				!__props.hideChrome ? (openBlock(), createElementBlock("div", _hoisted_3$1, [displayTitle.value ? (openBlock(), createElementBlock("span", {
+					key: 0,
+					ref_key: "titleEl",
+					ref: titleEl,
+					class: "docs-playground__title",
+					id: titleId.value,
+					tabindex: "-1",
+					title: displayTitle.value
+				}, [createElementVNode("a", {
+					class: "docs-playground__title-anchor",
+					href: `#${titleId.value}`
+				}, "#", 8, _hoisted_5$1), createElementVNode("span", _hoisted_6, toDisplayString(displayTitle.value), 1)], 8, _hoisted_4$1)) : createCommentVNode("v-if", true), createVNode(toolbar_default, {
 					"copy-value": copyValue.value,
 					viewport: __props.viewport,
 					"viewport-options": __props.viewportOptions,
@@ -2279,22 +2515,12 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 					"copy-value",
 					"viewport",
 					"viewport-options"
-				]), __props.views.length > 1 ? (openBlock(), createElementBlock("div", _hoisted_4, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.views, (item) => {
-					return openBlock(), createElementBlock("button", {
-						key: item,
-						type: "button",
-						class: normalizeClass(["docs-playground__view", { "is-active": item === __props.activeView }]),
-						title: getViewText(item),
-						"aria-label": getViewText(item),
-						"aria-pressed": item === __props.activeView,
-						onClick: ($event) => handleView(item)
-					}, [createVNode(unref(icon_default), { name: item }, null, 8, ["name"])], 10, _hoisted_5);
-				}), 128))])) : createCommentVNode("v-if", true)]),
-				errorText.value ? (openBlock(), createElementBlock("pre", _hoisted_6, toDisplayString(errorText.value), 1)) : createCommentVNode("v-if", true),
+				])])) : createCommentVNode("v-if", true),
+				errorText.value ? (openBlock(), createElementBlock("pre", _hoisted_7, toDisplayString(errorText.value), 1)) : createCommentVNode("v-if", true),
 				createElementVNode("section", {
 					class: normalizeClass(["docs-playground__preview", { "is-expanded": previewExpanded.value }]),
 					style: normalizeStyle(previewStyle.value)
-				}, [createElementVNode("div", _hoisted_7, [createElementVNode("div", {
+				}, [createElementVNode("div", _hoisted_8, [createElementVNode("div", {
 					class: "docs-playground-runtime__viewport",
 					style: normalizeStyle(viewportStyle.value)
 				}, [(openBlock(), createBlock(unref(Sandbox), {
@@ -2314,7 +2540,7 @@ var runtime_default = /* @__PURE__ */ defineComponent({
 					title: expandLabel.value,
 					"aria-label": expandLabel.value,
 					onClick: handleTogglePreviewExpand
-				}, [createVNode(unref(icon_default), { name: "expand" })], 10, _hoisted_8)) : createCommentVNode("v-if", true)], 6)
+				}, [createVNode(unref(icon_default), { name: "expand" })], 10, _hoisted_9)) : createCommentVNode("v-if", true)], 6)
 			], 512))]);
 		};
 	}
@@ -2325,6 +2551,13 @@ var _hoisted_1 = {
 	key: 0,
 	class: "docs-playground__error"
 };
+var _hoisted_2 = {
+	key: 0,
+	class: "docs-playground__header"
+};
+var _hoisted_3 = ["id", "title"];
+var _hoisted_4 = ["href"];
+var _hoisted_5 = { class: "docs-playground__title-text" };
 //#endregion
 //#region packages/playground/src/playground.vue
 var playground_default = /* @__PURE__ */ defineComponent({
@@ -2342,7 +2575,13 @@ var playground_default = /* @__PURE__ */ defineComponent({
 		},
 		options: { default: () => ({}) },
 		previewInset: { default: 0 },
-		expand: { type: [Boolean, Number] },
+		expandable: { type: [Boolean, Number] },
+		title: { default: "" },
+		id: { default: "" },
+		previewScroller: {
+			type: Boolean,
+			default: false
+		},
 		previewOptions: {},
 		locale: {}
 	},
@@ -2366,6 +2605,8 @@ var playground_default = /* @__PURE__ */ defineComponent({
 		const sourceFiles = ref(initialFiles);
 		const currentEntry = ref(initialEntry);
 		const fileActiveFilename = ref(initialEntry);
+		const runtimeRef = ref(null);
+		const titleEl = ref(null);
 		const normalizeViews = (views) => {
 			const normalized = [];
 			for (const view of views) {
@@ -2376,12 +2617,25 @@ var playground_default = /* @__PURE__ */ defineComponent({
 			return normalized.length ? normalized : ["runtime"];
 		};
 		const normalizedViews = computed(() => normalizeViews(props.views));
+		const hasRuntimeView = computed(() => normalizedViews.value.includes("runtime"));
+		const hasFilesView = computed(() => normalizedViews.value.includes("files"));
 		const activeView = ref(normalizedViews.value[0]);
 		const runtimeActivated = ref(props.styleless || activeView.value === "runtime");
 		const normalizedViewportOptions = computed(() => normalizeViewportOptions(props.viewportOptions));
 		const activeViewport = ref(resolveInitialViewport(props.viewport, normalizedViewportOptions.value));
 		const selectableViewportOptions = computed(() => includeActiveViewport(normalizedViewportOptions.value, activeViewport.value));
 		const error = ref(props.entry && initialFiles[props.entry] === void 0 ? t("playground.validation.entryMissing", { filename: props.entry }) : "");
+		const displayTitle = computed(() => props.title.trim());
+		const titleId = computed(() => resolvePlaygroundTitleId(displayTitle.value, props.id, (candidate) => {
+			if (typeof document === "undefined") return false;
+			const existing = document.getElementById(candidate);
+			return !!existing && existing !== titleEl.value;
+		}));
+		const copyValue = computed(() => sourceFiles.value[currentEntry.value] || "");
+		/** runtime / 双视图始终有顶栏；files-only 仅有标题时渲染。 */
+		const showHeader = computed(() => hasRuntimeView.value || !!displayTitle.value);
+		const showToolbar = computed(() => hasRuntimeView.value);
+		const showRuntimeActions = computed(() => activeView.value === "runtime");
 		watch(locale, () => {
 			if (props.entry && sourceFiles.value[props.entry] === void 0) error.value = t("playground.validation.entryMissing", { filename: props.entry });
 		});
@@ -2395,6 +2649,15 @@ var playground_default = /* @__PURE__ */ defineComponent({
 			activeViewport.value = cloneViewport(viewport);
 			emit("update:viewport", cloneViewport(viewport));
 		};
+		const handleRefresh = () => {
+			runtimeRef.value?.refresh();
+		};
+		const handleEdit = () => {
+			runtimeRef.value?.edit();
+		};
+		const handleOpenPopup = () => {
+			runtimeRef.value?.openPopup();
+		};
 		const handleFileActive = (filename) => {
 			if (sourceFiles.value[filename] !== void 0) fileActiveFilename.value = filename;
 		};
@@ -2476,8 +2739,11 @@ var playground_default = /* @__PURE__ */ defineComponent({
 				options: __props.options,
 				"preview-options": __props.previewOptions,
 				"preview-inset": __props.previewInset,
-				expand: __props.expand,
+				"preview-scroller": __props.previewScroller,
+				expandable: __props.expandable,
 				styleless: true,
+				title: __props.title,
+				id: __props.id,
 				viewport: activeViewport.value,
 				"viewport-options": selectableViewportOptions.value,
 				onFilesChange: handleFilesChange,
@@ -2489,29 +2755,70 @@ var playground_default = /* @__PURE__ */ defineComponent({
 				"options",
 				"preview-options",
 				"preview-inset",
-				"expand",
+				"preview-scroller",
+				"expandable",
+				"title",
+				"id",
 				"viewport",
 				"viewport-options"
 			])) : (openBlock(), createElementBlock("div", {
 				key: 1,
 				class: normalizeClass(["docs-playground", { "docs-playground--files": activeView.value === "files" }])
-			}, [
-				error.value ? (openBlock(), createElementBlock("div", _hoisted_1, toDisplayString(error.value), 1)) : createCommentVNode("v-if", true),
-				runtimeActivated.value && normalizedViews.value.includes("runtime") ? withDirectives((openBlock(), createBlock(unref(runtime_default), {
+			}, [error.value ? (openBlock(), createElementBlock("div", _hoisted_1, toDisplayString(error.value), 1)) : (openBlock(), createElementBlock(Fragment, { key: 1 }, [
+				showHeader.value ? (openBlock(), createElementBlock("div", _hoisted_2, [displayTitle.value ? (openBlock(), createElementBlock("span", {
+					key: 0,
+					ref_key: "titleEl",
+					ref: titleEl,
+					class: "docs-playground__title",
+					id: titleId.value,
+					tabindex: "-1",
+					title: displayTitle.value
+				}, [createElementVNode("a", {
+					class: "docs-playground__title-anchor",
+					href: `#${titleId.value}`
+				}, "#", 8, _hoisted_4), createElementVNode("span", _hoisted_5, toDisplayString(displayTitle.value), 1)], 8, _hoisted_3)) : createCommentVNode("v-if", true), showToolbar.value ? (openBlock(), createBlock(toolbar_default, {
+					key: 1,
+					"copy-value": copyValue.value,
+					viewport: activeViewport.value,
+					"viewport-options": selectableViewportOptions.value,
+					views: normalizedViews.value,
+					"active-view": activeView.value,
+					"show-runtime-actions": showRuntimeActions.value,
+					"show-open-popup": hasRuntimeView.value,
+					onRefresh: handleRefresh,
+					onEdit: handleEdit,
+					onOpenPopup: handleOpenPopup,
+					onViewportChange: handleViewport,
+					onViewChange: handleView
+				}, null, 8, [
+					"copy-value",
+					"viewport",
+					"viewport-options",
+					"views",
+					"active-view",
+					"show-runtime-actions",
+					"show-open-popup"
+				])) : createCommentVNode("v-if", true)])) : createCommentVNode("v-if", true),
+				runtimeActivated.value && hasRuntimeView.value ? withDirectives((openBlock(), createBlock(unref(runtime_default), {
 					key: 1,
+					ref_key: "runtimeRef",
+					ref: runtimeRef,
 					files: sourceFiles.value,
 					entry: currentEntry.value,
 					options: __props.options,
 					"preview-options": __props.previewOptions,
 					"preview-inset": __props.previewInset,
-					expand: __props.expand,
+					"preview-scroller": __props.previewScroller,
+					expandable: __props.expandable,
+					"hide-chrome": true,
+					title: __props.title,
+					id: __props.id,
 					"active-view": activeView.value,
 					views: normalizedViews.value,
 					viewport: activeViewport.value,
 					"viewport-options": selectableViewportOptions.value,
 					onFilesChange: handleFilesChange,
 					onNavigate: _cache[1] || (_cache[1] = ($event) => emit("navigate", $event)),
-					onViewChange: handleView,
 					onViewportChange: handleViewport
 				}, null, 8, [
 					"files",
@@ -2519,31 +2826,33 @@ var playground_default = /* @__PURE__ */ defineComponent({
 					"options",
 					"preview-options",
 					"preview-inset",
-					"expand",
+					"preview-scroller",
+					"expandable",
+					"title",
+					"id",
 					"active-view",
 					"views",
 					"viewport",
 					"viewport-options"
-				])), [[vShow, !error.value && activeView.value === "runtime"]]) : createCommentVNode("v-if", true),
-				normalizedViews.value.includes("files") ? withDirectives((openBlock(), createBlock(unref(files_preview_default), {
+				])), [[vShow, activeView.value === "runtime"]]) : createCommentVNode("v-if", true),
+				hasFilesView.value ? withDirectives((openBlock(), createBlock(unref(files_preview_default), {
 					key: 2,
 					files: sourceFiles.value,
 					entry: currentEntry.value,
 					"active-filename": fileActiveFilename.value,
 					"active-view": activeView.value,
 					views: normalizedViews.value,
-					onActiveChange: handleFileActive,
-					onViewChange: handleView
+					onActiveChange: handleFileActive
 				}, null, 8, [
 					"files",
 					"entry",
 					"active-filename",
 					"active-view",
 					"views"
-				])), [[vShow, !error.value && activeView.value === "files"]]) : createCommentVNode("v-if", true)
-			], 2));
+				])), [[vShow, activeView.value === "files"]]) : createCommentVNode("v-if", true)
+			], 64))], 2));
 		};
 	}
 });
 //#endregion
-export { code_preview_default as CodePreview, DEFAULT_CDN_URL, Editor, playground_default as Playground, applyPlaygroundImportMapOverride, applyPlaygroundStyleOverride, clearPlaygroundMaps, createBuiltinImports, createBuiltinStyles, createRuntimePreviewOptions, getPlaygroundImportMapOverrides, getPlaygroundSiteModules, getPlaygroundSiteStyles, getPlaygroundStyleOverrides, highlightCode, highlightCodeByLanguage, isSafePlaygroundHref, normalizeCdnURL, registerVueHighlight, removePlaygroundImportMapOverride, removePlaygroundStyleOverride, resolveHighlightLanguage, setPlaygroundImportMapOverrides, setPlaygroundSiteModules, setPlaygroundSiteStyles, setPlaygroundStyleOverrides, vueHighlight };
+export { code_preview_default as CodePreview, DEFAULT_CDN_URL, Editor, PREVIEW_SCROLLER_USE_CODE, PREVIEW_SCROLL_CONTENT_CLASS, PREVIEW_SCROLL_HTML_CLASS, playground_default as Playground, applyPlaygroundImportMapOverride, applyPlaygroundStyleOverride, clearPlaygroundMaps, createBuiltinImports, createBuiltinStyles, createRuntimePreviewOptions, getPlaygroundImportMapOverrides, getPlaygroundSiteModules, getPlaygroundSiteStyles, getPlaygroundStyleOverrides, highlightCode, highlightCodeByLanguage, isSafePlaygroundHref, normalizeCdnURL, registerVueHighlight, removePlaygroundImportMapOverride, removePlaygroundStyleOverride, resolveHighlightLanguage, resolvePlaygroundTitleId, setPlaygroundImportMapOverrides, setPlaygroundSiteModules, setPlaygroundSiteStyles, setPlaygroundStyleOverrides, slugifyPlaygroundTitle, vueHighlight };