@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/components/cascader/cascader.d.ts

@@ -1,23 +1,26 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
+import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
 import { CascaderApi, CascaderExpandTrigger, CascaderNode, CascaderSchema, CascaderSearchResult, CascaderTranslations, CascaderValue } from "@xihan-ui/headless";
-import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/cascader/cascader.d.ts
 type CascaderProps = CascaderSchema['props'];
-/** 默认插槽的载荷：级联的展开态、选中态与列数据，以及改动它们的方法。 */
+/** 默认插槽的载荷：级联的展开态、选中态与列数据，以及修改它们的方法。 */
 type CascaderRootSlotProps = Pick<CascaderApi, 'open' | 'levels' | 'columns' | 'value' | 'valuePath' | 'activePath' | 'focusedPath' | 'displayText' | 'canClear' | 'isSelected' | 'isIndeterminate' | 'isActive' | 'isVisible' | 'setOpen' | 'setValue' | 'setActivePath' | 'select' | 'clear'>;
 declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<CascaderNode[]>;
-    default: undefined;
   };
   value: {
     type: PropType<CascaderValue>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<CascaderValue>;
-    default: undefined;
+  };
+  name: {
+    type: StringConstructor;
+  };
+  form: {
+    type: StringConstructor;
   };
   open: {
     type: BooleanConstructor;
@@ -26,7 +29,6 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   defaultOpen: BooleanConstructor;
   expandTrigger: {
     type: PropType<CascaderExpandTrigger>;
-    default: undefined;
   };
   changeOnSelect: BooleanConstructor;
   multiple: BooleanConstructor;
@@ -37,42 +39,43 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   cascade: BooleanConstructor;
   checkedStrategy: {
     type: PropType<CascaderProps["checkedStrategy"]>;
+  };
+  disabled: {
+    type: BooleanConstructor;
     default: undefined;
   };
-  disabled: BooleanConstructor;
-  readOnly: BooleanConstructor;
-  invalid: BooleanConstructor;
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  loading: BooleanConstructor;
   translations: {
     type: PropType<Partial<CascaderTranslations>>;
-    default: undefined;
   };
   variant: {
     type: PropType<ControlVariant>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   placeholder: {
     type: StringConstructor;
-    default: undefined;
   };
   separator: {
     type: StringConstructor;
-    default: undefined;
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -80,7 +83,6 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -92,15 +94,18 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<CascaderNode[]>;
-    default: undefined;
   };
   value: {
     type: PropType<CascaderValue>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<CascaderValue>;
-    default: undefined;
+  };
+  name: {
+    type: StringConstructor;
+  };
+  form: {
+    type: StringConstructor;
   };
   open: {
     type: BooleanConstructor;
@@ -109,7 +114,6 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   defaultOpen: BooleanConstructor;
   expandTrigger: {
     type: PropType<CascaderExpandTrigger>;
-    default: undefined;
   };
   changeOnSelect: BooleanConstructor;
   multiple: BooleanConstructor;
@@ -120,42 +124,43 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   cascade: BooleanConstructor;
   checkedStrategy: {
     type: PropType<CascaderProps["checkedStrategy"]>;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  readOnly: {
+    type: BooleanConstructor;
     default: undefined;
   };
-  disabled: BooleanConstructor;
-  readOnly: BooleanConstructor;
-  invalid: BooleanConstructor;
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  loading: BooleanConstructor;
   translations: {
     type: PropType<Partial<CascaderTranslations>>;
-    default: undefined;
   };
   variant: {
     type: PropType<ControlVariant>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   placeholder: {
     type: StringConstructor;
-    default: undefined;
   };
   separator: {
     type: StringConstructor;
-    default: undefined;
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -163,7 +168,6 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").CascaderValueChangeDetails) => any) | undefined;
@@ -172,29 +176,16 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
   invalid: boolean;
-  value: CascaderValue;
   multiple: boolean;
-  collection: CascaderNode[];
-  defaultValue: CascaderValue;
-  dir: Direction;
-  tone: Tone;
-  size: Size;
+  loop: boolean;
   disabled: boolean;
-  offset: number;
-  translations: Partial<CascaderTranslations>;
   open: boolean;
   defaultOpen: boolean;
-  variant: ControlVariant;
-  separator: string;
+  loading: boolean;
   readOnly: boolean;
-  loop: boolean;
-  checkedStrategy: import("@xihan-ui/behavior").CascadeStrategy | undefined;
   changeOnSelect: boolean;
   cascade: boolean;
-  expandTrigger: CascaderExpandTrigger;
   searchable: boolean;
-  placeholder: string;
-  placement: Placement;
 }, SlotsType<{
   default?: (props: CascaderRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -216,7 +207,20 @@ declare const XhCascaderIndicator: import("vue").DefineComponent<{}, () => VNode
 declare const XhCascaderClearTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhCascaderPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCascaderPositioner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCascaderLoading: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhCascaderContent: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -231,7 +235,7 @@ interface CascaderSearchListItemSlotProps {
 }
 declare const XhCascaderSearchList: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
+}>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
   item?: (props: CascaderSearchListItemSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhCascaderColumn: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -241,12 +245,28 @@ declare const XhCascaderColumn: import("vue").DefineComponent<import("vue").Extr
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   level: {
     type: PropType<number | string>;
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCascaderGroup: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCascaderGroupLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhCascaderItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
@@ -266,6 +286,9 @@ declare const XhCascaderItemText: import("vue").DefineComponent<{}, () => VNode<
 declare const XhCascaderItemIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCascaderFooter: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { CascaderRootSlotProps, CascaderSearchListItemSlotProps, XhCascaderClearTrigger, XhCascaderColumn, XhCascaderContent, XhCascaderControl, XhCascaderIndicator, XhCascaderInput, XhCascaderItem, XhCascaderItemIndicator, XhCascaderItemText, XhCascaderLabel, XhCascaderPositioner, XhCascaderRoot, XhCascaderSearchList, XhCascaderTrigger, XhCascaderValueText };
+export { CascaderRootSlotProps, CascaderSearchListItemSlotProps, XhCascaderClearTrigger, XhCascaderColumn, XhCascaderContent, XhCascaderControl, XhCascaderFooter, XhCascaderGroup, XhCascaderGroupLabel, XhCascaderIndicator, XhCascaderInput, XhCascaderItem, XhCascaderItemIndicator, XhCascaderItemText, XhCascaderLabel, XhCascaderLoading, XhCascaderPositioner, XhCascaderRoot, XhCascaderSearchList, XhCascaderTrigger, XhCascaderValueText };
 //# sourceMappingURL=cascader.d.ts.map

package/dist/components/cascader/cascader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cascader.d.ts","names":[],"sources":["../../../src/components/cascader/cascader.ts"],"mappings":";;;;;KAqBK,gBAAgB;;KAiCT,wBAAwB,KAClC;cAqBW,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;;;;;;IAGP,MAAA,SAAS;;;;;;;;;;;IAKP,MAAA,SAAS;;;;;;;IAIZ,MAAA,SAAS,QAAQ;;;;IACtB,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;IAGJ,MAAA,SAAS;;;;;;;;;;;;IAGf,MAAA,SAAS;;;;;;EAIL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;IA9BJ,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;IACF,MAAA,SAAS;;;;;;;;;IAGP,MAAA,SAAS;;;;;;;;;;;IAKP,MAAA,SAAS;;;;;;;IAIZ,MAAA,SAAS,QAAQ;;;;IACtB,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;IAGJ,MAAA,SAAS;;;;;;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUtB,WAAC,OAAO,0BAA0B;kCAuC9C;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAc5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAW9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAsB/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAwB5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;UAGe;EACf,QAAQ;;cAGG,oCAAoB,0BAAA,oBAAA,4BAAA;;;EAGtB,QAAC,OAAO,oCAAoC;kCAarD;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAWrC,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAiBzB,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"cascader.d.ts","names":[],"sources":["../../../src/components/cascader/cascader.ts"],"mappings":";;;;;KA+BK,gBAAgB;;KAiCT,wBAAwB,KAClC;cAqBW,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;IAKP,MAAA,SAAS;;;;;;;;;;IAKP,MAAA,SAAS;;;;;;;;;;;;;;;;IAKZ,MAAA,SAAS,QAAQ;;;IACtB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;IAGJ,MAAA,SAAS;;;;;;;;;;IAGf,MAAA,SAAS;;;;;EAIL,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;IAjCJ,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;IAKP,MAAA,SAAS;;;;;;;;;;IAKP,MAAA,SAAS;;;;;;;;;;;;;;;;IAKZ,MAAA,SAAS,QAAQ;;;IACtB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;IAGJ,MAAA,SAAS;;;;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;EAUtB,WAAC,OAAO,0BAA0B;kCA0C9C;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAc5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAW9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,8BAAA;;;IAIA,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAuBxC,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAc5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAiBW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAsC5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;UAGe;EACf,QAAQ;;cAGG,oCAAoB,0BAAA,oBAAA,4BAAA;;;EAGtB,QAAC,OAAO,oCAAoC;kCA8BrD;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MA4BrC,oDAAA;cAEW,+BAAe,8BAAA;;;;;;;;;;;;MAY1B,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,8BAAA;;;;;;;;;;;;MAiBzB,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAQ3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/cascader/cascader.js

@@ -1,11 +1,13 @@
 import { withXhConfig } from "../../config/config.js";
+import { XhPortal } from "../../runtime/portal.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
+import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
-import { provideCascader, provideCascaderItem, useCascaderContext, useCascaderItemContext } from "./context.js";
+import { provideCascader, provideCascaderContent, provideCascaderGroup, provideCascaderItem, useCascaderContentContext, useCascaderContext, useCascaderGroupContext, useCascaderItemContext } from "./context.js";
 import { useCascader } from "./use-cascader.js";
-import { Teleport, computed, defineComponent, h, mergeProps, onBeforeUnmount, ref, watch } from "vue";
+import { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from "vue";
 //#region src/components/cascader/cascader.ts
-/** 本条目持有焦点时，value 变更重报焦点条目，卸载时上报焦点丢失 */
+/** 本条目持有焦点时，value 变更重新报告焦点条目，卸载时上报焦点丢失 */
 function reportItemFocus(ctx, el, value) {
 	watch(value, (next, prev) => {
 		if (next === prev) return;
@@ -28,27 +30,17 @@ function reportItemFocus(ctx, el, value) {
 const XhCascaderRoot = defineComponent({
 	name: "XhCascaderRoot",
 	props: {
-		collection: {
-			type: Array,
-			default: void 0
-		},
-		value: {
-			type: Array,
-			default: void 0
-		},
-		defaultValue: {
-			type: Array,
-			default: void 0
-		},
+		collection: { type: Array },
+		value: { type: Array },
+		defaultValue: { type: Array },
+		name: { type: String },
+		form: { type: String },
 		open: {
 			type: Boolean,
 			default: void 0
 		},
 		defaultOpen: Boolean,
-		expandTrigger: {
-			type: String,
-			default: void 0
-		},
+		expandTrigger: { type: String },
 		changeOnSelect: Boolean,
 		multiple: Boolean,
 		searchable: {
@@ -56,53 +48,33 @@ const XhCascaderRoot = defineComponent({
 			default: void 0
 		},
 		cascade: Boolean,
-		checkedStrategy: {
-			type: String,
-			default: void 0
-		},
-		disabled: Boolean,
-		readOnly: Boolean,
-		invalid: Boolean,
-		translations: {
-			type: Object,
-			default: void 0
-		},
-		variant: {
-			type: String,
-			default: void 0
-		},
-		tone: {
-			type: String,
-			default: void 0
-		},
-		size: {
-			type: String,
-			default: void 0
-		},
-		placeholder: {
-			type: String,
-			default: void 0
-		},
-		separator: {
-			type: String,
+		checkedStrategy: { type: String },
+		disabled: {
+			type: Boolean,
 			default: void 0
 		},
-		placement: {
-			type: String,
+		readOnly: {
+			type: Boolean,
 			default: void 0
 		},
-		offset: {
-			type: Number,
+		invalid: {
+			type: Boolean,
 			default: void 0
 		},
+		loading: Boolean,
+		translations: { type: Object },
+		variant: { type: String },
+		tone: { type: String },
+		size: { type: String },
+		placeholder: { type: String },
+		separator: { type: String },
+		placement: { type: String },
+		offset: { type: Number },
 		loop: {
 			type: Boolean,
 			default: void 0
 		},
-		dir: {
-			type: String,
-			default: void 0
-		}
+		dir: { type: String }
 	},
 	emits: {
 		"value-change": (_details) => true,
@@ -120,12 +92,12 @@ const XhCascaderRoot = defineComponent({
 			emit("open-change", details);
 			emit("update:open", details.open);
 		};
-		const ctx = useCascader(withXhConfig("cascader", props), {
+		const ctx = useCascader(withXhConfig("cascader", useFormControlProps(props)), {
 			onValueChange: notifyValue,
 			onOpenChange: notifyOpen
 		});
 		provideCascader(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+		return () => h("div", ctx.api.value.getRootProps(), [slots.default?.({
 			open: ctx.api.value.open,
 			levels: ctx.api.value.levels,
 			columns: ctx.api.value.columns,
@@ -144,7 +116,10 @@ const XhCascaderRoot = defineComponent({
 			setActivePath: ctx.api.value.setActivePath,
 			select: ctx.api.value.select,
 			clear: ctx.api.value.clear
-		}));
+		}), ...ctx.api.value.value.map((path) => h("input", {
+			...ctx.api.value.getHiddenInputProps({ path }),
+			key: JSON.stringify(path)
+		}))]);
 	}
 });
 const XhCascaderLabel = defineComponent({
@@ -168,11 +143,11 @@ const XhCascaderTrigger = defineComponent({
 		const fieldLabel = useFieldLabelWiring();
 		const ctx = useCascaderContext();
 		return () => h("button", fieldLabel.value({
+			...fieldWiring.value,
 			...ctx.api.value.getTriggerProps(),
 			ref: (el) => {
 				ctx.triggerRef.value = el;
-			},
-			...fieldWiring.value
+			}
 		}), slots.default?.());
 	}
 });
@@ -199,15 +174,24 @@ const XhCascaderClearTrigger = defineComponent({
 });
 const XhCascaderPositioner = defineComponent({
 	name: "XhCascaderPositioner",
+	props: { 
+	/** 本实例的 Portal 容器；优先于应用级配置。 */
+container: { type: Object } },
 	inheritAttrs: false,
-	setup(_, { slots, attrs }) {
+	setup(props, { slots, attrs }) {
 		const ctx = useCascaderContext();
 		const bars = useScrollbars({
 			scrollable: () => ctx.contentRef.value,
 			axes: ["horizontal"],
-			props: () => ({ dir: ctx.api.value.getPositionerProps().dir })
+			props: () => ({
+				dir: ctx.api.value.getPositionerProps().dir,
+				size: "sm"
+			})
 		});
-		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+		return () => h(XhPortal, {
+			to: props.container ?? ctx.portalTarget.value,
+			source: ctx.triggerRef
+		}, () => [h("div", {
 			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
 			ref: (el) => {
 				ctx.positionerRef.value = el;
@@ -215,19 +199,58 @@ const XhCascaderPositioner = defineComponent({
 		}, [...slots.default?.() ?? [], ...bars.render()])]);
 	}
 });
+const XhCascaderLoading = defineComponent({
+	name: "XhCascaderLoading",
+	setup(_, { slots }) {
+		const ctx = useCascaderContext();
+		onBeforeUnmount(useCascaderContentContext().registerLoading());
+		return () => h("div", ctx.api.value.getLoadingProps(), slots.default?.() ?? ctx.api.value.translations.loading);
+	}
+});
+/** 放在作者插槽之后挂载；隔着普通元素或业务组件的 Loading 已在 setup 阶段登记。 */
+const XhCascaderAutoLoading = defineComponent({
+	name: "XhCascaderAutoLoading",
+	setup() {
+		const ctx = useCascaderContext();
+		const content = useCascaderContentContext();
+		return () => content.authoredLoadingCount.value > 0 ? null : h("div", {
+			...ctx.api.value.getLoadingProps(),
+			"data-xh-cascader-auto-loading": ""
+		}, ctx.api.value.translations.loading);
+	}
+});
 const XhCascaderContent = defineComponent({
 	name: "XhCascaderContent",
 	setup(_, { slots }) {
 		const ctx = useCascaderContext();
+		const authoredLoadingCount = ref(0);
+		const registerLoading = () => {
+			authoredLoadingCount.value += 1;
+			let active = true;
+			return () => {
+				if (!active) return;
+				active = false;
+				authoredLoadingCount.value -= 1;
+			};
+		};
+		provideCascaderContent({
+			authoredLoadingCount,
+			registerLoading
+		});
 		return () => {
 			const api = ctx.api.value;
+			const children = slots.default?.() ?? [];
 			return h("div", {
 				...api.getContentProps(),
 				style: ctx.visible.value ? void 0 : { display: "none" },
 				ref: (el) => {
 					ctx.contentRef.value = el;
 				}
-			}, [slots.default?.(), h("div", api.getEmptyProps(), slots.empty ? slots.empty() : api.searching ? api.translations.noMatch : api.translations.empty)]);
+			}, [
+				children,
+				h("div", api.getEmptyProps(), slots.empty ? slots.empty() : api.searching ? api.translations.noMatch : api.translations.empty),
+				h(XhCascaderAutoLoading)
+			]);
 		};
 	}
 });
@@ -241,12 +264,28 @@ const XhCascaderInput = defineComponent({
 const XhCascaderSearchList = defineComponent({
 	name: "XhCascaderSearchList",
 	slots: Object,
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = useCascaderContext();
-		return () => h("div", ctx.api.value.getSearchListProps(), ctx.api.value.searchResults.map((result) => h("div", {
+		const searchListRef = ref(null);
+		const bars = useScrollbars({
+			scrollable: () => searchListRef.value,
+			anchor: "layer",
+			props: () => ({
+				dir: ctx.api.value.getPositionerProps().dir,
+				size: "sm"
+			})
+		});
+		onUpdated(() => bars.measure());
+		return () => [h("div", {
+			...mergeProps(ctx.api.value.getSearchListProps(), attrs),
+			ref: (el) => {
+				searchListRef.value = el;
+			}
+		}, ctx.api.value.searchResults.map((result) => h("div", {
 			...ctx.api.value.getSearchItemProps({ path: result.path }),
 			key: result.key
-		}, slots.item ? slots.item({ result }) : result.labels.join(" / "))));
+		}, slots.item ? slots.item({ result }) : result.labels.join(" / ")))), ...bars.render()];
 	}
 });
 const XhCascaderColumn = defineComponent({
@@ -255,9 +294,46 @@ const XhCascaderColumn = defineComponent({
 		type: [Number, String],
 		required: true
 	} },
+	inheritAttrs: false,
+	setup(props, { slots, attrs }) {
+		const ctx = useCascaderContext();
+		const columnRef = ref(null);
+		const bars = useScrollbars({
+			scrollable: () => columnRef.value,
+			anchor: "layer",
+			props: () => ({
+				dir: ctx.api.value.getPositionerProps().dir,
+				size: "sm"
+			})
+		});
+		onUpdated(() => bars.measure());
+		return () => [h("div", {
+			...mergeProps(ctx.api.value.getColumnProps({ level: Number(props.level) }), attrs),
+			ref: (el) => {
+				columnRef.value = el;
+			}
+		}, slots.default?.()), ...bars.render()];
+	}
+});
+const XhCascaderGroup = defineComponent({
+	name: "XhCascaderGroup",
+	props: { value: {
+		type: String,
+		required: true
+	} },
 	setup(props, { slots }) {
 		const ctx = useCascaderContext();
-		return () => h("div", ctx.api.value.getColumnProps({ level: Number(props.level) }), slots.default?.());
+		const group = computed(() => ({ value: props.value }));
+		provideCascaderGroup({ group });
+		return () => h("div", ctx.api.value.getGroupProps(group.value), slots.default?.());
+	}
+});
+const XhCascaderGroupLabel = defineComponent({
+	name: "XhCascaderGroupLabel",
+	setup(_, { slots }) {
+		const ctx = useCascaderContext();
+		const { group } = useCascaderGroupContext();
+		return () => h("span", ctx.api.value.getGroupLabelProps(group.value), slots.default?.());
 	}
 });
 const XhCascaderItem = defineComponent({
@@ -294,7 +370,14 @@ const XhCascaderItemIndicator = defineComponent({
 		return () => h("span", ctx.api.value.getItemIndicatorProps(item.value), slots.default?.());
 	}
 });
+const XhCascaderFooter = defineComponent({
+	name: "XhCascaderFooter",
+	setup(_, { slots }) {
+		const ctx = useCascaderContext();
+		return () => h("div", ctx.api.value.getFooterProps(), slots.default?.());
+	}
+});
 //#endregion
-export { XhCascaderClearTrigger, XhCascaderColumn, XhCascaderContent, XhCascaderControl, XhCascaderIndicator, XhCascaderInput, XhCascaderItem, XhCascaderItemIndicator, XhCascaderItemText, XhCascaderLabel, XhCascaderPositioner, XhCascaderRoot, XhCascaderSearchList, XhCascaderTrigger, XhCascaderValueText };
+export { XhCascaderClearTrigger, XhCascaderColumn, XhCascaderContent, XhCascaderControl, XhCascaderFooter, XhCascaderGroup, XhCascaderGroupLabel, XhCascaderIndicator, XhCascaderInput, XhCascaderItem, XhCascaderItemIndicator, XhCascaderItemText, XhCascaderLabel, XhCascaderLoading, XhCascaderPositioner, XhCascaderRoot, XhCascaderSearchList, XhCascaderTrigger, XhCascaderValueText };
 
 //# sourceMappingURL=cascader.js.map