@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/timestamp/timestamp.d.ts

@@ -1,11 +1,12 @@
 import { PropType } from "vue";
-import { TimestampType, TimestampValue } from "@xihan-ui/headless";
+import { TimestampTranslations, TimestampType, TimestampValue } from "@xihan-ui/headless";
 //#region src/components/timestamp/timestamp.d.ts
 /**
  * 渲染为 `<time datetime>`：文本供人阅读，datetime 供机器读取，两者取自同一个墙钟。
  *
  * 默认插槽中写了内容时使用作者的文本，datetime 仍由组件计算：这正是用它包裹一段
  * 自行排版的时间表述的用法。插槽为空时铺设组件格式化后的文本。
+ * 相对型在没给 now 时按距今远近自动刷新，刷新节奏由状态机掌握。
  */
 declare const XhTimestamp: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
@@ -20,9 +21,18 @@ declare const XhTimestamp: import("vue").DefineComponent<import("vue").ExtractPr
   locale: {
     type: StringConstructor;
   };
+  timeZone: {
+    type: StringConstructor;
+  };
   now: {
     type: PropType<TimestampValue>;
   };
+  refreshInterval: {
+    type: NumberConstructor;
+  };
+  translations: {
+    type: PropType<Partial<TimestampTranslations>>;
+  };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -38,9 +48,18 @@ declare const XhTimestamp: import("vue").DefineComponent<import("vue").ExtractPr
   locale: {
     type: StringConstructor;
   };
+  timeZone: {
+    type: StringConstructor;
+  };
   now: {
     type: PropType<TimestampValue>;
   };
+  refreshInterval: {
+    type: NumberConstructor;
+  };
+  translations: {
+    type: PropType<Partial<TimestampTranslations>>;
+  };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
 export { XhTimestamp };

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

@@ -1 +1 @@
-{"version":3,"file":"timestamp.d.ts","names":[],"sources":["../../../src/components/timestamp/timestamp.ts"],"mappings":";;;;;;;;;cAqBa,2BAAW,8BAAA;;IAIqB,MAAA,SAAS;;;IAC1B,MAAA,SAAS;;;;;;;;;IAGM,MAAA,SAAS;;;;;;IAJP,MAAA,SAAS;;;IAC1B,MAAA,SAAS;;;;;;;;;IAGM,MAAA,SAAS;;MAsBlD,oDAAA"}
+{"version":3,"file":"timestamp.d.ts","names":[],"sources":["../../../src/components/timestamp/timestamp.ts"],"mappings":";;;;;;;;;;cAyBa,2BAAW,8BAAA;;IAIqB,MAAA,SAAS;;;IAC1B,MAAA,SAAS;;;;;;;;;;;;IAIM,MAAA,SAAS;;;;;;IAEhB,MAAA,SAAS,QAAQ;;;;;;IAPR,MAAA,SAAS;;;IAC1B,MAAA,SAAS;;;;;;;;;;;;IAIM,MAAA,SAAS;;;;;;IAEhB,MAAA,SAAS,QAAQ;;MA0BnD,oDAAA"}

package/dist/components/timestamp/timestamp.js

@@ -1,14 +1,18 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { computed, defineComponent, h } from "vue";
-import { connectTimestamp } from "@xihan-ui/headless";
+import { createScope } from "@xihan-ui/core";
+import { connectTimestamp, timestampMachine } from "@xihan-ui/headless";
 //#region src/components/timestamp/timestamp.ts
 /**
 * 渲染为 `<time datetime>`：文本供人阅读，datetime 供机器读取，两者取自同一个墙钟。
 *
 * 默认插槽中写了内容时使用作者的文本，datetime 仍由组件计算：这正是用它包裹一段
 * 自行排版的时间表述的用法。插槽为空时铺设组件格式化后的文本。
+* 相对型在没给 now 时按距今远近自动刷新，刷新节奏由状态机掌握。
 */
 const XhTimestamp = defineComponent({
 	name: "XhTimestamp",
@@ -21,21 +25,28 @@ const XhTimestamp = defineComponent({
 		type: { type: String },
 		format: { type: String },
 		locale: { type: String },
+		timeZone: { type: String },
 		now: { type: [
 			String,
 			Number,
 			Date
-		] }
+		] },
+		refreshInterval: { type: Number },
+		translations: { type: Object }
 	},
 	setup(props, { slots }) {
 		const merged = withXhConfig("timestamp", props);
-		const api = computed(() => connectTimestamp({
+		const service = useMachine(timestampMachine, () => ({
 			value: merged.value,
 			type: merged.type,
 			format: merged.format,
 			locale: merged.locale,
-			now: merged.now
-		}, vueNormalize));
+			timeZone: merged.timeZone,
+			now: merged.now,
+			refreshInterval: merged.refreshInterval,
+			translations: merged.translations
+		}), createScope(null, createVueIdGenerator()));
+		const api = computed(() => connectTimestamp(service, vueNormalize));
 		return () => {
 			const content = slots.default?.();
 			return h("time", api.value.getRootProps(), slotPaints(content) ? content : api.value.text);

package/dist/components/timestamp/timestamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"timestamp.js","names":[],"sources":["../../../src/components/timestamp/timestamp.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// 提供 timestamp 相关实现。\n\nimport type { TimestampProps, TimestampType, TimestampValue } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectTimestamp } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\n\n/**\n * 渲染为 `<time datetime>`：文本供人阅读，datetime 供机器读取，两者取自同一个墙钟。\n *\n * 默认插槽中写了内容时使用作者的文本，datetime 仍由组件计算：这正是用它包裹一段\n * 自行排版的时间表述的用法。插槽为空时铺设组件格式化后的文本。\n */\nexport const XhTimestamp = defineComponent({\n  name: 'XhTimestamp',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: [String, Number, Date] as PropType<TimestampValue> },\n    type: { type: String as PropType<TimestampType> },\n    format: { type: String },\n    locale: { type: String },\n    now: { type: [String, Number, Date] as PropType<TimestampValue> },\n  },\n  setup(props, { slots }) {\n    const merged = withXhConfig('timestamp', props)\n    const api = computed(() => connectTimestamp({\n      value: merged.value,\n      type: merged.type,\n      format: merged.format,\n      locale: merged.locale,\n      now: merged.now,\n    } satisfies TimestampProps, vueNormalize))\n\n    return () => {\n      const content = slots.default?.()\n      return h(\n        'time',\n        api.value.getRootProps() as Record<string, unknown>,\n        // 插槽里只剩注释或空白时不算写过东西，那种情况仍铺组件的文本\n        slotPaints(content) ? content : api.value.text,\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM;GAAC;GAAQ;GAAQ;EAAI,EAA8B;EAClE,MAAM,EAAE,MAAM,OAAkC;EAChD,QAAQ,EAAE,MAAM,OAAO;EACvB,QAAQ,EAAE,MAAM,OAAO;EACvB,KAAK,EAAE,MAAM;GAAC;GAAQ;GAAQ;EAAI,EAA8B;CAClE;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,SAAS,aAAa,aAAa,KAAK;EAC9C,MAAM,MAAM,eAAe,iBAAiB;GAC1C,OAAO,OAAO;GACd,MAAM,OAAO;GACb,QAAQ,OAAO;GACf,QAAQ,OAAO;GACf,KAAK,OAAO;EACd,GAA4B,YAAY,CAAC;EAEzC,aAAa;GACX,MAAM,UAAU,MAAM,UAAU;GAChC,OAAO,EACL,QACA,IAAI,MAAM,aAAa,GAEvB,WAAW,OAAO,IAAI,UAAU,IAAI,MAAM,IAC5C;EACF;CACF;AACF,CAAC"}
+{"version":3,"file":"timestamp.js","names":[],"sources":["../../../src/components/timestamp/timestamp.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// 提供 timestamp 相关实现。\n\nimport type { TimestampTranslations, TimestampType, TimestampValue } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectTimestamp, timestampMachine } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\n/**\n * 渲染为 `<time datetime>`：文本供人阅读，datetime 供机器读取，两者取自同一个墙钟。\n *\n * 默认插槽中写了内容时使用作者的文本，datetime 仍由组件计算：这正是用它包裹一段\n * 自行排版的时间表述的用法。插槽为空时铺设组件格式化后的文本。\n * 相对型在没给 now 时按距今远近自动刷新，刷新节奏由状态机掌握。\n */\nexport const XhTimestamp = defineComponent({\n  name: 'XhTimestamp',\n  // 缺省值由机器与 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    value: { type: [String, Number, Date] as PropType<TimestampValue> },\n    type: { type: String as PropType<TimestampType> },\n    format: { type: String },\n    locale: { type: String },\n    timeZone: { type: String },\n    now: { type: [String, Number, Date] as PropType<TimestampValue> },\n    refreshInterval: { type: Number },\n    translations: { type: Object as PropType<Partial<TimestampTranslations>> },\n  },\n  setup(props, { slots }) {\n    const merged = withXhConfig('timestamp', props)\n    const service = useMachine(timestampMachine, () => ({\n      value: merged.value,\n      type: merged.type,\n      format: merged.format,\n      locale: merged.locale,\n      timeZone: merged.timeZone,\n      now: merged.now,\n      refreshInterval: merged.refreshInterval,\n      translations: merged.translations,\n    }), createScope(null, createVueIdGenerator()))\n    const api = computed(() => connectTimestamp(service, vueNormalize))\n\n    return () => {\n      const content = slots.default?.()\n      return h(\n        'time',\n        api.value.getRootProps() as Record<string, unknown>,\n        // 插槽里只剩注释或空白时不算写过东西，那种情况仍铺组件的文本\n        slotPaints(content) ? content : api.value.text,\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;;;;;AAyBA,MAAa,cAAc,gBAAgB;CACzC,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM;GAAC;GAAQ;GAAQ;EAAI,EAA8B;EAClE,MAAM,EAAE,MAAM,OAAkC;EAChD,QAAQ,EAAE,MAAM,OAAO;EACvB,QAAQ,EAAE,MAAM,OAAO;EACvB,UAAU,EAAE,MAAM,OAAO;EACzB,KAAK,EAAE,MAAM;GAAC;GAAQ;GAAQ;EAAI,EAA8B;EAChE,iBAAiB,EAAE,MAAM,OAAO;EAChC,cAAc,EAAE,MAAM,OAAmD;CAC3E;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,SAAS,aAAa,aAAa,KAAK;EAC9C,MAAM,UAAU,WAAW,yBAAyB;GAClD,OAAO,OAAO;GACd,MAAM,OAAO;GACb,QAAQ,OAAO;GACf,QAAQ,OAAO;GACf,UAAU,OAAO;GACjB,KAAK,OAAO;GACZ,iBAAiB,OAAO;GACxB,cAAc,OAAO;EACvB,IAAI,YAAY,MAAM,qBAAqB,CAAC,CAAC;EAC7C,MAAM,MAAM,eAAe,iBAAiB,SAAS,YAAY,CAAC;EAElE,aAAa;GACX,MAAM,UAAU,MAAM,UAAU;GAChC,OAAO,EACL,QACA,IAAI,MAAM,aAAa,GAEvB,WAAW,OAAO,IAAI,UAAU,IAAI,MAAM,IAC5C;EACF;CACF;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"toggle-group.d.ts","names":[],"sources":["../../../src/components/toggle-group/toggle-group.ts"],"mappings":";;;;;KAgBK,mBAAmB;cAgBX,iCAAiB,8BAAA;;IAIG,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;IAIvB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;IAIF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;EAML,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IApBN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;IAIvB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;IAIF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;qCA6BlC;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAmC5B;;cA6BW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"toggle-group.d.ts","names":[],"sources":["../../../src/components/toggle-group/toggle-group.ts"],"mappings":";;;;;KAiBK,mBAAmB;cAgBX,iCAAiB,8BAAA;;IAIG,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;IAIvB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;IAIF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;EAML,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IApBN,MAAA,SAAS;;;IACJ,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;;;;IAIvB,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;IAIF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;qCAgClC;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAmC5B;;cA6BW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,4 +1,5 @@
 import { useFormControlProps } from "../form/use-form-control.js";
+import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideToggleGroup, useToggleGroupContext } from "./context.js";
 import { useToggleGroup } from "./use-toggle-group.js";
 import { Comment, Fragment, Text, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
@@ -67,9 +68,14 @@ const XhToggleGroupRoot = defineComponent({
 		};
 		const ctx = useToggleGroup(useFormControlProps(props), notify);
 		provideToggleGroup(ctx);
+		const fieldWiring = useFieldGroupWiring();
+		const fieldLabel = useFieldLabelWiring();
 		return () => {
 			const children = slots.default ? slots.default() : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.item) : [];
-			return h("div", ctx.api.value.getRootProps(), renderChildren(children, ctx.api.value));
+			return h("div", fieldLabel.value({
+				...fieldWiring.value,
+				...ctx.api.value.getRootProps()
+			}), renderChildren(children, ctx.api.value));
 		};
 	}
 });

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

@@ -1 +1 @@
-{"version":3,"file":"toggle-group.js","names":[],"sources":["../../../src/components/toggle-group/toggle-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// 提供 toggle group 相关实现。\n\nimport type { ActionVariant, Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { ToggleGroupNode, ToggleGroupNodeMeta, ToggleGroupSchema, ToggleGroupValue } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { Comment, defineComponent, Fragment, h, onBeforeUnmount, ref, Text, watch } from 'vue'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideToggleGroup, useToggleGroupContext } from './context'\nimport { useToggleGroup } from './use-toggle-group'\n\ntype ToggleGroupProps = ToggleGroupSchema['props']\n\nfunction flattenChildren(children: readonly VNode[]): VNode[] {\n  const result: VNode[] = []\n  for (const child of children) {\n    if (child.type === Comment || child.type === Text)\n      continue\n    if (child.type === Fragment && Array.isArray(child.children)) {\n      result.push(...flattenChildren(child.children.filter(value => typeof value === 'object') as VNode[]))\n      continue\n    }\n    result.push(child)\n  }\n  return result\n}\n\nexport const XhToggleGroupRoot = defineComponent({\n  name: 'XhToggleGroupRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ToggleGroupNode[]> },\n    value: { type: [String, Array] as PropType<ToggleGroupValue> },\n    defaultValue: { type: [String, Array] as PropType<ToggleGroupValue> },\n    multiple: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    disallowEmpty: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ActionVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    fullWidth: { type: Boolean, default: undefined },\n    separators: { 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    rovingFocus: { type: Boolean, default: undefined },\n  },\n  // value-change 携带 { value }，update:value 携带裸值；裸值形态跟随 multiple，单选为字符串、多选为数组\n  emits: {\n    'value-change': (_details: PayloadOf<ToggleGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ToggleGroupProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: ToggleGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useToggleGroup(useFormControlProps(props) as ToggleGroupProps, notify)\n    provideToggleGroup(ctx)\n    return () => {\n      const children = slots.default\n        ? slots.default()\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.item)\n          : []\n      return h(\n        'div',\n        ctx.api.value.getRootProps() as Record<string, unknown>,\n        renderChildren(children, ctx.api.value),\n      )\n    }\n  },\n})\n\nexport const XhToggleGroupItem = defineComponent({\n  name: 'XhToggleGroupItem',\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 = useToggleGroupContext()\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，激活交给平台\n    return () => h(\n      'button',\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n// 分隔线按条目计数插在相邻条目之间；要认 XhToggleGroupItem 这个组件对象，所以放在它的定义之后\nfunction renderChildren(children: readonly VNode[], props: {\n  disabled: boolean\n  orientation: Orientation\n  separators: boolean\n}): VNode[] {\n  const result: VNode[] = []\n  let itemCount = 0\n  for (const child of flattenChildren(children)) {\n    if (child.type === XhToggleGroupItem) {\n      if (props.separators && itemCount > 0) {\n        result.push(h('span', {\n          'key': `separator-${itemCount}`,\n          'aria-hidden': true,\n          'data-xh-toggle-group-separator': '',\n          'data-orientation': props.orientation === 'horizontal' ? 'vertical' : 'horizontal',\n          'data-disabled': props.disabled ? '' : undefined,\n        }))\n      }\n      itemCount += 1\n    }\n    result.push(child)\n  }\n  return result\n}\n\n/** 表单出口：整组只有一份，提供 name 后才参与提交。 */\nexport const XhToggleGroupHiddenInput = defineComponent({\n  name: 'XhToggleGroupHiddenInput',\n  setup() {\n    const ctx = useToggleGroupContext()\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 ToggleGroupNodeMeta[],\n  itemSlot?: (node: ToggleGroupNodeMeta) => VNode[],\n): VNode[] {\n  return collection.map(node => h(\n    XhToggleGroupItem,\n    { key: node.value, value: node.value },\n    () => itemSlot?.(node) ?? node.label,\n  ))\n}\n"],"mappings":"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"}
+{"version":3,"file":"toggle-group.js","names":[],"sources":["../../../src/components/toggle-group/toggle-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// 提供 toggle group 相关实现。\n\nimport type { ActionVariant, Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { ToggleGroupNode, ToggleGroupNodeMeta, ToggleGroupSchema, ToggleGroupValue } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { Comment, defineComponent, Fragment, h, onBeforeUnmount, ref, Text, watch } from 'vue'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideToggleGroup, useToggleGroupContext } from './context'\nimport { useToggleGroup } from './use-toggle-group'\n\ntype ToggleGroupProps = ToggleGroupSchema['props']\n\nfunction flattenChildren(children: readonly VNode[]): VNode[] {\n  const result: VNode[] = []\n  for (const child of children) {\n    if (child.type === Comment || child.type === Text)\n      continue\n    if (child.type === Fragment && Array.isArray(child.children)) {\n      result.push(...flattenChildren(child.children.filter(value => typeof value === 'object') as VNode[]))\n      continue\n    }\n    result.push(child)\n  }\n  return result\n}\n\nexport const XhToggleGroupRoot = defineComponent({\n  name: 'XhToggleGroupRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<ToggleGroupNode[]> },\n    value: { type: [String, Array] as PropType<ToggleGroupValue> },\n    defaultValue: { type: [String, Array] as PropType<ToggleGroupValue> },\n    multiple: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    disallowEmpty: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ActionVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    fullWidth: { type: Boolean, default: undefined },\n    separators: { 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    rovingFocus: { type: Boolean, default: undefined },\n  },\n  // value-change 携带 { value }，update:value 携带裸值；裸值形态跟随 multiple，单选为字符串、多选为数组\n  emits: {\n    'value-change': (_details: PayloadOf<ToggleGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ToggleGroupProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: ToggleGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useToggleGroup(useFormControlProps(props) as ToggleGroupProps, notify)\n    provideToggleGroup(ctx)\n    // 放进表单字段时，字段的标题与说明接到组上：读屏进组时念组名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => {\n      const children = slots.default\n        ? slots.default()\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, slots.item)\n          : []\n      return h(\n        'div',\n        fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }),\n        renderChildren(children, ctx.api.value),\n      )\n    }\n  },\n})\n\nexport const XhToggleGroupItem = defineComponent({\n  name: 'XhToggleGroupItem',\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 = useToggleGroupContext()\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，激活交给平台\n    return () => h(\n      'button',\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n// 分隔线按条目计数插在相邻条目之间；要认 XhToggleGroupItem 这个组件对象，所以放在它的定义之后\nfunction renderChildren(children: readonly VNode[], props: {\n  disabled: boolean\n  orientation: Orientation\n  separators: boolean\n}): VNode[] {\n  const result: VNode[] = []\n  let itemCount = 0\n  for (const child of flattenChildren(children)) {\n    if (child.type === XhToggleGroupItem) {\n      if (props.separators && itemCount > 0) {\n        result.push(h('span', {\n          'key': `separator-${itemCount}`,\n          'aria-hidden': true,\n          'data-xh-toggle-group-separator': '',\n          'data-orientation': props.orientation === 'horizontal' ? 'vertical' : 'horizontal',\n          'data-disabled': props.disabled ? '' : undefined,\n        }))\n      }\n      itemCount += 1\n    }\n    result.push(child)\n  }\n  return result\n}\n\n/** 表单出口：整组只有一份，提供 name 后才参与提交。 */\nexport const XhToggleGroupHiddenInput = defineComponent({\n  name: 'XhToggleGroupHiddenInput',\n  setup() {\n    const ctx = useToggleGroupContext()\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 ToggleGroupNodeMeta[],\n  itemSlot?: (node: ToggleGroupNodeMeta) => VNode[],\n): VNode[] {\n  return collection.map(node => h(\n    XhToggleGroupItem,\n    { key: node.value, value: node.value },\n    () => itemSlot?.(node) ?? node.label,\n  ))\n}\n"],"mappings":"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"}

package/dist/components/toolbar/toolbar.d.ts

@@ -1,6 +1,6 @@
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Orientation, Size } from "@xihan-ui/core";
-import { ToolbarApi } from "@xihan-ui/headless";
+import { ToolbarApi, ToolbarTranslations } from "@xihan-ui/headless";
 //#region src/components/toolbar/toolbar.d.ts
 /** 默认插槽的载荷：焦点锚点、生效的主轴与整条工具条的禁用态。 */
 type ToolbarRootSlotProps = Pick<ToolbarApi, 'focusedValue' | 'orientation' | 'disabled'>;
@@ -25,6 +25,9 @@ declare const XhToolbarRoot: import("vue").DefineComponent<import("vue").Extract
   size: {
     type: PropType<Size>;
   };
+  translations: {
+    type: PropType<Partial<ToolbarTranslations>>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -48,6 +51,9 @@ declare const XhToolbarRoot: import("vue").DefineComponent<import("vue").Extract
   size: {
     type: PropType<Size>;
   };
+  translations: {
+    type: PropType<Partial<ToolbarTranslations>>;
+  };
 }>> & Readonly<{}>, {
   loop: boolean;
   disabled: boolean;
@@ -88,6 +94,15 @@ declare const XhToolbarItem: import("vue").DefineComponent<import("vue").Extract
   as: string;
   disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/**
+ * 行尾的「更多」钮：放不下的条目按次序收进它弹出的菜单，全部放得下时它收着。
+ * 放在 root 的最后。它同时是一张 Menu 的触发器——菜单的条目、勾选态与落位都由工具条的机器现给
+ * （toolbarOverflowMenuProps），钮按 asChild 接菜单的开合接线，自己的解剖与工具条的处理器不让位。
+ * 不写内容时由皮肤画一枚横排三点。
+ */
+declare const XhToolbarOverflowTrigger: 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 { ToolbarRootSlotProps, XhToolbarGroup, XhToolbarItem, XhToolbarRoot, XhToolbarSeparator };
+export { ToolbarRootSlotProps, XhToolbarGroup, XhToolbarItem, XhToolbarOverflowTrigger, XhToolbarRoot, XhToolbarSeparator };
 //# sourceMappingURL=toolbar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolbar.d.ts","names":[],"sources":["../../../src/components/toolbar/toolbar.ts"],"mappings":";;;;;KAiBY,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;IAIS,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;IALF,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;;;;EAGvB,WAAC,OAAO,yBAAyB;kCAY7C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAoCxB"}
+{"version":3,"file":"toolbar.d.ts","names":[],"sources":["../../../src/components/toolbar/toolbar.ts"],"mappings":";;;;;KAqBY,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;IAIS,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;IANlB,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;IAGL,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAGvC,WAAC,OAAO,yBAAyB;kCAe7C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAO7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAoCxB;;;;;;;cAQW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAUnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/toolbar/toolbar.js

@@ -1,6 +1,10 @@
+import { withXhConfig } from "../../config/config.js";
+import { mergePartProps } from "../../runtime/merge-props.js";
+import { XhMenuRoot } from "../menu/menu.js";
 import { provideToolbar, useToolbarContext } from "./context.js";
 import { useToolbar } from "./use-toolbar.js";
 import { defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
+import { toolbarOverflowMenuProps } from "@xihan-ui/headless";
 //#region src/components/toolbar/toolbar.ts
 const XhToolbarRoot = defineComponent({
 	name: "XhToolbarRoot",
@@ -16,13 +20,19 @@ const XhToolbarRoot = defineComponent({
 			default: void 0
 		},
 		variant: { type: String },
-		size: { type: String }
+		size: { type: String },
+		translations: { type: Object }
 	},
 	slots: Object,
 	setup(props, { slots }) {
-		const ctx = useToolbar(props);
+		const ctx = useToolbar(withXhConfig("toolbar", props));
 		provideToolbar(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+		return () => h("div", {
+			...ctx.api.value.getRootProps(),
+			ref: (el) => {
+				ctx.rootRef.value = el;
+			}
+		}, slots.default?.({
 			focusedValue: ctx.api.value.focusedValue,
 			orientation: ctx.api.value.orientation,
 			disabled: ctx.api.value.disabled
@@ -83,7 +93,24 @@ const XhToolbarItem = defineComponent({
 		}, slots.default?.());
 	}
 });
+/**
+* 行尾的「更多」钮：放不下的条目按次序收进它弹出的菜单，全部放得下时它收着。
+* 放在 root 的最后。它同时是一张 Menu 的触发器——菜单的条目、勾选态与落位都由工具条的机器现给
+* （toolbarOverflowMenuProps），钮按 asChild 接菜单的开合接线，自己的解剖与工具条的处理器不让位。
+* 不写内容时由皮肤画一枚横排三点。
+*/
+const XhToolbarOverflowTrigger = defineComponent({
+	name: "XhToolbarOverflowTrigger",
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
+		const ctx = useToolbarContext();
+		return () => h(XhMenuRoot, {
+			...toolbarOverflowMenuProps(ctx.service),
+			triggerAsChild: true
+		}, { trigger: () => [h("button", mergePartProps(ctx.api.value.getOverflowTriggerProps(), attrs), slots.default?.())] });
+	}
+});
 //#endregion
-export { XhToolbarGroup, XhToolbarItem, XhToolbarRoot, XhToolbarSeparator };
+export { XhToolbarGroup, XhToolbarItem, XhToolbarOverflowTrigger, XhToolbarRoot, XhToolbarSeparator };
 
 //# sourceMappingURL=toolbar.js.map

package/dist/components/toolbar/toolbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar.js","names":[],"sources":["../../../src/components/toolbar/toolbar.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// 提供 toolbar 相关实现。\n\nimport type { ControlVariant, Direction, Orientation, Size } from '@xihan-ui/core'\nimport type { ToolbarApi, ToolbarSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { provideToolbar, useToolbarContext } from './context'\nimport { useToolbar } from './use-toolbar'\n\ntype ToolbarProps = ToolbarSchema['props']\n\n/** 默认插槽的载荷：焦点锚点、生效的主轴与整条工具条的禁用态。 */\nexport type ToolbarRootSlotProps = Pick<ToolbarApi, 'focusedValue' | 'orientation' | 'disabled'>\n\nexport const XhToolbarRoot = defineComponent({\n  name: 'XhToolbarRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    loop: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    size: { type: String as PropType<Size> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ToolbarRootSlotProps) => VNode[]\n  }>,\n  // 无对外事件，条目的点击与切换由条目自行派发\n  setup(props, { slots }) {\n    const ctx = useToolbar(props as ToolbarProps)\n    provideToolbar(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      focusedValue: ctx.api.value.focusedValue,\n      orientation: ctx.api.value.orientation,\n      disabled: ctx.api.value.disabled,\n    }))\n  },\n})\n\nexport const XhToolbarGroup = defineComponent({\n  name: 'XhToolbarGroup',\n  setup(_, { slots }) {\n    const ctx = useToolbarContext()\n    return () => h('div', ctx.api.value.getGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhToolbarSeparator = defineComponent({\n  name: 'XhToolbarSeparator',\n  setup() {\n    const ctx = useToolbarContext()\n    // 分隔线不渲染内容\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhToolbarItem = defineComponent({\n  name: 'XhToolbarItem',\n  props: {\n    value: { type: String, required: true },\n    disabled: Boolean,\n    /** 条目渲染为哪个标签，默认 button；不自动补 type=\"button\"，表单内需自行声明。 */\n    as: { type: String, default: 'button' },\n  },\n  setup(props, { slots }) {\n    const ctx = useToolbarContext()\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      // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'TOOLBAR.BLUR' })\n    })\n    return () => h(\n      props.as,\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;AAmBA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,aAAa,EAAE,MAAM,OAAgC;EACrD,KAAK,EAAE,MAAM,OAA8B;EAC3C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;CACzC;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,WAAW,KAAqB;EAC5C,eAAe,GAAG;EAClB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,cAAc,IAAI,IAAI,MAAM;GAC5B,aAAa,IAAI,IAAI,MAAM;GAC3B,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,kBAAkB,CAA4B;CACpF;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EACtC,UAAU;;EAEV,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAS;CACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,kBAAkB;EAE9B,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;GAEpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,eAAe,CAAC;EACzC,CAAC;EACD,aAAa,EACX,MAAM,IACN;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;IAAE,OAAO,MAAM;IAAO,UAAU,MAAM;GAAS,CAAC;GAA8B,KAAK;EAAO,GAC1H,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}
+{"version":3,"file":"toolbar.js","names":[],"sources":["../../../src/components/toolbar/toolbar.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// 提供 toolbar 相关实现。\n\nimport type { ControlVariant, Direction, Orientation, Size } from '@xihan-ui/core'\nimport type { ToolbarApi, ToolbarSchema, ToolbarTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport { toolbarOverflowMenuProps } from '@xihan-ui/headless'\nimport { defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { XhMenuRoot } from '../menu/menu'\nimport { provideToolbar, useToolbarContext } from './context'\nimport { useToolbar } from './use-toolbar'\n\ntype ToolbarProps = ToolbarSchema['props']\n\n/** 默认插槽的载荷：焦点锚点、生效的主轴与整条工具条的禁用态。 */\nexport type ToolbarRootSlotProps = Pick<ToolbarApi, 'focusedValue' | 'orientation' | 'disabled'>\n\nexport const XhToolbarRoot = defineComponent({\n  name: 'XhToolbarRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    loop: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<ToolbarTranslations>> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ToolbarRootSlotProps) => VNode[]\n  }>,\n  // 无对外事件，条目的点击与切换由条目自行派发\n  setup(props, { slots }) {\n    const ctx = useToolbar(withXhConfig('toolbar', props) as ToolbarProps)\n    provideToolbar(ctx)\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement | null },\n    }, slots.default?.({\n      focusedValue: ctx.api.value.focusedValue,\n      orientation: ctx.api.value.orientation,\n      disabled: ctx.api.value.disabled,\n    }))\n  },\n})\n\nexport const XhToolbarGroup = defineComponent({\n  name: 'XhToolbarGroup',\n  setup(_, { slots }) {\n    const ctx = useToolbarContext()\n    return () => h('div', ctx.api.value.getGroupProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhToolbarSeparator = defineComponent({\n  name: 'XhToolbarSeparator',\n  setup() {\n    const ctx = useToolbarContext()\n    // 分隔线不渲染内容\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhToolbarItem = defineComponent({\n  name: 'XhToolbarItem',\n  props: {\n    value: { type: String, required: true },\n    disabled: Boolean,\n    /** 条目渲染为哪个标签，默认 button；不自动补 type=\"button\"，表单内需自行声明。 */\n    as: { type: String, default: 'button' },\n  },\n  setup(props, { slots }) {\n    const ctx = useToolbarContext()\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      // 整组一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'TOOLBAR.BLUR' })\n    })\n    return () => h(\n      props.as,\n      { ...ctx.api.value.getItemProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>, ref: itemEl },\n      slots.default?.(),\n    )\n  },\n})\n\n/**\n * 行尾的「更多」钮：放不下的条目按次序收进它弹出的菜单，全部放得下时它收着。\n * 放在 root 的最后。它同时是一张 Menu 的触发器——菜单的条目、勾选态与落位都由工具条的机器现给\n * （toolbarOverflowMenuProps），钮按 asChild 接菜单的开合接线，自己的解剖与工具条的处理器不让位。\n * 不写内容时由皮肤画一枚横排三点。\n */\nexport const XhToolbarOverflowTrigger = defineComponent({\n  name: 'XhToolbarOverflowTrigger',\n  // 直通属性合到钮上，而不是落到菜单的根组件上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useToolbarContext()\n    return () => h(XhMenuRoot, { ...toolbarOverflowMenuProps(ctx.service), triggerAsChild: true }, {\n      trigger: () => [h('button', mergePartProps(ctx.api.value.getOverflowTriggerProps() as Record<string, unknown>, attrs), slots.default?.())],\n    })\n  },\n})\n"],"mappings":";;;;;;;;AAuBA,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CAEN,OAAO;EACL,aAAa,EAAE,MAAM,OAAgC;EACrD,KAAK,EAAE,MAAM,OAA8B;EAC3C,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAiD;CACzE;CACA,OAAO;CAIP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,WAAW,aAAa,WAAW,KAAK,CAAiB;EACrE,eAAe,GAAG;EAClB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,MAAM,OAAgB;IAAE,IAAI,QAAQ,QAAQ;GAAyB;EACvE,GAAG,MAAM,UAAU;GACjB,cAAc,IAAI,IAAI,MAAM;GAC5B,aAAa,IAAI,IAAI,MAAM;GAC3B,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,iBAAiB,gBAAgB;CAC5C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACnG;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,kBAAkB;EAE9B,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,kBAAkB,CAA4B;CACpF;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EACtC,UAAU;;EAEV,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAS;CACxC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,kBAAkB;EAE9B,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;GAEpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,eAAe,CAAC;EACzC,CAAC;EACD,aAAa,EACX,MAAM,IACN;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa;IAAE,OAAO,MAAM;IAAO,UAAU,MAAM;GAAS,CAAC;GAA8B,KAAK;EAAO,GAC1H,MAAM,UAAU,CAClB;CACF;AACF,CAAC;;;;;;;AAQD,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,kBAAkB;EAC9B,aAAa,EAAE,YAAY;GAAE,GAAG,yBAAyB,IAAI,OAAO;GAAG,gBAAgB;EAAK,GAAG,EAC7F,eAAe,CAAC,EAAE,UAAU,eAAe,IAAI,IAAI,MAAM,wBAAwB,GAA8B,KAAK,GAAG,MAAM,UAAU,CAAC,CAAC,EAC3I,CAAC;CACH;AACF,CAAC"}

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

@@ -1,11 +1,13 @@
-import { ComputedRef } from "vue";
+import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
 import { ToolbarApi, ToolbarSchema } from "@xihan-ui/headless";
 //#region src/components/toolbar/use-toolbar.d.ts
 interface ToolbarContext {
   api: ComputedRef<ToolbarApi>;
-  /** 状态机实例，供条目上报 DOM 侧的事实（卸载带走了焦点）。 */
+  /** 状态机实例，供条目上报 DOM 侧的事实（卸载带走了焦点），也喂「更多」菜单的机器 props。 */
   service: Service<ToolbarSchema>;
+  /** root 节点：条目与「更多」钮的查询容器，也是收纳量测的参照系。 */
+  rootRef: Ref<HTMLElement | null>;
 }
 declare function useToolbar(props: ToolbarSchema['props']): ToolbarContext;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-toolbar.d.ts","names":[],"sources":["../../../src/components/toolbar/use-toolbar.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAIH,WAAW,OAAO,yBAAyB"}
+{"version":3,"file":"use-toolbar.d.ts","names":[],"sources":["../../../src/components/toolbar/use-toolbar.ts"],"mappings":";;;;UAeiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;iBAIC,WAAW,OAAO,yBAAyB"}

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

@@ -1,13 +1,16 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
+import { computed, ref } from "vue";
 import { connectToolbar, toolbarMachine } from "@xihan-ui/headless";
 //#region src/components/toolbar/use-toolbar.ts
 function useToolbar(props) {
+	const rootRef = ref(null);
 	const service = useMachine(toolbarMachine, () => ({ ...props }));
+	service.refs.set("getRootEl", () => rootRef.value);
 	return {
 		api: computed(() => connectToolbar(service, vueNormalize)),
-		service
+		service,
+		rootRef
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-toolbar.js","names":[],"sources":["../../../src/components/toolbar/use-toolbar.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 toolbar 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ToolbarApi, ToolbarSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectToolbar, toolbarMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ToolbarContext {\n  api: ComputedRef<ToolbarApi>\n  /** 状态机实例，供条目上报 DOM 侧的事实（卸载带走了焦点）。 */\n  service: Service<ToolbarSchema>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useToolbar(props: ToolbarSchema['props']): ToolbarContext {\n  const service = useMachine(toolbarMachine, () => ({ ...props }))\n  const api = computed(() => connectToolbar(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;AAsBA,SAAgB,WAAW,OAA+C;CACxE,MAAM,UAAU,WAAW,uBAAuB,EAAE,GAAG,MAAM,EAAE;CAE/D,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-toolbar.js","names":[],"sources":["../../../src/components/toolbar/use-toolbar.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 toolbar 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { ToolbarApi, ToolbarSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectToolbar, toolbarMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ToolbarContext {\n  api: ComputedRef<ToolbarApi>\n  /** 状态机实例，供条目上报 DOM 侧的事实（卸载带走了焦点），也喂「更多」菜单的机器 props。 */\n  service: Service<ToolbarSchema>\n  /** root 节点：条目与「更多」钮的查询容器，也是收纳量测的参照系。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useToolbar(props: ToolbarSchema['props']): ToolbarContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const service = useMachine(toolbarMachine, () => ({ ...props }))\n  // 收纳量测在机器的挂载效应里跑，取值口要赶在那之前交出去\n  service.refs.set('getRootEl', () => rootRef.value)\n  const api = computed(() => connectToolbar(service, vueNormalize))\n  return { api, service, rootRef }\n}\n"],"mappings":";;;;;AAwBA,SAAgB,WAAW,OAA+C;CACxE,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,UAAU,WAAW,uBAAuB,EAAE,GAAG,MAAM,EAAE;CAE/D,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAEjD,OAAO;EAAE,KADG,eAAe,eAAe,SAAS,YAAY,CACpD;EAAG;EAAS;CAAQ;AACjC"}

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

@@ -0,0 +1,21 @@
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
+import { TooltipApi, TooltipSchema } from "@xihan-ui/headless";
+//#region src/components/tooltip/context.d.ts
+interface TooltipContext {
+  service: Service<TooltipSchema>;
+  api: ComputedRef<TooltipApi>;
+  /** 定位锚点。 */
+  triggerRef: Ref<HTMLElement | null>;
+  /** 被定位的浮层。 */
+  positionerRef: Ref<HTMLElement | null>;
+  /** 浮层本体，退场动画从它上面探测。 */
+  contentRef: Ref<HTMLElement | null>;
+  /** 当前是否应当可见：退场动画播完之前仍为真。 */
+  visible: Ref<boolean>;
+  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */
+  portalTarget: ComputedRef<string | Element>;
+}
+//#endregion
+export { TooltipContext };
+//# sourceMappingURL=context.d.ts.map

package/dist/components/tooltip/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/tooltip/context.ts"],"mappings":";;;;UAYiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,YAAY,IAAI;;EAEhB,eAAe,IAAI;;EAEnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB"}

package/dist/components/tooltip/context.js

@@ -1,6 +1,15 @@
 import { inject, provide } from "vue";
 //#region src/components/tooltip/context.ts
 const KEY = Symbol.for("xh-tooltip");
+const GROUP_KEY = Symbol.for("xh-tooltip-group");
+/** XhTooltipProvider 把它那一组交给子树里的提示。 */
+function provideTooltipGroup(group) {
+	provide(GROUP_KEY, group);
+}
+/** 最近的 XhTooltipProvider 建的那一组；不在 Provider 里时为 null，提示归页面级的那一组。 */
+function useTooltipGroup() {
+	return inject(GROUP_KEY, null);
+}
 function provideTooltip(ctx) {
 	provide(KEY, ctx);
 }
@@ -10,6 +19,6 @@ function useTooltipContext() {
 	return ctx;
 }
 //#endregion
-export { provideTooltip, useTooltipContext };
+export { provideTooltip, provideTooltipGroup, useTooltipContext, useTooltipGroup };
 
 //# sourceMappingURL=context.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tooltip/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 { InjectionKey } from 'vue'\nimport type { TooltipContext } from './use-tooltip'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<TooltipContext> = Symbol.for('xh-tooltip')\n\nexport function provideTooltip(ctx: TooltipContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTooltipContext(): TooltipContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Tooltip 部件必须用在 XhTooltipRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAoC,OAAO,IAAI,YAAY;AAEjE,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/tooltip/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 { Service } from '@xihan-ui/core'\nimport type { TooltipApi, TooltipGroup, TooltipSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey, Ref } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface TooltipContext {\n  service: Service<TooltipSchema>\n  api: ComputedRef<TooltipApi>\n  /** 定位锚点。 */\n  triggerRef: Ref<HTMLElement | null>\n  /** 被定位的浮层。 */\n  positionerRef: Ref<HTMLElement | null>\n  /** 浮层本体，退场动画从它上面探测。 */\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当可见：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nconst KEY: InjectionKey<TooltipContext> = Symbol.for('xh-tooltip')\nconst GROUP_KEY: InjectionKey<TooltipGroup> = Symbol.for('xh-tooltip-group')\n\n/** XhTooltipProvider 把它那一组交给子树里的提示。 */\nexport function provideTooltipGroup(group: TooltipGroup): void {\n  provide(GROUP_KEY, group)\n}\n\n/** 最近的 XhTooltipProvider 建的那一组；不在 Provider 里时为 null，提示归页面级的那一组。 */\nexport function useTooltipGroup(): TooltipGroup | null {\n  return inject(GROUP_KEY, null)\n}\n\nexport function provideTooltip(ctx: TooltipContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useTooltipContext(): TooltipContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Tooltip 部件必须用在 XhTooltipRoot 内')\n  return ctx\n}\n"],"mappings":";;AA2BA,MAAM,MAAoC,OAAO,IAAI,YAAY;AACjE,MAAM,YAAwC,OAAO,IAAI,kBAAkB;;AAG3E,SAAgB,oBAAoB,OAA2B;CAC7D,QAAQ,WAAW,KAAK;AAC1B;;AAGA,SAAgB,kBAAuC;CACrD,OAAO,OAAO,WAAW,IAAI;AAC/B;AAEA,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT"}

package/dist/components/tooltip/tooltip.d.ts

@@ -6,6 +6,39 @@ import { TooltipApi, TooltipSchema } from "@xihan-ui/headless";
 type TooltipProps = TooltipSchema['props'];
 /** 默认插槽的载荷：展开状态与开合方法。 */
 type TooltipRootSlotProps = Pick<TooltipApi, 'open' | 'setOpen'>;
+/**
+ * 提示组：子树里的提示归同一组，共用接替窗口、同一时刻只开一个，没写延时的取这里给的缺省。
+ * 本身不渲染节点，也不改动子节点的排布。
+ */
+declare const XhTooltipProvider: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 组内提示悬停进入到展开的缺省等待毫秒；提示自己写了就以提示为准。 */
+  openDelay: {
+    type: NumberConstructor;
+  };
+  /** 组内提示悬停移出到收起的缺省等待毫秒。 */
+  closeDelay: {
+    type: NumberConstructor;
+  };
+  /** 组内提示的缺省接替窗口毫秒；0 表示组内不接替。 */
+  skipDelayDuration: {
+    type: NumberConstructor;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 组内提示悬停进入到展开的缺省等待毫秒；提示自己写了就以提示为准。 */
+  openDelay: {
+    type: NumberConstructor;
+  };
+  /** 组内提示悬停移出到收起的缺省等待毫秒。 */
+  closeDelay: {
+    type: NumberConstructor;
+  };
+  /** 组内提示的缺省接替窗口毫秒；0 表示组内不接替。 */
+  skipDelayDuration: {
+    type: NumberConstructor;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhTooltipRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   open: {
     type: BooleanConstructor;
@@ -28,7 +61,16 @@ declare const XhTooltipRoot: import("vue").DefineComponent<import("vue").Extract
   closeDelay: {
     type: NumberConstructor;
   };
+  /** 跳过等待的窗口毫秒，默认 300：另一个提示开着或刚收起时，指向这一个直接接替、不播进场；0 不参与。 */
+  skipDelayDuration: {
+    type: NumberConstructor;
+  };
   disabled: BooleanConstructor;
+  /** 跟随鼠标：由指针打开的提示锚在指针落点上并随移动更新；触屏与聚焦打开时锚回 trigger。 */
+  followCursor: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   tone: {
     type: PropType<Tone>;
   };
@@ -62,7 +104,16 @@ declare const XhTooltipRoot: import("vue").DefineComponent<import("vue").Extract
   closeDelay: {
     type: NumberConstructor;
   };
+  /** 跳过等待的窗口毫秒，默认 300：另一个提示开着或刚收起时，指向这一个直接接替、不播进场；0 不参与。 */
+  skipDelayDuration: {
+    type: NumberConstructor;
+  };
   disabled: BooleanConstructor;
+  /** 跟随鼠标：由指针打开的提示锚在指针落点上并随移动更新；触屏与聚焦打开时锚回 trigger。 */
+  followCursor: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   tone: {
     type: PropType<Tone>;
   };
@@ -76,6 +127,7 @@ declare const XhTooltipRoot: import("vue").DefineComponent<import("vue").Extract
   disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
+  followCursor: boolean;
 }, SlotsType<{
   default?: (props: TooltipRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -110,5 +162,5 @@ declare const XhTooltipArrow: import("vue").DefineComponent<{}, () => VNode<impo
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { TooltipRootSlotProps, XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipRoot, XhTooltipTrigger };
+export { TooltipRootSlotProps, XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipProvider, XhTooltipRoot, XhTooltipTrigger };
 //# sourceMappingURL=tooltip.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tooltip.d.ts","names":[],"sources":["../../../src/components/tooltip/tooltip.ts"],"mappings":";;;;;KAkBK,eAAe;;KAGR,uBAAuB,KAAK;cAE3B,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAbJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAyB3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAcxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"tooltip.d.ts","names":[],"sources":["../../../src/components/tooltip/tooltip.ts"],"mappings":";;;;;KAmBK,eAAe;;KAGR,uBAAuB,KAAK;;;;;cAM3B,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmB5B,oDAAA;cAEW,6BAAa,8BAAA;;;;;;;IAKO,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAQR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;IAjBJ,MAAA,SAAS;;;;;;;IAGf,MAAA,SAAS;;;;;;;;;;;;;;;;;;;IAQR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;;EAQvB,WAAC,OAAO,yBAAyB;kCAW7C;cAEW,gCAAgB,8BAAA;;;;;;;;;;qCAyB3B;cAEW,mCAAmB,8BAAA;;;IAIC,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAcxC,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/tooltip/tooltip.js

@@ -1,10 +1,34 @@
-import { XhPortal } from "../../runtime/portal.js";
 import { mergePartProps } from "../../runtime/merge-props.js";
 import { mergeIntoChild } from "../../runtime/as-child.js";
-import { provideTooltip, useTooltipContext } from "./context.js";
+import { XhPortal } from "../../runtime/portal.js";
+import { provideTooltip, provideTooltipGroup, useTooltipContext } from "./context.js";
 import { useTooltip } from "./use-tooltip.js";
 import { defineComponent, h, mergeProps } from "vue";
+import { createTooltipGroup } from "@xihan-ui/headless";
 //#region src/components/tooltip/tooltip.ts
+/**
+* 提示组：子树里的提示归同一组，共用接替窗口、同一时刻只开一个，没写延时的取这里给的缺省。
+* 本身不渲染节点，也不改动子节点的排布。
+*/
+const XhTooltipProvider = defineComponent({
+	name: "XhTooltipProvider",
+	props: {
+		/** 组内提示悬停进入到展开的缺省等待毫秒；提示自己写了就以提示为准。 */
+		openDelay: { type: Number },
+		/** 组内提示悬停移出到收起的缺省等待毫秒。 */
+		closeDelay: { type: Number },
+		/** 组内提示的缺省接替窗口毫秒；0 表示组内不接替。 */
+		skipDelayDuration: { type: Number }
+	},
+	setup(props, { slots }) {
+		provideTooltipGroup(createTooltipGroup(() => ({
+			openDelay: props.openDelay,
+			closeDelay: props.closeDelay,
+			skipDelayDuration: props.skipDelayDuration
+		})));
+		return () => slots.default?.();
+	}
+});
 const XhTooltipRoot = defineComponent({
 	name: "XhTooltipRoot",
 	props: {
@@ -19,7 +43,14 @@ const XhTooltipRoot = defineComponent({
 		dir: { type: String },
 		openDelay: { type: Number },
 		closeDelay: { type: Number },
+		/** 跳过等待的窗口毫秒，默认 300：另一个提示开着或刚收起时，指向这一个直接接替、不播进场；0 不参与。 */
+		skipDelayDuration: { type: Number },
 		disabled: Boolean,
+		/** 跟随鼠标：由指针打开的提示锚在指针落点上并随移动更新；触屏与聚焦打开时锚回 trigger。 */
+		followCursor: {
+			type: Boolean,
+			default: void 0
+		},
 		tone: { type: String },
 		size: { type: String }
 	},
@@ -105,6 +136,6 @@ const XhTooltipArrow = defineComponent({
 	}
 });
 //#endregion
-export { XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipRoot, XhTooltipTrigger };
+export { XhTooltipArrow, XhTooltipContent, XhTooltipPositioner, XhTooltipProvider, XhTooltipRoot, XhTooltipTrigger };
 
 //# sourceMappingURL=tooltip.js.map