@xihan-ui/vue 4.1.0 → 5.0.0

package/dist/components/card/card.d.ts

@@ -1,4 +1,4 @@
-import { PropType } from "vue";
+import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant } from "@xihan-ui/core";
 //#region src/components/card/card.d.ts
 declare const XhCardRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -10,7 +10,7 @@ declare const XhCardRoot: import("vue").DefineComponent<import("vue").ExtractPro
     type: BooleanConstructor;
     default: undefined;
   };
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   variant: {
@@ -23,11 +23,17 @@ declare const XhCardRoot: import("vue").DefineComponent<import("vue").ExtractPro
   };
 }>> & Readonly<{}>, {
   interactive: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhCardHeader: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}, SlotsType<{
+  default?: () => VNode[];
+  title?: () => VNode[];
+  description?: () => VNode[];
+  content?: () => VNode[];
+  footer?: () => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCardHeader: 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 XhCardTitle: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCardTitle: 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>;
 /**
@@ -41,7 +47,7 @@ declare const XhCardTrigger: import("vue").DefineComponent<import("vue").Extract
   };
   /** 借用作者的子节点作为触发器，不再渲染自己的元素；子节点须恰好一个。 */
   asChild: BooleanConstructor;
-}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   /** 链接地址；给了渲染 `<a>`，不给渲染按钮。 */
@@ -53,13 +59,13 @@ declare const XhCardTrigger: import("vue").DefineComponent<import("vue").Extract
 }>> & Readonly<{}>, {
   asChild: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhCardDescription: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCardDescription: 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 XhCardContent: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCardContent: 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 XhCardFooter: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhCardFooter: 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

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

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","names":[],"sources":["../../../src/components/card/card.ts"],"mappings":";;;cAkBa,0BAAU,8BAAA;;IAIQ,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;;;;;qCAWtC;cAEW,4BAAY,wCAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,wCAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;cAMW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;qCAsBxB;cAEW,iCAAiB,wCAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,wCAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,wCAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"card.d.ts","names":[],"sources":["../../../src/components/card/card.ts"],"mappings":";;;cAmBa,0BAAU,8BAAA;;IAIQ,MAAA,SAAS;;;;;;;;;;;IAAT,MAAA,SAAS;;;;;;;;;;EAK1B,gBAAM;EACR,cAAM;EACA,oBAAM;EACV,gBAAM;EACP,eAAM;kCAWjB;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,0BAAA,oBAAA,4BAAA;;8BAMtB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;cAMW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;qCAsBxB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/card/card.js

@@ -1,10 +1,11 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
 import { provideCard, useCardContext } from "./context.js";
+import { cardStructure, connectCard } from "@xihan-ui/headless";
 import { computed, defineComponent, h } from "vue";
-import { connectCard } from "@xihan-ui/headless";
 //#region src/components/card/card.ts
 const XhCardRoot = defineComponent({
 	name: "XhCardRoot",
@@ -16,11 +17,17 @@ const XhCardRoot = defineComponent({
 			default: void 0
 		}
 	},
+	slots: Object,
 	setup(props, { slots }) {
 		const configured = withXhConfig("card", props);
 		const api = computed(() => connectCard(configured, vueNormalize));
 		provideCard({ api });
-		return () => h("div", api.value.getRootProps(), slots.default?.());
+		return () => h("div", api.value.getRootProps(), slots.default ? slots.default() : renderDefaultStructure({
+			title: slots.title,
+			description: slots.description,
+			content: slots.content,
+			footer: slots.footer
+		}));
 	}
 });
 const XhCardHeader = defineComponent({
@@ -87,6 +94,21 @@ const XhCardFooter = defineComponent({
 		return () => h("div", ctx.api.value.getFooterProps(), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const CARD_PARTS = {
+	header: XhCardHeader,
+	title: XhCardTitle,
+	description: XhCardDescription,
+	content: XhCardContent,
+	footer: XhCardFooter
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 cardStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。给了哪个插槽才铺哪一段。
+*/
+function renderDefaultStructure(sections) {
+	return renderStructure(cardStructure({ slotted: (name) => sections[name] != null }), CARD_PARTS, (node) => node.slot ? sections[node.slot.name]?.() : void 0);
+}
 //#endregion
 export { XhCardContent, XhCardDescription, XhCardFooter, XhCardHeader, XhCardRoot, XhCardTitle, XhCardTrigger };
 

package/dist/components/card/card.js.map

@@ -1 +1 @@
-{"version":3,"file":"card.js","names":[],"sources":["../../../src/components/card/card.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 card 相关实现。\n\nimport type { ControlVariant } from '@xihan-ui/core'\nimport type { CardProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectCard } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideCard, useCardContext } from './context'\n\nexport const XhCardRoot = defineComponent({\n  name: 'XhCardRoot',\n  // 缺省值由 connect 给出。\n  props: {\n    variant: { type: String as PropType<ControlVariant> },\n    /** 整卡可交互：标题里的 trigger 把点击区铺满整张卡片。 */\n    interactive: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('card', props)\n    const api = computed(() => connectCard(configured as CardProps, vueNormalize))\n    provideCard({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCardHeader = defineComponent({\n  name: 'XhCardHeader',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCardTitle = defineComponent({\n  name: 'XhCardTitle',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('h3', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 整卡的触发器，放在 title 里：给了 href 渲染链接，不给渲染 `<button type=\"button\">`；\n * 路由链接等作者自己的节点用 asChild。卡片 interactive 时它的点击区铺满整张卡片。\n */\nexport const XhCardTrigger = defineComponent({\n  name: 'XhCardTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 链接地址；给了渲染 `<a>`，不给渲染按钮。 */\n    href: { type: String },\n    /** 借用作者的子节点作为触发器，不再渲染自己的元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useCardContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      if (props.asChild)\n        return mergeIntoChild(children, part, 'card')\n      return props.href == null\n        ? h('button', { type: 'button', ...part }, children)\n        : h('a', { ...part, href: props.href }, children)\n    }\n  },\n})\n\nexport const XhCardDescription = defineComponent({\n  name: 'XhCardDescription',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCardContent = defineComponent({\n  name: 'XhCardContent',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCardFooter = defineComponent({\n  name: 'XhCardFooter',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('div', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;;;AAkBA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CAEN,OAAO;EACL,SAAS,EAAE,MAAM,OAAmC;;EAEpD,aAAa;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CACnD;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,QAAQ,KAAK;EAC7C,MAAM,MAAM,eAAe,YAAY,YAAyB,YAAY,CAAC;EAC7E,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAC9F;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,cAAc,gBAAgB;CACzC,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;;;;;AAMD,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,cAAc;CACd,OAAO;;EAEL,MAAM,EAAE,MAAM,OAAO;;EAErB,SAAS;CACX;CACA,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,eAAe;EAC3B,aAAa;GACX,MAAM,OAAO,eAAe,IAAI,IAAI,MAAM,gBAAgB,GAA8B,KAAK;GAC7F,MAAM,WAAW,MAAM,UAAU;GACjC,IAAI,MAAM,SACR,OAAO,eAAe,UAAU,MAAM,MAAM;GAC9C,OAAO,MAAM,QAAQ,OACjB,EAAE,UAAU;IAAE,MAAM;IAAU,GAAG;GAAK,GAAG,QAAQ,IACjD,EAAE,KAAK;IAAE,GAAG;IAAM,MAAM,MAAM;GAAK,GAAG,QAAQ;EACpD;CACF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC"}
+{"version":3,"file":"card.js","names":[],"sources":["../../../src/components/card/card.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 card 相关实现。\n\nimport type { ControlVariant } from '@xihan-ui/core'\nimport type { CardProps } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { cardStructure, connectCard } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { renderStructure } from '../../runtime/structure'\nimport { provideCard, useCardContext } from './context'\n\nexport const XhCardRoot = defineComponent({\n  name: 'XhCardRoot',\n  // 缺省值由 connect 给出。\n  props: {\n    variant: { type: String as PropType<ControlVariant> },\n    /** 整卡可交互：标题里的 trigger 把点击区铺满整张卡片。 */\n    interactive: { type: Boolean, default: undefined },\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n    title?: () => VNode[]\n    description?: () => VNode[]\n    content?: () => VNode[]\n    footer?: () => VNode[]\n  }>,\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('card', props)\n    const api = computed(() => connectCard(configured as CardProps, vueNormalize))\n    provideCard({ api })\n    return () => h('div', api.value.getRootProps() as Record<string, unknown>, slots.default\n      ? slots.default()\n      : renderDefaultStructure({ title: slots.title, description: slots.description, content: slots.content, footer: slots.footer }))\n  },\n})\n\nexport const XhCardHeader = defineComponent({\n  name: 'XhCardHeader',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCardTitle = defineComponent({\n  name: 'XhCardTitle',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('h3', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 整卡的触发器，放在 title 里：给了 href 渲染链接，不给渲染 `<button type=\"button\">`；\n * 路由链接等作者自己的节点用 asChild。卡片 interactive 时它的点击区铺满整张卡片。\n */\nexport const XhCardTrigger = defineComponent({\n  name: 'XhCardTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 链接地址；给了渲染 `<a>`，不给渲染按钮。 */\n    href: { type: String },\n    /** 借用作者的子节点作为触发器，不再渲染自己的元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useCardContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      if (props.asChild)\n        return mergeIntoChild(children, part, 'card')\n      return props.href == null\n        ? h('button', { type: 'button', ...part }, children)\n        : h('a', { ...part, href: props.href }, children)\n    }\n  },\n})\n\nexport const XhCardDescription = defineComponent({\n  name: 'XhCardDescription',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCardContent = defineComponent({\n  name: 'XhCardContent',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('div', ctx.api.value.getContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCardFooter = defineComponent({\n  name: 'XhCardFooter',\n  setup(_, { slots }) {\n    const ctx = useCardContext()\n    return () => h('div', ctx.api.value.getFooterProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst CARD_PARTS = {\n  header: XhCardHeader,\n  title: XhCardTitle,\n  description: XhCardDescription,\n  content: XhCardContent,\n  footer: XhCardFooter,\n}\n\ntype CardSectionSlots = Readonly<Partial<Record<'title' | 'description' | 'content' | 'footer', () => VNode[]>>>\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 cardStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。给了哪个插槽才铺哪一段。\n */\nfunction renderDefaultStructure(sections: CardSectionSlots): VNode[] {\n  const nodes = cardStructure({ slotted: name => sections[name as keyof CardSectionSlots] != null })\n  return renderStructure(nodes, CARD_PARTS, node => (node.slot ? sections[node.slot.name as keyof CardSectionSlots]?.() : undefined))\n}\n"],"mappings":";;;;;;;;;AAmBA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CAEN,OAAO;EACL,SAAS,EAAE,MAAM,OAAmC;;EAEpD,aAAa;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CACnD;CACA,OAAO;CAOP,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,QAAQ,KAAK;EAC7C,MAAM,MAAM,eAAe,YAAY,YAAyB,YAAY,CAAC;EAC7E,YAAY,EAAE,IAAI,CAAC;EACnB,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,MAAM,UAC7E,MAAM,QAAQ,IACd,uBAAuB;GAAE,OAAO,MAAM;GAAO,aAAa,MAAM;GAAa,SAAS,MAAM;GAAS,QAAQ,MAAM;EAAO,CAAC,CAAC;CAClI;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,cAAc,gBAAgB;CACzC,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;;;;;AAMD,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,cAAc;CACd,OAAO;;EAEL,MAAM,EAAE,MAAM,OAAO;;EAErB,SAAS;CACX;CACA,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,eAAe;EAC3B,aAAa;GACX,MAAM,OAAO,eAAe,IAAI,IAAI,MAAM,gBAAgB,GAA8B,KAAK;GAC7F,MAAM,WAAW,MAAM,UAAU;GACjC,IAAI,MAAM,SACR,OAAO,eAAe,UAAU,MAAM,MAAM;GAC9C,OAAO,MAAM,QAAQ,OACjB,EAAE,UAAU;IAAE,MAAM;IAAU,GAAG;GAAK,GAAG,QAAQ,IACjD,EAAE,KAAK;IAAE,GAAG;IAAM,MAAM,MAAM;GAAK,GAAG,QAAQ;EACpD;CACF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,eAAe;EAC3B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;;AAGD,MAAM,aAAa;CACjB,QAAQ;CACR,OAAO;CACP,aAAa;CACb,SAAS;CACT,QAAQ;AACV;;;;;AAQA,SAAS,uBAAuB,UAAqC;CAEnE,OAAO,gBADO,cAAc,EAAE,UAAS,SAAQ,SAAS,SAAmC,KAAK,CACrE,GAAG,aAAY,SAAS,KAAK,OAAO,SAAS,KAAK,KAAK,KAA+B,GAAG,IAAI,KAAA,CAAU;AACpI"}

package/dist/components/card/context.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { CardApi } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/card/context.d.ts
 interface CardContext {
   api: ComputedRef<CardApi>;

package/dist/components/carousel/carousel.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CarouselApi, CarouselEffect, CarouselSchema, CarouselTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Orientation, Size } from "@xihan-ui/core";
-import { CarouselApi, CarouselEffect, CarouselSchema, CarouselTranslations } from "@xihan-ui/headless";
 //#region src/components/carousel/carousel.d.ts
 type CarouselProps = CarouselSchema['props'];
 /** 默认插槽的载荷：当前页与翻页区间、自动播放与拖拽状态，以及翻页、播放的命令。 */

package/dist/components/carousel/use-carousel.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { CarouselApi, CarouselSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/carousel/use-carousel.d.ts
 interface CarouselContext {
   api: ComputedRef<CarouselApi>;

package/dist/components/carousel/use-carousel.js

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { carouselMachine, connectCarousel } from "@xihan-ui/headless";
 import { computed } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { carouselMachine, connectCarousel } from "@xihan-ui/headless";
 //#region src/components/carousel/use-carousel.ts
 function useCarousel(props, onPageChange) {
 	const service = useMachine(carouselMachine, () => ({

package/dist/components/cartesian-chart/cartesian-chart.d.ts

@@ -1,6 +1,6 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { CartesianAnnotation, CartesianAxis, CartesianBrush, CartesianBrushSelection, CartesianChartApi, CartesianChartSchema, CartesianChartTranslations, CartesianOrientation, CartesianRenderer, CartesianSeries, CartesianTooltipModel, CartesianTooltipOrder, CartesianTrigger, CartesianWindow, CartesianZoom, ChartDatumDetails, ChartKey, ChartPalette, ChartRow, ColumnSource } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/cartesian-chart/cartesian-chart.d.ts
 type CartesianChartProps = CartesianChartSchema['props'];
 /** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */
@@ -229,24 +229,24 @@ declare const XhCartesianChartRoot: import("vue").DefineComponent<import("vue").
     type: PropType<Partial<CartesianChartTranslations>>;
   };
 }>> & Readonly<{
-  "onHidden-series-change"?: ((_details: import("@xihan-ui/headless").ChartHiddenSeriesChangeDetails) => any) | undefined;
-  "onUpdate:hiddenSeries"?: ((_hidden: string[]) => any) | undefined;
+  "onDatum-active"?: ((_details: ChartDatumDetails | null) => any) | undefined;
+  "onDatum-press"?: ((_details: ChartDatumDetails) => any) | undefined;
   "onActive-key-change"?: ((_details: import("@xihan-ui/headless").ChartActiveKeyChangeDetails) => any) | undefined;
   "onUpdate:activeKey"?: ((_key: ChartKey | null) => any) | undefined;
+  "onHidden-series-change"?: ((_details: import("@xihan-ui/headless").ChartHiddenSeriesChangeDetails) => any) | undefined;
+  "onUpdate:hiddenSeries"?: ((_hidden: string[]) => any) | undefined;
   "onWindow-change"?: ((_details: import("@xihan-ui/headless").CartesianWindowChangeDetails) => any) | undefined;
   "onUpdate:window"?: ((_window: CartesianWindow) => any) | undefined;
   "onFollow-change"?: ((_details: import("@xihan-ui/headless").CartesianFollowChangeDetails) => any) | undefined;
   "onUpdate:follow"?: ((_follow: boolean) => any) | undefined;
   "onBrush-selection-change"?: ((_details: import("@xihan-ui/headless").CartesianBrushSelectionChangeDetails) => any) | undefined;
   "onUpdate:brushSelection"?: ((_selection: CartesianWindow | null) => any) | undefined;
-  "onDatum-active"?: ((_details: ChartDatumDetails | null) => any) | undefined;
-  "onDatum-press"?: ((_details: ChartDatumDetails) => any) | undefined;
 }>, {
+  animated: boolean;
   pending: boolean;
   follow: boolean;
   totals: boolean;
   defaultFollow: boolean;
-  animated: boolean;
 }, SlotsType<{
   /** 自行摆放部件；不写时铺开缺省结构：图例、视口（绘图区与空态）、提示框。 */
   default?: (props: CartesianChartRootSlotProps) => VNode[];

package/dist/components/cartesian-chart/use-cartesian-chart.d.ts

@@ -1,6 +1,6 @@
+import { CartesianChartApi, CartesianChartSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { CartesianChartApi, CartesianChartSchema } from "@xihan-ui/headless";
 //#region src/components/cartesian-chart/use-cartesian-chart.d.ts
 /** 对外的回调：由外壳（emit）或组合式调用方提供，随 props 一并喂给机器。 */
 type CartesianChartNotifiers = Pick<CartesianChartSchema['props'], 'onHiddenSeriesChange' | 'onActiveKeyChange' | 'onWindowChange' | 'onFollowChange' | 'onBrushSelectionChange' | 'onDatumActive' | 'onDatumPress'>;

package/dist/components/cartesian-chart/use-cartesian-chart.js

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed, ref } from "vue";
 import { cartesianChartMachine, connectCartesianChart } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/cartesian-chart/use-cartesian-chart.ts
 /** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */
 function useCartesianChart(props, notify) {

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

@@ -1,12 +1,22 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CascaderApi, CascaderExpandTrigger, CascaderNode, CascaderSchema, CascaderSearchResult, CascaderTranslations, CascaderValue } from "@xihan-ui/headless";
 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";
 //#region src/components/cascader/cascader.d.ts
 type CascaderProps = CascaderSchema['props'];
 /** 默认插槽的载荷：级联的展开态、选中态与列数据、多选的可见标签与折起的个数，以及修改它们的方法。 */
 type CascaderRootSlotProps = Pick<CascaderApi, 'open' | 'levels' | 'columns' | 'value' | 'valuePath' | 'activePath' | 'focusedPath' | 'displayText' | 'canClear' | 'tags' | 'overflowCount' | 'overflowText' | 'isSelected' | 'isIndeterminate' | 'isActive' | 'isVisible' | 'setOpen' | 'setValue' | 'setActivePath' | 'select' | 'clear' | 'deselect'>;
 declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时盒里带清空按钮；写了插槽时放 clear-trigger 部件即可清空。 */
+  clearable: BooleanConstructor;
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<CascaderNode[]>;
   };
@@ -64,6 +74,10 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loading: BooleanConstructor;
   translations: {
     type: PropType<Partial<CascaderTranslations>>;
@@ -108,6 +122,16 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   'branch-load': (_details: PayloadOf<CascaderProps, "onBranchLoad">) => true;
   'branch-load-error': (_details: PayloadOf<CascaderProps, "onBranchLoadError">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不写默认插槽时盒里带清空按钮；写了插槽时放 clear-trigger 部件即可清空。 */
+  clearable: BooleanConstructor;
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<CascaderNode[]>;
   };
@@ -165,6 +189,10 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
     type: BooleanConstructor;
     default: undefined;
   };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   loading: BooleanConstructor;
   translations: {
     type: PropType<Partial<CascaderTranslations>>;
@@ -207,6 +235,7 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   "onBranch-load"?: ((_details: import("@xihan-ui/headless").CascaderBranchLoadDetails) => any) | undefined;
   "onBranch-load-error"?: ((_details: import("@xihan-ui/headless").CascaderBranchLoadErrorDetails) => any) | undefined;
 }>, {
+  required: boolean;
   invalid: boolean;
   multiple: boolean;
   loop: boolean;
@@ -215,11 +244,13 @@ declare const XhCascaderRoot: import("vue").DefineComponent<import("vue").Extrac
   defaultOpen: boolean;
   loading: boolean;
   readOnly: boolean;
+  clearable: boolean;
   changeOnSelect: boolean;
   cascade: boolean;
   searchable: boolean;
 }, SlotsType<{
   default?: (props: CascaderRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhCascaderLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

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

@@ -1 +1 @@
-{"version":3,"file":"cascader.d.ts","names":[],"sources":["../../../src/components/cascader/cascader.ts"],"mappings":"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"}
+{"version":3,"file":"cascader.d.ts","names":[],"sources":["../../../src/components/cascader/cascader.ts"],"mappings":"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"}

package/dist/components/cascader/cascader.js

@@ -1,3 +1,4 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { slotIsPlainText } from "../../runtime/slot-content.js";
@@ -7,7 +8,8 @@ import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideCascader, provideCascaderContent, provideCascaderGroup, provideCascaderItem, provideCascaderTag, useCascaderContentContext, useCascaderContext, useCascaderGroupContext, useCascaderItemContext, useCascaderTagContext } from "./context.js";
 import { useCascader } from "./use-cascader.js";
-import { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUpdated, ref, watch } from "vue";
+import { cascaderStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, mergeProps, onBeforeUnmount, onUnmounted, onUpdated, ref, watch } from "vue";
 //#region src/components/cascader/cascader.ts
 /** 本条目持有焦点时，value 变更重新报告焦点条目，卸载时上报焦点丢失 */
 function reportItemFocus(ctx, el, value) {
@@ -32,6 +34,12 @@ function reportItemFocus(ctx, el, value) {
 const XhCascaderRoot = defineComponent({
 	name: "XhCascaderRoot",
 	props: {
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不写默认插槽时盒里带清空按钮；写了插槽时放 clear-trigger 部件即可清空。 */
+		clearable: Boolean,
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		collection: { type: Array },
 		/** 取回懒分支（hasChildren 且没给 children）的直接子项；展开路径走到它时自动调用。 */
 		loadChildren: { type: Function },
@@ -69,6 +77,10 @@ const XhCascaderRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		loading: Boolean,
 		translations: { type: Object },
 		variant: { type: String },
@@ -112,39 +124,54 @@ const XhCascaderRoot = defineComponent({
 			onBranchLoadError: (details) => emit("branch-load-error", details)
 		});
 		provideCascader(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), [slots.default?.({
-			open: ctx.api.value.open,
-			levels: ctx.api.value.levels,
-			columns: ctx.api.value.columns,
-			value: ctx.api.value.value,
-			valuePath: ctx.api.value.valuePath,
-			activePath: ctx.api.value.activePath,
-			focusedPath: ctx.api.value.focusedPath,
-			displayText: ctx.api.value.displayText,
-			canClear: ctx.api.value.canClear,
-			tags: ctx.api.value.tags,
-			overflowCount: ctx.api.value.overflowCount,
-			overflowText: ctx.api.value.overflowText,
-			isSelected: ctx.api.value.isSelected,
-			isIndeterminate: ctx.api.value.isIndeterminate,
-			isActive: ctx.api.value.isActive,
-			isVisible: ctx.api.value.isVisible,
-			setOpen: ctx.api.value.setOpen,
-			setValue: ctx.api.value.setValue,
-			setActivePath: ctx.api.value.setActivePath,
-			select: ctx.api.value.select,
-			clear: ctx.api.value.clear,
-			deselect: ctx.api.value.deselect
-		}), ...ctx.api.value.value.map((path) => h("input", {
-			...ctx.api.value.getHiddenInputProps({ path }),
-			key: JSON.stringify(path)
-		}))]);
+		return () => h("div", ctx.api.value.getRootProps(), [
+			!slots.default ? renderDefaultStructure(ctx.api.value, {
+				label: props.label,
+				clearable: props.clearable,
+				searchable: props.searchable
+			}, slots.label) : slots.default({
+				open: ctx.api.value.open,
+				levels: ctx.api.value.levels,
+				columns: ctx.api.value.columns,
+				value: ctx.api.value.value,
+				valuePath: ctx.api.value.valuePath,
+				activePath: ctx.api.value.activePath,
+				focusedPath: ctx.api.value.focusedPath,
+				displayText: ctx.api.value.displayText,
+				canClear: ctx.api.value.canClear,
+				tags: ctx.api.value.tags,
+				overflowCount: ctx.api.value.overflowCount,
+				overflowText: ctx.api.value.overflowText,
+				isSelected: ctx.api.value.isSelected,
+				isIndeterminate: ctx.api.value.isIndeterminate,
+				isActive: ctx.api.value.isActive,
+				isVisible: ctx.api.value.isVisible,
+				setOpen: ctx.api.value.setOpen,
+				setValue: ctx.api.value.setValue,
+				setActivePath: ctx.api.value.setActivePath,
+				select: ctx.api.value.select,
+				clear: ctx.api.value.clear,
+				deselect: ctx.api.value.deselect
+			}),
+			...ctx.api.value.value.map((path) => h("input", {
+				...ctx.api.value.getHiddenInputProps({ path }),
+				key: JSON.stringify(path)
+			})),
+			...ctx.api.value.value.length === 0 && ctx.api.value.required ? [h("input", {
+				...ctx.api.value.getHiddenInputProps(),
+				key: "required"
+			})] : []
+		]);
 	}
 });
 const XhCascaderLabel = defineComponent({
 	name: "XhCascaderLabel",
 	setup(_, { slots }) {
 		const ctx = useCascaderContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -498,6 +525,56 @@ const XhCascaderFooter = defineComponent({
 		return () => h("div", ctx.api.value.getFooterProps(), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件；委派部件按「组件名/部件名」查。 */
+const CASCADER_PARTS = {
+	"label": XhCascaderLabel,
+	"control": XhCascaderControl,
+	"trigger": XhCascaderTrigger,
+	"value-text": XhCascaderValueText,
+	"tag-list": XhCascaderTagList,
+	"indicator": XhCascaderIndicator,
+	"clear-trigger": XhCascaderClearTrigger,
+	"positioner": XhCascaderPositioner,
+	"content": XhCascaderContent,
+	"input": XhCascaderInput,
+	"search-list": XhCascaderSearchList,
+	"column": XhCascaderColumn,
+	"item": XhCascaderItem,
+	"item-text": XhCascaderItemText,
+	"item-description": XhCascaderItemDescription,
+	"item-indicator": XhCascaderItemIndicator,
+	"tag/tag": XhCascaderTag,
+	"tag/overflow-tag": XhCascaderOverflowTag
+};
+/** 浮层自己铺空态与在途，候选列表自己铺每条候选，列自己铺懒分支的三块状态：铺结构时去掉这些格子。 */
+const SELF_ASSEMBLED = /* @__PURE__ */ new Set([
+	"empty",
+	"loading",
+	"search-item",
+	"branch-loading",
+	"branch-error",
+	"branch-retry-trigger"
+]);
+function withoutSelfAssembled(nodes) {
+	return nodes.flatMap((node) => {
+		if (!("part" in node)) return [node];
+		if (SELF_ASSEMBLED.has(node.part)) return [];
+		return [node.children ? {
+			...node,
+			children: withoutSelfAssembled(node.children)
+		} : node];
+	});
+}
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 cascaderStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管；表单影子仍由根按选中路径装配在后面。
+*/
+function renderDefaultStructure(api, options, labelSlot) {
+	return renderStructure(withoutSelfAssembled(cascaderStructure(api, {
+		...options,
+		slotted: (name) => name === "label" && labelSlot != null
+	})), CASCADER_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhCascaderClearTrigger, XhCascaderColumn, XhCascaderContent, XhCascaderControl, XhCascaderFooter, XhCascaderGroup, XhCascaderGroupLabel, XhCascaderIndicator, XhCascaderInput, XhCascaderItem, XhCascaderItemDeleteTrigger, XhCascaderItemDescription, XhCascaderItemIndicator, XhCascaderItemSuffix, XhCascaderItemText, XhCascaderLabel, XhCascaderLoading, XhCascaderOverflowTag, XhCascaderPositioner, XhCascaderRoot, XhCascaderSearchList, XhCascaderTag, XhCascaderTagLabel, XhCascaderTagList, XhCascaderTrigger, XhCascaderValueText };