@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/components/tag/tag.js

@@ -1,8 +1,16 @@
 import { withXhConfig } from "../../config/config.js";
+import { slotIsPlainText } from "../../runtime/slot-content.js";
 import { provideTag, useTagContext } from "./context.js";
 import { useTag } from "./use-tag.js";
 import { defineComponent, h } from "vue";
 //#region src/components/tag/tag.ts
+const XhTagLabel = defineComponent({
+	name: "XhTagLabel",
+	setup(_, { slots }) {
+		const ctx = useTagContext();
+		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
+	}
+});
 const XhTagRoot = defineComponent({
 	name: "XhTagRoot",
 	props: {
@@ -17,6 +25,10 @@ const XhTagRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		readOnly: {
+			type: Boolean,
+			default: void 0
+		},
 		open: {
 			type: Boolean,
 			default: void 0
@@ -38,14 +50,11 @@ const XhTagRoot = defineComponent({
 		};
 		const ctx = useTag(withXhConfig("tag", props), notify);
 		provideTag(ctx);
-		return () => h("span", ctx.api.value.getRootProps(), slots.default?.());
-	}
-});
-const XhTagLabel = defineComponent({
-	name: "XhTagLabel",
-	setup(_, { slots }) {
-		const ctx = useTagContext();
-		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
+		return () => {
+			const content = slots.default?.();
+			const children = slotIsPlainText(content) ? [h(XhTagLabel, null, () => content)] : content;
+			return h("span", ctx.api.value.getRootProps(), children);
+		};
 	}
 });
 const XhTagCloseTrigger = defineComponent({

package/dist/components/tag/tag.js.map

@@ -1 +1 @@
-{"version":3,"file":"tag.js","names":[],"sources":["../../../src/components/tag/tag.ts"],"sourcesContent":["import type { TagSchema, TagTranslations, TagVariant } from '@xihan-ui/headless'\nimport type { Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideTag, useTagContext } from './context'\nimport { useTag } from './use-tag'\n\ntype TagProps = TagSchema['props']\n\nexport const XhTagRoot = defineComponent({\n  name: 'XhTagRoot',\n  props: {\n    variant: String as PropType<TagVariant>,\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n    // 三态：不传即由 connect 决定缺省，传 false 才真的关掉\n    closable: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: { type: Boolean, default: undefined },\n    translations: Object as PropType<Partial<TagTranslations>>,\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<TagProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<TagProps, 'onOpenChange'>['open']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: TagProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useTag(withXhConfig('tag', props) as TagProps, notify)\n    provideTag(ctx)\n    // 标签随文排，根用 span 才能落在一行文字里\n    return () => h('span', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagLabel = defineComponent({\n  name: 'XhTagLabel',\n  setup(_, { slots }) {\n    const ctx = useTagContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagCloseTrigger = defineComponent({\n  name: 'XhTagCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagContext()\n    // 用原生 button，Enter/Space 的激活交给平台\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAWA,MAAa,YAAY,gBAAgB;CACvC,MAAM;CACN,OAAO;EACL,SAAS;EACT,MAAM;EACN,MAAM;EAEN,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACjD,cAAc;CAChB;CAEA,OAAO;EACL,gBAAgB,aAAkD;EAClE,gBAAgB,UAAuD;CACzE;CACA,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAoC,YAAY;GACpD,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,OAAO,aAAa,OAAO,KAAK,GAAe,MAAM;EACjE,WAAW,GAAG;EAEd,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAC1B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC"}
+{"version":3,"file":"tag.js","names":[],"sources":["../../../src/components/tag/tag.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// 提供 tag 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { TagSchema, TagTranslations, TagVariant } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { slotIsPlainText } from '../../runtime/slot-content'\nimport { provideTag, useTagContext } from './context'\nimport { useTag } from './use-tag'\n\ntype TagProps = TagSchema['props']\n\nexport const XhTagLabel = defineComponent({\n  name: 'XhTagLabel',\n  setup(_, { slots }) {\n    const ctx = useTagContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagRoot = defineComponent({\n  name: 'XhTagRoot',\n  props: {\n    variant: String as PropType<TagVariant>,\n    tone: String as PropType<Tone>,\n    size: String as PropType<Size>,\n    // 三态：不传即由 connect 决定缺省，传 false 才真的关掉\n    closable: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: { type: Boolean, default: undefined },\n    translations: Object as PropType<Partial<TagTranslations>>,\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<TagProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<TagProps, 'onOpenChange'>['open']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: TagProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useTag(withXhConfig('tag', props) as TagProps, notify)\n    provideTag(ctx)\n    // 标签随文排，根用 span 才能落在一行文字里\n    return () => {\n      const content = slots.default?.()\n      // 默认插槽里只有文字时替它包一层 label：截断规则挂在 label 上，\n      // 直接摊在 root 上的文字过长会把关闭钮挤出去。作者自己写了节点就原样放行\n      const children = slotIsPlainText(content) ? [h(XhTagLabel, null, () => content)] : content\n      return h('span', ctx.api.value.getRootProps() as Record<string, unknown>, children)\n    }\n  },\n})\n\nexport const XhTagCloseTrigger = defineComponent({\n  name: 'XhTagCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagContext()\n    // 用原生 button，Enter/Space 的激活交给平台\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAmBA,MAAa,aAAa,gBAAgB;CACxC,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAC1B,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,YAAY,gBAAgB;CACvC,MAAM;CACN,OAAO;EACL,SAAS;EACT,MAAM;EACN,MAAM;EAEN,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACjD,cAAc;CAChB;CAEA,OAAO;EACL,gBAAgB,aAAkD;EAClE,gBAAgB,UAAuD;CACzE;CACA,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAoC,YAAY;GACpD,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,OAAO,aAAa,OAAO,KAAK,GAAe,MAAM;EACjE,WAAW,GAAG;EAEd,aAAa;GACX,MAAM,UAAU,MAAM,UAAU;GAGhC,MAAM,WAAW,gBAAgB,OAAO,IAAI,CAAC,EAAE,YAAY,YAAY,OAAO,CAAC,IAAI;GACnF,OAAO,EAAE,QAAQ,IAAI,IAAI,MAAM,aAAa,GAA8B,QAAQ;EACpF;CACF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,cAAc;EAE1B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-tag.d.ts","names":[],"sources":["../../../src/components/tag/use-tag.ts"],"mappings":";;;UAOiB;EACf,KAAK,YAAY;;iBAIH,OACd,OAAO,oBACP,eAAe,qCACd"}
+{"version":3,"file":"use-tag.d.ts","names":[],"sources":["../../../src/components/tag/use-tag.ts"],"mappings":";;;UAciB;EACf,KAAK,YAAY;;iBAIH,OACd,OAAO,oBACP,eAAe,qCACd"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-tag.js","names":[],"sources":["../../../src/components/tag/use-tag.ts"],"sourcesContent":["import type { TagApi, TagSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectStaticTag, connectTag, tagMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface TagContext {\n  api: ComputedRef<TagApi>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useTag(\n  props: TagSchema['props'],\n  onOpenChange?: TagSchema['props']['onOpenChange'],\n): TagContext {\n  // 不给关闭钮的标签没有任何能改状态的事件，用不着机器：一台机器约 0.1ms，\n  // 表格一页几十行、每行几个状态药丸就是几百台，翻页时肉眼可见地卡一下。\n  // 判据取挂载那一刻的 closable——之后再打开也不要紧，快路的 setOpen 与关闭钮\n  // 走的是同一套受控/非受控语义，与机器路逐条一致。\n  if (!props.closable) {\n    // 非受控时展开态住这儿；受控时它不参与，值每次从 prop 现读\n    const local = ref(props.defaultOpen ?? true)\n    const api = computed(() => connectStaticTag(\n      { ...props, onOpenChange },\n      {\n        get: () => props.open ?? local.value,\n        set: (next) => { local.value = next },\n      },\n      vueNormalize,\n    ))\n    return { api }\n  }\n\n  const service = useMachine(tagMachine, () => ({ ...props, onOpenChange }))\n  const api = computed(() => connectTag(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAYA,SAAgB,OACd,OACA,cACY;CAKZ,IAAI,CAAC,MAAM,UAAU;EAEnB,MAAM,QAAQ,IAAI,MAAM,eAAe,IAAI;EAS3C,OAAO,EAAE,KARG,eAAe,iBACzB;GAAE,GAAG;GAAO;EAAa,GACzB;GACE,WAAW,MAAM,QAAQ,MAAM;GAC/B,MAAM,SAAS;IAAE,MAAM,QAAQ;GAAK;EACtC,GACA,YACF,CACW,EAAE;CACf;CAEA,MAAM,UAAU,WAAW,mBAAmB;EAAE,GAAG;EAAO;CAAa,EAAE;CAEzE,OAAO,EAAE,KADG,eAAe,WAAW,SAAS,YAAY,CAChD,EAAE;AACf"}
+{"version":3,"file":"use-tag.js","names":[],"sources":["../../../src/components/tag/use-tag.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 tag 相关实现。\n\nimport type { TagApi, TagSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectStaticTag, connectTag, tagMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface TagContext {\n  api: ComputedRef<TagApi>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useTag(\n  props: TagSchema['props'],\n  onOpenChange?: TagSchema['props']['onOpenChange'],\n): TagContext {\n  // 不给关闭钮的标签没有任何能改状态的事件，用不着机器：一台机器约 0.1ms，\n  // 表格一页几十行、每行几个状态药丸就是几百台，翻页时肉眼可见地卡一下。\n  // 判据取挂载那一刻的 closable——之后再打开也不要紧，快路的 setOpen 与关闭钮\n  // 走的是同一套受控/非受控语义，与机器路逐条一致。\n  if (!props.closable) {\n    // 非受控时展开态住这儿；受控时它不参与，值每次从 prop 现读\n    const local = ref(props.defaultOpen ?? true)\n    const api = computed(() => connectStaticTag(\n      { ...props, onOpenChange },\n      {\n        get: () => props.open ?? local.value,\n        set: (next) => { local.value = next },\n      },\n      vueNormalize,\n    ))\n    return { api }\n  }\n\n  const service = useMachine(tagMachine, () => ({ ...props, onOpenChange }))\n  const api = computed(() => connectTag(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAmBA,SAAgB,OACd,OACA,cACY;CAKZ,IAAI,CAAC,MAAM,UAAU;EAEnB,MAAM,QAAQ,IAAI,MAAM,eAAe,IAAI;EAS3C,OAAO,EAAE,KARG,eAAe,iBACzB;GAAE,GAAG;GAAO;EAAa,GACzB;GACE,WAAW,MAAM,QAAQ,MAAM;GAC/B,MAAM,SAAS;IAAE,MAAM,QAAQ;GAAK;EACtC,GACA,YACF,CACW,EAAE;CACf;CAEA,MAAM,UAAU,WAAW,mBAAmB;EAAE,GAAG;EAAO;CAAa,EAAE;CAEzE,OAAO,EAAE,KADG,eAAe,WAAW,SAAS,YAAY,CAChD,EAAE;AACf"}

package/dist/components/tag-group/context.d.ts

@@ -0,0 +1,13 @@
+import { TagGroupContext } from "./use-tag-group.js";
+import { ComputedRef } from "vue";
+import { TagGroupItemProps } from "@xihan-ui/headless";
+//#region src/components/tag-group/context.d.ts
+/** 条目声明的值、禁用与可移除，供 cell / item-text / item-delete-trigger 复用同一份声明。 */
+interface TagGroupItemContext {
+  item: ComputedRef<TagGroupItemProps>;
+}
+declare function useTagGroupContext(): TagGroupContext;
+declare function useTagGroupItemContext(): TagGroupItemContext;
+//#endregion
+export { TagGroupItemContext, useTagGroupContext, useTagGroupItemContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/tag-group/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/tag-group/context.ts"],"mappings":";;;;;UAaiB;EACf,MAAM,YAAY;;iBAUJ,sBAAsB;iBAWtB,0BAA0B"}

package/dist/components/tag-group/context.js

@@ -0,0 +1,24 @@
+import { inject, provide } from "vue";
+//#region src/components/tag-group/context.ts
+const KEY = Symbol.for("xh-tag-group");
+const ITEM_KEY = Symbol.for("xh-tag-group-item");
+function provideTagGroup(ctx) {
+	provide(KEY, ctx);
+}
+function useTagGroupContext() {
+	const ctx = inject(KEY, null);
+	if (!ctx) throw new Error("[xh] TagGroup 部件必须用在 XhTagGroupRoot 内");
+	return ctx;
+}
+function provideTagGroupItem(ctx) {
+	provide(ITEM_KEY, ctx);
+}
+function useTagGroupItemContext() {
+	const ctx = inject(ITEM_KEY, null);
+	if (!ctx) throw new Error("[xh] TagGroup 条目子部件必须用在 XhTagGroupItem 内");
+	return ctx;
+}
+//#endregion
+export { provideTagGroup, provideTagGroupItem, useTagGroupContext, useTagGroupItemContext };
+
+//# sourceMappingURL=context.js.map

package/dist/components/tag-group/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tag-group/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 { TagGroupItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { TagGroupContext } from './use-tag-group'\nimport { inject, provide } from 'vue'\n\n/** 条目声明的值、禁用与可移除，供 cell / item-text / item-delete-trigger 复用同一份声明。 */\nexport interface TagGroupItemContext {\n  item: ComputedRef<TagGroupItemProps>\n}\n\nconst KEY: InjectionKey<TagGroupContext> = Symbol.for('xh-tag-group')\nconst ITEM_KEY: InjectionKey<TagGroupItemContext> = Symbol.for('xh-tag-group-item')\n\nexport function provideTagGroup(ctx: TagGroupContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTagGroupContext(): TagGroupContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TagGroup 部件必须用在 XhTagGroupRoot 内')\n  return ctx\n}\n\nexport function provideTagGroupItem(ctx: TagGroupItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useTagGroupItemContext(): TagGroupItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TagGroup 条目子部件必须用在 XhTagGroupItem 内')\n  return ctx\n}\n"],"mappings":";;AAiBA,MAAM,MAAqC,OAAO,IAAI,cAAc;AACpE,MAAM,WAA8C,OAAO,IAAI,mBAAmB;AAElF,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT;AAEA,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,0CAA0C;CAC5D,OAAO;AACT"}

package/dist/components/tag-group/tag-group.d.ts

@@ -0,0 +1,190 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, SlotsType, VNode } from "vue";
+import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
+import { TagGroupApi, TagGroupNode, TagGroupNodeMeta, TagGroupSchema, TagGroupSelectionMode, TagGroupTranslations, TagVariant } from "@xihan-ui/headless";
+//#region src/components/tag-group/tag-group.d.ts
+type TagGroupProps = TagGroupSchema['props'];
+/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换、移除的命令。 */
+type TagGroupRootSlotProps = Pick<TagGroupApi, 'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle' | 'deleteItem'>;
+declare const XhTagGroupRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  collection: {
+    type: PropType<TagGroupNode[]>;
+  };
+  /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  value: {
+    type: PropType<string | string[]>;
+  };
+  defaultValue: {
+    type: PropType<string | string[]>;
+  };
+  selectionMode: {
+    type: PropType<TagGroupSelectionMode>;
+  };
+  deletable: BooleanConstructor;
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  loop: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  dir: {
+    type: PropType<Direction>;
+  };
+  orientation: {
+    type: PropType<Orientation>;
+  };
+  typeahead: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  variant: {
+    type: PropType<TagVariant>;
+  };
+  tone: {
+    type: PropType<Tone>;
+  };
+  size: {
+    type: PropType<Size>;
+  };
+  translations: {
+    type: PropType<Partial<TagGroupTranslations>>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'value-change': (_details: PayloadOf<TagGroupProps, "onValueChange">) => true;
+  'update:value': (_value: PayloadOf<TagGroupProps, "onValueChange">["value"]) => true;
+  'item-delete': (_details: PayloadOf<TagGroupProps, "onItemDelete">) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  collection: {
+    type: PropType<TagGroupNode[]>;
+  };
+  /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  value: {
+    type: PropType<string | string[]>;
+  };
+  defaultValue: {
+    type: PropType<string | string[]>;
+  };
+  selectionMode: {
+    type: PropType<TagGroupSelectionMode>;
+  };
+  deletable: BooleanConstructor;
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  readOnly: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  loop: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  dir: {
+    type: PropType<Direction>;
+  };
+  orientation: {
+    type: PropType<Orientation>;
+  };
+  typeahead: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  variant: {
+    type: PropType<TagVariant>;
+  };
+  tone: {
+    type: PropType<Tone>;
+  };
+  size: {
+    type: PropType<Size>;
+  };
+  translations: {
+    type: PropType<Partial<TagGroupTranslations>>;
+  };
+}>> & Readonly<{
+  "onValue-change"?: ((_details: import("@xihan-ui/headless").TagGroupValueChangeDetails) => any) | undefined;
+  "onUpdate:value"?: ((_value: string[]) => any) | undefined;
+  "onItem-delete"?: ((_details: import("@xihan-ui/headless").TagGroupItemDeleteDetails) => any) | undefined;
+}>, {
+  loop: boolean;
+  disabled: boolean;
+  readOnly: boolean;
+  typeahead: boolean;
+  deletable: boolean;
+}, SlotsType<{
+  default?: (props: TagGroupRootSlotProps) => VNode[];
+  label?: () => VNode[];
+  item?: (node: TagGroupNodeMeta) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhTagGroupLabel: 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 XhTagGroupList: 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"），组把行角色、Tab 停靠点、选中与锚点叠加在它上面。 */
+declare const XhTagGroupItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  deletable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+}>, () => 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;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  deletable: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+}>> & Readonly<{}>, {
+  disabled: boolean;
+  deletable: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhTagGroupCell: 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 XhTagGroupItemIndicator: 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 XhTagGroupItemText: 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 的 close-trigger，不占 Tab 位；整组未开放移除时收起。 */
+declare const XhTagGroupItemDeleteTrigger: 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 { TagGroupRootSlotProps, XhTagGroupCell, XhTagGroupItem, XhTagGroupItemDeleteTrigger, XhTagGroupItemIndicator, XhTagGroupItemText, XhTagGroupLabel, XhTagGroupList, XhTagGroupRoot };
+//# sourceMappingURL=tag-group.d.ts.map

package/dist/components/tag-group/tag-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-group.d.ts","names":[],"sources":["../../../src/components/tag-group/tag-group.ts"],"mappings":";;;;;KAiBK,gBAAgB;;KAGT,wBAAwB,KAClC;cAIW,8BAAc,8BAAA;;IAIM,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKnB,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;IAEb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAKtB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACT,gBAAA,UAAA,UAAU;;;IAvBP,MAAA,SAAS;;;;;;;IAGJ,MAAA;;;IACO,MAAA;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;IAKnB,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;IAEb,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;EAUvC,WAAC,OAAO,0BAA0B;EACpC,cAAM;EACP,QAAC,MAAM,qBAAqB;kCAiCrC;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAyCzB;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAOzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/tag-group/tag-group.js

@@ -0,0 +1,180 @@
+import { withXhConfig } from "../../config/config.js";
+import { useFormControlProps } from "../form/use-form-control.js";
+import { provideTagGroup, provideTagGroupItem, useTagGroupContext, useTagGroupItemContext } from "./context.js";
+import { useTagGroup } from "./use-tag-group.js";
+import { computed, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
+//#region src/components/tag-group/tag-group.ts
+const XhTagGroupRoot = defineComponent({
+	name: "XhTagGroupRoot",
+	props: {
+		collection: { type: Array },
+		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		value: { type: [String, Array] },
+		defaultValue: { type: [String, Array] },
+		selectionMode: { type: String },
+		deletable: Boolean,
+		disabled: {
+			type: Boolean,
+			default: void 0
+		},
+		readOnly: {
+			type: Boolean,
+			default: void 0
+		},
+		loop: {
+			type: Boolean,
+			default: void 0
+		},
+		dir: { type: String },
+		orientation: { type: String },
+		typeahead: {
+			type: Boolean,
+			default: void 0
+		},
+		variant: { type: String },
+		tone: { type: String },
+		size: { type: String },
+		translations: { type: Object }
+	},
+	emits: {
+		"value-change": (_details) => true,
+		"update:value": (_value) => true,
+		"item-delete": (_details) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const notify = (details) => {
+			emit("value-change", details);
+			emit("update:value", details.value);
+		};
+		const notifyDelete = (details) => {
+			emit("item-delete", details);
+		};
+		const ctx = useTagGroup(withXhConfig("tag-group", useFormControlProps(props)), notify, notifyDelete);
+		provideTagGroup(ctx);
+		return () => h("div", ctx.api.value.getRootProps(), [...slots.default ? slots.default({
+			value: ctx.api.value.value,
+			selectionMode: ctx.api.value.selectionMode,
+			focusedValue: ctx.api.value.focusedValue,
+			isSelected: ctx.api.value.isSelected,
+			setValue: ctx.api.value.setValue,
+			select: ctx.api.value.select,
+			toggle: ctx.api.value.toggle,
+			deleteItem: ctx.api.value.deleteItem
+		}) ?? [] : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.item) : []]);
+	}
+});
+const XhTagGroupLabel = defineComponent({
+	name: "XhTagGroupLabel",
+	setup(_, { slots }) {
+		const ctx = useTagGroupContext();
+		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
+	}
+});
+const XhTagGroupList = defineComponent({
+	name: "XhTagGroupList",
+	setup(_, { slots }) {
+		const ctx = useTagGroupContext();
+		return () => h("div", ctx.api.value.getListProps(), slots.default?.());
+	}
+});
+/** 一个标签：渲染为 tag 的 root（data-scope="tag"），组把行角色、Tab 停靠点、选中与锚点叠加在它上面。 */
+const XhTagGroupItem = defineComponent({
+	name: "XhTagGroupItem",
+	props: {
+		value: {
+			type: String,
+			required: true
+		},
+		disabled: {
+			type: Boolean,
+			default: void 0
+		},
+		deletable: {
+			type: Boolean,
+			default: void 0
+		}
+	},
+	setup(props, { slots }) {
+		const ctx = useTagGroupContext();
+		const item = computed(() => ({
+			value: props.value,
+			disabled: props.disabled,
+			deletable: props.deletable
+		}));
+		provideTagGroupItem({ item });
+		const itemEl = ref(null);
+		watch(() => props.value, (next, prev) => {
+			if (next === prev) return;
+			const { service } = ctx;
+			if (service.getStatus() !== "Started") return;
+			if (itemEl.value && service.scope.getActiveElement() === itemEl.value) service.send({
+				type: "ITEM.FOCUS",
+				value: next
+			});
+		});
+		onBeforeUnmount(() => {
+			const { service } = ctx;
+			if (service.getStatus() !== "Started") return;
+			if (itemEl.value && service.scope.getActiveElement() === itemEl.value) service.send({ type: "LIST.BLUR" });
+		});
+		return () => h("span", {
+			...ctx.api.value.getItemProps(item.value),
+			ref: itemEl
+		}, slots.default?.());
+	}
+});
+const XhTagGroupCell = defineComponent({
+	name: "XhTagGroupCell",
+	setup(_, { slots }) {
+		const ctx = useTagGroupContext();
+		const { item } = useTagGroupItemContext();
+		return () => h("span", ctx.api.value.getCellProps(item.value), slots.default?.());
+	}
+});
+/** 选中标记：落在格子内、文字之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */
+const XhTagGroupItemIndicator = defineComponent({
+	name: "XhTagGroupItemIndicator",
+	setup(_, { slots }) {
+		const ctx = useTagGroupContext();
+		const { item } = useTagGroupItemContext();
+		return () => h("span", ctx.api.value.getItemIndicatorProps(item.value), slots.default?.());
+	}
+});
+/** 标签文字：渲染为 tag 的 label。 */
+const XhTagGroupItemText = defineComponent({
+	name: "XhTagGroupItemText",
+	setup(_, { slots }) {
+		const ctx = useTagGroupContext();
+		const { item } = useTagGroupItemContext();
+		return () => h("span", ctx.api.value.getItemTextProps(item.value), slots.default?.());
+	}
+});
+/** 移除按钮：渲染为所在标签那份 tag 的 close-trigger，不占 Tab 位；整组未开放移除时收起。 */
+const XhTagGroupItemDeleteTrigger = defineComponent({
+	name: "XhTagGroupItemDeleteTrigger",
+	setup(_, { slots }) {
+		const ctx = useTagGroupContext();
+		const { item } = useTagGroupItemContext();
+		return () => h("button", ctx.api.value.getItemDeleteTriggerProps(item.value), slots.default?.());
+	}
+});
+/**
+* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
+* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽。
+*/
+function renderDefaultTree(collection, label, itemSlot) {
+	return [...label ? [h(XhTagGroupLabel, null, () => label)] : [], h(XhTagGroupList, null, () => collection.map((node) => h(XhTagGroupItem, {
+		key: node.value,
+		value: node.value
+	}, () => [h(XhTagGroupCell, null, () => [
+		h(XhTagGroupItemIndicator),
+		h(XhTagGroupItemText, null, () => itemSlot?.(node) ?? node.label),
+		h(XhTagGroupItemDeleteTrigger)
+	])])))];
+}
+//#endregion
+export { XhTagGroupCell, XhTagGroupItem, XhTagGroupItemDeleteTrigger, XhTagGroupItemIndicator, XhTagGroupItemText, XhTagGroupLabel, XhTagGroupList, XhTagGroupRoot };
+
+//# sourceMappingURL=tag-group.js.map

package/dist/components/tag-group/tag-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-group.js","names":[],"sources":["../../../src/components/tag-group/tag-group.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// 提供 tag group 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { TagGroupApi, TagGroupItemProps, TagGroupNode, TagGroupNodeMeta, TagGroupSchema, TagGroupSelectionMode, TagGroupTranslations, TagVariant } 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 { withXhConfig } from '../../config/config'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideTagGroup, provideTagGroupItem, useTagGroupContext, useTagGroupItemContext } from './context'\nimport { useTagGroup } from './use-tag-group'\n\ntype TagGroupProps = TagGroupSchema['props']\n\n/** 默认插槽的载荷：选中集合、选择模式与焦点锚点，以及判定选中与整份赋值、单选、切换、移除的命令。 */\nexport type TagGroupRootSlotProps = Pick<\n  TagGroupApi,\n  'value' | 'selectionMode' | 'focusedValue' | 'isSelected' | 'setValue' | 'select' | 'toggle' | 'deleteItem'\n>\n\nexport const XhTagGroupRoot = defineComponent({\n  name: 'XhTagGroupRoot',\n  // 有 connect 兜底的 prop：普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<TagGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    selectionMode: { type: String as PropType<TagGroupSelectionMode> },\n    deletable: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    loop: { type: Boolean, default: undefined },\n    dir: { type: String as PropType<Direction> },\n    orientation: { type: String as PropType<Orientation> },\n    typeahead: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<TagVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<TagGroupTranslations>> },\n  },\n  // value-change 携带 { value }，update:value 携带裸集合；回传值恒为数组，单选时长度 ≤ 1。\n  // item-delete 只报「用户要摘这一枚」，条目的去留由宿主改自己的数据\n  emits: {\n    'value-change': (_details: PayloadOf<TagGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<TagGroupProps, 'onValueChange'>['value']) => true,\n    'item-delete': (_details: PayloadOf<TagGroupProps, 'onItemDelete'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: TagGroupRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (node: TagGroupNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: TagGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyDelete: TagGroupProps['onItemDelete'] = (details) => {\n      emit('item-delete', details)\n    }\n    const ctx = useTagGroup(withXhConfig('tag-group', useFormControlProps(props)) as TagGroupProps, notify, notifyDelete)\n    provideTagGroup(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, [\n      ...(slots.default\n        ? slots.default({\n          value: ctx.api.value.value,\n          selectionMode: ctx.api.value.selectionMode,\n          focusedValue: ctx.api.value.focusedValue,\n          isSelected: ctx.api.value.isSelected,\n          setValue: ctx.api.value.setValue,\n          select: ctx.api.value.select,\n          toggle: ctx.api.value.toggle,\n          deleteItem: ctx.api.value.deleteItem,\n        }) ?? []\n        : props.collection\n          ? renderDefaultTree(\n              ctx.api.value.collection,\n              slots.label?.() ?? (props.label != null ? [props.label] : null),\n              slots.item,\n            )\n          : []),\n    ])\n  },\n})\n\nexport const XhTagGroupLabel = defineComponent({\n  name: 'XhTagGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhTagGroupList = defineComponent({\n  name: 'XhTagGroupList',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    return () => h('div', ctx.api.value.getListProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 一个标签：渲染为 tag 的 root（data-scope=\"tag\"），组把行角色、Tab 停靠点、选中与锚点叠加在它上面。 */\nexport const XhTagGroupItem = defineComponent({\n  name: 'XhTagGroupItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的声明\n    disabled: { type: Boolean, default: undefined },\n    deletable: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useTagGroupContext()\n    const item = computed<TagGroupItemProps>(() => ({\n      value: props.value,\n      disabled: props.disabled,\n      deletable: props.deletable,\n    }))\n    provideTagGroupItem({ 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: 'LIST.BLUR' })\n    })\n    return () => h(\n      'span',\n      { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhTagGroupCell = defineComponent({\n  name: 'XhTagGroupCell',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getCellProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 选中标记：落在格子内、文字之前，选中时展示、未选中时收起；内容留空时由皮肤绘制对号。 */\nexport const XhTagGroupItemIndicator = defineComponent({\n  name: 'XhTagGroupItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签文字：渲染为 tag 的 label。 */\nexport const XhTagGroupItemText = defineComponent({\n  name: 'XhTagGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 移除按钮：渲染为所在标签那份 tag 的 close-trigger，不占 Tab 位；整组未开放移除时收起。 */\nexport const XhTagGroupItemDeleteTrigger = defineComponent({\n  name: 'XhTagGroupItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useTagGroupContext()\n    const { item } = useTagGroupItemContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly TagGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: TagGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhTagGroupLabel, null, () => label)] : []),\n    h(XhTagGroupList, null, () => collection.map(node =>\n      h(XhTagGroupItem, { key: node.value, value: node.value }, () => [\n        h(XhTagGroupCell, null, () => [\n          h(XhTagGroupItemIndicator),\n          h(XhTagGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n          h(XhTagGroupItemDeleteTrigger),\n        ]),\n      ]),\n    )),\n  ]\n}\n"],"mappings":"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"}

package/dist/components/tag-group/use-tag-group.d.ts

@@ -0,0 +1,13 @@
+import { ComputedRef } from "vue";
+import { Service } from "@xihan-ui/core";
+import { TagGroupApi, TagGroupSchema } from "@xihan-ui/headless";
+//#region src/components/tag-group/use-tag-group.d.ts
+interface TagGroupContext {
+  api: ComputedRef<TagGroupApi>;
+  /** 状态机实例，供部件上报 DOM 侧的事实（如标签卸载带走了焦点）。 */
+  service: Service<TagGroupSchema>;
+}
+declare function useTagGroup(props: TagGroupSchema['props'], onValueChange?: TagGroupSchema['props']['onValueChange'], onItemDelete?: TagGroupSchema['props']['onItemDelete']): TagGroupContext;
+//#endregion
+export { TagGroupContext, useTagGroup };
+//# sourceMappingURL=use-tag-group.d.ts.map

package/dist/components/tag-group/use-tag-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tag-group.d.ts","names":[],"sources":["../../../src/components/tag-group/use-tag-group.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,YACd,OAAO,yBACP,gBAAgB,0CAChB,eAAe,0CACd"}

package/dist/components/tag-group/use-tag-group.js

@@ -0,0 +1,22 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { computed } from "vue";
+import { createScope } from "@xihan-ui/core";
+import { connectTagGroup, tagGroupMachine } from "@xihan-ui/headless";
+//#region src/components/tag-group/use-tag-group.ts
+function useTagGroup(props, onValueChange, onItemDelete) {
+	const service = useMachine(tagGroupMachine, () => ({
+		...props,
+		onValueChange,
+		onItemDelete
+	}), createScope(null, createVueIdGenerator()));
+	return {
+		api: computed(() => connectTagGroup(service, vueNormalize)),
+		service
+	};
+}
+//#endregion
+export { useTagGroup };
+
+//# sourceMappingURL=use-tag-group.js.map

package/dist/components/tag-group/use-tag-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tag-group.js","names":[],"sources":["../../../src/components/tag-group/use-tag-group.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 tag group 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { TagGroupApi, TagGroupSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTagGroup, tagGroupMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface TagGroupContext {\n  api: ComputedRef<TagGroupApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如标签卸载带走了焦点）。 */\n  service: Service<TagGroupSchema>\n}\n\nexport function useTagGroup(\n  props: TagGroupSchema['props'],\n  onValueChange?: TagGroupSchema['props']['onValueChange'],\n  onItemDelete?: TagGroupSchema['props']['onItemDelete'],\n): TagGroupContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // 连打检索缓冲存在机器的 refs 里，适配器不必注入 refs\n  const service = useMachine(tagGroupMachine, () => ({ ...props, onValueChange, onItemDelete }), scope)\n  const api = computed(() => connectTagGroup(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAuBA,SAAgB,YACd,OACA,eACA,cACiB;CAIjB,MAAM,UAAU,WAAW,wBAAwB;EAAE,GAAG;EAAO;EAAe;CAAa,IAF7E,YAAY,MADZ,qBACsB,CAE+D,CAAC;CAEpG,OAAO;EAAE,KADG,eAAe,gBAAgB,SAAS,YAAY,CACrD;EAAG;CAAQ;AACxB"}

package/dist/components/tags-input/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tags-input/context.ts"],"sourcesContent":["import type { TagsInputItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { TagsInputContext } from './use-tags-input'\nimport { inject, provide } from 'vue'\n\n/** 标签自报的值，供 item-preview / item-text / 删除按钮 / 编辑框复用同一份声明。 */\nexport interface TagsInputItemContext {\n  item: ComputedRef<TagsInputItemProps>\n}\n\nconst KEY: InjectionKey<TagsInputContext> = Symbol.for('xh-tags-input')\nconst ITEM_KEY: InjectionKey<TagsInputItemContext> = Symbol.for('xh-tags-input-item')\n\nexport function provideTagsInput(ctx: TagsInputContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTagsInputContext(): TagsInputContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TagsInput 部件必须用在 XhTagsInputRoot 内')\n  return ctx\n}\n\nexport function provideTagsInputItem(ctx: TagsInputItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useTagsInputItemContext(): TagsInputItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TagsInput 标签子部件必须用在 XhTagsInputItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAsC,OAAO,IAAI,eAAe;AACtE,MAAM,WAA+C,OAAO,IAAI,oBAAoB;AAEpF,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,4CAA4C;CAC9D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tags-input/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 { TagsInputItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { TagsInputContext } from './use-tags-input'\nimport { inject, provide } from 'vue'\n\n/** 标签声明的值，供预览（tag 的 root）/ 文字（tag 的 label）/ 删除按钮（tag 的 close-trigger）/ 编辑框复用同一份声明。 */\nexport interface TagsInputItemContext {\n  item: ComputedRef<TagsInputItemProps>\n}\n\nconst KEY: InjectionKey<TagsInputContext> = Symbol.for('xh-tags-input')\nconst ITEM_KEY: InjectionKey<TagsInputItemContext> = Symbol.for('xh-tags-input-item')\n\nexport function provideTagsInput(ctx: TagsInputContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTagsInputContext(): TagsInputContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TagsInput 部件必须用在 XhTagsInputRoot 内')\n  return ctx\n}\n\nexport function provideTagsInputItem(ctx: TagsInputItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useTagsInputItemContext(): TagsInputItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] TagsInput 标签子部件必须用在 XhTagsInputItem 内')\n  return ctx\n}\n"],"mappings":";;AAiBA,MAAM,MAAsC,OAAO,IAAI,eAAe;AACtE,MAAM,WAA+C,OAAO,IAAI,oBAAoB;AAEpF,SAAgB,iBAAiB,KAA6B;CAC5D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,sBAAwC;CACtD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,yCAAyC;CAC3D,OAAO;AACT;AAEA,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,4CAA4C;CAC9D,OAAO;AACT"}