@xihan-ui/web-components 1.0.0-alpha.3 → 1.0.0

package/dist/define.d.ts

@@ -1,7 +1,7 @@
 import { r as PropertyValues } from "./types-BvWWqMd_.js";
 import { t as XhReactiveElement } from "./element-DRoFjrYO.js";
 import { l as Spreader, n as XhConfigScope, t as XhConfig } from "./config-Cz16-P4i.js";
-import { AccordionNode, AlertSchema, AnchorTranslations, BadgeVariant, BreadcrumbTranslations, CalendarDay, CalendarSelectionMode, CalendarView, CalendarWeekDay, CalendarWeekdayFormat, CarouselTranslations, CascaderExpandTrigger, CascaderNode, CascaderSchema, CascaderValue, CheckboxCheckedState, CheckboxGroupNode, ColorPickerFormat, ColorPickerTranslations, ComboboxInputBehavior, ComboboxNode, ComboboxSchema, ComponentMeta, ComposerRunStatus, ComposerTranslations, ContextMenuNode, ContextMenuSchema, DateFieldTranslations, DateGranularity, DatePickerPreset, DatePickerSchema, DateSegmentSet, DateSegmentType, DownloadTriggerData, DrawerSchema, EditableActivationMode, EditableSubmitMode, EmptyStateLive, FieldsetTranslations, FileUploadRemoteFile, FileUploadSchema, FileUploadTranslations, FloatingPanelPosition, FloatingPanelSchema, FloatingPanelSize, FloatingPanelStage, FormErrorPatch, FormSchema, FormValidateOn, FormValues, HeatmapAxisInput, HeatmapGrid, HeatmapMatrixGrid, HeatmapMonthGrid, HeatmapPalette, HeatmapTranslations, HeatmapValue, HeatmapVariant, HotkeysPlatform, HotkeysTarget, HotkeysTranslations, IconWeight, ImageCropperRect, ImageCropperSchema, ImageCropperShape, ImageViewerItem, ImageViewerTranslations, JsonViewerTranslations, ListboxNode, ListboxSelectionMode, LoadingBarTranslations, MasonryColumns, MasonryProps, MenuNode, MenubarNode, NavigationMenuNode, NavigationMenuTranslations, NumberFieldSchema, PaginationTranslations, PasswordInputTranslations, PinInputTranslations, PinInputType, PopoverTranslations, ProgressGapPosition, ProgressVariant, RadioGroupNode, ResolvedToast, ScrollAreaOrientation, ScrollbarSchema, ScrollbarType, SegmentedNode, SelectNode, SelectSchema, SideNavNode, SideNavSchema, SideNavTranslations, SignaturePadDrawingOptions, SignaturePadTranslations, SkeletonVariant, SliderSchema, SliderValueTextDetails, SpaceProps, SpinnerTranslations, SplitterPanelProps, TableColumnDef, TableRowDef, TableSelection, TableSelectionMode, TableSortDescriptor, TabsActivationMode, TabsNode, TabsVariant, TagSchema, TagVariant, TagsInputBlurBehavior, TextFieldSchema, TextFieldType, ThreadStatus, ThreadTranslations, TimeFieldSchema, TimeGranularity, TimeHourCycle, TimePickerPreset, TimePickerSchema, TimerSchema, ToastOptions, ToastPlacement, ToastRecord, ToastTranslations, ToastType, ToasterTranslations, ToggleGroupNode, TourStep, TourTranslations, TransferFilter, TransferItem, TreeNode, TreeSchema, TreeSelectSchema, TreeSelectionMode, VirtualizerAlign, VirtualizerItemState, XhTranslationOverrides } from "@xihan-ui/headless";
+import { AccordionNode, AlertSchema, AnchorTranslations, BadgePlacement, BreadcrumbTranslations, CalendarDay, CalendarSelectionMode, CalendarView, CalendarWeekDay, CalendarWeekdayFormat, CarouselTranslations, CascaderExpandTrigger, CascaderNode, CascaderSchema, CascaderValue, CheckboxCheckedState, CheckboxGroupNode, ColorPickerFormat, ColorPickerTranslations, ComboboxInputBehavior, ComboboxNode, ComboboxSchema, ComponentMeta, ComposerRunStatus, ComposerTranslations, ContextMenuNode, ContextMenuSchema, DateFieldTranslations, DateGranularity, DatePickerPreset, DatePickerSchema, DateSegmentSet, DateSegmentType, DownloadTriggerData, DrawerSchema, EditableActivationMode, EditableSubmitMode, EmptyStateLive, FieldsetTranslations, FileUploadRemoteFile, FileUploadSchema, FileUploadTranslations, FloatingPanelPosition, FloatingPanelSchema, FloatingPanelSize, FloatingPanelStage, FormErrorPatch, FormSchema, FormValidateOn, FormValues, HeatmapAxisInput, HeatmapGrid, HeatmapMatrixGrid, HeatmapMonthGrid, HeatmapPalette, HeatmapTranslations, HeatmapValue, HeatmapVariant, HotkeysPlatform, HotkeysTarget, HotkeysTranslations, IconWeight, ImageCropperRect, ImageCropperSchema, ImageCropperShape, ImageViewerItem, ImageViewerTranslations, JsonViewerTranslations, ListboxNode, ListboxSelectionMode, LoadingBarTranslations, MasonryColumns, MasonryProps, MenuNode, MenubarNode, NavigationMenuNode, NavigationMenuTranslations, NotificationOptions, NotificationPlacement, NotificationRecord, NotificationTranslations, NotificationType, NumberFieldSchema, PaginationTranslations, PasswordInputTranslations, PinInputTranslations, PinInputType, PopoverTranslations, ProgressGapPosition, ProgressVariant, RadioGroupNode, ResolvedNotification, ScrollAreaOrientation, ScrollbarSchema, ScrollbarType, SegmentedNode, SelectNode, SelectSchema, SideNavNode, SideNavSchema, SideNavTranslations, SignaturePadDrawingOptions, SignaturePadTranslations, SkeletonVariant, SliderSchema, SliderValueTextDetails, SpaceProps, SpinnerTranslations, SplitterPanelProps, TableColumnDef, TableColumnKind, TableColumnPreference, TableRowDef, TableSelection, TableSelectionMode, TableSortDescriptor, TabsActivationMode, TabsNode, TabsVariant, TagSchema, TagVariant, TagsInputBlurBehavior, TextFieldSchema, TextFieldType, ThreadStatus, ThreadTranslations, TimeFieldSchema, TimeGranularity, TimeHourCycle, TimePickerPreset, TimePickerSchema, TimerSchema, ToastTranslations, ToastType, ToggleGroupNode, TourStep, TourTranslations, TransferFilter, TransferItem, TreeNode, TreeSchema, TreeSelectSchema, TreeSelectionMode, VirtualizerAlign, VirtualizerItemState, XhTranslationOverrides } from "@xihan-ui/headless";
 import { MotionPreference } from "@xihan-ui/motion";
 import { ActionVariant, ControlVariant, Direction, HighlighterPort, IconRecord, Orientation, Placement, Size, Tone } from "@xihan-ui/kernel";
 //#region src/dom/part-contract.d.ts
@@ -123,7 +123,7 @@ declare class XhAccordionElement extends XhElement {
   private exitConfig;
   private ensureExitConfig;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "indicator" | "header" | "trigger">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "header" | "item" | "trigger" | "content">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -252,7 +252,7 @@ declare class XhAlertElement extends XhElement {
  */
 declare class XhAnchorElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "list" | "link">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "list" | "link">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -374,26 +374,30 @@ declare class XhAvatarElement extends XhElement {
 //#endregion
 //#region src/elements/badge.d.ts
 /**
- * `<xh-badge>` —— 徽标展示宿主，无状态机，外观来自 variant 属性。
+ * `<xh-badge>` —— 角标宿主，无状态机。
+ *
+ * 被标记的东西写进 root，角标本身写进 indicator；角标是挂在别的元素角上的一枚标记，
+ * 行内的状态药丸请用 `<xh-tag>`。
  *
  * @customElement xh-badge
- * @attr {'solid'|'subtle'|'outline'} variant - 视觉变体
+ * @attr {'top-end'|'top-start'|'bottom-end'|'bottom-start'} placement - 挂在哪个角上，默认 top-end
  * @attr {'brand'|'neutral'|'success'|'warning'|'danger'|'info'} tone - 语气
  * @attr {'sm'|'md'|'lg'} size - 尺寸
  * @attr {number} count - 计数：给了它徽标就自己出数字，超过 max 写成「max+」；节点已有内容时以内容为准
  * @attr {number} max - 计数上限，默认 99
  * @attr {boolean} show-zero - 计数为 0 时也显示，默认不显示
  * @attr {boolean} dot - 只出一个点，不出数字
- * @attr {string} label - 读屏怎么念这枚徽标，例如「3 条未读」
- * @csspart root - 承载 data-scope/data-part/data-* 的展示节点
+ * @attr {string} label - 读屏怎么念这枚角标，例如「3 条未读」
+ * @csspart root - 锚点：被标记的那个东西放进它里面
+ * @csspart indicator - 角标本身，绝对定位在 root 的某个角上
  */
 declare class XhBadgeElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
-    variant: {
+    placement: {
       converter: {
         fromAttribute: (v: string | null) => string | undefined;
       };
@@ -431,7 +435,7 @@ declare class XhBadgeElement extends XhElement {
       };
     };
   };
-  variant?: BadgeVariant;
+  placement?: BadgePlacement;
   tone?: Tone;
   size?: Size;
   count?: number;
@@ -766,7 +770,7 @@ declare class XhCalendarElement extends XhElement {
  */
 declare class XhCarouselElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "viewport" | "indicator" | "prev-trigger" | "next-trigger" | "item-group" | "indicator-group">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "prev-trigger" | "next-trigger" | "viewport" | "item-group" | "indicator-group">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -914,7 +918,7 @@ declare class XhCarouselElement extends XhElement {
  */
 declare class XhCascaderElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "indicator" | "trigger" | "label" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "input" | "empty" | "column" | "value-text" | "search-list" | "search-item">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "content" | "label" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "input" | "empty" | "column" | "value-text" | "search-list" | "search-item">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1064,6 +1068,12 @@ declare class XhCascaderElement extends XhElement {
   private readonly notifyValue;
   private readonly notifyOpen;
   private readonly ctrl;
+  /**
+   * 列区的自绘条：与 content 同级挂在已经 fixed 的 positioner 上。
+   * 只摆横的——列多到放不下时整体横向滚动，纵向溢出归每一列自己；
+   * 横条的正负按排版方向算，而组件不读计算样式，把作者写的那份显式交过去。
+   */
+  private readonly bars;
   private machineProps;
   private ensureConfig;
   private readonly registerLayer;
@@ -1203,7 +1213,7 @@ declare class XhCheckboxElement extends XhElement {
  */
 declare class XhCheckboxGroupElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "trigger" | "label" | "item-text" | "hidden-input">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "label" | "item-text" | "hidden-input">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1408,7 +1418,7 @@ declare class XhCollapsibleElement extends XhElement {
   private config;
   private ensureConfig;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1459,6 +1469,7 @@ declare class XhCollapsibleElement extends XhElement {
  * @attr {boolean} read-only - 只读：浮层照开，进去只是改不动
  * @attr {boolean} alpha - 带透明度，默认关；关掉时透明度那条滑杆与输入框整条禁用
  * @attr {string} swatches - 预设色板，逗号分隔（如 "#ff0000,#00ff00"）
+ * @attr {'sm'|'md'|'lg'} size - 尺寸
  * @attr {'ltr'|'rtl'} dir - 文字方向，只改写横轴上左右两键与指针的语义，默认 ltr
  * @attr {string} placement - 首选放置位，默认 bottom-start；避让后的实际位写在 data-placement 上
  * @attr {number} offset - 浮层与锚点的间距（px）
@@ -1486,7 +1497,7 @@ declare class XhCollapsibleElement extends XhElement {
  */
 declare class XhColorPickerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "label" | "control" | "positioner" | "value-text" | "hidden-input" | "area" | "swatch" | "area-thumb" | "channel-slider" | "channel-slider-track" | "channel-slider-thumb" | "channel-input" | "eye-dropper-trigger" | "swatch-group" | "swatch-item">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content" | "label" | "control" | "positioner" | "value-text" | "hidden-input" | "area" | "swatch" | "area-thumb" | "channel-slider" | "channel-slider-track" | "channel-slider-thumb" | "channel-input" | "eye-dropper-trigger" | "swatch-group" | "swatch-item">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1541,6 +1552,11 @@ declare class XhColorPickerElement extends XhElement {
         fromAttribute: (v: string | null) => string | undefined;
       };
     };
+    size: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
     direction: {
       converter: {
         fromAttribute: (v: string | null) => string | undefined;
@@ -1571,6 +1587,7 @@ declare class XhColorPickerElement extends XhElement {
   alpha?: boolean;
   swatches?: string[];
   name?: string;
+  size?: Size;
   direction?: Direction;
   placement?: Placement;
   offset?: number;
@@ -1584,6 +1601,8 @@ declare class XhColorPickerElement extends XhElement {
   private readonly notifyValue;
   private readonly notifyOpen;
   private readonly ctrl;
+  /** 面板的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
   private machineProps;
   private ensureConfig;
   private readonly registerLayer;
@@ -1654,7 +1673,7 @@ declare class XhColorPickerElement extends XhElement {
  */
 declare class XhComboboxElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "trigger" | "label" | "item-group" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "input" | "empty" | "hidden-input" | "item-group-label">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "trigger" | "content" | "label" | "item-group" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "input" | "empty" | "hidden-input" | "item-group-label">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1801,6 +1820,8 @@ declare class XhComboboxElement extends XhElement {
   private readonly notifyInputValue;
   private readonly notifyOpen;
   private readonly ctrl;
+  /** 候选列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
   /** 作者声明的条目禁用，只认首见那一份；给了 collection 时用它，否则现读 */
   private readonly declaredDisabled;
   private machineProps;
@@ -1988,7 +2009,7 @@ declare class XhConfigElement extends XhReactiveElement implements XhConfigScope
  */
 declare class XhContextMenuElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "trigger" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "trigger" | "content" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -2072,6 +2093,8 @@ declare class XhContextMenuElement extends XhElement {
   private readonly notifyOpen;
   private readonly notifySelect;
   private readonly ctrl;
+  /** 条目列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
   /** 作者声明的条目禁用，只认首见那一份；给了 collection 时用它，否则现读 */
   private readonly declaredDisabled;
   private machineProps;
@@ -2146,7 +2169,7 @@ type SegmentTexts = { readonly [K in DateSegmentType]?: string; };
  */
 declare class XhDateFieldElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "label" | "control" | "clear-trigger" | "hidden-input" | "segment-group" | "segment">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "label" | "control" | "clear-trigger" | "hidden-input" | "segment" | "segment-group">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -2298,7 +2321,9 @@ declare class XhDateFieldElement extends XhElement {
  * @attr {'day'|'month'|'quarter'|'year'} active-view - 受控：面板此刻钻到了哪一层；缺省跟着 view，每次展开都拨回去
  * @attr {boolean} week-selection - 周选：点任意一天选中它所在的整周（view=day 且区间模式下生效）
  * @prop {DatePickerPreset[]} presets - 快捷选项（数组只走 property）：给了就在浮层里多出一列
- * @attr {number} visible-count - 并排展示几页
+ * @attr {number} visible-count - 并排展示几页；缺省单选 1，区间按两端定，同一页放得下就 1
+ * @attr {boolean} fixed-weeks - 日历恒渲染六行，默认开；写 fixed-weeks="false" 关掉
+ * @attr {string} default-focused-value - 初始聚焦日，同时决定展开时先落在哪一页
  * @attr {boolean} disabled - 整个控件禁用：trigger 转原生 disabled，段位退出 Tab 序
  * @attr {boolean} read-only - 只读：浮层照常展开、日历照常浏览，但选中值改不动
  * @attr {boolean} invalid - 校验失败标注
@@ -2351,9 +2376,9 @@ declare class XhDateFieldElement extends XhElement {
  */
 declare class XhDatePickerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "label" | "control" | "positioner" | "clear-trigger" | "segment-group" | "confirm-trigger" | "preset" | "presets" | "calendar" | "time-column" | "time-item">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content" | "label" | "control" | "positioner" | "clear-trigger" | "segment-group" | "confirm-trigger" | "presets" | "preset" | "calendar" | "time-column" | "time-item">;
     meta: import("@xihan-ui/headless").ComponentMeta;
-    delegates: (import("@xihan-ui/kernel").Anatomy<"root" | "header" | "grid" | "heading" | "prev-trigger" | "next-trigger" | "prev-year-trigger" | "next-year-trigger" | "heading-year-trigger" | "heading-month-trigger" | "grid-head" | "week-day" | "grid-body" | "week-row" | "week-number" | "cell" | "cell-trigger"> | import("@xihan-ui/kernel").Anatomy<"root" | "label" | "control" | "clear-trigger" | "hidden-input" | "segment-group" | "segment">)[];
+    delegates: (import("@xihan-ui/kernel").Anatomy<"root" | "header" | "grid" | "heading" | "prev-trigger" | "next-trigger" | "prev-year-trigger" | "next-year-trigger" | "heading-year-trigger" | "heading-month-trigger" | "grid-head" | "week-day" | "grid-body" | "week-row" | "week-number" | "cell" | "cell-trigger"> | import("@xihan-ui/kernel").Anatomy<"root" | "label" | "control" | "clear-trigger" | "hidden-input" | "segment" | "segment-group">)[];
   };
   static properties: {
     value: {
@@ -2432,6 +2457,18 @@ declare class XhDatePickerElement extends XhElement {
       };
       attribute: string;
     };
+    fixedWeeks: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+      attribute: string;
+    };
+    defaultFocusedValue: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+      attribute: string;
+    };
     disabled: {
       converter: {
         fromAttribute: (v: string | null) => boolean | undefined;
@@ -2529,6 +2566,8 @@ declare class XhDatePickerElement extends XhElement {
   weekSelection?: boolean;
   presets?: DatePickerPreset[];
   visibleCount?: number;
+  fixedWeeks?: boolean;
+  defaultFocusedValue?: string;
   disabled?: boolean;
   readOnly?: boolean;
   invalid?: boolean;
@@ -2559,6 +2598,8 @@ declare class XhDatePickerElement extends XhElement {
   private readonly calendarCtrl;
   private readonly fieldCtrl;
   private readonly fieldEndCtrl;
+  /** 浮层面板的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
   private services;
   private machineProps;
   private ensureConfig;
@@ -2610,7 +2651,7 @@ declare class XhDatePickerElement extends XhElement {
  */
 declare class XhDialogElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"content" | "trigger" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"trigger" | "content" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -2766,7 +2807,7 @@ declare class XhDownloadTriggerElement extends XhElement {
  */
 declare class XhDrawerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -3383,7 +3424,7 @@ declare class XhFileUploadElement extends XhElement {
  */
 declare class XhFloatingPanelElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "header" | "trigger" | "title" | "close-trigger" | "positioner" | "body" | "drag-trigger" | "resize-trigger" | "stage-trigger">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "header" | "trigger" | "content" | "title" | "close-trigger" | "positioner" | "body" | "drag-trigger" | "resize-trigger" | "stage-trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -3907,7 +3948,7 @@ declare class XhHotkeysElement extends XhElement {
  */
 declare class XhHoverCardElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "positioner" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content" | "positioner" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -3974,6 +4015,8 @@ declare class XhHoverCardElement extends XhElement {
   private exit;
   private readonly notify;
   private readonly ctrl;
+  /** 卡片内容的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
   private machineProps;
   private ensureConfig;
   private readonly registerLayer;
@@ -4154,7 +4197,7 @@ declare class XhImageElement extends XhElement {
  */
 declare class XhImageCropperElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "viewport" | "image" | "grid" | "hidden-input" | "crop-area" | "crop-handle">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "image" | "grid" | "viewport" | "hidden-input" | "crop-area" | "crop-handle">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -4307,7 +4350,7 @@ declare class XhImageCropperElement extends XhElement {
  */
 declare class XhImageViewerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"viewport" | "content" | "trigger" | "close-trigger" | "image" | "prev-trigger" | "next-trigger" | "positioner" | "backdrop" | "reset-trigger" | "toolbar" | "zoom-in-trigger" | "zoom-out-trigger" | "rotate-left-trigger" | "rotate-right-trigger" | "flip-horizontal-trigger" | "flip-vertical-trigger" | "counter">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"trigger" | "content" | "close-trigger" | "image" | "prev-trigger" | "next-trigger" | "viewport" | "positioner" | "backdrop" | "reset-trigger" | "toolbar" | "zoom-in-trigger" | "zoom-out-trigger" | "rotate-left-trigger" | "rotate-right-trigger" | "flip-horizontal-trigger" | "flip-vertical-trigger" | "counter">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -4454,7 +4497,7 @@ declare class XhImageViewerElement extends XhElement {
  */
 declare class XhJsonViewerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "preview" | "tree" | "item-key" | "item-value" | "branch" | "branch-control" | "branch-trigger" | "branch-indicator" | "branch-text" | "branch-content">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "text" | "preview" | "tree" | "item-key" | "item-value" | "branch" | "branch-control" | "branch-trigger" | "branch-indicator" | "branch-text" | "branch-content">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -4493,6 +4536,9 @@ declare class XhJsonViewerElement extends XhElement {
       };
       attribute: string;
     };
+    view: {
+      attribute: string;
+    };
     loop: {
       converter: {
         fromAttribute: (v: string | null) => boolean | undefined;
@@ -4520,15 +4566,25 @@ declare class XhJsonViewerElement extends XhElement {
   maxStringLength?: number;
   maxItems?: number;
   sortKeys?: boolean;
+  view?: 'tree' | 'text';
   loop?: boolean;
   direction?: Direction;
   size?: Size;
   translations?: Partial<JsonViewerTranslations>;
   private readonly notify;
   private readonly ctrl;
+  /**
+   * 两档的自绘条：与滚动层同级挂在根上。两档互斥，交此刻在场的那个——
+   * 两个容器都归本元素建，身上没有 data-xh-part，从 root 里现查。
+   * 两条轴都摆：深层缩进往行首方向推、长字符串往行尾伸。
+   */
+  private readonly bars;
+  /** 条子上一轮接的是哪一档的容器。 */
+  private wiredLayer;
   private machineProps;
   /** 树容器与每一行都归本元素建，按路径留着复用。 */
   private treeEl;
+  private textEl;
   private readonly rows;
   /**
    * root 被移出本宿主时，铺在它里面的行也一并离场。浏览器此时不派 focusout，
@@ -4539,6 +4595,18 @@ declare class XhJsonViewerElement extends XhElement {
   private makeRow;
   private paint;
   protected wire(): void;
+  /**
+   * 把条子接到此刻在场的那一档容器上。
+   * 机器的追踪器在本轮渲染之前就跑完了，这一轮换掉的容器它看不见；
+   * 换了档就再催一轮，下一轮的追踪器才把滚动监听与容器标记挪过去。
+   */
+  private syncBars;
+  /**
+   * root 里只留这一档的容器：摘走另一档，作者写在里面的东西也一并清掉。
+   * 自绘条同样挂在 root 上，按 scope 认出来留着——整份 replaceChildren 会把条子一起抹掉。
+   * 已经就位的节点一个都不碰：移动一个节点等于把它摘下来再插回去，焦点在树里会掉回 body。
+   */
+  private adopt;
 }
 //#endregion
 //#region src/elements/listbox.d.ts
@@ -4860,7 +4928,7 @@ declare class XhMasonryElement extends XhElement {
  */
 declare class XhMenuElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"item" | "content" | "trigger" | "separator" | "positioner" | "group" | "group-label" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"item" | "trigger" | "content" | "separator" | "positioner" | "group" | "group-label" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -4953,6 +5021,8 @@ declare class XhMenuElement extends XhElement {
   private readonly notifyOpen;
   private readonly notifySelect;
   private readonly ctrl;
+  /** 条目列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
   /** 作者声明的条目禁用，只认首见那一份；给了 collection 时用它，否则现读 */
   private readonly declaredDisabled;
   private machineProps;
@@ -5021,7 +5091,7 @@ declare class XhMenubarElement extends XhElement {
   /** 闸门只用到 reducedMotion，本元素别处不需要 config，建一份共用即可。 */
   private exitConfig;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "trigger" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "trigger" | "content" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -5160,7 +5230,7 @@ declare class XhNavigationMenuElement extends XhElement {
   /** 退场闸门与消解层共用一份环境包。 */
   private config;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "viewport" | "content" | "indicator" | "trigger" | "list" | "link">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "content" | "list" | "link" | "viewport">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -5243,6 +5313,229 @@ declare class XhNavigationMenuElement extends XhElement {
   disconnectedCallback(): void;
 }
 //#endregion
+//#region src/elements/notification.d.ts
+/**
+ * `<xh-notification>` —— Light-DOM 行为宿主：作者写 root 与若干 group 角色节点，
+ * 元素跑 notification 机器并把 connect 产出打上去。每个 group 用 `placement` 属性声明自己是哪个位置，
+ * 不写就落在队列的 placement 上。
+ *
+ * 单条通知的节点由作者按队列渲染（读 `items` 或听 `items-change`），元素不替作者生成：
+ * 生成节点就等于收走模板控制权，图标、进度条、i18n 文案都再塞不进来。
+ * 每条渲染成一个 `<xh-notification-item>`，它走完退场会冒泡一条 status-change，本元素据此把记录删掉。
+ *
+ * @customElement xh-notification
+ * @attr {'top-start'|'top'|'top-end'|'middle-start'|'middle'|'middle-end'|'bottom-start'|'bottom'|'bottom-end'} placement - 默认落位，默认 bottom-end
+ * @attr {number} max - 每个位置最多同时留几条，超出挤掉最旧的；不给即不限
+ * @attr {number} gap - 同一摞内的间距（px），默认 16
+ * @attr {number} duration - 单条没写 duration 时的默认停留毫秒
+ * @attr {number} remove-delay - 单条没写 remove-delay 时的默认退场窗口毫秒
+ * @attr {boolean} pause-on-page-idle - 页面切到后台时按住计时，逐条下发
+ * @fires items-change - 队列变化；detail 为 `{ items: NotificationRecord[] }`
+ * @csspart root - 队列的作用域包装（display: contents，不占布局），承载 data-count / data-empty
+ * @csspart group - role=region 的地标，某一个位置上的那一摞；可自带 placement 属性，承载 data-placement / data-count / data-empty 与间距
+ */
+declare class XhNotificationElement extends XhElement {
+  static partContract: {
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "item-indicator" | "group" | "item-title" | "item-description" | "item-action-trigger" | "item-close-trigger">;
+    meta: import("@xihan-ui/headless").ComponentMeta;
+  };
+  static properties: {
+    items: {
+      attribute: boolean;
+    };
+    defaultItems: {
+      attribute: boolean;
+    };
+    placement: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
+    max: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+    };
+    gap: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+    };
+    duration: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+    };
+    removeDelay: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    pauseOnPageIdle: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+      attribute: string;
+    };
+    translations: {
+      attribute: boolean;
+    };
+  };
+  items?: NotificationRecord[];
+  defaultItems?: NotificationRecord[];
+  placement?: NotificationPlacement;
+  max?: number;
+  gap?: number;
+  duration?: number;
+  removeDelay?: number;
+  pauseOnPageIdle?: boolean;
+  translations?: Partial<NotificationTranslations>;
+  private readonly notify;
+  private readonly ctrl;
+  private machineProps;
+  /**
+   * 命令式入口共用的取法。机器要到进文档（hostConnected）才建：
+   * 还没进文档就发通知是调用方的时序问题，明说好过把这条通知静默丢掉。
+   */
+  private commands;
+  /** 入队并返回 id；同 id 已存在则就地改写，位置不动（处理中转已完成走的就是这条）。 */
+  create(options?: NotificationOptions): string;
+  /**
+   * 刻意不叫 `update`：那是 Lit 自己的渲染生命周期钩子，占用它会让宿主每次重渲
+   * 都拐进这里来（还带着一个 changedProperties 当 id），组件当场不工作。
+   * Vue 侧没有这层基类，composable 上仍叫 `update`。
+   */
+  updateItem(id: string, options: Partial<NotificationOptions>): void;
+  dismiss(id: string): void;
+  dismissAll(): void;
+  /** max 之内、按加入先后排列的可见条目，已补齐默认值，可直接摊给 `<xh-notification-item>`。 */
+  get visibleNotifications(): ResolvedNotification[];
+  /** 当前有条目的位置，按九宫格固定顺序。 */
+  get placements(): NotificationPlacement[];
+  get count(): number;
+  getItemsByPlacement(placement: NotificationPlacement): ResolvedNotification[];
+  /**
+   * 单条通知走完退场会冒泡上来：记录该从队列里删掉了。
+   * 认元素名而不是只认事件名——avatar 之类的部件也派 status-change，且完全可能就摆在通知内部。
+   */
+  private readonly onItemStatus;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  protected wire(): void;
+}
+/**
+ * `<xh-notification-item>` —— 单条通知卡片：作者写 item/item-indicator/item-title/
+ * item-description/item-action-trigger/item-close-trigger 角色节点，
+ * 元素跑生命周期机器并把 connect 产出打上去。
+ *
+ * item 承载 role 与 aria-live：默认 status + polite（排队等读屏的空隙），
+ * type="error" 换成 alert + assertive（打断当前朗读）。指针停在卡片上、
+ * 或焦点落进卡片内部都会把倒计时按住，离开才接着走剩下的那一段。
+ *
+ * 退场窗口走完只把卡片收起、不删节点：作者写在里面的内容归作者，
+ * 什么时候把这条从队列里删掉是 `<xh-notification>` 的事（它收本元素冒泡上去的 status-change）。
+ *
+ * @customElement xh-notification-item
+ * @attr {string} id - 队列身份，`<xh-notification>` 按它寻址；不给就用实例自己的 scope id
+ * @attr {string} title - 标题文案；作者没在 item-title 部件里写内容时由元素填入
+ * @attr {string} description - 补充说明；作者没在 item-description 部件里写内容时由元素填入
+ * @attr {'info'|'success'|'warning'|'error'|'loading'} type - 语气，默认 info；loading 不自动消失
+ * @attr {number} duration - 停留毫秒，默认 5000；<=0 即关掉自动消失
+ * @attr {number} remove-delay - 退场窗口毫秒，默认 200，留给退场动画
+ * @attr {boolean} closable - 是否给可用的关闭按钮，默认 true；写 closable="false" 关掉
+ * @attr {boolean} pause-on-page-idle - 页面切到后台时按住计时，默认关
+ * @fires status-change - 生命周期落位；detail 为 `{ id: string, status: 'dismissing'|'unmounted' }`
+ * @fires action - 操作按钮被按下；detail 为 `{ id: string }`
+ * @csspart item - role=status（error 时 alert）的卡片，承载 data-type / data-tone / data-state / data-paused
+ * @csspart item-indicator - 类型指示符；留空即由皮肤按 data-type 画一枚兜底字形
+ * @csspart item-title - 标题，aria-labelledby 的目标
+ * @csspart item-description - 补充说明，aria-describedby 的目标
+ * @csspart item-action-trigger - 操作按钮：先发 action 再进入退场
+ * @csspart item-close-trigger - 关闭按钮；closable=false 时转原生 disabled 并收起
+ */
+declare class XhNotificationItemElement extends XhElement {
+  static partContract: {
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "item-indicator" | "group" | "item-title" | "item-description" | "item-action-trigger" | "item-close-trigger">;
+    meta: {
+      component: string;
+      requiredParts: string[];
+    };
+  };
+  static properties: {
+    itemId: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+      attribute: string;
+    };
+    titleText: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+      attribute: string;
+    };
+    description: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
+    type: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
+    duration: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+    };
+    removeDelay: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    closable: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+    };
+    pauseOnPageIdle: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+      attribute: string;
+    };
+    translations: {
+      attribute: boolean;
+    };
+  };
+  itemId?: string;
+  titleText?: string;
+  description?: string;
+  type?: NotificationType;
+  duration?: number;
+  removeDelay?: number;
+  closable?: boolean;
+  pauseOnPageIdle?: boolean;
+  translations?: Partial<NotificationTranslations>;
+  private readonly notifyStatus;
+  private readonly notifyAction;
+  private readonly ctrl;
+  private machineProps;
+  /** 这个部件的文字归不归作者：头一回见到它时定案，之后不再改口。 */
+  private readonly authorOwnsText;
+  /**
+   * 作者没往部件里写内容时，用 props 上的文案填进去。
+   *
+   * 归属只判一次：判完本轮就会把文字写进去，再回读分不清是作者写的还是自己写的，
+   * 从那以后 title 属性改了也再刷不动（Vue 侧是响应式渲染，会跟着改，两侧就此分叉）。
+   */
+  private fillText;
+  protected wire(): void;
+}
+//#endregion
 //#region src/elements/number-field.d.ts
 /**
  * `<xh-number-field>` —— Light-DOM 行为宿主：作者写 root/label/input/加减按钮四类角色节点，
@@ -5413,15 +5706,22 @@ declare class XhNumberFieldElement extends XhElement {
  * @attr {'brand'|'neutral'|'success'|'warning'|'danger'|'info'} tone - 语气
  * @attr {'sm'|'md'|'lg'} size - 尺寸
  * @fires page-change - 页码变化；detail 为 `{ page: number, pageSize: number }`
+ * @fires page-size-change - 每页条数变化；detail 为 `{ pageSize: number, page: number }`，页码是换算后的
+ * @attr {string} placement - 省略位摊开后的落点，默认 bottom-start
+ * @attr {number} offset - 浮层与省略位之间的间距（px），默认 8
+ * @attr {number} open-delay - 指针停在省略位多久才摊开（ms），默认 200
+ * @attr {number} close-delay - 指针离开后多久收起（ms），默认 300
+ * @attr {number} default-page-size - 非受控初始每页条数，默认 10
+ * @prop {number[]} pageSizeOptions - 可选的每页条数档位，默认 [10, 20, 50, 100]
  * @csspart root - nav 地标，承载 aria-label 与 data-empty
  * @csspart prev-trigger - 上一页；首页时转原生 disabled
  * @csspart next-trigger - 下一页；末页时转原生 disabled
  * @csspart item - 页码按钮，须自带 value 属性；当前页带 aria-current="page" 与 data-current
- * @csspart ellipsis - 折叠掉的那几页的占位，对读屏隐藏
+ * @csspart ellipsis - 折进去那几页的入口，须自带 side 属性（start / end）；承载 data-side 与 aria-expanded
  */
 declare class XhPaginationElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "ellipsis" | "prev-trigger" | "next-trigger">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "ellipsis" | "prev-trigger" | "next-trigger" | "positioner" | "page-size-select">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -5436,6 +5736,15 @@ declare class XhPaginationElement extends XhElement {
       };
       attribute: string;
     };
+    defaultPageSize: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    pageSizeOptions: {
+      attribute: boolean;
+    };
     page: {
       converter: {
         fromAttribute: (v: string | null) => number | undefined;
@@ -5472,9 +5781,33 @@ declare class XhPaginationElement extends XhElement {
     translations: {
       attribute: boolean;
     };
+    placement: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
+    offset: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+    };
+    openDelay: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    closeDelay: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
   };
   count?: number;
   pageSize?: number;
+  defaultPageSize?: number;
+  pageSizeOptions?: number[];
   page?: number;
   defaultPage?: number;
   siblingCount?: number;
@@ -5482,10 +5815,34 @@ declare class XhPaginationElement extends XhElement {
   tone?: Tone;
   size?: Size;
   translations?: Partial<PaginationTranslations>;
+  placement?: Placement;
+  offset?: number;
+  openDelay?: number;
+  closeDelay?: number;
+  private readonly idGen;
+  private readonly paginationScope;
+  private readonly positionEngine;
+  private config;
+  /** 退场闸门：收起从跟着展开态走改成跟着 presence 走，退场动画播完才真收。 */
+  private exit;
   private readonly notify;
+  private readonly notifyPageSize;
   private readonly ctrl;
+  /** 折叠页码列表的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
+  private ensureConfig;
+  /** 此刻摊开的是哪个省略位的节点——它是定位锚点。 */
+  private openEllipsisEl;
+  private readonly registerLayer;
+  private injectRefs;
+  /**
+   * 角色节点提前发现一次：常规发现要等首次 updated，那一刻 partMap 还空着，
+   * 引擎挂不上，浮层会停在容器左上角。
+   */
+  connectedCallback(): void;
   private machineProps;
   protected wire(): void;
+  disconnectedCallback(): void;
 }
 //#endregion
 //#region src/elements/password-input.d.ts
@@ -5791,7 +6148,7 @@ declare class XhPinInputElement extends XhElement {
  */
 declare class XhPopoverElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"content" | "trigger" | "title" | "description" | "close-trigger" | "positioner" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"trigger" | "content" | "title" | "description" | "close-trigger" | "positioner" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -5858,6 +6215,8 @@ declare class XhPopoverElement extends XhElement {
   private exit;
   private readonly notify;
   private readonly ctrl;
+  /** 面板内容的自绘条：与 content 同级挂在已经 fixed 的 positioner 上 */
+  private readonly bars;
   private machineProps;
   private ensureConfig;
   private readonly registerLayer;
@@ -5981,7 +6340,7 @@ declare class XhProgressElement extends XhElement {
  */
 declare class XhRadioGroupElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "label" | "item-text" | "hidden-input">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "label" | "item-text" | "hidden-input">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -6191,8 +6550,8 @@ declare class XhRatingElement extends XhElement {
  * 轨道与滑块按所在滚动条的轴向取几何，不必另写。这是挂载时的静态声明：运行期要换轴，换节点。
  *
  * @customElement xh-scroll-area
- * @attr {'auto'|'always'|'scroll'|'hover'} type - 滚动条露面的时机，默认 hover
- * @attr {number} hide-delay - 收起前的等待毫秒（type 为 scroll / hover 时生效），默认 600
+ * @attr {'auto'|'always'|'scroll'|'hover'|'scroll-hover'} type - 滚动条露面的时机，默认 scroll-hover
+ * @attr {number} hide-delay - 收起前的等待毫秒（type 为 scroll / hover / scroll-hover 时生效），默认 600
  * @attr {'horizontal'|'vertical'|'both'} orientation - 哪几条轴归本组件管，默认 both
  * @attr {'sm'|'md'|'lg'} size - 尺寸档，换的是滚动条厚度
  * @attr {'ltr'|'rtl'} dir - 排版方向，只改写横轴的滚动量正负与指针位移方向
@@ -6207,7 +6566,7 @@ declare class XhRatingElement extends XhElement {
  */
 declare class XhScrollAreaElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "viewport" | "content" | "scrollbar">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "viewport" | "scrollbar">;
     meta: import("@xihan-ui/headless").ComponentMeta;
     delegates: import("@xihan-ui/kernel").Anatomy<"root" | "track" | "thumb" | "corner">[];
   };
@@ -6288,8 +6647,8 @@ declare class XhScrollAreaElement extends XhElement {
  * @customElement xh-scrollbar
  * @attr {string} controls - 滚动容器的 id；没设 scrollable 属性时按它查节点，focusable 时同时落到 aria-controls
  * @attr {'horizontal'|'vertical'} orientation - 这条滚动条管哪条轴，默认 vertical
- * @attr {'auto'|'always'|'scroll'|'hover'} type - 露面的时机，默认 hover
- * @attr {number} hide-delay - 收起前的等待毫秒（type 为 scroll / hover 时生效），默认 600
+ * @attr {'auto'|'always'|'scroll'|'hover'|'scroll-hover'} type - 露面的时机，默认 scroll-hover
+ * @attr {number} hide-delay - 收起前的等待毫秒（type 为 scroll / hover / scroll-hover 时生效），默认 600
  * @attr {number} min-thumb-size - 滑块最短多少像素，默认 20
  * @attr {number} step - 方向键一步滚多少像素，默认 40
  * @attr {'sm'|'md'|'lg'} size - 尺寸档，换的是滚动条厚度
@@ -6445,7 +6804,7 @@ declare class XhScrollbarElement extends XhElement {
  */
 declare class XhSegmentedElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "item-text" | "hidden-input">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "item-text" | "hidden-input">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -6607,7 +6966,7 @@ declare class XhSegmentedElement extends XhElement {
  */
 declare class XhSelectElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "indicator" | "trigger" | "list" | "label" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "value-text" | "item-delete-trigger" | "footer" | "tag" | "hidden-select">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "content" | "list" | "label" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "value-text" | "item-delete-trigger" | "footer" | "tag" | "hidden-select">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -7251,7 +7610,8 @@ declare class XhSliderElement extends XhElement {
  * 根上不写 role：容器只做排布，里面装的是列表还是一组按钮由作者自己声明。
  *
  * @customElement xh-space
- * @attr {'horizontal'|'vertical'} direction - 排布方向，缺省 horizontal
+ * @attr {'horizontal'|'vertical'} orientation - 排布方向，缺省 horizontal
+ * @attr {'horizontal'|'vertical'} direction - 排布方向的旧写法，两个都写时以 orientation 为准
  * @attr {'xs'|'sm'|'md'|'lg'|'xl'} gap - 子项间距档位，缺省 md，逐档对应一个间距令牌
  * @attr {'start'|'center'|'end'|'stretch'|'baseline'} align - 交叉轴对齐
  * @attr {'start'|'center'|'end'|'between'|'around'|'evenly'} justify - 主轴分布
@@ -7266,6 +7626,11 @@ declare class XhSpaceElement extends XhElement {
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
+    orientation: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
     direction: {
       converter: {
         fromAttribute: (v: string | null) => string | undefined;
@@ -7297,6 +7662,7 @@ declare class XhSpaceElement extends XhElement {
       };
     };
   };
+  orientation?: SpaceProps['orientation'];
   direction?: SpaceProps['direction'];
   gap?: SpaceProps['gap'];
   align?: SpaceProps['align'];
@@ -7490,7 +7856,7 @@ declare class XhSplitterElement extends XhElement {
  */
 declare class XhStepsElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "indicator" | "trigger" | "title" | "description" | "list" | "separator">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "content" | "title" | "description" | "list" | "separator">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -7680,6 +8046,9 @@ declare class XhSwitchElement extends XhElement {
  * @attr {'ltr'|'rtl'} dir - 文字方向，只对调左右方向键的展开/收起语义，默认 ltr
  * @attr {'sm'|'md'|'lg'} size - 密度：只换单元格的纵向内边距与字号，列宽不受影响
  * @fires sort-change - 排序链变化；detail 为 `{ value: { id, direction }[] }`
+ * @fires column-preference-change - 列偏好变化；detail 为 `{ value: TableColumnPreference }`
+ * @prop {TableColumnPreference} columnPreference - 列偏好（显隐/顺序/宽/冻结），给定即受控
+ * @prop {TableColumnKind[]} prefixColumns - 要哪几列前缀列，按给定顺序插在最前面
  * @fires selection-change - 选中集合变化；detail 为 `{ value: string[] | 'all' }`
  * @fires expanded-change - 展开集合变化；detail 为 `{ value: string[] }`
  * @csspart root - role=grid 容器（rows 里有可展开的行时为 treegrid），报行列总数与多选声明
@@ -7734,6 +8103,26 @@ declare class XhTableElement extends XhElement {
       };
       attribute: string;
     };
+    prefixColumns: {
+      attribute: boolean;
+    };
+    columnPreference: {
+      attribute: boolean;
+    };
+    defaultColumnPreference: {
+      attribute: boolean;
+    };
+    page: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+    };
+    pageSize: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
     loading: {
       type: BooleanConstructor;
     };
@@ -7784,6 +8173,11 @@ declare class XhTableElement extends XhElement {
   expanded?: string[];
   defaultExpanded?: string[];
   selectionMode?: TableSelectionMode;
+  prefixColumns?: TableColumnKind[];
+  columnPreference?: TableColumnPreference;
+  defaultColumnPreference?: TableColumnPreference;
+  page?: number;
+  pageSize?: number;
   loading?: boolean;
   empty?: boolean;
   stickyHeader?: boolean;
@@ -7794,6 +8188,7 @@ declare class XhTableElement extends XhElement {
   loop?: boolean;
   direction?: Direction;
   size?: Size;
+  private readonly notifyColumnPreference;
   private readonly notifySort;
   private readonly notifySelection;
   private readonly notifyExpanded;
@@ -7836,7 +8231,7 @@ declare class XhTableElement extends XhElement {
  */
 declare class XhTabsElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "list">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content" | "list">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8338,7 +8733,7 @@ declare class XhTextFieldElement extends XhElement {
  */
 declare class XhThreadElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "viewport" | "content" | "scroll-button" | "live-region">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "viewport" | "scroll-button" | "live-region">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8411,7 +8806,7 @@ declare class XhThreadElement extends XhElement {
  */
 declare class XhTimeFieldElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "label" | "control" | "clear-trigger" | "hidden-input" | "segment-group" | "segment">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "label" | "control" | "clear-trigger" | "hidden-input" | "segment" | "segment-group">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8585,7 +8980,7 @@ declare class XhTimeFieldElement extends XhElement {
  */
 declare class XhTimePickerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "trigger" | "label" | "control" | "positioner" | "clear-trigger" | "input" | "column" | "hidden-input" | "segment-group" | "preset" | "presets">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "trigger" | "content" | "label" | "control" | "positioner" | "clear-trigger" | "input" | "column" | "hidden-input" | "segment-group" | "presets" | "preset">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8843,20 +9238,19 @@ declare class XhTimerElement extends XhElement {
 //#endregion
 //#region src/elements/toast.d.ts
 /**
- * `<xh-toast>` —— Light-DOM 行为宿主：作者写 root/title/description/action-trigger/close-trigger
+ * `<xh-toast>` —— Light-DOM 行为宿主：作者写 root/title/action-trigger/close-trigger
  * 角色节点，元素跑 toast 机器并把 connect 产出打上去。
  *
  * root 承载 role 与 aria-live：默认 status + polite（排队等读屏的空隙），
- * type="error" 换成 alert + assertive（打断当前朗读）。指针停在通知上、
- * 或焦点落进通知内部都会把倒计时按住，离开才接着走剩下的那一段。
+ * type="error" 换成 alert + assertive（打断当前朗读）。指针停在条子上、
+ * 或焦点落进条子内部都会把倒计时按住，离开才接着走剩下的那一段。
  *
  * 退场窗口走完只把 root 收起、不删节点：作者写在里面的内容归作者，
- * 什么时候把这条从队列里删掉是 `<xh-toaster>` 的事（它收本元素冒泡上去的 status-change）。
+ * 什么时候把这条从队列里删掉是全局服务的事（它收本元素冒泡上去的 status-change）。
  *
  * @customElement xh-toast
- * @attr {string} id - 队列身份，`<xh-toaster>` 按它寻址；不给就用实例自己的 scope id
+ * @attr {string} id - 队列身份，全局服务按它寻址；不给就用实例自己的 scope id
  * @attr {string} title - 标题文案；作者没在 title 部件里写内容时由元素填入
- * @attr {string} description - 补充说明；作者没在 description 部件里写内容时由元素填入
  * @attr {'info'|'success'|'warning'|'error'|'loading'} type - 语气，默认 info；loading 不自动消失
  * @attr {number} duration - 停留毫秒，默认 5000；<=0 即关掉自动消失
  * @attr {number} remove-delay - 退场窗口毫秒，默认 200，留给退场动画
@@ -8866,13 +9260,12 @@ declare class XhTimerElement extends XhElement {
  * @fires action - 操作按钮被按下；detail 为 `{ id: string }`
  * @csspart root - role=status（error 时 alert）的容器，承载 data-type / data-tone / data-state / data-paused
  * @csspart title - 标题，aria-labelledby 的目标
- * @csspart description - 补充说明，aria-describedby 的目标
  * @csspart action-trigger - 操作按钮：先发 action 再进入退场
  * @csspart close-trigger - 关闭按钮；closable=false 时转原生 disabled 并收起
  */
 declare class XhToastElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "title" | "description" | "close-trigger" | "action-trigger">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "title" | "close-trigger" | "group" | "action-trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8888,11 +9281,6 @@ declare class XhToastElement extends XhElement {
       };
       attribute: string;
     };
-    description: {
-      converter: {
-        fromAttribute: (v: string | null) => string | undefined;
-      };
-    };
     type: {
       converter: {
         fromAttribute: (v: string | null) => string | undefined;
@@ -8926,7 +9314,6 @@ declare class XhToastElement extends XhElement {
   };
   toastId?: string;
   titleText?: string;
-  description?: string;
   type?: ToastType;
   duration?: number;
   removeDelay?: number;
@@ -8949,118 +9336,6 @@ declare class XhToastElement extends XhElement {
   protected wire(): void;
 }
 //#endregion
-//#region src/elements/toaster.d.ts
-/**
- * `<xh-toaster>` —— Light-DOM 行为宿主：作者写 root 与若干 group 角色节点，
- * 元素跑 toaster 机器并把 connect 产出打上去。每个 group 用 `placement` 属性声明自己是哪个位置，
- * 不写就落在 toaster 的 placement 上。
- *
- * 单条通知的节点由作者按队列渲染（读 `visibleToasts` 或听 `toasts-change`），元素不替作者生成：
- * 生成节点就等于收走模板控制权，图标、进度条、i18n 文案都再塞不进来。
- * 每条渲染成一个 `<xh-toast>`，它走完退场会冒泡一条 status-change，本元素据此把记录删掉。
- *
- * @customElement xh-toaster
- * @attr {'top-start'|'top'|'top-end'|'middle-start'|'middle'|'middle-end'|'bottom-start'|'bottom'|'bottom-end'} placement - 默认落位，默认 bottom-end
- * @attr {number} max - 每个位置最多同时留几条，超出挤掉最旧的；不给即不限
- * @attr {number} gap - 同一摞内的间距（px），默认 16
- * @attr {number} duration - 单条没写 duration 时的默认停留毫秒
- * @attr {number} remove-delay - 单条没写 remove-delay 时的默认退场窗口毫秒
- * @attr {boolean} pause-on-page-idle - 页面切到后台时按住计时，逐条下发
- * @fires toasts-change - 队列变化；detail 为 `{ toasts: ToastRecord[] }`
- * @csspart root - role=region 的地标容器，承载 data-count / data-empty
- * @csspart group - 某一个位置上的那一摞，可自带 placement 属性；承载 data-placement / data-count / data-empty 与间距
- */
-declare class XhToasterElement extends XhElement {
-  static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "group">;
-    meta: import("@xihan-ui/headless").ComponentMeta;
-  };
-  static properties: {
-    toasts: {
-      attribute: boolean;
-    };
-    defaultToasts: {
-      attribute: boolean;
-    };
-    placement: {
-      converter: {
-        fromAttribute: (v: string | null) => string | undefined;
-      };
-    };
-    max: {
-      converter: {
-        fromAttribute: (v: string | null) => number | undefined;
-      };
-    };
-    gap: {
-      converter: {
-        fromAttribute: (v: string | null) => number | undefined;
-      };
-    };
-    duration: {
-      converter: {
-        fromAttribute: (v: string | null) => number | undefined;
-      };
-    };
-    removeDelay: {
-      converter: {
-        fromAttribute: (v: string | null) => number | undefined;
-      };
-      attribute: string;
-    };
-    pauseOnPageIdle: {
-      converter: {
-        fromAttribute: (v: string | null) => boolean | undefined;
-      };
-      attribute: string;
-    };
-    translations: {
-      attribute: boolean;
-    };
-  };
-  toasts?: ToastRecord[];
-  defaultToasts?: ToastRecord[];
-  placement?: ToastPlacement;
-  max?: number;
-  gap?: number;
-  duration?: number;
-  removeDelay?: number;
-  pauseOnPageIdle?: boolean;
-  translations?: Partial<ToasterTranslations>;
-  private readonly notify;
-  private readonly ctrl;
-  private machineProps;
-  /**
-   * 命令式入口共用的取法。机器要到进文档（hostConnected）才建：
-   * 还没进文档就发通知是调用方的时序问题，明说好过把这条通知静默丢掉。
-   */
-  private commands;
-  /** 入队并返回 id；同 id 已存在则就地改写，位置不动（loading 转 success 走的就是这条）。 */
-  create(options?: ToastOptions): string;
-  /**
-   * 刻意不叫 `update`：那是 Lit 自己的渲染生命周期钩子，占用它会让宿主每次重渲
-   * 都拐进这里来（还带着一个 changedProperties 当 id），组件当场不工作。
-   * Vue 侧没有这层基类，composable 上仍叫 `update`。
-   */
-  updateToast(id: string, options: Partial<ToastOptions>): void;
-  dismiss(id: string): void;
-  dismissAll(): void;
-  /** max 之内、按加入先后排列的可见条目，已补齐默认值，可直接摊给 `<xh-toast>`。 */
-  get visibleToasts(): ResolvedToast[];
-  /** 当前有条目的位置，按九宫格固定顺序。 */
-  get placements(): ToastPlacement[];
-  get count(): number;
-  getToastsByPlacement(placement: ToastPlacement): ResolvedToast[];
-  /**
-   * 单条通知走完退场会冒泡上来：记录该从队列里删掉了。
-   * 认元素名而不是只认事件名——avatar 之类的部件也派 status-change，且完全可能就摆在通知内部。
-   */
-  private readonly onToastStatus;
-  connectedCallback(): void;
-  disconnectedCallback(): void;
-  protected wire(): void;
-}
-//#endregion
 //#region src/elements/toggle.d.ts
 /**
  * `<xh-toggle>` —— Light-DOM 行为宿主，跑 toggle 机器并把 connect 产出打到 root 角色节点。
@@ -9126,6 +9401,7 @@ declare class XhToggleElement extends XhElement {
  * @attr {boolean} multiple - 允许多项同时选中，默认关闭
  * @attr {boolean} disabled - 整组禁用
  * @attr {boolean} disallow-empty - 不许把值点空（最后一个选中项摘不掉）
+ * @attr {'sm'|'md'|'lg'} size - 尺寸
  * @attr {'horizontal'|'vertical'} orientation - 视觉排布，默认 horizontal；方向键四个恒响应，与它无关
  * @attr {'ltr'|'rtl'} dir - 文字方向，只改写左右方向键语义，默认 ltr
  * @attr {boolean} loop - 方向键走到尽头回绕，默认开启
@@ -9170,6 +9446,11 @@ declare class XhToggleGroupElement extends XhElement {
       };
       attribute: string;
     };
+    size: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
     orientation: {
       converter: {
         fromAttribute: (v: string | null) => string | undefined;
@@ -9199,6 +9480,7 @@ declare class XhToggleGroupElement extends XhElement {
   multiple?: boolean;
   disabled?: boolean;
   disallowEmpty?: boolean;
+  size?: Size;
   orientation?: Orientation;
   direction?: Direction;
   loop?: boolean;
@@ -9324,7 +9606,7 @@ declare class XhToolbarElement extends XhElement {
  */
 declare class XhTooltipElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"content" | "trigger" | "positioner" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"trigger" | "content" | "positioner" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   /** 退场闸门：收起从跟着 open 走改成跟着 presence 走，退场动画播完才真收。 */
@@ -9691,7 +9973,9 @@ declare class XhTransferElement extends XhElement {
  * 树数据与展开/选中集合都是数组，属性表达不了，只能走 property（`el.collection = [...]`）。
  *
  * @customElement xh-tree
- * @attr {'single'|'multiple'} selection-mode - 选择模式，默认 single
+ * @attr {boolean} multiple - 复选，默认关闭
+ * @attr {'horizontal'|'vertical'} leaf-orientation - 末端那一层怎么排，默认 vertical；horizontal 让子节点全是叶子的那层并排铺开
+ * @attr {'single'|'multiple'} selection-mode - 选择模式的旧写法，默认 single；与 multiple 同时给时以它为准
  * @attr {boolean} cascade - multiple 下父子级联勾选（整枝传导/半选/禁用冻结），默认 false
  * @attr {string} checked-strategy - 级联下对外值的收敛策略：child（默认）/ parent / all
  * @attr {boolean} expand-on-click - 点分支行顺带展开/收起，默认开；写 expand-on-click="false" 关掉
@@ -9737,6 +10021,17 @@ declare class XhTreeElement extends XhElement {
     defaultSelection: {
       attribute: boolean;
     };
+    multiple: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+    };
+    leafOrientation: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+      attribute: string;
+    };
     selectionMode: {
       converter: {
         fromAttribute: (v: string | null) => string | undefined;
@@ -9783,6 +10078,8 @@ declare class XhTreeElement extends XhElement {
   defaultExpandedValue?: string[];
   selection?: string[];
   defaultSelection?: string[];
+  multiple?: boolean;
+  leafOrientation?: Orientation;
   selectionMode?: TreeSelectionMode;
   cascade?: boolean;
   checkedStrategy?: TreeSchema['props']['checkedStrategy'];
@@ -9872,7 +10169,7 @@ declare class XhTreeElement extends XhElement {
  */
 declare class XhTreeSelectElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "indicator" | "trigger" | "label" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "value-text" | "hidden-input" | "tree" | "branch" | "branch-control" | "branch-trigger" | "branch-indicator" | "branch-text" | "branch-content">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "content" | "label" | "control" | "positioner" | "clear-trigger" | "item-text" | "item-indicator" | "value-text" | "hidden-input" | "tree" | "branch" | "branch-control" | "branch-trigger" | "branch-indicator" | "branch-text" | "branch-content">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -10017,6 +10314,12 @@ declare class XhTreeSelectElement extends XhElement {
   private readonly notifyExpanded;
   private readonly notifyOpen;
   private readonly ctrl;
+  /**
+   * 树的自绘条：与 content 同级挂在已经 fixed 的 positioner 上。
+   * 两条轴都摆——深层节点靠缩进往行末推，横向溢出与纵向一样是常态；
+   * 横条的正负按排版方向算，而组件不读计算样式，把作者写的那份显式交过去。
+   */
+  private readonly bars;
   private machineProps;
   private ensureConfig;
   private readonly registerLayer;
@@ -10071,7 +10374,7 @@ declare class XhTreeSelectElement extends XhElement {
  */
 declare class XhVirtualizerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "viewport" | "content">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "viewport">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -10167,5 +10470,5 @@ declare class XhVirtualizerElement extends XhElement {
 //#region src/define.d.ts
 declare function defineXhElements(): void;
 //#endregion
-export { XhAccordionElement, XhAlertElement, XhAnchorElement, XhAvatarElement, XhBadgeElement, XhBreadcrumbElement, XhButtonElement, XhCalendarElement, XhCarouselElement, XhCascaderElement, XhCheckboxElement, XhCheckboxGroupElement, XhClipboardElement, XhCodeBlockElement, XhCollapsibleElement, XhColorPickerElement, XhComboboxElement, XhComposerElement, XhConfigElement, XhContextMenuElement, XhDateFieldElement, XhDatePickerElement, XhDialogElement, XhDownloadTriggerElement, XhDrawerElement, XhEditableElement, XhEmptyStateElement, XhFieldElement, XhFieldsetElement, XhFileUploadElement, XhFloatingPanelElement, XhFormElement, XhHeatmapElement, XhHotkeysElement, XhHoverCardElement, XhIconElement, XhImageCropperElement, XhImageElement, XhImageViewerElement, XhJsonViewerElement, XhListboxElement, XhLoadingBarElement, XhMasonryElement, XhMenuElement, XhMenubarElement, XhNavigationMenuElement, XhNumberFieldElement, XhPaginationElement, XhPasswordInputElement, XhPinInputElement, XhPopoverElement, XhProgressElement, XhRadioGroupElement, XhRatingElement, XhScrollAreaElement, XhScrollbarElement, XhSegmentedElement, XhSelectElement, XhSeparatorElement, XhSideNavElement, XhSignaturePadElement, XhSkeletonElement, XhSliderElement, XhSpaceElement, XhSpinnerElement, XhSplitterElement, XhStepsElement, XhSwitchElement, XhTableElement, XhTabsElement, XhTagElement, XhTagsInputElement, XhTextFieldElement, XhThreadElement, XhTimeFieldElement, XhTimePickerElement, XhTimerElement, 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, XhConfigElement, XhContextMenuElement, XhDateFieldElement, XhDatePickerElement, XhDialogElement, XhDownloadTriggerElement, XhDrawerElement, XhEditableElement, XhEmptyStateElement, XhFieldElement, XhFieldsetElement, XhFileUploadElement, XhFloatingPanelElement, XhFormElement, XhHeatmapElement, XhHotkeysElement, XhHoverCardElement, XhIconElement, XhImageCropperElement, XhImageElement, XhImageViewerElement, XhJsonViewerElement, XhListboxElement, XhLoadingBarElement, XhMasonryElement, XhMenuElement, XhMenubarElement, XhNavigationMenuElement, XhNotificationElement, XhNotificationItemElement, XhNumberFieldElement, XhPaginationElement, XhPasswordInputElement, XhPinInputElement, XhPopoverElement, XhProgressElement, XhRadioGroupElement, XhRatingElement, XhScrollAreaElement, XhScrollbarElement, XhSegmentedElement, XhSelectElement, XhSeparatorElement, XhSideNavElement, XhSignaturePadElement, XhSkeletonElement, XhSliderElement, XhSpaceElement, XhSpinnerElement, XhSplitterElement, XhStepsElement, XhSwitchElement, XhTableElement, XhTabsElement, XhTagElement, XhTagsInputElement, XhTextFieldElement, XhThreadElement, XhTimeFieldElement, XhTimePickerElement, XhTimerElement, XhToastElement, XhToggleElement, XhToggleGroupElement, XhToolbarElement, XhTooltipElement, XhTourElement, XhTransferElement, XhTreeElement, XhTreeSelectElement, XhVirtualizerElement, defineXhElements };
 //# sourceMappingURL=define.d.ts.map