@xihan-ui/vue 1.1.0 → 2.0.0

package/dist/components/segmented/segmented.js

@@ -1,3 +1,4 @@
+import { useFormControlProps } from "../form/use-form-control.js";
 import { provideSegmented, provideSegmentedItem, useSegmentedContext, useSegmentedItemContext } from "./context.js";
 import { useSegmented } from "./use-segmented.js";
 import { computed, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
@@ -5,18 +6,9 @@ import { computed, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
 const XhSegmentedRoot = defineComponent({
 	name: "XhSegmentedRoot",
 	props: {
-		collection: {
-			type: Array,
-			default: void 0
-		},
-		value: {
-			type: String,
-			default: void 0
-		},
-		defaultValue: {
-			type: String,
-			default: void 0
-		},
+		collection: { type: Array },
+		value: { type: String },
+		defaultValue: { type: String },
 		disabled: {
 			type: Boolean,
 			default: void 0
@@ -33,18 +25,9 @@ const XhSegmentedRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		name: {
-			type: String,
-			default: void 0
-		},
-		orientation: {
-			type: String,
-			default: void 0
-		},
-		dir: {
-			type: String,
-			default: void 0
-		},
+		name: { type: String },
+		orientation: { type: String },
+		dir: { type: String },
 		loop: {
 			type: Boolean,
 			default: void 0
@@ -53,14 +36,8 @@ const XhSegmentedRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		tone: {
-			type: String,
-			default: void 0
-		},
-		size: {
-			type: String,
-			default: void 0
-		}
+		tone: { type: String },
+		size: { type: String }
 	},
 	emits: {
 		"value-change": (_details) => true,
@@ -72,7 +49,7 @@ const XhSegmentedRoot = defineComponent({
 			emit("value-change", details);
 			emit("update:value", details.value);
 		};
-		const ctx = useSegmented(props, notify);
+		const ctx = useSegmented(useFormControlProps(props), notify);
 		provideSegmented(ctx);
 		return () => h("div", {
 			...ctx.api.value.getRootProps(),
@@ -128,7 +105,7 @@ const XhSegmentedItemText = defineComponent({
 		return () => h("span", ctx.api.value.getItemTextProps(item.value), slots.default?.());
 	}
 });
-/** 会滑动的选中标记，位置由机器量好写进内联样式的私有槽；无选中项时收起。 */
+/** 滑动的选中标记，位置由状态机测量后写入内联样式的私有槽；无选中项时收起。 */
 const XhSegmentedIndicator = defineComponent({
 	name: "XhSegmentedIndicator",
 	setup() {
@@ -136,7 +113,7 @@ const XhSegmentedIndicator = defineComponent({
 		return () => h("span", ctx.api.value.getIndicatorProps());
 	}
 });
-/** 表单出口：给了 name 才带上它，提交的就是当前选中值。 */
+/** 表单出口：提供 name 时才带上它，提交的即当前选中值。 */
 const XhSegmentedHiddenInput = defineComponent({
 	name: "XhSegmentedHiddenInput",
 	setup() {
@@ -145,9 +122,9 @@ const XhSegmentedHiddenInput = defineComponent({
 	}
 });
 /**
-* 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。
-* 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。
-* 指示器排在最前：它绝对定位，靠文档序让后面的段压在它上面，段里的文字才不会被盖住。
+* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
+* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
+* 指示器排在最前：它绝对定位，依靠文档序让后面的段覆盖在它上面，段中的文字才不会被遮住。
 */
 function renderDefaultTree(collection, itemSlot) {
 	return [

package/dist/components/segmented/segmented.js.map

@@ -1 +1 @@
-{"version":3,"file":"segmented.js","names":[],"sources":["../../../src/components/segmented/segmented.ts"],"sourcesContent":["import type { SegmentedItemProps, SegmentedNode, SegmentedNodeMeta, SegmentedSchema } from '@xihan-ui/headless'\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { provideSegmented, provideSegmentedItem, useSegmentedContext, useSegmentedItemContext } from './context'\nimport { useSegmented } from './use-segmented'\n\ntype SegmentedProps = SegmentedSchema['props']\n\nexport const XhSegmentedRoot = defineComponent({\n  name: 'XhSegmentedRoot',\n  // 全部 default: undefined，缺省值由机器与 connect 决定\n  props: {\n    collection: { type: Array as PropType<SegmentedNode[]>, default: undefined },\n    value: { type: String as PropType<string | null>, default: undefined },\n    defaultValue: { type: String as PropType<string | null>, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String, default: undefined },\n    orientation: { type: String as PropType<Orientation>, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    block: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<SegmentedProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<SegmentedProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n    /** 铺开 collection 时每一段的文本插槽。 */\n    item?: (props: SegmentedNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: SegmentedProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useSegmented(props as SegmentedProps, notify)\n    provideSegmented(ctx)\n    // 写了默认插槽就整套结构自理：隐藏输入也要自己放一个 XhSegmentedHiddenInput，\n    // 否则给了 name 也没有任何东西参与提交\n    return () => h(\n      'div',\n      { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef },\n      slots.default\n        ? slots.default()\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.item)\n          : [],\n    )\n  },\n})\n\nexport const XhSegmentedItem = defineComponent({\n  name: 'XhSegmentedItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useSegmentedContext()\n    const item = computed<SegmentedItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideSegmentedItem({ item })\n    // 本段持有焦点时，value 变更重报焦点段，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'GROUP.BLUR' })\n    })\n    // 用原生 button，Enter/Space 的激活交给平台\n    return () => h(\n      'button',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhSegmentedItemText = defineComponent({\n  name: 'XhSegmentedItemText',\n  setup(_, { slots }) {\n    const ctx = useSegmentedContext()\n    const { item } = useSegmentedItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 会滑动的选中标记，位置由机器量好写进内联样式的私有槽；无选中项时收起。 */\nexport const XhSegmentedIndicator = defineComponent({\n  name: 'XhSegmentedIndicator',\n  setup() {\n    const ctx = useSegmentedContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>)\n  },\n})\n\n/** 表单出口：给了 name 才带上它，提交的就是当前选中值。 */\nexport const XhSegmentedHiddenInput = defineComponent({\n  name: 'XhSegmentedHiddenInput',\n  setup() {\n    const ctx = useSegmentedContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/**\n * 没写默认插槽时按 collection 铺开的整套结构，作者只交数据。\n * 与手写部件产出的 DOM 完全一致，要改结构就写默认插槽，行为不变。\n * 指示器排在最前：它绝对定位，靠文档序让后面的段压在它上面，段里的文字才不会被盖住。\n */\nfunction renderDefaultTree(\n  collection: readonly SegmentedNodeMeta[],\n  itemSlot?: (node: SegmentedNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    h(XhSegmentedIndicator),\n    ...collection.map(node => h(XhSegmentedItem, { key: node.value, value: node.value }, () => [\n      h(XhSegmentedItemText, null, () => itemSlot?.(node) ?? node.label),\n    ])),\n    h(XhSegmentedHiddenInput),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"segmented.js","names":[],"sources":["../../../src/components/segmented/segmented.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// 提供 segmented 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { SegmentedItemProps, SegmentedNode, SegmentedNodeMeta, SegmentedSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideSegmented, provideSegmentedItem, useSegmentedContext, useSegmentedItemContext } from './context'\nimport { useSegmented } from './use-segmented'\n\ntype SegmentedProps = SegmentedSchema['props']\n\nexport const XhSegmentedRoot = defineComponent({\n  name: 'XhSegmentedRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<SegmentedNode[]> },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    loop: { type: Boolean, default: undefined },\n    block: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<SegmentedProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<SegmentedProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: () => VNode[]\n    /** 铺开 collection 时每一段的文本插槽。 */\n    item?: (props: SegmentedNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: SegmentedProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useSegmented(useFormControlProps(props) as SegmentedProps, notify)\n    provideSegmented(ctx)\n    // 写了默认插槽就整套结构自理：隐藏输入也要自己放一个 XhSegmentedHiddenInput，\n    // 否则给了 name 也没有任何东西参与提交\n    return () => h(\n      'div',\n      { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef },\n      slots.default\n        ? slots.default()\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.item)\n          : [],\n    )\n  },\n})\n\nexport const XhSegmentedItem = defineComponent({\n  name: 'XhSegmentedItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useSegmentedContext()\n    const item = computed<SegmentedItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideSegmentedItem({ item })\n    // 本段持有焦点时，value 变更重报焦点段，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'GROUP.BLUR' })\n    })\n    // 用原生 button，Enter/Space 的激活交给平台\n    return () => h(\n      'button',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhSegmentedItemText = defineComponent({\n  name: 'XhSegmentedItemText',\n  setup(_, { slots }) {\n    const ctx = useSegmentedContext()\n    const { item } = useSegmentedItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 滑动的选中标记，位置由状态机测量后写入内联样式的私有槽；无选中项时收起。 */\nexport const XhSegmentedIndicator = defineComponent({\n  name: 'XhSegmentedIndicator',\n  setup() {\n    const ctx = useSegmentedContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>)\n  },\n})\n\n/** 表单出口：提供 name 时才带上它，提交的即当前选中值。 */\nexport const XhSegmentedHiddenInput = defineComponent({\n  name: 'XhSegmentedHiddenInput',\n  setup() {\n    const ctx = useSegmentedContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 指示器排在最前：它绝对定位，依靠文档序让后面的段覆盖在它上面，段中的文字才不会被遮住。\n */\nfunction renderDefaultTree(\n  collection: readonly SegmentedNodeMeta[],\n  itemSlot?: (node: SegmentedNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    h(XhSegmentedIndicator),\n    ...collection.map(node => h(XhSegmentedItem, { key: node.value, value: node.value }, () => [\n      h(XhSegmentedItemText, null, () => itemSlot?.(node) ?? node.label),\n    ])),\n    h(XhSegmentedHiddenInput),\n  ]\n}\n"],"mappings":";;;;;AAkBA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,OAAO;EACL,YAAY,EAAE,MAAM,MAAmC;EACvD,OAAO,EAAE,MAAM,OAAkC;EACjD,cAAc,EAAE,MAAM,OAAkC;EACxD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM,EAAE,MAAM,OAAO;EACrB,aAAa,EAAE,MAAM,OAAgC;EACrD,KAAK,EAAE,MAAM,OAA8B;EAC3C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,OAAO;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC3C,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;CACzC;CAEA,OAAO;EACL,iBAAiB,aAAyD;EAC1E,iBAAiB,WAAgE;CACnF;CACA,OAAO;CAKP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA2C,YAAY;GAC3D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,MAAM,aAAa,oBAAoB,KAAK,GAAqB,MAAM;EAC7E,iBAAiB,GAAG;EAGpB,aAAa,EACX,OACA;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;GAA8B,KAAK,IAAI;EAAQ,GAC/E,MAAM,UACF,MAAM,QAAQ,IACd,MAAM,aACJ,kBAAkB,IAAI,IAAI,MAAM,YAAY,MAAM,IAAI,IACtD,CAAC,CACT;CACF;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EAEtC,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAChD;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,oBAAoB;EAChC,MAAM,OAAO,gBAAoC;GAAE,OAAO,MAAM;GAAO,UAAU,MAAM;EAAS,EAAE;EAClG,qBAAqB,EAAE,KAAK,CAAC;EAE7B,MAAM,SAAS,IAAwB,IAAI;EAC3C,YAAY,MAAM,QAAQ,MAAM,SAAS;GACvC,IAAI,SAAS,MACX;GACF,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GACF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK;IAAE,MAAM;IAAc,OAAO;GAAK,CAAC;EACpD,CAAC;EACD,sBAAsB;GACpB,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,aAAa,CAAC;EACvC,CAAC;EAED,aAAa,EACX,UACA;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa,KAAK,KAAK;GAA8B,KAAK;EAAO,GACpF,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,MAAM,EAAE,SAAS,wBAAwB;EACzC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,CAA4B;CACrF;AACF,CAAC;;AAGD,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,oBAAoB,CAA4B;CACxF;AACF,CAAC;;;;;;AAOD,SAAS,kBACP,YACA,UACS;CACT,OAAO;EACL,EAAE,oBAAoB;EACtB,GAAG,WAAW,KAAI,SAAQ,EAAE,iBAAiB;GAAE,KAAK,KAAK;GAAO,OAAO,KAAK;EAAM,SAAS,CACzF,EAAE,qBAAqB,YAAY,WAAW,IAAI,KAAK,KAAK,KAAK,CACnE,CAAC,CAAC;EACF,EAAE,sBAAsB;CAC1B;AACF"}

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

@@ -1,12 +1,12 @@
 import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
 import { SegmentedApi, SegmentedSchema } from "@xihan-ui/headless";
-import { Service } from "@xihan-ui/machine";
 //#region src/components/segmented/use-segmented.d.ts
 interface SegmentedContext {
   api: ComputedRef<SegmentedApi>;
-  /** 机器实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */
+  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */
   service: Service<SegmentedSchema>;
-  /** root 节点：条目集合的查询容器，同时是指示器量测的参照系。 */
+  /** root 节点：条目集合的查询容器，同时是指示器测量的参照系。 */
   rootRef: Ref<HTMLElement | null>;
 }
 declare function useSegmented(props: SegmentedSchema['props'], onValueChange?: SegmentedSchema['props']['onValueChange']): SegmentedContext;

package/dist/components/segmented/use-segmented.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-segmented.d.ts","names":[],"sources":["../../../src/components/segmented/use-segmented.ts"],"mappings":";;;;UAQiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;iBAIC,aACd,OAAO,0BACP,gBAAgB,4CACf"}
+{"version":3,"file":"use-segmented.d.ts","names":[],"sources":["../../../src/components/segmented/use-segmented.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;iBAIC,aACd,OAAO,0BACP,gBAAgB,4CACf"}

package/dist/components/segmented/use-segmented.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-segmented.js","names":[],"sources":["../../../src/components/segmented/use-segmented.ts"],"sourcesContent":["import type { SegmentedApi, SegmentedSchema } from '@xihan-ui/headless'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectSegmented, segmentedMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface SegmentedContext {\n  api: ComputedRef<SegmentedApi>\n  /** 机器实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<SegmentedSchema>\n  /** root 节点：条目集合的查询容器，同时是指示器量测的参照系。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useSegmented(\n  props: SegmentedSchema['props'],\n  onValueChange?: SegmentedSchema['props']['onValueChange'],\n): SegmentedContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const service = useMachine(segmentedMachine, () => ({ ...props, onValueChange }))\n\n  // 指示器的量测在机器里跑，DOM 侧的取值口经 refs 交进去\n  service.refs.set('getRootEl', () => rootRef.value)\n\n  const api = computed(() => connectSegmented(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;AAiBA,SAAgB,aACd,OACA,eACkB;CAClB,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO;CAAc,EAAE;CAGhF,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAGjD,OAAO;EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD;EAAG;EAAS;CAAQ;AACjC"}
+{"version":3,"file":"use-segmented.js","names":[],"sources":["../../../src/components/segmented/use-segmented.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// 提供 use segmented 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { SegmentedApi, SegmentedSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectSegmented, segmentedMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface SegmentedContext {\n  api: ComputedRef<SegmentedApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<SegmentedSchema>\n  /** root 节点：条目集合的查询容器，同时是指示器测量的参照系。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useSegmented(\n  props: SegmentedSchema['props'],\n  onValueChange?: SegmentedSchema['props']['onValueChange'],\n): SegmentedContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const service = useMachine(segmentedMachine, () => ({ ...props, onValueChange }))\n\n  // 指示器的量测在机器里跑，DOM 侧的取值口经 refs 交进去\n  service.refs.set('getRootEl', () => rootRef.value)\n\n  const api = computed(() => connectSegmented(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;AAwBA,SAAgB,aACd,OACA,eACkB;CAClB,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO;CAAc,EAAE;CAGhF,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAGjD,OAAO;EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD;EAAG;EAAS;CAAQ;AACjC"}

package/dist/components/select/context.js

@@ -18,6 +18,15 @@ function useSelectItemContext() {
 	if (!ctx) throw new Error("[xh] Select 条目子部件必须用在 XhSelectItem 内");
 	return ctx;
 }
+const GROUP_KEY = Symbol.for("xh-select-group");
+function provideSelectGroup(ctx) {
+	provide(GROUP_KEY, ctx);
+}
+function useSelectGroupContext() {
+	const ctx = inject(GROUP_KEY, null);
+	if (!ctx) throw new Error("[xh] Select 分组标题必须用在 XhSelectGroup 内");
+	return ctx;
+}
 const TAG_KEY = Symbol.for("xh-select-tag");
 function provideSelectTag(ctx) {
 	provide(TAG_KEY, ctx);
@@ -28,6 +37,6 @@ function useSelectTagContext() {
 	return ctx;
 }
 //#endregion
-export { provideSelect, provideSelectItem, provideSelectTag, useSelectContext, useSelectItemContext, useSelectTagContext };
+export { provideSelect, provideSelectGroup, provideSelectItem, provideSelectTag, useSelectContext, useSelectGroupContext, useSelectItemContext, useSelectTagContext };
 
 //# sourceMappingURL=context.js.map

package/dist/components/select/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/select/context.ts"],"sourcesContent":["import type { SelectItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { SelectContext } from './use-select'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的值与禁用，供 item-text / item-indicator 这类子部件复用同一份声明。 */\nexport interface SelectItemContext {\n  item: ComputedRef<SelectItemProps>\n}\n\nconst KEY: InjectionKey<SelectContext> = Symbol.for('xh-select')\nconst ITEM_KEY: InjectionKey<SelectItemContext> = Symbol.for('xh-select-item')\n\nexport function provideSelect(ctx: SelectContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useSelectContext(): SelectContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Select 部件必须用在 XhSelectRoot 内')\n  return ctx\n}\n\nexport function provideSelectItem(ctx: SelectItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useSelectItemContext(): SelectItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Select 条目子部件必须用在 XhSelectItem 内')\n  return ctx\n}\n\n/** 标签自报的值，供 item-delete-trigger 复用同一份声明。 */\nexport interface SelectTagContext {\n  value: () => string\n}\n\nconst TAG_KEY: InjectionKey<SelectTagContext> = Symbol.for('xh-select-tag')\n\nexport function provideSelectTag(ctx: SelectTagContext): void {\n  provide(TAG_KEY, ctx)\n}\n\nexport function useSelectTagContext(): SelectTagContext {\n  const ctx = inject(TAG_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Select 标签子部件必须用在 XhSelectTag 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAmC,OAAO,IAAI,WAAW;AAC/D,MAAM,WAA4C,OAAO,IAAI,gBAAgB;AAE7E,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT;AAEA,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT;AAOA,MAAM,UAA0C,OAAO,IAAI,eAAe;AAE1E,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,SAAS,IAAI;CAChC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/select/context.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// 提供 context 相关实现。\n\nimport type { SelectGroupProps, SelectItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { SelectContext } from './use-select'\nimport { inject, provide } from 'vue'\n\n/** 条目声明的值与禁用，供 item-text / item-indicator 等子部件复用同一份声明。 */\nexport interface SelectItemContext {\n  item: ComputedRef<SelectItemProps>\n}\n\nconst KEY: InjectionKey<SelectContext> = Symbol.for('xh-select')\nconst ITEM_KEY: InjectionKey<SelectItemContext> = Symbol.for('xh-select-item')\n\nexport function provideSelect(ctx: SelectContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useSelectContext(): SelectContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Select 部件必须用在 XhSelectRoot 内')\n  return ctx\n}\n\nexport function provideSelectItem(ctx: SelectItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useSelectItemContext(): SelectItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Select 条目子部件必须用在 XhSelectItem 内')\n  return ctx\n}\n\n/** 分组声明的身份，供分组标题取到同一个值（标题的 id 由它派生）。 */\nexport interface SelectGroupContext {\n  group: ComputedRef<SelectGroupProps>\n}\n\nconst GROUP_KEY: InjectionKey<SelectGroupContext> = Symbol.for('xh-select-group')\n\nexport function provideSelectGroup(ctx: SelectGroupContext): void {\n  provide(GROUP_KEY, ctx)\n}\n\nexport function useSelectGroupContext(): SelectGroupContext {\n  const ctx = inject(GROUP_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Select 分组标题必须用在 XhSelectGroup 内')\n  return ctx\n}\n\n/** 标签声明的值，供标签中的删除按钮复用同一份声明。 */\nexport interface SelectTagContext {\n  value: () => string\n}\n\nconst TAG_KEY: InjectionKey<SelectTagContext> = Symbol.for('xh-select-tag')\n\nexport function provideSelectTag(ctx: SelectTagContext): void {\n  provide(TAG_KEY, ctx)\n}\n\nexport function useSelectTagContext(): SelectTagContext {\n  const ctx = inject(TAG_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Select 标签子部件必须用在 XhSelectTag 内')\n  return ctx\n}\n"],"mappings":";;AAiBA,MAAM,MAAmC,OAAO,IAAI,WAAW;AAC/D,MAAM,WAA4C,OAAO,IAAI,gBAAgB;AAE7E,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT;AAEA,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT;AAOA,MAAM,YAA8C,OAAO,IAAI,iBAAiB;AAEhF,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,WAAW,GAAG;AACxB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,WAAW,IAAI;CAClC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,sCAAsC;CACxD,OAAO;AACT;AAOA,MAAM,UAA0C,OAAO,IAAI,eAAe;AAE1E,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,SAAS,IAAI;CAChC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT"}

package/dist/components/select/select.d.ts

@@ -1,27 +1,23 @@
 import { PropType, SlotsType, VNode } from "vue";
+import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/core";
 import { SelectApi, SelectNode, SelectNodeMeta, SelectOpenChangeDetails, SelectSchema, SelectValueChangeDetails } from "@xihan-ui/headless";
-import { ControlVariant, Direction, Placement, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/select/select.d.ts
 type SelectProps = SelectSchema['props'];
-/** 默认插槽的载荷：展开态、选中集合与显示文字、可见标签与被折起的个数，以及改展开、改值、清空、摘值四个动作。 */
-type SelectRootSlotProps = Pick<SelectApi, 'open' | 'value' | 'displayText' | 'tags' | 'overflowCount' | 'setOpen' | 'setValue' | 'clear' | 'deselect'>;
+/** 默认插槽的载荷：展开态、选中集合与显示文字、可见标签与被折叠的个数及其文字，以及修改展开、修改值、清空、移除值四个动作。 */
+type SelectRootSlotProps = Pick<SelectApi, 'open' | 'value' | 'displayText' | 'tags' | 'overflowCount' | 'overflowText' | 'setOpen' | 'setValue' | 'clear' | 'deselect'>;
 declare const XhSelectRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<SelectNode[]>;
-    default: undefined;
   };
-  /** 标题文字。给了它就不必再写 label 部件；要放别的内容改用 label 插槽。 */
+  /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
   label: {
     type: StringConstructor;
-    default: undefined;
   };
   value: {
     type: PropType<string | string[] | null>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<string | string[] | null>;
-    default: undefined;
   };
   multiple: BooleanConstructor;
   open: {
@@ -29,42 +25,46 @@ declare const XhSelectRoot: import("vue").DefineComponent<import("vue").ExtractP
     default: undefined;
   };
   defaultOpen: BooleanConstructor;
-  disabled: BooleanConstructor;
-  /** 只读：浮层照常展开与浏览，但选中值改不动、也清不掉。 */
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 只读：浮层照常展开与浏览，但选中值不可修改、也不可清空。 */
   readOnly: {
     type: BooleanConstructor;
     default: undefined;
   };
-  /** 自动渲染树里是否带清空按钮；手写部件不看它，写了节点即可清。 */
+  /** 自动渲染树中是否带清空按钮；手写部件不使用它，写了节点即可清空。 */
   clearable: BooleanConstructor;
   invalid: {
     type: BooleanConstructor;
     default: undefined;
   };
-  required: BooleanConstructor;
+  loading: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
-    default: undefined;
   };
   translations: {
     type: PropType<SelectProps["translations"]>;
-    default: undefined;
   };
   maxTagCount: {
     type: NumberConstructor;
-    default: undefined;
   };
   placeholder: {
     type: StringConstructor;
-    default: undefined;
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -72,19 +72,15 @@ declare const XhSelectRoot: import("vue").DefineComponent<import("vue").ExtractP
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   variant: {
     type: PropType<ControlVariant>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -96,20 +92,16 @@ declare const XhSelectRoot: import("vue").DefineComponent<import("vue").ExtractP
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<SelectNode[]>;
-    default: undefined;
   };
-  /** 标题文字。给了它就不必再写 label 部件；要放别的内容改用 label 插槽。 */
+  /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
   label: {
     type: StringConstructor;
-    default: undefined;
   };
   value: {
     type: PropType<string | string[] | null>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<string | string[] | null>;
-    default: undefined;
   };
   multiple: BooleanConstructor;
   open: {
@@ -117,42 +109,46 @@ declare const XhSelectRoot: import("vue").DefineComponent<import("vue").ExtractP
     default: undefined;
   };
   defaultOpen: BooleanConstructor;
-  disabled: BooleanConstructor;
-  /** 只读：浮层照常展开与浏览，但选中值改不动、也清不掉。 */
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  /** 只读：浮层照常展开与浏览，但选中值不可修改、也不可清空。 */
   readOnly: {
     type: BooleanConstructor;
     default: undefined;
   };
-  /** 自动渲染树里是否带清空按钮；手写部件不看它，写了节点即可清。 */
+  /** 自动渲染树中是否带清空按钮；手写部件不使用它，写了节点即可清空。 */
   clearable: BooleanConstructor;
   invalid: {
     type: BooleanConstructor;
     default: undefined;
   };
-  required: BooleanConstructor;
+  loading: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
-    default: undefined;
   };
   translations: {
     type: PropType<SelectProps["translations"]>;
-    default: undefined;
   };
   maxTagCount: {
     type: NumberConstructor;
-    default: undefined;
   };
   placeholder: {
     type: StringConstructor;
-    default: undefined;
   };
   placement: {
     type: PropType<Placement>;
-    default: undefined;
   };
   offset: {
     type: NumberConstructor;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
@@ -160,19 +156,15 @@ declare const XhSelectRoot: import("vue").DefineComponent<import("vue").ExtractP
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   variant: {
     type: PropType<ControlVariant>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>> & Readonly<{
   "onValue-change"?: ((_details: SelectValueChangeDetails) => any) | undefined;
@@ -181,28 +173,15 @@ declare const XhSelectRoot: import("vue").DefineComponent<import("vue").ExtractP
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
   required: boolean;
-  name: string;
   invalid: boolean;
-  label: string;
-  value: string | string[] | null;
   multiple: boolean;
-  collection: SelectNode[];
-  defaultValue: string | string[] | null;
-  dir: Direction;
-  tone: Tone;
-  size: Size;
+  loop: boolean;
   disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<import("@xihan-ui/headless").SelectTranslations> | undefined;
-  offset: number;
+  loading: boolean;
   readOnly: boolean;
-  placeholder: string;
-  loop: boolean;
-  placement: Placement;
-  variant: ControlVariant;
   clearable: boolean;
-  maxTagCount: number;
 }, SlotsType<{
   default?: (props: SelectRootSlotProps) => VNode[];
   label?: () => VNode[];
@@ -226,6 +205,14 @@ declare const XhSelectIndicator: import("vue").DefineComponent<{}, () => VNode<i
 declare const XhSelectClearTrigger: 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 XhSelectTagList: 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>;
+/** 标签文字所在的块（tag 的 label）：截断规则挂在这一层。 */
+declare const XhSelectTagLabel: 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>;
+/** 一个选中值一个标签，即库内 tag 的 root（data-scope="tag"）：语气、尺寸与禁用从 select 传下，形态按控件的面派生；触发器内纯展示，触发器外配合 XhSelectItemDeleteTrigger 可删除。 */
 declare const XhSelectTag: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   /** 它代表哪个选中值。 */
   value: {
@@ -241,12 +228,27 @@ declare const XhSelectTag: import("vue").DefineComponent<import("vue").ExtractPr
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhSelectItemDeleteTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 折叠的标签合成的一个标签：同样是 tag 的 root；有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */
+declare const XhSelectOverflowTag: 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 XhSelectPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger（data-scope="tag"），可及名使用 translations.deleteItem；点按移除所在标签的选中值。 */
+declare const XhSelectItemDeleteTrigger: 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 XhSelectPositioner: 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 XhSelectContent: 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>;
@@ -256,6 +258,28 @@ declare const XhSelectList: import("vue").DefineComponent<{}, () => VNode<import
 declare const XhSelectFooter: 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 XhSelectEmpty: 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 XhSelectLoading: 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 XhSelectGroup: 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 XhSelectGroupLabel: 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 XhSelectItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
@@ -286,5 +310,5 @@ declare const XhSelectItemIndicator: import("vue").DefineComponent<{}, () => VNo
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { SelectRootSlotProps, XhSelectClearTrigger, XhSelectContent, XhSelectControl, XhSelectFooter, XhSelectIndicator, XhSelectItem, XhSelectItemDeleteTrigger, XhSelectItemIndicator, XhSelectItemText, XhSelectLabel, XhSelectList, XhSelectPositioner, XhSelectRoot, XhSelectTag, XhSelectTrigger, XhSelectValueText };
+export { SelectRootSlotProps, XhSelectClearTrigger, XhSelectContent, XhSelectControl, XhSelectEmpty, XhSelectFooter, XhSelectGroup, XhSelectGroupLabel, XhSelectIndicator, XhSelectItem, XhSelectItemDeleteTrigger, XhSelectItemIndicator, XhSelectItemText, XhSelectLabel, XhSelectList, XhSelectLoading, XhSelectOverflowTag, XhSelectPositioner, XhSelectRoot, XhSelectTag, XhSelectTagLabel, XhSelectTagList, XhSelectTrigger, XhSelectValueText };
 //# sourceMappingURL=select.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","names":[],"sources":["../../../src/components/select/select.ts"],"mappings":";;;;KASK,cAAc;;KAGP,sBAAsB,KAChC;cAIW,4BAAY,8BAAA;;IAIQ,MAAA,SAAS;;;;;;;;;IAGJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYT,MAAA,SAAS;;;;;;;;;;;;IAGZ,MAAA,SAAS;;;;;;;;;;;;IAGf,MAAA,SAAS;;;;IACL,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAKN,iBAAA,UAAA;EACD,gBAAA,UAAA;EACD,iBAAA;EACF,gBAAA;;;IAjCM,MAAA,SAAS;;;;;;;;;IAGJ,MAAA;;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;IAYT,MAAA,SAAS;;;;;;;;;;;;IAGZ,MAAA,SAAS;;;;;;;;;;;;IAGf,MAAA,SAAS;;;;IACL,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWvB,WAAC,OAAO,wBAAwB;EAClC,cAAM;EACP,QAAC,MAAM,mBAAmB;kCAgDnC;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAc1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2BAAW,8BAAA;;;;;;;;;;;;;;MAWtB,oDAAA;cAEW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAc7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAY1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAOvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAQzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAoCvB;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"select.d.ts","names":[],"sources":["../../../src/components/select/select.ts"],"mappings":";;;;KAoBK,cAAc;;KAGP,sBAAsB,KAChC;cAIW,4BAAY,8BAAA;;IAIQ,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaT,MAAA,SAAS;;;;;;;;;IAGZ,MAAA,SAAS;;;;;;;;;;IAGf,MAAA,SAAS;;;IACL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAKN,iBAAA,UAAA;EACD,gBAAA,UAAA;EACD,iBAAA;EACF,gBAAA;;;IAlCM,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaT,MAAA,SAAS;;;;;;;;;IAGZ,MAAA,SAAS;;;;;;;;;;IAGf,MAAA,SAAS;;;IACL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;EAWvB,WAAC,OAAO,wBAAwB;EAClC,cAAM;EACP,QAAC,MAAM,mBAAmB;kCAiDnC;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAU1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAc1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAM3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAcW,2BAAW,8BAAA;;;;;;;;;;;;;;MAYtB,oDAAA;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAU9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAOpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,8BAAA;;;IAIE,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAY1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAUvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAQzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAQxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAO1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;MAYxB,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAoCvB;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}