niuma-ui 2.1.3 → 2.1.5

package/CHANGELOG.md

@@ -6,6 +6,22 @@
 
 ## [Unreleased]
 
+## [2.1.5] - 2026-09-28
+
+### 变更
+
+- 发版：推到 `main` 后，**Release** 读取 changelog 第一条 `## [x.y.z]`（含 `x.y.z-beta.1` 这类预发布）。与 `package.json` 的 `version` 不一致则失败；`vX.Y.Z` 已存在则跳过。新版本先跑 `pnpm test` 和 `pnpm build`，再打附注 tag（说明是 `niuma-ui X.Y.Z` 加上该版本段落）。Actions 令牌推 tag 不会触发其它工作流，随后以 `workflow_dispatch` 启动 **Publish**（npm 与 GitHub Release）。同一提交的文档站仍由推 `main` 时的 **Deploy Docs** 部署。步骤见 `CONTRIBUTING.md`。
+
+### 修复
+
+- `RsMenu`：折叠后悬停弹出的子菜单，模板 ref 可能不是元素，`ResizeObserver.observe` 会抛错，浮层尺寸变化后不再重新摆放。ref 现在只保留 `HTMLElement`；定位和点击外部关闭也先确认是元素。
+
+## [2.1.4] - 2026-09-23
+
+### 变更
+
+- 文档站：组件页和指南页共用 `site-doc` 文章样式（眉题、标题、导语、小节）。演示、代码块、API / Token 表、翻页和首页卡片的圆角与底色走 `--site-panel-radius` / `--site-panel-bg`，暗色不再单独换成抬升表面。文档区背景跟首页画布，网格线走 `--site-home-grid`；暗色画布用 `--rs-bg`，网格为浅色细线。
+
 ## [2.1.3] - 2026-09-22
 
 ### 变更

package/dist/components/menu/src/RsMenuItems.impl.js

@@ -214,12 +214,16 @@ var RsMenuItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 			const themed = el.closest("[data-rs-theme]");
 			flyoutTheme.value = themed instanceof HTMLElement ? themed.dataset.rsTheme : void 0;
 		}
+		function setFlyoutEl(el) {
+			flyoutEl.value = el instanceof HTMLElement ? el : null;
+		}
 		function placeFlyout() {
 			if (typeof window === "undefined" || !flyoutKey.value) return;
 			const trigger = triggerEls.get(flyoutKey.value);
 			if (!trigger) return;
 			const anchor = trigger.getBoundingClientRect();
-			const measured = flyoutEl.value?.getBoundingClientRect();
+			const panel = flyoutEl.value;
+			const measured = panel instanceof HTMLElement ? panel.getBoundingClientRect() : void 0;
 			flyoutBox.value = placeSidePopup({
 				top: anchor.top,
 				left: anchor.left,
@@ -245,7 +249,7 @@ var RsMenuItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 			const target = event.target;
 			if (!(target instanceof Node)) return;
 			if ((flyoutKey.value ? triggerEls.get(flyoutKey.value) : null)?.contains(target)) return;
-			if (flyoutEl.value?.contains(target)) return;
+			if (flyoutEl.value instanceof HTMLElement && flyoutEl.value.contains(target)) return;
 			closeFlyout();
 		}
 		function onDocKeydown(event) {
@@ -291,10 +295,11 @@ var RsMenuItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 			syncFlyoutTheme(triggerEls.get(key) ?? null);
 			attachOverlay();
 			nextTick(() => {
-				if (flyoutEl.value && typeof ResizeObserver !== "undefined") {
+				const panel = flyoutEl.value;
+				if (panel instanceof HTMLElement && typeof ResizeObserver !== "undefined") {
 					panelResize?.disconnect();
 					panelResize = new ResizeObserver(() => requestPlace());
-					panelResize.observe(flyoutEl.value);
+					panelResize.observe(panel);
 				}
 				requestPlace();
 			});
@@ -540,8 +545,7 @@ var RsMenuItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 					to: portalTarget.value
 				}, [createElementVNode("section", {
 					ref_for: true,
-					ref_key: "flyoutEl",
-					ref: flyoutEl,
+					ref: setFlyoutEl,
 					class: "rs-menu__flyout",
 					"aria-label": item.label,
 					"data-rs-theme": flyoutTheme.value,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niuma-ui",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Vue 3 workbench design system — Rs* components, --rs-* tokens, optional Monaco / CodeMirror / xterm",