@xihan-ui/web-components 1.0.0 → 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, 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 { 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 {
@@ -123,7 +124,7 @@ declare class XhAccordionElement extends XhElement {
   private exitConfig;
   private ensureExitConfig;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "header" | "item" | "trigger" | "content">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "indicator" | "header" | "trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -252,7 +253,7 @@ declare class XhAlertElement extends XhElement {
  */
 declare class XhAnchorElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "list" | "link">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "list" | "link">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -770,7 +771,7 @@ declare class XhCalendarElement extends XhElement {
  */
 declare class XhCarouselElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "prev-trigger" | "next-trigger" | "viewport" | "item-group" | "indicator-group">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "viewport" | "indicator" | "prev-trigger" | "next-trigger" | "item-group" | "indicator-group">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -918,7 +919,7 @@ declare class XhCarouselElement extends XhElement {
  */
 declare class XhCascaderElement extends XhElement {
   static partContract: {
-    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">;
+    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">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1213,7 +1214,7 @@ declare class XhCheckboxElement extends XhElement {
  */
 declare class XhCheckboxGroupElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "label" | "item-text" | "hidden-input">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "trigger" | "label" | "item-text" | "hidden-input">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1418,7 +1419,7 @@ declare class XhCollapsibleElement extends XhElement {
   private config;
   private ensureConfig;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1497,7 +1498,7 @@ declare class XhCollapsibleElement extends XhElement {
  */
 declare class XhColorPickerElement extends XhElement {
   static partContract: {
-    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">;
+    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">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -1673,7 +1674,7 @@ declare class XhColorPickerElement extends XhElement {
  */
 declare class XhComboboxElement extends XhElement {
   static partContract: {
-    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">;
+    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">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -2009,7 +2010,7 @@ declare class XhConfigElement extends XhReactiveElement implements XhConfigScope
  */
 declare class XhContextMenuElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "trigger" | "content" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "trigger" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -2376,7 +2377,7 @@ declare class XhDateFieldElement extends XhElement {
  */
 declare class XhDatePickerElement extends XhElement {
   static partContract: {
-    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">;
+    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" | "segment-group">)[];
   };
@@ -2651,7 +2652,7 @@ declare class XhDatePickerElement extends XhElement {
  */
 declare class XhDialogElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"trigger" | "content" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"content" | "trigger" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -2807,7 +2808,7 @@ declare class XhDownloadTriggerElement extends XhElement {
  */
 declare class XhDrawerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "title" | "description" | "close-trigger" | "positioner" | "backdrop">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -3424,7 +3425,7 @@ declare class XhFileUploadElement extends XhElement {
  */
 declare class XhFloatingPanelElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "header" | "trigger" | "content" | "title" | "close-trigger" | "positioner" | "body" | "drag-trigger" | "resize-trigger" | "stage-trigger">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "header" | "trigger" | "title" | "close-trigger" | "positioner" | "body" | "drag-trigger" | "resize-trigger" | "stage-trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -3948,7 +3949,7 @@ declare class XhHotkeysElement extends XhElement {
  */
 declare class XhHoverCardElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "trigger" | "content" | "positioner" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "positioner" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -4197,7 +4198,7 @@ declare class XhImageElement extends XhElement {
  */
 declare class XhImageCropperElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "image" | "grid" | "viewport" | "hidden-input" | "crop-area" | "crop-handle">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "viewport" | "image" | "grid" | "hidden-input" | "crop-area" | "crop-handle">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -4350,7 +4351,7 @@ declare class XhImageCropperElement extends XhElement {
  */
 declare class XhImageViewerElement extends XhElement {
   static partContract: {
-    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">;
+    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: {
@@ -4928,7 +4929,7 @@ declare class XhMasonryElement extends XhElement {
  */
 declare class XhMenuElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"item" | "trigger" | "content" | "separator" | "positioner" | "group" | "group-label" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"item" | "content" | "trigger" | "separator" | "positioner" | "group" | "group-label" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -5091,7 +5092,7 @@ declare class XhMenubarElement extends XhElement {
   /** 闸门只用到 reducedMotion，本元素别处不需要 config，建一份共用即可。 */
   private exitConfig;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "trigger" | "content" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "trigger" | "separator" | "positioner" | "item-text" | "item-indicator" | "group" | "group-label">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -5230,7 +5231,7 @@ declare class XhNavigationMenuElement extends XhElement {
   /** 退场闸门与消解层共用一份环境包。 */
   private config;
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "content" | "list" | "link" | "viewport">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "viewport" | "indicator" | "trigger" | "list" | "link">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -6148,7 +6149,7 @@ declare class XhPinInputElement extends XhElement {
  */
 declare class XhPopoverElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"trigger" | "content" | "title" | "description" | "close-trigger" | "positioner" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"content" | "trigger" | "title" | "description" | "close-trigger" | "positioner" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -6340,7 +6341,7 @@ declare class XhProgressElement extends XhElement {
  */
 declare class XhRadioGroupElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "label" | "item-text" | "hidden-input">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "label" | "item-text" | "hidden-input">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -6533,6 +6534,146 @@ declare class XhRatingElement extends XhElement {
   protected wire(): void;
 }
 //#endregion
+//#region src/elements/resizable.d.ts
+/**
+ * `<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
@@ -6804,7 +6945,7 @@ declare class XhScrollbarElement extends XhElement {
  */
 declare class XhSegmentedElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "item-text" | "hidden-input">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "indicator" | "item-text" | "hidden-input">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -6966,7 +7107,7 @@ declare class XhSegmentedElement extends XhElement {
  */
 declare class XhSelectElement extends XhElement {
   static partContract: {
-    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">;
+    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">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -7596,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 角色节点。
@@ -7856,7 +8094,7 @@ declare class XhSplitterElement extends XhElement {
  */
 declare class XhStepsElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "indicator" | "item" | "trigger" | "content" | "title" | "description" | "list" | "separator">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "indicator" | "trigger" | "title" | "description" | "list" | "separator">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8020,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 产出打上去。
@@ -8031,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（不声明就没有选择这回事）
@@ -8042,6 +8288,7 @@ 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 - 密度：只换单元格的纵向内边距与字号，列宽不受影响
@@ -8051,6 +8298,8 @@ declare class XhSwitchElement extends XhElement {
  * @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 表头区
@@ -8062,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 - 空态节点，表体为空且不在加载时显形
@@ -8069,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: {
@@ -8147,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;
@@ -8185,6 +8445,8 @@ declare class XhTableElement extends XhElement {
   borderless?: boolean;
   ruled?: boolean;
   footer?: boolean;
+  rowReorderable?: boolean;
+  allowRowDrop?: (move: TableRowMoveDetails) => boolean;
   loop?: boolean;
   direction?: Direction;
   size?: Size;
@@ -8192,6 +8454,7 @@ declare class XhTableElement extends XhElement {
   private readonly notifySort;
   private readonly notifySelection;
   private readonly notifyExpanded;
+  private readonly notifyRowMove;
   private readonly ctrl;
   private machineProps;
   /** 承载焦点的行被移出 DOM 时上报 TABLE.BLUR，让机器重挑焦点锚点。 */
@@ -8203,6 +8466,11 @@ declare class XhTableElement extends XhElement {
   private identityOf;
   private rowOf;
   private columnOf;
+  /**
+   * 播报区节点。第一次用时建出来挂在元素末尾，之后一直复用——
+   * 读屏不播报后插入的节点，等到拾起才建等于没有。
+   */
+  private ensureLiveRegion;
   /** 按祖先链现查行所在的区段。 */
   private sectionOf;
   protected wire(): void;
@@ -8213,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 - 非受控的初始选中值
@@ -8223,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" | "trigger" | "content" | "list">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "trigger" | "list" | "live-region" | "tab-drag-trigger">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -8286,6 +8565,12 @@ declare class XhTabsElement extends XhElement {
         fromAttribute: (v: string | null) => string | undefined;
       };
     };
+    reorderable: {
+      type: BooleanConstructor;
+    };
+    translations: {
+      attribute: boolean;
+    };
   };
   collection?: TabsNode[];
   value?: string;
@@ -8297,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
@@ -8733,7 +9027,7 @@ declare class XhTextFieldElement extends XhElement {
  */
 declare class XhThreadElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "content" | "viewport" | "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: {
@@ -8980,7 +9274,7 @@ declare class XhTimeFieldElement extends XhElement {
  */
 declare class XhTimePickerElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "trigger" | "content" | "label" | "control" | "positioner" | "clear-trigger" | "input" | "column" | "hidden-input" | "segment-group" | "presets" | "preset">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"root" | "item" | "content" | "trigger" | "label" | "control" | "positioner" | "clear-trigger" | "input" | "column" | "hidden-input" | "segment-group" | "preset" | "presets">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -9606,7 +9900,7 @@ declare class XhToolbarElement extends XhElement {
  */
 declare class XhTooltipElement extends XhElement {
   static partContract: {
-    anatomy: import("@xihan-ui/kernel").Anatomy<"trigger" | "content" | "positioner" | "arrow">;
+    anatomy: import("@xihan-ui/kernel").Anatomy<"content" | "trigger" | "positioner" | "arrow">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   /** 退场闸门：收起从跟着 open 走改成跟着 presence 走，退场动画播完才真收。 */
@@ -9962,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 属性。
@@ -9970,7 +10266,13 @@ 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 {boolean} multiple - 复选，默认关闭
@@ -9983,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 - 叶子文本
@@ -9999,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: {
@@ -10072,6 +10378,16 @@ declare class XhTreeElement extends XhElement {
       };
       attribute: string;
     };
+    nodeDraggable: {
+      type: BooleanConstructor;
+      attribute: string;
+    };
+    allowDrop: {
+      attribute: boolean;
+    };
+    translations: {
+      attribute: boolean;
+    };
   };
   collection?: TreeNode[];
   expandedValue?: string[];
@@ -10088,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;
   /**
@@ -10169,7 +10489,7 @@ declare class XhTreeElement extends XhElement {
  */
 declare class XhTreeSelectElement extends XhElement {
   static partContract: {
-    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">;
+    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">;
     meta: import("@xihan-ui/headless").ComponentMeta;
   };
   static properties: {
@@ -10470,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, 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 };
+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