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

package/dist/define.d.ts

@@ -1,9 +1,10 @@
 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, ResizableSize, ResolvedNotification, ScrollAreaOrientation, ScrollbarSchema, ScrollbarType, SegmentedNode, SelectNode, SelectSchema, SideNavNode, SideNavSchema, SideNavTranslations, SignaturePadDrawingOptions, SignaturePadTranslations, SkeletonVariant, SliderSchema, SliderValueTextDetails, SpaceProps, SpinnerTranslations, SplitterPanelProps, TableColumnDef, TableColumnKind, TableColumnPreference, TableRowDef, TableSchema, TableSelection, TableSelectionMode, TableSortDescriptor, TabsActivationMode, TabsNode, TabsTranslations, 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, TreeTranslations, 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";
+import { ResizeEdge, SortableAxis } from "@xihan-ui/pointer";
 //#region src/dom/part-contract.d.ts
 /** 只取校验用得上的两项，避免把 `Anatomy<具体 part 联合>` 收窄成 `Anatomy<string>` 时不可赋值。 */
 interface PartContract {
@@ -374,26 +375,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 +436,7 @@ declare class XhBadgeElement extends XhElement {
       };
     };
   };
-  variant?: BadgeVariant;
+  placement?: BadgePlacement;
   tone?: Tone;
   size?: Size;
   count?: number;
@@ -1064,6 +1069,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;
@@ -1459,6 +1470,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）
@@ -1541,6 +1553,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 +1588,7 @@ declare class XhColorPickerElement extends XhElement {
   alpha?: boolean;
   swatches?: string[];
   name?: string;
+  size?: Size;
   direction?: Direction;
   placement?: Placement;
   offset?: number;
@@ -1584,6 +1602,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;
@@ -1801,6 +1821,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;
@@ -2072,6 +2094,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 +2170,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 +2322,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 - 校验失败标注
@@ -2353,7 +2379,7 @@ 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">;
     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 +2458,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 +2567,8 @@ declare class XhDatePickerElement extends XhElement {
   weekSelection?: boolean;
   presets?: DatePickerPreset[];
   visibleCount?: number;
+  fixedWeeks?: boolean;
+  defaultFocusedValue?: string;
   disabled?: boolean;
   readOnly?: boolean;
   invalid?: boolean;
@@ -2559,6 +2599,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;
@@ -3974,6 +4016,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;
@@ -4307,7 +4351,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<"content" | "viewport" | "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">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -4454,7 +4498,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 +4537,9 @@ declare class XhJsonViewerElement extends XhElement {
       };
       attribute: string;
     };
+    view: {
+      attribute: string;
+    };
     loop: {
       converter: {
         fromAttribute: (v: string | null) => boolean | undefined;
@@ -4520,15 +4567,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 +4596,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
@@ -4953,6 +5022,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;
@@ -5160,7 +5231,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" | "item" | "content" | "viewport" | "indicator" | "trigger" | "list" | "link">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -5243,6 +5314,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 +5707,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 +5737,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 +5782,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 +5816,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
@@ -5858,6 +6216,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;
@@ -6174,11 +6534,151 @@ declare class XhRatingElement extends XhElement {
   protected wire(): void;
 }
 //#endregion
-//#region src/elements/scroll-area.d.ts
+//#region src/elements/resizable.d.ts
 /**
- * `<xh-scroll-area>` —— Light-DOM 行为宿主：作者写 root/viewport/content 与两条 scrollbar
- * 角色节点，元素按轴各跑一台 scrollbar 机器并把 connect 产出打上去。
- *
+ * `<xh-resizable>` —— Light-DOM 行为宿主：作者写 root 与八向 handle 角色节点，
+ * 元素跑 resizable 机器并把 connect 产出打上去。
+ *
+ * 每个 handle 用 `edge` 属性写明自己是哪条边（`n` / `ne` / `e` / `se` / `s` / `sw` / `w` / `nw`），
+ * 与 Vue 侧的 `:edge` 是同一份声明。
+ *
+ * 尺寸由元素每帧写进 root 的内联 `inline-size` / `block-size`，作者的样式表不要再碰这两条轴。
+ * **推西边与北边时容器的起点会动**，那段位移写成 root 的 `left` / `top`——皮肤已给
+ * `position: relative`，开箱即对；把 root 改成 `static` 会让这两个方向只变尺寸不移位。
+ *
+ * 键盘全在把手上：方向键按屏幕方向推一步（推东边时右键变宽、推西边时右键变窄，与拖动同义），
+ * 按住 Shift 走大步，Home / End 推到这条边能到的两端。
+ *
+ * @customElement xh-resizable
+ * @attr {string} size - 受控尺寸，写成 `宽x高`（如 `320x200`）；缺省该属性即非受控
+ * @attr {string} default-size - 非受控初值，同样写成 `宽x高`
+ * @attr {number} min-width - 宽度下限
+ * @attr {number} min-height - 高度下限
+ * @attr {number} max-width - 宽度上限；不给即不封顶
+ * @attr {number} max-height - 高度上限；不给即不封顶
+ * @attr {number} aspect-ratio - 宽高比（宽 ÷ 高）。给了就锁死，四个角以宽为准
+ * @attr {number} step - 吸附步进：宽高各自落到最近的整数倍
+ * @attr {number} keyboard-step - 方向键一次推多远（px），默认 8
+ * @attr {number} keyboard-large-step - 按住 Shift 时的步长（px），默认 40
+ * @attr {string} edges - 开放哪几条边，逗号分隔（如 `e,s,se`）；默认八向全开
+ * @attr {boolean} disabled - 禁用：把手退出 Tab 序列，按下也不进调整
+ * @attr {'ltr'|'rtl'} dir - 文字方向，只对调水平位移与左右两键的正负，默认 ltr
+ * @fires size-change - 尺寸变化（拖动途中会连发）；detail 为 `{ size }`
+ * @fires size-change-end - 一次调整收尾发一次；detail 为 `{ size, edge }`
+ * @csspart root - 承载 data-resizing / data-edge / data-disabled 的容器，尺寸写在它的内联样式上
+ * @csspart handle - role=separator 的把手，指针与键盘交互全在它身上
+ */
+declare class XhResizableElement extends XhElement {
+  static partContract: {
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "handle">;
+    meta: import("@xihan-ui/headless").ComponentMeta;
+  };
+  static properties: {
+    size: {
+      converter: {
+        fromAttribute: (v: string | null) => ResizableSize | undefined;
+      };
+    };
+    defaultSize: {
+      converter: {
+        fromAttribute: (v: string | null) => ResizableSize | undefined;
+      };
+      attribute: string;
+    };
+    minWidth: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    minHeight: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    maxWidth: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    maxHeight: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    aspectRatio: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    step: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+    };
+    keyboardStep: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    keyboardLargeStep: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    edges: {
+      converter: {
+        fromAttribute: (v: string | null) => ResizeEdge[] | undefined;
+      };
+    };
+    disabled: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+    };
+    direction: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+      attribute: string;
+    };
+  };
+  size?: ResizableSize;
+  defaultSize?: ResizableSize;
+  minWidth?: number;
+  minHeight?: number;
+  maxWidth?: number;
+  maxHeight?: number;
+  aspectRatio?: number;
+  step?: number;
+  keyboardStep?: number;
+  keyboardLargeStep?: number;
+  edges?: ResizeEdge[];
+  disabled?: boolean;
+  direction?: Direction;
+  private readonly idGen;
+  private readonly resizableScope;
+  private readonly notifySize;
+  private readonly notifySizeEnd;
+  private readonly ctrl;
+  private machineProps;
+  private injectRefs;
+  /** 把手自报的边。没写就落东南角——那是文档流里最常见的那个。 */
+  private edgeOf;
+  protected wire(): void;
+}
+//#endregion
+//#region src/elements/scroll-area.d.ts
+/**
+ * `<xh-scroll-area>` —— Light-DOM 行为宿主：作者写 root/viewport/content 与两条 scrollbar
+ * 角色节点，元素按轴各跑一台 scrollbar 机器并把 connect 产出打上去。
+ *
  * 滚动区没有自己的机器，它是视口加两条 scrollbar 的组装：scrollbar 角色节点是那条
  * scrollbar 的挂载点、同时充当它的根，里面照 scrollbar 那套写 track / thumb / corner
  * （它们戴 data-scope="scrollbar"），两个组件共用同一份滚动条。
@@ -6191,8 +6691,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 +6707,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 +6788,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 - 尺寸档，换的是滚动条厚度
@@ -7237,6 +7737,103 @@ declare class XhSliderElement extends XhElement {
   protected wire(): void;
 }
 //#endregion
+//#region src/elements/sortable.d.ts
+/**
+ * `<xh-sortable>` —— Light-DOM 行为宿主：作者写 root/item/item-handle/live-region 角色节点，
+ * 元素跑 sortable 机器并把 connect 产出打上去。
+ *
+ * 顺序的唯一真源是 `ids`，DOM 里项的先后必须与它一致——几何按 DOM 量，事件按 `ids` 算。
+ * 每个 item 与它的 item-handle 都要用 `item-id` 属性写明自己是哪一项（与 Vue 侧的 `:item-id` 同一份声明）。
+ * 单独禁掉某一项写 `item-disabled`。不给 item-handle 时整项可拖。
+ *
+ * 拖动落点走乐观投影：拖动过程中其余项实时让位，松手即定。让位与跟手的位移由元素每帧
+ * 写进内联 transform，作者的样式表不要再碰这条属性。
+ *
+ * 键盘全在手柄上：空格或回车拾起、方向键挪一格、再按空格放下、Esc 取消。
+ * 拖动中的 Tab 会被拦下——焦点一旦移走，这一场就没有出口了。
+ *
+ * @customElement xh-sortable
+ * @attr {string} ids - 顺序真源，逗号分隔的项标识（如 "a,b,c"）
+ * @attr {'horizontal'|'vertical'|'both'} orientation - 排序轴，默认 vertical；换行网格用 both
+ * @attr {'ltr'|'rtl'} dir - 文字方向，只对调水平排布下左右两键的语义，默认 ltr
+ * @attr {boolean} disabled - 禁用：手柄退出 Tab 序列，按下也不进拖动
+ * @attr {number} activation-distance - 按下之后走多远才算开始拖，默认 5；给 0 表示按下即拖
+ * @attr {boolean} auto-scroll - 拖到容器边缘时自动滚动，默认开
+ * @fires sort - 顺序变化；detail 为 `{ from, to, id, ids }`，其中 ids 已重排好
+ * @fires drag-start - 拾起；detail 为 `{ id, from, mode }`
+ * @fires drag-end - 收尾（含取消）；detail 为 `{ id, from, to, mode, canceled }`
+ * @csspart root - 承载 data-orientation / data-disabled / data-dragging 的容器
+ * @csspart item - 一项；位移由内联 transform 给出，被拖的那项带 data-dragging
+ * @csspart item-handle - role=button 的拖拽手柄，指针与键盘交互全在它身上
+ * @csspart live-region - 视觉隐藏的播报区，拖动过程的读屏文案写在这里
+ */
+declare class XhSortableElement extends XhElement {
+  static partContract: {
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "live-region" | "item-handle">;
+    meta: import("@xihan-ui/headless").ComponentMeta;
+  };
+  static properties: {
+    ids: {
+      converter: {
+        fromAttribute: (v: string | null) => string[] | undefined;
+      };
+    };
+    orientation: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+    };
+    direction: {
+      converter: {
+        fromAttribute: (v: string | null) => string | undefined;
+      };
+      attribute: string;
+    };
+    disabled: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+    };
+    activationDistance: {
+      converter: {
+        fromAttribute: (v: string | null) => number | undefined;
+      };
+      attribute: string;
+    };
+    autoScroll: {
+      converter: {
+        fromAttribute: (v: string | null) => boolean | undefined;
+      };
+      attribute: string;
+    };
+  };
+  ids?: string[];
+  orientation?: SortableAxis;
+  direction?: Direction;
+  disabled?: boolean;
+  activationDistance?: number;
+  autoScroll?: boolean;
+  private readonly idGen;
+  private readonly sortableScope;
+  private readonly notifySort;
+  private readonly notifyDragStart;
+  private readonly notifyDragEnd;
+  private readonly ctrl;
+  private machineProps;
+  private injectRefs;
+  /**
+   * 部件自报的项标识。作者在节点上写 item-id="a"，与 Vue 侧的 `:id` 是同一份声明；
+   * 没写就落空串——connect 那边找不到对应项，会当作不可拖的普通节点。
+   *
+   * 不用 `id`：那是 HTML 全局属性，写上去会留在 DOM 里（Vue 侧的同名 prop 不会），
+   * 而且同一项的外壳与手柄同名时会造出两个相同的 DOM id。
+   */
+  private partId;
+  /** 项级禁用。写 item-disabled 即禁掉这一项，与列表级的 disabled 各管各的。 */
+  private partDisabled;
+  protected wire(): void;
+}
+//#endregion
 //#region src/elements/space.d.ts
 /**
  * `<xh-space>` —— Light-DOM 行为宿主，无状态机，把 connectSpace 产出打到 root 角色节点。
@@ -7251,7 +7848,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 +7864,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 +7900,7 @@ declare class XhSpaceElement extends XhElement {
       };
     };
   };
+  orientation?: SpaceProps['orientation'];
   direction?: SpaceProps['direction'];
   gap?: SpaceProps['gap'];
   align?: SpaceProps['align'];
@@ -7654,6 +8258,8 @@ declare class XhSwitchElement extends XhElement {
 }
 //#endregion
 //#region src/elements/table.d.ts
+/** 行换位事件的 detail：从机器 props 上的回调取，不在适配器里另抄一份类型。 */
+type TableRowMoveDetails = Parameters<NonNullable<TableSchema['props']['onRowMove']>>[0];
 /**
  * `<xh-table>` —— Light-DOM 行为宿主：作者写 root/caption/header/body/footer 与若干
  * row / column-header / cell 角色节点，元素跑 table 机器并把 connect 产出打上去。
@@ -7665,7 +8271,13 @@ declare class XhSwitchElement extends XhElement {
  * 同一个 row 部件写在 header / body / footer 里语义不同（表头行、数据行、脚注行），
  * 元素按祖先链现查区段，作者无需换用别的部件名。
  *
- * 两份定义与三个集合都是数组/对象，只走 property（`el.rows = [...]`）。
+ * 两份定义与三个集合都是数组/对象，只走 property（`el.rows = [...]`）；
+ * 落点校验 `allowRowDrop`（函数）同理。
+ *
+ * 打开 row-reorderable 后行可以拖着换位：整行都是拖动源。落点画在参照行上——
+ * data-drop 为 before/after 是插在这一行前后；rows 带 parentId 的树形表另有 inside，
+ * 是放进这一行底下，只有可展开或已经有孩子的行给这一档。触屏那一路走 row-drag-trigger 把手。
+ * 键盘走 Alt + 方向键：上下在同层挪一位，左右在树形表下改缩进层级（rtl 下左右对调）。
  *
  * @customElement xh-table
  * @attr {'none'|'single'|'multiple'} selection-mode - 选择模式，默认 none（不声明就没有选择这回事）
@@ -7676,12 +8288,18 @@ declare class XhSwitchElement extends XhElement {
  * @attr {boolean} borderless - 去掉外框，只留行间横线
  * @attr {boolean} ruled - 列与列之间加竖分隔线
  * @attr {boolean} footer - 表格带脚注行：行号空间的最后一行留给它，aria-rowcount 也算上
+ * @attr {boolean} row-reorderable - 行可以拖着换位：整行都是拖动源；触屏那一路走 row-drag-trigger 把手
  * @attr {boolean} loop - 上下键走到首尾回绕，默认关；写 loop="true" 打开
  * @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[] }`
+ * @fires row-move - 行换了位置；detail 为 `{ id, parent, index, ids }`，parent 为 null 即根层，index 是在那一层的落位（已算过先摘后插），ids 是重排好的整份行序
+ * @prop {(move: TableRowMoveDetails) => boolean} allowRowDrop - 这一次搬家许不许，收到的是折算好的落点；不给即都许
  * @csspart root - role=grid 容器（rows 里有可展开的行时为 treegrid），报行列总数与多选声明
  * @csspart caption - 表格标题（aria-labelledby 目标）
  * @csspart header - role=rowgroup 表头区
@@ -7693,6 +8311,10 @@ declare class XhSwitchElement extends XhElement {
  * @csspart select-all-trigger - 全选把手，三态（aria-checked 半选为 mixed），自占一个 Tab 位
  * @csspart row-select-trigger - 行选择把手（aria-hidden 且不占 Tab 位，键盘那一路由 Space 承担）
  * @csspart sort-trigger - 排序把手，自占一个 Tab 位；按住 Shift 点是追加到排序链
+ * @csspart column-resize-trigger - 列宽把手，自占一个 Tab 位；方向键改一步、按住 Shift 是大步
+ * @csspart column-drag-trigger - 列拖拽把手，自占一个 Tab 位；方向键移一位、Home/End 移到可拖区段首末
+ * @csspart row-drag-trigger - 行拖拽把手，触屏那一路的入口（自带 touch-action: none，按下即拖）；对读屏隐藏且不占 Tab 位，键盘那一路由表体上的 Alt + 方向键承担
+ * @csspart live-region - 视觉隐藏的播报区，列拖拽过程的读屏文案写在这里；须写在 root 之外（root 是 role=grid，它的子节点只能是 row 与 rowgroup）
  * @csspart expand-trigger - 展开把手（aria-hidden 且不占 Tab 位，键盘那一路由左右方向键承担）
  * @csspart expanded-row - role=row 详情行，须自带 value 属性与它所属的数据行配对，内部须放一个 cell 承载详情；收起时 hidden
  * @csspart empty - 空态节点，表体为空且不在加载时显形
@@ -7700,7 +8322,7 @@ declare class XhSwitchElement extends XhElement {
  */
 declare class XhTableElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "header" | "cell" | "empty" | "expand-trigger" | "body" | "row" | "footer" | "select-all-trigger" | "column-header" | "caption" | "row-select-trigger" | "sort-trigger" | "expanded-row" | "loading-state">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "header" | "cell" | "empty" | "expand-trigger" | "body" | "row" | "footer" | "live-region" | "select-all-trigger" | "column-header" | "caption" | "row-select-trigger" | "sort-trigger" | "column-resize-trigger" | "column-drag-trigger" | "row-drag-trigger" | "expanded-row" | "loading-state">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -7734,6 +8356,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;
     };
@@ -7758,6 +8400,13 @@ declare class XhTableElement extends XhElement {
     footer: {
       type: BooleanConstructor;
     };
+    rowReorderable: {
+      type: BooleanConstructor;
+      attribute: string;
+    };
+    allowRowDrop: {
+      attribute: boolean;
+    };
     loop: {
       converter: {
         fromAttribute: (v: string | null) => boolean | undefined;
@@ -7784,6 +8433,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;
@@ -7791,12 +8445,16 @@ declare class XhTableElement extends XhElement {
   borderless?: boolean;
   ruled?: boolean;
   footer?: boolean;
+  rowReorderable?: boolean;
+  allowRowDrop?: (move: TableRowMoveDetails) => boolean;
   loop?: boolean;
   direction?: Direction;
   size?: Size;
+  private readonly notifyColumnPreference;
   private readonly notifySort;
   private readonly notifySelection;
   private readonly notifyExpanded;
+  private readonly notifyRowMove;
   private readonly ctrl;
   private machineProps;
   /** 承载焦点的行被移出 DOM 时上报 TABLE.BLUR，让机器重挑焦点锚点。 */
@@ -7808,6 +8466,11 @@ declare class XhTableElement extends XhElement {
   private identityOf;
   private rowOf;
   private columnOf;
+  /**
+   * 播报区节点。第一次用时建出来挂在元素末尾，之后一直复用——
+   * 读屏不播报后插入的节点，等到拾起才建等于没有。
+   */
+  private ensureLiveRegion;
   /** 按祖先链现查行所在的区段。 */
   private sectionOf;
   protected wire(): void;
@@ -7818,6 +8481,13 @@ declare class XhTableElement extends XhElement {
  * `<xh-tabs>` —— Light-DOM 行为宿主，跑 tabs 机器并把 connect 产出打到 root/list/trigger/content
  * 角色节点上。条目身份取作者写在 trigger/content 上的 value 属性，trigger 的禁用由部件自报。
  *
+ * 读屏文案 `translations` 是对象，属性表达不了，只能走 property（`el.translations = {...}`）。
+ *
+ * 打开 reorderable 后标签可以拖着换位：整个标签都是拖动源。拖动中被拖的标签原地不动，
+ * 只落 data-dragging；落点画在参照标签上，data-drop 为 before/after 即插在这个标签前后。触屏那一路走 tab-drag-trigger 把手。
+ * 键盘走 Alt + 主轴方向键（横排是左右、竖排是上下，横排 rtl 下左右对调），一按就是一次完整提交。
+ * 顺序不由元素保管：换位只发 tab-move，标签序由使用方写回自己的数据源。
+ *
  * @customElement xh-tabs
  * @attr {string} value - 受控选中值；缺省该属性即非受控
  * @attr {string} default-value - 非受控的初始选中值
@@ -7828,15 +8498,19 @@ declare class XhTableElement extends XhElement {
  * @attr {'line'|'card'|'segment'} variant - 形态，默认 line
  * @attr {'brand'|'neutral'|'success'|'warning'|'danger'|'info'} tone - 语气
  * @attr {'sm'|'md'|'lg'} size - 尺寸
+ * @attr {boolean} reorderable - 标签可以拖着换位，默认关
  * @fires value-change - 选中值变化；detail 为 `{ value: string | null }`
+ * @fires tab-move - 标签换了位；detail 为 `{ value, from, to, values }`，values 是重排好的整份标签序
  * @csspart root - 组件根容器（承载 data-orientation）
  * @csspart list - role=tablist 容器（方向键与 Tab 序列在此收口）
+ * @csspart live-region - 视觉隐藏的播报区，拖动过程的读屏文案写在这里；写在 root 里、与 list 部件平级（root 自己不带角色，它落不进 role=tablist 的子节点集合）
  * @csspart trigger - role=tab 的标签按钮，须自带 value 属性标识身份
  * @csspart content - role=tabpanel 的面板，须自带 value 属性与 trigger 配对；未选中时 hidden
+ * @csspart tab-drag-trigger - 标签拖拽把手，触屏那一路的入口（自带 touch-action: none，按下即拖）；对读屏隐藏且不占 Tab 位，键盘那一路由标签带上的 Alt + 方向键承担
  */
 declare class XhTabsElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "list">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "list" | "live-region" | "tab-drag-trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -7891,6 +8565,12 @@ declare class XhTabsElement extends XhElement {
         fromAttribute: (v: string | null) => string | undefined;
       };
     };
+    reorderable: {
+      type: BooleanConstructor;
+    };
+    translations: {
+      attribute: boolean;
+    };
   };
   collection?: TabsNode[];
   value?: string;
@@ -7902,13 +8582,22 @@ declare class XhTabsElement extends XhElement {
   variant?: TabsVariant;
   tone?: Tone;
   size?: Size;
+  reorderable?: boolean;
+  translations?: Partial<TabsTranslations>;
   private readonly notify;
+  private readonly notifyTabMove;
   private readonly ctrl;
   /** 作者声明的条目禁用，只认首见那一份；给了 collection 时用它，否则现读 */
   private readonly declaredDisabled;
   private machineProps;
   /** 承载焦点的条目被移出 DOM 时浏览器不派 focusout，这里替 DOM 上报焦点离场。 */
   protected onPartsReleased(nodes: readonly HTMLElement[]): void;
+  /**
+   * 取把手所属标签的身份：向上找本宿主内最近的 trigger，没有包裹层时退回读节点自身。
+   * 越出本宿主的 trigger 不算数——嵌套 xh-tabs 的内层把手不会认外层的标签。
+   */
+  /** 把手所属的那个 trigger 节点；把手自己就写在 trigger 上时即它本身。 */
+  private triggerElOf;
   protected wire(): void;
 }
 //#endregion
@@ -8338,7 +9027,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" | "live-region" | "scroll-button">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8411,7 +9100,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: {
@@ -8843,20 +9532,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 +9554,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 +9575,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 +9608,6 @@ declare class XhToastElement extends XhElement {
   };
   toastId?: string;
   titleText?: string;
-  description?: string;
   type?: ToastType;
   duration?: number;
   removeDelay?: number;
@@ -8949,118 +9630,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 +9695,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 +9740,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 +9774,7 @@ declare class XhToggleGroupElement extends XhElement {
   multiple?: boolean;
   disabled?: boolean;
   disallowEmpty?: boolean;
+  size?: Size;
   orientation?: Orientation;
   direction?: Direction;
   loop?: boolean;
@@ -9680,6 +10256,8 @@ declare class XhTransferElement extends XhElement {
 }
 //#endregion
 //#region src/elements/tree.d.ts
+/** 搬家事件的 detail：从机器 props 上的回调取，不在适配器里另抄一份类型。 */
+type TreeNodeMoveDetails = Parameters<NonNullable<TreeSchema['props']['onNodeMove']>>[0];
 /**
  * `<xh-tree>` —— Light-DOM 行为宿主：作者写 root/label/tree 与若干 item / branch 角色节点，
  * 元素跑 tree 机器并把 connect 产出打上去。节点身份取自节点上的 value 属性。
@@ -9688,10 +10266,18 @@ declare class XhTransferElement extends XhElement {
  * 这份树数据——它是元信息的唯一事实源，作者的标记只管长相，两个适配器也就不会各推各的。
  * 因此 collection 必须与标记同源：标记里有、collection 里没有的节点报不出层级，也进不了导航。
  *
- * 树数据与展开/选中集合都是数组，属性表达不了，只能走 property（`el.collection = [...]`）。
+ * 树数据与展开/选中集合都是数组，属性表达不了，只能走 property（`el.collection = [...]`）；
+ * 落点校验 `allowDrop`（函数）与读屏文案 `translations`（对象）同理。
+ *
+ * 打开 node-draggable 后节点可以拖着搬家：整个节点都是拖动源。拖动中被拖的节点原地不动，
+ * 只落 data-dragging；落点画在参照节点上——data-drop 为 before/after 是插在这一行前后，
+ * 为 inside 是放进这个分支。触屏那一路走 node-drag-trigger 把手。
+ * 键盘走 Alt + 方向键：上下在同层兄弟间挪，左右改缩进层级（rtl 下左右对调），一按就是一次完整提交。
  *
  * @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" 关掉
@@ -9699,10 +10285,13 @@ declare class XhTransferElement extends XhElement {
  * @attr {boolean} loop - 上下键走到首尾回绕，默认关；写 loop="true" 打开
  * @attr {boolean} typeahead - 连打检索，默认开；写 typeahead="false" 关掉
  * @attr {'ltr'|'rtl'} dir - 文字方向，只对调左右方向键的展开/收起语义，默认 ltr
+ * @attr {boolean} node-draggable - 节点可以拖着搬家，默认关；不叫 draggable 是因为那是 HTML 全局属性，写在元素上浏览器会拿它接管原生拖放，指针就到不了这里
  * @fires expanded-change - 展开集合变化；detail 为 `{ value: string[] }`
  * @fires selection-change - 选中集合变化；detail 为 `{ value: string[] }`
+ * @fires node-move - 节点搬了家；detail 为 `{ value, parent, index }`，parent 为 null 即根层，index 是在那一层的落位（已算过先摘后插）
  * @csspart root - 组件根容器
  * @csspart label - 树标题（aria-labelledby 目标）
+ * @csspart live-region - 视觉隐藏的播报区，拖动过程的读屏文案写在这里；写在 root 里、与 tree 部件平级（root 自己不带角色，它落不进 role=tree 的子节点集合）
  * @csspart tree - role=tree 容器，键盘在此收口，也是 roving tabindex 的兜底位
  * @csspart item - role=treeitem 叶子，须自带 value 属性标识身份
  * @csspart item-text - 叶子文本
@@ -9715,10 +10304,11 @@ declare class XhTransferElement extends XhElement {
  * @csspart branch-indicator - 展开方向指示符（aria-hidden）
  * @csspart branch-text - 分支文本
  * @csspart branch-content - role=group 子层容器，收起时隐藏
+ * @csspart node-drag-trigger - 节点拖拽把手，触屏那一路的入口（自带 touch-action: none，按下即拖）；对读屏隐藏且不占 Tab 位，键盘那一路由树上的 Alt + 方向键承担
  */
 declare class XhTreeElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "label" | "item-text" | "item-indicator" | "tree" | "branch" | "branch-control" | "branch-trigger" | "branch-indicator" | "branch-text" | "branch-content" | "item-checkbox" | "branch-checkbox">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "label" | "item-text" | "item-indicator" | "tree" | "branch" | "branch-control" | "branch-trigger" | "branch-indicator" | "branch-text" | "branch-content" | "live-region" | "item-checkbox" | "branch-checkbox" | "node-drag-trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -9737,6 +10327,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;
@@ -9777,12 +10378,24 @@ declare class XhTreeElement extends XhElement {
       };
       attribute: string;
     };
+    nodeDraggable: {
+      type: BooleanConstructor;
+      attribute: string;
+    };
+    allowDrop: {
+      attribute: boolean;
+    };
+    translations: {
+      attribute: boolean;
+    };
   };
   collection?: TreeNode[];
   expandedValue?: string[];
   defaultExpandedValue?: string[];
   selection?: string[];
   defaultSelection?: string[];
+  multiple?: boolean;
+  leafOrientation?: Orientation;
   selectionMode?: TreeSelectionMode;
   cascade?: boolean;
   checkedStrategy?: TreeSchema['props']['checkedStrategy'];
@@ -9791,8 +10404,12 @@ declare class XhTreeElement extends XhElement {
   loop?: boolean;
   typeahead?: boolean;
   direction?: Direction;
+  nodeDraggable?: boolean;
+  allowDrop?: (move: TreeNodeMoveDetails) => boolean;
+  translations?: Partial<TreeTranslations>;
   private readonly notifyExpanded;
   private readonly notifySelection;
+  private readonly notifyNodeMove;
   private readonly ctrl;
   private machineProps;
   /**
@@ -10017,6 +10634,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 +10694,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 +10790,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, XhResizableElement, XhScrollAreaElement, XhScrollbarElement, XhSegmentedElement, XhSelectElement, XhSeparatorElement, XhSideNavElement, XhSignaturePadElement, XhSkeletonElement, XhSliderElement, XhSortableElement, 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