@xihan-ui/vue 4.1.0 → 5.0.0

package/dist/components/notification/notification.d.ts

@@ -1,6 +1,6 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { NotificationDedupe, NotificationItemApi, NotificationItemSchema, NotificationOptions, NotificationPlacement, NotificationPreset, NotificationRecord, NotificationSchema, NotificationTone, NotificationTranslations, ResolvedNotification } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/notification/notification.d.ts
 type NotificationProps = NotificationSchema['props'];
 type NotificationItemProps = NotificationItemSchema['props'];

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

@@ -1 +1 @@
-{"version":3,"file":"notification.d.ts","names":[],"sources":["../../../src/components/notification/notification.ts"],"mappings":";;;;KA2BK,oBAAoB;KACpB,wBAAwB;;UAGZ;EACf,OAAO;EACP,YAAY;EACZ;EACA,sBAAsB,WAAW,0BAA0B;EAC3D,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;EACtC,UAAU;EACV;;cAGW,kCAAkB,8BAAA;;IAIH,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;IAEZ,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKH,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfX,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;IAEZ,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKH,MAAA,SAAS,QAAQ;;;;;;;;;EAQvC,WAAC,OAAO,8BAA8B;kCAqBlD;;UAGe;EACf,MAAM;;cAGK,mCAAmB,8BAAA;;IAIC,MAAA,SAAS;;;;;;IAAT,MAAA,SAAS;;;EAG5B,WAAC,OAAO,+BAA+B;kCAkBnD;;UAGe;EACf,MAAM;;;cAIK,kCAAkB,8BAAA;;;;;IAMD,MAAA,SAAS;;;;;;;;;IAGX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAOD,MAAA,SAAS,QAAQ;;;;;EAIrB,kBAAA,UAAA,UAAU;EACjB,SAAA,UAAA,UAAU;;;;;;IAfL,MAAA,SAAS;;;;;;;;;IAGX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAOD,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,8BAA8B;kCAelD;;cAGW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAMtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAWlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAUxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAO1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8CAA8B,0BAAA,oBAAA,4BAAA;;8BAMzC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"notification.d.ts","names":[],"sources":["../../../src/components/notification/notification.ts"],"mappings":";;;;KA4BK,oBAAoB;KACpB,wBAAwB;;UAGZ;EACf,OAAO;EACP,YAAY;EACZ;EACA,sBAAsB,WAAW,0BAA0B;EAC3D,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;EACtC,UAAU;EACV;;cAGW,kCAAkB,8BAAA;;IAIH,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;IAEZ,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKH,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAfX,MAAA,SAAS;;;IACF,MAAA,SAAS;;;IACd,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;IAEZ,MAAA,SAAS;;;;;;;;;;;;;;;;;IAKH,MAAA,SAAS,QAAQ;;;;;;;;;EAQvC,WAAC,OAAO,8BAA8B;kCAqBlD;;UAGe;EACf,MAAM;;cAGK,mCAAmB,8BAAA;;IAIC,MAAA,SAAS;;;;;;IAAT,MAAA,SAAS;;;EAG5B,WAAC,OAAO,+BAA+B;kCAkBnD;;UAGe;EACf,MAAM;;;cAIK,kCAAkB,8BAAA;;;;;IAMD,MAAA,SAAS;;;;;;;;;IAGX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAOD,MAAA,SAAS,QAAQ;;;;;EAIrB,kBAAA,UAAA,UAAU;EACjB,SAAA,UAAA,UAAU;;;;;;IAfL,MAAA,SAAS;;;;;;;;;IAGX,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;IAOD,MAAA,SAAS,QAAQ;;;;;;;;;;;EAQvC,WAAC,OAAO,8BAA8B;kCAelD;;cAGW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAMtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAYlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAYxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAO1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;8BAMrC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8CAA8B,0BAAA,oBAAA,4BAAA;;8BAMzC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/notification/notification.js

@@ -1,4 +1,5 @@
 import { withXhConfig } from "../../config/config.js";
+import { useDescriptionPart, useTitleDescriptionPart } from "../../runtime/title-description.js";
 import { provideNotification, provideNotificationItem, useNotificationContext, useNotificationItemContext } from "./context.js";
 import { useNotification, useNotificationItem } from "./use-notification.js";
 import { Fragment, defineComponent, h } from "vue";
@@ -128,6 +129,7 @@ const XhNotificationItemTitle = defineComponent({
 	name: "XhNotificationItemTitle",
 	setup(_, { slots }) {
 		const ctx = useNotificationItemContext();
+		useTitleDescriptionPart(ctx.presence, "title");
 		return () => h("div", ctx.api.value.getItemTitleProps(), slots.default?.() ?? ctx.api.value.title);
 	}
 });
@@ -135,7 +137,11 @@ const XhNotificationItemDescription = defineComponent({
 	name: "XhNotificationItemDescription",
 	setup(_, { slots }) {
 		const ctx = useNotificationItemContext();
-		return () => h("div", ctx.api.value.getItemDescriptionProps(), slots.default?.() ?? ctx.api.value.description);
+		const el = useDescriptionPart(ctx.presence);
+		return () => h("div", {
+			...ctx.api.value.getItemDescriptionProps(),
+			ref: el
+		}, slots.default?.() ?? ctx.api.value.description);
 	}
 });
 const XhNotificationItemActionTrigger = defineComponent({

package/dist/components/notification/notification.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification.js","names":[],"sources":["../../../src/components/notification/notification.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// 提供 notification 相关实现。\n\nimport type {\n  NotificationDedupe,\n  NotificationItemApi,\n  NotificationItemSchema,\n  NotificationOptions,\n  NotificationPlacement,\n  NotificationPreset,\n  NotificationRecord,\n  NotificationSchema,\n  NotificationTone,\n  NotificationTranslations,\n  ResolvedNotification,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, Fragment, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideNotification, provideNotificationItem, useNotificationContext, useNotificationItemContext } from './context'\nimport { useNotification, useNotificationItem } from './use-notification'\n\ntype NotificationProps = NotificationSchema['props']\ntype NotificationItemProps = NotificationItemSchema['props']\n\n/** 默认插槽的载荷：当前可见的通知队列与它的落位分组，以及入队、改写、关闭的命令。 */\nexport interface NotificationRootSlotProps {\n  items: ResolvedNotification[]\n  placements: NotificationPlacement[]\n  count: number\n  getItemsByPlacement: (placement: NotificationPlacement) => ResolvedNotification[]\n  create: (options?: NotificationOptions) => string\n  update: (id: string, options: Partial<NotificationOptions>) => void\n  dismiss: (id: string) => void\n  dismissAll: () => void\n}\n\nexport const XhNotificationRoot = defineComponent({\n  name: 'XhNotificationRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    items: { type: Array as PropType<NotificationRecord[]> },\n    defaultItems: { type: Array as PropType<NotificationRecord[]> },\n    preset: { type: String as PropType<NotificationPreset> },\n    placement: { type: String as PropType<NotificationPlacement> },\n    max: { type: Number },\n    dedupe: { type: String as PropType<NotificationDedupe> },\n    gap: { type: Number },\n    duration: { type: Number },\n    stacked: { type: Boolean, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>> },\n  },\n  // items-change 携带 { items }，update:items 携带裸队列以支持 v-model:items\n  emits: {\n    'items-change': (_details: PayloadOf<NotificationProps, 'onItemsChange'>) => true,\n    'update:items': (_items: PayloadOf<NotificationProps, 'onItemsChange'>['items']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NotificationProps['onItemsChange'] = (details) => {\n      emit('items-change', details)\n      emit('update:items', details.items)\n    }\n    const ctx = useNotification(withXhConfig('notification', props) as NotificationProps, notify)\n    provideNotification(ctx)\n    // 根节点是地标容器，插槽作用域里一并暴露队列与增删改命令\n    return () => h('div', { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef }, slots.default?.({\n      items: ctx.api.value.visibleNotifications,\n      placements: ctx.api.value.placements,\n      count: ctx.api.value.count,\n      getItemsByPlacement: ctx.api.value.getItemsByPlacement,\n      create: ctx.create,\n      update: ctx.update,\n      dismiss: ctx.dismiss,\n      dismissAll: ctx.dismissAll,\n    }))\n  },\n})\n\n/** 默认插槽的载荷：该组中逐条铺开的通知。 */\nexport interface NotificationGroupSlotProps {\n  item: ResolvedNotification\n}\n\nexport const XhNotificationGroup = defineComponent({\n  name: 'XhNotificationGroup',\n  props: {\n    // 不写就用 notification 的 placement；写了就只收这个位置上的条目\n    placement: { type: String as PropType<NotificationPlacement> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationGroupSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useNotificationContext()\n    return () => {\n      const api = ctx.api.value\n      const groupProps = api.getGroupProps({ placement: props.placement }) as Record<string, unknown>\n      // 落位从 group 自己的产出里读回，不在这边重算缺省\n      const placement = groupProps['data-placement'] as NotificationPlacement\n      const list = api.getItemsByPlacement(placement)\n      // 每条通知按队列身份 id 给 key，避免节点被就地复用\n      return h(\n        'div',\n        groupProps,\n        slots.default ? list.map(item => h(Fragment, { key: item.id }, slots.default!({ item }))) : undefined,\n      )\n    }\n  },\n})\n\n/** 默认插槽的载荷：该卡片自己的 api。 */\nexport interface NotificationItemSlotProps {\n  item: NotificationItemApi\n}\n\n/** 单条卡片：到期自行消失的一条消息，计时、暂停、按压与退场都在它自己身上。 */\nexport const XhNotificationItem = defineComponent({\n  name: 'XhNotificationItem',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 队列身份，不是 DOM id；不给则回落到实例的 scope id\n    id: { type: String },\n    preset: { type: String as PropType<NotificationPreset> },\n    title: { type: String },\n    description: { type: String },\n    tone: { type: String as PropType<NotificationTone> },\n    loading: { type: Boolean, default: undefined },\n    duration: { type: Number },\n    closable: { type: Boolean, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    // 由宿主整摞一起按住计时；与指针、焦点那几路并存，最后一个松开才继续走\n    paused: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>> },\n  },\n  // status-change 携带 { id, status }，action 携带 { id }\n  emits: {\n    'status-change': (_details: PayloadOf<NotificationItemProps, 'onStatusChange'>) => true,\n    'action': (_details: PayloadOf<NotificationItemProps, 'onAction'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationItemSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useNotificationItem(\n      withXhConfig('notification', props) as NotificationItemProps,\n      details => emit('status-change', details),\n      details => emit('action', details),\n    )\n    provideNotificationItem(ctx)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps() as Record<string, unknown>, ref: ctx.rootRef },\n      slots.default?.({ item: ctx.api.value }),\n    )\n  },\n})\n\n/** 语气指示符。作者未写内容时由皮肤按 data-tone 绘制兜底字形，data-loading 时换为加载环。 */\nexport const XhNotificationItemIndicator = defineComponent({\n  name: 'XhNotificationItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标题与说明的文本列。 */\nexport const XhNotificationItemContent = defineComponent({\n  name: 'XhNotificationItemContent',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('div', ctx.api.value.getItemContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemTitle = defineComponent({\n  name: 'XhNotificationItemTitle',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    // 作者没写内容就用队列里那条记录的标题\n    return () => h(\n      'div',\n      ctx.api.value.getItemTitleProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.title,\n    )\n  },\n})\n\nexport const XhNotificationItemDescription = defineComponent({\n  name: 'XhNotificationItemDescription',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemDescriptionProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.description,\n    )\n  },\n})\n\nexport const XhNotificationItemActionTrigger = defineComponent({\n  name: 'XhNotificationItemActionTrigger',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    // 原生 <button>，激活行为交给平台\n    return () => h('button', ctx.api.value.getItemActionTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemProgress = defineComponent({\n  name: 'XhNotificationItemProgress',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('div', ctx.api.value.getItemProgressProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemCloseTrigger = defineComponent({\n  name: 'XhNotificationItemCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('button', ctx.api.value.getItemCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"notification.js","names":[],"sources":["../../../src/components/notification/notification.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// 提供 notification 相关实现。\n\nimport type {\n  NotificationDedupe,\n  NotificationItemApi,\n  NotificationItemSchema,\n  NotificationOptions,\n  NotificationPlacement,\n  NotificationPreset,\n  NotificationRecord,\n  NotificationSchema,\n  NotificationTone,\n  NotificationTranslations,\n  ResolvedNotification,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, Fragment, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useDescriptionPart, useTitleDescriptionPart } from '../../runtime/title-description'\nimport { provideNotification, provideNotificationItem, useNotificationContext, useNotificationItemContext } from './context'\nimport { useNotification, useNotificationItem } from './use-notification'\n\ntype NotificationProps = NotificationSchema['props']\ntype NotificationItemProps = NotificationItemSchema['props']\n\n/** 默认插槽的载荷：当前可见的通知队列与它的落位分组，以及入队、改写、关闭的命令。 */\nexport interface NotificationRootSlotProps {\n  items: ResolvedNotification[]\n  placements: NotificationPlacement[]\n  count: number\n  getItemsByPlacement: (placement: NotificationPlacement) => ResolvedNotification[]\n  create: (options?: NotificationOptions) => string\n  update: (id: string, options: Partial<NotificationOptions>) => void\n  dismiss: (id: string) => void\n  dismissAll: () => void\n}\n\nexport const XhNotificationRoot = defineComponent({\n  name: 'XhNotificationRoot',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    items: { type: Array as PropType<NotificationRecord[]> },\n    defaultItems: { type: Array as PropType<NotificationRecord[]> },\n    preset: { type: String as PropType<NotificationPreset> },\n    placement: { type: String as PropType<NotificationPlacement> },\n    max: { type: Number },\n    dedupe: { type: String as PropType<NotificationDedupe> },\n    gap: { type: Number },\n    duration: { type: Number },\n    stacked: { type: Boolean, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>> },\n  },\n  // items-change 携带 { items }，update:items 携带裸队列以支持 v-model:items\n  emits: {\n    'items-change': (_details: PayloadOf<NotificationProps, 'onItemsChange'>) => true,\n    'update:items': (_items: PayloadOf<NotificationProps, 'onItemsChange'>['items']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NotificationProps['onItemsChange'] = (details) => {\n      emit('items-change', details)\n      emit('update:items', details.items)\n    }\n    const ctx = useNotification(withXhConfig('notification', props) as NotificationProps, notify)\n    provideNotification(ctx)\n    // 根节点是地标容器，插槽作用域里一并暴露队列与增删改命令\n    return () => h('div', { ...ctx.api.value.getRootProps() as Record<string, unknown>, ref: ctx.rootRef }, slots.default?.({\n      items: ctx.api.value.visibleNotifications,\n      placements: ctx.api.value.placements,\n      count: ctx.api.value.count,\n      getItemsByPlacement: ctx.api.value.getItemsByPlacement,\n      create: ctx.create,\n      update: ctx.update,\n      dismiss: ctx.dismiss,\n      dismissAll: ctx.dismissAll,\n    }))\n  },\n})\n\n/** 默认插槽的载荷：该组中逐条铺开的通知。 */\nexport interface NotificationGroupSlotProps {\n  item: ResolvedNotification\n}\n\nexport const XhNotificationGroup = defineComponent({\n  name: 'XhNotificationGroup',\n  props: {\n    // 不写就用 notification 的 placement；写了就只收这个位置上的条目\n    placement: { type: String as PropType<NotificationPlacement> },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationGroupSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useNotificationContext()\n    return () => {\n      const api = ctx.api.value\n      const groupProps = api.getGroupProps({ placement: props.placement }) as Record<string, unknown>\n      // 落位从 group 自己的产出里读回，不在这边重算缺省\n      const placement = groupProps['data-placement'] as NotificationPlacement\n      const list = api.getItemsByPlacement(placement)\n      // 每条通知按队列身份 id 给 key，避免节点被就地复用\n      return h(\n        'div',\n        groupProps,\n        slots.default ? list.map(item => h(Fragment, { key: item.id }, slots.default!({ item }))) : undefined,\n      )\n    }\n  },\n})\n\n/** 默认插槽的载荷：该卡片自己的 api。 */\nexport interface NotificationItemSlotProps {\n  item: NotificationItemApi\n}\n\n/** 单条卡片：到期自行消失的一条消息，计时、暂停、按压与退场都在它自己身上。 */\nexport const XhNotificationItem = defineComponent({\n  name: 'XhNotificationItem',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    // 队列身份，不是 DOM id；不给则回落到实例的 scope id\n    id: { type: String },\n    preset: { type: String as PropType<NotificationPreset> },\n    title: { type: String },\n    description: { type: String },\n    tone: { type: String as PropType<NotificationTone> },\n    loading: { type: Boolean, default: undefined },\n    duration: { type: Number },\n    closable: { type: Boolean, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    // 由宿主整摞一起按住计时；与指针、焦点那几路并存，最后一个松开才继续走\n    paused: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>> },\n  },\n  // status-change 携带 { id, status }，action 携带 { id }\n  emits: {\n    'status-change': (_details: PayloadOf<NotificationItemProps, 'onStatusChange'>) => true,\n    'action': (_details: PayloadOf<NotificationItemProps, 'onAction'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationItemSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useNotificationItem(\n      withXhConfig('notification', props) as NotificationItemProps,\n      details => emit('status-change', details),\n      details => emit('action', details),\n    )\n    provideNotificationItem(ctx)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemProps() as Record<string, unknown>, ref: ctx.rootRef },\n      slots.default?.({ item: ctx.api.value }),\n    )\n  },\n})\n\n/** 语气指示符。作者未写内容时由皮肤按 data-tone 绘制兜底字形，data-loading 时换为加载环。 */\nexport const XhNotificationItemIndicator = defineComponent({\n  name: 'XhNotificationItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标题与说明的文本列。 */\nexport const XhNotificationItemContent = defineComponent({\n  name: 'XhNotificationItemContent',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('div', ctx.api.value.getItemContentProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemTitle = defineComponent({\n  name: 'XhNotificationItemTitle',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    useTitleDescriptionPart(ctx.presence, 'title')\n    // 作者没写内容就用队列里那条记录的标题\n    return () => h(\n      'div',\n      ctx.api.value.getItemTitleProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.title,\n    )\n  },\n})\n\nexport const XhNotificationItemDescription = defineComponent({\n  name: 'XhNotificationItemDescription',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    // 读不出一句话的说明不进描述链：记录没写 description 时它是空的\n    const el = useDescriptionPart(ctx.presence)\n    return () => h(\n      'div',\n      { ...ctx.api.value.getItemDescriptionProps() as Record<string, unknown>, ref: el },\n      slots.default?.() ?? ctx.api.value.description,\n    )\n  },\n})\n\nexport const XhNotificationItemActionTrigger = defineComponent({\n  name: 'XhNotificationItemActionTrigger',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    // 原生 <button>，激活行为交给平台\n    return () => h('button', ctx.api.value.getItemActionTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemProgress = defineComponent({\n  name: 'XhNotificationItemProgress',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('div', ctx.api.value.getItemProgressProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemCloseTrigger = defineComponent({\n  name: 'XhNotificationItemCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('button', ctx.api.value.getItemCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { NotificationContext, NotificationItemContext } from "./context.js";
-import { MaybeRefOrGetter } from "vue";
 import { NotificationItemSchema, NotificationSchema } from "@xihan-ui/headless";
+import { MaybeRefOrGetter } from "vue";
 //#region src/components/notification/use-notification.d.ts
 /** props 接收 ref/getter 时每帧现取，文案等值可以在运行期更换。 */
 declare function useNotification(props: MaybeRefOrGetter<NotificationSchema['props']>, onItemsChange?: NotificationSchema['props']['onItemsChange']): NotificationContext;

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

@@ -1 +1 @@
-{"version":3,"file":"use-notification.d.ts","names":[],"sources":["../../../src/components/notification/use-notification.ts"],"mappings":";;;;;iBAkBgB,gBACd,OAAO,iBAAiB,8BACxB,gBAAgB,+CACf;;;;;iBAqBa,oBACd,OAAO,iCACP,iBAAiB,mDACjB,WAAW,8CACV"}
+{"version":3,"file":"use-notification.d.ts","names":[],"sources":["../../../src/components/notification/use-notification.ts"],"mappings":";;;;;iBAmBgB,gBACd,OAAO,iBAAiB,8BACxB,gBAAgB,+CACf;;;;;iBAqBa,oBACd,OAAO,iCACP,iBAAiB,mDACjB,WAAW,8CACV"}

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

@@ -1,9 +1,10 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
+import { useTitleDescriptionPresence } from "../../runtime/title-description.js";
 import { useNotificationContextOptional } from "./context.js";
 import { useNotificationItemExit } from "./use-item-exit.js";
-import { computed, ref, toValue } from "vue";
 import { connectNotification, connectNotificationItem, notificationItemMachine, notificationMachine } from "@xihan-ui/headless";
+import { computed, ref, toValue } from "vue";
 //#region src/components/notification/use-notification.ts
 /** props 接收 ref/getter 时每帧现取，文案等值可以在运行期更换。 */
 function useNotification(props, onItemsChange) {
@@ -33,8 +34,10 @@ function useNotificationItem(props, onStatusChange, onAction) {
 		onStatusChange?.(details);
 		if (details.status === "unmounted") queue?.dismiss(details.id);
 	};
+	const presence = useTitleDescriptionPresence();
 	const service = useMachine(notificationItemMachine, () => ({
 		...props,
+		parts: presence.parts.value,
 		onStatusChange: notifyStatus,
 		onAction
 	}));
@@ -48,7 +51,8 @@ function useNotificationItem(props, onStatusChange, onAction) {
 	});
 	return {
 		api,
-		rootRef
+		rootRef,
+		presence
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-notification.js","names":[],"sources":["../../../src/components/notification/use-notification.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 notification 相关实现。\n\nimport type { NotificationItemSchema, NotificationSchema } from '@xihan-ui/headless'\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { NotificationContext, NotificationItemContext } from './context'\nimport { connectNotification, connectNotificationItem, notificationItemMachine, notificationMachine } from '@xihan-ui/headless'\nimport { computed, ref, toValue } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useNotificationContextOptional } from './context'\nimport { useNotificationItemExit } from './use-item-exit'\n\n/** props 接收 ref/getter 时每帧现取，文案等值可以在运行期更换。 */\nexport function useNotification(\n  props: MaybeRefOrGetter<NotificationSchema['props']>,\n  onItemsChange?: NotificationSchema['props']['onItemsChange'],\n): NotificationContext {\n  const service = useMachine(notificationMachine, () => ({ ...toValue(props), onItemsChange }))\n  const api = computed(() => connectNotification(service, vueNormalize))\n  const rootRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getRootEl', () => rootRef.value)\n  // 四个命令在顶层摊平，函数身份稳定，可解构后随时调用且不读取队列\n  return {\n    api,\n    rootRef,\n    create: options => api.value.create(options),\n    update: (id, options) => api.value.update(id, options),\n    dismiss: id => api.value.dismiss(id),\n    dismissAll: () => api.value.dismissAll(),\n  }\n}\n\n/**\n * 单条卡片：计时、暂停、按压与退场都在它自己的机器上。\n * 退场完成后由这里通知队列删除记录：队列在外层，卡片自身不知道它。\n */\nexport function useNotificationItem(\n  props: NotificationItemSchema['props'],\n  onStatusChange?: NotificationItemSchema['props']['onStatusChange'],\n  onAction?: NotificationItemSchema['props']['onAction'],\n): NotificationItemContext {\n  const queue = useNotificationContextOptional()\n  const notifyStatus: NotificationItemSchema['props']['onStatusChange'] = (details) => {\n    onStatusChange?.(details)\n    if (details.status === 'unmounted')\n      queue?.dismiss(details.id)\n  }\n  const service = useMachine(notificationItemMachine, () => ({ ...props, onStatusChange: notifyStatus, onAction }))\n  const api = computed(() => connectNotificationItem(service, vueNormalize))\n  const rootRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值；叠摞展开的追踪从它找所在的那一摞\n  service.refs.set('getRootEl', () => rootRef.value)\n  useNotificationItemExit({ service, isOpen: () => api.value.status === 'visible', rootRef })\n  return { api, rootRef }\n}\n"],"mappings":";;;;;;;;AAkBA,SAAgB,gBACd,OACA,eACqB;CACrB,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG,QAAQ,KAAK;EAAG;CAAc,EAAE;CAC5F,MAAM,MAAM,eAAe,oBAAoB,SAAS,YAAY,CAAC;CACrE,MAAM,UAAU,IAAwB,IAAI;CAE5C,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAEjD,OAAO;EACL;EACA;EACA,SAAQ,YAAW,IAAI,MAAM,OAAO,OAAO;EAC3C,SAAS,IAAI,YAAY,IAAI,MAAM,OAAO,IAAI,OAAO;EACrD,UAAS,OAAM,IAAI,MAAM,QAAQ,EAAE;EACnC,kBAAkB,IAAI,MAAM,WAAW;CACzC;AACF;;;;;AAMA,SAAgB,oBACd,OACA,gBACA,UACyB;CACzB,MAAM,QAAQ,+BAA+B;CAC7C,MAAM,gBAAmE,YAAY;EACnF,iBAAiB,OAAO;EACxB,IAAI,QAAQ,WAAW,aACrB,OAAO,QAAQ,QAAQ,EAAE;CAC7B;CACA,MAAM,UAAU,WAAW,gCAAgC;EAAE,GAAG;EAAO,gBAAgB;EAAc;CAAS,EAAE;CAChH,MAAM,MAAM,eAAe,wBAAwB,SAAS,YAAY,CAAC;CACzE,MAAM,UAAU,IAAwB,IAAI;CAE5C,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,wBAAwB;EAAE;EAAS,cAAc,IAAI,MAAM,WAAW;EAAW;CAAQ,CAAC;CAC1F,OAAO;EAAE;EAAK;CAAQ;AACxB"}
+{"version":3,"file":"use-notification.js","names":[],"sources":["../../../src/components/notification/use-notification.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 notification 相关实现。\n\nimport type { NotificationItemSchema, NotificationSchema } from '@xihan-ui/headless'\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { NotificationContext, NotificationItemContext } from './context'\nimport { connectNotification, connectNotificationItem, notificationItemMachine, notificationMachine } from '@xihan-ui/headless'\nimport { computed, ref, toValue } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useTitleDescriptionPresence } from '../../runtime/title-description'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useNotificationContextOptional } from './context'\nimport { useNotificationItemExit } from './use-item-exit'\n\n/** props 接收 ref/getter 时每帧现取，文案等值可以在运行期更换。 */\nexport function useNotification(\n  props: MaybeRefOrGetter<NotificationSchema['props']>,\n  onItemsChange?: NotificationSchema['props']['onItemsChange'],\n): NotificationContext {\n  const service = useMachine(notificationMachine, () => ({ ...toValue(props), onItemsChange }))\n  const api = computed(() => connectNotification(service, vueNormalize))\n  const rootRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getRootEl', () => rootRef.value)\n  // 四个命令在顶层摊平，函数身份稳定，可解构后随时调用且不读取队列\n  return {\n    api,\n    rootRef,\n    create: options => api.value.create(options),\n    update: (id, options) => api.value.update(id, options),\n    dismiss: id => api.value.dismiss(id),\n    dismissAll: () => api.value.dismissAll(),\n  }\n}\n\n/**\n * 单条卡片：计时、暂停、按压与退场都在它自己的机器上。\n * 退场完成后由这里通知队列删除记录：队列在外层，卡片自身不知道它。\n */\nexport function useNotificationItem(\n  props: NotificationItemSchema['props'],\n  onStatusChange?: NotificationItemSchema['props']['onStatusChange'],\n  onAction?: NotificationItemSchema['props']['onAction'],\n): NotificationItemContext {\n  const queue = useNotificationContextOptional()\n  const notifyStatus: NotificationItemSchema['props']['onStatusChange'] = (details) => {\n    onStatusChange?.(details)\n    if (details.status === 'unmounted')\n      queue?.dismiss(details.id)\n  }\n  const presence = useTitleDescriptionPresence()\n  const service = useMachine(notificationItemMachine, () => ({ ...props, parts: presence.parts.value, onStatusChange: notifyStatus, onAction }))\n  const api = computed(() => connectNotificationItem(service, vueNormalize))\n  const rootRef = ref<HTMLElement | null>(null)\n  // 传 getter 而非节点本身，ref 在挂载后才有值；叠摞展开的追踪从它找所在的那一摞\n  service.refs.set('getRootEl', () => rootRef.value)\n  useNotificationItemExit({ service, isOpen: () => api.value.status === 'visible', rootRef })\n  return { api, rootRef, presence }\n}\n"],"mappings":";;;;;;;;;AAmBA,SAAgB,gBACd,OACA,eACqB;CACrB,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG,QAAQ,KAAK;EAAG;CAAc,EAAE;CAC5F,MAAM,MAAM,eAAe,oBAAoB,SAAS,YAAY,CAAC;CACrE,MAAM,UAAU,IAAwB,IAAI;CAE5C,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAEjD,OAAO;EACL;EACA;EACA,SAAQ,YAAW,IAAI,MAAM,OAAO,OAAO;EAC3C,SAAS,IAAI,YAAY,IAAI,MAAM,OAAO,IAAI,OAAO;EACrD,UAAS,OAAM,IAAI,MAAM,QAAQ,EAAE;EACnC,kBAAkB,IAAI,MAAM,WAAW;CACzC;AACF;;;;;AAMA,SAAgB,oBACd,OACA,gBACA,UACyB;CACzB,MAAM,QAAQ,+BAA+B;CAC7C,MAAM,gBAAmE,YAAY;EACnF,iBAAiB,OAAO;EACxB,IAAI,QAAQ,WAAW,aACrB,OAAO,QAAQ,QAAQ,EAAE;CAC7B;CACA,MAAM,WAAW,4BAA4B;CAC7C,MAAM,UAAU,WAAW,gCAAgC;EAAE,GAAG;EAAO,OAAO,SAAS,MAAM;EAAO,gBAAgB;EAAc;CAAS,EAAE;CAC7I,MAAM,MAAM,eAAe,wBAAwB,SAAS,YAAY,CAAC;CACzE,MAAM,UAAU,IAAwB,IAAI;CAE5C,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,wBAAwB;EAAE;EAAS,cAAc,IAAI,MAAM,WAAW;EAAW;CAAQ,CAAC;CAC1F,OAAO;EAAE;EAAK;EAAS;CAAS;AAClC"}

package/dist/components/number-animation/number-animation.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { NumberAnimationApi, NumberAnimationCompleteDetails, NumberAnimationEasing, NumberAnimationFormatOptions, NumberAnimationLive, NumberAnimationSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Size, Tone } from "@xihan-ui/core";
-import { NumberAnimationApi, NumberAnimationCompleteDetails, NumberAnimationEasing, NumberAnimationFormatOptions, NumberAnimationLive, NumberAnimationSchema } from "@xihan-ui/headless";
 //#region src/components/number-animation/number-animation.d.ts
 type NumberAnimationProps = NumberAnimationSchema['props'];
 /** 默认插槽的载荷：当前帧的数值，以及它按 locale、precision、separator 与 formatOptions 格式化后的文本。 */

package/dist/components/number-animation/number-animation.js

@@ -2,9 +2,9 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { slotPaints } from "../../runtime/slot-content.js";
+import { connectNumberAnimation, numberAnimationMachine } from "@xihan-ui/headless";
 import { computed, defineComponent, h } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectNumberAnimation, numberAnimationMachine } from "@xihan-ui/headless";
 //#region src/components/number-animation/number-animation.ts
 /**
 * 一段自动变化的数字：从 from 补间到 to，逐帧计算值，格式化后写入根中。

package/dist/components/number-field/number-field.d.ts

@@ -1,12 +1,20 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { NumberFieldApi, NumberFieldSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { NumberFieldApi, NumberFieldSchema } from "@xihan-ui/headless";
 //#region src/components/number-field/number-field.d.ts
 type NumberFieldProps = NumberFieldSchema['props'];
 /** 默认插槽的载荷：原始输入串与其数值、增减是否仍可进行，以及写值、增减的命令。 */
 type NumberFieldRootSlotProps = Pick<NumberFieldApi, 'value' | 'valueAsNumber' | 'empty' | 'canIncrement' | 'canDecrement' | 'outOfRange' | 'setValue' | 'increment' | 'decrement'>;
 declare const XhNumberFieldRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };
@@ -44,6 +52,9 @@ declare const XhNumberFieldRoot: import("vue").DefineComponent<import("vue").Ext
   name: {
     type: StringConstructor;
   };
+  placeholder: {
+    type: StringConstructor;
+  };
   changeDelay: {
     type: NumberConstructor;
   };
@@ -78,6 +89,14 @@ declare const XhNumberFieldRoot: import("vue").DefineComponent<import("vue").Ext
   'value-change': (_details: PayloadOf<NumberFieldProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<NumberFieldProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };
@@ -115,6 +134,9 @@ declare const XhNumberFieldRoot: import("vue").DefineComponent<import("vue").Ext
   name: {
     type: StringConstructor;
   };
+  placeholder: {
+    type: StringConstructor;
+  };
   changeDelay: {
     type: NumberConstructor;
   };
@@ -154,6 +176,7 @@ declare const XhNumberFieldRoot: import("vue").DefineComponent<import("vue").Ext
   clampValueOnBlur: boolean;
 }, SlotsType<{
   default?: (props: NumberFieldRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhNumberFieldLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/number-field/number-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number-field.d.ts","names":[],"sources":["../../../src/components/number-field/number-field.ts"],"mappings":";;;;;KAiBK,mBAAmB;;KAGZ,2BAA2B,KACrC;cAIW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;EAIV,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;;;;;;EAQ3B,WAAC,OAAO,6BAA6B;kCAqBjD;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAU7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"number-field.d.ts","names":[],"sources":["../../../src/components/number-field/number-field.ts"],"mappings":";;;;;KAmBK,mBAAmB;;KAGZ,2BAA2B,KACrC;cAIW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwBC,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;EAIV,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;IACR,MAAA,SAAS;;;;;;;;;;;;EAQ3B,WAAC,OAAO,6BAA6B;EACvC,cAAM;kCA0BhB;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAW7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAU7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/number-field/number-field.js

@@ -1,12 +1,18 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideNumberField, useNumberFieldContext } from "./context.js";
 import { useNumberField } from "./use-number-field.js";
-import { defineComponent, h } from "vue";
+import { numberFieldStructure } from "@xihan-ui/headless";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/number-field/number-field.ts
 const XhNumberFieldRoot = defineComponent({
 	name: "XhNumberFieldRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
 		value: { type: String },
 		defaultValue: { type: String },
 		min: { type: Number },
@@ -30,6 +36,7 @@ const XhNumberFieldRoot = defineComponent({
 			default: void 0
 		},
 		name: { type: String },
+		placeholder: { type: String },
 		changeDelay: { type: Number },
 		changeInterval: { type: Number },
 		minChangeInterval: { type: Number },
@@ -55,23 +62,30 @@ const XhNumberFieldRoot = defineComponent({
 		};
 		const ctx = useNumberField(useFormControlProps(props), notify);
 		provideNumberField(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
-			value: ctx.api.value.value,
-			valueAsNumber: ctx.api.value.valueAsNumber,
-			empty: ctx.api.value.empty,
-			canIncrement: ctx.api.value.canIncrement,
-			canDecrement: ctx.api.value.canDecrement,
-			outOfRange: ctx.api.value.outOfRange,
-			setValue: ctx.api.value.setValue,
-			increment: ctx.api.value.increment,
-			decrement: ctx.api.value.decrement
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				value: api.value,
+				valueAsNumber: api.valueAsNumber,
+				empty: api.empty,
+				canIncrement: api.canIncrement,
+				canDecrement: api.canDecrement,
+				outOfRange: api.outOfRange,
+				setValue: api.setValue,
+				increment: api.increment,
+				decrement: api.decrement
+			}) : renderDefaultStructure(props.label, slots.label));
+		};
 	}
 });
 const XhNumberFieldLabel = defineComponent({
 	name: "XhNumberFieldLabel",
 	setup(_, { slots }) {
 		const ctx = useNumberFieldContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -122,6 +136,24 @@ const XhNumberFieldDecrementTrigger = defineComponent({
 		return () => h("button", ctx.api.value.getDecrementTriggerProps(), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const NUMBER_FIELD_PARTS = {
+	"label": XhNumberFieldLabel,
+	"control": XhNumberFieldControl,
+	"decrement-trigger": XhNumberFieldDecrementTrigger,
+	"input": XhNumberFieldInput,
+	"increment-trigger": XhNumberFieldIncrementTrigger
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 numberFieldStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(label, labelSlot) {
+	return renderStructure(numberFieldStructure({
+		label,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), NUMBER_FIELD_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhNumberFieldControl, XhNumberFieldDecrementTrigger, XhNumberFieldIncrementTrigger, XhNumberFieldInput, XhNumberFieldLabel, XhNumberFieldPrefix, XhNumberFieldRoot, XhNumberFieldSuffix };
 

package/dist/components/number-field/number-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"number-field.js","names":[],"sources":["../../../src/components/number-field/number-field.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// 提供 number field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { NumberFieldApi, NumberFieldSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideNumberField, useNumberFieldContext } from './context'\nimport { useNumberField } from './use-number-field'\n\ntype NumberFieldProps = NumberFieldSchema['props']\n\n/** 默认插槽的载荷：原始输入串与其数值、增减是否仍可进行，以及写值、增减的命令。 */\nexport type NumberFieldRootSlotProps = Pick<\n  NumberFieldApi,\n  'value' | 'valueAsNumber' | 'empty' | 'canIncrement' | 'canDecrement' | 'outOfRange' | 'setValue' | 'increment' | 'decrement'\n>\n\nexport const XhNumberFieldRoot = defineComponent({\n  name: 'XhNumberFieldRoot',\n  props: {\n    // 值是原始输入串；缺席值 undefined 表示非受控\n    value: { type: String },\n    defaultValue: { type: String },\n    min: { type: Number },\n    max: { type: Number },\n    step: { type: Number },\n    largeStep: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    changeDelay: { type: Number },\n    changeInterval: { type: Number },\n    minChangeInterval: { type: Number },\n    clampValueOnBlur: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    parse: { type: Function as PropType<NumberFieldProps['parse']> },\n    format: { type: Function as PropType<NumberFieldProps['format']> },\n  },\n  // value-change 携带 { value, valueAsNumber }，update:value 携带裸串\n  emits: {\n    'value-change': (_details: PayloadOf<NumberFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<NumberFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NumberFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NumberFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useNumberField(useFormControlProps(props) as NumberFieldProps, notify)\n    provideNumberField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      valueAsNumber: ctx.api.value.valueAsNumber,\n      empty: ctx.api.value.empty,\n      canIncrement: ctx.api.value.canIncrement,\n      canDecrement: ctx.api.value.canDecrement,\n      outOfRange: ctx.api.value.outOfRange,\n      setValue: ctx.api.value.setValue,\n      increment: ctx.api.value.increment,\n      decrement: ctx.api.value.decrement,\n    }))\n  },\n})\n\nexport const XhNumberFieldLabel = defineComponent({\n  name: 'XhNumberFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldControl = defineComponent({\n  name: 'XhNumberFieldControl',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    // 视觉盒：输入框与加减钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldPrefix = defineComponent({\n  name: 'XhNumberFieldPrefix',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('span', ctx.api.value.getPrefixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldSuffix = defineComponent({\n  name: 'XhNumberFieldSuffix',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('span', ctx.api.value.getSuffixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldInput = defineComponent({\n  name: 'XhNumberFieldInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useNumberFieldContext()\n    return () => h('input', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getInputProps() as Record<string, unknown> }))\n  },\n})\n\nexport const XhNumberFieldIncrementTrigger = defineComponent({\n  name: 'XhNumberFieldIncrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getIncrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldDecrementTrigger = defineComponent({\n  name: 'XhNumberFieldDecrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getDecrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"number-field.js","names":[],"sources":["../../../src/components/number-field/number-field.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// 提供 number field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { NumberFieldApi, NumberFieldSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { numberFieldStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideNumberField, useNumberFieldContext } from './context'\nimport { useNumberField } from './use-number-field'\n\ntype NumberFieldProps = NumberFieldSchema['props']\n\n/** 默认插槽的载荷：原始输入串与其数值、增减是否仍可进行，以及写值、增减的命令。 */\nexport type NumberFieldRootSlotProps = Pick<\n  NumberFieldApi,\n  'value' | 'valueAsNumber' | 'empty' | 'canIncrement' | 'canDecrement' | 'outOfRange' | 'setValue' | 'increment' | 'decrement'\n>\n\nexport const XhNumberFieldRoot = defineComponent({\n  name: 'XhNumberFieldRoot',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    // 值是原始输入串；缺席值 undefined 表示非受控\n    value: { type: String },\n    defaultValue: { type: String },\n    min: { type: Number },\n    max: { type: Number },\n    step: { type: Number },\n    largeStep: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    placeholder: { type: String },\n    changeDelay: { type: Number },\n    changeInterval: { type: Number },\n    minChangeInterval: { type: Number },\n    clampValueOnBlur: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    parse: { type: Function as PropType<NumberFieldProps['parse']> },\n    format: { type: Function as PropType<NumberFieldProps['format']> },\n  },\n  // value-change 携带 { value, valueAsNumber }，update:value 携带裸串\n  emits: {\n    'value-change': (_details: PayloadOf<NumberFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<NumberFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NumberFieldRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NumberFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useNumberField(useFormControlProps(props) as NumberFieldProps, notify)\n    provideNumberField(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getRootProps() as Record<string, unknown>, slots.default\n        ? slots.default({\n            value: api.value,\n            valueAsNumber: api.valueAsNumber,\n            empty: api.empty,\n            canIncrement: api.canIncrement,\n            canDecrement: api.canDecrement,\n            outOfRange: api.outOfRange,\n            setValue: api.setValue,\n            increment: api.increment,\n            decrement: api.decrement,\n          })\n        : renderDefaultStructure(props.label, slots.label))\n    }\n  },\n})\n\nexport const XhNumberFieldLabel = defineComponent({\n  name: 'XhNumberFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldControl = defineComponent({\n  name: 'XhNumberFieldControl',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    // 视觉盒：输入框与加减钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldPrefix = defineComponent({\n  name: 'XhNumberFieldPrefix',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('span', ctx.api.value.getPrefixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldSuffix = defineComponent({\n  name: 'XhNumberFieldSuffix',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('span', ctx.api.value.getSuffixProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldInput = defineComponent({\n  name: 'XhNumberFieldInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useNumberFieldContext()\n    return () => h('input', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getInputProps() as Record<string, unknown> }))\n  },\n})\n\nexport const XhNumberFieldIncrementTrigger = defineComponent({\n  name: 'XhNumberFieldIncrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getIncrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldDecrementTrigger = defineComponent({\n  name: 'XhNumberFieldDecrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getDecrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst NUMBER_FIELD_PARTS = {\n  'label': XhNumberFieldLabel,\n  'control': XhNumberFieldControl,\n  'decrement-trigger': XhNumberFieldDecrementTrigger,\n  'input': XhNumberFieldInput,\n  'increment-trigger': XhNumberFieldIncrementTrigger,\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 numberFieldStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(label: string | undefined, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = numberFieldStructure({ label, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(nodes, NUMBER_FIELD_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

package/dist/components/number-field/use-number-field.d.ts

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { NumberFieldApi, NumberFieldSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/number-field/use-number-field.d.ts
 interface NumberFieldContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhNumberFieldLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<NumberFieldApi>;
 }
 declare function useNumberField(props: NumberFieldSchema['props'], onValueChange?: NumberFieldSchema['props']['onValueChange']): NumberFieldContext;

package/dist/components/number-field/use-number-field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-number-field.d.ts","names":[],"sources":["../../../src/components/number-field/use-number-field.ts"],"mappings":";;;UAciB;EACf,KAAK,YAAY;;iBAGH,eACd,OAAO,4BACP,gBAAgB,8CACf"}
+{"version":3,"file":"use-number-field.d.ts","names":[],"sources":["../../../src/components/number-field/use-number-field.ts"],"mappings":";;;UAciB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,eACd,OAAO,4BACP,gBAAgB,8CACf"}

package/dist/components/number-field/use-number-field.js

@@ -1,14 +1,19 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { connectNumberField, numberFieldMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/number-field/use-number-field.ts
 function useNumberField(props, onValueChange) {
+	const labelCount = ref(0);
 	const service = useMachine(numberFieldMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onValueChange
 	}));
-	return { api: computed(() => connectNumberField(service, vueNormalize)) };
+	return {
+		labelCount,
+		api: computed(() => connectNumberField(service, vueNormalize))
+	};
 }
 //#endregion
 export { useNumberField };

package/dist/components/number-field/use-number-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-number-field.js","names":[],"sources":["../../../src/components/number-field/use-number-field.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 number field 相关实现。\n\nimport type { NumberFieldApi, NumberFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectNumberField, numberFieldMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface NumberFieldContext {\n  api: ComputedRef<NumberFieldApi>\n}\n\nexport function useNumberField(\n  props: NumberFieldSchema['props'],\n  onValueChange?: NumberFieldSchema['props']['onValueChange'],\n): NumberFieldContext {\n  const service = useMachine(numberFieldMachine, () => ({ ...props, onValueChange }))\n  const api = computed(() => connectNumberField(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAkBA,SAAgB,eACd,OACA,eACoB;CACpB,MAAM,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO;CAAc,EAAE;CAElF,OAAO,EAAE,KADG,eAAe,mBAAmB,SAAS,YAAY,CACxD,EAAE;AACf"}
+{"version":3,"file":"use-number-field.js","names":[],"sources":["../../../src/components/number-field/use-number-field.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 number field 相关实现。\n\nimport type { NumberFieldApi, NumberFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectNumberField, numberFieldMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface NumberFieldContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhNumberFieldLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<NumberFieldApi>\n}\n\nexport function useNumberField(\n  props: NumberFieldSchema['props'],\n  onValueChange?: NumberFieldSchema['props']['onValueChange'],\n): NumberFieldContext {\n  const labelCount = ref(0)\n  const service = useMachine(numberFieldMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange }))\n  const api = computed(() => connectNumberField(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;AAuBA,SAAgB,eACd,OACA,eACoB;CACpB,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;CAAc,EAAE;CAElH,OAAO;EAAE;EAAY,KADT,eAAe,mBAAmB,SAAS,YAAY,CAC5C;CAAE;AAC3B"}

package/dist/components/page-header/context.d.ts

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

package/dist/components/page-header/page-header.js

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { providePageHeader, usePageHeaderContext } from "./context.js";
-import { computed, defineComponent, h } from "vue";
 import { connectPageHeader } from "@xihan-ui/headless";
+import { computed, defineComponent, h } from "vue";
 //#region src/components/page-header/page-header.ts
 /** 根节点渲染为 div，默认值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined */
 const XhPageHeaderRoot = defineComponent({

package/dist/components/pagination/pagination.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { PaginationApi, PaginationEllipsisSide, PaginationPageSizeChangeDetails, PaginationSchema, PaginationTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Placement, Size, Tone } from "@xihan-ui/core";
-import { PaginationApi, PaginationEllipsisSide, PaginationPageSizeChangeDetails, PaginationSchema, PaginationTranslations } from "@xihan-ui/headless";
 //#region src/components/pagination/pagination.d.ts
 type PaginationProps = PaginationSchema['props'];
 /** 默认插槽的载荷：当前页与总量口径、页码序列与条目区间、前后页页码，以及翻页与按当前页切分数据的动作。 */

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

@@ -1,5 +1,5 @@
-import { ComputedRef, Ref } from "vue";
 import { PaginationApi, PaginationSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/pagination/use-pagination.d.ts
 interface PaginationContext {
   api: ComputedRef<PaginationApi>;

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

@@ -3,9 +3,9 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectPagination, paginationMachine, paginationPageSizeSelectProps, selectMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectPagination, paginationMachine, paginationPageSizeSelectProps, selectMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/pagination/use-pagination.ts
 function usePagination(props, onPageChange, onPageSizeChange) {

package/dist/components/password-input/password-input.d.ts

@@ -1,12 +1,20 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { PasswordInputApi, PasswordInputSchema, PasswordInputTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { PasswordInputApi, PasswordInputSchema, PasswordInputTranslations } from "@xihan-ui/headless";
 //#region src/components/password-input/password-input.d.ts
 type PasswordInputProps = PasswordInputSchema['props'];
 /** 默认插槽的载荷：当前值与空标志、明暗与大写锁定，以及写值与切换明暗的动作。 */
 type PasswordInputRootSlotProps = Pick<PasswordInputApi, 'value' | 'empty' | 'revealed' | 'capsLock' | 'inputType' | 'setValue' | 'setRevealed' | 'toggleRevealed'>;
 declare const XhPasswordInputRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };
@@ -69,6 +77,14 @@ declare const XhPasswordInputRoot: import("vue").DefineComponent<import("vue").E
   'revealed-change': (_details: PayloadOf<PasswordInputProps, "onRevealedChange">) => true;
   'update:revealed': (_revealed: PayloadOf<PasswordInputProps, "onRevealedChange">["revealed"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: StringConstructor;
   };
@@ -137,6 +153,8 @@ declare const XhPasswordInputRoot: import("vue").DefineComponent<import("vue").E
   defaultRevealed: boolean;
 }, SlotsType<{
   default?: (props: PasswordInputRootSlotProps) => VNode[];
+  /** 不写默认插槽时标题的内容，代替 label 文字。 */
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhPasswordInputLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/password-input/password-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"password-input.d.ts","names":[],"sources":["../../../src/components/password-input/password-input.ts"],"mappings":";;;;;KAkBK,qBAAqB;;KAGd,6BAA6B,KACvC;cAIW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBD,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACL,oBAAA,UAAA,UAAU;EACT,oBAAA,WAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAVd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EAUvC,WAAC,OAAO,+BAA+B;kCA2BnD;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAW/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gDAAgC,0BAAA,oBAAA,4BAAA;;8BAO3C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gDAAgC,0BAAA,oBAAA,4BAAA;;8BAO3C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,4CAA4B,0BAAA,oBAAA,4BAAA;;8BAMvC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"password-input.d.ts","names":[],"sources":["../../../src/components/password-input/password-input.ts"],"mappings":";;;;;KAoBK,qBAAqB;;KAGd,6BAA6B,KACvC;cAIW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoBD,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACL,oBAAA,UAAA,UAAU;EACT,oBAAA,WAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAVd,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EAUvC,WAAC,OAAO,+BAA+B;;EAEzC,cAAM;kCAgChB;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAe/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gDAAgC,0BAAA,oBAAA,4BAAA;;8BAO3C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gDAAgC,0BAAA,oBAAA,4BAAA;;8BAO3C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,4CAA4B,0BAAA,oBAAA,4BAAA;;8BAMvC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}