@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/components/notification/notification.js

@@ -6,42 +6,19 @@ import { Fragment, defineComponent, h } from "vue";
 const XhNotificationRoot = defineComponent({
 	name: "XhNotificationRoot",
 	props: {
-		items: {
-			type: Array,
-			default: void 0
-		},
-		defaultItems: {
-			type: Array,
-			default: void 0
-		},
-		placement: {
-			type: String,
-			default: void 0
-		},
-		max: {
-			type: Number,
-			default: void 0
-		},
-		gap: {
-			type: Number,
-			default: void 0
-		},
-		duration: {
-			type: Number,
-			default: void 0
-		},
-		removeDelay: {
-			type: Number,
-			default: void 0
-		},
+		items: { type: Array },
+		defaultItems: { type: Array },
+		placement: { type: String },
+		max: { type: Number },
+		dedupe: { type: String },
+		gap: { type: Number },
+		duration: { type: Number },
+		removeDelay: { type: Number },
 		pauseOnPageIdle: {
 			type: Boolean,
 			default: void 0
 		},
-		translations: {
-			type: Object,
-			default: void 0
-		}
+		translations: { type: Object }
 	},
 	emits: {
 		"items-change": (_details) => true,
@@ -69,10 +46,7 @@ const XhNotificationRoot = defineComponent({
 });
 const XhNotificationGroup = defineComponent({
 	name: "XhNotificationGroup",
-	props: { placement: {
-		type: String,
-		default: void 0
-	} },
+	props: { placement: { type: String } },
 	slots: Object,
 	setup(props, { slots }) {
 		const ctx = useNotificationContext();
@@ -85,34 +59,20 @@ const XhNotificationGroup = defineComponent({
 		};
 	}
 });
-/** 单条卡片。生命周期复用 toast 那台机器：会自己消失的卡片，这一行为与消息来源无关。 */
+/** 单条卡片。生命周期复用 toast 的状态机：会自动消失的卡片，该行为与消息来源无关。 */
 const XhNotificationItem = defineComponent({
 	name: "XhNotificationItem",
 	props: {
-		id: {
-			type: String,
-			default: void 0
-		},
-		title: {
-			type: String,
-			default: void 0
-		},
-		description: {
-			type: String,
-			default: void 0
-		},
-		type: {
-			type: String,
-			default: void 0
-		},
-		duration: {
-			type: Number,
-			default: void 0
-		},
-		removeDelay: {
-			type: Number,
+		id: { type: String },
+		title: { type: String },
+		description: { type: String },
+		tone: { type: String },
+		loading: {
+			type: Boolean,
 			default: void 0
 		},
+		duration: { type: Number },
+		removeDelay: { type: Number },
 		closable: {
 			type: Boolean,
 			default: void 0
@@ -121,10 +81,11 @@ const XhNotificationItem = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
-		translations: {
-			type: Object,
+		paused: {
+			type: Boolean,
 			default: void 0
-		}
+		},
+		translations: { type: Object }
 	},
 	emits: {
 		"status-change": (_details) => true,
@@ -137,7 +98,7 @@ const XhNotificationItem = defineComponent({
 		return () => h("div", ctx.api.value.getItemProps(), slots.default?.({ item: ctx.api.value }));
 	}
 });
-/** 类型指示符。作者不写内容时由皮肤按 data-type 画一枚兜底字形。 */
+/** 语气指示符。作者未写内容时由皮肤按 data-tone 绘制兜底字形，data-loading 时换为加载指示。 */
 const XhNotificationItemIndicator = defineComponent({
 	name: "XhNotificationItemIndicator",
 	setup(_, { slots }) {
@@ -166,6 +127,13 @@ const XhNotificationItemActionTrigger = defineComponent({
 		return () => h("button", ctx.api.value.getItemActionTriggerProps(), slots.default?.());
 	}
 });
+const XhNotificationItemProgress = defineComponent({
+	name: "XhNotificationItemProgress",
+	setup(_, { slots }) {
+		const ctx = useNotificationItemContext();
+		return () => h("div", ctx.api.value.getItemProgressProps(), slots.default?.());
+	}
+});
 const XhNotificationItemCloseTrigger = defineComponent({
 	name: "XhNotificationItemCloseTrigger",
 	setup(_, { slots }) {
@@ -174,6 +142,6 @@ const XhNotificationItemCloseTrigger = defineComponent({
 	}
 });
 //#endregion
-export { XhNotificationGroup, XhNotificationItem, XhNotificationItemActionTrigger, XhNotificationItemCloseTrigger, XhNotificationItemDescription, XhNotificationItemIndicator, XhNotificationItemTitle, XhNotificationRoot };
+export { XhNotificationGroup, XhNotificationItem, XhNotificationItemActionTrigger, XhNotificationItemCloseTrigger, XhNotificationItemDescription, XhNotificationItemIndicator, XhNotificationItemProgress, XhNotificationItemTitle, XhNotificationRoot };
 
 //# sourceMappingURL=notification.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"notification.js","names":[],"sources":["../../../src/components/notification/notification.ts"],"sourcesContent":["import type { NotificationItemApi, NotificationOptions, NotificationPlacement, NotificationRecord, NotificationSchema, NotificationTranslations, ResolvedNotification, ToastSchema, ToastType } 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']\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: undefined\n  props: {\n    items: { type: Array as PropType<NotificationRecord[]>, default: undefined },\n    defaultItems: { type: Array as PropType<NotificationRecord[]>, default: undefined },\n    placement: { type: String as PropType<NotificationPlacement>, default: undefined },\n    max: { type: Number, default: undefined },\n    gap: { type: Number, default: undefined },\n    duration: { type: Number, default: undefined },\n    removeDelay: { type: Number, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>>, default: undefined },\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>, 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>, default: undefined },\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/** 单条卡片。生命周期复用 toast 那台机器：会自己消失的卡片，这一行为与消息来源无关。 */\nexport const XhNotificationItem = defineComponent({\n  name: 'XhNotificationItem',\n  // 缺省值由 connect 决定，这里一律 default: undefined\n  props: {\n    id: { type: String, default: undefined },\n    title: { type: String, default: undefined },\n    description: { type: String, default: undefined },\n    type: { type: String as PropType<ToastType>, default: undefined },\n    duration: { type: Number, default: undefined },\n    removeDelay: { type: Number, default: undefined },\n    closable: { type: Boolean, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>>, default: undefined },\n  },\n  emits: {\n    'status-change': (_details: PayloadOf<ToastSchema['props'], 'onStatusChange'>) => true,\n    'action': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: { item: NotificationItemApi }) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    // 桶名写 notification 而不是 toast：卡片跑的虽然是 toast 那台机器，\n    // 但它的文案该跟着通知走——写 toast 的话，改这颗叉的读屏名会连所有轻提示一起改\n    const ctx = useNotificationItem(\n      withXhConfig('notification', props) as ToastSchema['props'],\n      details => emit('status-change', details),\n      () => emit('action'),\n    )\n    provideNotificationItem(ctx)\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps() as Record<string, unknown>,\n      slots.default?.({ item: ctx.api.value }),\n    )\n  },\n})\n\n/** 类型指示符。作者不写内容时由皮肤按 data-type 画一枚兜底字形。 */\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\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    return () => h('button', ctx.api.value.getItemActionTriggerProps() 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":";;;;;AAsBA,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,OAAO;EACL,OAAO;GAAE,MAAM;GAAyC,SAAS,KAAA;EAAU;EAC3E,cAAc;GAAE,MAAM;GAAyC,SAAS,KAAA;EAAU;EAClF,WAAW;GAAE,MAAM;GAA2C,SAAS,KAAA;EAAU;EACjF,KAAK;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACxC,KAAK;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACxC,UAAU;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC7C,aAAa;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAChD,iBAAiB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACrD,cAAc;GAAE,MAAM;GAAuD,SAAS,KAAA;EAAU;CAClG;CAEA,OAAO;EACL,iBAAiB,aAA4D;EAC7E,iBAAiB,WAAmE;CACtF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA8C,YAAY;GAC9D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,MAAM,gBAAgB,aAAa,gBAAgB,KAAK,GAAwB,MAAM;EAC5F,oBAAoB,GAAG;EAEvB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,YAAY,IAAI,IAAI,MAAM;GAC1B,OAAO,IAAI,IAAI,MAAM;GACrB,qBAAqB,IAAI,IAAI,MAAM;GACnC,QAAQ,IAAI;GACZ,QAAQ,IAAI;GACZ,SAAS,IAAI;GACb,YAAY,IAAI;EAClB,CAAC,CAAC;CACJ;AACF,CAAC;AAOD,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO,EAEL,WAAW;EAAE,MAAM;EAA2C,SAAS,KAAA;CAAU,EACnF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa;GACX,MAAM,MAAM,IAAI,IAAI;GACpB,MAAM,aAAa,IAAI,cAAc,EAAE,WAAW,MAAM,UAAU,CAAC;GAEnE,MAAM,YAAY,WAAW;GAC7B,MAAM,OAAO,IAAI,oBAAoB,SAAS;GAE9C,OAAO,EACL,OACA,YACA,MAAM,UAAU,KAAK,KAAI,SAAQ,EAAE,UAAU,EAAE,KAAK,KAAK,GAAG,GAAG,MAAM,QAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,KAAA,CAC9F;EACF;CACF;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,OAAO;EACL,IAAI;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACvC,OAAO;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC1C,aAAa;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAChD,MAAM;GAAE,MAAM;GAA+B,SAAS,KAAA;EAAU;EAChE,UAAU;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC7C,aAAa;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAChD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,iBAAiB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EACrD,cAAc;GAAE,MAAM;GAAuD,SAAS,KAAA;EAAU;CAClG;CACA,OAAO;EACL,kBAAkB,aAAgE;EAClF,gBAAgB;CAClB;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAG5B,MAAM,MAAM,oBACV,aAAa,gBAAgB,KAAK,IAClC,YAAW,KAAK,iBAAiB,OAAO,SAClC,KAAK,QAAQ,CACrB;EACA,wBAAwB,GAAG;EAC3B,aAAa,EACX,OACA,IAAI,IAAI,MAAM,aAAa,GAC3B,MAAM,UAAU,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,CACzC;CACF;AACF,CAAC;;AAGD,MAAa,8BAA8B,gBAAgB;CACzD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,2BAA2B;EACvC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,sBAAsB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,2BAA2B;EAEvC,aAAa,EACX,OACA,IAAI,IAAI,MAAM,kBAAkB,GAChC,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,KACrC;CACF;AACF,CAAC;AAED,MAAa,gCAAgC,gBAAgB;CAC3D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,2BAA2B;EACvC,aAAa,EACX,OACA,IAAI,IAAI,MAAM,wBAAwB,GACtC,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,WACrC;CACF;AACF,CAAC;AAED,MAAa,kCAAkC,gBAAgB;CAC7D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,2BAA2B;EACvC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,0BAA0B,GAA8B,MAAM,UAAU,CAAC;CAClH;AACF,CAAC;AAED,MAAa,iCAAiC,gBAAgB;CAC5D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,2BAA2B;EACvC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,yBAAyB,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC"}
+{"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 { NotificationDedupe, NotificationItemApi, NotificationOptions, NotificationPlacement, NotificationRecord, NotificationSchema, NotificationTranslations, ResolvedNotification, ToastSchema, ToastTone } 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']\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    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    removeDelay: { type: Number },\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>, 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/** 单条卡片。生命周期复用 toast 的状态机：会自动消失的卡片，该行为与消息来源无关。 */\nexport const XhNotificationItem = defineComponent({\n  name: 'XhNotificationItem',\n  // 缺省值由 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    id: { type: String },\n    title: { type: String },\n    description: { type: String },\n    tone: { type: String as PropType<ToastTone> },\n    loading: { type: Boolean, default: undefined },\n    duration: { type: Number },\n    removeDelay: { 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  emits: {\n    'status-change': (_details: PayloadOf<ToastSchema['props'], 'onStatusChange'>) => true,\n    'action': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: { item: NotificationItemApi }) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    // 桶名写 notification 而不是 toast：卡片跑的虽然是 toast 那台机器，\n    // 但它的文案该跟着通知走——写 toast 的话，改这颗叉的读屏名会连所有轻提示一起改\n    const ctx = useNotificationItem(\n      withXhConfig('notification', props) as ToastSchema['props'],\n      details => emit('status-change', details),\n      () => emit('action'),\n    )\n    provideNotificationItem(ctx)\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps() as Record<string, unknown>,\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\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    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

@@ -2,11 +2,11 @@ import { NotificationContext, NotificationItemContext } from "./context.js";
 import { MaybeRefOrGetter } from "vue";
 import { NotificationSchema, ToastSchema } from "@xihan-ui/headless";
 //#region src/components/notification/use-notification.d.ts
-/** props 收 ref/getter 时每帧现取，文案之类的量可以运行期换。 */
+/** props 接收 ref/getter 时每帧现取，文案等值可以在运行期更换。 */
 declare function useNotification(props: MaybeRefOrGetter<NotificationSchema['props']>, onItemsChange?: NotificationSchema['props']['onItemsChange']): NotificationContext;
 /**
- * 单条卡片。生命周期复用 toast 那台机器——那是「会自己消失的卡片」这一通用行为。
- * 退场走完由这里回队列删记录：队列在外层，卡片自己不认识它。
+ * 单条卡片。生命周期复用 toast 的状态机：那是会自动消失的卡片这一通用行为。
+ * 退场完成后由这里通知队列删除记录：队列在外层，卡片自身不知道它。
  */
 declare function useNotificationItem(props: ToastSchema['props'], onStatusChange?: ToastSchema['props']['onStatusChange'], onAction?: ToastSchema['props']['onAction']): NotificationItemContext;
 //#endregion

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":";;;;;iBAUgB,gBACd,OAAO,iBAAiB,8BACxB,gBAAgB,+CACf;;;;;iBAiBa,oBACd,OAAO,sBACP,iBAAiB,wCACjB,WAAW,mCACV"}
+{"version":3,"file":"use-notification.d.ts","names":[],"sources":["../../../src/components/notification/use-notification.ts"],"mappings":";;;;;iBAiBgB,gBACd,OAAO,iBAAiB,8BACxB,gBAAgB,+CACf;;;;;iBAiBa,oBACd,OAAO,sBACP,iBAAiB,wCACjB,WAAW,mCACV"}

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

@@ -4,7 +4,7 @@ import { useNotificationContextOptional } from "./context.js";
 import { computed, toValue } from "vue";
 import { connectNotification, connectNotificationItem, notificationMachine, toastMachine } from "@xihan-ui/headless";
 //#region src/components/notification/use-notification.ts
-/** props 收 ref/getter 时每帧现取，文案之类的量可以运行期换。 */
+/** props 接收 ref/getter 时每帧现取，文案等值可以在运行期更换。 */
 function useNotification(props, onItemsChange) {
 	const service = useMachine(notificationMachine, () => ({
 		...toValue(props),
@@ -20,8 +20,8 @@ function useNotification(props, onItemsChange) {
 	};
 }
 /**
-* 单条卡片。生命周期复用 toast 那台机器——那是「会自己消失的卡片」这一通用行为。
-* 退场走完由这里回队列删记录：队列在外层，卡片自己不认识它。
+* 单条卡片。生命周期复用 toast 的状态机：那是会自动消失的卡片这一通用行为。
+* 退场完成后由这里通知队列删除记录：队列在外层，卡片自身不知道它。
 */
 function useNotificationItem(props, onStatusChange, onAction) {
 	const queue = useNotificationContextOptional();

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":["import type { NotificationSchema, ToastSchema } from '@xihan-ui/headless'\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { NotificationContext, NotificationItemContext } from './context'\nimport { connectNotification, connectNotificationItem, notificationMachine, toastMachine } from '@xihan-ui/headless'\nimport { computed, toValue } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useNotificationContextOptional } from './context'\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  // 四个命令在顶层摊平，函数身份稳定，可解构后随时调用且不读取队列\n  return {\n    api,\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 * 单条卡片。生命周期复用 toast 那台机器——那是「会自己消失的卡片」这一通用行为。\n * 退场走完由这里回队列删记录：队列在外层，卡片自己不认识它。\n */\nexport function useNotificationItem(\n  props: ToastSchema['props'],\n  onStatusChange?: ToastSchema['props']['onStatusChange'],\n  onAction?: ToastSchema['props']['onAction'],\n): NotificationItemContext {\n  const queue = useNotificationContextOptional()\n  const notifyStatus: ToastSchema['props']['onStatusChange'] = (details) => {\n    onStatusChange?.(details)\n    if (details.status === 'unmounted')\n      queue?.dismiss(details.id)\n  }\n  const service = useMachine(toastMachine, () => ({ ...props, onStatusChange: notifyStatus, onAction }))\n  const api = computed(() => connectNotificationItem(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAUA,SAAgB,gBACd,OACA,eACqB;CACrB,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG,QAAQ,KAAK;EAAG;CAAc,EAAE;CAC5F,MAAM,MAAM,eAAe,oBAAoB,SAAS,YAAY,CAAC;CAErE,OAAO;EACL;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,gBAAwD,YAAY;EACxE,iBAAiB,OAAO;EACxB,IAAI,QAAQ,WAAW,aACrB,OAAO,QAAQ,QAAQ,EAAE;CAC7B;CACA,MAAM,UAAU,WAAW,qBAAqB;EAAE,GAAG;EAAO,gBAAgB;EAAc;CAAS,EAAE;CAErG,OAAO,EAAE,KADG,eAAe,wBAAwB,SAAS,YAAY,CAC7D,EAAE;AACf"}
+{"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 { NotificationSchema, ToastSchema } from '@xihan-ui/headless'\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { NotificationContext, NotificationItemContext } from './context'\nimport { connectNotification, connectNotificationItem, notificationMachine, toastMachine } from '@xihan-ui/headless'\nimport { computed, toValue } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useNotificationContextOptional } from './context'\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  // 四个命令在顶层摊平，函数身份稳定，可解构后随时调用且不读取队列\n  return {\n    api,\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 * 单条卡片。生命周期复用 toast 的状态机：那是会自动消失的卡片这一通用行为。\n * 退场完成后由这里通知队列删除记录：队列在外层，卡片自身不知道它。\n */\nexport function useNotificationItem(\n  props: ToastSchema['props'],\n  onStatusChange?: ToastSchema['props']['onStatusChange'],\n  onAction?: ToastSchema['props']['onAction'],\n): NotificationItemContext {\n  const queue = useNotificationContextOptional()\n  const notifyStatus: ToastSchema['props']['onStatusChange'] = (details) => {\n    onStatusChange?.(details)\n    if (details.status === 'unmounted')\n      queue?.dismiss(details.id)\n  }\n  const service = useMachine(toastMachine, () => ({ ...props, onStatusChange: notifyStatus, onAction }))\n  const api = computed(() => connectNotificationItem(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAiBA,SAAgB,gBACd,OACA,eACqB;CACrB,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG,QAAQ,KAAK;EAAG;CAAc,EAAE;CAC5F,MAAM,MAAM,eAAe,oBAAoB,SAAS,YAAY,CAAC;CAErE,OAAO;EACL;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,gBAAwD,YAAY;EACxE,iBAAiB,OAAO;EACxB,IAAI,QAAQ,WAAW,aACrB,OAAO,QAAQ,QAAQ,EAAE;CAC7B;CACA,MAAM,UAAU,WAAW,qBAAqB;EAAE,GAAG;EAAO,gBAAgB;EAAc;CAAS,EAAE;CAErG,OAAO,EAAE,KADG,eAAe,wBAAwB,SAAS,YAAY,CAC7D,EAAE;AACf"}

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

@@ -1,41 +1,35 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { NumberAnimationApi, NumberAnimationEasing, NumberAnimationFinishDetails, NumberAnimationLive, NumberAnimationSchema } from "@xihan-ui/headless";
-import { Size, Tone } from "@xihan-ui/kernel";
+import { Size, Tone } from "@xihan-ui/core";
+import { NumberAnimationApi, NumberAnimationCompleteDetails, NumberAnimationEasing, NumberAnimationLive, NumberAnimationSchema } from "@xihan-ui/headless";
 //#region src/components/number-animation/number-animation.d.ts
 type NumberAnimationProps = NumberAnimationSchema['props'];
-/** 默认插槽的载荷：当前帧的数值，以及它按 precision 与 separator 铺好的文本。 */
+/** 默认插槽的载荷：当前帧的数值，以及它按 precision 与 separator 格式化后的文本。 */
 type NumberAnimationSlotProps = Pick<NumberAnimationApi, 'value' | 'text'>;
 /**
- * 一段会自己走的数字：从 from 补间到 to，逐帧算值，格式化后写进根里。
+ * 一段自动变化的数字：从 from 补间到 to，逐帧计算值，格式化后写入根中。
  *
- * 默认插槽拿得到 `{ value, text }`，插了内容就由作者自己排版；
- * 什么都不插时根里就是格式化好的那串字。
+ * 默认插槽可得到 `{ value, text }`，插入内容后由作者自行排版；
+ * 未插入任何内容时根中即为格式化后的文本。
  */
 declare const XhNumberAnimation: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   from: {
     type: NumberConstructor;
-    default: undefined;
   };
   to: {
     type: NumberConstructor;
-    default: undefined;
   };
   duration: {
     type: NumberConstructor;
-    default: undefined;
   };
   easing: {
     type: PropType<NumberAnimationEasing>;
-    default: undefined;
   };
   precision: {
     type: NumberConstructor;
-    default: undefined;
   };
   separator: {
     type: StringConstructor;
-    default: undefined;
   };
   active: {
     type: BooleanConstructor;
@@ -43,44 +37,35 @@ declare const XhNumberAnimation: import("vue").DefineComponent<import("vue").Ext
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   live: {
     type: PropType<NumberAnimationLive>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  finish: (_details: PayloadOf<NumberAnimationProps, "onFinish">) => true;
+  complete: (_details: PayloadOf<NumberAnimationProps, "onComplete">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   from: {
     type: NumberConstructor;
-    default: undefined;
   };
   to: {
     type: NumberConstructor;
-    default: undefined;
   };
   duration: {
     type: NumberConstructor;
-    default: undefined;
   };
   easing: {
     type: PropType<NumberAnimationEasing>;
-    default: undefined;
   };
   precision: {
     type: NumberConstructor;
-    default: undefined;
   };
   separator: {
     type: StringConstructor;
-    default: undefined;
   };
   active: {
     type: BooleanConstructor;
@@ -88,29 +73,17 @@ declare const XhNumberAnimation: import("vue").DefineComponent<import("vue").Ext
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   live: {
     type: PropType<NumberAnimationLive>;
-    default: undefined;
   };
 }>> & Readonly<{
-  onFinish?: ((_details: NumberAnimationFinishDetails) => any) | undefined;
+  onComplete?: ((_details: NumberAnimationCompleteDetails) => any) | undefined;
 }>, {
-  tone: Tone;
-  size: Size;
-  separator: string;
-  to: number;
   active: boolean;
-  precision: number;
-  live: NumberAnimationLive;
-  from: number;
-  duration: number;
-  easing: import("@xihan-ui/motion").TweenEasing;
 }, SlotsType<{
   default?: (props: NumberAnimationSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -1 +1 @@
-{"version":3,"file":"number-animation.d.ts","names":[],"sources":["../../../src/components/number-animation/number-animation.ts"],"mappings":";;;;;KAUK,uBAAuB;;KAGhB,2BAA2B,KAAK;;;;;;;cAQ/B,iCAAiB,8BAAA;;;;;;;;;;;;;;IAOA,MAAA,SAAS;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAGd,SAAA,UAAA,UAAU;;;;;;;;;;;;;;;IATH,MAAA,SAAS;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;EAMvB,WAAC,OAAO,6BAA6B;kCAoBjD"}
+{"version":3,"file":"number-animation.d.ts","names":[],"sources":["../../../src/components/number-animation/number-animation.ts"],"mappings":";;;;;KAiBK,uBAAuB;;KAGhB,2BAA2B,KAAK;;;;;;;cAQ/B,iCAAiB,8BAAA;;;;;;;;;;;IAOA,MAAA,SAAS;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAGZ,WAAA,UAAA,UAAU;;;;;;;;;;;;IATL,MAAA,SAAS;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;EAMvB,WAAC,OAAO,6BAA6B;kCAoBjD"}

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

@@ -5,64 +5,37 @@ import { computed, defineComponent, h } from "vue";
 import { connectNumberAnimation, numberAnimationMachine } from "@xihan-ui/headless";
 //#region src/components/number-animation/number-animation.ts
 /**
-* 一段会自己走的数字：从 from 补间到 to，逐帧算值，格式化后写进根里。
+* 一段自动变化的数字：从 from 补间到 to，逐帧计算值，格式化后写入根中。
 *
-* 默认插槽拿得到 `{ value, text }`，插了内容就由作者自己排版；
-* 什么都不插时根里就是格式化好的那串字。
+* 默认插槽可得到 `{ value, text }`，插入内容后由作者自行排版；
+* 未插入任何内容时根中即为格式化后的文本。
 */
 const XhNumberAnimation = defineComponent({
 	name: "XhNumberAnimation",
 	props: {
-		from: {
-			type: Number,
-			default: void 0
-		},
-		to: {
-			type: Number,
-			default: void 0
-		},
-		duration: {
-			type: Number,
-			default: void 0
-		},
-		easing: {
-			type: String,
-			default: void 0
-		},
-		precision: {
-			type: Number,
-			default: void 0
-		},
-		separator: {
-			type: String,
-			default: void 0
-		},
+		from: { type: Number },
+		to: { type: Number },
+		duration: { type: Number },
+		easing: { type: String },
+		precision: { type: Number },
+		separator: { type: String },
 		active: {
 			type: Boolean,
 			default: void 0
 		},
-		size: {
-			type: String,
-			default: void 0
-		},
-		tone: {
-			type: String,
-			default: void 0
-		},
-		live: {
-			type: String,
-			default: void 0
-		}
+		size: { type: String },
+		tone: { type: String },
+		live: { type: String }
 	},
-	emits: { finish: (_details) => true },
+	emits: { complete: (_details) => true },
 	slots: Object,
 	setup(props, { slots, emit }) {
 		const notify = (details) => {
-			emit("finish", details);
+			emit("complete", details);
 		};
 		const service = useMachine(numberAnimationMachine, () => ({
 			...props,
-			onFinish: notify
+			onComplete: notify
 		}));
 		const api = computed(() => connectNumberAnimation(service, vueNormalize));
 		return () => {

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

@@ -1 +1 @@
-{"version":3,"file":"number-animation.js","names":[],"sources":["../../../src/components/number-animation/number-animation.ts"],"sourcesContent":["import type { NumberAnimationApi, NumberAnimationEasing, NumberAnimationFinishDetails, NumberAnimationLive, NumberAnimationSchema } from '@xihan-ui/headless'\nimport type { Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { connectNumberAnimation, numberAnimationMachine } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useMachine } from '../../runtime/use-machine'\n\ntype NumberAnimationProps = NumberAnimationSchema['props']\n\n/** 默认插槽的载荷：当前帧的数值，以及它按 precision 与 separator 铺好的文本。 */\nexport type NumberAnimationSlotProps = Pick<NumberAnimationApi, 'value' | 'text'>\n\n/**\n * 一段会自己走的数字：从 from 补间到 to，逐帧算值，格式化后写进根里。\n *\n * 默认插槽拿得到 `{ value, text }`，插了内容就由作者自己排版；\n * 什么都不插时根里就是格式化好的那串字。\n */\nexport const XhNumberAnimation = defineComponent({\n  name: 'XhNumberAnimation',\n  // 缺省值由机器与 connect 给出，这里一律 default: undefined\n  props: {\n    from: { type: Number, default: undefined },\n    to: { type: Number, default: undefined },\n    duration: { type: Number, default: undefined },\n    easing: { type: String as PropType<NumberAnimationEasing>, default: undefined },\n    precision: { type: Number, default: undefined },\n    separator: { type: String, default: undefined },\n    active: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    live: { type: String as PropType<NumberAnimationLive>, default: undefined },\n  },\n  emits: {\n    finish: (_details: PayloadOf<NumberAnimationProps, 'onFinish'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NumberAnimationSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NumberAnimationProps['onFinish'] = (details: NumberAnimationFinishDetails) => {\n      emit('finish', details)\n    }\n    const service = useMachine(numberAnimationMachine, () => ({ ...props, onFinish: notify }))\n    const api = computed(() => connectNumberAnimation(service, vueNormalize))\n\n    return () => {\n      const current = api.value\n      const content = slots.default?.({ value: current.value, text: current.text })\n      return h(\n        'span',\n        current.getRootProps() as Record<string, unknown>,\n        // 插槽为空（含 v-if 落空只剩注释节点）时退回组件自己铺好的那串字\n        slotPaints(content) ? content : current.text,\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,MAAM;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACzC,IAAI;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACvC,UAAU;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC7C,QAAQ;GAAE,MAAM;GAA2C,SAAS,KAAA;EAAU;EAC9E,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,QAAQ;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC5C,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,MAAM;GAAE,MAAM;GAAyC,SAAS,KAAA;EAAU;CAC5E;CACA,OAAO,EACL,SAAS,aAA0D,KACrE;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA4C,YAA0C;GAC1F,KAAK,UAAU,OAAO;EACxB;EACA,MAAM,UAAU,WAAW,+BAA+B;GAAE,GAAG;GAAO,UAAU;EAAO,EAAE;EACzF,MAAM,MAAM,eAAe,uBAAuB,SAAS,YAAY,CAAC;EAExE,aAAa;GACX,MAAM,UAAU,IAAI;GACpB,MAAM,UAAU,MAAM,UAAU;IAAE,OAAO,QAAQ;IAAO,MAAM,QAAQ;GAAK,CAAC;GAC5E,OAAO,EACL,QACA,QAAQ,aAAa,GAErB,WAAW,OAAO,IAAI,UAAU,QAAQ,IAC1C;EACF;CACF;AACF,CAAC"}
+{"version":3,"file":"number-animation.js","names":[],"sources":["../../../src/components/number-animation/number-animation.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 animation 相关实现。\n\nimport type { Size, Tone } from '@xihan-ui/core'\nimport type { NumberAnimationApi, NumberAnimationCompleteDetails, NumberAnimationEasing, NumberAnimationLive, NumberAnimationSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { connectNumberAnimation, numberAnimationMachine } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useMachine } from '../../runtime/use-machine'\n\ntype NumberAnimationProps = NumberAnimationSchema['props']\n\n/** 默认插槽的载荷：当前帧的数值，以及它按 precision 与 separator 格式化后的文本。 */\nexport type NumberAnimationSlotProps = Pick<NumberAnimationApi, 'value' | 'text'>\n\n/**\n * 一段自动变化的数字：从 from 补间到 to，逐帧计算值，格式化后写入根中。\n *\n * 默认插槽可得到 `{ value, text }`，插入内容后由作者自行排版；\n * 未插入任何内容时根中即为格式化后的文本。\n */\nexport const XhNumberAnimation = defineComponent({\n  name: 'XhNumberAnimation',\n  // 缺省值由机器与 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    from: { type: Number },\n    to: { type: Number },\n    duration: { type: Number },\n    easing: { type: String as PropType<NumberAnimationEasing> },\n    precision: { type: Number },\n    separator: { type: String },\n    active: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    tone: { type: String as PropType<Tone> },\n    live: { type: String as PropType<NumberAnimationLive> },\n  },\n  emits: {\n    complete: (_details: PayloadOf<NumberAnimationProps, 'onComplete'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NumberAnimationSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NumberAnimationProps['onComplete'] = (details: NumberAnimationCompleteDetails) => {\n      emit('complete', details)\n    }\n    const service = useMachine(numberAnimationMachine, () => ({ ...props, onComplete: notify }))\n    const api = computed(() => connectNumberAnimation(service, vueNormalize))\n\n    return () => {\n      const current = api.value\n      const content = slots.default?.({ value: current.value, text: current.text })\n      return h(\n        'span',\n        current.getRootProps() as Record<string, unknown>,\n        // 插槽为空（含 v-if 落空只剩注释节点）时退回组件自己铺好的那串字\n        slotPaints(content) ? content : current.text,\n      )\n    }\n  },\n})\n"],"mappings":";;;;;;;;;;;;AA4BA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,MAAM,EAAE,MAAM,OAAO;EACrB,IAAI,EAAE,MAAM,OAAO;EACnB,UAAU,EAAE,MAAM,OAAO;EACzB,QAAQ,EAAE,MAAM,OAA0C;EAC1D,WAAW,EAAE,MAAM,OAAO;EAC1B,WAAW,EAAE,MAAM,OAAO;EAC1B,QAAQ;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC5C,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAwC;CACxD;CACA,OAAO,EACL,WAAW,aAA4D,KACzE;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA8C,YAA4C;GAC9F,KAAK,YAAY,OAAO;EAC1B;EACA,MAAM,UAAU,WAAW,+BAA+B;GAAE,GAAG;GAAO,YAAY;EAAO,EAAE;EAC3F,MAAM,MAAM,eAAe,uBAAuB,SAAS,YAAY,CAAC;EAExE,aAAa;GACX,MAAM,UAAU,IAAI;GACpB,MAAM,UAAU,MAAM,UAAU;IAAE,OAAO,QAAQ;IAAO,MAAM,QAAQ;GAAK,CAAC;GAC5E,OAAO,EACL,QACA,QAAQ,aAAa,GAErB,WAAW,OAAO,IAAI,UAAU,QAAQ,IAC1C;EACF;CACF;AACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/number-field/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { NumberFieldContext } from './use-number-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<NumberFieldContext> = Symbol.for('xh-number-field')\n\nexport function provideNumberField(ctx: NumberFieldContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNumberFieldContext(): NumberFieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] NumberField 部件必须用在 XhNumberFieldRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAwC,OAAO,IAAI,iBAAiB;AAE1E,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/number-field/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 { NumberFieldContext } from './use-number-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<NumberFieldContext> = Symbol.for('xh-number-field')\n\nexport function provideNumberField(ctx: NumberFieldContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNumberFieldContext(): NumberFieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] NumberField 部件必须用在 XhNumberFieldRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAwC,OAAO,IAAI,iBAAiB;AAE1E,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT"}