@xihan-ui/web-components 1.0.0-alpha.0 → 1.0.0-alpha.1

package/dist/define.js

@@ -1,9 +1,9 @@
-import { a as discoverParts, i as containsPart, o as wcNormalize, r as createSpreader, t as MachineController } from "./machine-controller-Bnr5jbhz.js";
+import { a as containsPart, i as PART_ATTR, o as discoverParts, r as createSpreader, s as wcNormalize, t as MachineController } from "./machine-controller-Cq9t_cfJ.js";
 import { t as defineElement } from "./registry-DR6I2_zF.js";
-import { n as version, t as XhReactiveElement } from "./element-xjYY5Oe2.js";
+import { n as version, t as XhReactiveElement } from "./element-BxtVEMuI.js";
 import { DIAGNOSTIC_CODES, createCounterIdGenerator, createRuntimeConfig, createScope, getDiagnostics, reportDiagnostic } from "@xihan-ui/kernel";
 import { ITEM_VALUE_ATTR, declaredItemDisabled, isItemDisabled } from "@xihan-ui/behavior";
-import { accordionAnatomy, accordionMachine, accordionMeta, affixAnatomy, affixMachine, affixMeta, alertAnatomy, alertMachine, alertMeta, anchorAnatomy, anchorMachine, anchorMeta, avatarAnatomy, avatarGroupAnatomy, avatarGroupMeta, avatarMachine, avatarMeta, backTopAnatomy, backTopMachine, backTopMeta, badgeAnatomy, badgeMeta, breadcrumbAnatomy, breadcrumbMeta, buttonAnatomy, buttonGroupAnatomy, buttonGroupMeta, buttonMeta, calendarAnatomy, calendarMachine, calendarMeta, cardAnatomy, cardMeta, carouselAnatomy, carouselMachine, carouselMeta, cascaderAnatomy, cascaderMachine, cascaderMeta, checkboxAnatomy, checkboxGroupAnatomy, checkboxGroupMachine, checkboxGroupMeta, checkboxMachine, checkboxMeta, clipboardAnatomy, clipboardMachine, clipboardMeta, codeBlockAnatomy, codeBlockMeta, collapsibleAnatomy, collapsibleMachine, collapsibleMeta, colorPickerAnatomy, colorPickerMachine, colorPickerMeta, colorPickerToChannel, colorPickerToInputChannel, comboboxAnatomy, comboboxMachine, comboboxMeta, composerAnatomy, composerMachine, composerMeta, connectAccordion, connectAffix, connectAlert, connectAnchor, connectAvatar, connectAvatarGroup, connectBackTop, connectBadge, connectBreadcrumb, connectButton, connectButtonGroup, connectCalendar, connectCard, connectCarousel, connectCascader, connectCheckbox, connectCheckboxGroup, connectClipboard, connectCodeBlock, connectCollapsible, connectColorPicker, connectCombobox, connectComposer, connectContextMenu, connectCountdown, connectDateField, connectDatePicker, connectDescriptions, connectDialog, connectDrawer, connectDynamicInput, connectEditable, connectEllipsis, connectEmptyState, connectField, connectFileUpload, connectFlex, connectFloatButton, connectForm, connectGradientText, connectGrid, connectHighlight, connectHoverCard, connectIcon, connectIconWrapper, connectImage, connectInfiniteScroll, connectLayout, connectList, connectListbox, connectLoadingBar, connectLog, connectMarquee, connectMention, connectMenu, connectMenubar, connectNavigationMenu, connectNumberAnimation, connectNumberField, connectPageHeader, connectPagination, connectPinInput, connectPopconfirm, connectPopover, connectPopselect, connectProgress, connectQrCode, connectRadioGroup, connectRating, connectResult, connectScrollArea, connectSelect, connectSeparator, connectSkeleton, connectSlider, connectSpinner, connectSplitter, connectStatistic, connectSteps, connectSwitch, connectTable, connectTabs, connectTagsInput, connectTextField, connectThread, connectTime, connectTimeField, connectTimePicker, connectTimeline, connectToast, connectToaster, connectToggle, connectToggleGroup, connectToolbar, connectTooltip, connectTour, connectTransfer, connectTree, connectTreeSelect, connectTypography, connectVirtualizer, connectWatermark, contextMenuAnatomy, contextMenuMachine, contextMenuMeta, countdownAnatomy, countdownMachine, countdownMeta, dateFieldAnatomy, dateFieldMachine, dateFieldMeta, datePickerAnatomy, datePickerCalendarProps, datePickerFieldEndProps, datePickerFieldProps, datePickerMachine, datePickerMeta, descriptionsAnatomy, descriptionsMeta, dialogAnatomy, dialogMachine, dialogMeta, drawerAnatomy, drawerMachine, drawerMeta, dynamicInputAnatomy, dynamicInputMachine, dynamicInputMeta, editableAnatomy, editableMachine, editableMeta, ellipsisAnatomy, ellipsisMachine, ellipsisMeta, emptyStateAnatomy, emptyStateMeta, fieldAnatomy, fieldMeta, fileUploadAnatomy, fileUploadMachine, fileUploadMeta, flexAnatomy, flexMeta, floatButtonAnatomy, floatButtonMeta, formAnatomy, formMachine, formMeta, gradientTextAnatomy, gradientTextMeta, gridAnatomy, gridMeta, highlightAnatomy, highlightMeta, hoverCardAnatomy, hoverCardMachine, hoverCardMeta, iconAnatomy, iconMeta, iconWrapperAnatomy, iconWrapperMeta, imageAnatomy, imageMachine, imageMeta, infiniteScrollAnatomy, infiniteScrollMachine, infiniteScrollMeta, layoutAnatomy, layoutMachine, layoutMeta, listAnatomy, listMeta, listboxAnatomy, listboxMachine, listboxMeta, loadingBarAnatomy, loadingBarMachine, loadingBarMeta, logAnatomy, logMeta, marqueeAnatomy, marqueeMeta, mentionAnatomy, mentionMachine, mentionMeta, menuAnatomy, menuMachine, menuMeta, menubarAnatomy, menubarMachine, menubarMeta, navigationMenuAnatomy, navigationMenuMachine, navigationMenuMeta, numberAnimationAnatomy, numberAnimationMachine, numberAnimationMeta, numberFieldAnatomy, numberFieldMachine, numberFieldMeta, pageHeaderAnatomy, pageHeaderMeta, paginationAnatomy, paginationMachine, paginationMeta, pinInputAnatomy, pinInputMachine, pinInputMeta, popconfirmAnatomy, popconfirmMeta, popoverAnatomy, popoverMachine, popoverMeta, popselectAnatomy, popselectMeta, progressAnatomy, progressMeta, qrCodeAnatomy, qrCodeMeta, radioGroupAnatomy, radioGroupMachine, radioGroupMeta, ratingAnatomy, ratingMachine, ratingMeta, resultAnatomy, resultMeta, scrollAreaAnatomy, scrollAreaMachine, scrollAreaMeta, selectAnatomy, selectMachine, selectMeta, separatorAnatomy, separatorMeta, skeletonAnatomy, skeletonMeta, sliderAnatomy, sliderMachine, sliderMeta, spinnerAnatomy, spinnerMeta, splitterAnatomy, splitterMachine, splitterMeta, statisticAnatomy, statisticMeta, stepsAnatomy, stepsMachine, stepsMeta, switchAnatomy, switchMachine, switchMeta, tableAnatomy, tableMachine, tableMeta, tabsAnatomy, tabsMachine, tabsMeta, tagsInputAnatomy, tagsInputMachine, tagsInputMeta, textFieldAnatomy, textFieldMachine, textFieldMeta, threadAnatomy, threadMachine, threadMeta, timeAnatomy, timeFieldAnatomy, timeFieldMachine, timeFieldMeta, timeMeta, timePickerAnatomy, timePickerMachine, timePickerMeta, timelineAnatomy, timelineMeta, toastAnatomy, toastMachine, toastMeta, toasterAnatomy, toasterMachine, toasterMeta, toggleAnatomy, toggleGroupAnatomy, toggleGroupMachine, toggleGroupMeta, toggleMachine, toggleMeta, toolbarAnatomy, toolbarMachine, toolbarMeta, tooltipAnatomy, tooltipMachine, tooltipMeta, tourAnatomy, tourMachine, tourMeta, transferAnatomy, transferFocusKey, transferMachine, transferMeta, treeAnatomy, treeMachine, treeMeta, treeSelectAnatomy, treeSelectMachine, treeSelectMeta, typographyAnatomy, typographyMeta, virtualizerAnatomy, virtualizerMachine, virtualizerMeta, watermarkAnatomy, watermarkMeta } from "@xihan-ui/headless";
+import { accordionAnatomy, accordionMachine, accordionMeta, affixAnatomy, affixMachine, affixMeta, alertAnatomy, alertMachine, alertMeta, anchorAnatomy, anchorMachine, anchorMeta, autoSizeTextarea, avatarAnatomy, avatarGroupAnatomy, avatarGroupMeta, avatarMachine, avatarMeta, backTopAnatomy, backTopMachine, backTopMeta, badgeAnatomy, badgeMeta, breadcrumbAnatomy, breadcrumbMeta, buttonAnatomy, buttonGroupAnatomy, buttonGroupMeta, buttonMeta, calendarAnatomy, calendarMachine, calendarMeta, cardAnatomy, cardMeta, carouselAnatomy, carouselMachine, carouselMeta, cascaderAnatomy, cascaderMachine, cascaderMeta, checkboxAnatomy, checkboxGroupAnatomy, checkboxGroupMachine, checkboxGroupMeta, checkboxMachine, checkboxMeta, clipboardAnatomy, clipboardMachine, clipboardMeta, codeBlockAnatomy, codeBlockMeta, collapsibleAnatomy, collapsibleMachine, collapsibleMeta, colorPickerAnatomy, colorPickerMachine, colorPickerMeta, colorPickerToChannel, colorPickerToInputChannel, comboboxAnatomy, comboboxMachine, comboboxMeta, composerAnatomy, composerMachine, composerMeta, connectAccordion, connectAffix, connectAlert, connectAnchor, connectAvatar, connectAvatarGroup, connectBackTop, connectBadge, connectBreadcrumb, connectButton, connectButtonGroup, connectCalendar, connectCard, connectCarousel, connectCascader, connectCheckbox, connectCheckboxGroup, connectClipboard, connectCodeBlock, connectCollapsible, connectColorPicker, connectCombobox, connectComposer, connectContextMenu, connectCountdown, connectDateField, connectDatePicker, connectDescriptions, connectDialog, connectDrawer, connectDynamicInput, connectEditable, connectEllipsis, connectEmptyState, connectField, connectFileUpload, connectFlex, connectFloatButton, connectForm, connectGradientText, connectGrid, connectHighlight, connectHoverCard, connectIcon, connectIconWrapper, connectImage, connectImageViewer, connectInfiniteScroll, connectLayout, connectList, connectListbox, connectLoadingBar, connectLog, connectMarquee, connectMention, connectMenu, connectMenubar, connectNavigationMenu, connectNumberAnimation, connectNumberField, connectPageHeader, connectPagination, connectPinInput, connectPopconfirm, connectPopover, connectPopselect, connectProgress, connectQrCode, connectRadioGroup, connectRating, connectResult, connectScrollArea, connectSelect, connectSeparator, connectSideNav, connectSkeleton, connectSlider, connectSpinner, connectSplitter, connectStatistic, connectSteps, connectSwitch, connectTable, connectTabs, connectTagsInput, connectTextField, connectThread, connectTime, connectTimeField, connectTimePicker, connectTimeline, connectToast, connectToaster, connectToggle, connectToggleGroup, connectToolbar, connectTooltip, connectTour, connectTransfer, connectTree, connectTreeSelect, connectTypography, connectVirtualizer, connectWatermark, contextMenuAnatomy, contextMenuMachine, contextMenuMeta, countdownAnatomy, countdownMachine, countdownMeta, dateFieldAnatomy, dateFieldMachine, dateFieldMeta, datePickerAnatomy, datePickerCalendarProps, datePickerFieldEndProps, datePickerFieldProps, datePickerMachine, datePickerMeta, descriptionsAnatomy, descriptionsMeta, dialogAnatomy, dialogMachine, dialogMeta, drawerAnatomy, drawerMachine, drawerMeta, dynamicInputAnatomy, dynamicInputMachine, dynamicInputMeta, editableAnatomy, editableMachine, editableMeta, ellipsisAnatomy, ellipsisMachine, ellipsisMeta, emptyStateAnatomy, emptyStateMeta, fieldAnatomy, fieldMeta, fileUploadAnatomy, fileUploadMachine, fileUploadMeta, flexAnatomy, flexMeta, floatButtonAnatomy, floatButtonMeta, formAnatomy, formMachine, formMeta, gradientTextAnatomy, gradientTextMeta, gridAnatomy, gridMeta, highlightAnatomy, highlightMeta, hoverCardAnatomy, hoverCardMachine, hoverCardMeta, iconAnatomy, iconMeta, iconWrapperAnatomy, iconWrapperMeta, imageAnatomy, imageMachine, imageMeta, imageViewerAnatomy, imageViewerCounterText, imageViewerMachine, imageViewerMeta, infiniteScrollAnatomy, infiniteScrollMachine, infiniteScrollMeta, layoutAnatomy, layoutMachine, layoutMeta, listAnatomy, listMeta, listboxAnatomy, listboxMachine, listboxMeta, loadingBarAnatomy, loadingBarMachine, loadingBarMeta, logAnatomy, logMeta, marqueeAnatomy, marqueeMeta, mentionAnatomy, mentionMachine, mentionMeta, menuAnatomy, menuMachine, menuMeta, menubarAnatomy, menubarMachine, menubarMeta, navigationMenuAnatomy, navigationMenuMachine, navigationMenuMeta, numberAnimationAnatomy, numberAnimationMachine, numberAnimationMeta, numberFieldAnatomy, numberFieldMachine, numberFieldMeta, pageHeaderAnatomy, pageHeaderMeta, paginationAnatomy, paginationMachine, paginationMeta, pinInputAnatomy, pinInputMachine, pinInputMeta, popconfirmAnatomy, popconfirmMeta, popoverAnatomy, popoverMachine, popoverMeta, popselectAnatomy, popselectInitialFocus, popselectMeta, progressAnatomy, progressMeta, qrCodeAnatomy, qrCodeMeta, radioGroupAnatomy, radioGroupMachine, radioGroupMeta, ratingAnatomy, ratingMachine, ratingMeta, resultAnatomy, resultMeta, scrollAreaAnatomy, scrollAreaMachine, scrollAreaMeta, selectAnatomy, selectMachine, selectMeta, separatorAnatomy, separatorMeta, sideNavAnatomy, sideNavMachine, sideNavMeta, skeletonAnatomy, skeletonMeta, sliderAnatomy, sliderMachine, sliderMeta, spinnerAnatomy, spinnerMeta, splitterAnatomy, splitterMachine, splitterMeta, statisticAnatomy, statisticMeta, stepsAnatomy, stepsMachine, stepsMeta, switchAnatomy, switchMachine, switchMeta, tableAnatomy, tableMachine, tableMeta, tabsAnatomy, tabsMachine, tabsMeta, tagsInputAnatomy, tagsInputMachine, tagsInputMeta, textFieldAnatomy, textFieldMachine, textFieldMeta, threadAnatomy, threadMachine, threadMeta, timeAnatomy, timeFieldAnatomy, timeFieldMachine, timeFieldMeta, timeMeta, timePickerAnatomy, timePickerMachine, timePickerMeta, timelineAnatomy, timelineMeta, toastAnatomy, toastMachine, toastMeta, toasterAnatomy, toasterMachine, toasterMeta, toggleAnatomy, toggleGroupAnatomy, toggleGroupMachine, toggleGroupMeta, toggleMachine, toggleMeta, toolbarAnatomy, toolbarMachine, toolbarMeta, tooltipAnatomy, tooltipMachine, tooltipMeta, tourAnatomy, tourMachine, tourMeta, transferAnatomy, transferFocusKey, transferMachine, transferMeta, treeAnatomy, treeMachine, treeMeta, treeSelectAnatomy, treeSelectMachine, treeSelectMeta, typographyAnatomy, typographyMeta, virtualizerAnatomy, virtualizerMachine, virtualizerMeta, watermarkAnatomy, watermarkMeta } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 import { createHighlighter } from "@xihan-ui/code-highlight";
 //#region src/dom/part-contract.ts
@@ -302,7 +302,7 @@ var XhAccordionElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/affix.ts
-const NUMBER_CONVERTER$49 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const NUMBER_CONVERTER$50 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 /**
 * `<xh-affix>` —— 吸附行为宿主：滚过判定线就把 content 钉在滚动容器可视区的边上。
 *
@@ -325,11 +325,11 @@ var XhAffixElement = class extends XhElement {
 	};
 	static properties = {
 		topOffset: {
-			converter: NUMBER_CONVERTER$49,
+			converter: NUMBER_CONVERTER$50,
 			attribute: "offset-top"
 		},
 		bottomOffset: {
-			converter: NUMBER_CONVERTER$49,
+			converter: NUMBER_CONVERTER$50,
 			attribute: "offset-bottom"
 		},
 		target: { attribute: false }
@@ -430,9 +430,9 @@ var XhAlertElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/anchor.ts
-const STRING_CONVERTER$79 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$48 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$50 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$80 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$49 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$52 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-anchor>` —— 锚点导航行为宿主，激活项由机器的滚动观察器结算，
 * 目标区块按 link 上的 value 属性（或 targets 清单）里的 id 现查。
@@ -463,20 +463,20 @@ var XhAnchorElement = class extends XhElement {
 		meta: anchorMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$79 },
+		value: { converter: STRING_CONVERTER$80 },
 		defaultValue: {
-			converter: STRING_CONVERTER$79,
+			converter: STRING_CONVERTER$80,
 			attribute: "default-value"
 		},
-		offset: { converter: NUMBER_CONVERTER$48 },
-		smooth: { converter: BOOLEAN_CONVERTER$50 },
-		orientation: { converter: STRING_CONVERTER$79 },
+		offset: { converter: NUMBER_CONVERTER$49 },
+		smooth: { converter: BOOLEAN_CONVERTER$52 },
+		orientation: { converter: STRING_CONVERTER$80 },
 		direction: {
-			converter: STRING_CONVERTER$79,
+			converter: STRING_CONVERTER$80,
 			attribute: "dir"
 		},
-		tone: { converter: STRING_CONVERTER$79 },
-		size: { converter: STRING_CONVERTER$79 },
+		tone: { converter: STRING_CONVERTER$80 },
+		size: { converter: STRING_CONVERTER$80 },
 		targets: { attribute: false },
 		translations: { attribute: false },
 		scrollElement: { attribute: false }
@@ -531,7 +531,7 @@ var XhAnchorElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/avatar.ts
-const STRING_CONVERTER$78 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$79 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-avatar>` —— 头像行为宿主，src/alt 写进 image 节点，加载成败回送机器，image 与 fallback 互斥显隐。
 *
@@ -550,9 +550,9 @@ var XhAvatarElement = class extends XhElement {
 		meta: avatarMeta
 	};
 	static properties = {
-		src: { converter: STRING_CONVERTER$78 },
-		alt: { converter: STRING_CONVERTER$78 },
-		size: { converter: STRING_CONVERTER$78 }
+		src: { converter: STRING_CONVERTER$79 },
+		alt: { converter: STRING_CONVERTER$79 },
+		size: { converter: STRING_CONVERTER$79 }
 	};
 	notify = (details) => {
 		this.dispatchEvent(new CustomEvent("status-change", {
@@ -631,8 +631,8 @@ var XhAvatarGroupElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/back-top.ts
-const STRING_CONVERTER$77 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$47 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const STRING_CONVERTER$78 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$48 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 /**
 * `<xh-back-top>` —— 回到顶部行为宿主：滚动量过线时露出按钮，点它滚回顶部。
 *
@@ -656,12 +656,12 @@ var XhBackTopElement = class extends XhElement {
 	};
 	static properties = {
 		visibilityHeight: {
-			converter: NUMBER_CONVERTER$47,
+			converter: NUMBER_CONVERTER$48,
 			attribute: "visibility-height"
 		},
-		behavior: { converter: STRING_CONVERTER$77 },
-		tone: { converter: STRING_CONVERTER$77 },
-		size: { converter: STRING_CONVERTER$77 },
+		behavior: { converter: STRING_CONVERTER$78 },
+		tone: { converter: STRING_CONVERTER$78 },
+		size: { converter: STRING_CONVERTER$78 },
 		translations: { attribute: false },
 		target: { attribute: false }
 	};
@@ -732,7 +732,7 @@ var XhBadgeElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/breadcrumb.ts
-const STRING_CONVERTER$76 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$77 = { fromAttribute: (v) => v ?? void 0 };
 /** 读作者写在角色节点上的布尔声明：属性缺席或 ="false" 为假，其余为真。 */
 function authorFlag$1(el, name) {
 	const raw = el.getAttribute(name);
@@ -762,11 +762,11 @@ var XhBreadcrumbElement = class extends XhElement {
 	};
 	static properties = {
 		direction: {
-			converter: STRING_CONVERTER$76,
+			converter: STRING_CONVERTER$77,
 			attribute: "dir"
 		},
-		tone: { converter: STRING_CONVERTER$76 },
-		size: { converter: STRING_CONVERTER$76 },
+		tone: { converter: STRING_CONVERTER$77 },
+		size: { converter: STRING_CONVERTER$77 },
 		translations: { attribute: false }
 	};
 	wire() {
@@ -872,7 +872,7 @@ var XhButtonGroupElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/calendar.ts
-const STRING_CONVERTER$75 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$76 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-calendar>` —— 日历行为宿主。
 *
@@ -916,32 +916,32 @@ var XhCalendarElement = class extends XhElement {
 		meta: calendarMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$75 },
+		value: { converter: STRING_CONVERTER$76 },
 		defaultValue: {
-			converter: STRING_CONVERTER$75,
+			converter: STRING_CONVERTER$76,
 			attribute: "default-value"
 		},
 		selectionMode: {
-			converter: STRING_CONVERTER$75,
+			converter: STRING_CONVERTER$76,
 			attribute: "selection-mode"
 		},
 		focusedValue: {
-			converter: STRING_CONVERTER$75,
+			converter: STRING_CONVERTER$76,
 			attribute: "focused-value"
 		},
 		defaultFocusedValue: {
-			converter: STRING_CONVERTER$75,
+			converter: STRING_CONVERTER$76,
 			attribute: "default-focused-value"
 		},
-		min: { converter: STRING_CONVERTER$75 },
-		max: { converter: STRING_CONVERTER$75 },
-		locale: { converter: STRING_CONVERTER$75 },
+		min: { converter: STRING_CONVERTER$76 },
+		max: { converter: STRING_CONVERTER$76 },
+		locale: { converter: STRING_CONVERTER$76 },
 		timeZone: {
-			converter: STRING_CONVERTER$75,
+			converter: STRING_CONVERTER$76,
 			attribute: "time-zone"
 		},
 		weekdayFormat: {
-			converter: STRING_CONVERTER$75,
+			converter: STRING_CONVERTER$76,
 			attribute: "weekday-format"
 		},
 		disabled: { type: Boolean },
@@ -1089,9 +1089,9 @@ var XhCardElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/carousel.ts
-const STRING_CONVERTER$74 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$46 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$49 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$75 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$47 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$51 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * autoplay 布尔或毫秒两用：缺席 = undefined，`autoplay` / `autoplay="true"` = 默认间隔，
 * `autoplay="false"` = 关，`autoplay="3000"` = 3 秒一张，念不成数的串按开着处理。
@@ -1145,35 +1145,35 @@ var XhCarouselElement = class extends XhElement {
 		meta: carouselMeta
 	};
 	static properties = {
-		page: { converter: NUMBER_CONVERTER$46 },
+		page: { converter: NUMBER_CONVERTER$47 },
 		defaultPage: {
-			converter: NUMBER_CONVERTER$46,
+			converter: NUMBER_CONVERTER$47,
 			attribute: "default-page"
 		},
 		slideCount: {
-			converter: NUMBER_CONVERTER$46,
+			converter: NUMBER_CONVERTER$47,
 			attribute: "slide-count"
 		},
 		slidesPerPage: {
-			converter: NUMBER_CONVERTER$46,
+			converter: NUMBER_CONVERTER$47,
 			attribute: "slides-per-page"
 		},
 		slidesPerMove: {
-			converter: NUMBER_CONVERTER$46,
+			converter: NUMBER_CONVERTER$47,
 			attribute: "slides-per-move"
 		},
-		orientation: { converter: STRING_CONVERTER$74 },
+		orientation: { converter: STRING_CONVERTER$75 },
 		direction: {
-			converter: STRING_CONVERTER$74,
+			converter: STRING_CONVERTER$75,
 			attribute: "dir"
 		},
-		loop: { converter: BOOLEAN_CONVERTER$49 },
+		loop: { converter: BOOLEAN_CONVERTER$51 },
 		autoplay: { converter: AUTOPLAY_CONVERTER },
 		allowPointerDrag: {
-			converter: BOOLEAN_CONVERTER$49,
+			converter: BOOLEAN_CONVERTER$51,
 			attribute: "allow-pointer-drag"
 		},
-		spacing: { converter: STRING_CONVERTER$74 },
+		spacing: { converter: STRING_CONVERTER$75 },
 		translations: { attribute: false }
 	};
 	notify = (details) => {
@@ -1223,9 +1223,9 @@ var XhCarouselElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/cascader.ts
-const STRING_CONVERTER$73 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$45 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$48 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$74 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$46 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$50 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /** 条目一系的归属容器：文本与勾选标记向上找最近的那个条目。 */
 const ITEM_SELECTOR$4 = "[data-xh-part=\"item\"]";
 /**
@@ -1251,6 +1251,9 @@ const ITEM_SELECTOR$4 = "[data-xh-part=\"item\"]";
 * @attr {'click'|'hover'} expand-trigger - 子列由点还是悬停展开，默认 click
 * @attr {boolean} change-on-select - 中间层（分支）也能落值
 * @attr {boolean} multiple - 多选：选中后浮层不收起，焦点留在列里
+* @attr {boolean} searchable - 开启搜索：input 部件可用，输入后整条路径连缀过滤、候选替换列视图
+* @attr {boolean} cascade - 多选下父子级联勾选（整枝传导/半选/禁用冻结），默认 false
+* @attr {string} checked-strategy - 级联下对外值的收敛策略：child（默认）/ parent / all
 * @attr {boolean} disabled - 整个控件禁用：trigger 用原生 disabled，浮层展不开
 * @attr {boolean} read-only - 只读：浮层照常展开、列照常浏览，但选中值改不动、也清不掉
 * @attr {boolean} invalid - 校验失败标注
@@ -1272,7 +1275,11 @@ const ITEM_SELECTOR$4 = "[data-xh-part=\"item\"]";
 * @csspart indicator - 展开指示符（aria-hidden，data-state 随开合）
 * @csspart clear-trigger - 清空按钮，须是原生 button；不占 Tab 位且对读屏隐藏
 * @csspart positioner - 浮层定位容器，坐标由引擎写成内联样式
-* @csspart content - 浮层壳（焦点域与消解层的根节点），键盘在此收口，收起时带 hidden
+* @csspart content - 浮层壳（焦点域与消解层的根节点），键盘在此收口，收起时带 hidden；根列没有条目时带 data-empty
+* @csspart input - 搜索框（content 顶部）；没开 searchable 时带 hidden。上下键走候选、Enter 选中、Escape 先清词
+* @csspart search-list - 候选列表容器；不在搜索视图时带 hidden，无候选时带 data-empty
+* @csspart search-item - 一条候选，须用 value 属性写整条路径的 JSON 数组串（如 value='["a","b"]'）；词换了不匹配的带 hidden
+* @csspart empty - 空态占位：搜索无候选或 collection 为空时露面，其余时候带 hidden。标记里没写就由元素在 content 末尾补一个并填缺省文案；写了就用作者那份，文案也归作者
 * @csspart column - role=listbox 的一列，须自带 level 属性标识它是第几列；砍掉时带 hidden
 * @csspart item - role=option 的条目，须自带 value 属性标识身份；不在当前列里时带 hidden
 * @csspart item-text - 条目文本
@@ -1287,36 +1294,43 @@ var XhCascaderElement = class extends XhElement {
 		collection: { attribute: false },
 		value: { attribute: false },
 		defaultValue: { attribute: false },
-		open: { converter: BOOLEAN_CONVERTER$48 },
+		open: { converter: BOOLEAN_CONVERTER$50 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
 		expandTrigger: {
-			converter: STRING_CONVERTER$73,
+			converter: STRING_CONVERTER$74,
 			attribute: "expand-trigger"
 		},
 		changeOnSelect: {
-			converter: BOOLEAN_CONVERTER$48,
+			converter: BOOLEAN_CONVERTER$50,
 			attribute: "change-on-select"
 		},
 		multiple: { type: Boolean },
+		searchable: { type: Boolean },
+		cascade: { type: Boolean },
+		checkedStrategy: {
+			converter: STRING_CONVERTER$74,
+			attribute: "checked-strategy"
+		},
 		disabled: { type: Boolean },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$48,
+			converter: BOOLEAN_CONVERTER$50,
 			attribute: "read-only"
 		},
-		invalid: { converter: BOOLEAN_CONVERTER$48 },
-		variant: { converter: STRING_CONVERTER$73 },
-		tone: { converter: STRING_CONVERTER$73 },
-		size: { converter: STRING_CONVERTER$73 },
-		placeholder: { converter: STRING_CONVERTER$73 },
-		separator: { converter: STRING_CONVERTER$73 },
-		placement: { converter: STRING_CONVERTER$73 },
-		offset: { converter: NUMBER_CONVERTER$45 },
-		loop: { converter: BOOLEAN_CONVERTER$48 },
+		invalid: { converter: BOOLEAN_CONVERTER$50 },
+		variant: { converter: STRING_CONVERTER$74 },
+		tone: { converter: STRING_CONVERTER$74 },
+		size: { converter: STRING_CONVERTER$74 },
+		placeholder: { converter: STRING_CONVERTER$74 },
+		separator: { converter: STRING_CONVERTER$74 },
+		translations: { attribute: false },
+		placement: { converter: STRING_CONVERTER$74 },
+		offset: { converter: NUMBER_CONVERTER$46 },
+		loop: { converter: BOOLEAN_CONVERTER$50 },
 		direction: {
-			converter: STRING_CONVERTER$73,
+			converter: STRING_CONVERTER$74,
 			attribute: "dir"
 		}
 	};
@@ -1326,6 +1340,8 @@ var XhCascaderElement = class extends XhElement {
 	config = null;
 	/** value-text 是否归元素填：首次见到该节点时定，之后不再回读（回读到的会是自己写的字）。 */
 	ownsValueText = /* @__PURE__ */ new WeakMap();
+	/** 空态占位的文案是否归元素填，判定同 ownsValueText。 */
+	ownsEmptyText = /* @__PURE__ */ new WeakMap();
 	notifyValue = (details) => {
 		this.dispatchEvent(new CustomEvent("value-change", {
 			detail: details,
@@ -1354,6 +1370,9 @@ var XhCascaderElement = class extends XhElement {
 			expandTrigger: this.expandTrigger,
 			changeOnSelect: this.changeOnSelect ?? false,
 			multiple: this.multiple ?? false,
+			searchable: this.searchable ?? false,
+			cascade: this.cascade,
+			checkedStrategy: this.checkedStrategy,
 			disabled: this.disabled ?? false,
 			readOnly: this.readOnly ?? false,
 			invalid: this.invalid ?? false,
@@ -1366,6 +1385,7 @@ var XhCascaderElement = class extends XhElement {
 			offset: this.offset,
 			loop: this.loop,
 			dir: this.direction,
+			translations: this.translations,
 			onValueChange: this.notifyValue,
 			onOpenChange: this.notifyOpen
 		};
@@ -1434,16 +1454,30 @@ var XhCascaderElement = class extends XhElement {
 	stripNativeDisabled(el) {
 		if (el.hasAttribute("disabled")) el.removeAttribute("disabled");
 	}
-	/** 把整条路径的文字填进 value-text；首次见到该节点时若已有内容则判为归作者，之后一概不碰。 */
-	fillValueText(el, text) {
-		let owned = this.ownsValueText.get(el);
+	/** 把文字填进角色节点；首次见到该节点时若已有内容则判为归作者，之后一概不碰。 */
+	fillOwnedText(owns, el, text) {
+		let owned = owns.get(el);
 		if (owned === void 0) {
 			owned = (el.textContent ?? "").trim() === "";
-			this.ownsValueText.set(el, owned);
+			owns.set(el, owned);
 		}
 		if (!owned || el.textContent === text) return;
 		el.textContent = text;
 	}
+	/**
+	* 取空态占位；标记里没写就在 content 末尾补一个，位置与 Vue 侧一致。
+	* 作者写了就用作者那份，只接线不新建。补出来的节点下一轮由 discoverParts 收进 partMap。
+	*/
+	ensureEmpty() {
+		const existing = this.getPart("empty");
+		if (existing) return existing;
+		const content = this.getPart("content");
+		if (!content) return null;
+		const el = this.ownerDocument.createElement("div");
+		el.setAttribute(PART_ATTR, "empty");
+		content.append(el);
+		return el;
+	}
 	wire() {
 		const api = connectCascader(this.ctrl.service, wcNormalize);
 		const put = (name, props) => {
@@ -1457,10 +1491,28 @@ var XhCascaderElement = class extends XhElement {
 		put("clear-trigger", api.getClearTriggerProps());
 		put("positioner", api.getPositionerProps());
 		put("content", api.getContentProps());
+		put("input", api.getInputProps());
+		put("search-list", api.getSearchListProps());
+		const empty = this.ensureEmpty();
+		if (empty) {
+			this.spreader.spread(empty, api.getEmptyProps());
+			this.fillOwnedText(this.ownsEmptyText, empty, api.searching ? api.translations.noMatch : api.translations.empty);
+		}
+		for (const el of this.getParts("search-item")) {
+			const raw = el.getAttribute("value") ?? "[]";
+			let path = [];
+			try {
+				const parsed = JSON.parse(raw);
+				if (Array.isArray(parsed)) path = parsed.map(String);
+			} catch {
+				path = [];
+			}
+			this.spreader.spread(el, api.getSearchItemProps({ path }));
+		}
 		const valueText = this.getPart("value-text");
 		if (valueText) {
 			this.spreader.spread(valueText, api.getValueTextProps());
-			this.fillValueText(valueText, api.displayText);
+			this.fillOwnedText(this.ownsValueText, valueText, api.displayText);
 		}
 		this.getParts("column").forEach((el, position) => {
 			this.spreader.spread(el, api.getColumnProps({ level: this.levelOf(el, position) }));
@@ -1496,6 +1548,8 @@ var XhCascaderElement = class extends XhElement {
 * @fires checked-change - checked 状态变化；detail 为 `{ checked: boolean }`
 * @csspart root - role=checkbox 的按钮（承载 aria-checked / data-state）
 * @csspart indicator - 选中标记
+* @attr {string} name - 表单字段名；给了 hidden-input 才参与提交
+* @csspart hidden-input - type=hidden 的表单出口，省略该节点即不参与表单
 */
 var XhCheckboxElement = class extends XhElement {
 	static partContract = {
@@ -1509,6 +1563,8 @@ var XhCheckboxElement = class extends XhElement {
 			converter: { fromAttribute: (v) => v === null ? void 0 : v === "indeterminate" ? "indeterminate" : v !== "false" }
 		},
 		disabled: { type: Boolean },
+		name: { converter: { fromAttribute: (v) => v ?? void 0 } },
+		value: { converter: { fromAttribute: (v) => v ?? void 0 } },
 		tone: {},
 		size: {}
 	};
@@ -1527,6 +1583,8 @@ var XhCheckboxElement = class extends XhElement {
 			disabled: this.disabled ?? false,
 			tone: this.tone,
 			size: this.size,
+			name: this.name,
+			value: this.value,
 			onCheckedChange: this.notify
 		};
 	}
@@ -1536,6 +1594,8 @@ var XhCheckboxElement = class extends XhElement {
 		if (root) this.spreader.spread(root, api.getRootProps());
 		const indicator = this.getPart("indicator");
 		if (indicator) this.spreader.spread(indicator, api.getIndicatorProps());
+		const hidden = this.getPart("hidden-input");
+		if (hidden) this.spreader.spread(hidden, api.getHiddenInputProps());
 	}
 };
 //#endregion
@@ -1555,12 +1615,12 @@ function createDeclaredDisabled() {
 }
 //#endregion
 //#region src/elements/checkbox-group.ts
-const STRING_CONVERTER$72 = { fromAttribute: (v) => v ?? void 0 };
-const BOOLEAN_CONVERTER$47 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$73 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$49 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 const LIST_CONVERTER = { fromAttribute: (v) => v === null ? void 0 : v.split(",").map((s) => s.trim()).filter(Boolean) };
 /**
 * `<xh-checkbox-group>` —— Light-DOM 行为宿主：作者写 root/label 与若干 item 角色节点，
-* 每个 item 内自带 item-hidden-input/item-control/item-text，元素跑 checkbox-group 机器
+* 每个 item 内自带 hidden-input/indicator/item-text，元素跑 checkbox-group 机器
 * 并把 connect 产出打上去。条目身份取自条目节点上的 value 属性。
 *
 * 不做 roving tabindex：组内每一项都是独立的 Tab 停靠点（禁用项也保留），容器自己不占位。
@@ -1578,9 +1638,9 @@ const LIST_CONVERTER = { fromAttribute: (v) => v === null ? void 0 : v.split(","
 * @csspart root - role=group 容器
 * @csspart label - 组标题（aria-labelledby 目标）
 * @csspart item - role=checkbox 条目，作者用 value 属性声明身份
-* @csspart item-control - 条目的视觉方框（对读屏隐藏）
+* @csspart indicator - 条目的视觉方框（对读屏隐藏）
 * @csspart item-text - 条目文本，条目的可及名来源
-* @csspart item-hidden-input - 条目的表单影子输入（必须是原生 input）
+* @csspart hidden-input - 条目的表单影子输入（必须是原生 input）
 * @csspart trigger - 全选/半选的父复选框，须写在 root 之内
 */
 var XhCheckboxGroupElement = class extends XhElement {
@@ -1599,14 +1659,14 @@ var XhCheckboxGroupElement = class extends XhElement {
 			converter: LIST_CONVERTER,
 			attribute: "item-values"
 		},
-		disabled: { converter: BOOLEAN_CONVERTER$47 },
+		disabled: { converter: BOOLEAN_CONVERTER$49 },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$47,
+			converter: BOOLEAN_CONVERTER$49,
 			attribute: "read-only"
 		},
-		invalid: { converter: BOOLEAN_CONVERTER$47 },
-		orientation: { converter: STRING_CONVERTER$72 },
-		name: { converter: STRING_CONVERTER$72 }
+		invalid: { converter: BOOLEAN_CONVERTER$49 },
+		orientation: { converter: STRING_CONVERTER$73 },
+		name: { converter: STRING_CONVERTER$73 }
 	};
 	/** 条目自身 disabled 声明的快照，整组禁用期间 DOM 上的 aria-disabled 不可信。 */
 	declaredDisabled = /* @__PURE__ */ new WeakMap();
@@ -1685,8 +1745,8 @@ var XhCheckboxGroupElement = class extends XhElement {
 		for (const el of this.getParts("item")) {
 			const item = this.itemProps(el);
 			this.spreader.spread(el, api.getItemProps(item));
-			for (const input of this.partsIn(el, "item-hidden-input")) this.spreadHiddenInput(input, api.getItemHiddenInputProps(item));
-			for (const control of this.partsIn(el, "item-control")) this.spreader.spread(control, api.getItemControlProps(item));
+			for (const input of this.partsIn(el, "hidden-input")) this.spreadHiddenInput(input, api.getHiddenInputProps(item));
+			for (const control of this.partsIn(el, "indicator")) this.spreader.spread(control, api.getIndicatorProps(item));
 			for (const text of this.partsIn(el, "item-text")) this.spreader.spread(text, api.getItemTextProps(item));
 		}
 		this.wasGroupDisabled = !!this.disabled;
@@ -1694,8 +1754,8 @@ var XhCheckboxGroupElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/clipboard.ts
-const STRING_CONVERTER$71 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$44 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const STRING_CONVERTER$72 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$45 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 /**
 * `<xh-clipboard>` —— Light-DOM 行为宿主，跑 clipboard 机器并把 connect 产出打到角色节点上。
 *
@@ -1722,8 +1782,8 @@ var XhClipboardElement = class extends XhElement {
 		meta: clipboardMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$71 },
-		timeout: { converter: NUMBER_CONVERTER$44 }
+		value: { converter: STRING_CONVERTER$72 },
+		timeout: { converter: NUMBER_CONVERTER$45 }
 	};
 	notifyStatus = (details) => {
 		this.dispatchEvent(new CustomEvent("status-change", {
@@ -1770,8 +1830,8 @@ var XhClipboardElement = class extends XhElement {
 //#region src/elements/code-block.ts
 /** 默认着色实现全元素共用一份：它无状态，没必要每个块建一个。 */
 const defaultHighlighter = createHighlighter();
-const STRING_CONVERTER$70 = { fromAttribute: (v) => v ?? void 0 };
-const BOOLEAN_CONVERTER$46 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$71 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$48 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-code-block>` —— Light-DOM 行为宿主，无状态机：wire 时算出 connectCodeBlock 的产出，
 * 打到四类角色节点上。显示的代码文本由作者写在 code 角色节点里，元素不改其子节点。
@@ -1793,14 +1853,14 @@ var XhCodeBlockElement = class extends XhElement {
 		meta: codeBlockMeta
 	};
 	static properties = {
-		code: { converter: STRING_CONVERTER$70 },
+		code: { converter: STRING_CONVERTER$71 },
 		codeLang: {
-			converter: STRING_CONVERTER$70,
+			converter: STRING_CONVERTER$71,
 			attribute: "code-lang"
 		},
-		complete: { converter: BOOLEAN_CONVERTER$46 },
+		complete: { converter: BOOLEAN_CONVERTER$48 },
 		highlightWhileStreaming: {
-			converter: BOOLEAN_CONVERTER$46,
+			converter: BOOLEAN_CONVERTER$48,
 			attribute: "highlight-while-streaming"
 		}
 	};
@@ -1915,9 +1975,9 @@ var XhCollapsibleElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/color-picker.ts
-const STRING_CONVERTER$69 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$43 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$45 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$70 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$44 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$47 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /** 预设色板写成逗号分隔（swatches="#ff0000,#00ff00"），空串当没写。 */
 const STRING_LIST_CONVERTER = { fromAttribute: (v) => {
 	if (v == null || v.trim() === "") return void 0;
@@ -1949,6 +2009,7 @@ const STRING_LIST_CONVERTER = { fromAttribute: (v) => {
 * @attr {'ltr'|'rtl'} dir - 文字方向，只改写横轴上左右两键与指针的语义，默认 ltr
 * @attr {string} placement - 首选放置位，默认 bottom-start；避让后的实际位写在 data-placement 上
 * @attr {number} offset - 浮层与锚点的间距（px）
+* @attr {string} name - 表单字段名；给了 hidden-input 才带 name 并参与提交
 * @fires value-change - 颜色变化；detail 为 `{ value: string }`
 * @fires open-change - open 状态变化；detail 为 `{ open: boolean }`
 * @csspart root - 组件根容器（承载 data-state/data-disabled/data-readonly）
@@ -1967,6 +2028,7 @@ const STRING_LIST_CONVERTER = { fromAttribute: (v) => {
 * @csspart eye-dropper-trigger - 屏幕取色按钮，须是原生 button；环境不支持时自动禁用
 * @csspart swatch-group - role=group 的预设色板容器
 * @csspart swatch-item - 预设色板一格，须是原生 button 且自带 value 属性
+* @csspart hidden-input - type=hidden 的表单出口，值是当前颜色串；作者不写这个部件就不参与提交
 */
 var XhColorPickerElement = class extends XhElement {
 	static partContract = {
@@ -1974,30 +2036,31 @@ var XhColorPickerElement = class extends XhElement {
 		meta: colorPickerMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$69 },
+		value: { converter: STRING_CONVERTER$70 },
 		defaultValue: {
-			converter: STRING_CONVERTER$69,
+			converter: STRING_CONVERTER$70,
 			attribute: "default-value"
 		},
-		format: { converter: STRING_CONVERTER$69 },
-		open: { converter: BOOLEAN_CONVERTER$45 },
+		format: { converter: STRING_CONVERTER$70 },
+		open: { converter: BOOLEAN_CONVERTER$47 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		disabled: { converter: BOOLEAN_CONVERTER$45 },
+		disabled: { converter: BOOLEAN_CONVERTER$47 },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$45,
+			converter: BOOLEAN_CONVERTER$47,
 			attribute: "read-only"
 		},
-		alpha: { converter: BOOLEAN_CONVERTER$45 },
+		alpha: { converter: BOOLEAN_CONVERTER$47 },
 		swatches: { converter: STRING_LIST_CONVERTER },
+		name: { converter: STRING_CONVERTER$70 },
 		direction: {
-			converter: STRING_CONVERTER$69,
+			converter: STRING_CONVERTER$70,
 			attribute: "dir"
 		},
-		placement: { converter: STRING_CONVERTER$69 },
-		offset: { converter: NUMBER_CONVERTER$43 },
+		placement: { converter: STRING_CONVERTER$70 },
+		offset: { converter: NUMBER_CONVERTER$44 },
 		translations: { attribute: false }
 	};
 	idGen = createCounterIdGenerator();
@@ -2033,6 +2096,7 @@ var XhColorPickerElement = class extends XhElement {
 			readOnly: this.readOnly ?? false,
 			alpha: this.alpha ?? false,
 			swatches: this.swatches,
+			name: this.name,
 			dir: this.direction,
 			placement: this.placement,
 			offset: this.offset,
@@ -2111,6 +2175,7 @@ var XhColorPickerElement = class extends XhElement {
 		put("area-thumb", api.getAreaThumbProps());
 		put("eye-dropper-trigger", api.getEyeDropperTriggerProps());
 		put("swatch-group", api.getSwatchGroupProps());
+		put("hidden-input", api.getHiddenInputProps());
 		const valueText = this.getPart("value-text");
 		if (valueText) {
 			this.spreader.spread(valueText, api.getValueTextProps());
@@ -2136,9 +2201,9 @@ var XhColorPickerElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/combobox.ts
-const STRING_CONVERTER$68 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$42 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$44 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$69 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$43 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$46 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-combobox>` —— Light-DOM 行为宿主：作者写 root/label/control/input/trigger/positioner/content/item/...
 * 角色节点，元素跑 combobox 机器并把 connect 产出打上去。浮层定位引擎在本元素里建好、经 refs 注入机器，
@@ -2186,6 +2251,8 @@ const BOOLEAN_CONVERTER$44 = { fromAttribute: (v) => v === null ? void 0 : v !==
 * @csspart item-indicator - 候选选中标记（aria-hidden）
 * @csspart item-group - role=group 分组容器，须自带 value 属性标识身份
 * @csspart item-group-label - 分组标题（本组 aria-labelledby 的目标）
+* @attr {string} name - 表单字段名；给了 hidden-input 才参与提交（多选按逗号拼成一串）
+* @csspart hidden-input - type=hidden 的表单出口，省略该节点即不参与表单
 * @csspart empty - 无匹配项提示；须放在 positioner 里当 content 的兄弟（列表内只允许 option 与 group）
 */
 var XhComboboxElement = class extends XhElement {
@@ -2195,20 +2262,21 @@ var XhComboboxElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		value: { converter: STRING_CONVERTER$68 },
+		name: { converter: STRING_CONVERTER$69 },
+		value: { converter: STRING_CONVERTER$69 },
 		defaultValue: {
-			converter: STRING_CONVERTER$68,
+			converter: STRING_CONVERTER$69,
 			attribute: "default-value"
 		},
 		inputValue: {
-			converter: STRING_CONVERTER$68,
+			converter: STRING_CONVERTER$69,
 			attribute: "input-value"
 		},
 		defaultInputValue: {
-			converter: STRING_CONVERTER$68,
+			converter: STRING_CONVERTER$69,
 			attribute: "default-input-value"
 		},
-		open: { converter: BOOLEAN_CONVERTER$44 },
+		open: { converter: BOOLEAN_CONVERTER$46 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
@@ -2216,12 +2284,12 @@ var XhComboboxElement = class extends XhElement {
 		multiple: { type: Boolean },
 		disabled: { type: Boolean },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$44,
+			converter: BOOLEAN_CONVERTER$46,
 			attribute: "read-only"
 		},
-		invalid: { converter: BOOLEAN_CONVERTER$44 },
-		loop: { converter: BOOLEAN_CONVERTER$44 },
-		placeholder: { converter: STRING_CONVERTER$68 },
+		invalid: { converter: BOOLEAN_CONVERTER$46 },
+		loop: { converter: BOOLEAN_CONVERTER$46 },
+		placeholder: { converter: STRING_CONVERTER$69 },
 		allowCustomValue: {
 			type: Boolean,
 			attribute: "allow-custom-value"
@@ -2231,14 +2299,14 @@ var XhComboboxElement = class extends XhElement {
 			attribute: "open-on-click"
 		},
 		inputBehavior: {
-			converter: STRING_CONVERTER$68,
+			converter: STRING_CONVERTER$69,
 			attribute: "input-behavior"
 		},
-		placement: { converter: STRING_CONVERTER$68 },
-		offset: { converter: NUMBER_CONVERTER$42 },
-		variant: { converter: STRING_CONVERTER$68 },
-		tone: { converter: STRING_CONVERTER$68 },
-		size: { converter: STRING_CONVERTER$68 }
+		placement: { converter: STRING_CONVERTER$69 },
+		offset: { converter: NUMBER_CONVERTER$43 },
+		variant: { converter: STRING_CONVERTER$69 },
+		tone: { converter: STRING_CONVERTER$69 },
+		size: { converter: STRING_CONVERTER$69 }
 	};
 	idGen = createCounterIdGenerator();
 	comboboxScope = createScope(null, this.idGen);
@@ -2285,6 +2353,7 @@ var XhComboboxElement = class extends XhElement {
 			readOnly: this.readOnly ?? false,
 			invalid: this.invalid ?? false,
 			loop: this.loop,
+			name: this.name,
 			placeholder: this.placeholder,
 			allowCustomValue: this.allowCustomValue ?? false,
 			openOnClick: this.openOnClick ?? false,
@@ -2354,6 +2423,7 @@ var XhComboboxElement = class extends XhElement {
 		put("positioner", api.getPositionerProps());
 		put("content", api.getContentProps());
 		put("empty", api.getEmptyProps());
+		put("hidden-input", api.getHiddenInputProps());
 		for (const el of this.getParts("item-group")) {
 			const group = { value: el.getAttribute("value") ?? "" };
 			this.spreader.spread(el, api.getItemGroupProps(group));
@@ -2379,8 +2449,8 @@ var XhComboboxElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/composer.ts
-const STRING_CONVERTER$67 = { fromAttribute: (v) => v ?? void 0 };
-const BOOLEAN_CONVERTER$43 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$68 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$45 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-composer>` —— Light-DOM 行为宿主：跑 composer 机器，把 connect 产出打到作者写的
 * root/input/submit-trigger 三类角色节点上。input 须是原生 `<textarea>`，值经 property 写、
@@ -2406,18 +2476,18 @@ var XhComposerElement = class extends XhElement {
 		meta: composerMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$67 },
+		value: { converter: STRING_CONVERTER$68 },
 		defaultValue: {
-			converter: STRING_CONVERTER$67,
+			converter: STRING_CONVERTER$68,
 			attribute: "default-value"
 		},
-		disabled: { converter: BOOLEAN_CONVERTER$43 },
+		disabled: { converter: BOOLEAN_CONVERTER$45 },
 		runStatus: {
-			converter: STRING_CONVERTER$67,
+			converter: STRING_CONVERTER$68,
 			attribute: "run-status"
 		},
 		submitOnEnter: {
-			converter: BOOLEAN_CONVERTER$43,
+			converter: BOOLEAN_CONVERTER$45,
 			attribute: "submit-on-enter"
 		},
 		translations: { attribute: false }
@@ -2459,9 +2529,9 @@ var XhComposerElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/context-menu.ts
-const STRING_CONVERTER$66 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$41 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$42 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$67 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$42 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$44 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-context-menu>` —— Light-DOM 行为宿主：作者写 root/trigger/positioner/content 与若干
 * item / group / separator 角色节点，元素跑 context-menu 机器并把 connect 产出打上去。
@@ -2504,25 +2574,26 @@ var XhContextMenuElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		open: { converter: BOOLEAN_CONVERTER$42 },
+		open: { converter: BOOLEAN_CONVERTER$44 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		placement: { converter: STRING_CONVERTER$66 },
-		offset: { converter: NUMBER_CONVERTER$41 },
-		loop: { converter: BOOLEAN_CONVERTER$42 },
-		typeahead: { converter: BOOLEAN_CONVERTER$42 },
+		placement: { converter: STRING_CONVERTER$67 },
+		offset: { converter: NUMBER_CONVERTER$42 },
+		loop: { converter: BOOLEAN_CONVERTER$44 },
+		typeahead: { converter: BOOLEAN_CONVERTER$44 },
+		translations: { attribute: false },
 		direction: {
-			converter: STRING_CONVERTER$66,
+			converter: STRING_CONVERTER$67,
 			attribute: "dir"
 		},
 		longPressDelay: {
-			converter: NUMBER_CONVERTER$41,
+			converter: NUMBER_CONVERTER$42,
 			attribute: "long-press-delay"
 		},
-		tone: { converter: STRING_CONVERTER$66 },
-		size: { converter: STRING_CONVERTER$66 }
+		tone: { converter: STRING_CONVERTER$67 },
+		size: { converter: STRING_CONVERTER$67 }
 	};
 	idGen = createCounterIdGenerator();
 	menuScope = createScope(null, this.idGen);
@@ -2557,6 +2628,7 @@ var XhContextMenuElement = class extends XhElement {
 			offset: this.offset,
 			loop: this.loop,
 			typeahead: this.typeahead,
+			translations: this.translations,
 			dir: this.direction,
 			longPressDelay: this.longPressDelay,
 			tone: this.tone,
@@ -2589,6 +2661,7 @@ var XhContextMenuElement = class extends XhElement {
 		svc.refs.set("registerLayer", this.registerLayer);
 		svc.refs.set("position", this.positionEngine);
 		svc.refs.set("getFloatingEl", () => this.getPart("positioner"));
+		svc.refs.set("getTriggerEl", () => this.getPart("trigger"));
 		svc.refs.set("getContentEl", () => this.getPart("content"));
 	}
 	/**
@@ -2652,9 +2725,9 @@ var XhContextMenuElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/countdown.ts
-const STRING_CONVERTER$65 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$40 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$41 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$66 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$41 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$43 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-countdown>` —— Light-DOM 行为宿主：作者写一个 root 角色节点，
 * 元素跑 countdown 机器，逐帧把剩余毫秒按模板铺成时分秒写进那个节点。
@@ -2684,11 +2757,11 @@ var XhCountdownElement = class extends XhElement {
 		meta: countdownMeta
 	};
 	static properties = {
-		value: { converter: NUMBER_CONVERTER$40 },
-		format: { converter: STRING_CONVERTER$65 },
-		active: { converter: BOOLEAN_CONVERTER$41 },
-		precision: { converter: NUMBER_CONVERTER$40 },
-		live: { converter: STRING_CONVERTER$65 }
+		value: { converter: NUMBER_CONVERTER$41 },
+		format: { converter: STRING_CONVERTER$66 },
+		active: { converter: BOOLEAN_CONVERTER$43 },
+		precision: { converter: NUMBER_CONVERTER$41 },
+		live: { converter: STRING_CONVERTER$66 }
 	};
 	notify = (details) => {
 		this.dispatchEvent(new CustomEvent("finish", {
@@ -2718,8 +2791,8 @@ var XhCountdownElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/date-field.ts
-const STRING_CONVERTER$64 = { fromAttribute: (v) => v ?? void 0 };
-const BOOLEAN_CONVERTER$40 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$65 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$42 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /** 作者写在段位上的下标。缺席或写坏了就退回文档序——手写 HTML 时把段位按顺序排下来本身就是声明。 */
 function declaredIndex$4(el, position) {
 	const raw = el.getAttribute("index");
@@ -2770,32 +2843,32 @@ var XhDateFieldElement = class extends XhElement {
 		meta: dateFieldMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$64 },
+		value: { converter: STRING_CONVERTER$65 },
 		defaultValue: {
-			converter: STRING_CONVERTER$64,
+			converter: STRING_CONVERTER$65,
 			attribute: "default-value"
 		},
-		min: { converter: STRING_CONVERTER$64 },
-		max: { converter: STRING_CONVERTER$64 },
-		locale: { converter: STRING_CONVERTER$64 },
+		min: { converter: STRING_CONVERTER$65 },
+		max: { converter: STRING_CONVERTER$65 },
+		locale: { converter: STRING_CONVERTER$65 },
 		timeZone: {
-			converter: STRING_CONVERTER$64,
+			converter: STRING_CONVERTER$65,
 			attribute: "time-zone"
 		},
-		granularity: { converter: STRING_CONVERTER$64 },
-		disabled: { converter: BOOLEAN_CONVERTER$40 },
+		granularity: { converter: STRING_CONVERTER$65 },
+		disabled: { converter: BOOLEAN_CONVERTER$42 },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$40,
+			converter: BOOLEAN_CONVERTER$42,
 			attribute: "read-only"
 		},
-		invalid: { converter: BOOLEAN_CONVERTER$40 },
-		required: { converter: BOOLEAN_CONVERTER$40 },
-		name: { converter: STRING_CONVERTER$64 },
+		invalid: { converter: BOOLEAN_CONVERTER$42 },
+		required: { converter: BOOLEAN_CONVERTER$42 },
+		name: { converter: STRING_CONVERTER$65 },
 		placeholder: { attribute: false },
 		translations: { attribute: false },
-		variant: { converter: STRING_CONVERTER$64 },
-		tone: { converter: STRING_CONVERTER$64 },
-		size: { converter: STRING_CONVERTER$64 }
+		variant: { converter: STRING_CONVERTER$65 },
+		tone: { converter: STRING_CONVERTER$65 },
+		size: { converter: STRING_CONVERTER$65 }
 	};
 	notifyChange = (details) => {
 		this.dispatchEvent(new CustomEvent("value-change", {
@@ -2849,9 +2922,9 @@ var XhDateFieldElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/date-picker.ts
-const STRING_CONVERTER$63 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$39 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$39 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$64 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$40 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$41 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /** 取作者写在段位上的 index，缺席或写坏了退回组内文档序。 */
 function declaredIndex$3(el, position) {
 	const raw = el.getAttribute("index");
@@ -2909,6 +2982,9 @@ function declaredIndex$3(el, position) {
 * @csspart positioner - 浮层定位容器，坐标由引擎写成内联样式
 * @csspart content - role=dialog 浮层（消解层的根节点），收起时带 hidden
 * @csspart calendar - 内嵌日历的挂载点，同时充当日历的根节点
+* @csspart time-column - showTime 的时间列，须自带 unit 属性（hour/minute/second）；没开时带 hidden
+* @csspart time-item - 时间选项，须自带 value 属性（两位补零串）；点按把该单位写进值
+* @csspart confirm-trigger - showTime 的收口按钮；没开时带 hidden
 * @csspart header - 日历标题栏外壳（data-scope="calendar"）
 * @csspart prev-trigger - 上一月；越过 min 时转原生 disabled
 * @csspart next-trigger - 下一月；越过 max 时转原生 disabled
@@ -2929,46 +3005,54 @@ var XhDatePickerElement = class extends XhElement {
 		delegates: [dateFieldAnatomy, calendarAnatomy]
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$63 },
+		value: { converter: STRING_CONVERTER$64 },
 		defaultValue: {
-			converter: STRING_CONVERTER$63,
+			converter: STRING_CONVERTER$64,
 			attribute: "default-value"
 		},
-		open: { converter: BOOLEAN_CONVERTER$39 },
+		open: { converter: BOOLEAN_CONVERTER$41 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		min: { converter: STRING_CONVERTER$63 },
-		max: { converter: STRING_CONVERTER$63 },
-		locale: { converter: STRING_CONVERTER$63 },
+		min: { converter: STRING_CONVERTER$64 },
+		max: { converter: STRING_CONVERTER$64 },
+		locale: { converter: STRING_CONVERTER$64 },
 		timeZone: {
-			converter: STRING_CONVERTER$63,
+			converter: STRING_CONVERTER$64,
 			attribute: "time-zone"
 		},
 		selectionMode: {
-			converter: STRING_CONVERTER$63,
+			converter: STRING_CONVERTER$64,
 			attribute: "selection-mode"
 		},
-		disabled: { converter: BOOLEAN_CONVERTER$39 },
+		disabled: { converter: BOOLEAN_CONVERTER$41 },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$39,
+			converter: BOOLEAN_CONVERTER$41,
 			attribute: "read-only"
 		},
-		invalid: { converter: BOOLEAN_CONVERTER$39 },
-		required: { converter: BOOLEAN_CONVERTER$39 },
-		name: { converter: STRING_CONVERTER$63 },
+		invalid: { converter: BOOLEAN_CONVERTER$41 },
+		required: { converter: BOOLEAN_CONVERTER$41 },
+		name: { converter: STRING_CONVERTER$64 },
 		endName: {
-			converter: STRING_CONVERTER$63,
+			converter: STRING_CONVERTER$64,
 			attribute: "end-name"
 		},
 		translations: { attribute: false },
-		placement: { converter: STRING_CONVERTER$63 },
-		offset: { converter: NUMBER_CONVERTER$39 },
+		placement: { converter: STRING_CONVERTER$64 },
+		offset: { converter: NUMBER_CONVERTER$40 },
 		closeOnSelect: {
-			converter: BOOLEAN_CONVERTER$39,
+			converter: BOOLEAN_CONVERTER$41,
 			attribute: "close-on-select"
 		},
+		showTime: {
+			converter: BOOLEAN_CONVERTER$41,
+			attribute: "show-time"
+		},
+		timeGranularity: {
+			converter: STRING_CONVERTER$64,
+			attribute: "time-granularity"
+		},
 		isDateUnavailable: { attribute: false }
 	};
 	idGen = createCounterIdGenerator();
@@ -3038,6 +3122,8 @@ var XhDatePickerElement = class extends XhElement {
 			placement: this.placement,
 			offset: this.offset,
 			closeOnSelect: this.closeOnSelect,
+			showTime: this.showTime,
+			timeGranularity: this.timeGranularity,
 			onValueChange: this.notifyValue,
 			onOpenChange: this.notifyOpen,
 			onFocusedValueChange: this.notifyFocus
@@ -3128,6 +3214,12 @@ var XhDatePickerElement = class extends XhElement {
 		put("positioner", api.getPositionerProps());
 		put("content", api.getContentProps());
 		put("calendar", api.getCalendarProps());
+		put("confirm-trigger", api.getConfirmTriggerProps());
+		for (const el of this.getParts("time-column")) this.spreader.spread(el, api.getTimeColumnProps({ unit: el.getAttribute("unit") ?? "hour" }));
+		for (const el of this.getParts("time-item")) this.spreader.spread(el, api.getTimeItemProps({
+			unit: el.closest("[data-xh-part=\"time-column\"]")?.getAttribute("unit") ?? "hour",
+			value: el.getAttribute("value") ?? ""
+		}));
 		const inputs = this.getParts("input");
 		const owners = [inputs[0] ?? this, inputs[1]];
 		const hiddenInputs = this.hiddenInputGroups(inputs);
@@ -3167,7 +3259,7 @@ var XhDatePickerElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/descriptions.ts
-const STRING_CONVERTER$62 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$63 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-descriptions>` —— Light-DOM 行为宿主，无状态机，把 connectDescriptions 产出打到各角色节点。
 * 排版走 CSS Grid，columns 落成列数。
@@ -3193,8 +3285,8 @@ var XhDescriptionsElement = class extends XhElement {
 	static properties = {
 		columns: { type: Number },
 		bordered: { type: Boolean },
-		placement: { converter: STRING_CONVERTER$62 },
-		size: { converter: STRING_CONVERTER$62 }
+		placement: { converter: STRING_CONVERTER$63 },
+		size: { converter: STRING_CONVERTER$63 }
 	};
 	wire() {
 		const api = connectDescriptions({
@@ -3215,8 +3307,8 @@ var XhDescriptionsElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/dialog.ts
-const BOOLEAN_CONVERTER$38 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
-const STRING_CONVERTER$61 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$40 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$62 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-dialog>` —— Light-DOM 行为宿主，跑 dialog 机器并把 connect 产出打到角色节点上，
 * 关闭时用内联 style.display 隐藏浮层子树。
@@ -3244,21 +3336,21 @@ var XhDialogElement = class extends XhElement {
 		meta: dialogMeta
 	};
 	static properties = {
-		open: { converter: BOOLEAN_CONVERTER$38 },
+		open: { converter: BOOLEAN_CONVERTER$40 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		modal: { converter: BOOLEAN_CONVERTER$38 },
+		modal: { converter: BOOLEAN_CONVERTER$40 },
 		closeOnEscape: {
-			converter: BOOLEAN_CONVERTER$38,
+			converter: BOOLEAN_CONVERTER$40,
 			attribute: "close-on-escape"
 		},
 		restoreFocus: {
-			converter: BOOLEAN_CONVERTER$38,
+			converter: BOOLEAN_CONVERTER$40,
 			attribute: "restore-focus"
 		},
-		size: { converter: STRING_CONVERTER$61 }
+		size: { converter: STRING_CONVERTER$62 }
 	};
 	idGen = createCounterIdGenerator();
 	dialogScope = createScope(null, this.idGen);
@@ -3344,8 +3436,8 @@ var XhDialogElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/drawer.ts
-const BOOLEAN_CONVERTER$37 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
-const STRING_CONVERTER$60 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$39 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$61 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-drawer>` —— Light-DOM 行为宿主，跑 drawer 机器并把 connect 产出打到角色节点上，
 * 关闭时用内联 style.display 隐藏浮层子树。
@@ -3378,26 +3470,26 @@ var XhDrawerElement = class extends XhElement {
 		meta: drawerMeta
 	};
 	static properties = {
-		open: { converter: BOOLEAN_CONVERTER$37 },
+		open: { converter: BOOLEAN_CONVERTER$39 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		modal: { converter: BOOLEAN_CONVERTER$37 },
-		side: { converter: STRING_CONVERTER$60 },
+		modal: { converter: BOOLEAN_CONVERTER$39 },
+		side: { converter: STRING_CONVERTER$61 },
 		closeOnEscape: {
-			converter: BOOLEAN_CONVERTER$37,
+			converter: BOOLEAN_CONVERTER$39,
 			attribute: "close-on-escape"
 		},
 		closeOnInteractOutside: {
-			converter: BOOLEAN_CONVERTER$37,
+			converter: BOOLEAN_CONVERTER$39,
 			attribute: "close-on-interact-outside"
 		},
 		restoreFocus: {
-			converter: BOOLEAN_CONVERTER$37,
+			converter: BOOLEAN_CONVERTER$39,
 			attribute: "restore-focus"
 		},
-		size: { converter: STRING_CONVERTER$60 },
+		size: { converter: STRING_CONVERTER$61 },
 		translations: { attribute: false }
 	};
 	idGen = createCounterIdGenerator();
@@ -3488,8 +3580,8 @@ var XhDrawerElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/dynamic-input.ts
-const NUMBER_CONVERTER$38 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$36 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const NUMBER_CONVERTER$39 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$38 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /** 作者写在行上的下标。缺席或写坏了就退回文档序——把行按顺序排下来本身就是声明。 */
 function declaredIndex$2(el, position) {
 	const raw = el.getAttribute("index");
@@ -3531,11 +3623,11 @@ var XhDynamicInputElement = class extends XhElement {
 	static properties = {
 		value: { attribute: false },
 		defaultValue: { attribute: false },
-		min: { converter: NUMBER_CONVERTER$38 },
-		max: { converter: NUMBER_CONVERTER$38 },
+		min: { converter: NUMBER_CONVERTER$39 },
+		max: { converter: NUMBER_CONVERTER$39 },
 		createItem: { attribute: false },
-		movable: { converter: BOOLEAN_CONVERTER$36 },
-		disabled: { converter: BOOLEAN_CONVERTER$36 },
+		movable: { converter: BOOLEAN_CONVERTER$38 },
+		disabled: { converter: BOOLEAN_CONVERTER$38 },
 		translations: { attribute: false }
 	};
 	notifyValue = (details) => {
@@ -3589,9 +3681,9 @@ var XhDynamicInputElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/editable.ts
-const STRING_CONVERTER$59 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$37 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$35 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$60 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$38 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$37 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-editable>` —— Light-DOM 行为宿主：作者写 root/label/area/preview/input/control
 * 与三颗按钮的角色节点，元素跑 editable 机器并把 connect 产出打上去。
@@ -3640,42 +3732,42 @@ var XhEditableElement = class extends XhElement {
 		meta: editableMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$59 },
+		value: { converter: STRING_CONVERTER$60 },
 		defaultValue: {
-			converter: STRING_CONVERTER$59,
+			converter: STRING_CONVERTER$60,
 			attribute: "default-value"
 		},
-		edit: { converter: BOOLEAN_CONVERTER$35 },
+		edit: { converter: BOOLEAN_CONVERTER$37 },
 		defaultEdit: {
-			converter: BOOLEAN_CONVERTER$35,
+			converter: BOOLEAN_CONVERTER$37,
 			attribute: "default-edit"
 		},
-		placeholder: { converter: STRING_CONVERTER$59 },
-		disabled: { converter: BOOLEAN_CONVERTER$35 },
+		placeholder: { converter: STRING_CONVERTER$60 },
+		disabled: { converter: BOOLEAN_CONVERTER$37 },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$35,
+			converter: BOOLEAN_CONVERTER$37,
 			attribute: "read-only"
 		},
-		invalid: { converter: BOOLEAN_CONVERTER$35 },
+		invalid: { converter: BOOLEAN_CONVERTER$37 },
 		maxLength: {
-			converter: NUMBER_CONVERTER$37,
+			converter: NUMBER_CONVERTER$38,
 			attribute: "max-length"
 		},
-		name: { converter: STRING_CONVERTER$59 },
+		name: { converter: STRING_CONVERTER$60 },
 		submitMode: {
-			converter: STRING_CONVERTER$59,
+			converter: STRING_CONVERTER$60,
 			attribute: "submit-mode"
 		},
 		activationMode: {
-			converter: STRING_CONVERTER$59,
+			converter: STRING_CONVERTER$60,
 			attribute: "activation-mode"
 		},
 		selectOnFocus: {
-			converter: BOOLEAN_CONVERTER$35,
+			converter: BOOLEAN_CONVERTER$37,
 			attribute: "select-on-focus"
 		},
 		autoResize: {
-			converter: BOOLEAN_CONVERTER$35,
+			converter: BOOLEAN_CONVERTER$37,
 			attribute: "auto-resize"
 		}
 	};
@@ -3784,7 +3876,7 @@ var XhEditableElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/ellipsis.ts
-const NUMBER_CONVERTER$36 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const NUMBER_CONVERTER$37 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 const TRISTATE_CONVERTER$1 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-ellipsis>` —— 省略行为宿主：把一段文字夹在给定行数内，并如实报出它有没有被裁掉。
@@ -3812,7 +3904,7 @@ var XhEllipsisElement = class extends XhElement {
 		meta: ellipsisMeta
 	};
 	static properties = {
-		lines: { converter: NUMBER_CONVERTER$36 },
+		lines: { converter: NUMBER_CONVERTER$37 },
 		expandable: { type: Boolean },
 		expanded: { converter: TRISTATE_CONVERTER$1 },
 		defaultExpanded: {
@@ -3858,7 +3950,7 @@ var XhEllipsisElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/empty-state.ts
-const STRING_CONVERTER$58 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$59 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-empty-state>` —— 空状态行为宿主，无状态机，把 connectEmptyState 产出的属性打到角色节点上。
 *
@@ -3880,8 +3972,8 @@ var XhEmptyStateElement = class extends XhElement {
 		meta: emptyStateMeta
 	};
 	static properties = {
-		size: { converter: STRING_CONVERTER$58 },
-		live: { converter: STRING_CONVERTER$58 }
+		size: { converter: STRING_CONVERTER$59 },
+		live: { converter: STRING_CONVERTER$59 }
 	};
 	wire() {
 		const api = connectEmptyState({
@@ -3901,7 +3993,7 @@ var XhEmptyStateElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/field.ts
-const STRING_CONVERTER$57 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$58 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-field>` —— Light-DOM 行为宿主，无状态机，把 connectField 产出的 id 与 aria-* 打到
 * label/control/description/error-text 角色节点上，自动对齐 `for` 与描述链。控件本身由作者渲染。
@@ -3931,7 +4023,7 @@ var XhFieldElement = class extends XhElement {
 		required: { type: Boolean },
 		disabled: { type: Boolean },
 		controlId: {
-			converter: STRING_CONVERTER$57,
+			converter: STRING_CONVERTER$58,
 			attribute: "control-id"
 		}
 	};
@@ -3957,9 +4049,9 @@ var XhFieldElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/file-upload.ts
-const STRING_CONVERTER$56 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$35 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$34 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$57 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$36 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const BOOLEAN_CONVERTER$36 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /** 取作者写在条目上的 index，缺席或写坏了退回文档序。 */
 function declaredIndex$1(el, position) {
 	const raw = el.getAttribute("index");
@@ -3991,7 +4083,11 @@ function declaredIndex$1(el, position) {
 * @attr {boolean} allow-drop - 是否接受拖拽投放，默认 true；写 allow-drop="false" 关掉
 * @attr {boolean} directory - 选目录而不是选文件（隐藏输入带 webkitdirectory）
 * @attr {'user'|'environment'} capture - 移动端直接调用摄像头/麦克风采集
+* @attr {boolean} auto-upload - 收下即自动开传（须配 upload 实现），默认 true；写 auto-upload="false" 关掉
 * @fires files-change - 列表变化；detail 为 `{ files: File[] }`
+* @fires remote-files-change - 远程附件列表变化；detail 为 `{ files: FileUploadRemoteFile[] }`
+* @fires upload-complete - 单个文件传完；detail 为 `{ file, url? }`
+* @fires upload-error - 单个文件传败；detail 为 `{ file, error }`
 * @fires file-accept - 本次收下了哪些；detail 为 `{ files: File[] }`
 * @fires file-reject - 本次拒了哪些、各自为什么；detail 为 `{ files: { file, reasons }[] }`
 * @csspart root - 组件根容器，承载 data-dragging / data-disabled / data-invalid / data-empty
@@ -4015,28 +4111,35 @@ var XhFileUploadElement = class XhFileUploadElement extends XhElement {
 	static properties = {
 		files: { attribute: false },
 		defaultFiles: { attribute: false },
-		accept: { converter: STRING_CONVERTER$56 },
+		remoteFiles: { attribute: false },
+		defaultRemoteFiles: { attribute: false },
+		upload: { attribute: false },
+		autoUpload: {
+			converter: BOOLEAN_CONVERTER$36,
+			attribute: "auto-upload"
+		},
+		accept: { converter: STRING_CONVERTER$57 },
 		maxFiles: {
-			converter: NUMBER_CONVERTER$35,
+			converter: NUMBER_CONVERTER$36,
 			attribute: "max-files"
 		},
 		maxFileSize: {
-			converter: NUMBER_CONVERTER$35,
+			converter: NUMBER_CONVERTER$36,
 			attribute: "max-file-size"
 		},
 		minFileSize: {
-			converter: NUMBER_CONVERTER$35,
+			converter: NUMBER_CONVERTER$36,
 			attribute: "min-file-size"
 		},
 		disabled: { type: Boolean },
 		invalid: { type: Boolean },
-		name: { converter: STRING_CONVERTER$56 },
+		name: { converter: STRING_CONVERTER$57 },
 		allowDrop: {
-			converter: BOOLEAN_CONVERTER$34,
+			converter: BOOLEAN_CONVERTER$36,
 			attribute: "allow-drop"
 		},
 		directory: { type: Boolean },
-		capture: { converter: STRING_CONVERTER$56 },
+		capture: { converter: STRING_CONVERTER$57 },
 		translations: { attribute: false }
 	};
 	uploadScope = createScope(this, createCounterIdGenerator());
@@ -4061,11 +4164,36 @@ var XhFileUploadElement = class XhFileUploadElement extends XhElement {
 			composed: true
 		}));
 	};
+	notifyRemoteChange = (details) => {
+		this.dispatchEvent(new CustomEvent("remote-files-change", {
+			detail: details,
+			bubbles: true,
+			composed: true
+		}));
+	};
+	notifyUploadComplete = (details) => {
+		this.dispatchEvent(new CustomEvent("upload-complete", {
+			detail: details,
+			bubbles: true,
+			composed: true
+		}));
+	};
+	notifyUploadError = (details) => {
+		this.dispatchEvent(new CustomEvent("upload-error", {
+			detail: details,
+			bubbles: true,
+			composed: true
+		}));
+	};
 	ctrl = new MachineController(this, fileUploadMachine, () => this.machineProps(), { scope: this.uploadScope });
 	machineProps() {
 		return {
 			files: this.files,
 			defaultFiles: this.defaultFiles,
+			remoteFiles: this.remoteFiles,
+			defaultRemoteFiles: this.defaultRemoteFiles,
+			upload: this.upload,
+			autoUpload: this.autoUpload,
 			accept: this.accept,
 			maxFiles: this.maxFiles,
 			maxFileSize: this.maxFileSize,
@@ -4078,6 +4206,9 @@ var XhFileUploadElement = class XhFileUploadElement extends XhElement {
 			capture: this.capture,
 			translations: this.translations,
 			onFilesChange: this.notifyChange,
+			onRemoteFilesChange: this.notifyRemoteChange,
+			onUploadComplete: this.notifyUploadComplete,
+			onUploadError: this.notifyUploadError,
 			onFileAccept: this.notifyAccept,
 			onFileReject: this.notifyReject
 		};
@@ -4222,8 +4353,8 @@ var XhFlexElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/float-button.ts
-const STRING_CONVERTER$55 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$34 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const STRING_CONVERTER$56 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$35 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 const TRISTATE_CONVERTER = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-float-button>` —— 悬浮按钮行为宿主：一颗钉在视口一角的触发器，展开一组动作。
@@ -4261,11 +4392,11 @@ var XhFloatButtonElement = class extends XhElement {
 			attribute: "default-open"
 		},
 		disabled: { type: Boolean },
-		placement: { converter: STRING_CONVERTER$55 },
-		offset: { converter: NUMBER_CONVERTER$34 },
-		shape: { converter: STRING_CONVERTER$55 },
+		placement: { converter: STRING_CONVERTER$56 },
+		offset: { converter: NUMBER_CONVERTER$35 },
+		shape: { converter: STRING_CONVERTER$56 },
 		expandTrigger: {
-			converter: STRING_CONVERTER$55,
+			converter: STRING_CONVERTER$56,
 			attribute: "expand-trigger"
 		},
 		translations: { attribute: false }
@@ -4313,8 +4444,8 @@ var XhFloatButtonElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/form.ts
-const STRING_CONVERTER$54 = { fromAttribute: (v) => v ?? void 0 };
-const BOOLEAN_CONVERTER$33 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$55 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$35 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * 字段容器与摘要条目自报的字段名，取作者写的 `value` 属性。
 *
@@ -4344,6 +4475,9 @@ function fieldNameOf(el) {
 *
 * @customElement xh-form
 * @attr {string} validate-on - 校验时机：submit（默认）/ blur / change
+* @attr {string} layout - 排布：vertical（默认）/ horizontal（标签左置两列）/ inline（横排一行流）
+* @attr {string} label-width - horizontal 下标签列宽（CSS 长度），整表统一对齐
+* @attr {string} label-align - horizontal 下标签对齐缘：end（默认，贴控件）/ start
 * @attr {boolean} disabled - 整个表单禁用：提交、重置、写值一概不发生，两颗按钮带原生 disabled
 * @attr {boolean} read-only - 只读：写值与重置不发生，但仍可提交
 * @fires values-change - 值表变化；detail 为 `{ values }`
@@ -4351,7 +4485,8 @@ function fieldNameOf(el) {
 * @fires submit - 校验通过才派发；detail 为 `{ values }`
 * @fires invalid - 校验不通过时派发；detail 为 `{ errors, values }`
 * @csspart root - 表单根容器，必须是原生 `<form>`（承载 data-state/data-disabled/data-readonly/data-invalid）
-* @csspart field-group - 单个字段的容器，须自带 value 属性标识字段名；带 id 供摘要链接指向
+* @csspart field-group - 单个字段的容器，须自带 value 属性标识字段名；带 id 供摘要链接指向。
+*   组里的 `<xh-field>` 由表单驱动 invalid/required/disabled，作者显式设的会被顶掉
 * @csspart error-summary - role=alert 的错误汇总，提交失败且仍有错误时才显形
 * @csspart error-summary-item - 摘要里的一条，须是原生 `<a>` 且自带 value 属性标识字段名；无对应错误时带 hidden
 * @csspart submit-trigger - 提交键，须是原生 button（连接层写成 type=submit）
@@ -4368,13 +4503,24 @@ var XhFormElement = class extends XhElement {
 		errors: { attribute: false },
 		defaultErrors: { attribute: false },
 		validate: { attribute: false },
+		rules: { attribute: false },
+		validateMessages: { attribute: false },
 		validateOn: {
-			converter: STRING_CONVERTER$54,
+			converter: STRING_CONVERTER$55,
 			attribute: "validate-on"
 		},
-		disabled: { converter: BOOLEAN_CONVERTER$33 },
+		layout: { converter: STRING_CONVERTER$55 },
+		labelWidth: {
+			converter: STRING_CONVERTER$55,
+			attribute: "label-width"
+		},
+		labelAlign: {
+			converter: STRING_CONVERTER$55,
+			attribute: "label-align"
+		},
+		disabled: { converter: BOOLEAN_CONVERTER$35 },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$33,
+			converter: BOOLEAN_CONVERTER$35,
 			attribute: "read-only"
 		}
 	};
@@ -4414,7 +4560,12 @@ var XhFormElement = class extends XhElement {
 			errors: this.errors,
 			defaultErrors: this.defaultErrors,
 			validate: this.validate,
+			rules: this.rules,
+			validateMessages: this.validateMessages,
 			validateOn: this.validateOn,
+			layout: this.layout,
+			labelWidth: this.labelWidth,
+			labelAlign: this.labelAlign,
 			disabled: this.disabled ?? false,
 			readOnly: this.readOnly ?? false,
 			onValuesChange: this.notifyValues,
@@ -4486,7 +4637,15 @@ var XhFormElement = class extends XhElement {
 		put("error-summary", api.getErrorSummaryProps());
 		put("submit-trigger", api.getSubmitTriggerProps());
 		put("reset-trigger", api.getResetTriggerProps());
-		for (const el of this.getParts("field-group")) this.spreader.spread(el, api.getFieldGroupProps({ name: fieldNameOf(el) }));
+		for (const el of this.getParts("field-group")) {
+			const name = fieldNameOf(el);
+			this.spreader.spread(el, api.getFieldGroupProps({ name }));
+			for (const field of el.querySelectorAll("xh-field")) {
+				field.invalid = api.isFieldInvalid(name);
+				field.required = api.isFieldRequired(name) || void 0;
+				field.disabled = api.disabled || void 0;
+			}
+		}
 		for (const el of this.getParts("error-summary-item")) {
 			this.spreader.spread(el, api.getErrorSummaryItemProps({ name: fieldNameOf(el) }));
 			this.setPartHidden(el, api.getFieldError(fieldNameOf(el)) === void 0);
@@ -4496,7 +4655,7 @@ var XhFormElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/gradient-text.ts
-const STRING_CONVERTER$53 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$54 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-gradient-text>` —— Light-DOM 行为宿主，无状态机，把 connectGradientText 产出打到 root 角色节点。
 *
@@ -4517,9 +4676,9 @@ var XhGradientTextElement = class extends XhElement {
 		meta: gradientTextMeta
 	};
 	static properties = {
-		from: { converter: STRING_CONVERTER$53 },
-		to: { converter: STRING_CONVERTER$53 },
-		direction: { converter: STRING_CONVERTER$53 }
+		from: { converter: STRING_CONVERTER$54 },
+		to: { converter: STRING_CONVERTER$54 },
+		direction: { converter: STRING_CONVERTER$54 }
 	};
 	wire() {
 		const api = connectGradientText({
@@ -4533,7 +4692,7 @@ var XhGradientTextElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/grid.ts
-const STRING_CONVERTER$52 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$53 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * 列数写整数就是各档同一个列数（`cols="3"`），写 JSON 对象就是逐档的列数
 * （`cols='{"base":1,"md":3}'`）。解析不出对象时当没写：落一个半截对象进去，
@@ -4582,9 +4741,9 @@ var XhGridElement = class extends XhElement {
 	};
 	static properties = {
 		cols: { converter: COLS_CONVERTER },
-		gap: { converter: STRING_CONVERTER$52 },
-		align: { converter: STRING_CONVERTER$52 },
-		justify: { converter: STRING_CONVERTER$52 }
+		gap: { converter: STRING_CONVERTER$53 },
+		align: { converter: STRING_CONVERTER$53 },
+		justify: { converter: STRING_CONVERTER$53 }
 	};
 	wire() {
 		const api = connectGrid({
@@ -4606,7 +4765,7 @@ var XhGridElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/highlight.ts
-const STRING_CONVERTER$51 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$52 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-highlight>` —— Light-DOM 行为宿主，无状态机，把 text 按 keyword 切段铺进 root。
 *
@@ -4632,8 +4791,8 @@ var XhHighlightElement = class extends XhElement {
 		meta: highlightMeta
 	};
 	static properties = {
-		text: { converter: STRING_CONVERTER$51 },
-		keyword: { converter: STRING_CONVERTER$51 },
+		text: { converter: STRING_CONVERTER$52 },
+		keyword: { converter: STRING_CONVERTER$52 },
 		caseSensitive: {
 			type: Boolean,
 			attribute: "case-sensitive"
@@ -4681,13 +4840,13 @@ var XhHighlightElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/hover-card.ts
-const STRING_CONVERTER$50 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$33 = { fromAttribute: (v) => {
+const STRING_CONVERTER$51 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$34 = { fromAttribute: (v) => {
 	if (v === null) return void 0;
 	const n = Number(v);
 	return Number.isFinite(n) ? n : void 0;
 } };
-const BOOLEAN_CONVERTER$32 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$34 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-hover-card>` —— Light-DOM 行为宿主：作者写 root/trigger/positioner/content/arrow 角色节点，
 * 元素跑 hover-card 机器并把 connect 产出打上去。
@@ -4720,27 +4879,27 @@ var XhHoverCardElement = class extends XhElement {
 		meta: hoverCardMeta
 	};
 	static properties = {
-		open: { converter: BOOLEAN_CONVERTER$32 },
+		open: { converter: BOOLEAN_CONVERTER$34 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		placement: { converter: STRING_CONVERTER$50 },
-		offset: { converter: NUMBER_CONVERTER$33 },
+		placement: { converter: STRING_CONVERTER$51 },
+		offset: { converter: NUMBER_CONVERTER$34 },
 		openDelay: {
-			converter: NUMBER_CONVERTER$33,
+			converter: NUMBER_CONVERTER$34,
 			attribute: "open-delay"
 		},
 		closeDelay: {
-			converter: NUMBER_CONVERTER$33,
+			converter: NUMBER_CONVERTER$34,
 			attribute: "close-delay"
 		},
 		direction: {
-			converter: STRING_CONVERTER$50,
+			converter: STRING_CONVERTER$51,
 			attribute: "dir"
 		},
 		disabled: { type: Boolean },
-		size: { converter: STRING_CONVERTER$50 }
+		size: { converter: STRING_CONVERTER$51 }
 	};
 	idGen = createCounterIdGenerator();
 	hoverCardScope = createScope(null, this.idGen);
@@ -4828,7 +4987,7 @@ var XhHoverCardElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/icon.ts
-const STRING_CONVERTER$49 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$50 = { fromAttribute: (v) => v ?? void 0 };
 const SVG_NS$1 = "http://www.w3.org/2000/svg";
 /** 自带可及名字的控件；图标落在它们里面时名字该写在控件上。 */
 const NAMED_CONTROLS = "button, a[href], [role=\"button\"], [role=\"link\"], [role=\"menuitem\"], [role=\"tab\"], [role=\"option\"]";
@@ -4869,10 +5028,10 @@ var XhIconElement = class extends XhElement {
 		}
 	};
 	static properties = {
-		label: { converter: STRING_CONVERTER$49 },
-		size: { converter: STRING_CONVERTER$49 },
-		weight: { converter: STRING_CONVERTER$49 },
-		tone: { converter: STRING_CONVERTER$49 },
+		label: { converter: STRING_CONVERTER$50 },
+		size: { converter: STRING_CONVERTER$50 },
+		weight: { converter: STRING_CONVERTER$50 },
+		tone: { converter: STRING_CONVERTER$50 },
 		icon: { attribute: false }
 	};
 	/** 一个 glyph 节点归谁，首次见到时定死。 */
@@ -4995,8 +5154,8 @@ var XhIconWrapperElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/image.ts
-const STRING_CONVERTER$48 = { fromAttribute: (v) => v ?? void 0 };
-const NUMBER_CONVERTER$32 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
+const STRING_CONVERTER$49 = { fromAttribute: (v) => v ?? void 0 };
+const NUMBER_CONVERTER$33 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 /**
 * `<xh-image>` —— Light-DOM 行为宿主：作者写 root/image/fallback 角色节点，
 * 元素跑 image 机器并把 connect 产出打上去。图片来源由宿主的 src/alt 写进 image 节点，
@@ -5020,10 +5179,10 @@ var XhImageElement = class extends XhElement {
 		meta: imageMeta
 	};
 	static properties = {
-		src: { converter: STRING_CONVERTER$48 },
-		alt: { converter: STRING_CONVERTER$48 },
+		src: { converter: STRING_CONVERTER$49 },
+		alt: { converter: STRING_CONVERTER$49 },
 		fallbackDelay: {
-			converter: NUMBER_CONVERTER$32,
+			converter: NUMBER_CONVERTER$33,
 			attribute: "fallback-delay"
 		}
 	};
@@ -5078,9 +5237,208 @@ var XhImageElement = class extends XhElement {
 	}
 };
 //#endregion
+//#region src/elements/image-viewer.ts
+const BOOLEAN_CONVERTER$33 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const NUMBER_CONVERTER$32 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
+/**
+* `<xh-image-viewer>` —— Light-DOM 行为宿主，跑 image-viewer 机器：
+* 模态看片浮层，滚轮缩放、拖拽平移、旋转翻转与多图翻页。
+*
+* @customElement xh-image-viewer
+* @attr {boolean} open - 受控开合；缺省该属性即非受控
+* @attr {boolean} default-open - 非受控初始为打开
+* @attr {number} index - 受控下标（0 起）
+* @attr {number} default-index - 非受控初始下标，默认 0
+* @attr {boolean} loop - 前后翻页到头回绕，默认 true；写 loop="false" 关掉
+* @attr {number} zoom-step - 缩放步长（加法），默认 0.5
+* @attr {number} min-scale - 缩放下限，默认 0.25
+* @attr {number} max-scale - 缩放上限，默认 8
+* @attr {boolean} close-on-escape - Esc 关闭，默认 true
+* @attr {boolean} close-on-interact-outside - 点遮罩关闭，默认 true
+* @attr {boolean} restore-focus - 关闭后把焦点归还触发元素，默认 true
+* @fires open-change - open 状态变化；detail 为 `{ open: boolean }`
+* @fires index-change - 下标变化；detail 为 `{ index: number }`
+* @csspart trigger - 触发按钮
+* @csspart backdrop - 遮罩层
+* @csspart positioner - 浮层定位容器
+* @csspart content - 看片容器（role=dialog + aria-modal；方向键翻页在这里）
+* @csspart viewport - 手势视口（滚轮缩放、拖拽平移）
+* @csspart image - 当前那张图（src/alt/transform 由元素代填）
+* @csspart toolbar - 工具条容器
+* @csspart zoom-in-trigger - 放大
+* @csspart zoom-out-trigger - 缩小
+* @csspart rotate-left-trigger - 左转 90°
+* @csspart rotate-right-trigger - 右转 90°
+* @csspart flip-horizontal-trigger - 水平翻转
+* @csspart flip-vertical-trigger - 垂直翻转
+* @csspart reset-trigger - 变换归零
+* @csspart prev-trigger - 上一张
+* @csspart next-trigger - 下一张
+* @csspart counter - 「第 n / 共 m」计数（元素代填）
+* @csspart close-trigger - 关闭
+*/
+var XhImageViewerElement = class extends XhElement {
+	static partContract = {
+		anatomy: imageViewerAnatomy,
+		meta: imageViewerMeta
+	};
+	static properties = {
+		open: { converter: BOOLEAN_CONVERTER$33 },
+		defaultOpen: {
+			type: Boolean,
+			attribute: "default-open"
+		},
+		index: { converter: NUMBER_CONVERTER$32 },
+		defaultIndex: {
+			converter: NUMBER_CONVERTER$32,
+			attribute: "default-index"
+		},
+		loop: { converter: BOOLEAN_CONVERTER$33 },
+		zoomStep: {
+			converter: NUMBER_CONVERTER$32,
+			attribute: "zoom-step"
+		},
+		minScale: {
+			converter: NUMBER_CONVERTER$32,
+			attribute: "min-scale"
+		},
+		maxScale: {
+			converter: NUMBER_CONVERTER$32,
+			attribute: "max-scale"
+		},
+		closeOnEscape: {
+			converter: BOOLEAN_CONVERTER$33,
+			attribute: "close-on-escape"
+		},
+		closeOnInteractOutside: {
+			converter: BOOLEAN_CONVERTER$33,
+			attribute: "close-on-interact-outside"
+		},
+		restoreFocus: {
+			converter: BOOLEAN_CONVERTER$33,
+			attribute: "restore-focus"
+		},
+		items: { attribute: false },
+		translations: { attribute: false }
+	};
+	idGen = createCounterIdGenerator();
+	viewerScope = createScope(null, this.idGen);
+	config = null;
+	contentNode = null;
+	backdropNode = null;
+	/** counter 的文本归属：首帧为空才代填，作者写过内容就不碰。 */
+	counterOwned = null;
+	notifyOpen = (details) => {
+		this.dispatchEvent(new CustomEvent("open-change", {
+			detail: details,
+			bubbles: true,
+			composed: true
+		}));
+	};
+	notifyIndex = (details) => {
+		this.dispatchEvent(new CustomEvent("index-change", {
+			detail: details,
+			bubbles: true,
+			composed: true
+		}));
+	};
+	ctrl = new MachineController(this, imageViewerMachine, () => this.machineProps(), {
+		scope: this.viewerScope,
+		onBuilt: (svc) => this.injectRefs(svc)
+	});
+	machineProps() {
+		return {
+			items: this.items,
+			open: this.open,
+			defaultOpen: this.defaultOpen ?? false,
+			index: this.index,
+			defaultIndex: this.defaultIndex,
+			loop: this.loop,
+			zoomStep: this.zoomStep,
+			minScale: this.minScale,
+			maxScale: this.maxScale,
+			closeOnEscape: this.closeOnEscape,
+			closeOnInteractOutside: this.closeOnInteractOutside,
+			restoreFocus: this.restoreFocus,
+			translations: this.translations,
+			onOpenChange: this.notifyOpen,
+			onIndexChange: this.notifyIndex
+		};
+	}
+	ensureConfig() {
+		if (this.config) return;
+		this.config = createRuntimeConfig({
+			scope: this.viewerScope,
+			idGenerator: this.idGen
+		});
+	}
+	registerLayer = () => {
+		this.ensureConfig();
+		return this.config.layerRegistry.register({
+			kind: "modal",
+			node: () => this.contentNode,
+			branches: () => [],
+			isModal: () => true,
+			setModal: () => {},
+			surfaces: () => [this.backdropNode].filter(Boolean)
+		});
+	};
+	injectRefs(svc) {
+		this.ensureConfig();
+		svc.refs.set("config", this.config);
+		svc.refs.set("registerLayer", this.registerLayer);
+		svc.refs.set("getContentEl", () => this.contentNode);
+	}
+	wire() {
+		const svc = this.ctrl.service;
+		const api = connectImageViewer(svc, wcNormalize);
+		const open = svc.state.get() === "open";
+		this.contentNode = this.getPart("content");
+		this.backdropNode = this.getPart("backdrop");
+		const put = (name, props) => {
+			const el = this.getPart(name);
+			if (el) this.spreader.spread(el, props);
+		};
+		put("trigger", api.getTriggerProps());
+		put("backdrop", api.getBackdropProps());
+		put("positioner", api.getPositionerProps());
+		put("content", api.getContentProps());
+		put("viewport", api.getViewportProps());
+		put("image", api.getImageProps());
+		put("toolbar", api.getToolbarProps());
+		put("zoom-in-trigger", api.getZoomInTriggerProps());
+		put("zoom-out-trigger", api.getZoomOutTriggerProps());
+		put("rotate-left-trigger", api.getRotateLeftTriggerProps());
+		put("rotate-right-trigger", api.getRotateRightTriggerProps());
+		put("flip-horizontal-trigger", api.getFlipHorizontalTriggerProps());
+		put("flip-vertical-trigger", api.getFlipVerticalTriggerProps());
+		put("reset-trigger", api.getResetTriggerProps());
+		put("prev-trigger", api.getPrevTriggerProps());
+		put("next-trigger", api.getNextTriggerProps());
+		put("counter", api.getCounterProps());
+		put("close-trigger", api.getCloseTriggerProps());
+		const counter = this.getPart("counter");
+		if (counter) {
+			if (this.counterOwned === null) this.counterOwned = (counter.textContent ?? "").trim() === "";
+			if (this.counterOwned) {
+				const text = imageViewerCounterText(this.translations, api.index, api.count);
+				if (counter.textContent !== text) counter.textContent = text;
+			}
+		}
+		const positioner = this.getPart("positioner");
+		if (positioner) this.setPartHidden(positioner, !open);
+		if (this.backdropNode) this.setPartHidden(this.backdropNode, !open);
+		this.setPartHidden(this.contentNode, !open);
+	}
+	disconnectedCallback() {
+		super.disconnectedCallback();
+		this.config = null;
+	}
+};
+//#endregion
 //#region src/elements/infinite-scroll.ts
 const NUMBER_CONVERTER$31 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$31 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$32 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-infinite-scroll>` —— 无限滚动行为宿主：摆在列表末尾的哨兵一进可视区就报「该取下一页了」。
 *
@@ -5104,8 +5462,8 @@ var XhInfiniteScrollElement = class extends XhElement {
 	};
 	static properties = {
 		distance: { converter: NUMBER_CONVERTER$31 },
-		disabled: { converter: BOOLEAN_CONVERTER$31 },
-		loading: { converter: BOOLEAN_CONVERTER$31 },
+		disabled: { converter: BOOLEAN_CONVERTER$32 },
+		loading: { converter: BOOLEAN_CONVERTER$32 },
 		target: { attribute: false }
 	};
 	notify = () => {
@@ -5139,7 +5497,7 @@ var XhInfiniteScrollElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/layout.ts
-const STRING_CONVERTER$47 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$48 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-layout>` —— 页面骨架的 Light-DOM 行为宿主，跑 layout 机器并把 connect 产出打到
 * root/header/sider/content/footer/sider-trigger 角色节点。
@@ -5185,15 +5543,15 @@ var XhLayoutElement = class extends XhElement {
 		},
 		siderWidth: {
 			attribute: "sider-width",
-			converter: STRING_CONVERTER$47
+			converter: STRING_CONVERTER$48
 		},
 		siderCollapsedWidth: {
 			attribute: "sider-collapsed-width",
-			converter: STRING_CONVERTER$47
+			converter: STRING_CONVERTER$48
 		},
 		siderPlacement: {
 			attribute: "sider-placement",
-			converter: STRING_CONVERTER$47
+			converter: STRING_CONVERTER$48
 		},
 		headerFixed: {
 			type: Boolean,
@@ -5242,7 +5600,7 @@ var XhLayoutElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/list.ts
-const STRING_CONVERTER$46 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$47 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-list>` —— Light-DOM 行为宿主，无状态机，把 connectList 产出打到各角色节点。
 * 除 root 外的部件全部可缺省：空列表、只有一行标题的条目都是合法形态。
@@ -5272,7 +5630,7 @@ var XhListElement = class extends XhElement {
 		bordered: { type: Boolean },
 		hoverable: { type: Boolean },
 		split: { type: Boolean },
-		size: { converter: STRING_CONVERTER$46 }
+		size: { converter: STRING_CONVERTER$47 }
 	};
 	wire() {
 		const api = connectList({
@@ -5296,8 +5654,8 @@ var XhListElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/listbox.ts
-const STRING_CONVERTER$45 = { fromAttribute: (v) => v ?? void 0 };
-const BOOLEAN_CONVERTER$30 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const STRING_CONVERTER$46 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$31 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-listbox>` —— Light-DOM 行为宿主：作者写 root/label/content 与若干 item 角色节点，
 * 元素跑 listbox 机器并把 connect 产出打上去。条目身份取自条目节点上的 value 属性，
@@ -5339,24 +5697,24 @@ var XhListboxElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		value: { converter: STRING_CONVERTER$45 },
+		value: { converter: STRING_CONVERTER$46 },
 		defaultValue: {
-			converter: STRING_CONVERTER$45,
+			converter: STRING_CONVERTER$46,
 			attribute: "default-value"
 		},
 		multiple: { type: Boolean },
 		selectionMode: {
-			converter: STRING_CONVERTER$45,
+			converter: STRING_CONVERTER$46,
 			attribute: "selection-mode"
 		},
 		disabled: { type: Boolean },
-		loop: { converter: BOOLEAN_CONVERTER$30 },
+		loop: { converter: BOOLEAN_CONVERTER$31 },
 		direction: {
-			converter: STRING_CONVERTER$45,
+			converter: STRING_CONVERTER$46,
 			attribute: "dir"
 		},
-		orientation: { converter: STRING_CONVERTER$45 },
-		typeahead: { converter: BOOLEAN_CONVERTER$30 }
+		orientation: { converter: STRING_CONVERTER$46 },
+		typeahead: { converter: BOOLEAN_CONVERTER$31 }
 	};
 	declaredDisabled = /* @__PURE__ */ new WeakMap();
 	/** 上一帧是否整列禁用：解禁当帧 DOM 上还留着机器写回的 aria-disabled，读不得。 */
@@ -5454,9 +5812,9 @@ var XhListboxElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/loading-bar.ts
-const STRING_CONVERTER$44 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$45 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$30 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$29 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$30 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 const HEIGHT_CONVERTER = { fromAttribute: (v) => {
 	if (v == null || v === "") return void 0;
 	const px = Number(v);
@@ -5500,11 +5858,11 @@ var XhLoadingBarElement = class extends XhElement {
 			converter: NUMBER_CONVERTER$30,
 			attribute: "default-value"
 		},
-		loading: { converter: BOOLEAN_CONVERTER$29 },
+		loading: { converter: BOOLEAN_CONVERTER$30 },
 		height: { converter: HEIGHT_CONVERTER },
-		color: { converter: STRING_CONVERTER$44 },
-		tone: { converter: STRING_CONVERTER$44 },
-		trickle: { converter: BOOLEAN_CONVERTER$29 },
+		color: { converter: STRING_CONVERTER$45 },
+		tone: { converter: STRING_CONVERTER$45 },
+		trickle: { converter: BOOLEAN_CONVERTER$30 },
 		trickleSpeed: {
 			converter: NUMBER_CONVERTER$30,
 			attribute: "trickle-speed"
@@ -5640,7 +5998,7 @@ var XhLogElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/marquee.ts
-const STRING_CONVERTER$43 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$44 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$28 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 /**
 * `<xh-marquee>` —— Light-DOM 行为宿主，无状态机，把 connectMarquee 产出打到 root 与 content 上。
@@ -5668,7 +6026,7 @@ var XhMarqueeElement = class extends XhElement {
 		meta: marqueeMeta
 	};
 	static properties = {
-		direction: { converter: STRING_CONVERTER$43 },
+		direction: { converter: STRING_CONVERTER$44 },
 		speed: { converter: NUMBER_CONVERTER$28 },
 		pauseOnHover: {
 			type: Boolean,
@@ -5696,9 +6054,9 @@ var XhMarqueeElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/mention.ts
-const STRING_CONVERTER$42 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$43 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$27 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$28 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$29 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-mention>` —— Light-DOM 行为宿主：作者写 root/input/positioner/content/item 角色节点，
 * 元素跑 mention 机器并把 connect 产出打上去。浮层定位引擎在本元素里建好、经 refs 注入机器，
@@ -5747,22 +6105,22 @@ var XhMentionElement = class extends XhElement {
 		collection: { attribute: false },
 		translations: { attribute: false },
 		triggerPrefix: {
-			converter: STRING_CONVERTER$42,
+			converter: STRING_CONVERTER$43,
 			attribute: "prefix"
 		},
-		value: { converter: STRING_CONVERTER$42 },
+		value: { converter: STRING_CONVERTER$43 },
 		defaultValue: {
-			converter: STRING_CONVERTER$42,
+			converter: STRING_CONVERTER$43,
 			attribute: "default-value"
 		},
 		disabled: { type: Boolean },
-		placeholder: { converter: STRING_CONVERTER$42 },
-		loop: { converter: BOOLEAN_CONVERTER$28 },
-		placement: { converter: STRING_CONVERTER$42 },
+		placeholder: { converter: STRING_CONVERTER$43 },
+		loop: { converter: BOOLEAN_CONVERTER$29 },
+		placement: { converter: STRING_CONVERTER$43 },
 		offset: { converter: NUMBER_CONVERTER$27 },
-		variant: { converter: STRING_CONVERTER$42 },
-		tone: { converter: STRING_CONVERTER$42 },
-		size: { converter: STRING_CONVERTER$42 }
+		variant: { converter: STRING_CONVERTER$43 },
+		tone: { converter: STRING_CONVERTER$43 },
+		size: { converter: STRING_CONVERTER$43 }
 	};
 	idGen = createCounterIdGenerator();
 	mentionScope = createScope(null, this.idGen);
@@ -5890,9 +6248,9 @@ var XhMentionElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/menu.ts
-const STRING_CONVERTER$41 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$42 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$26 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$27 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$28 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-menu>` —— Light-DOM 行为宿主：用户写 trigger/positioner/content/item/... 角色节点，
 * 元素跑 menu 机器并把 connect 产出打上去。浮层定位引擎在本元素里建好、经 refs 注入机器，
@@ -5924,20 +6282,33 @@ var XhMenuElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		open: { converter: BOOLEAN_CONVERTER$27 },
+		open: { converter: BOOLEAN_CONVERTER$28 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		placement: { converter: STRING_CONVERTER$41 },
+		placement: { converter: STRING_CONVERTER$42 },
 		offset: { converter: NUMBER_CONVERTER$26 },
-		loop: { converter: BOOLEAN_CONVERTER$27 },
+		loop: { converter: BOOLEAN_CONVERTER$28 },
 		direction: {
-			converter: STRING_CONVERTER$41,
+			converter: STRING_CONVERTER$42,
 			attribute: "dir"
 		},
-		tone: { converter: STRING_CONVERTER$41 },
-		size: { converter: STRING_CONVERTER$41 }
+		tone: { converter: STRING_CONVERTER$42 },
+		size: { converter: STRING_CONVERTER$42 },
+		submenu: { converter: BOOLEAN_CONVERTER$28 },
+		openOnHover: {
+			converter: BOOLEAN_CONVERTER$28,
+			attribute: "open-on-hover"
+		},
+		hoverOpenDelay: {
+			converter: NUMBER_CONVERTER$26,
+			attribute: "hover-open-delay"
+		},
+		hoverCloseDelay: {
+			converter: NUMBER_CONVERTER$26,
+			attribute: "hover-close-delay"
+		}
 	};
 	idGen = createCounterIdGenerator();
 	menuScope = createScope(null, this.idGen);
@@ -5974,6 +6345,10 @@ var XhMenuElement = class extends XhElement {
 			dir: this.direction,
 			tone: this.tone,
 			size: this.size,
+			submenu: this.submenu,
+			openOnHover: this.openOnHover,
+			hoverOpenDelay: this.hoverOpenDelay,
+			hoverCloseDelay: this.hoverCloseDelay,
 			onOpenChange: this.notifyOpen,
 			onSelect: this.notifySelect
 		};
@@ -6033,7 +6408,9 @@ var XhMenuElement = class extends XhElement {
 			const el = this.getPart(name);
 			if (el) this.spreader.spread(el, props);
 		};
-		put("trigger", api.getTriggerProps());
+		const triggerEl = this.getPart("trigger");
+		if (this.submenu && triggerEl) this.spreader.spread(triggerEl, api.getSubmenuTriggerProps({ value: triggerEl.getAttribute("value") ?? "" }));
+		else put("trigger", api.getTriggerProps());
 		put("positioner", api.getPositionerProps());
 		put("content", api.getContentProps());
 		put("arrow", api.getArrowProps());
@@ -6055,9 +6432,9 @@ var XhMenuElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/menubar.ts
-const STRING_CONVERTER$40 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$41 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$25 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$26 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$27 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /** 读角色节点的禁用声明，并摘掉作者写的原生 disabled，禁用态归一到 aria-disabled。 */
 function authorDisabled$1(el) {
 	const disabled = isItemDisabled(el);
@@ -6107,23 +6484,23 @@ var XhMenubarElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		value: { converter: STRING_CONVERTER$40 },
+		value: { converter: STRING_CONVERTER$41 },
 		defaultValue: {
-			converter: STRING_CONVERTER$40,
+			converter: STRING_CONVERTER$41,
 			attribute: "default-value"
 		},
-		orientation: { converter: STRING_CONVERTER$40 },
-		loop: { converter: BOOLEAN_CONVERTER$26 },
+		orientation: { converter: STRING_CONVERTER$41 },
+		loop: { converter: BOOLEAN_CONVERTER$27 },
 		direction: {
-			converter: STRING_CONVERTER$40,
+			converter: STRING_CONVERTER$41,
 			attribute: "dir"
 		},
-		disabled: { converter: BOOLEAN_CONVERTER$26 },
-		typeahead: { converter: BOOLEAN_CONVERTER$26 },
-		placement: { converter: STRING_CONVERTER$40 },
+		disabled: { converter: BOOLEAN_CONVERTER$27 },
+		typeahead: { converter: BOOLEAN_CONVERTER$27 },
+		placement: { converter: STRING_CONVERTER$41 },
 		offset: { converter: NUMBER_CONVERTER$25 },
-		tone: { converter: STRING_CONVERTER$40 },
-		size: { converter: STRING_CONVERTER$40 }
+		tone: { converter: STRING_CONVERTER$41 },
+		size: { converter: STRING_CONVERTER$41 }
 	};
 	idGen = createCounterIdGenerator();
 	barScope = createScope(null, this.idGen);
@@ -6257,9 +6634,9 @@ var XhMenubarElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/navigation-menu.ts
-const STRING_CONVERTER$39 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$40 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$24 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$25 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$26 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * 作者写在角色节点上的布尔声明，三态读法：属性缺席 = false，="false" = false，其余 = true。
 */
@@ -6319,12 +6696,12 @@ var XhNavigationMenuElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		value: { converter: STRING_CONVERTER$39 },
+		value: { converter: STRING_CONVERTER$40 },
 		defaultValue: {
-			converter: STRING_CONVERTER$39,
+			converter: STRING_CONVERTER$40,
 			attribute: "default-value"
 		},
-		orientation: { converter: STRING_CONVERTER$39 },
+		orientation: { converter: STRING_CONVERTER$40 },
 		delayDuration: {
 			converter: NUMBER_CONVERTER$24,
 			attribute: "delay-duration"
@@ -6334,12 +6711,12 @@ var XhNavigationMenuElement = class extends XhElement {
 			attribute: "skip-delay-duration"
 		},
 		direction: {
-			converter: STRING_CONVERTER$39,
+			converter: STRING_CONVERTER$40,
 			attribute: "dir"
 		},
-		loop: { converter: BOOLEAN_CONVERTER$25 },
-		tone: { converter: STRING_CONVERTER$39 },
-		size: { converter: STRING_CONVERTER$39 },
+		loop: { converter: BOOLEAN_CONVERTER$26 },
+		tone: { converter: STRING_CONVERTER$40 },
+		size: { converter: STRING_CONVERTER$40 },
 		translations: { attribute: false }
 	};
 	idGen = createCounterIdGenerator();
@@ -6412,9 +6789,9 @@ var XhNavigationMenuElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/number-animation.ts
-const STRING_CONVERTER$38 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$39 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$23 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$24 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$25 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-number-animation>` —— Light-DOM 行为宿主：作者写一个 root 角色节点，
 * 元素跑 number-animation 机器，逐帧把补间算出的数字格式化后写进那个节点。
@@ -6449,13 +6826,13 @@ var XhNumberAnimationElement = class extends XhElement {
 		from: { converter: NUMBER_CONVERTER$23 },
 		to: { converter: NUMBER_CONVERTER$23 },
 		duration: { converter: NUMBER_CONVERTER$23 },
-		easing: { converter: STRING_CONVERTER$38 },
+		easing: { converter: STRING_CONVERTER$39 },
 		precision: { converter: NUMBER_CONVERTER$23 },
-		separator: { converter: STRING_CONVERTER$38 },
-		active: { converter: BOOLEAN_CONVERTER$24 },
-		size: { converter: STRING_CONVERTER$38 },
-		tone: { converter: STRING_CONVERTER$38 },
-		live: { converter: STRING_CONVERTER$38 }
+		separator: { converter: STRING_CONVERTER$39 },
+		active: { converter: BOOLEAN_CONVERTER$25 },
+		size: { converter: STRING_CONVERTER$39 },
+		tone: { converter: STRING_CONVERTER$39 },
+		live: { converter: STRING_CONVERTER$39 }
 	};
 	notify = (details) => {
 		this.dispatchEvent(new CustomEvent("finish", {
@@ -6490,7 +6867,7 @@ var XhNumberAnimationElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/number-field.ts
-const STRING_CONVERTER$37 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$38 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$22 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 /**
 * `<xh-number-field>` —— Light-DOM 行为宿主：作者写 root/label/input/加减按钮四类角色节点，
@@ -6529,9 +6906,9 @@ var XhNumberFieldElement = class extends XhElement {
 		meta: numberFieldMeta
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$37 },
+		value: { converter: STRING_CONVERTER$38 },
 		defaultValue: {
-			converter: STRING_CONVERTER$37,
+			converter: STRING_CONVERTER$38,
 			attribute: "default-value"
 		},
 		min: { converter: NUMBER_CONVERTER$22 },
@@ -6548,7 +6925,7 @@ var XhNumberFieldElement = class extends XhElement {
 		},
 		required: { type: Boolean },
 		invalid: { type: Boolean },
-		name: { converter: STRING_CONVERTER$37 },
+		name: { converter: STRING_CONVERTER$38 },
 		changeDelay: {
 			converter: NUMBER_CONVERTER$22,
 			attribute: "change-delay"
@@ -6557,9 +6934,9 @@ var XhNumberFieldElement = class extends XhElement {
 			converter: NUMBER_CONVERTER$22,
 			attribute: "change-interval"
 		},
-		variant: { converter: STRING_CONVERTER$37 },
-		tone: { converter: STRING_CONVERTER$37 },
-		size: { converter: STRING_CONVERTER$37 }
+		variant: { converter: STRING_CONVERTER$38 },
+		tone: { converter: STRING_CONVERTER$38 },
+		size: { converter: STRING_CONVERTER$38 }
 	};
 	notify = (details) => {
 		this.dispatchEvent(new CustomEvent("value-change", {
@@ -6605,7 +6982,7 @@ var XhNumberFieldElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/page-header.ts
-const STRING_CONVERTER$36 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$37 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-page-header>` —— Light-DOM 行为宿主，无状态机，把 connectPageHeader 产出打到各角色节点。
 * 除 root 外的部件全部可缺省：返回位、标题、副标题、操作、页脚按需摆。
@@ -6629,7 +7006,7 @@ var XhPageHeaderElement = class extends XhElement {
 		meta: pageHeaderMeta
 	};
 	static properties = {
-		size: { converter: STRING_CONVERTER$36 },
+		size: { converter: STRING_CONVERTER$37 },
 		bordered: { type: Boolean }
 	};
 	wire() {
@@ -6652,7 +7029,7 @@ var XhPageHeaderElement = class extends XhElement {
 //#endregion
 //#region src/elements/pagination.ts
 const NUMBER_CONVERTER$21 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const STRING_CONVERTER$35 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$36 = { fromAttribute: (v) => v ?? void 0 };
 /** 页码按钮自报的页数；缺失或空串一律给 NaN（见 wire 里的说明）。 */
 function itemPage(el) {
 	const raw = el.getAttribute("value");
@@ -6705,11 +7082,11 @@ var XhPaginationElement = class extends XhElement {
 			attribute: "sibling-count"
 		},
 		direction: {
-			converter: STRING_CONVERTER$35,
+			converter: STRING_CONVERTER$36,
 			attribute: "dir"
 		},
-		tone: { converter: STRING_CONVERTER$35 },
-		size: { converter: STRING_CONVERTER$35 },
+		tone: { converter: STRING_CONVERTER$36 },
+		size: { converter: STRING_CONVERTER$36 },
 		translations: { attribute: false }
 	};
 	notify = (details) => {
@@ -6752,7 +7129,7 @@ var XhPaginationElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/pin-input.ts
-const STRING_CONVERTER$34 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$35 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$20 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 const ARRAY_CONVERTER$1 = { fromAttribute: (v) => v == null ? void 0 : [...v] };
 /** 作者写在格子上的下标。缺席或写坏了就退回文档序——手写 HTML 时把格子按顺序排下来本身就是声明。 */
@@ -6804,20 +7181,20 @@ var XhPinInputElement = class extends XhElement {
 			attribute: "default-value"
 		},
 		length: { converter: NUMBER_CONVERTER$20 },
-		type: { converter: STRING_CONVERTER$34 },
+		type: { converter: STRING_CONVERTER$35 },
 		mask: { type: Boolean },
 		otp: { type: Boolean },
-		placeholder: { converter: STRING_CONVERTER$34 },
+		placeholder: { converter: STRING_CONVERTER$35 },
 		disabled: { type: Boolean },
 		invalid: { type: Boolean },
 		blurOnComplete: {
 			type: Boolean,
 			attribute: "blur-on-complete"
 		},
-		name: { converter: STRING_CONVERTER$34 },
-		variant: { converter: STRING_CONVERTER$34 },
-		tone: { converter: STRING_CONVERTER$34 },
-		size: { converter: STRING_CONVERTER$34 },
+		name: { converter: STRING_CONVERTER$35 },
+		variant: { converter: STRING_CONVERTER$35 },
+		tone: { converter: STRING_CONVERTER$35 },
+		size: { converter: STRING_CONVERTER$35 },
 		translations: { attribute: false }
 	};
 	notifyChange = (details) => {
@@ -6873,9 +7250,9 @@ var XhPinInputElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/popconfirm.ts
-const STRING_CONVERTER$33 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$34 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$19 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$23 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$24 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-popconfirm>` —— Light-DOM 行为宿主：用户写 root/trigger/positioner/content/... 角色节点，
 * 元素跑 popover 机器（开合、定位、消解层、焦点域都在那里）并把 connectPopconfirm 产出打上去。
@@ -6893,7 +7270,9 @@ const BOOLEAN_CONVERTER$23 = { fromAttribute: (v) => v === null ? void 0 : v !==
 * @attr {boolean} close-on-interact-outside - 层外交互关闭，默认 true；写 "false" 关掉
 * @attr {'sm'|'md'|'lg'} size - 尺寸
 * @fires open-change - open 状态变化；detail 为 `{ open: boolean }`
-* @fires confirm - 点了确认按钮；随后浮层收起
+* @fires confirm - 点了确认按钮；随后浮层收起。异步门走 confirmAction 属性：
+*   事件拿不到监听函数的返回值，给元素赋 `confirmAction = () => Promise` 即挂起确认门
+*   （浮层等兑现才收、确认按钮转圈，落空留在原地），confirm 事件照发只作通知
 * @fires cancel - 点了取消按钮；随后浮层收起
 * @csspart root - 框住触发器的根容器，承载 data-state
 * @csspart trigger - 触发按钮（aria-haspopup/aria-expanded/aria-controls 所在），同时是定位锚点
@@ -6910,22 +7289,22 @@ var XhPopconfirmElement = class extends XhElement {
 		meta: popconfirmMeta
 	};
 	static properties = {
-		open: { converter: BOOLEAN_CONVERTER$23 },
+		open: { converter: BOOLEAN_CONVERTER$24 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		placement: { converter: STRING_CONVERTER$33 },
+		placement: { converter: STRING_CONVERTER$34 },
 		offset: { converter: NUMBER_CONVERTER$19 },
 		closeOnEscape: {
-			converter: BOOLEAN_CONVERTER$23,
+			converter: BOOLEAN_CONVERTER$24,
 			attribute: "close-on-escape"
 		},
 		closeOnInteractOutside: {
-			converter: BOOLEAN_CONVERTER$23,
+			converter: BOOLEAN_CONVERTER$24,
 			attribute: "close-on-interact-outside"
 		},
-		size: { converter: STRING_CONVERTER$33 }
+		size: { converter: STRING_CONVERTER$34 }
 	};
 	idGen = createCounterIdGenerator();
 	popconfirmScope = createScope(null, this.idGen);
@@ -6938,18 +7317,25 @@ var XhPopconfirmElement = class extends XhElement {
 			composed: true
 		}));
 	};
+	/** 异步确认的挂起布尔；变化时重打属性。 */
+	pendingState = false;
 	intents = {
 		onConfirm: () => {
 			this.dispatchEvent(new CustomEvent("confirm", {
 				bubbles: true,
 				composed: true
 			}));
+			return this.confirmAction?.();
 		},
 		onCancel: () => {
 			this.dispatchEvent(new CustomEvent("cancel", {
 				bubbles: true,
 				composed: true
 			}));
+		},
+		onPendingChange: (next) => {
+			this.pendingState = next;
+			this.requestUpdate();
 		}
 	};
 	ctrl = new MachineController(this, popoverMachine, () => this.machineProps(), {
@@ -7005,7 +7391,10 @@ var XhPopconfirmElement = class extends XhElement {
 		super.connectedCallback();
 	}
 	wire() {
-		const api = connectPopconfirm(this.ctrl.service, this.intents, wcNormalize);
+		const api = connectPopconfirm(this.ctrl.service, {
+			...this.intents,
+			pending: this.pendingState
+		}, wcNormalize);
 		const put = (name, props) => {
 			const el = this.getPart(name);
 			if (el) this.spreader.spread(el, props);
@@ -7028,9 +7417,9 @@ var XhPopconfirmElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/popover.ts
-const STRING_CONVERTER$32 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$33 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$18 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$22 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$23 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-popover>` —— Light-DOM 行为宿主：用户写 trigger/positioner/content/... 角色节点，
 * 元素跑 popover 机器并把 connect 产出打上去。浮层定位引擎在本元素里建好、经 refs 注入机器，
@@ -7060,23 +7449,23 @@ var XhPopoverElement = class extends XhElement {
 		meta: popoverMeta
 	};
 	static properties = {
-		open: { converter: BOOLEAN_CONVERTER$22 },
+		open: { converter: BOOLEAN_CONVERTER$23 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		placement: { converter: STRING_CONVERTER$32 },
+		placement: { converter: STRING_CONVERTER$33 },
 		offset: { converter: NUMBER_CONVERTER$18 },
-		modal: { converter: BOOLEAN_CONVERTER$22 },
+		modal: { converter: BOOLEAN_CONVERTER$23 },
 		closeOnEscape: {
-			converter: BOOLEAN_CONVERTER$22,
+			converter: BOOLEAN_CONVERTER$23,
 			attribute: "close-on-escape"
 		},
 		closeOnInteractOutside: {
-			converter: BOOLEAN_CONVERTER$22,
+			converter: BOOLEAN_CONVERTER$23,
 			attribute: "close-on-interact-outside"
 		},
-		size: { converter: STRING_CONVERTER$32 },
+		size: { converter: STRING_CONVERTER$33 },
 		translations: { attribute: false }
 	};
 	idGen = createCounterIdGenerator();
@@ -7168,9 +7557,9 @@ var XhPopoverElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/popselect.ts
-const STRING_CONVERTER$31 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$32 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$17 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$21 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$22 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-popselect>` —— Light-DOM 行为宿主：作者写 root/trigger/positioner/content/item 角色节点，
 * 元素同时跑两台机器——浮层开合、定位、消解层与焦点域归 popover，选中集合与焦点锚点归 listbox——
@@ -7217,37 +7606,37 @@ var XhPopselectElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		value: { converter: STRING_CONVERTER$31 },
+		value: { converter: STRING_CONVERTER$32 },
 		defaultValue: {
-			converter: STRING_CONVERTER$31,
+			converter: STRING_CONVERTER$32,
 			attribute: "default-value"
 		},
 		multiple: { type: Boolean },
 		disabled: { type: Boolean },
-		loop: { converter: BOOLEAN_CONVERTER$21 },
-		typeahead: { converter: BOOLEAN_CONVERTER$21 },
+		loop: { converter: BOOLEAN_CONVERTER$22 },
+		typeahead: { converter: BOOLEAN_CONVERTER$22 },
 		direction: {
-			converter: STRING_CONVERTER$31,
+			converter: STRING_CONVERTER$32,
 			attribute: "dir"
 		},
-		open: { converter: BOOLEAN_CONVERTER$21 },
+		open: { converter: BOOLEAN_CONVERTER$22 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
-		placement: { converter: STRING_CONVERTER$31 },
+		placement: { converter: STRING_CONVERTER$32 },
 		offset: { converter: NUMBER_CONVERTER$17 },
 		closeOnEscape: {
-			converter: BOOLEAN_CONVERTER$21,
+			converter: BOOLEAN_CONVERTER$22,
 			attribute: "close-on-escape"
 		},
 		closeOnInteractOutside: {
-			converter: BOOLEAN_CONVERTER$21,
+			converter: BOOLEAN_CONVERTER$22,
 			attribute: "close-on-interact-outside"
 		},
-		variant: { converter: STRING_CONVERTER$31 },
-		tone: { converter: STRING_CONVERTER$31 },
-		size: { converter: STRING_CONVERTER$31 }
+		variant: { converter: STRING_CONVERTER$32 },
+		tone: { converter: STRING_CONVERTER$32 },
+		size: { converter: STRING_CONVERTER$32 }
 	};
 	idGen = createCounterIdGenerator();
 	popselectScope = createScope(null, this.idGen);
@@ -7325,6 +7714,7 @@ var XhPopselectElement = class extends XhElement {
 		svc.refs.set("getAnchorEl", () => this.getPart("trigger"));
 		svc.refs.set("getFloatingEl", () => this.getPart("positioner"));
 		svc.refs.set("getContentEl", () => this.getPart("content"));
+		svc.refs.set("getInitialFocusEl", () => popselectInitialFocus(this.listboxCtrl.service, this.getPart("content")));
 	}
 	/**
 	* 角色节点提前发现一次：default-open 时 popover 机器在 hostConnected 当场进入 open，
@@ -7392,16 +7782,35 @@ var XhPopselectElement = class extends XhElement {
 //#endregion
 //#region src/elements/progress.ts
 /**
-* `<xh-progress>` —— Light-DOM 行为宿主，无状态机，把 connectProgress 产出打到 root/track/range 角色节点。
+* `<xh-progress>` —— Light-DOM 行为宿主，无状态机，把 connectProgress 产出打到各角色节点。
+*
+* 线形写三层 div（root > track > range）；环形要把 track 与 range 写成 `<circle>`、
+* 外面套一层 `<svg>` 当 canvas，环心的文字放进 label：
+*
+* ```html
+* <xh-progress variant="circle" value="60">
+*   <div data-part="root">
+*     <svg data-part="canvas"><circle data-part="track" /><circle data-part="range" /></svg>
+*     <div data-part="label">60%</div>
+*   </div>
+* </xh-progress>
+* ```
 *
 * @customElement xh-progress
 * @attr {number} value - 当前进度值，越界会被夹到 [0, max]，默认 0
 * @attr {number} max - 满值上限，默认 100
+* @attr {'line'|'circle'|'dashboard'} variant - 形态，默认 line
+* @attr {number} stroke-width - 环的线宽（viewBox 单位），默认 6；只对 circle / dashboard 生效
+* @attr {number} gap-degree - 缺口角度，默认 75；只对 dashboard 生效
+* @attr {'top'|'right'|'bottom'|'left'} gap-position - 缺口朝向，默认 bottom；只对 dashboard 生效
+* @attr {string} value-text - 读屏播报的文字，覆盖默认的数值播报
 * @attr {'brand'|'neutral'|'success'|'warning'|'danger'|'info'} tone - 语气
-* @attr {'sm'|'md'|'lg'} size - 尺寸
+* @attr {'sm'|'md'|'lg'} size - 尺寸：线形改厚度，环形改直径
 * @csspart root - role=progressbar 的容器（承载 aria-valuenow/aria-valuemax/data-state）
-* @csspart track - 进度轨道（满长背景）
-* @csspart range - 已完成区段，长度按百分比写成内联 inline-size
+* @csspart canvas - 承载环的 svg（线形不用）
+* @csspart track - 进度轨道：线形是满长背景，环形是整段弧
+* @csspart range - 已完成区段：线形写内联 inline-size，环形写 stroke-dashoffset
+* @csspart label - 环心那一块，写什么由使用者决定（线形不用）
 */
 var XhProgressElement = class extends XhElement {
 	static partContract = {
@@ -7411,6 +7820,17 @@ var XhProgressElement = class extends XhElement {
 	static properties = {
 		value: { type: Number },
 		max: { type: Number },
+		variant: {},
+		strokeWidth: {
+			type: Number,
+			attribute: "stroke-width"
+		},
+		gapDegree: {
+			type: Number,
+			attribute: "gap-degree"
+		},
+		gapPosition: { attribute: "gap-position" },
+		valueText: { attribute: "value-text" },
 		tone: {},
 		size: {}
 	};
@@ -7418,23 +7838,28 @@ var XhProgressElement = class extends XhElement {
 		const api = connectProgress({
 			value: this.value,
 			max: this.max,
+			variant: this.variant,
+			strokeWidth: this.strokeWidth,
+			gapDegree: this.gapDegree,
+			gapPosition: this.gapPosition,
+			valueText: this.valueText,
 			tone: this.tone,
 			size: this.size
 		}, wcNormalize);
-		const root = this.getPart("root");
-		if (root) this.spreader.spread(root, api.getRootProps());
-		const track = this.getPart("track");
-		if (track) this.spreader.spread(track, api.getTrackProps());
-		const range = this.getPart("range");
-		if (!range) return;
-		const { style, ...attrs } = api.getRangeProps();
-		this.spreader.spread(range, attrs);
-		range.style.inlineSize = style?.inlineSize ?? "";
+		const put = (name, props) => {
+			const el = this.getPart(name);
+			if (el) this.spreader.spread(el, props);
+		};
+		put("root", api.getRootProps());
+		put("canvas", api.getCanvasProps());
+		put("track", api.getTrackProps());
+		put("range", api.getRangeProps());
+		put("label", api.getLabelProps());
 	}
 };
 //#endregion
 //#region src/elements/qr-code.ts
-const STRING_CONVERTER$30 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$31 = { fromAttribute: (v) => v ?? void 0 };
 const SVG_NS = "http://www.w3.org/2000/svg";
 /** 本元素生成的几何节点的标记：作者写的节点不带它，重画时只清掉自己生成的那几个。 */
 const GEOM_ATTR = "data-xh-geom";
@@ -7461,7 +7886,7 @@ function makeGeom(doc, tag, name) {
 * @customElement xh-qr-code
 * @attr {string} value - 要编码的内容，按 UTF-8 取字节走字节模式
 * @attr {'L'|'M'|'Q'|'H'} level - 纠错级别，缺省 M
-* @attr {number} size - 像素边长，缺省 160
+* @attr {number} pixel-size - 像素边长，缺省 160
 * @attr {number} margin - 静区宽度（模块数），缺省 4
 * @attr {string} label - 可及名字，缺省用 value
 * @attr {'square'|'dot'|'rounded'} module-shape - 码点形状，缺省 square
@@ -7479,17 +7904,20 @@ var XhQrCodeElement = class extends XhElement {
 		}
 	};
 	static properties = {
-		value: { converter: STRING_CONVERTER$30 },
-		level: { converter: STRING_CONVERTER$30 },
-		label: { converter: STRING_CONVERTER$30 },
-		size: { type: Number },
+		value: { converter: STRING_CONVERTER$31 },
+		level: { converter: STRING_CONVERTER$31 },
+		label: { converter: STRING_CONVERTER$31 },
+		pixelSize: {
+			type: Number,
+			attribute: "pixel-size"
+		},
 		margin: { type: Number },
 		moduleShape: {
-			converter: STRING_CONVERTER$30,
+			converter: STRING_CONVERTER$31,
 			attribute: "module-shape"
 		},
 		eyeShape: {
-			converter: STRING_CONVERTER$30,
+			converter: STRING_CONVERTER$31,
 			attribute: "eye-shape"
 		}
 	};
@@ -7502,7 +7930,7 @@ var XhQrCodeElement = class extends XhElement {
 		const api = connectQrCode({
 			value: this.value,
 			level: this.level,
-			size: this.size,
+			pixelSize: this.pixelSize,
 			margin: this.margin,
 			label: this.label,
 			moduleShape: this.moduleShape,
@@ -7690,9 +8118,9 @@ var XhRadioGroupElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/rating.ts
-const STRING_CONVERTER$29 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$30 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$16 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$20 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$21 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-rating>` —— Light-DOM 行为宿主：作者写 root/label/control 与若干 item 角色节点
 * （可选再写一个 hidden-input 参与表单提交），元素跑 rating 机器并把 connect 产出打上去。
@@ -7705,6 +8133,7 @@ const BOOLEAN_CONVERTER$20 = { fromAttribute: (v) => v === null ? void 0 : v !==
 * @attr {number} default-value - 非受控初值，缺省 0（还没评）
 * @attr {number} count - 星星颗数，默认 5
 * @attr {boolean} allow-half - 允许半颗星：档位从 1 变成 0.5
+* @attr {boolean} allow-clear - 再点当前档位清零，键盘最低档再往下也清；默认开，写 "false" 关
 * @attr {boolean} disabled - 整个不可交互：整条带子退出 Tab 序列，指针与键盘都不认
 * @attr {boolean} read-only - 只读：仍可聚焦与朗读，但改不动，也没有悬停预览
 * @attr {boolean} required - 必填标注；表单影子据此参与原生校验
@@ -7734,22 +8163,26 @@ var XhRatingElement = class extends XhElement {
 		},
 		count: { converter: NUMBER_CONVERTER$16 },
 		allowHalf: {
-			converter: BOOLEAN_CONVERTER$20,
+			converter: BOOLEAN_CONVERTER$21,
 			attribute: "allow-half"
 		},
-		disabled: { converter: BOOLEAN_CONVERTER$20 },
+		allowClear: {
+			converter: BOOLEAN_CONVERTER$21,
+			attribute: "allow-clear"
+		},
+		disabled: { converter: BOOLEAN_CONVERTER$21 },
 		readOnly: {
-			converter: BOOLEAN_CONVERTER$20,
+			converter: BOOLEAN_CONVERTER$21,
 			attribute: "read-only"
 		},
-		required: { converter: BOOLEAN_CONVERTER$20 },
-		name: { converter: STRING_CONVERTER$29 },
+		required: { converter: BOOLEAN_CONVERTER$21 },
+		name: { converter: STRING_CONVERTER$30 },
 		direction: {
-			converter: STRING_CONVERTER$29,
+			converter: STRING_CONVERTER$30,
 			attribute: "dir"
 		},
-		tone: { converter: STRING_CONVERTER$29 },
-		size: { converter: STRING_CONVERTER$29 }
+		tone: { converter: STRING_CONVERTER$30 },
+		size: { converter: STRING_CONVERTER$30 }
 	};
 	notifyValue = (details) => {
 		this.dispatchEvent(new CustomEvent("value-change", {
@@ -7772,6 +8205,7 @@ var XhRatingElement = class extends XhElement {
 			defaultValue: this.defaultValue,
 			count: this.count,
 			allowHalf: this.allowHalf ?? false,
+			allowClear: this.allowClear,
 			disabled: this.disabled ?? false,
 			readOnly: this.readOnly ?? false,
 			required: this.required ?? false,
@@ -7814,7 +8248,7 @@ var XhRatingElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/result.ts
-const STRING_CONVERTER$28 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$29 = { fromAttribute: (v) => v ?? void 0 };
 /**
 * `<xh-result>` —— 结果页行为宿主，无状态机，把 connectResult 产出的属性打到角色节点上。
 *
@@ -7838,8 +8272,8 @@ var XhResultElement = class extends XhElement {
 		meta: resultMeta
 	};
 	static properties = {
-		status: { converter: STRING_CONVERTER$28 },
-		size: { converter: STRING_CONVERTER$28 }
+		status: { converter: STRING_CONVERTER$29 },
+		size: { converter: STRING_CONVERTER$29 }
 	};
 	wire() {
 		const api = connectResult({
@@ -7859,7 +8293,7 @@ var XhResultElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/scroll-area.ts
-const STRING_CONVERTER$27 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$28 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$15 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 /**
 * `<xh-scroll-area>` —— Light-DOM 行为宿主：作者写 root/viewport/content/scrollbar/thumb/corner
@@ -7894,14 +8328,14 @@ var XhScrollAreaElement = class extends XhElement {
 		meta: scrollAreaMeta
 	};
 	static properties = {
-		type: { converter: STRING_CONVERTER$27 },
+		type: { converter: STRING_CONVERTER$28 },
 		scrollHideDelay: {
 			converter: NUMBER_CONVERTER$15,
 			attribute: "scroll-hide-delay"
 		},
-		orientation: { converter: STRING_CONVERTER$27 },
+		orientation: { converter: STRING_CONVERTER$28 },
 		direction: {
-			converter: STRING_CONVERTER$27,
+			converter: STRING_CONVERTER$28,
 			attribute: "dir"
 		}
 	};
@@ -7955,9 +8389,9 @@ var XhScrollAreaElement = class extends XhElement {
 };
 //#endregion
 //#region src/elements/select.ts
-const STRING_CONVERTER$26 = { fromAttribute: (v) => v ?? void 0 };
+const STRING_CONVERTER$27 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$14 = { fromAttribute: (v) => v === null ? void 0 : Number(v) };
-const BOOLEAN_CONVERTER$19 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+const BOOLEAN_CONVERTER$20 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
 * `<xh-select>` —— Light-DOM 行为宿主：用户写 root/trigger/value-text/positioner/content/item/...
 * 角色节点，元素跑 select 机器并把 connect 产出打上去。浮层定位引擎在本元素里建好、经 refs 注入机器，
@@ -7973,6 +8407,8 @@ const BOOLEAN_CONVERTER$19 = { fromAttribute: (v) => v === null ? void 0 : v !==
 * @attr {boolean} open - 受控开合；缺省该属性即非受控
 * @attr {boolean} default-open - 非受控初始为展开
 * @attr {boolean} disabled - 整个控件禁用：trigger 用原生 disabled，表单影子不参与提交
+* @attr {boolean} invalid - 校验错误态：trigger 标红并输出 aria-invalid
+* @attr {number} max-tag-count - 多选标签最多摆几个，其余折进 api 的 overflowCount；缺省全摆
 * @attr {boolean} required - 原生表单校验：无选中值时提交被拦下；多选下的门槛是至少选中一项
 * @attr {string} name - 表单字段名；给定后表单影子才带 name 并参与提交
 * @attr {string} placeholder - 无选中时 value-text 显示的占位文字
@@ -7991,6 +8427,10 @@ const BOOLEAN_CONVERTER$19 = { fromAttribute: (v) => v === null ? void 0 : v !==
 * @csspart trigger - 触发按钮（aria-haspopup=listbox/aria-expanded/aria-controls 所在），同时是定位锚点，须是原生 button
 * @csspart value-text - 选中项文本的显示位；留空即由元素填入 displayText，作者写了内容则归作者
 * @csspart indicator - 展开指示符（aria-hidden，data-state 随开合）
+* @csspart control - 触发器与清空按钮的收纳容器兼定位基准；清空钮据此嵌进触发器右端、悬停时替换展开指示符
+* @csspart clear-trigger - 清空按钮：trigger 的兄弟节点（放进 control 即内嵌形态），没选中或禁用时带 hidden；可及名走 translations.clear
+* @csspart tag - 多选标签，须自带 value 属性标识选中值；放触发器里是纯展示，放外面配 tag-remove 可删
+* @csspart tag-remove - 标签删除按钮，须放在 tag 里；点按摘掉所在标签的选中值，可及名走 translations.removeTag
 * @csspart positioner - 浮层定位容器，坐标由引擎写成内联样式
 * @csspart content - role=listbox 容器（焦点域与消解层的根节点，键盘在此收口），收起时带 hidden
 * @csspart item - role=option 条目，须自带 value 属性标识身份；禁用写 aria-disabled="true"
@@ -8005,31 +8445,37 @@ var XhSelectElement = class extends XhElement {
 	};
 	static properties = {
 		collection: { attribute: false },
-		value: { converter: STRING_CONVERTER$26 },
+		value: { converter: STRING_CONVERTER$27 },
 		defaultValue: {
-			converter: STRING_CONVERTER$26,
+			converter: STRING_CONVERTER$27,
 			attribute: "default-value"
 		},
-		open: { converter: BOOLEAN_CONVERTER$19 },
+		open: { converter: BOOLEAN_CONVERTER$20 },
 		defaultOpen: {
 			type: Boolean,
 			attribute: "default-open"
 		},
 		disabled: { type: Boolean },
+		invalid: { type: Boolean },
 		required: { type: Boolean },
-		name: { converter: STRING_CONVERTER$26 },
-		placeholder: { converter: STRING_CONVERTER$26 },
-		placement: { converter: STRING_CONVERTER$26 },
+		name: { converter: STRING_CONVERTER$27 },
+		placeholder: { converter: STRING_CONVERTER$27 },
+		placement: { converter: STRING_CONVERTER$27 },
 		offset: { converter: NUMBER_CONVERTER$14 },
-		loop: { converter: BOOLEAN_CONVERTER$19 },
+		loop: { converter: BOOLEAN_CONVERTER$20 },
 		multiple: { type: Boolean },
 		direction: {
-			converter: STRING_CONVERTER$26,
+			converter: STRING_CONVERTER$27,
 			attribute: "dir"
 		},
-		variant: { converter: STRING_CONVERTER$26 },
-		tone: { converter: STRING_CONVERTER$26 },
-		size: { converter: STRING_CONVERTER$26 }
+		variant: { converter: STRING_CONVERTER$27 },
+		tone: { converter: STRING_CONVERTER$27 },
+		size: { converter: STRING_CONVERTER$27 },
+		translations: { attribute: false },
+		maxTagCount: {
+			converter: NUMBER_CONVERTER$14,
+			attribute: "max-tag-count"
+		}
 	};
 	idGen = createCounterIdGenerator();
 	selectScope = createScope(null, this.idGen);
@@ -8067,6 +8513,7 @@ var XhSelectElement = class extends XhElement {
 			open: this.open,
 			defaultOpen: this.defaultOpen ?? false,
 			disabled: this.disabled ?? false,
+			invalid: this.invalid ?? false,
 			required: this.required ?? false,
 			name: this.name,
 			placeholder: this.placeholder,
@@ -8078,6 +8525,8 @@ var XhSelectElement = class extends XhElement {
 			variant: this.variant,
 			tone: this.tone,
 			size: this.size,
+			translations: this.translations,
+			maxTagCount: this.maxTagCount,
 			onValueChange: this.notifyValue,
 			onOpenChange: this.notifyOpen
 		};
@@ -8177,8 +8626,15 @@ var XhSelectElement = class extends XhElement {
 		};
 		put("root", api.getRootProps());
 		put("label", api.getLabelProps());
+		put("control", api.getControlProps());
 		put("trigger", api.getTriggerProps());
 		put("indicator", api.getIndicatorProps());
+		put("clear-trigger", api.getClearTriggerProps());
+		for (const el of this.getParts("tag")) this.spreader.spread(el, api.getTagProps({ value: el.getAttribute("value") ?? "" }));
+		for (const el of this.getParts("tag-remove")) {
+			const owner = el.closest("[data-xh-part=\"tag\"]");
+			this.spreader.spread(el, api.getTagRemoveProps({ value: owner?.getAttribute("value") ?? "" }));
+		}
 		put("positioner", api.getPositionerProps());
 		put("content", api.getContentProps());
 		const valueText = this.getPart("value-text");
@@ -8237,6 +8693,175 @@ var XhSeparatorElement = class extends XhElement {
 	}
 };
 //#endregion
+//#region src/elements/side-nav.ts
+const STRING_CONVERTER$26 = { fromAttribute: (v) => v ?? void 0 };
+const BOOLEAN_CONVERTER$19 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
+/** 分支一系的归属容器；嵌套分支各认最近的那个。 */
+const BRANCH_SELECTOR$2 = "[data-xh-part=\"branch\"]";
+/** 分组一系的归属容器。 */
+const GROUP_SELECTOR = "[data-xh-part=\"group\"]";
+/**
+* `<xh-side-nav>` —— Light-DOM 行为宿主：管理后台侧栏导航。
+* 作者写 root/list 与若干 branch / link 角色节点，元素跑 side-nav 机器并把 connect 产出打上去。
+* 节点身份取自节点上的 value 属性；href 与禁用查 `collection` 这份树数据。
+*
+* @customElement xh-side-nav
+* @attr {string} value - 受控选中的叶子；缺省该属性即非受控
+* @attr {string} default-value - 非受控初始选中
+* @attr {boolean} accordion - 同层手风琴：展开一枝收起同层其余，默认 false
+* @attr {boolean} collapsed - 折叠成图标栏（内嵌展开整体收起、文字由皮肤藏掉；顶层分支换装浮层弹出）
+* @attr {boolean} collapsed-popout - 折叠态下顶层分支是否弹出子级面板，默认 true
+* @attr {boolean} disabled - 整个侧栏禁用
+* @attr {boolean} loop - 上下键走到首尾回绕，默认关
+* @attr {'ltr'|'rtl'} dir - 文字方向，只对调左右方向键的展开/收起语义，默认 ltr
+* @fires value-change - 选中变化；detail 为 `{ value: string | null }`
+* @fires expanded-change - 展开集合变化；detail 为 `{ value: string[] }`
+* @csspart root - nav 地标根容器（aria-label 由 translations.root 给）
+* @csspart list - 顶层列表容器
+* @csspart group - role=group 分组，须自带 value 属性
+* @csspart group-label - 分组标题（aria-labelledby 目标）
+* @csspart branch - 分支行容器，须自带 value 属性；它裹着自己的 branch-content
+* @csspart branch-trigger - 展开/收起按钮（aria-expanded / aria-controls）
+* @csspart branch-text - 行文字载体，折叠成图标栏时隐藏
+* @csspart branch-indicator - 展开方向指示符（aria-hidden）
+* @csspart branch-content - 内嵌子层容器，收起时隐藏
+* @csspart link - 去处链接，须自带 value 属性；选中输出 aria-current="page"
+* @csspart link-text - 链接文字载体，折叠成图标栏时隐藏
+*/
+var XhSideNavElement = class extends XhElement {
+	static partContract = {
+		anatomy: sideNavAnatomy,
+		meta: sideNavMeta
+	};
+	static properties = {
+		value: { converter: STRING_CONVERTER$26 },
+		defaultValue: {
+			converter: STRING_CONVERTER$26,
+			attribute: "default-value"
+		},
+		accordion: { converter: BOOLEAN_CONVERTER$19 },
+		collapsed: { converter: BOOLEAN_CONVERTER$19 },
+		collapsedPopout: {
+			converter: BOOLEAN_CONVERTER$19,
+			attribute: "collapsed-popout"
+		},
+		disabled: { converter: BOOLEAN_CONVERTER$19 },
+		loop: { converter: BOOLEAN_CONVERTER$19 },
+		direction: {
+			converter: STRING_CONVERTER$26,
+			attribute: "dir"
+		},
+		collection: { attribute: false },
+		expandedValue: { attribute: false },
+		defaultExpandedValue: { attribute: false },
+		translations: { attribute: false }
+	};
+	notifyValue = (details) => {
+		this.dispatchEvent(new CustomEvent("value-change", {
+			detail: details,
+			bubbles: true,
+			composed: true
+		}));
+	};
+	notifyExpanded = (details) => {
+		this.dispatchEvent(new CustomEvent("expanded-change", {
+			detail: details,
+			bubbles: true,
+			composed: true
+		}));
+	};
+	idGen = createCounterIdGenerator();
+	navScope = createScope(null, this.idGen);
+	positionEngine = createPositionEngine();
+	config = null;
+	ctrl = new MachineController(this, sideNavMachine, () => this.machineProps(), {
+		scope: this.navScope,
+		onBuilt: (svc) => this.injectRefs(svc)
+	});
+	machineProps() {
+		return {
+			collection: this.collection,
+			value: this.value,
+			defaultValue: this.defaultValue,
+			expandedValue: this.expandedValue,
+			defaultExpandedValue: this.defaultExpandedValue,
+			accordion: this.accordion,
+			collapsed: this.collapsed,
+			collapsedPopout: this.collapsedPopout,
+			disabled: this.disabled,
+			loop: this.loop,
+			dir: this.direction,
+			translations: this.translations,
+			onValueChange: this.notifyValue,
+			onExpandedChange: this.notifyExpanded
+		};
+	}
+	ensureConfig() {
+		if (this.config) return;
+		this.config = createRuntimeConfig({
+			scope: this.navScope,
+			idGenerator: this.idGen
+		});
+	}
+	/** 当前弹出分支名下的角色节点：按归属分支的 value 现查。 */
+	findPopoutPart(svc, name) {
+		const v = svc.context.get("popoutValue");
+		if (v == null) return null;
+		for (const el of this.getParts(name)) if (this.nodeOf(el, BRANCH_SELECTOR$2).value === v) return el;
+		return null;
+	}
+	registerLayer = () => {
+		this.ensureConfig();
+		const svc = this.ctrl.service;
+		return this.config.layerRegistry.register({
+			kind: "popover",
+			node: () => this.findPopoutPart(svc, "branch-content"),
+			branches: () => [this.findPopoutPart(svc, "branch-trigger")].filter(Boolean),
+			isModal: () => false,
+			setModal: () => {},
+			surfaces: () => []
+		});
+	};
+	injectRefs(svc) {
+		this.ensureConfig();
+		svc.refs.set("config", this.config);
+		svc.refs.set("registerLayer", this.registerLayer);
+		svc.refs.set("position", this.positionEngine);
+		svc.refs.set("getPopoutAnchorEl", () => this.findPopoutPart(svc, "branch-trigger"));
+		svc.refs.set("getPopoutContentEl", () => this.findPopoutPart(svc, "branch-content"));
+	}
+	nodeOf(el, selector) {
+		const owner = el.closest(selector);
+		return { value: (owner && owner !== this && this.contains(owner) ? owner : el).getAttribute("value") ?? "" };
+	}
+	disconnectedCallback() {
+		super.disconnectedCallback();
+		this.config = null;
+	}
+	wire() {
+		const api = connectSideNav(this.ctrl.service, wcNormalize);
+		const put = (name, props) => {
+			const el = this.getPart(name);
+			if (el) this.spreader.spread(el, props);
+		};
+		put("root", api.getRootProps());
+		put("list", api.getListProps());
+		const putAll = (name, selector, get) => {
+			for (const el of this.getParts(name)) this.spreader.spread(el, get(this.nodeOf(el, selector)));
+		};
+		putAll("group", GROUP_SELECTOR, (node) => api.getGroupProps(node));
+		putAll("group-label", GROUP_SELECTOR, (node) => api.getGroupLabelProps(node));
+		putAll("branch", BRANCH_SELECTOR$2, (node) => api.getBranchProps(node));
+		putAll("branch-trigger", BRANCH_SELECTOR$2, (node) => api.getBranchTriggerProps(node));
+		putAll("branch-indicator", BRANCH_SELECTOR$2, (node) => api.getBranchIndicatorProps(node));
+		for (const el of this.getParts("branch-text")) this.spreader.spread(el, api.getBranchTextProps());
+		for (const el of this.getParts("link-text")) this.spreader.spread(el, api.getLinkTextProps());
+		putAll("branch-content", BRANCH_SELECTOR$2, (node) => api.getBranchContentProps(node));
+		putAll("link", "[data-xh-part=\"link\"]", (node) => api.getLinkProps(node));
+		for (const el of this.getParts("branch-content")) this.setPartHidden(el, el.hasAttribute("hidden"));
+	}
+};
+//#endregion
 //#region src/elements/skeleton.ts
 const STRING_CONVERTER$25 = { fromAttribute: (v) => v ?? void 0 };
 const BOOLEAN_CONVERTER$18 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
@@ -8315,6 +8940,7 @@ const NUMBER_LIST_CONVERTER$1 = { fromAttribute: (v) => {
 * @attr {number} step - 方向键与吸附网格的步长，默认 1
 * @attr {number} large-step - PageUp/PageDown 的步长，默认 10 倍 step
 * @attr {number} min-steps-between-thumbs - 相邻滑块至少隔几格，默认 0
+* @attr {boolean} snap-to-marks - 只认刻度落点：拖动、点按与键盘都吸到最近/下一档刻度；刻度表经 marks property 赋
 * @attr {'horizontal'|'vertical'} orientation - 轨道朝向，默认 horizontal
 * @attr {'ltr'|'rtl'} dir - 文字方向，只改写水平轨道上左右两键与指针的语义，默认 ltr
 * @attr {boolean} disabled - 禁用：拇指退出 Tab 序列、推不动、不参与表单提交
@@ -8330,6 +8956,9 @@ const NUMBER_LIST_CONVERTER$1 = { fromAttribute: (v) => {
 * @csspart control - 指针命中区，按下即跳到落点并接管拖动
 * @csspart track - 轨道本体，值与坐标的换算以它的矩形为准
 * @csspart range - 已选区间，起止由内联逻辑属性给出
+* @csspart marks - 刻度容器
+* @csspart mark - 刻度点（纯装饰），须自带 value 属性；落进已选区间带 data-active
+* @csspart mark-label - 刻度文案，须自带 value 属性；点按把最近的滑块跳到这一档
 * @csspart thumb - role=slider 的拇指，键盘交互全在它身上；多滑块须写 index 属性
 * @csspart hidden-input - 拇指内的表单影子（须是原生 input）
 */
@@ -8355,6 +8984,11 @@ var XhSliderElement = class extends XhElement {
 			converter: NUMBER_CONVERTER$13,
 			attribute: "min-steps-between-thumbs"
 		},
+		snapToMarks: {
+			converter: BOOLEAN_CONVERTER$17,
+			attribute: "snap-to-marks"
+		},
+		marks: { attribute: false },
 		orientation: { converter: STRING_CONVERTER$24 },
 		direction: {
 			converter: STRING_CONVERTER$24,
@@ -8400,6 +9034,8 @@ var XhSliderElement = class extends XhElement {
 			step: this.step,
 			largeStep: this.largeStep,
 			minStepsBetweenThumbs: this.minStepsBetweenThumbs,
+			marks: this.marks,
+			snapToMarks: this.snapToMarks,
 			orientation: this.orientation,
 			dir: this.direction,
 			disabled: this.disabled ?? false,
@@ -8438,6 +9074,9 @@ var XhSliderElement = class extends XhElement {
 		put("control", api.getControlProps());
 		put("track", api.getTrackProps());
 		put("range", api.getRangeProps());
+		put("marks", api.getMarksProps());
+		for (const el of this.getParts("mark")) this.spreader.spread(el, api.getMarkProps({ value: Number(el.getAttribute("value")) }));
+		for (const el of this.getParts("mark-label")) this.spreader.spread(el, api.getMarkLabelProps({ value: Number(el.getAttribute("value")) }));
 		for (const el of this.getParts("thumb")) {
 			const index = this.thumbIndex(el);
 			this.spreader.spread(el, api.getThumbProps(index));
@@ -8491,7 +9130,7 @@ const STRING_CONVERTER$22 = { fromAttribute: (v) => v ?? void 0 };
 const NUMBER_CONVERTER$12 = { fromAttribute: (v) => v == null || v === "" ? void 0 : Number(v) };
 const BOOLEAN_CONVERTER$16 = { fromAttribute: (v) => v === null ? void 0 : v !== "false" };
 /**
-* 布局是百分比数组，属性写成逗号分隔（两栏 size="30,70"）。
+* 布局是百分比数组，属性写成逗号分隔（两栏 sizes="30,70"）。
 * 解析不出任何有限数就当没写：留下 NaN 会一路写进 aria-valuenow 与定位百分比。
 */
 const NUMBER_LIST_CONVERTER = { fromAttribute: (v) => {
@@ -8529,16 +9168,16 @@ const PANELS_CONVERTER = { fromAttribute: (v) => {
 * 第 index 条分隔条坐在第 index 与第 index+1 块面板之间，调整的是前一块。
 *
 * @customElement xh-splitter
-* @attr {string} size - 受控布局，逗号分隔的百分比（如 "30,70"）；缺省该属性即非受控
-* @attr {string} default-size - 非受控初值，同样逗号分隔；缺省时按面板数等分
+* @attr {string} sizes - 受控布局，逗号分隔的百分比（如 "30,70"）；缺省该属性即非受控
+* @attr {string} default-sizes - 非受控初值，同样逗号分隔；缺省时按面板数等分
 * @attr {string} panels - 逐块约束的 JSON 数组：id / min / max / collapsible / collapsedSize
 * @attr {'horizontal'|'vertical'} orientation - 面板排布轴，默认 horizontal（并排）
 * @attr {'ltr'|'rtl'} dir - 文字方向，只对调水平排布下左右两键与指针位移的正负，默认 ltr
 * @attr {boolean} disabled - 禁用：分隔条退出 Tab 序列、拖不动也推不动
 * @attr {number} step - 方向键的步长（百分比），默认 1
 * @attr {number} large-step - Shift + 方向键的步长（百分比），默认 10
-* @fires size-change - 布局变化（拖动途中会连发）；detail 为 `{ size: number[] }`
-* @fires size-change-end - 一次拖拽收尾发一次；detail 为 `{ size: number[], index: number }`
+* @fires sizes-change - 布局变化（拖动途中会连发）；detail 为 `{ sizes: number[] }`
+* @fires sizes-change-end - 一次拖拽收尾发一次；detail 为 `{ sizes: number[], index: number }`
 * @csspart root - 承载 data-orientation / data-disabled / data-dragging 的容器，矩形以它为准
 * @csspart panel - 一块面板；尺寸由内联 flex-basis 给出，折叠时带 data-collapsed
 * @csspart resize-trigger - role=separator 的分隔条，指针与键盘交互全在它身上
@@ -8549,10 +9188,10 @@ var XhSplitterElement = class extends XhElement {
 		meta: splitterMeta
 	};
 	static properties = {
-		size: { converter: NUMBER_LIST_CONVERTER },
-		defaultSize: {
+		sizes: { converter: NUMBER_LIST_CONVERTER },
+		defaultSizes: {
 			converter: NUMBER_LIST_CONVERTER,
-			attribute: "default-size"
+			attribute: "default-sizes"
 		},
 		panels: { converter: PANELS_CONVERTER },
 		orientation: { converter: STRING_CONVERTER$22 },
@@ -8570,14 +9209,14 @@ var XhSplitterElement = class extends XhElement {
 	idGen = createCounterIdGenerator();
 	splitterScope = createScope(null, this.idGen);
 	notifySize = (details) => {
-		this.dispatchEvent(new CustomEvent("size-change", {
+		this.dispatchEvent(new CustomEvent("sizes-change", {
 			detail: details,
 			bubbles: true,
 			composed: true
 		}));
 	};
 	notifySizeEnd = (details) => {
-		this.dispatchEvent(new CustomEvent("size-change-end", {
+		this.dispatchEvent(new CustomEvent("sizes-change-end", {
 			detail: details,
 			bubbles: true,
 			composed: true
@@ -8589,16 +9228,16 @@ var XhSplitterElement = class extends XhElement {
 	});
 	machineProps() {
 		return {
-			size: this.size,
-			defaultSize: this.defaultSize,
+			sizes: this.sizes,
+			defaultSizes: this.defaultSizes,
 			panels: this.panels,
 			orientation: this.orientation,
 			dir: this.direction,
 			disabled: this.disabled ?? false,
 			step: this.step,
 			largeStep: this.largeStep,
-			onSizeChange: this.notifySize,
-			onSizeChangeEnd: this.notifySizeEnd
+			onSizesChange: this.notifySize,
+			onSizesChangeEnd: this.notifySizeEnd
 		};
 	}
 	injectRefs(svc) {
@@ -8812,11 +9451,14 @@ var XhStepsElement = class extends XhElement {
 * @attr {boolean} checked - 受控开合；缺省该属性即非受控
 * @attr {boolean} default-checked - 非受控初始为选中
 * @attr {boolean} disabled - 禁用
+* @attr {boolean} loading - 提交中：交互挂起、滑块转圈，仍可聚焦（aria-busy）
 * @attr {'brand'|'neutral'|'success'|'warning'|'danger'|'info'} tone - 语气
 * @attr {'sm'|'md'|'lg'} size - 尺寸
 * @fires checked-change - checked 状态变化；detail 为 `{ checked: boolean }`
 * @csspart root - role=switch 的按钮（承载 aria-checked / data-state）
 * @csspart thumb - 滑块
+* @attr {string} name - 表单字段名；给了 hidden-input 才参与提交
+* @csspart hidden-input - type=hidden 的表单出口，省略该节点即不参与表单
 */
 var XhSwitchElement = class extends XhElement {
 	static partContract = {
@@ -8830,6 +9472,9 @@ var XhSwitchElement = class extends XhElement {
 			attribute: "default-checked"
 		},
 		disabled: { type: Boolean },
+		loading: { type: Boolean },
+		name: { converter: { fromAttribute: (v) => v ?? void 0 } },
+		value: { converter: { fromAttribute: (v) => v ?? void 0 } },
 		tone: {},
 		size: {}
 	};
@@ -8846,8 +9491,11 @@ var XhSwitchElement = class extends XhElement {
 			checked: this.checked,
 			defaultChecked: this.defaultChecked ?? false,
 			disabled: this.disabled ?? false,
+			loading: this.loading ?? false,
 			tone: this.tone,
 			size: this.size,
+			name: this.name,
+			value: this.value,
 			onCheckedChange: this.notify
 		};
 	}
@@ -8857,6 +9505,8 @@ var XhSwitchElement = class extends XhElement {
 		if (root) this.spreader.spread(root, api.getRootProps());
 		const thumb = this.getPart("thumb");
 		if (thumb) this.spreader.spread(thumb, api.getThumbProps());
+		const hidden = this.getPart("hidden-input");
+		if (hidden) this.spreader.spread(hidden, api.getHiddenInputProps());
 	}
 };
 //#endregion
@@ -8907,7 +9557,7 @@ const FOOTER_SELECTOR = "[data-xh-part=\"footer\"]";
 * @csspart sort-trigger - 排序把手，自占一个 Tab 位；按住 Shift 点是追加到排序链
 * @csspart expand-trigger - 展开把手（aria-hidden 且不占 Tab 位，键盘那一路由左右方向键承担）
 * @csspart expanded-row - role=row 详情行，须自带 value 属性与它所属的数据行配对，内部须放一个 cell 承载详情；收起时 hidden
-* @csspart empty-state - 空态节点，表体为空且不在加载时显形
+* @csspart empty - 空态节点，表体为空且不在加载时显形
 * @csspart loading-state - 加载态节点，表体为空且正在加载时显形
 */
 var XhTableElement = class extends XhElement {
@@ -9028,9 +9678,9 @@ var XhTableElement = class extends XhElement {
 		put("header", api.getHeaderProps());
 		put("body", api.getBodyProps());
 		put("footer", api.getFooterProps());
-		const emptyProps = api.getEmptyStateProps();
+		const emptyProps = api.getEmptyProps();
 		const loadingProps = api.getLoadingStateProps();
-		put("empty-state", emptyProps);
+		put("empty", emptyProps);
 		put("loading-state", loadingProps);
 		const putAll = (name, get) => {
 			for (const el of this.getParts(name)) this.spreader.spread(el, get(el));
@@ -9059,7 +9709,7 @@ var XhTableElement = class extends XhElement {
 		putAll("expanded-row", (el) => api.getExpandedRowProps({ value: el.getAttribute("value") ?? "" }));
 		for (const el of this.getParts("row")) if (el.hasAttribute("disabled")) el.removeAttribute("disabled");
 		for (const el of this.getParts("expanded-row")) this.setPartHidden(el, !api.isExpanded(el.getAttribute("value") ?? ""));
-		this.setPartHidden(this.getPart("empty-state"), !!emptyProps.hidden);
+		this.setPartHidden(this.getPart("empty"), !!emptyProps.hidden);
 		this.setPartHidden(this.getPart("loading-state"), !!loadingProps.hidden);
 	}
 };
@@ -9374,6 +10024,7 @@ const BOOLEAN_CONVERTER$11 = { fromAttribute: (v) => v === null ? void 0 : v !==
 * @attr {string} name - 表单字段名；给了才参与提交
 * @attr {number} max-length - 字符数上限；同时落成原生 maxlength 与机器侧截断
 * @attr {boolean} clearable - 开启清空：清空按钮显出并在有值时可用，Escape 接管
+* @attr {boolean} auto-size - 多行宿主（input 部件写成 textarea）的自动高度；行数界限对象经 autoSize property 赋
 * @attr {'outline'|'subtle'|'ghost'} variant - 视觉变体
 * @attr {'brand'|'neutral'|'success'|'warning'|'danger'|'info'} tone - 语气
 * @attr {'sm'|'md'|'lg'} size - 尺寸
@@ -9408,6 +10059,10 @@ var XhTextFieldElement = class extends XhElement {
 			attribute: "max-length"
 		},
 		clearable: { converter: BOOLEAN_CONVERTER$11 },
+		autoSize: {
+			converter: BOOLEAN_CONVERTER$11,
+			attribute: "auto-size"
+		},
 		variant: { converter: STRING_CONVERTER$16 },
 		tone: { converter: STRING_CONVERTER$16 },
 		size: { converter: STRING_CONVERTER$16 }
@@ -9432,6 +10087,7 @@ var XhTextFieldElement = class extends XhElement {
 			name: this.name,
 			maxLength: this.maxLength,
 			clearable: this.clearable ?? false,
+			autoSize: this.autoSize,
 			variant: this.variant,
 			tone: this.tone,
 			size: this.size,
@@ -9446,7 +10102,10 @@ var XhTextFieldElement = class extends XhElement {
 		};
 		put("root", api.getRootProps());
 		put("label", api.getLabelProps());
-		put("input", api.getInputProps());
+		const inputEl = this.getPart("input");
+		const host = inputEl?.tagName === "TEXTAREA" ? "textarea" : "input";
+		put("input", api.getInputProps({ as: host }));
+		if (host === "textarea" && inputEl) autoSizeTextarea(inputEl, api.autoSize);
 		put("clear-trigger", api.getClearTriggerProps());
 		this.setPartHidden(this.getPart("clear-trigger"), !api.clearable);
 	}
@@ -9768,7 +10427,7 @@ function declaredUnit(el, position) {
 }
 /**
 * `<xh-time-picker>` —— Light-DOM 行为宿主：作者写 root/label/control/input（多个）/trigger/
-* clear-trigger/positioner/content/column（多个）/option（多个）/hidden-input 角色节点，
+* clear-trigger/positioner/content/column（多个）/item（多个）/hidden-input 角色节点，
 * 元素跑 time-picker 机器并把 connect 产出打上去。浮层定位引擎在本元素里建好、经 refs 注入机器，
 * 锚点取 control（浮层因此与整个输入行对齐），被定位的浮层取 positioner。
 *
@@ -9806,7 +10465,7 @@ function declaredUnit(el, position) {
 * @csspart positioner - 浮层定位容器，坐标由引擎写成内联样式
 * @csspart content - 浮层容器（消解层与焦点域的根节点），收起时带 hidden
 * @csspart column - role=listbox 的一列，可自带 unit 属性声明单位，缺省按文档序
-* @csspart option - role=option 的一格，须自带 value 属性（两位补零的显示串）
+* @csspart item - role=option 的一格，须自带 value 属性（两位补零的显示串）
 * @csspart hidden-input - type=hidden 的表单出口，值是完整 ISO 串
 */
 var XhTimePickerElement = class extends XhElement {
@@ -9958,13 +10617,13 @@ var XhTimePickerElement = class extends XhElement {
 			const unit = declaredUnit(columnEl, position);
 			this.spreader.spread(columnEl, api.getColumnProps({ unit }));
 			this.setPartHidden(columnEl, !api.columns.some((column) => column.unit === unit));
-			for (const optionEl of this.getParts("option").filter((el) => columnEl.contains(el))) {
-				const value = optionEl.getAttribute("value") ?? "";
-				this.spreader.spread(optionEl, api.getOptionProps({
+			for (const itemEl of this.getParts("item").filter((el) => columnEl.contains(el))) {
+				const value = itemEl.getAttribute("value") ?? "";
+				this.spreader.spread(itemEl, api.getItemProps({
 					unit,
 					value
 				}));
-				this.fillText(optionEl, value);
+				this.fillText(itemEl, value);
 			}
 		});
 		this.setPartHidden(this.getPart("content"), !api.open);
@@ -10734,6 +11393,7 @@ const BOOLEAN_CONVERTER$4 = { fromAttribute: (v) => v === null ? void 0 : v !==
 * @attr {boolean} close-on-interact-outside - 层外交互关闭，默认 false；写 "true" 打开
 * @attr {boolean} show-backdrop - 画遮罩，默认 true；写 show-backdrop="false" 关掉
 * @attr {number} spotlight-padding - 高亮框在目标四周留出的空白（px），默认 8
+* @attr {boolean} auto-scroll - 展开与换步时自动把目标滚进视口（nearest），默认 true；写 auto-scroll="false" 关掉
 * @fires open-change - open 状态变化；detail 为 `{ open: boolean }`
 * @fires step-change - 步序变化；detail 为 `{ step: number }`
 * @fires complete - 末步再按下一步；detail 为 `{ step: number }`
@@ -10786,6 +11446,10 @@ var XhTourElement = class extends XhElement {
 			converter: NUMBER_CONVERTER$3,
 			attribute: "spotlight-padding"
 		},
+		autoScroll: {
+			converter: BOOLEAN_CONVERTER$4,
+			attribute: "auto-scroll"
+		},
 		steps: { attribute: false },
 		translations: { attribute: false }
 	};
@@ -10825,6 +11489,7 @@ var XhTourElement = class extends XhElement {
 			closeOnInteractOutside: this.closeOnInteractOutside,
 			showBackdrop: this.showBackdrop,
 			spotlightPadding: this.spotlightPadding,
+			autoScroll: this.autoScroll,
 			translations: this.translations,
 			onOpenChange: this.notifyOpen,
 			onStepChange: this.notifyStep,
@@ -10887,6 +11552,10 @@ var XhTourElement = class extends XhElement {
 	wire() {
 		this.wireWith(this.ctrl.service);
 	}
+	/** 重量高亮框与浮层位置：目标节点被外部改动（换位、变尺寸）后调它校准。 */
+	remeasure() {
+		this.ctrl?.service.send({ type: "GEOMETRY.SYNC" });
+	}
 	wireWith(svc) {
 		const api = connectTour(svc, wcNormalize);
 		this.contentNode = this.getPart("content");
@@ -10935,7 +11604,7 @@ const SIDES = ["source", "target"];
 /**
 * 读条目节点上作者写的原生 disabled，顺手摘掉。
 *
-* 集合条目的禁用一律由 aria-disabled 表达（禁用声明的事实源是 items，不是标记）：
+* 集合条目的禁用一律由 aria-disabled 表达（禁用声明的事实源是 collection，不是标记）：
 * 原生禁用的节点不可聚焦、也收不到 click，「禁用项仍是方向键起点、仍挡得住点击」
 * 这两条在原生 disabled 下根本无从成立。摘掉之后禁用态由 connect 写回的 aria-disabled 承接。
 */
@@ -10947,7 +11616,7 @@ function stripNativeDisabled(el) {
 * root/source-panel/target-panel/panel-header/panel-title/panel-count/search/list/item/...
 * 角色节点，元素跑 transfer 机器并把 connect 产出打上去。
 *
-* 条目全集由 `items` 属性（property）给出，它是标签与禁用的唯一事实源；
+* 条目全集由 `collection` 属性（property）给出，它是标签与禁用的唯一事实源；
 * **两侧面板各挂一份全集**，不属于本侧、或被搜索筛掉的那一份由元素打上 hidden，
 * 节点不卸载。条目身份取节点上的 `value` 属性，归哪一侧则取它落在哪个面板里。
 *
@@ -10956,8 +11625,8 @@ function stripNativeDisabled(el) {
 * 导航与勾选在事件那一刻按 data-scope+data-part 查活 DOM，依赖 connect 回写的 data-value，
 * 因此 wire 必须先于交互跑过（基类 updated 已保证）。
 *
-* 集合类输入（items / value / selected / filter）都表达不成属性，只能走 property：
-* `el.items = [...]`、`el.value = ['a']`。
+* 集合类输入（collection / value / selected / filter）都表达不成属性，只能走 property：
+* `el.collection = [...]`、`el.value = ['a']`。
 *
 * @customElement xh-transfer
 * @attr {boolean} searchable - 每侧带一个搜索框；关掉时搜索框仍在 DOM 里但带 hidden
@@ -10966,7 +11635,7 @@ function stripNativeDisabled(el) {
 * @attr {boolean} loop - 列表内方向键走到尽头回绕，默认 true；写 loop="false" 关掉
 * @attr {'ltr'|'rtl'} dir - 文字方向，决定列表内哪个横向方向键是"搬向对面"，默认 ltr
 * @fires value-change - 落在右侧的值变化；detail 为 `{ value: string[] }`
-* @fires selected-change - 勾选集合变化；detail 为 `{ selected: string[] }`
+* @fires selection-change - 勾选集合变化；detail 为 `{ selected: string[] }`
 * @csspart root - 组件根容器（承载 data-disabled/data-one-way）
 * @csspart source-panel - 左侧面板容器，其内的角色节点一律归左侧
 * @csspart target-panel - 右侧面板容器，其内的角色节点一律归右侧
@@ -10975,7 +11644,7 @@ function stripNativeDisabled(el) {
 * @csspart panel-count - 计数节点，只带 data-count / data-checked-count，文案由作者写
 * @csspart search - 本侧搜索框，须是原生 input；searchable 关掉时带 hidden
 * @csspart list - role=listbox 容器，键盘在此收口，也是 roving tabindex 的兜底位
-* @csspart item - role=option 条目，须自带 value 属性标识身份；禁用写在 items 里，不写在节点上
+* @csspart item - role=option 条目，须自带 value 属性标识身份；禁用写在 collection 里，不写在节点上
 * @csspart item-text - 条目文本
 * @csspart item-checkbox - 条目勾选标记（aria-hidden）；oneWay 下右侧的那一份带 hidden
 * @csspart select-all-trigger - 本侧全选格，须是原生 button；三态经 aria-checked 上报
@@ -10988,7 +11657,7 @@ var XhTransferElement = class extends XhElement {
 		meta: transferMeta
 	};
 	static properties = {
-		items: { attribute: false },
+		collection: { attribute: false },
 		value: { attribute: false },
 		defaultValue: { attribute: false },
 		selected: { attribute: false },
@@ -11014,7 +11683,7 @@ var XhTransferElement = class extends XhElement {
 		}));
 	};
 	notifySelected = (details) => {
-		this.dispatchEvent(new CustomEvent("selected-change", {
+		this.dispatchEvent(new CustomEvent("selection-change", {
 			detail: details,
 			bubbles: true,
 			composed: true
@@ -11023,7 +11692,7 @@ var XhTransferElement = class extends XhElement {
 	ctrl = new MachineController(this, transferMachine, () => this.machineProps());
 	machineProps() {
 		return {
-			items: this.items,
+			collection: this.collection,
 			value: this.value,
 			defaultValue: this.defaultValue,
 			selected: this.selected,
@@ -11035,7 +11704,7 @@ var XhTransferElement = class extends XhElement {
 			loop: this.loop,
 			dir: this.direction,
 			onValueChange: this.notifyValue,
-			onSelectedChange: this.notifySelected
+			onSelectionChange: this.notifySelected
 		};
 	}
 	/**
@@ -11120,6 +11789,8 @@ const BRANCH_SELECTOR$1 = "[data-xh-part=\"branch\"]";
 *
 * @customElement xh-tree
 * @attr {'single'|'multiple'} selection-mode - 选择模式，默认 single
+* @attr {boolean} cascade - multiple 下父子级联勾选（整枝传导/半选/禁用冻结），默认 false
+* @attr {string} checked-strategy - 级联下对外值的收敛策略：child（默认）/ parent / all
 * @attr {boolean} expand-on-click - 点分支行顺带展开/收起，默认开；写 expand-on-click="false" 关掉
 * @attr {boolean} disabled - 整棵树禁用：所有节点转 aria-disabled，键盘与点击都改不了展开与选中
 * @attr {boolean} loop - 上下键走到首尾回绕，默认关；写 loop="true" 打开
@@ -11155,6 +11826,11 @@ var XhTreeElement = class extends XhElement {
 			converter: STRING_CONVERTER$3,
 			attribute: "selection-mode"
 		},
+		cascade: { type: Boolean },
+		checkedStrategy: {
+			converter: STRING_CONVERTER$3,
+			attribute: "checked-strategy"
+		},
 		expandOnClick: {
 			converter: BOOLEAN_CONVERTER$2,
 			attribute: "expand-on-click"
@@ -11190,6 +11866,8 @@ var XhTreeElement = class extends XhElement {
 			selectedValue: this.selectedValue,
 			defaultSelectedValue: this.defaultSelectedValue,
 			selectionMode: this.selectionMode,
+			cascade: this.cascade,
+			checkedStrategy: this.checkedStrategy,
 			expandOnClick: this.expandOnClick,
 			disabled: this.disabled ?? false,
 			loop: this.loop,
@@ -11274,6 +11952,8 @@ const BRANCH_SELECTOR = "[data-xh-part=\"branch\"]";
 * @attr {boolean} open - 受控开合；缺省该属性即非受控
 * @attr {boolean} default-open - 非受控初始为展开
 * @attr {boolean} multiple - 多选：选中后浮层不收起，焦点留在树里
+* @attr {boolean} cascade - 多选下父子级联勾选（整枝传导/半选/禁用冻结），默认 false
+* @attr {string} checked-strategy - 级联下对外值的收敛策略：child（默认）/ parent / all
 * @attr {boolean} disabled - 整个控件禁用：trigger 用原生 disabled，表单出口不参与提交
 * @attr {boolean} read-only - 只读：浮层照常展开、树照常浏览，但选中值改不动、也清不掉
 * @attr {boolean} invalid - 校验失败标注
@@ -11296,8 +11976,8 @@ const BRANCH_SELECTOR = "[data-xh-part=\"branch\"]";
 * @csspart indicator - 展开指示符（aria-hidden，data-state 随开合）
 * @csspart clear-trigger - 清空按钮，须是原生 button；不占 Tab 位且对读屏隐藏
 * @csspart positioner - 浮层定位容器，坐标由引擎写成内联样式
-* @csspart content - 浮层壳（焦点域与消解层的根节点），收起时带 hidden
-* @csspart tree - role=tree 容器，键盘在此收口，也是没有锚点时的 Tab 兜底位
+* @csspart content - 浮层壳（焦点域与消解层的根节点，键盘在此收口），收起时带 hidden
+* @csspart tree - role=tree 容器，没有锚点时的 Tab 兜底位与落焦点
 * @csspart item - role=treeitem 叶子，须自带 value 属性标识身份
 * @csspart item-text - 叶子文本
 * @csspart item-indicator - 叶子选中标记（aria-hidden）
@@ -11329,6 +12009,11 @@ var XhTreeSelectElement = class extends XhElement {
 			attribute: "default-open"
 		},
 		multiple: { type: Boolean },
+		cascade: { type: Boolean },
+		checkedStrategy: {
+			converter: STRING_CONVERTER$2,
+			attribute: "checked-strategy"
+		},
 		disabled: { type: Boolean },
 		readOnly: {
 			converter: BOOLEAN_CONVERTER$1,
@@ -11339,6 +12024,7 @@ var XhTreeSelectElement = class extends XhElement {
 		tone: { converter: STRING_CONVERTER$2 },
 		size: { converter: STRING_CONVERTER$2 },
 		placeholder: { converter: STRING_CONVERTER$2 },
+		translations: { attribute: false },
 		placement: { converter: STRING_CONVERTER$2 },
 		offset: { converter: NUMBER_CONVERTER$2 },
 		loop: { converter: BOOLEAN_CONVERTER$1 },
@@ -11389,6 +12075,8 @@ var XhTreeSelectElement = class extends XhElement {
 			open: this.open,
 			defaultOpen: this.defaultOpen ?? false,
 			multiple: this.multiple ?? false,
+			cascade: this.cascade,
+			checkedStrategy: this.checkedStrategy,
 			disabled: this.disabled ?? false,
 			readOnly: this.readOnly ?? false,
 			invalid: this.invalid ?? false,
@@ -11396,6 +12084,7 @@ var XhTreeSelectElement = class extends XhElement {
 			tone: this.tone,
 			size: this.size,
 			placeholder: this.placeholder,
+			translations: this.translations,
 			placement: this.placement,
 			offset: this.offset,
 			loop: this.loop,
@@ -11831,6 +12520,7 @@ function defineXhElements() {
 	defineElement("xh-hover-card", XhHoverCardElement, version);
 	defineElement("xh-icon", XhIconElement, version);
 	defineElement("xh-image", XhImageElement, version);
+	defineElement("xh-image-viewer", XhImageViewerElement, version);
 	defineElement("xh-listbox", XhListboxElement, version);
 	defineElement("xh-loading-bar", XhLoadingBarElement, version);
 	defineElement("xh-menu", XhMenuElement, version);
@@ -11846,6 +12536,7 @@ function defineXhElements() {
 	defineElement("xh-scroll-area", XhScrollAreaElement, version);
 	defineElement("xh-select", XhSelectElement, version);
 	defineElement("xh-separator", XhSeparatorElement, version);
+	defineElement("xh-side-nav", XhSideNavElement, version);
 	defineElement("xh-slider", XhSliderElement, version);
 	defineElement("xh-splitter", XhSplitterElement, version);
 	defineElement("xh-statistic", XhStatisticElement, version);
@@ -11875,6 +12566,6 @@ function defineXhElements() {
 	defineElement("xh-watermark", XhWatermarkElement, version);
 }
 //#endregion
-export { XhAccordionElement, XhAlertElement, XhAnchorElement, XhAvatarElement, XhBadgeElement, XhBreadcrumbElement, XhButtonElement, XhCalendarElement, XhCarouselElement, XhCascaderElement, XhCheckboxElement, XhCheckboxGroupElement, XhClipboardElement, XhCodeBlockElement, XhCollapsibleElement, XhColorPickerElement, XhComboboxElement, XhComposerElement, XhContextMenuElement, XhDateFieldElement, XhDatePickerElement, XhDialogElement, XhDrawerElement, XhEditableElement, XhEmptyStateElement, XhFieldElement, XhFileUploadElement, XhFormElement, XhHoverCardElement, XhIconElement, XhImageElement, XhListboxElement, XhLoadingBarElement, XhMenuElement, XhMenubarElement, XhNavigationMenuElement, XhNumberFieldElement, XhPaginationElement, XhPinInputElement, XhPopoverElement, XhProgressElement, XhRadioGroupElement, XhRatingElement, XhScrollAreaElement, XhSelectElement, XhSeparatorElement, XhSkeletonElement, XhSliderElement, XhSpinnerElement, XhSplitterElement, XhStepsElement, XhSwitchElement, XhTableElement, XhTabsElement, XhTagsInputElement, XhTextFieldElement, XhThreadElement, XhTimeFieldElement, XhTimePickerElement, XhToastElement, XhToasterElement, XhToggleElement, XhToggleGroupElement, XhToolbarElement, XhTooltipElement, XhTourElement, XhTransferElement, XhTreeElement, XhTreeSelectElement, XhVirtualizerElement, defineXhElements };
+export { XhAccordionElement, XhAlertElement, XhAnchorElement, XhAvatarElement, XhBadgeElement, XhBreadcrumbElement, XhButtonElement, XhCalendarElement, XhCarouselElement, XhCascaderElement, XhCheckboxElement, XhCheckboxGroupElement, XhClipboardElement, XhCodeBlockElement, XhCollapsibleElement, XhColorPickerElement, XhComboboxElement, XhComposerElement, XhContextMenuElement, XhDateFieldElement, XhDatePickerElement, XhDialogElement, XhDrawerElement, XhEditableElement, XhEmptyStateElement, XhFieldElement, XhFileUploadElement, XhFormElement, XhHoverCardElement, XhIconElement, XhImageElement, XhImageViewerElement, XhListboxElement, XhLoadingBarElement, XhMenuElement, XhMenubarElement, XhNavigationMenuElement, XhNumberFieldElement, XhPaginationElement, XhPinInputElement, XhPopoverElement, XhProgressElement, XhRadioGroupElement, XhRatingElement, XhScrollAreaElement, XhSelectElement, XhSeparatorElement, XhSideNavElement, XhSkeletonElement, XhSliderElement, XhSpinnerElement, XhSplitterElement, XhStepsElement, XhSwitchElement, XhTableElement, XhTabsElement, XhTagsInputElement, XhTextFieldElement, XhThreadElement, XhTimeFieldElement, XhTimePickerElement, XhToastElement, XhToasterElement, XhToggleElement, XhToggleGroupElement, XhToolbarElement, XhTooltipElement, XhTourElement, XhTransferElement, XhTreeElement, XhTreeSelectElement, XhVirtualizerElement, defineXhElements };
 
 //# sourceMappingURL=define.js.map