@xihan-ui/vue 1.0.0 → 2.0.0

package/dist/services/notification-service.js

@@ -1,28 +1,34 @@
-import { useNotification } from "../components/notification/use-notification.js";
-import { XhNotificationItem, XhNotificationItemCloseTrigger, XhNotificationItemDescription, XhNotificationItemIndicator, XhNotificationItemTitle } from "../components/notification/notification.js";
-import { mountServiceHost } from "./mount-host.js";
+import { vueNormalize } from "../runtime/normalize-props.js";
+import { useMachine } from "../runtime/use-machine.js";
+import { XhNotificationItem, XhNotificationItemActionTrigger, XhNotificationItemCloseTrigger, XhNotificationItemDescription, XhNotificationItemIndicator, XhNotificationItemTitle } from "../components/notification/notification.js";
 import { createServiceConfig } from "./service-config.js";
-import { Fragment, computed, createApp, defineComponent, h, toValue } from "vue";
-import { ensurePortalRoot } from "@xihan-ui/kernel";
+import { mountServiceHost } from "./mount-host.js";
+import { Fragment, computed, createApp, defineComponent, h, shallowRef, toValue } from "vue";
+import { ensurePortalRoot } from "@xihan-ui/core";
+import { connectNotification, createFeedbackServiceController, notificationMachine, resolveFeedbackServiceTitle } from "@xihan-ui/headless";
 //#region src/services/notification-service.ts
-function defaultCard(item, translations, onUnmounted) {
+function defaultCard(item, translations, paused, onUnmounted, onAction) {
 	return h(XhNotificationItem, {
 		id: item.id,
-		title: item.title,
+		title: resolveFeedbackServiceTitle(item),
 		description: item.description,
-		type: item.type,
+		tone: item.tone,
+		loading: item.loading,
 		duration: item.duration,
 		removeDelay: item.removeDelay,
 		closable: item.closable,
 		pauseOnPageIdle: item.pauseOnPageIdle,
+		paused,
 		translations,
 		onStatusChange: ({ id, status }) => {
 			if (status === "unmounted") onUnmounted(id);
-		}
+		},
+		onAction: () => onAction(item.id)
 	}, () => [
 		h(XhNotificationItemIndicator),
 		h(XhNotificationItemTitle),
 		h(XhNotificationItemDescription),
+		item.actionLabel ? h(XhNotificationItemActionTrigger, () => item.actionLabel) : null,
 		item.closable !== false ? h(XhNotificationItemCloseTrigger) : null
 	]);
 }
@@ -32,55 +38,65 @@ function createNotificationService(options = {}) {
 	const configSource = createServiceConfig(config);
 	const holder = target ?? document.createElement("div");
 	if (!target) ensurePortalRoot(document).appendChild(holder);
-	let ctx = null;
+	let publishState = () => {};
+	const controller = createFeedbackServiceController({
+		name: "notification",
+		onStateChange: (state) => publishState(state.paused)
+	});
+	const pausedAll = shallowRef(controller.state.paused);
+	publishState = (paused) => void (pausedAll.value = paused);
 	const app = createApp(defineComponent({
 		name: "XhNotificationServiceHost",
 		setup() {
 			configSource.provide();
-			const inner = useNotification(() => ({
+			const service = useMachine(notificationMachine, () => ({
 				...queueProps,
 				translations: toValue(queueProps.translations)
-			}));
-			ctx = inner;
-			const api = computed(() => inner.api.value);
+			}), void 0, { start: "setup" });
+			const api = computed(() => connectNotification(service, vueNormalize));
+			controller.attach({
+				create: (opts) => api.value.create(opts),
+				update: (id, opts) => api.value.update(id, opts),
+				dismiss: (id) => api.value.dismiss(id),
+				dismissAll: () => api.value.dismissAll()
+			});
 			return () => {
 				const value = api.value;
+				controller.syncItems(value.visibleNotifications.map((item) => item.id));
 				return h("div", value.getRootProps(), value.placements.map((placement) => h("div", {
 					key: placement,
 					...value.getGroupProps({ placement })
-				}, value.getItemsByPlacement(placement).map((item) => h(Fragment, { key: item.id }, [defaultCard(item, toValue(queueProps.translations), inner.dismiss)])))));
+				}, value.getItemsByPlacement(placement).map((item) => h(Fragment, { key: item.id }, [defaultCard(item, toValue(queueProps.translations), pausedAll.value, controller.unmounted, controller.invokeAction)])))));
 			};
 		}
 	}));
 	const mounted = mountServiceHost(app, holder, "notification");
-	let disposed = false;
-	/**
-	* 宿主没挂起来时命令一律空转：把消息丢掉好过让调用点（推送回调、拦截器）连锁崩掉。
-	* 已卸载则是另一回事——那是调用方拿着一个死服务在用，明说好过静默吞掉。
-	*/
-	const use = () => {
-		if (disposed) throw new Error("notification 服务已卸载");
-		return mounted ? ctx : null;
+	if (!mounted) controller.attach(null);
+	/** 入队一条；回调另存一张表，队列记录中只保留文案。 */
+	const create = (opts = {}) => {
+		const { onAction, ...record } = opts;
+		return controller.create(record, onAction);
 	};
-	const sugar = (type) => (title, opts = {}) => use()?.create({
+	const sugar = (tone) => (title, opts = {}) => create({
 		...opts,
-		type,
+		tone,
 		title
-	}) ?? "";
+	});
 	return {
-		create: (opts) => use()?.create(opts) ?? "",
-		update: (id, opts) => use()?.update(id, opts),
-		dismiss: (id) => use()?.dismiss(id),
-		dismissAll: () => use()?.dismissAll(),
+		create,
+		update: controller.update,
+		dismiss: controller.dismiss,
+		dismissAll: controller.dismissAll,
 		info: sugar("info"),
 		success: sugar("success"),
 		warning: sugar("warning"),
-		error: sugar("error"),
+		danger: sugar("danger"),
+		pauseAll: controller.pauseAll,
+		resumeAll: controller.resumeAll,
 		setConfig: (next) => configSource.set(next),
 		dispose: () => {
 			if (mounted) app.unmount();
-			disposed = true;
-			ctx = null;
+			controller.dispose();
 			if (!target) holder.remove();
 		}
 	};

package/dist/services/notification-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification-service.js","names":[],"sources":["../../src/services/notification-service.ts"],"sourcesContent":["// 全局命令式通知服务：自带一个挂到 body 的宿主应用与默认渲染模板。\n//\n// 通知常常不是从组件树里发出来的——推送连接的回调、后台任务的收尾、拦截器里的\n// 一条系统消息，调用点都在组件之外。要它们各自去找一份队列上下文并不现实，\n// 所以队列由本服务持有，业务代码只管发。\n//\n// 队列要长在页面结构里（比如通知中心那一栏自己排版）时，用组件形态的\n// XhNotificationRoot，那是另一条路，两者不共享队列。\nimport type {\n  NotificationOptions,\n  NotificationPlacement,\n  NotificationTranslations,\n  ResolvedNotification,\n} from '@xihan-ui/headless'\nimport type { App, MaybeRefOrGetter, VNode } from 'vue'\nimport type { NotificationContext } from '../components/notification/context'\nimport type { XhConfig } from '../config/config'\nimport { ensurePortalRoot } from '@xihan-ui/kernel'\nimport { computed, createApp, defineComponent, Fragment, h, toValue } from 'vue'\nimport {\n  XhNotificationItem,\n  XhNotificationItemCloseTrigger,\n  XhNotificationItemDescription,\n  XhNotificationItemIndicator,\n  XhNotificationItemTitle,\n} from '../components/notification/notification'\nimport { useNotification } from '../components/notification/use-notification'\nimport { mountServiceHost } from './mount-host'\nimport { createServiceConfig } from './service-config'\n\nexport interface NotificationServiceOptions {\n  /** 默认落位，默认 bottom-end；单条可用 options.placement 覆盖。 */\n  placement?: NotificationPlacement\n  /** 每个位置最多同时留几条，超出挤掉最旧的。不给即不限。 */\n  max?: number\n  /** 同一摞内的间距（px），默认 16。 */\n  gap?: number\n  duration?: number\n  removeDelay?: number\n  pauseOnPageIdle?: boolean\n  /** 通知的文案：那一摞的读屏名与卡片上那颗叉的读屏名，一个桶装完。 */\n  translations?: MaybeRefOrGetter<Partial<NotificationTranslations>>\n  /**\n   * 喂给通知子树的全局配置（locale / translations / size / portalContainer）。\n   * 本服务自带宿主应用，接不到组件树里的 provideXhConfig，要让它跟应用同语言就从这里给；\n   * 传 ref/getter 即可运行期跟着切语言，也可以之后用 setConfig 推。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；不给就在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\n/** 类型糖的入参：只差 type 与 title，其余同 create。 */\nexport type NotificationMessageOptions = Omit<NotificationOptions, 'type' | 'title'>\n\nexport interface NotificationService {\n  /** 入队并返回 id；同 id 已存在则就地改写，位置不动。 */\n  create: (options?: NotificationOptions) => string\n  update: (id: string, options: Partial<NotificationOptions>) => void\n  dismiss: (id: string) => void\n  dismissAll: () => void\n  info: (title: string, options?: NotificationMessageOptions) => string\n  success: (title: string, options?: NotificationMessageOptions) => string\n  warning: (title: string, options?: NotificationMessageOptions) => string\n  error: (title: string, options?: NotificationMessageOptions) => string\n  /** 换一份全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\nfunction defaultCard(\n  item: ResolvedNotification,\n  translations: Partial<NotificationTranslations> | undefined,\n  onUnmounted: (id: string) => void,\n): VNode {\n  return h(XhNotificationItem, {\n    id: item.id,\n    title: item.title,\n    description: item.description,\n    type: item.type,\n    duration: item.duration,\n    removeDelay: item.removeDelay,\n    closable: item.closable,\n    pauseOnPageIdle: item.pauseOnPageIdle,\n    translations,\n    onStatusChange: ({ id, status }: { id: string, status: string }) => {\n      if (status === 'unmounted')\n        onUnmounted(id)\n    },\n  }, () => [\n    // 四个节点平铺：两列网格与右上角那颗叉都归皮肤，模板套一层行容器只会与它打架。\n    // 指示符与说明都恒渲染——皮肤的 :empty 规则负责把空盒收走，\n    // 而 aria-describedby 无条件指着说明那一个，节点缺席就成了悬空引用\n    h(XhNotificationItemIndicator),\n    h(XhNotificationItemTitle),\n    h(XhNotificationItemDescription),\n    item.closable !== false ? h(XhNotificationItemCloseTrigger) : null,\n  ])\n}\n\nexport function createNotificationService(options: NotificationServiceOptions = {}): NotificationService {\n  if (typeof document === 'undefined')\n    throw new Error('createNotificationService 需要 document；SSR 里请等到客户端再创建')\n\n  const { target, config, ...queueProps } = options\n  const configSource = createServiceConfig(config)\n  const holder = target ?? document.createElement('div')\n  if (!target)\n    ensurePortalRoot(document).appendChild(holder)\n\n  let ctx: NotificationContext | null = null\n\n  const Host = defineComponent({\n    name: 'XhNotificationServiceHost',\n    setup() {\n      configSource.provide()\n      // props 每帧现展开：文案是 getter 时才跟得上运行期切语言\n      const inner = useNotification(() => ({ ...queueProps, translations: toValue(queueProps.translations) }))\n      ctx = inner\n      // 部件不经 provide/inject 取队列：本服务自己收 status-change 把走完退场的那条删掉，\n      // 卡片与队列之间因此没有第二条隐式链路\n      const api = computed(() => inner.api.value)\n      return () => {\n        const value = api.value\n        return h('div', value.getRootProps() as Record<string, unknown>, value.placements.map(placement =>\n          h(\n            'div',\n            { key: placement, ...value.getGroupProps({ placement }) as Record<string, unknown> },\n            // 按队列身份 id 给 key，避免节点被就地复用\n            value.getItemsByPlacement(placement).map(item => h(Fragment, { key: item.id }, [\n              defaultCard(item, toValue(queueProps.translations), inner.dismiss),\n            ])),\n          )))\n      }\n    },\n  })\n\n  const app: App = createApp(Host)\n  const mounted = mountServiceHost(app, holder, 'notification')\n  let disposed = false\n\n  /**\n   * 宿主没挂起来时命令一律空转：把消息丢掉好过让调用点（推送回调、拦截器）连锁崩掉。\n   * 已卸载则是另一回事——那是调用方拿着一个死服务在用，明说好过静默吞掉。\n   */\n  const use = (): NotificationContext | null => {\n    if (disposed)\n      throw new Error('notification 服务已卸载')\n    return mounted ? ctx : null\n  }\n  const sugar = (type: NotificationOptions['type']) =>\n    (title: string, opts: NotificationMessageOptions = {}): string =>\n      use()?.create({ ...opts, type, title }) ?? ''\n\n  return {\n    create: opts => use()?.create(opts) ?? '',\n    update: (id, opts) => use()?.update(id, opts),\n    dismiss: id => use()?.dismiss(id),\n    dismissAll: () => use()?.dismissAll(),\n    info: sugar('info'),\n    success: sugar('success'),\n    warning: sugar('warning'),\n    error: sugar('error'),\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      if (mounted)\n        app.unmount()\n      disposed = true\n      ctx = null\n      if (!target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":";;;;;;;AAuEA,SAAS,YACP,MACA,cACA,aACO;CACP,OAAO,EAAE,oBAAoB;EAC3B,IAAI,KAAK;EACT,OAAO,KAAK;EACZ,aAAa,KAAK;EAClB,MAAM,KAAK;EACX,UAAU,KAAK;EACf,aAAa,KAAK;EAClB,UAAU,KAAK;EACf,iBAAiB,KAAK;EACtB;EACA,iBAAiB,EAAE,IAAI,aAA6C;GAClE,IAAI,WAAW,aACb,YAAY,EAAE;EAClB;CACF,SAAS;EAIP,EAAE,2BAA2B;EAC7B,EAAE,uBAAuB;EACzB,EAAE,6BAA6B;EAC/B,KAAK,aAAa,QAAQ,EAAE,8BAA8B,IAAI;CAChE,CAAC;AACH;AAEA,SAAgB,0BAA0B,UAAsC,CAAC,GAAwB;CACvG,IAAI,OAAO,aAAa,aACtB,MAAM,IAAI,MAAM,sDAAsD;CAExE,MAAM,EAAE,QAAQ,QAAQ,GAAG,eAAe;CAC1C,MAAM,eAAe,oBAAoB,MAAM;CAC/C,MAAM,SAAS,UAAU,SAAS,cAAc,KAAK;CACrD,IAAI,CAAC,QACH,iBAAiB,QAAQ,CAAC,CAAC,YAAY,MAAM;CAE/C,IAAI,MAAkC;CA2BtC,MAAM,MAAW,UAzBJ,gBAAgB;EAC3B,MAAM;EACN,QAAQ;GACN,aAAa,QAAQ;GAErB,MAAM,QAAQ,uBAAuB;IAAE,GAAG;IAAY,cAAc,QAAQ,WAAW,YAAY;GAAE,EAAE;GACvG,MAAM;GAGN,MAAM,MAAM,eAAe,MAAM,IAAI,KAAK;GAC1C,aAAa;IACX,MAAM,QAAQ,IAAI;IAClB,OAAO,EAAE,OAAO,MAAM,aAAa,GAA8B,MAAM,WAAW,KAAI,cACpF,EACE,OACA;KAAE,KAAK;KAAW,GAAG,MAAM,cAAc,EAAE,UAAU,CAAC;IAA6B,GAEnF,MAAM,oBAAoB,SAAS,CAAC,CAAC,KAAI,SAAQ,EAAE,UAAU,EAAE,KAAK,KAAK,GAAG,GAAG,CAC7E,YAAY,MAAM,QAAQ,WAAW,YAAY,GAAG,MAAM,OAAO,CACnE,CAAC,CAAC,CACJ,CAAC,CAAC;GACN;EACF;CACF,CAE8B,CAAC;CAC/B,MAAM,UAAU,iBAAiB,KAAK,QAAQ,cAAc;CAC5D,IAAI,WAAW;;;;;CAMf,MAAM,YAAwC;EAC5C,IAAI,UACF,MAAM,IAAI,MAAM,oBAAoB;EACtC,OAAO,UAAU,MAAM;CACzB;CACA,MAAM,SAAS,UACZ,OAAe,OAAmC,CAAC,MAClD,IAAI,CAAC,EAAE,OAAO;EAAE,GAAG;EAAM;EAAM;CAAM,CAAC,KAAK;CAE/C,OAAO;EACL,SAAQ,SAAQ,IAAI,CAAC,EAAE,OAAO,IAAI,KAAK;EACvC,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,OAAO,IAAI,IAAI;EAC5C,UAAS,OAAM,IAAI,CAAC,EAAE,QAAQ,EAAE;EAChC,kBAAkB,IAAI,CAAC,EAAE,WAAW;EACpC,MAAM,MAAM,MAAM;EAClB,SAAS,MAAM,SAAS;EACxB,SAAS,MAAM,SAAS;EACxB,OAAO,MAAM,OAAO;EACpB,YAAW,SAAQ,aAAa,IAAI,IAAI;EACxC,eAAe;GACb,IAAI,SACF,IAAI,QAAQ;GACd,WAAW;GACX,MAAM;GACN,IAAI,CAAC,QACH,OAAO,OAAO;EAClB;CACF;AACF"}
+{"version":3,"file":"notification-service.js","names":[],"sources":["../../src/services/notification-service.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// 全局命令式通知服务：自带一个挂到 body 的宿主应用与默认渲染模板。\n//\n// 通知常常不是从组件树里发出来的——推送连接的回调、后台任务的收尾、拦截器里的\n// 一条系统消息，调用点都在组件之外。要它们各自去找一份队列上下文并不现实，\n// 所以队列由本服务持有，业务代码只管发。\n//\n// 队列要长在页面结构里（比如通知中心那一栏自己排版）时，用组件形态的\n// XhNotificationRoot，那是另一条路，两者不共享队列。\nimport type {\n  NotificationDedupe,\n  NotificationOptions,\n  NotificationPlacement,\n  NotificationTranslations,\n  ResolvedNotification,\n} from '@xihan-ui/headless'\nimport type { App, MaybeRefOrGetter, VNode } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { ensurePortalRoot } from '@xihan-ui/core'\nimport { connectNotification, createFeedbackServiceController, notificationMachine, resolveFeedbackServiceTitle } from '@xihan-ui/headless'\nimport { computed, createApp, defineComponent, Fragment, h, shallowRef, toValue } from 'vue'\nimport {\n  XhNotificationItem,\n  XhNotificationItemActionTrigger,\n  XhNotificationItemCloseTrigger,\n  XhNotificationItemDescription,\n  XhNotificationItemIndicator,\n  XhNotificationItemTitle,\n} from '../components/notification/notification'\nimport { vueNormalize } from '../runtime/normalize-props'\nimport { useMachine } from '../runtime/use-machine'\nimport { mountServiceHost } from './mount-host'\nimport { createServiceConfig } from './service-config'\n\nexport interface NotificationServiceOptions {\n  /** 默认落位，默认 bottom-end；单条可用 options.placement 覆盖。 */\n  placement?: NotificationPlacement\n  /** 每个位置最多同时保留几条，超出时先移除低优先级的、同级中移除最旧的。默认 5；传 Infinity 即不限。 */\n  max?: number\n  /** 重复的判定方式，默认 'id'；传 'content' 则同一内容合并为一条并计数。 */\n  dedupe?: NotificationDedupe\n  /** 同一堆叠内的间距（px），默认 16。 */\n  gap?: number\n  duration?: number\n  removeDelay?: number\n  pauseOnPageIdle?: boolean\n  /** 通知的文案：堆叠区的读屏名与卡片上关闭按钮的读屏名，统一在一个桶中。 */\n  translations?: MaybeRefOrGetter<Partial<NotificationTranslations>>\n  /**\n   * 提供给通知子树的全局配置（locale / translations / size / portalContainer）。\n   * 本服务自带宿主应用，无法接收组件树中的 provideXhConfig，需要与应用同语言时从这里提供；\n   * 传 ref/getter 即可在运行期跟随切换语言，也可以之后用 setConfig 推送。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；未提供时在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\n/**\n * create 的入参。`actionLabel` 是卡片上行内动作按钮的文案，`onAction` 是按下它执行的动作：\n * 回调不进入队列记录（该记录要能被整份替换、序列化、比对），服务按 id 单独保存一张表。\n */\nexport interface NotificationCreateOptions extends NotificationOptions {\n  onAction?: () => void\n}\n\n/** 类型糖的入参：只差 type 与 title，其余同 create。 */\nexport type NotificationMessageOptions = Omit<NotificationCreateOptions, 'tone' | 'loading' | 'title'>\n\nexport interface NotificationService {\n  /** 入队并返回 id；同 id 已存在则就地改写，被合并的返回被并入的那一条。 */\n  create: (options?: NotificationCreateOptions) => string\n  update: (id: string, options: Partial<NotificationOptions>) => void\n  dismiss: (id: string) => void\n  dismissAll: () => void\n  info: (title: string, options?: NotificationMessageOptions) => string\n  success: (title: string, options?: NotificationMessageOptions) => string\n  warning: (title: string, options?: NotificationMessageOptions) => string\n  danger: (title: string, options?: NotificationMessageOptions) => string\n  /** 暂停当前这些卡片的计时，'service' 这一路与指针、焦点并存。 */\n  pauseAll: () => void\n  resumeAll: () => void\n  /** 更换全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\nfunction defaultCard(\n  item: ResolvedNotification,\n  translations: Partial<NotificationTranslations> | undefined,\n  paused: boolean,\n  onUnmounted: (id: string) => void,\n  onAction: (id: string) => void,\n): VNode {\n  return h(XhNotificationItem, {\n    id: item.id,\n    title: resolveFeedbackServiceTitle(item),\n    description: item.description,\n    tone: item.tone,\n    loading: item.loading,\n    duration: item.duration,\n    removeDelay: item.removeDelay,\n    closable: item.closable,\n    pauseOnPageIdle: item.pauseOnPageIdle,\n    paused,\n    translations,\n    onStatusChange: ({ id, status }: { id: string, status: string }) => {\n      if (status === 'unmounted')\n        onUnmounted(id)\n    },\n    onAction: () => onAction(item.id),\n  }, () => [\n    // 四个节点平铺：两列网格与右上角那颗叉都归皮肤，模板套一层行容器只会与它打架。\n    // 指示符与说明都恒渲染——皮肤的 :empty 规则负责把空盒收走，\n    // 而 aria-describedby 无条件指着说明那一个，节点缺席就成了悬空引用\n    h(XhNotificationItemIndicator),\n    h(XhNotificationItemTitle),\n    h(XhNotificationItemDescription),\n    item.actionLabel ? h(XhNotificationItemActionTrigger, () => item.actionLabel) : null,\n    item.closable !== false ? h(XhNotificationItemCloseTrigger) : null,\n  ])\n}\n\nexport function createNotificationService(options: NotificationServiceOptions = {}): NotificationService {\n  if (typeof document === 'undefined')\n    throw new Error('createNotificationService 需要 document；SSR 里请等到客户端再创建')\n\n  const { target, config, ...queueProps } = options\n  const configSource = createServiceConfig(config)\n  const holder = target ?? document.createElement('div')\n  if (!target)\n    ensurePortalRoot(document).appendChild(holder)\n\n  let publishState: (paused: boolean) => void = () => {}\n  const controller = createFeedbackServiceController<NotificationOptions, Partial<NotificationOptions>>({\n    name: 'notification',\n    onStateChange: state => publishState(state.paused),\n  })\n  const pausedAll = shallowRef(controller.state.paused)\n  publishState = paused => void (pausedAll.value = paused)\n\n  const Host = defineComponent({\n    name: 'XhNotificationServiceHost',\n    setup() {\n      configSource.provide()\n      // props 每帧现展开：文案是 getter 时才跟得上运行期切语言。\n      // 队列机器在 setup 里当场 start：它没有 DOM 锚点，而端口紧接着就接上。\n      // 等 mounted 再 start 的话，从业务组件的 onMounted 懒建本服务时，宿主的 mounted\n      // 会排到调用方那条 post-flush 队列的队尾，调用方接着发的第一条命令就撞上 SEND_BEFORE_MOUNT\n      const service = useMachine(\n        notificationMachine,\n        () => ({ ...queueProps, translations: toValue(queueProps.translations) }),\n        undefined,\n        { start: 'setup' },\n      )\n      // 部件不经 provide/inject 取队列：本服务自己收 status-change 把走完退场的那条删掉，\n      // 卡片与队列之间因此没有第二条隐式链路\n      const api = computed(() => connectNotification(service, vueNormalize))\n      controller.attach({\n        create: opts => api.value.create(opts),\n        update: (id, opts) => api.value.update(id, opts),\n        dismiss: id => api.value.dismiss(id),\n        dismissAll: () => api.value.dismissAll(),\n      })\n      return () => {\n        const value = api.value\n        controller.syncItems(value.visibleNotifications.map(item => item.id))\n        return h('div', value.getRootProps() as Record<string, unknown>, value.placements.map(placement =>\n          h(\n            'div',\n            { key: placement, ...value.getGroupProps({ placement }) as Record<string, unknown> },\n            // 按队列身份 id 给 key，避免节点被就地复用\n            value.getItemsByPlacement(placement).map(item => h(Fragment, { key: item.id }, [\n              defaultCard(\n                item,\n                toValue(queueProps.translations),\n                pausedAll.value,\n                controller.unmounted,\n                controller.invokeAction,\n              ),\n            ])),\n          )))\n      }\n    },\n  })\n\n  const app: App = createApp(Host)\n  const mounted = mountServiceHost(app, holder, 'notification')\n  if (!mounted)\n    controller.attach(null)\n\n  /** 入队一条；回调另存一张表，队列记录中只保留文案。 */\n  const create = (opts: NotificationCreateOptions = {}): string => {\n    const { onAction, ...record } = opts\n    return controller.create(record, onAction)\n  }\n\n  const sugar = (tone: NotificationOptions['tone']) =>\n    (title: string, opts: NotificationMessageOptions = {}): string =>\n      create({ ...opts, tone, title })\n\n  return {\n    create,\n    update: controller.update,\n    dismiss: controller.dismiss,\n    dismissAll: controller.dismissAll,\n    info: sugar('info'),\n    success: sugar('success'),\n    warning: sugar('warning'),\n    danger: sugar('danger'),\n    pauseAll: controller.pauseAll,\n    resumeAll: controller.resumeAll,\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      if (mounted)\n        app.unmount()\n      controller.dispose()\n      if (!target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/services/service-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-config.js","names":[],"sources":["../../src/services/service-config.ts"],"sourcesContent":["// 命令式服务共用的配置源。三个服务各自 createApp 到自建容器，接不到组件树里的\n// provideXhConfig，只能自己往宿主里 provide 一份；这里把那段收在一处。\n// 源收成 shallowRef 是为了运行期能换：传 ref/getter 的跟着应用切语言，\n// 没有响应式源的用句柄上的 setConfig 命令式推。\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { shallowRef, toValue } from 'vue'\nimport { provideXhConfig } from '../config/config'\n\nexport interface ServiceConfigSource {\n  /** 在宿主组件的 setup 里调一次。 */\n  provide: () => void\n  /** 换一份配置源；下一帧起服务子树读新值。 */\n  set: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n}\n\nexport function createServiceConfig(initial?: MaybeRefOrGetter<XhConfig>): ServiceConfigSource {\n  // 源本身可能就是个 ref，直接放进 shallowRef 会被解包成只读，故套一层盒子\n  const box = shallowRef<{ src: MaybeRefOrGetter<XhConfig> | undefined }>({ src: initial })\n  return {\n    provide: () => provideXhConfig(() => toValue(box.value.src) ?? {}),\n    set: (next) => {\n      box.value = { src: next }\n    },\n  }\n}\n"],"mappings":";;;AAgBA,SAAgB,oBAAoB,SAA2D;CAE7F,MAAM,MAAM,WAA4D,EAAE,KAAK,QAAQ,CAAC;CACxF,OAAO;EACL,eAAe,sBAAsB,QAAQ,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC;EACjE,MAAM,SAAS;GACb,IAAI,QAAQ,EAAE,KAAK,KAAK;EAC1B;CACF;AACF"}
+{"version":3,"file":"service-config.js","names":[],"sources":["../../src/services/service-config.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// 命令式服务共用的配置源。三个服务各自 createApp 到自建容器，接不到组件树里的\n// provideXhConfig，只能自己往宿主里 provide 一份；这里把那段收在一处。\n// 源收成 shallowRef 是为了运行期能换：传 ref/getter 的跟着应用切语言，\n// 没有响应式源的用句柄上的 setConfig 命令式推。\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { shallowRef, toValue } from 'vue'\nimport { provideXhConfig } from '../config/config'\n\nexport interface ServiceConfigSource {\n  /** 在宿主组件的 setup 中调用一次。 */\n  provide: () => void\n  /** 更换配置源；下一帧起服务子树读取新值。 */\n  set: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n}\n\nexport function createServiceConfig(initial?: MaybeRefOrGetter<XhConfig>): ServiceConfigSource {\n  // 源本身可能就是个 ref，直接放进 shallowRef 会被解包成只读，故套一层盒子\n  const box = shallowRef<{ src: MaybeRefOrGetter<XhConfig> | undefined }>({ src: initial })\n  return {\n    provide: () => provideXhConfig(() => toValue(box.value.src) ?? {}),\n    set: (next) => {\n      box.value = { src: next }\n    },\n  }\n}\n"],"mappings":";;;AAqBA,SAAgB,oBAAoB,SAA2D;CAE7F,MAAM,MAAM,WAA4D,EAAE,KAAK,QAAQ,CAAC;CACxF,OAAO;EACL,eAAe,sBAAsB,QAAQ,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC;EACjE,MAAM,SAAS;GACb,IAAI,QAAQ,EAAE,KAAK,KAAK;EAC1B;CACF;AACF"}

package/dist/services/toast-service.d.ts

@@ -1,52 +1,69 @@
 import { XhConfig } from "../config/config.js";
 import { MaybeRefOrGetter } from "vue";
-import { ToastOptions, ToastPlacement, ToastTranslations } from "@xihan-ui/headless";
+import { NotificationDedupe, ToastOptions, ToastPlacement, ToastServiceDefaults, ToastTranslations } from "@xihan-ui/headless";
 //#region src/services/toast-service.d.ts
-/** 单条没写时的兜底：服务档一次定好，逐条渲染时补进去。 */
-interface ToastDefaults {
-  duration?: number;
-  removeDelay?: number;
-  pauseOnPageIdle?: boolean;
-}
-interface ToastServiceOptions extends ToastDefaults {
-  /** 那一摞落在哪儿，默认 'top'：视线正好在刚才操作的地方上方。 */
+interface ToastServiceOptions extends ToastServiceDefaults {
+  /** 堆叠区的位置，默认 'bottom'。 */
   placement?: ToastPlacement;
-  /** 最多同时留几条，超出挤掉最旧的，默认 5。 */
+  /** 最多同时保留几条，默认 3；超出时先移除低优先级的，同级中移除最旧的。 */
   max?: number;
-  /** 摞内间距（px），默认 16。 */
+  /** 重复的判定方式，默认 'id'；传 'content' 则同一内容合并为一条并计数。 */
+  dedupe?: NotificationDedupe;
+  /** 堆叠内间距（px），默认 12。 */
   gap?: number;
-  /** toast 部件的文案（关闭钮的读屏名等）。 */
+  /** toast 部件的文案（关闭按钮的读屏名等）。 */
   toastTranslations?: MaybeRefOrGetter<Partial<ToastTranslations>>;
   /**
-   * 喂给轻提示子树的全局配置（locale / translations / size / portalContainer）。
-   * 本服务自带宿主应用，接不到组件树里的 provideXhConfig，要让它跟应用同语言就从这里给；
-   * 传 ref/getter 即可运行期跟着切语言，也可以之后用 setConfig 推。
+   * 提供给轻提示子树的全局配置（locale / translations / size / portalContainer）。
+   * 本服务自带宿主应用，无法接收组件树中的 provideXhConfig，需要与应用同语言时从这里提供；
+   * 传 ref/getter 即可在运行期跟随切换语言，也可以之后用 setConfig 推送。
    */
   config?: MaybeRefOrGetter<XhConfig>;
-  /** 宿主容器；不给就在 body 下新建一个。 */
+  /** 宿主容器；未提供时在 body 下新建一个。 */
   target?: HTMLElement;
 }
-/** 类型糖的入参：只差 type，其余同 create。 */
-type ToastMessageOptions = Omit<ToastOptions, 'type' | 'title'>;
+/**
+ * create 的入参。`actionLabel` 是提示条上行内动作按钮的文案，`onAction` 是按下它执行的动作：
+ * 回调不进入队列记录（该记录要能被整份替换、序列化、比对），服务按 id 单独保存一张表。
+ */
+interface ToastCreateOptions extends ToastOptions {
+  onAction?: () => void;
+}
+/** 语气糖的入参：只差 tone / loading，其余同 create。 */
+type ToastMessageOptions = Omit<ToastCreateOptions, 'tone' | 'loading' | 'title'>;
+/** promise 三态的文案：成功与失败可以传函数，拿到结果后再拼装文案。 */
+interface ToastPromiseOptions<T> extends Omit<ToastMessageOptions, 'duration'> {
+  loading: string;
+  success: string | ((value: T) => string);
+  error: string | ((reason: unknown) => string);
+}
 interface ToastService {
-  /** 入队并返回 id；同 id 已存在则就地改写。 */
-  create: (options?: ToastOptions) => string;
+  /** 入队并返回 id；同 id 已存在则就地改写，被合并的返回被并入的那一条。 */
+  create: (options?: ToastCreateOptions) => string;
   update: (id: string, options: Partial<ToastOptions>) => void;
-  /** 立刻从队列里删掉。条子自己的关闭按钮走的是退场窗口，有退场动画。 */
+  /** 立即从队列中删除。提示条自己的关闭按钮经退场窗口，带退场动画。 */
   dismiss: (id: string) => void;
   dismissAll: () => void;
   info: (message: string, options?: ToastMessageOptions) => string;
   success: (message: string, options?: ToastMessageOptions) => string;
   warning: (message: string, options?: ToastMessageOptions) => string;
-  error: (message: string, options?: ToastMessageOptions) => string;
-  /** 返回 id，之后用 update(id, { type: 'success', title: … }) 收尾。 */
+  danger: (message: string, options?: ToastMessageOptions) => string;
+  /** 返回 id，之后用 update(id, { loading: false, tone: 'success', title: … }) 收尾。 */
   loading: (message: string, options?: ToastMessageOptions) => string;
-  /** 换一份全局配置源。 */
+  /**
+   * 先显示一条 loading，Promise 落定后就地改写为 success / danger。
+   * 返回该条的 id；Promise 的结果原样交回调用方，拒绝也照旧拒绝。
+   */
+  promise: <T>(input: Promise<T> | (() => Promise<T>), options: ToastPromiseOptions<T>) => Promise<T>;
+  /** 暂停当前堆叠的计时，'service' 这一路与指针、焦点并存。 */
+  pauseAll: () => void;
+  resumeAll: () => void;
+  /** 更换全局配置源。 */
   setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void;
   /** 卸载宿主应用并移除容器。 */
   dispose: () => void;
 }
 declare function createToastService(options?: ToastServiceOptions): ToastService;
 //#endregion
-export { ToastMessageOptions, ToastService, ToastServiceOptions, createToastService };
+export { ToastCreateOptions, ToastMessageOptions, ToastPromiseOptions, ToastService, ToastServiceOptions, createToastService };
 //# sourceMappingURL=toast-service.d.ts.map

package/dist/services/toast-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast-service.d.ts","names":[],"sources":["../../src/services/toast-service.ts"],"mappings":";;;;;UAoBU;EACR;EACA;EACA;;UAGe,4BAA4B;;EAE3C,YAAY;;EAEZ;;EAEA;;EAEA,oBAAoB,iBAAiB,QAAQ;;;;;;EAM7C,SAAS,iBAAiB;;EAE1B,SAAS;;;KAIC,sBAAsB,KAAK;UAEtB;;EAEf,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;;EAEtC,UAAU;EACV;EACA,OAAO,iBAAiB,UAAU;EAClC,UAAU,iBAAiB,UAAU;EACrC,UAAU,iBAAiB,UAAU;EACrC,QAAQ,iBAAiB,UAAU;;EAEnC,UAAU,iBAAiB,UAAU;;EAErC,YAAY,MAAM,iBAAiB;;EAEnC;;iBAgDc,mBAAmB,UAAS,sBAA2B"}
+{"version":3,"file":"toast-service.d.ts","names":[],"sources":["../../src/services/toast-service.ts"],"mappings":";;;;UAqDiB,4BAA4B;;EAE3C,YAAY;;EAEZ;;EAEA,SAAS;;EAET;;EAEA,oBAAoB,iBAAiB,QAAQ;;;;;;EAM7C,SAAS,iBAAiB;;EAE1B,SAAS;;;;;;UAOM,2BAA2B;EAC1C;;;KAIU,sBAAsB,KAAK;;UAGtB,oBAAoB,WAAW,KAAK;EACnD;EACA,oBAAoB,OAAO;EAC3B,kBAAkB;;UAGH;;EAEf,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;;EAEtC,UAAU;EACV;EACA,OAAO,iBAAiB,UAAU;EAClC,UAAU,iBAAiB,UAAU;EACrC,UAAU,iBAAiB,UAAU;EACrC,SAAS,iBAAiB,UAAU;;EAEpC,UAAU,iBAAiB,UAAU;;;;;EAKrC,UAAU,GAAG,OAAO,QAAQ,YAAY,QAAQ,KAAK,SAAS,oBAAoB,OAAO,QAAQ;;EAEjG;EACA;;EAEA,YAAY,MAAM,iBAAiB;;EAEnC;;iBAwCc,mBAAmB,UAAS,sBAA2B"}

package/dist/services/toast-service.js

@@ -1,136 +1,156 @@
-import { XhToastCloseTrigger, XhToastRoot, XhToastTitle } from "../components/toast/toast.js";
-import { typeGlyph } from "./glyph.js";
-import { mountServiceHost } from "./mount-host.js";
+import { vueNormalize } from "../runtime/normalize-props.js";
+import { useMachine } from "../runtime/use-machine.js";
+import { XhToastActionTrigger, XhToastCloseTrigger, XhToastContent, XhToastDescription, XhToastIndicator, XhToastRoot, XhToastTitle } from "../components/toast/toast.js";
 import { createServiceConfig } from "./service-config.js";
-import { Fragment, createApp, defineComponent, h, shallowRef, toValue } from "vue";
-import { TOAST_DURATION, TOAST_GAP, TOAST_PLACEMENT, toastAnatomy } from "@xihan-ui/headless";
-import { DATA_INERT_EXEMPT, ensurePortalRoot } from "@xihan-ui/kernel";
+import { mountServiceHost } from "./mount-host.js";
+import { Fragment, computed, createApp, defineComponent, h, shallowRef, toValue } from "vue";
+import { DATA_INERT_EXEMPT, ensurePortalRoot } from "@xihan-ui/core";
+import { TOAST_GAP, TOAST_MAX, TOAST_PLACEMENT, connectNotification, createFeedbackServiceController, createToastStackController, notificationMachine, resolveToastServiceItem, toastAnatomy, visibleNotifications } from "@xihan-ui/headless";
 //#region src/services/toast-service.ts
 const parts = toastAnatomy.build();
-/**
-* 这一条会不会自己走掉。loading 一直挂着，duration <= 0 与非有限值也是。
-* 走不掉的必须留个出口，否则界面上一个可点、可聚焦的节点都没有。
-*/
-function selfDismissing(toast, defaults) {
-	if (toast.type === "loading") return false;
-	const duration = toast.duration ?? defaults.duration ?? TOAST_DURATION;
-	return Number.isFinite(duration) && duration > 0;
-}
-function defaultToast(toast, defaults, translations, onUnmounted) {
-	const closable = toast.closable ?? !selfDismissing(toast, defaults);
-	const type = toast.type ?? "info";
+function defaultToast(toast, defaults, translations, paused, onUnmounted, onAction) {
+	const item = resolveToastServiceItem(toast, defaults);
 	return h(XhToastRoot, {
-		id: toast.id,
-		title: toast.title,
-		type,
-		duration: toast.duration ?? defaults.duration,
-		removeDelay: toast.removeDelay ?? defaults.removeDelay,
-		closable,
-		pauseOnPageIdle: defaults.pauseOnPageIdle,
+		id: item.id,
+		title: item.title,
+		description: item.description,
+		tone: item.tone,
+		loading: item.loading,
+		duration: item.duration,
+		removeDelay: item.removeDelay,
+		closable: item.closable,
+		pauseOnPageIdle: item.pauseOnPageIdle,
+		paused,
 		translations,
 		onStatusChange: ({ id, status }) => {
 			if (status === "unmounted") onUnmounted(id);
-		}
+		},
+		onAction: ({ id }) => onAction(id)
 	}, () => [
-		typeGlyph(type),
-		h(XhToastTitle),
-		closable ? h(XhToastCloseTrigger) : null
+		h(XhToastIndicator),
+		h(XhToastContent, () => [h(XhToastTitle), item.description ? h(XhToastDescription) : null]),
+		item.actionLabel ? h(XhToastActionTrigger, () => item.actionLabel) : null,
+		item.closable ? h(XhToastCloseTrigger) : null
 	]);
 }
 function createToastService(options = {}) {
 	if (typeof document === "undefined") throw new Error("createToastService 需要 document；SSR 里请等到客户端再创建");
-	const { target, toastTranslations, config, placement = TOAST_PLACEMENT, gap = TOAST_GAP, max = 5, ...defaults } = options;
+	const { target, toastTranslations, config, placement = TOAST_PLACEMENT, gap = TOAST_GAP, max = TOAST_MAX, dedupe, ...defaults } = options;
+	const serviceDefaults = {
+		...defaults,
+		pauseOnPageIdle: defaults.pauseOnPageIdle ?? true
+	};
 	const configSource = createServiceConfig(config);
 	const holder = target ?? document.createElement("div");
 	if (!target) ensurePortalRoot(document).appendChild(holder);
-	const queue = shallowRef([]);
-	let seq = 0;
-	const indexOf = (id) => queue.value.findIndex((item) => item.id === id);
-	const create = (opts = {}) => {
-		const id = opts.id ?? `toast-${++seq}`;
-		const at = indexOf(id);
-		if (at >= 0) {
-			const next = queue.value.slice();
-			next[at] = {
-				...next[at],
-				...opts,
-				id
-			};
-			queue.value = next;
-			return id;
-		}
-		const next = [...queue.value, {
-			...opts,
-			id
-		}];
-		queue.value = Number.isFinite(max) && max > 0 && next.length > max ? next.slice(next.length - max) : next;
-		return id;
-	};
-	const update = (id, opts) => {
-		const at = indexOf(id);
-		if (at < 0) return;
-		const next = queue.value.slice();
-		next[at] = {
-			...next[at],
-			...opts,
-			id
-		};
-		queue.value = next;
-	};
-	const remove = (id) => {
-		const next = queue.value.filter((item) => item.id !== id);
-		if (next.length !== queue.value.length) queue.value = next;
+	let publishState = () => {};
+	const controller = createFeedbackServiceController({
+		name: "toast",
+		idPrefix: "toast",
+		onStateChange: (state) => publishState(state.paused)
+	});
+	const pausedAll = shallowRef(controller.state.paused);
+	publishState = (paused) => void (pausedAll.value = paused);
+	let stack = null;
+	let stackGroup = null;
+	const bindGroup = (group) => {
+		const next = group instanceof HTMLElement ? group : null;
+		if (next === stackGroup) return;
+		stack?.dispose();
+		stackGroup = next;
+		stack = next ? createToastStackController({
+			group: next,
+			gap,
+			placement,
+			onInteractionChange: (active) => active ? controller.pauseAll() : controller.resumeAll()
+		}) : null;
 	};
 	const app = createApp(defineComponent({
 		name: "XhToastServiceHost",
 		setup() {
 			configSource.provide();
-			return () => h("div", {
-				...parts.group.attrs,
-				"data-placement": placement,
-				"data-count": queue.value.length,
-				"style": { gap: `${gap}px` },
-				[DATA_INERT_EXEMPT]: "",
-				"hidden": queue.value.length === 0 || void 0
-			}, queue.value.map((toast) => h(Fragment, { key: toast.id }, [defaultToast(toast, defaults, toValue(toastTranslations), remove)])));
+			const service = useMachine(notificationMachine, () => ({
+				placement,
+				max,
+				dedupe,
+				duration: serviceDefaults.duration,
+				removeDelay: serviceDefaults.removeDelay,
+				pauseOnPageIdle: serviceDefaults.pauseOnPageIdle
+			}), void 0, { start: "setup" });
+			const api = computed(() => connectNotification(service, vueNormalize));
+			const items = computed(() => visibleNotifications(service.context.get("items"), max, placement));
+			controller.attach({
+				create: (opts) => api.value.create(opts),
+				update: (id, opts) => api.value.update(id, opts),
+				dismiss: (id) => api.value.dismiss(id),
+				dismissAll: () => api.value.dismissAll()
+			});
+			return () => {
+				controller.syncItems(items.value.map((item) => item.id));
+				return h("div", {
+					...parts.group.attrs,
+					"ref": bindGroup,
+					"data-placement": placement,
+					"data-count": items.value.length,
+					[DATA_INERT_EXEMPT]: "",
+					"hidden": items.value.length === 0 || void 0
+				}, items.value.map((toast) => h(Fragment, { key: toast.id }, [defaultToast(toast, serviceDefaults, toValue(toastTranslations), pausedAll.value, controller.unmounted, controller.invokeAction)])));
+			};
 		}
 	}));
 	const mounted = mountServiceHost(app, holder, "toast");
-	let disposed = false;
-	/**
-	* 宿主没挂起来时命令一律空转：把提示丢掉好过让调用点（拦截器、store）连锁崩掉。
-	* 已卸载则是另一回事——那是调用方拿着一个死服务在用，明说好过静默吞掉。
-	*/
-	const alive = () => {
-		if (disposed) throw new Error("toast 服务已卸载");
-		return mounted;
+	if (!mounted) controller.attach(null);
+	/** 入队一条；回调另存一张表，队列记录中只保留文案。 */
+	const create = (opts = {}) => {
+		const { onAction, ...record } = opts;
+		return controller.create(record, onAction);
 	};
-	const sugar = (type) => (message, opts = {}) => alive() ? create({
+	const sugar = (tone) => (message, opts = {}) => create({
 		...opts,
-		type,
+		tone,
 		title: message
-	}) : "";
+	});
 	return {
-		create: (opts) => alive() ? create(opts) : "",
-		update: (id, opts) => {
-			if (alive()) update(id, opts);
-		},
-		dismiss: (id) => {
-			if (alive()) remove(id);
-		},
-		dismissAll: () => {
-			if (alive()) queue.value = [];
-		},
+		create,
+		update: controller.update,
+		dismiss: controller.dismiss,
+		dismissAll: controller.dismissAll,
 		info: sugar("info"),
 		success: sugar("success"),
 		warning: sugar("warning"),
-		error: sugar("error"),
-		loading: sugar("loading"),
+		danger: sugar("danger"),
+		loading: (message, opts = {}) => create({
+			...opts,
+			loading: true,
+			title: message
+		}),
+		promise: (input, opts) => {
+			const { loading, success, error, ...rest } = opts;
+			const running = typeof input === "function" ? input() : input;
+			const { onAction, ...record } = rest;
+			return controller.trackPromise(running, {
+				...record,
+				loading: true,
+				title: loading
+			}, (value) => ({
+				loading: false,
+				tone: "success",
+				title: typeof success === "function" ? success(value) : success
+			}), (reason) => ({
+				loading: false,
+				tone: "danger",
+				title: typeof error === "function" ? error(reason) : error
+			}), onAction);
+		},
+		pauseAll: controller.pauseAll,
+		resumeAll: controller.resumeAll,
 		setConfig: (next) => configSource.set(next),
 		dispose: () => {
+			stack?.dispose();
+			stack = null;
+			stackGroup = null;
 			if (mounted) app.unmount();
-			disposed = true;
-			queue.value = [];
+			controller.dispose();
 			if (!target) holder.remove();
 		}
 	};

package/dist/services/toast-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"toast-service.js","names":[],"sources":["../../src/services/toast-service.ts"],"sourcesContent":["// 全局命令式轻提示服务：自带一个挂到 body 的宿主应用与默认渲染模板，\n// info/success 等命令在任意模块作用域可调（请求拦截器、store），\n// 不要求调用点在组件树内。\n//\n// 队列是本服务的私事，没有对应的容器组件：一次操作的反馈落在哪儿是整个服务的口径，\n// 不该让每个业务页面各挂一份容器再各自决定。\nimport type { ToastOptions, ToastPlacement, ToastRecord, ToastTranslations, ToastType } from '@xihan-ui/headless'\nimport type { App, MaybeRefOrGetter, VNode } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { TOAST_DURATION, TOAST_GAP, TOAST_PLACEMENT, toastAnatomy } from '@xihan-ui/headless'\nimport { DATA_INERT_EXEMPT, ensurePortalRoot } from '@xihan-ui/kernel'\nimport { createApp, defineComponent, Fragment, h, shallowRef, toValue } from 'vue'\nimport { XhToastCloseTrigger, XhToastRoot, XhToastTitle } from '../components/toast/toast'\nimport { typeGlyph } from './glyph'\nimport { mountServiceHost } from './mount-host'\nimport { createServiceConfig } from './service-config'\n\nconst parts = toastAnatomy.build()\n\n/** 单条没写时的兜底：服务档一次定好，逐条渲染时补进去。 */\ninterface ToastDefaults {\n  duration?: number\n  removeDelay?: number\n  pauseOnPageIdle?: boolean\n}\n\nexport interface ToastServiceOptions extends ToastDefaults {\n  /** 那一摞落在哪儿，默认 'top'：视线正好在刚才操作的地方上方。 */\n  placement?: ToastPlacement\n  /** 最多同时留几条，超出挤掉最旧的，默认 5。 */\n  max?: number\n  /** 摞内间距（px），默认 16。 */\n  gap?: number\n  /** toast 部件的文案（关闭钮的读屏名等）。 */\n  toastTranslations?: MaybeRefOrGetter<Partial<ToastTranslations>>\n  /**\n   * 喂给轻提示子树的全局配置（locale / translations / size / portalContainer）。\n   * 本服务自带宿主应用，接不到组件树里的 provideXhConfig，要让它跟应用同语言就从这里给；\n   * 传 ref/getter 即可运行期跟着切语言，也可以之后用 setConfig 推。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；不给就在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\n/** 类型糖的入参：只差 type，其余同 create。 */\nexport type ToastMessageOptions = Omit<ToastOptions, 'type' | 'title'>\n\nexport interface ToastService {\n  /** 入队并返回 id；同 id 已存在则就地改写。 */\n  create: (options?: ToastOptions) => string\n  update: (id: string, options: Partial<ToastOptions>) => void\n  /** 立刻从队列里删掉。条子自己的关闭按钮走的是退场窗口，有退场动画。 */\n  dismiss: (id: string) => void\n  dismissAll: () => void\n  info: (message: string, options?: ToastMessageOptions) => string\n  success: (message: string, options?: ToastMessageOptions) => string\n  warning: (message: string, options?: ToastMessageOptions) => string\n  error: (message: string, options?: ToastMessageOptions) => string\n  /** 返回 id，之后用 update(id, { type: 'success', title: … }) 收尾。 */\n  loading: (message: string, options?: ToastMessageOptions) => string\n  /** 换一份全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\n/**\n * 这一条会不会自己走掉。loading 一直挂着，duration <= 0 与非有限值也是。\n * 走不掉的必须留个出口，否则界面上一个可点、可聚焦的节点都没有。\n */\nfunction selfDismissing(toast: ToastRecord, defaults: ToastDefaults): boolean {\n  if (toast.type === 'loading')\n    return false\n  const duration = toast.duration ?? defaults.duration ?? TOAST_DURATION\n  return Number.isFinite(duration) && duration > 0\n}\n\nfunction defaultToast(\n  toast: ToastRecord,\n  defaults: ToastDefaults,\n  translations: Partial<ToastTranslations> | undefined,\n  onUnmounted: (id: string) => void,\n): VNode {\n  // 到点自己走的默认不出叉，多一颗叉就多一个「要不要点」的判断；\n  // 走不掉的反过来默认给叉。两者都能用 closable 显式改口\n  const closable = toast.closable ?? !selfDismissing(toast, defaults)\n  // 语气跟着 connect 的缺省走（type 缺席即 info），字形不能在这儿另算一份——\n  // 算差了就成了「整条蓝淡底、却没有字形」的半截态\n  const type = toast.type ?? 'info'\n  return h(XhToastRoot, {\n    id: toast.id,\n    title: toast.title,\n    type,\n    // 单条 > 服务档 > 机器内建默认\n    duration: toast.duration ?? defaults.duration,\n    removeDelay: toast.removeDelay ?? defaults.removeDelay,\n    closable,\n    pauseOnPageIdle: defaults.pauseOnPageIdle,\n    translations,\n    onStatusChange: ({ id, status }: { id: string, status: string }) => {\n      if (status === 'unmounted')\n        onUnmounted(id)\n    },\n  }, () => [\n    // 三个节点平铺，不再套一层行容器：横排是皮肤的事，模板套一层只会与它打架\n    typeGlyph(type),\n    h(XhToastTitle),\n    closable ? h(XhToastCloseTrigger) : null,\n  ])\n}\n\nexport function createToastService(options: ToastServiceOptions = {}): ToastService {\n  if (typeof document === 'undefined')\n    throw new Error('createToastService 需要 document；SSR 里请等到客户端再创建')\n\n  const {\n    target,\n    toastTranslations,\n    config,\n    placement = TOAST_PLACEMENT,\n    gap = TOAST_GAP,\n    max = 5,\n    ...defaults\n  } = options\n  const configSource = createServiceConfig(config)\n  const holder = target ?? document.createElement('div')\n  if (!target)\n    ensurePortalRoot(document).appendChild(holder)\n\n  // 队列本身就是全部状态，没有第二种模式，也没有第二个使用者：一个数组足够，不必上机器\n  const queue = shallowRef<ToastRecord[]>([])\n  let seq = 0\n\n  const indexOf = (id: string): number => queue.value.findIndex(item => item.id === id)\n\n  const create = (opts: ToastOptions = {}): string => {\n    const id = opts.id ?? `toast-${++seq}`\n    const at = indexOf(id)\n    // 同 id 视为就地改写（loading 转 success 走的就是这条），位置不动\n    if (at >= 0) {\n      const next = queue.value.slice()\n      next[at] = { ...next[at]!, ...opts, id }\n      queue.value = next\n      return id\n    }\n    const next = [...queue.value, { ...opts, id }]\n    // 超出上限就挤掉最旧的；<=0 与非有限数一并按不限处理\n    queue.value = Number.isFinite(max) && max > 0 && next.length > max ? next.slice(next.length - max) : next\n    return id\n  }\n\n  const update = (id: string, opts: Partial<ToastOptions>): void => {\n    const at = indexOf(id)\n    if (at < 0)\n      return\n    const next = queue.value.slice()\n    next[at] = { ...next[at]!, ...opts, id }\n    queue.value = next\n  }\n\n  const remove = (id: string): void => {\n    const next = queue.value.filter(item => item.id !== id)\n    if (next.length !== queue.value.length)\n      queue.value = next\n  }\n\n  const Host = defineComponent({\n    name: 'XhToastServiceHost',\n    setup() {\n      configSource.provide()\n      return () => h(\n        'div',\n        // 摞没有对应的容器组件，属性直接从解剖里取\n        {\n          ...parts.group.attrs,\n          'data-placement': placement,\n          'data-count': queue.value.length,\n          'style': { gap: `${gap}px` },\n          // 模态浮层给背景施加 inert 时跳过这一摞：轻提示画在遮罩之上，\n          // 一并罩住就成了看得见、点不动、读屏也跳过\n          [DATA_INERT_EXEMPT]: '',\n          // 队列空着时整面定位面撤掉：留着白白多一个罩住整块视口的合成层\n          'hidden': queue.value.length === 0 || undefined,\n        },\n        // 按队列身份 id 给 key，避免节点被就地复用\n        queue.value.map(toast => h(Fragment, { key: toast.id }, [\n          defaultToast(toast, defaults, toValue(toastTranslations), remove),\n        ])),\n      )\n    },\n  })\n\n  const app: App = createApp(Host)\n  const mounted = mountServiceHost(app, holder, 'toast')\n  let disposed = false\n\n  /**\n   * 宿主没挂起来时命令一律空转：把提示丢掉好过让调用点（拦截器、store）连锁崩掉。\n   * 已卸载则是另一回事——那是调用方拿着一个死服务在用，明说好过静默吞掉。\n   */\n  const alive = (): boolean => {\n    if (disposed)\n      throw new Error('toast 服务已卸载')\n    return mounted\n  }\n  const sugar = (type: ToastType) => (message: string, opts: ToastMessageOptions = {}): string =>\n    alive() ? create({ ...opts, type, title: message }) : ''\n\n  return {\n    create: opts => (alive() ? create(opts) : ''),\n    update: (id, opts) => {\n      if (alive())\n        update(id, opts)\n    },\n    dismiss: (id) => {\n      if (alive())\n        remove(id)\n    },\n    dismissAll: () => {\n      if (alive())\n        queue.value = []\n    },\n    info: sugar('info'),\n    success: sugar('success'),\n    warning: sugar('warning'),\n    error: sugar('error'),\n    loading: sugar('loading'),\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      if (mounted)\n        app.unmount()\n      disposed = true\n      queue.value = []\n      if (!target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"toast-service.js","names":[],"sources":["../../src/services/toast-service.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// 全局命令式轻提示服务：自带一个挂到 body 的宿主应用与默认渲染模板，\n// info/success 等命令在任意模块作用域可调（请求拦截器、store），\n// 不要求调用点在组件树内。\n//\n// 摞落在哪儿是整个服务的口径，不该让每个业务页面各挂一份容器再各自决定，\n// 因此这里没有对应的容器组件；队列本身跑的是 notification 那台队列机器，\n// 上限、挤条与合并计数全库一份实现。\nimport type {\n  NotificationDedupe,\n  ToastOptions,\n  ToastPlacement,\n  ToastRecord,\n  ToastServiceDefaults,\n  ToastTone,\n  ToastTranslations,\n} from '@xihan-ui/headless'\nimport type { App, MaybeRefOrGetter, VNode } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { DATA_INERT_EXEMPT, ensurePortalRoot } from '@xihan-ui/core'\nimport {\n  connectNotification,\n  createFeedbackServiceController,\n  createToastStackController,\n  notificationMachine,\n  resolveToastServiceItem,\n  TOAST_GAP,\n  TOAST_MAX,\n  TOAST_PLACEMENT,\n  toastAnatomy,\n  visibleNotifications,\n} from '@xihan-ui/headless'\nimport { computed, createApp, defineComponent, Fragment, h, shallowRef, toValue } from 'vue'\nimport {\n  XhToastActionTrigger,\n  XhToastCloseTrigger,\n  XhToastContent,\n  XhToastDescription,\n  XhToastIndicator,\n  XhToastRoot,\n  XhToastTitle,\n} from '../components/toast/toast'\nimport { vueNormalize } from '../runtime/normalize-props'\nimport { useMachine } from '../runtime/use-machine'\nimport { mountServiceHost } from './mount-host'\nimport { createServiceConfig } from './service-config'\n\nconst parts = toastAnatomy.build()\n\nexport interface ToastServiceOptions extends ToastServiceDefaults {\n  /** 堆叠区的位置，默认 'bottom'。 */\n  placement?: ToastPlacement\n  /** 最多同时保留几条，默认 3；超出时先移除低优先级的，同级中移除最旧的。 */\n  max?: number\n  /** 重复的判定方式，默认 'id'；传 'content' 则同一内容合并为一条并计数。 */\n  dedupe?: NotificationDedupe\n  /** 堆叠内间距（px），默认 12。 */\n  gap?: number\n  /** toast 部件的文案（关闭按钮的读屏名等）。 */\n  toastTranslations?: MaybeRefOrGetter<Partial<ToastTranslations>>\n  /**\n   * 提供给轻提示子树的全局配置（locale / translations / size / portalContainer）。\n   * 本服务自带宿主应用，无法接收组件树中的 provideXhConfig，需要与应用同语言时从这里提供；\n   * 传 ref/getter 即可在运行期跟随切换语言，也可以之后用 setConfig 推送。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；未提供时在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\n/**\n * create 的入参。`actionLabel` 是提示条上行内动作按钮的文案，`onAction` 是按下它执行的动作：\n * 回调不进入队列记录（该记录要能被整份替换、序列化、比对），服务按 id 单独保存一张表。\n */\nexport interface ToastCreateOptions extends ToastOptions {\n  onAction?: () => void\n}\n\n/** 语气糖的入参：只差 tone / loading，其余同 create。 */\nexport type ToastMessageOptions = Omit<ToastCreateOptions, 'tone' | 'loading' | 'title'>\n\n/** promise 三态的文案：成功与失败可以传函数，拿到结果后再拼装文案。 */\nexport interface ToastPromiseOptions<T> extends Omit<ToastMessageOptions, 'duration'> {\n  loading: string\n  success: string | ((value: T) => string)\n  error: string | ((reason: unknown) => string)\n}\n\nexport interface ToastService {\n  /** 入队并返回 id；同 id 已存在则就地改写，被合并的返回被并入的那一条。 */\n  create: (options?: ToastCreateOptions) => string\n  update: (id: string, options: Partial<ToastOptions>) => void\n  /** 立即从队列中删除。提示条自己的关闭按钮经退场窗口，带退场动画。 */\n  dismiss: (id: string) => void\n  dismissAll: () => void\n  info: (message: string, options?: ToastMessageOptions) => string\n  success: (message: string, options?: ToastMessageOptions) => string\n  warning: (message: string, options?: ToastMessageOptions) => string\n  danger: (message: string, options?: ToastMessageOptions) => string\n  /** 返回 id，之后用 update(id, { loading: false, tone: 'success', title: … }) 收尾。 */\n  loading: (message: string, options?: ToastMessageOptions) => string\n  /**\n   * 先显示一条 loading，Promise 落定后就地改写为 success / danger。\n   * 返回该条的 id；Promise 的结果原样交回调用方，拒绝也照旧拒绝。\n   */\n  promise: <T>(input: Promise<T> | (() => Promise<T>), options: ToastPromiseOptions<T>) => Promise<T>\n  /** 暂停当前堆叠的计时，'service' 这一路与指针、焦点并存。 */\n  pauseAll: () => void\n  resumeAll: () => void\n  /** 更换全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\nfunction defaultToast(\n  toast: ToastRecord,\n  defaults: ToastServiceDefaults,\n  translations: Partial<ToastTranslations> | undefined,\n  paused: boolean,\n  onUnmounted: (id: string) => void,\n  onAction: (id: string) => void,\n): VNode {\n  const item = resolveToastServiceItem(toast, defaults)\n  return h(XhToastRoot, {\n    id: item.id,\n    title: item.title,\n    description: item.description,\n    tone: item.tone,\n    loading: item.loading,\n    duration: item.duration,\n    removeDelay: item.removeDelay,\n    closable: item.closable,\n    pauseOnPageIdle: item.pauseOnPageIdle,\n    paused,\n    translations,\n    onStatusChange: ({ id, status }: { id: string, status: string }) => {\n      if (status === 'unmounted')\n        onUnmounted(id)\n    },\n    onAction: ({ id }: { id: string }) => onAction(id),\n  }, () => [\n    h(XhToastIndicator),\n    h(XhToastContent, () => [\n      h(XhToastTitle),\n      item.description ? h(XhToastDescription) : null,\n    ]),\n    item.actionLabel ? h(XhToastActionTrigger, () => item.actionLabel) : null,\n    item.closable ? h(XhToastCloseTrigger) : null,\n  ])\n}\n\nexport function createToastService(options: ToastServiceOptions = {}): ToastService {\n  if (typeof document === 'undefined')\n    throw new Error('createToastService 需要 document；SSR 里请等到客户端再创建')\n\n  const {\n    target,\n    toastTranslations,\n    config,\n    placement = TOAST_PLACEMENT,\n    gap = TOAST_GAP,\n    max = TOAST_MAX,\n    dedupe,\n    ...defaults\n  } = options\n  const serviceDefaults: ToastServiceDefaults = {\n    ...defaults,\n    pauseOnPageIdle: defaults.pauseOnPageIdle ?? true,\n  }\n  const configSource = createServiceConfig(config)\n  const holder = target ?? document.createElement('div')\n  if (!target)\n    ensurePortalRoot(document).appendChild(holder)\n\n  let publishState: (paused: boolean) => void = () => {}\n  const controller = createFeedbackServiceController<ToastOptions, Partial<ToastOptions>>({\n    name: 'toast',\n    idPrefix: 'toast',\n    onStateChange: state => publishState(state.paused),\n  })\n  const pausedAll = shallowRef(controller.state.paused)\n  publishState = paused => void (pausedAll.value = paused)\n  let stack: ReturnType<typeof createToastStackController> | null = null\n  let stackGroup: HTMLElement | null = null\n  const bindGroup = (group: unknown): void => {\n    const next = group instanceof HTMLElement ? group : null\n    if (next === stackGroup)\n      return\n    stack?.dispose()\n    stackGroup = next\n    stack = next\n      ? createToastStackController({\n          group: next,\n          gap,\n          placement,\n          onInteractionChange: active => active ? controller.pauseAll() : controller.resumeAll(),\n        })\n      : null\n  }\n\n  const Host = defineComponent({\n    name: 'XhToastServiceHost',\n    setup() {\n      configSource.provide()\n      // 队列机器在 setup 里当场 start：它没有 DOM 锚点，而端口紧接着就接上。\n      // 等 mounted 再 start 的话，从业务组件的 onMounted 懒建本服务时，宿主的 mounted\n      // 会排到调用方那条 post-flush 队列的队尾，调用方接着发的第一条命令就撞上 SEND_BEFORE_MOUNT\n      const service = useMachine(notificationMachine, () => ({\n        placement,\n        max,\n        dedupe,\n        duration: serviceDefaults.duration,\n        removeDelay: serviceDefaults.removeDelay,\n        pauseOnPageIdle: serviceDefaults.pauseOnPageIdle,\n      }), undefined, { start: 'setup' })\n      const api = computed(() => connectNotification(service, vueNormalize))\n      // 渲染读原始记录，保留 Toast 自己的标题计数与可选说明投影。\n      const items = computed(() => visibleNotifications(service.context.get('items'), max, placement))\n      controller.attach({\n        create: opts => api.value.create(opts),\n        update: (id, opts) => api.value.update(id, opts),\n        dismiss: id => api.value.dismiss(id),\n        dismissAll: () => api.value.dismissAll(),\n      })\n      return () => {\n        controller.syncItems(items.value.map(item => item.id))\n        return h(\n          'div',\n          // 摞没有对应的容器组件，属性直接从解剖里取\n          {\n            ...parts.group.attrs,\n            'ref': bindGroup,\n            'data-placement': placement,\n            'data-count': items.value.length,\n            // 模态浮层给背景施加 inert 时跳过这一摞：轻提示画在遮罩之上，\n            // 一并罩住就成了看得见、点不动、读屏也跳过\n            [DATA_INERT_EXEMPT]: '',\n            // 队列空着时整面定位面撤掉：留着白白多一个罩住整块视口的合成层\n            'hidden': items.value.length === 0 || undefined,\n          },\n          // 按队列身份 id 给 key，避免节点被就地复用\n          items.value.map(toast => h(Fragment, { key: toast.id }, [\n            defaultToast(\n              toast,\n              serviceDefaults,\n              toValue(toastTranslations),\n              pausedAll.value,\n              controller.unmounted,\n              controller.invokeAction,\n            ),\n          ])),\n        )\n      }\n    },\n  })\n\n  const app: App = createApp(Host)\n  const mounted = mountServiceHost(app, holder, 'toast')\n  if (!mounted)\n    controller.attach(null)\n\n  /** 入队一条；回调另存一张表，队列记录中只保留文案。 */\n  const create = (opts: ToastCreateOptions = {}): string => {\n    const { onAction, ...record } = opts\n    return controller.create(record, onAction)\n  }\n\n  const sugar = (tone: ToastTone) => (message: string, opts: ToastMessageOptions = {}): string =>\n    create({ ...opts, tone, title: message })\n\n  return {\n    create,\n    update: controller.update,\n    dismiss: controller.dismiss,\n    dismissAll: controller.dismissAll,\n    info: sugar('info'),\n    success: sugar('success'),\n    warning: sugar('warning'),\n    danger: sugar('danger'),\n    loading: (message, opts = {}) => create({ ...opts, loading: true, title: message }),\n    promise: <T>(input: Promise<T> | (() => Promise<T>), opts: ToastPromiseOptions<T>): Promise<T> => {\n      const { loading, success, error, ...rest } = opts\n      const running = typeof input === 'function' ? input() : input\n      const { onAction, ...record } = rest\n      return controller.trackPromise(\n        running,\n        { ...record, loading: true, title: loading },\n        value => ({ loading: false, tone: 'success', title: typeof success === 'function' ? success(value) : success }),\n        reason => ({ loading: false, tone: 'danger', title: typeof error === 'function' ? error(reason) : error }),\n        onAction,\n      )\n    },\n    pauseAll: controller.pauseAll,\n    resumeAll: controller.resumeAll,\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      stack?.dispose()\n      stack = null\n      stackGroup = null\n      if (mounted)\n        app.unmount()\n      controller.dispose()\n      if (!target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":";;;;;;;;;AAmDA,MAAM,QAAQ,aAAa,MAAM;AAoEjC,SAAS,aACP,OACA,UACA,cACA,QACA,aACA,UACO;CACP,MAAM,OAAO,wBAAwB,OAAO,QAAQ;CACpD,OAAO,EAAE,aAAa;EACpB,IAAI,KAAK;EACT,OAAO,KAAK;EACZ,aAAa,KAAK;EAClB,MAAM,KAAK;EACX,SAAS,KAAK;EACd,UAAU,KAAK;EACf,aAAa,KAAK;EAClB,UAAU,KAAK;EACf,iBAAiB,KAAK;EACtB;EACA;EACA,iBAAiB,EAAE,IAAI,aAA6C;GAClE,IAAI,WAAW,aACb,YAAY,EAAE;EAClB;EACA,WAAW,EAAE,SAAyB,SAAS,EAAE;CACnD,SAAS;EACP,EAAE,gBAAgB;EAClB,EAAE,sBAAsB,CACtB,EAAE,YAAY,GACd,KAAK,cAAc,EAAE,kBAAkB,IAAI,IAC7C,CAAC;EACD,KAAK,cAAc,EAAE,4BAA4B,KAAK,WAAW,IAAI;EACrE,KAAK,WAAW,EAAE,mBAAmB,IAAI;CAC3C,CAAC;AACH;AAEA,SAAgB,mBAAmB,UAA+B,CAAC,GAAiB;CAClF,IAAI,OAAO,aAAa,aACtB,MAAM,IAAI,MAAM,+CAA+C;CAEjE,MAAM,EACJ,QACA,mBACA,QACA,YAAY,iBACZ,MAAM,WACN,MAAM,WACN,QACA,GAAG,aACD;CACJ,MAAM,kBAAwC;EAC5C,GAAG;EACH,iBAAiB,SAAS,mBAAmB;CAC/C;CACA,MAAM,eAAe,oBAAoB,MAAM;CAC/C,MAAM,SAAS,UAAU,SAAS,cAAc,KAAK;CACrD,IAAI,CAAC,QACH,iBAAiB,QAAQ,CAAC,CAAC,YAAY,MAAM;CAE/C,IAAI,qBAAgD,CAAC;CACrD,MAAM,aAAa,gCAAqE;EACtF,MAAM;EACN,UAAU;EACV,gBAAe,UAAS,aAAa,MAAM,MAAM;CACnD,CAAC;CACD,MAAM,YAAY,WAAW,WAAW,MAAM,MAAM;CACpD,gBAAe,WAAU,MAAM,UAAU,QAAQ;CACjD,IAAI,QAA8D;CAClE,IAAI,aAAiC;CACrC,MAAM,aAAa,UAAyB;EAC1C,MAAM,OAAO,iBAAiB,cAAc,QAAQ;EACpD,IAAI,SAAS,YACX;EACF,OAAO,QAAQ;EACf,aAAa;EACb,QAAQ,OACJ,2BAA2B;GACzB,OAAO;GACP;GACA;GACA,sBAAqB,WAAU,SAAS,WAAW,SAAS,IAAI,WAAW,UAAU;EACvF,CAAC,IACD;CACN;CA0DA,MAAM,MAAW,UAxDJ,gBAAgB;EAC3B,MAAM;EACN,QAAQ;GACN,aAAa,QAAQ;GAIrB,MAAM,UAAU,WAAW,4BAA4B;IACrD;IACA;IACA;IACA,UAAU,gBAAgB;IAC1B,aAAa,gBAAgB;IAC7B,iBAAiB,gBAAgB;GACnC,IAAI,KAAA,GAAW,EAAE,OAAO,QAAQ,CAAC;GACjC,MAAM,MAAM,eAAe,oBAAoB,SAAS,YAAY,CAAC;GAErE,MAAM,QAAQ,eAAe,qBAAqB,QAAQ,QAAQ,IAAI,OAAO,GAAG,KAAK,SAAS,CAAC;GAC/F,WAAW,OAAO;IAChB,SAAQ,SAAQ,IAAI,MAAM,OAAO,IAAI;IACrC,SAAS,IAAI,SAAS,IAAI,MAAM,OAAO,IAAI,IAAI;IAC/C,UAAS,OAAM,IAAI,MAAM,QAAQ,EAAE;IACnC,kBAAkB,IAAI,MAAM,WAAW;GACzC,CAAC;GACD,aAAa;IACX,WAAW,UAAU,MAAM,MAAM,KAAI,SAAQ,KAAK,EAAE,CAAC;IACrD,OAAO,EACL,OAEA;KACE,GAAG,MAAM,MAAM;KACf,OAAO;KACP,kBAAkB;KAClB,cAAc,MAAM,MAAM;MAGzB,oBAAoB;KAErB,UAAU,MAAM,MAAM,WAAW,KAAK,KAAA;IACxC,GAEA,MAAM,MAAM,KAAI,UAAS,EAAE,UAAU,EAAE,KAAK,MAAM,GAAG,GAAG,CACtD,aACE,OACA,iBACA,QAAQ,iBAAiB,GACzB,UAAU,OACV,WAAW,WACX,WAAW,YACb,CACF,CAAC,CAAC,CACJ;GACF;EACF;CACF,CAE8B,CAAC;CAC/B,MAAM,UAAU,iBAAiB,KAAK,QAAQ,OAAO;CACrD,IAAI,CAAC,SACH,WAAW,OAAO,IAAI;;CAGxB,MAAM,UAAU,OAA2B,CAAC,MAAc;EACxD,MAAM,EAAE,UAAU,GAAG,WAAW;EAChC,OAAO,WAAW,OAAO,QAAQ,QAAQ;CAC3C;CAEA,MAAM,SAAS,UAAqB,SAAiB,OAA4B,CAAC,MAChF,OAAO;EAAE,GAAG;EAAM;EAAM,OAAO;CAAQ,CAAC;CAE1C,OAAO;EACL;EACA,QAAQ,WAAW;EACnB,SAAS,WAAW;EACpB,YAAY,WAAW;EACvB,MAAM,MAAM,MAAM;EAClB,SAAS,MAAM,SAAS;EACxB,SAAS,MAAM,SAAS;EACxB,QAAQ,MAAM,QAAQ;EACtB,UAAU,SAAS,OAAO,CAAC,MAAM,OAAO;GAAE,GAAG;GAAM,SAAS;GAAM,OAAO;EAAQ,CAAC;EAClF,UAAa,OAAwC,SAA6C;GAChG,MAAM,EAAE,SAAS,SAAS,OAAO,GAAG,SAAS;GAC7C,MAAM,UAAU,OAAO,UAAU,aAAa,MAAM,IAAI;GACxD,MAAM,EAAE,UAAU,GAAG,WAAW;GAChC,OAAO,WAAW,aAChB,SACA;IAAE,GAAG;IAAQ,SAAS;IAAM,OAAO;GAAQ,IAC3C,WAAU;IAAE,SAAS;IAAO,MAAM;IAAW,OAAO,OAAO,YAAY,aAAa,QAAQ,KAAK,IAAI;GAAQ,KAC7G,YAAW;IAAE,SAAS;IAAO,MAAM;IAAU,OAAO,OAAO,UAAU,aAAa,MAAM,MAAM,IAAI;GAAM,IACxG,QACF;EACF;EACA,UAAU,WAAW;EACrB,WAAW,WAAW;EACtB,YAAW,SAAQ,aAAa,IAAI,IAAI;EACxC,eAAe;GACb,OAAO,QAAQ;GACf,QAAQ;GACR,aAAa;GACb,IAAI,SACF,IAAI,QAAQ;GACd,WAAW,QAAQ;GACnB,IAAI,CAAC,QACH,OAAO,OAAO;EAClB;CACF;AACF"}