@xihan-ui/vue 1.0.0 → 2.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"dialog-service.js","names":[],"sources":["../../src/services/dialog-service.ts"],"sourcesContent":["// 全局命令式确认框服务：confirm/info/success/warning/error 一次调用弹出，\n// 自带标题徽记、正文与按钮行。同一时刻只挂一个对话框，后来的排队顺次弹出，\n// 避开多层模态叠加。onOk 返回 Promise 时确认钮自动进入 pending 并拦住关闭，\n// 失败保持打开以便重试或取消。\nimport type { Tone } from '@xihan-ui/kernel'\nimport type { App, MaybeRefOrGetter, VNodeChild } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { ensurePortalRoot } from '@xihan-ui/kernel'\nimport { createApp, defineComponent, h, reactive, shallowRef, toRaw, toValue } from 'vue'\nimport { XhButton, XhButtonIndicator, XhButtonLabel } from '../components/button'\nimport { XhDialogContent, XhDialogDescription, XhDialogRoot, XhDialogTitle } from '../components/dialog/dialog'\nimport { spinArc, typeBadge } from './glyph'\nimport { mountServiceHost } from './mount-host'\nimport { createServiceConfig } from './service-config'\n\n/**\n * 对话框正文。给串走 description 部件（读屏的 aria-describedby 由它接）；\n * 给渲染函数则整块摊在正文位，自己决定渲染什么。\n *\n * 不收裸 VNode：服务的宿主是常驻的，忙态一翻就整棵重渲，\n * 同一个 VNode 实例被复用时的行为未定义。\n */\nexport type DialogBody = string | (() => VNodeChild)\n\nexport interface ConfirmOptions {\n  title: string\n  content?: DialogBody\n  /** 确认钮语气，默认 brand；危险操作传 danger。 */\n  tone?: Tone\n  /** 标题旁的类型徽记。不给则不出徽记。 */\n  badge?: 'info' | 'success' | 'warning' | 'error'\n  okText?: MaybeRefOrGetter<string>\n  cancelText?: MaybeRefOrGetter<string>\n  /** Promise 拒绝时对话框保持打开。 */\n  onOk?: () => void | Promise<unknown>\n}\n\n/** 单按钮告知框的入参：没有取消钮，徽记由预设档自己定，其余同 confirm。 */\nexport type AlertOptions = Omit<ConfirmOptions, 'tone' | 'badge'>\n\n/** 取值型弹窗的入参。正文自己拼表单，确认时把那份值带回来。 */\nexport interface PromptOptions<T extends object> extends Omit<ConfirmOptions, 'onOk' | 'content'> {\n  /** 每次打开建一份初值；服务用 reactive 包起来交给 body 与 onOk，两边同一份。 */\n  initialValue: T\n  /** 用那份可写代理渲染表单主体。 */\n  body: (value: T) => VNodeChild\n  /** 落焦到哪个节点，CSS 选择器。 */\n  initialFocus?: string\n  /** 返回 false（或拒绝）表示校验没过，弹窗保持打开。 */\n  onOk?: (value: T) => boolean | void | Promise<boolean | void>\n}\n\nexport interface DialogServiceOptions {\n  /** 确认钮文案，缺省 OK。 */\n  okText?: MaybeRefOrGetter<string>\n  /** 取消钮文案，缺省 Cancel。 */\n  cancelText?: MaybeRefOrGetter<string>\n  /**\n   * 喂给对话框子树的全局配置（locale / translations / size / portalContainer）。\n   * 本服务自带宿主应用，接不到组件树里的 provideXhConfig，要让它跟应用同语言就从这里给；\n   * 传 ref/getter 即可运行期跟着切语言，也可以之后用 setConfig 推。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；不给就在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\nexport interface DialogService {\n  /** 确认走 onOk 后 resolve true；取消/Esc resolve false。 */\n  confirm: (options: ConfirmOptions) => Promise<boolean>\n  info: (options: AlertOptions) => Promise<void>\n  success: (options: AlertOptions) => Promise<void>\n  warning: (options: AlertOptions) => Promise<void>\n  error: (options: AlertOptions) => Promise<void>\n  /** 确认后 resolve 一份值的普通对象快照；取消 / Esc / 卸载 resolve null。 */\n  prompt: <T extends object>(options: PromptOptions<T>) => Promise<T | null>\n  /** 换一份全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\ninterface Spec {\n  title: string\n  content?: DialogBody\n  tone: Tone\n  okText: MaybeRefOrGetter<string>\n  cancelText: MaybeRefOrGetter<string>\n  showCancel: boolean\n  /** 标题旁的类型徽记（预设档用），confirm 不带。 */\n  badge?: 'info' | 'success' | 'warning' | 'error'\n  /** 返回 false 表示不放行；confirm 那一路的返回值不参与判定。 */\n  onOk?: () => unknown\n  /** 取值型弹窗的正文与那份可写的值，两边同一个对象。 */\n  body?: (value: object) => VNodeChild\n  value?: object\n  initialFocus?: string\n  resolve: (ok: boolean) => void\n  settled: boolean\n}\n\n/** 关到再开之间留出退场窗口，动效走完再放下一个。 */\nconst EXIT_WINDOW_MS = 250\n\nexport function createDialogService(options: DialogServiceOptions = {}): DialogService {\n  if (typeof document === 'undefined')\n    throw new Error('createDialogService 需要 document；SSR 里请等到客户端再创建')\n\n  // 文案不在创建时求值：队列里的对话框会跨过一次切语言\n  const defaults = { okText: options.okText ?? 'OK', cancelText: options.cancelText ?? 'Cancel' }\n  const configSource = createServiceConfig(options.config)\n  const holder = options.target ?? document.createElement('div')\n  if (!options.target)\n    ensurePortalRoot(document).appendChild(holder)\n\n  // 当前项单独放 shallowRef：进 reactive 会把 Spec 里那几个 MaybeRefOrGetter 的 Ref 分支解包掉\n  const current = shallowRef<Spec | null>(null)\n  const state = reactive({\n    open: false,\n    busy: false,\n  })\n  const queue: Spec[] = []\n  let disposed = false\n  let advanceTimer: ReturnType<typeof setTimeout> | null = null\n\n  function next(): void {\n    if (disposed || current.value || queue.length === 0)\n      return\n    current.value = queue.shift()!\n    state.busy = false\n    state.open = true\n  }\n\n  function settle(ok: boolean): void {\n    const spec = current.value\n    if (!spec || spec.settled)\n      return\n    spec.settled = true\n    spec.resolve(ok)\n  }\n\n  /** 退场窗口走完再清当前项、放下一个；程序化关闭与机器侧关闭都汇到这里，只挂一只表。 */\n  function scheduleAdvance(): void {\n    if (advanceTimer)\n      return\n    advanceTimer = setTimeout(() => {\n      advanceTimer = null\n      current.value = null\n      state.busy = false\n      next()\n    }, EXIT_WINDOW_MS)\n  }\n\n  function close(ok: boolean): void {\n    settle(ok)\n    state.open = false\n    scheduleAdvance()\n  }\n\n  // 机器侧的关闭（Esc 等）从这里回来：未定的一律按取消结\n  function onOpenChange(open: boolean): void {\n    if (open)\n      return\n    settle(false)\n    state.open = false\n    scheduleAdvance()\n  }\n\n  async function ok(): Promise<void> {\n    const spec = current.value\n    if (!spec || state.busy)\n      return\n    if (spec.onOk) {\n      state.busy = true\n      try {\n        // 取值型弹窗的 onOk 收 false 表示校验没过，对话框保持打开；\n        // confirm 的 onOk 签名不吃 false，语义不受影响\n        const verdict = await spec.onOk()\n        if (verdict === false) {\n          state.busy = false\n          return\n        }\n      }\n      catch (err) {\n        state.busy = false\n        console.error('[xh] confirm onOk 失败，对话框保持打开', err)\n        return\n      }\n      state.busy = false\n    }\n    close(true)\n  }\n\n  function request(spec: Omit<Spec, 'resolve' | 'settled'>): Promise<boolean> {\n    if (disposed)\n      return Promise.reject(new Error('dialog 服务已卸载'))\n    return new Promise<boolean>((resolve) => {\n      queue.push({ ...spec, resolve, settled: false })\n      next()\n    })\n  }\n\n  const Host = defineComponent({\n    name: 'XhDialogServiceHost',\n    setup() {\n      configSource.provide()\n      return () => {\n        const spec = current.value\n        return h(XhDialogRoot, {\n          'open': state.open,\n          'onUpdate:open': onOpenChange,\n          'modal': true,\n          'role': 'alertdialog',\n          'closeOnEscape': !state.busy,\n          'closeOnInteractOutside': false,\n          'initialFocus': spec?.initialFocus,\n        }, () => spec\n          ? h(XhDialogContent, null, () => [\n              h('div', { 'style': { display: 'flex', alignItems: 'center', gap: 'var(--xh-control-gap-md)' }, 'data-tone': spec.badge ? toneOfBadge(spec.badge) : undefined }, [\n                spec.badge ? typeBadge(spec.badge) : null,\n                h(XhDialogTitle, () => spec.title),\n              ]),\n              // 串走 description（读屏的 aria-describedby 接在它上面），渲染函数直接摊开\n              typeof spec.content === 'string'\n                ? h(XhDialogDescription, () => spec.content as string)\n                : typeof spec.content === 'function' ? spec.content() : null,\n              spec.body && spec.value ? spec.body(spec.value) : null,\n              h('div', { style: { display: 'flex', justifyContent: 'flex-end', gap: 'var(--xh-control-gap-md)' } }, [\n                spec.showCancel\n                  ? h(XhButton, { variant: 'ghost', disabled: state.busy, onClick: () => close(false) }, () => toValue(spec.cancelText))\n                  : null,\n                h(XhButton, { variant: 'solid', tone: spec.tone, loading: state.busy, onClick: ok }, () => [\n                  state.busy ? h(XhButtonIndicator, () => spinArc()) : null,\n                  h(XhButtonLabel, () => (state.busy ? `${toValue(spec.okText)}…` : toValue(spec.okText))),\n                ]),\n              ]),\n            ])\n          : null)\n      }\n    },\n  })\n\n  function toneOfBadge(badge: NonNullable<Spec['badge']>): Tone {\n    return badge === 'error' ? 'danger' : badge\n  }\n\n  const app: App = createApp(Host)\n  const mounted = mountServiceHost(app, holder, 'dialog')\n\n  const alert = (badge: NonNullable<Spec['badge']>, tone: Tone) => async (opts: AlertOptions): Promise<void> => {\n    await request({\n      title: opts.title,\n      content: opts.content,\n      tone,\n      okText: opts.okText ?? defaults.okText,\n      cancelText: defaults.cancelText,\n      showCancel: false,\n      badge,\n      onOk: opts.onOk,\n    })\n  }\n\n  return {\n    confirm: opts => request({\n      title: opts.title,\n      content: opts.content,\n      tone: opts.tone ?? 'brand',\n      okText: opts.okText ?? defaults.okText,\n      cancelText: opts.cancelText ?? defaults.cancelText,\n      showCancel: true,\n      badge: opts.badge,\n      onOk: opts.onOk,\n    }),\n    prompt: <T extends object>(opts: PromptOptions<T>): Promise<T | null> => {\n      // body 与 onOk 拿的是同一份可写代理：正文里改了什么，确认时就读到什么\n      const value = reactive({ ...opts.initialValue }) as T\n      return request({\n        title: opts.title,\n        tone: opts.tone ?? 'brand',\n        okText: opts.okText ?? defaults.okText,\n        cancelText: opts.cancelText ?? defaults.cancelText,\n        showCancel: true,\n        badge: opts.badge,\n        initialFocus: opts.initialFocus,\n        body: v => opts.body(v as T),\n        value,\n        onOk: opts.onOk ? () => opts.onOk!(value) : undefined,\n      }).then(ok => (ok ? { ...toRaw(value) } as T : null))\n    },\n    info: alert('info', 'info'),\n    success: alert('success', 'success'),\n    warning: alert('warning', 'warning'),\n    error: alert('error', 'danger'),\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      disposed = true\n      if (advanceTimer) {\n        clearTimeout(advanceTimer)\n        advanceTimer = null\n      }\n      settle(false)\n      for (const spec of queue.splice(0))\n        spec.resolve(false)\n      if (mounted)\n        app.unmount()\n      if (!options.target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"dialog-service.js","names":[],"sources":["../../src/services/dialog-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// 全局命令式确认框服务：confirm/info/success/warning/error 一次调用弹出，\n// 自带标题徽记、正文与按钮行。同一时刻只挂一个对话框，后来的排队顺次弹出，\n// 避开多层模态叠加。onOk 返回 Promise 时确认钮自动进入 pending 并拦住关闭，\n// 失败保持打开以便重试或取消。\nimport type { Tone } from '@xihan-ui/core'\nimport type { DialogServiceBadge, DialogServiceControllerSpec, DialogServiceControllerState } from '@xihan-ui/headless'\nimport type { App, MaybeRefOrGetter, VNodeChild } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { ensurePortalRoot } from '@xihan-ui/core'\nimport { createDialogServiceController, dialogServiceBadgeTone } from '@xihan-ui/headless'\nimport { createApp, defineComponent, h, reactive, shallowRef, toRaw, toValue } from 'vue'\nimport { XhButton, XhButtonIndicator, XhButtonLabel } from '../components/button'\nimport { XhDialogBody, XhDialogContent, XhDialogDescription, XhDialogFooter, XhDialogHeader, XhDialogIndicator, XhDialogRoot, XhDialogTitle } from '../components/dialog/dialog'\nimport { spinArc } from './glyph'\nimport { createServiceConfig } from './service-config'\n\n/**\n * 对话框正文。传字符串时经 description 部件（读屏的 aria-describedby 由它承接）；\n * 传渲染函数时整块展开在正文位，自行决定渲染内容。\n *\n * 不接收裸 VNode：服务的宿主是常驻的，忙态切换即整棵重渲，\n * 同一个 VNode 实例被复用时的行为未定义。\n */\nexport type DialogBody = string | (() => VNodeChild)\n\n/** 动作异常保留原始原因；可见文案由 actionErrorText 提供。 */\nexport interface DialogActionError {\n  cause: unknown\n}\n\nexport interface ConfirmOptions {\n  title: string\n  content?: DialogBody\n  /** 确认按钮语气，默认 brand；危险操作传 danger。 */\n  tone?: Tone\n  /** 标题旁的类型徽记。未提供时不显示徽记。 */\n  badge?: DialogServiceBadge\n  okText?: MaybeRefOrGetter<string>\n  cancelText?: MaybeRefOrGetter<string>\n  /** false 阻止关闭；抛错或 Promise 拒绝进入 actionError，保持打开。 */\n  onOk?: () => boolean | void | Promise<unknown>\n  /** 动作失败通知；通知自身失败时拒绝所属请求。 */\n  onActionError?: (error: DialogActionError) => void | Promise<void>\n}\n\n/** 单按钮告知框的入参：没有取消按钮，徽记由预设档决定，其余同 confirm。 */\nexport type AlertOptions = Omit<ConfirmOptions, 'tone' | 'badge'>\n\n/** 取值型弹窗的入参。正文自行拼装表单，确认时把该份值带回。 */\nexport interface PromptOptions<T extends object> extends Omit<ConfirmOptions, 'onOk' | 'content'> {\n  /** 每次打开建立一份初值；服务用 reactive 包装后交给 body 与 onOk，两边是同一份。 */\n  initialValue: T\n  /** 用该份可写代理渲染表单主体。 */\n  body: (value: T) => VNodeChild\n  /** 落焦到哪个节点，CSS 选择器。 */\n  initialFocus?: string\n  /** false 只阻止关闭；抛错或拒绝进入独立动作异常，弹窗保持打开。 */\n  onOk?: (value: T) => boolean | void | Promise<boolean | void>\n}\n\nexport interface DialogServiceOptions {\n  /** 确认按钮文案，默认 OK。 */\n  okText?: MaybeRefOrGetter<string>\n  /** 取消按钮文案，默认 Cancel。 */\n  cancelText?: MaybeRefOrGetter<string>\n  /** 动作失败时的安全提示，支持与按钮文案相同的响应式来源。 */\n  actionErrorText?: MaybeRefOrGetter<string>\n  /**\n   * 提供给对话框子树的全局配置（locale / translations / size / portalContainer）。\n   * 本服务自带宿主应用，无法接收组件树中的 provideXhConfig，需要与应用同语言时从这里提供；\n   * 传 ref/getter 即可在运行期跟随切换语言，也可以之后用 setConfig 推送。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；未提供时在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\nexport interface DialogService {\n  /** 当前请求的动作异常，重试、关闭和切换请求时清空。 */\n  readonly actionError: DialogActionError | null\n  /** 确认经 onOk 后 resolve true；取消/Esc resolve false。 */\n  confirm: (options: ConfirmOptions) => Promise<boolean>\n  info: (options: AlertOptions) => Promise<void>\n  success: (options: AlertOptions) => Promise<void>\n  warning: (options: AlertOptions) => Promise<void>\n  error: (options: AlertOptions) => Promise<void>\n  /** 确认后 resolve 一份值的普通对象快照；取消 / Esc / 卸载 resolve null。 */\n  prompt: <T extends object>(options: PromptOptions<T>) => Promise<T | null>\n  /** 更换全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\ninterface Spec extends DialogServiceControllerSpec {\n  title: string\n  content?: DialogBody\n  tone: Tone\n  okText: MaybeRefOrGetter<string>\n  cancelText: MaybeRefOrGetter<string>\n  showCancel: boolean\n  /** 标题旁的类型徽记（预设档使用），confirm 不带。 */\n  badge?: DialogServiceBadge\n  /** 返回 false 阻止本次确认；异常由独立错误状态报告。 */\n  onOk?: () => unknown\n  onActionError?: (error: DialogActionError) => void | Promise<void>\n  /** 取值型弹窗的正文与可写的值，两边是同一个对象。 */\n  body?: (value: object) => VNodeChild\n  value?: object\n  initialFocus?: string\n}\n\nexport function createDialogService(options: DialogServiceOptions = {}): DialogService {\n  if (typeof document === 'undefined')\n    throw new Error('createDialogService 需要 document；SSR 里请等到客户端再创建')\n\n  // 文案不在创建时求值：队列里的对话框会跨过一次切语言\n  const defaults = { okText: options.okText ?? 'OK', cancelText: options.cancelText ?? 'Cancel' }\n  const configSource = createServiceConfig(options.config)\n  const holder = options.target ?? document.createElement('div')\n  let hostFailure: { cause: unknown } | null = null\n  try {\n    if (!options.target)\n      ensurePortalRoot(document).appendChild(holder)\n    if (holder.nodeType !== 1 || holder.ownerDocument !== document || !holder.isConnected)\n      throw new Error('DialogService target 必须是当前文档中已连接的元素')\n  }\n  catch (cause) {\n    hostFailure = { cause }\n  }\n\n  // 整份核心快照放 shallowRef：Spec 里的 MaybeRefOrGetter 不能被 reactive 深层解包。\n  let publishState: (next: DialogServiceControllerState<Spec>) => void = () => {}\n  const controller = createDialogServiceController<Spec>({\n    onStateChange: next => publishState(next),\n  })\n  const state = shallowRef(controller.state)\n  publishState = next => void (state.value = next)\n  if (hostFailure)\n    controller.fail(hostFailure.cause)\n\n  // 机器侧的关闭（Esc 等）从这里回来：未定的一律按取消结\n  function onOpenChange(open: boolean): void {\n    if (open)\n      return\n    controller.close(false)\n  }\n\n  const Host = defineComponent({\n    name: 'XhDialogServiceHost',\n    setup() {\n      configSource.provide()\n      return () => {\n        const serviceState = state.value\n        if (serviceState.failure)\n          return null\n        const request = serviceState.current\n        const spec = request?.spec\n        return h(XhDialogRoot, {\n          'open': serviceState.open,\n          'onUpdate:open': onOpenChange,\n          'modal': true,\n          'role': 'alertdialog',\n          'closeOnEscape': !serviceState.busy,\n          'closeOnInteractOutside': false,\n          'initialFocus': spec?.initialFocus,\n          'onExitComplete': () => controller.finishExit(request),\n        }, () => spec\n          ? h(XhDialogContent, null, () => [\n              h(XhDialogHeader, null, () => [\n                spec.badge ? h(XhDialogIndicator, { 'data-tone': dialogServiceBadgeTone(spec.badge) }) : null,\n                h(XhDialogTitle, () => spec.title),\n              ]),\n              h(XhDialogBody, null, () => [\n                // 串走 description，函数正文与 prompt 表单也在唯一滚动区内。\n                typeof spec.content === 'string'\n                  ? h(XhDialogDescription, () => spec.content as string)\n                  : typeof spec.content === 'function' ? spec.content() : null,\n                spec.body && spec.value ? spec.body(spec.value) : null,\n                serviceState.actionError ? h('p', { role: 'alert', style: { color: 'var(--xh-fg-danger)' } }, toValue(options.actionErrorText) ?? 'Action failed. Please try again.') : null,\n              ]),\n              h(XhDialogFooter, null, () => [\n                spec.showCancel\n                  ? h(XhButton, { variant: 'ghost', disabled: serviceState.busy, onClick: () => controller.close(false) }, () => toValue(spec.cancelText))\n                  : null,\n                h(XhButton, { variant: 'solid', tone: spec.tone, loading: serviceState.busy, onClick: controller.confirmCurrent }, () => [\n                  serviceState.busy ? h(XhButtonIndicator, () => spinArc()) : null,\n                  h(XhButtonLabel, () => (serviceState.busy ? `${toValue(spec.okText)}…` : toValue(spec.okText))),\n                ]),\n              ]),\n            ])\n          : null)\n      }\n    },\n  })\n\n  const app: App = createApp(Host)\n  let mounted = false\n  function failHost(cause: unknown): void {\n    controller.fail(cause)\n  }\n  app.config.errorHandler = failHost\n  if (!hostFailure) {\n    try {\n      app.mount(holder)\n      mounted = true\n    }\n    catch (cause) {\n      failHost(cause)\n    }\n  }\n\n  const alert = (badge: DialogServiceBadge, tone: Tone) => async (opts: AlertOptions): Promise<void> => {\n    await controller.request({\n      title: opts.title,\n      content: opts.content,\n      tone,\n      okText: opts.okText ?? defaults.okText,\n      cancelText: defaults.cancelText,\n      showCancel: false,\n      badge,\n      onOk: opts.onOk,\n      onActionError: opts.onActionError,\n    })\n  }\n\n  return {\n    get actionError() { return controller.state.actionError },\n    confirm: opts => controller.request({\n      title: opts.title,\n      content: opts.content,\n      tone: opts.tone ?? 'brand',\n      okText: opts.okText ?? defaults.okText,\n      cancelText: opts.cancelText ?? defaults.cancelText,\n      showCancel: true,\n      badge: opts.badge,\n      onOk: opts.onOk,\n      onActionError: opts.onActionError,\n    }),\n    prompt: <T extends object>(opts: PromptOptions<T>): Promise<T | null> => {\n      // body 与 onOk 拿的是同一份可写代理：正文里改了什么，确认时就读到什么\n      const value = reactive({ ...opts.initialValue }) as T\n      return controller.request({\n        title: opts.title,\n        tone: opts.tone ?? 'brand',\n        okText: opts.okText ?? defaults.okText,\n        cancelText: opts.cancelText ?? defaults.cancelText,\n        showCancel: true,\n        badge: opts.badge,\n        initialFocus: opts.initialFocus,\n        body: v => opts.body(v as T),\n        value,\n        onOk: opts.onOk ? () => opts.onOk!(value) : undefined,\n        onActionError: opts.onActionError,\n      }).then(ok => (ok ? { ...toRaw(value) } as T : null))\n    },\n    info: alert('info', 'info'),\n    success: alert('success', 'success'),\n    warning: alert('warning', 'warning'),\n    error: alert('error', 'danger'),\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      controller.dispose()\n      if (mounted)\n        app.unmount()\n      if (!options.target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/services/glyph.js

@@ -1,47 +1,5 @@
 import { h } from "vue";
-import { resolveMotionPreference } from "@xihan-ui/motion";
 //#region src/services/glyph.ts
-/** 裸字形跟着宿主声明的图标尺寸走；宿主没声明时退回控件指示符那一档。 */
-const GLYPH_SIZE = "var(--xh-icon-size, var(--xh-control-indicator-size))";
-const GLYPH_STYLE = {
-	display: "grid",
-	placeItems: "center",
-	flex: "none",
-	inlineSize: GLYPH_SIZE,
-	blockSize: GLYPH_SIZE,
-	color: "var(--xh-_tone-fg, var(--xh-fg-default))"
-};
-/** 徽记的圆底取中号字形尺寸；里面的字形四边各让出一个 space-1。 */
-const BADGE_SIZE = "var(--xh-glyph-size-md)";
-const MARK_SIZE = "calc(var(--xh-glyph-size-md) - 2 * var(--xh-space-1))";
-const BADGE_STYLE = {
-	display: "grid",
-	placeItems: "center",
-	flex: "none",
-	inlineSize: BADGE_SIZE,
-	blockSize: BADGE_SIZE,
-	borderRadius: "var(--xh-shape-pill)",
-	background: "var(--xh-_tone-subtle, var(--xh-bg-muted))",
-	color: "var(--xh-_tone-fg, var(--xh-fg-default))"
-};
-/** 四种类型各取哪枚字形令牌；图形经 mask 着色，跟着徽记的前景色走。 */
-const GLYPH_MARK = {
-	info: "--xh-glyph-mark-info",
-	success: "--xh-glyph-mark-check",
-	warning: "--xh-glyph-mark-warning",
-	error: "--xh-glyph-mark-close"
-};
-function markStyle(token) {
-	const image = `var(${token})`;
-	return {
-		display: "block",
-		inlineSize: MARK_SIZE,
-		blockSize: MARK_SIZE,
-		backgroundColor: "currentColor",
-		WebkitMask: `${image} center / contain no-repeat`,
-		mask: `${image} center / contain no-repeat`
-	};
-}
 /** 旋转的加载弧线；转动动画由外层容器（如 XhButtonIndicator）或自带样式提供。 */
 function spinArc(size = "1em") {
 	return h("svg", {
@@ -62,73 +20,7 @@ function spinArc(size = "1em") {
 		"stroke-dashoffset": "22"
 	})]);
 }
-/** 解析 CSS 时长（"640ms" / "0.8s"）为毫秒，解析不出来给 0。 */
-function parseDuration(value) {
-	const n = Number.parseFloat(value);
-	if (!Number.isFinite(n)) return 0;
-	return /s\s*$/.test(value) && !/ms\s*$/.test(value) ? n * 1e3 : n;
-}
-/**
-* 让徽记转起来。动画用 Web Animations 而不是 CSS 动画名：模板是内联样式渲染的，
-* 不归任何一份皮肤管，引用皮肤里的 @keyframes 名字时那份皮肤不一定在场。
-* 时长读 --xh-spin-duration 令牌；减弱动效时不转，静止的弧线仍读得出「还没好」。
-*/
-function spin(el) {
-	if (typeof el.animate !== "function" || resolveMotionPreference(el.ownerDocument?.defaultView ?? void 0) === "reduce") return;
-	const duration = parseDuration(getComputedStyle(el).getPropertyValue("--xh-spin-duration"));
-	if (duration <= 0) return;
-	el.animate([{ rotate: "0deg" }, { rotate: "360deg" }], {
-		duration,
-		iterations: Number.POSITIVE_INFINITY,
-		easing: "linear"
-	});
-}
-/**
-* 状态字形：不带圆底的一枚字形，尺寸随宿主的 --xh-icon-size，颜色随语气。
-*
-* 与 typeBadge 的分工是体量：圆底徽记是给对话框那种有余裕的版面用的（眼下只剩它在用），
-* 排在一行短消息里会把行高顶起来，也让一句话的反馈看着像一则公告。
-*/
-function typeGlyph(type) {
-	if (!type) return null;
-	if (type === "loading") return h("span", {
-		"key": "spin",
-		"style": GLYPH_STYLE,
-		"aria-hidden": "true",
-		"onVnodeMounted": (vnode) => spin(vnode.el)
-	}, [spinArc("100%")]);
-	const mark = GLYPH_MARK[type];
-	if (!mark) return null;
-	const image = `var(${mark})`;
-	return h("span", {
-		"key": "mark",
-		"style": {
-			...GLYPH_STYLE,
-			backgroundColor: "currentColor",
-			WebkitMask: `${image} center / contain no-repeat`,
-			mask: `${image} center / contain no-repeat`
-		},
-		"aria-hidden": "true"
-	});
-}
-/** 类型徽记：圆底 + 字形；loading 给转圈弧线。 */
-function typeBadge(type) {
-	if (!type) return null;
-	if (type === "loading") return h("span", {
-		"key": "spin",
-		"style": BADGE_STYLE,
-		"aria-hidden": "true",
-		"onVnodeMounted": (vnode) => spin(vnode.el)
-	}, [spinArc(MARK_SIZE)]);
-	const mark = GLYPH_MARK[type];
-	if (!mark) return null;
-	return h("span", {
-		"key": "mark",
-		"style": BADGE_STYLE,
-		"aria-hidden": "true"
-	}, [h("span", { style: markStyle(mark) })]);
-}
 //#endregion
-export { spinArc, typeBadge, typeGlyph };
+export { spinArc };
 
 //# sourceMappingURL=glyph.js.map

package/dist/services/glyph.js.map

@@ -1 +1 @@
-{"version":3,"file":"glyph.js","names":[],"sources":["../../src/services/glyph.ts"],"sourcesContent":["// 反馈服务默认模板用的装饰图形：裸字形（typeGlyph）、圆底徽记（typeBadge）与加载弧线。\n// 纯装饰（aria-hidden），读屏内容由标题与描述承担；配色取语气层继承下来的私有槽，\n// 随宿主 data-tone 自动换族。徽记里的图形取 --xh-glyph-mark-* 令牌，与皮肤的兜底字形同一套。\nimport type { VNode } from 'vue'\nimport { resolveMotionPreference } from '@xihan-ui/motion'\nimport { h } from 'vue'\n\n/** 裸字形跟着宿主声明的图标尺寸走；宿主没声明时退回控件指示符那一档。 */\nconst GLYPH_SIZE = 'var(--xh-icon-size, var(--xh-control-indicator-size))'\n\nconst GLYPH_STYLE = {\n  display: 'grid',\n  placeItems: 'center',\n  flex: 'none',\n  inlineSize: GLYPH_SIZE,\n  blockSize: GLYPH_SIZE,\n  /* 字形压的是同族淡底，不是白底：主色 600 档兑上去只剩 2.1–2.7（浅色 success / warning、\n     深色 neutral），够不到图形该有的 3:1。-fg 档在同一批底上最低 4.08，与 alert 的图标同档 */\n  color: 'var(--xh-_tone-fg, var(--xh-fg-default))',\n} as const\n\n/** 徽记的圆底取中号字形尺寸；里面的字形四边各让出一个 space-1。 */\nconst BADGE_SIZE = 'var(--xh-glyph-size-md)'\nconst MARK_SIZE = 'calc(var(--xh-glyph-size-md) - 2 * var(--xh-space-1))'\n\nconst BADGE_STYLE = {\n  display: 'grid',\n  placeItems: 'center',\n  flex: 'none',\n  inlineSize: BADGE_SIZE,\n  blockSize: BADGE_SIZE,\n  borderRadius: 'var(--xh-shape-pill)',\n  background: 'var(--xh-_tone-subtle, var(--xh-bg-muted))',\n  color: 'var(--xh-_tone-fg, var(--xh-fg-default))',\n} as const\n\n/** 四种类型各取哪枚字形令牌；图形经 mask 着色，跟着徽记的前景色走。 */\nconst GLYPH_MARK: Record<string, string> = {\n  info: '--xh-glyph-mark-info',\n  success: '--xh-glyph-mark-check',\n  warning: '--xh-glyph-mark-warning',\n  error: '--xh-glyph-mark-close',\n}\n\nfunction markStyle(token: string): Record<string, string> {\n  const image = `var(${token})`\n  return {\n    display: 'block',\n    inlineSize: MARK_SIZE,\n    blockSize: MARK_SIZE,\n    backgroundColor: 'currentColor',\n    WebkitMask: `${image} center / contain no-repeat`,\n    mask: `${image} center / contain no-repeat`,\n  }\n}\n\n/** 旋转的加载弧线；转动动画由外层容器（如 XhButtonIndicator）或自带样式提供。 */\nexport function spinArc(size = '1em'): VNode {\n  return h('svg', {\n    'viewBox': '0 0 16 16',\n    'width': size,\n    'height': size,\n    'aria-hidden': 'true',\n    'style': { display: 'block' },\n  }, [\n    h('circle', {\n      'cx': 8,\n      'cy': 8,\n      'r': 6.5,\n      'fill': 'none',\n      'stroke': 'currentColor',\n      'stroke-width': 2,\n      'stroke-linecap': 'round',\n      'stroke-dasharray': '30',\n      'stroke-dashoffset': '22',\n    }),\n  ])\n}\n\n/** 解析 CSS 时长（\"640ms\" / \"0.8s\"）为毫秒，解析不出来给 0。 */\nfunction parseDuration(value: string): number {\n  const n = Number.parseFloat(value)\n  if (!Number.isFinite(n))\n    return 0\n  return /s\\s*$/.test(value) && !/ms\\s*$/.test(value) ? n * 1000 : n\n}\n\n/**\n * 让徽记转起来。动画用 Web Animations 而不是 CSS 动画名：模板是内联样式渲染的，\n * 不归任何一份皮肤管，引用皮肤里的 @keyframes 名字时那份皮肤不一定在场。\n * 时长读 --xh-spin-duration 令牌；减弱动效时不转，静止的弧线仍读得出「还没好」。\n */\nfunction spin(el: HTMLElement): void {\n  if (typeof el.animate !== 'function' || resolveMotionPreference(el.ownerDocument?.defaultView ?? undefined) === 'reduce')\n    return\n  const duration = parseDuration(getComputedStyle(el).getPropertyValue('--xh-spin-duration'))\n  if (duration <= 0)\n    return\n  el.animate([{ rotate: '0deg' }, { rotate: '360deg' }], { duration, iterations: Number.POSITIVE_INFINITY, easing: 'linear' })\n}\n\n/**\n * 状态字形：不带圆底的一枚字形，尺寸随宿主的 --xh-icon-size，颜色随语气。\n *\n * 与 typeBadge 的分工是体量：圆底徽记是给对话框那种有余裕的版面用的（眼下只剩它在用），\n * 排在一行短消息里会把行高顶起来，也让一句话的反馈看着像一则公告。\n */\nexport function typeGlyph(type: string | undefined): VNode | null {\n  if (!type)\n    return null\n  if (type === 'loading') {\n    // key 必须与下面那支不同：同为无 key 的 span 会被判成同一个节点就地复用，\n    // 而转圈是 Web Animations 挂在元素上的，样式补丁不会把它收走——\n    // loading 改写成 success 之后那枚勾号会一直转\n    return h('span', {\n      'key': 'spin',\n      'style': GLYPH_STYLE,\n      'aria-hidden': 'true',\n      'onVnodeMounted': vnode => spin(vnode.el as HTMLElement),\n    }, [spinArc('100%')])\n  }\n  const mark = GLYPH_MARK[type]\n  if (!mark)\n    return null\n  const image = `var(${mark})`\n  // 图案经 mask 着色，取的就是本元素的 color，不必再套一层内节点\n  return h('span', {\n    'key': 'mark',\n    'style': {\n      ...GLYPH_STYLE,\n      backgroundColor: 'currentColor',\n      WebkitMask: `${image} center / contain no-repeat`,\n      mask: `${image} center / contain no-repeat`,\n    },\n    'aria-hidden': 'true',\n  })\n}\n\n/** 类型徽记：圆底 + 字形；loading 给转圈弧线。 */\nexport function typeBadge(type: string | undefined): VNode | null {\n  if (!type)\n    return null\n  if (type === 'loading') {\n    // 两支的 key 必须不同，理由同 typeGlyph\n    return h('span', {\n      'key': 'spin',\n      'style': BADGE_STYLE,\n      'aria-hidden': 'true',\n      'onVnodeMounted': vnode => spin(vnode.el as HTMLElement),\n    }, [spinArc(MARK_SIZE)])\n  }\n  const mark = GLYPH_MARK[type]\n  if (!mark)\n    return null\n  return h('span', { 'key': 'mark', 'style': BADGE_STYLE, 'aria-hidden': 'true' }, [h('span', { style: markStyle(mark) })])\n}\n"],"mappings":";;;;AAQA,MAAM,aAAa;AAEnB,MAAM,cAAc;CAClB,SAAS;CACT,YAAY;CACZ,MAAM;CACN,YAAY;CACZ,WAAW;CAGX,OAAO;AACT;;AAGA,MAAM,aAAa;AACnB,MAAM,YAAY;AAElB,MAAM,cAAc;CAClB,SAAS;CACT,YAAY;CACZ,MAAM;CACN,YAAY;CACZ,WAAW;CACX,cAAc;CACd,YAAY;CACZ,OAAO;AACT;;AAGA,MAAM,aAAqC;CACzC,MAAM;CACN,SAAS;CACT,SAAS;CACT,OAAO;AACT;AAEA,SAAS,UAAU,OAAuC;CACxD,MAAM,QAAQ,OAAO,MAAM;CAC3B,OAAO;EACL,SAAS;EACT,YAAY;EACZ,WAAW;EACX,iBAAiB;EACjB,YAAY,GAAG,MAAM;EACrB,MAAM,GAAG,MAAM;CACjB;AACF;;AAGA,SAAgB,QAAQ,OAAO,OAAc;CAC3C,OAAO,EAAE,OAAO;EACd,WAAW;EACX,SAAS;EACT,UAAU;EACV,eAAe;EACf,SAAS,EAAE,SAAS,QAAQ;CAC9B,GAAG,CACD,EAAE,UAAU;EACV,MAAM;EACN,MAAM;EACN,KAAK;EACL,QAAQ;EACR,UAAU;EACV,gBAAgB;EAChB,kBAAkB;EAClB,oBAAoB;EACpB,qBAAqB;CACvB,CAAC,CACH,CAAC;AACH;;AAGA,SAAS,cAAc,OAAuB;CAC5C,MAAM,IAAI,OAAO,WAAW,KAAK;CACjC,IAAI,CAAC,OAAO,SAAS,CAAC,GACpB,OAAO;CACT,OAAO,QAAQ,KAAK,KAAK,KAAK,CAAC,SAAS,KAAK,KAAK,IAAI,IAAI,MAAO;AACnE;;;;;;AAOA,SAAS,KAAK,IAAuB;CACnC,IAAI,OAAO,GAAG,YAAY,cAAc,wBAAwB,GAAG,eAAe,eAAe,KAAA,CAAS,MAAM,UAC9G;CACF,MAAM,WAAW,cAAc,iBAAiB,EAAE,CAAC,CAAC,iBAAiB,oBAAoB,CAAC;CAC1F,IAAI,YAAY,GACd;CACF,GAAG,QAAQ,CAAC,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,SAAS,CAAC,GAAG;EAAE;EAAU,YAAY,OAAO;EAAmB,QAAQ;CAAS,CAAC;AAC7H;;;;;;;AAQA,SAAgB,UAAU,MAAwC;CAChE,IAAI,CAAC,MACH,OAAO;CACT,IAAI,SAAS,WAIX,OAAO,EAAE,QAAQ;EACf,OAAO;EACP,SAAS;EACT,eAAe;EACf,mBAAkB,UAAS,KAAK,MAAM,EAAiB;CACzD,GAAG,CAAC,QAAQ,MAAM,CAAC,CAAC;CAEtB,MAAM,OAAO,WAAW;CACxB,IAAI,CAAC,MACH,OAAO;CACT,MAAM,QAAQ,OAAO,KAAK;CAE1B,OAAO,EAAE,QAAQ;EACf,OAAO;EACP,SAAS;GACP,GAAG;GACH,iBAAiB;GACjB,YAAY,GAAG,MAAM;GACrB,MAAM,GAAG,MAAM;EACjB;EACA,eAAe;CACjB,CAAC;AACH;;AAGA,SAAgB,UAAU,MAAwC;CAChE,IAAI,CAAC,MACH,OAAO;CACT,IAAI,SAAS,WAEX,OAAO,EAAE,QAAQ;EACf,OAAO;EACP,SAAS;EACT,eAAe;EACf,mBAAkB,UAAS,KAAK,MAAM,EAAiB;CACzD,GAAG,CAAC,QAAQ,SAAS,CAAC,CAAC;CAEzB,MAAM,OAAO,WAAW;CACxB,IAAI,CAAC,MACH,OAAO;CACT,OAAO,EAAE,QAAQ;EAAE,OAAO;EAAQ,SAAS;EAAa,eAAe;CAAO,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1H"}
+{"version":3,"file":"glyph.js","names":[],"sources":["../../src/services/glyph.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// 反馈服务默认模板用的装饰图形：加载弧线。\n// 纯装饰（aria-hidden），读屏内容由标题与描述承担。\nimport type { VNode } from 'vue'\nimport { h } from 'vue'\n\n/** 旋转的加载弧线；转动动画由外层容器（如 XhButtonIndicator）或自带样式提供。 */\nexport function spinArc(size = '1em'): VNode {\n  return h('svg', {\n    'viewBox': '0 0 16 16',\n    'width': size,\n    'height': size,\n    'aria-hidden': 'true',\n    'style': { display: 'block' },\n  }, [\n    h('circle', {\n      'cx': 8,\n      'cy': 8,\n      'r': 6.5,\n      'fill': 'none',\n      'stroke': 'currentColor',\n      'stroke-width': 2,\n      'stroke-linecap': 'round',\n      'stroke-dasharray': '30',\n      'stroke-dashoffset': '22',\n    }),\n  ])\n}\n"],"mappings":";;;AAWA,SAAgB,QAAQ,OAAO,OAAc;CAC3C,OAAO,EAAE,OAAO;EACd,WAAW;EACX,SAAS;EACT,UAAU;EACV,eAAe;EACf,SAAS,EAAE,SAAS,QAAQ;CAC9B,GAAG,CACD,EAAE,UAAU;EACV,MAAM;EACN,MAAM;EACN,KAAK;EACL,QAAQ;EACR,UAAU;EACV,gBAAgB;EAChB,kBAAkB;EAClB,oBAAoB;EACpB,qBAAqB;CACvB,CAAC,CACH,CAAC;AACH"}

package/dist/services/loading-bar-service.d.ts

@@ -1,41 +1,40 @@
 import { XhConfig } from "../config/config.js";
 import { MaybeRefOrGetter } from "vue";
+import { Tone } from "@xihan-ui/core";
 import { LoadingBarTranslations } from "@xihan-ui/headless";
-import { Tone } from "@xihan-ui/kernel";
 //#region src/services/loading-bar-service.d.ts
 interface LoadingBarServiceOptions {
-  /** 正常收尾的语气，缺省 brand。 */
+  /** 正常收尾的语气，默认 brand。 */
   tone?: Tone;
-  /** error() 收尾用的语气，缺省 danger：出错的收尾要与正常收尾区分得开。 */
+  /** error() 收尾使用的语气，默认 danger：出错的收尾要与正常收尾区分开。 */
   errorTone?: Tone;
   height?: string | number;
-  color?: string;
   trickle?: boolean;
   trickleSpeed?: number;
   minimum?: number;
   fadeDuration?: number;
   translations?: MaybeRefOrGetter<Partial<LoadingBarTranslations>>;
   /**
-   * 喂给进度条子树的全局配置。
-   * 本服务自带宿主应用，接不到组件树里的 provideXhConfig，要让它跟应用同语言就从这里给；
-   * 传 ref/getter 即可运行期跟着切语言，也可以之后用 setConfig 推。
+   * 提供给进度条子树的全局配置。
+   * 本服务自带宿主应用，无法接收组件树中的 provideXhConfig，需要与应用同语言时从这里提供；
+   * 传 ref/getter 即可在运行期跟随切换语言，也可以之后用 setConfig 推送。
    */
   config?: MaybeRefOrGetter<XhConfig>;
-  /** 宿主容器；不给就在 body 下新建一个。 */
+  /** 宿主容器；未提供时在 body 下新建一个。 */
   target?: HTMLElement;
 }
 interface LoadingBarService {
   /** 在途计数 +1；从 0 起跳即开始爬升。 */
   start: () => void;
-  /** 在途计数 -1（夹到 0，多调不会变负）；归零才收。 */
+  /** 在途计数 -1（夹取到 0，多次调用不会变负）；归零才收尾。 */
   finish: () => void;
-  /** 强制归零并以 errorTone 收。 */
+  /** 强制归零并以 errorTone 收尾。 */
   error: () => void;
-  /** 不管还剩几笔在途一律收掉（路由跳走时用）。 */
+  /** 无论还剩多少笔在途一律收尾（路由跳转时使用）。 */
   finishAll: () => void;
-  /** 切成确定进度：给了值就照它显示，内部爬升停止；再 start() 回到不确定。 */
+  /** 切换为确定进度：提供值时按值显示，内部爬升停止；再次 start() 回到不确定。 */
   set: (value: number) => void;
-  /** 换一份全局配置源。 */
+  /** 更换全局配置源。 */
   setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void;
   /** 卸载宿主应用并移除容器。 */
   dispose: () => void;

package/dist/services/loading-bar-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading-bar-service.d.ts","names":[],"sources":["../../src/services/loading-bar-service.ts"],"mappings":";;;;;UAeiB;;EAEf,OAAO;;EAEP,YAAY;EACZ;EACA;EACA;EACA;EACA;EACA;EACA,eAAe,iBAAiB,QAAQ;;;;;;EAMxC,SAAS,iBAAiB;;EAE1B,SAAS;;UAGM;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,MAAM;;EAEN,YAAY,MAAM,iBAAiB;;EAEnC;;iBAGc,wBAAwB,UAAS,2BAAgC"}
+{"version":3,"file":"loading-bar-service.d.ts","names":[],"sources":["../../src/services/loading-bar-service.ts"],"mappings":";;;;;UAsBiB;;EAEf,OAAO;;EAEP,YAAY;EACZ;EACA;EACA;EACA;EACA;EACA,eAAe,iBAAiB,QAAQ;;;;;;EAMxC,SAAS,iBAAiB;;EAE1B,SAAS;;UAGM;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,MAAM;;EAEN,YAAY,MAAM,iBAAiB;;EAEnC;;iBAGc,wBAAwB,UAAS,2BAAgC"}

package/dist/services/loading-bar-service.js

@@ -1,10 +1,10 @@
 import { vueNormalize } from "../runtime/normalize-props.js";
 import { useMachine } from "../runtime/use-machine.js";
-import { mountServiceHost } from "./mount-host.js";
 import { createServiceConfig } from "./service-config.js";
-import { computed, createApp, defineComponent, h, reactive, toValue } from "vue";
-import { connectLoadingBar, loadingBarMachine } from "@xihan-ui/headless";
-import { ensurePortalRoot } from "@xihan-ui/kernel";
+import { mountServiceHost } from "./mount-host.js";
+import { computed, createApp, defineComponent, h, shallowRef, toValue } from "vue";
+import { ensurePortalRoot } from "@xihan-ui/core";
+import { connectLoadingBar, createLoadingBarServiceController, loadingBarMachine } from "@xihan-ui/headless";
 //#region src/services/loading-bar-service.ts
 function createLoadingBarService(options = {}) {
 	if (typeof document === "undefined") throw new Error("createLoadingBarService 需要 document；SSR 里请等到客户端再创建");
@@ -12,20 +12,23 @@ function createLoadingBarService(options = {}) {
 	const holder = target ?? document.createElement("div");
 	if (!target) ensurePortalRoot(document).appendChild(holder);
 	const configSource = createServiceConfig(config);
-	const state = reactive({
-		pending: 0,
+	let publishState = () => {};
+	const controller = createLoadingBarServiceController({
 		tone,
-		value: void 0
+		errorTone,
+		onStateChange: (next) => publishState(next)
 	});
+	const controllerState = shallowRef(controller.state);
+	publishState = (next) => void (controllerState.value = next);
 	const app = createApp(defineComponent({
 		name: "XhLoadingBarServiceHost",
 		setup() {
 			configSource.provide();
 			const service = useMachine(loadingBarMachine, () => ({
 				...barProps,
-				loading: state.pending > 0,
-				tone: state.tone,
-				value: state.value,
+				loading: controllerState.value.pending > 0,
+				tone: controllerState.value.tone,
+				value: controllerState.value.value,
 				translations: toValue(translations)
 			}));
 			const api = computed(() => connectLoadingBar(service, vueNormalize));
@@ -33,32 +36,16 @@ function createLoadingBarService(options = {}) {
 		}
 	}));
 	const mounted = mountServiceHost(app, holder, "loading-bar");
-	const settle = (nextTone) => {
-		if (!mounted) return;
-		state.pending = 0;
-		state.tone = nextTone;
-		state.value = void 0;
-	};
+	if (!mounted) controller.dispose();
 	return {
-		start: () => {
-			if (!mounted) return;
-			state.tone = tone;
-			state.value = void 0;
-			state.pending += 1;
-		},
-		finish: () => {
-			if (!mounted) return;
-			state.pending = Math.max(0, state.pending - 1);
-			if (state.pending === 0) state.value = void 0;
-		},
-		error: () => settle(errorTone),
-		finishAll: () => settle(tone),
-		set: (value) => {
-			if (!mounted) return;
-			state.value = value;
-		},
+		start: controller.start,
+		finish: controller.finish,
+		error: controller.error,
+		finishAll: controller.finishAll,
+		set: controller.set,
 		setConfig: (next) => configSource.set(next),
 		dispose: () => {
+			controller.dispose();
 			if (mounted) app.unmount();
 			if (!target) holder.remove();
 		}

package/dist/services/loading-bar-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"loading-bar-service.js","names":[],"sources":["../../src/services/loading-bar-service.ts"],"sourcesContent":["// 全局命令式顶部进度条：自带一个挂到 body 的宿主应用，\n// start/finish 在任意模块作用域可调（路由守卫、请求拦截器），不要求调用点在组件树内。\n// 组件树内的组合用法仍走 XhLoadingBarRoot。\nimport type { LoadingBarTranslations } from '@xihan-ui/headless'\nimport type { Tone } from '@xihan-ui/kernel'\nimport type { App, MaybeRefOrGetter } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { connectLoadingBar, loadingBarMachine } from '@xihan-ui/headless'\nimport { ensurePortalRoot } from '@xihan-ui/kernel'\nimport { computed, createApp, defineComponent, h, reactive, toValue } from 'vue'\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 LoadingBarServiceOptions {\n  /** 正常收尾的语气，缺省 brand。 */\n  tone?: Tone\n  /** error() 收尾用的语气，缺省 danger：出错的收尾要与正常收尾区分得开。 */\n  errorTone?: Tone\n  height?: string | number\n  color?: string\n  trickle?: boolean\n  trickleSpeed?: number\n  minimum?: number\n  fadeDuration?: number\n  translations?: MaybeRefOrGetter<Partial<LoadingBarTranslations>>\n  /**\n   * 喂给进度条子树的全局配置。\n   * 本服务自带宿主应用，接不到组件树里的 provideXhConfig，要让它跟应用同语言就从这里给；\n   * 传 ref/getter 即可运行期跟着切语言，也可以之后用 setConfig 推。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；不给就在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\nexport interface LoadingBarService {\n  /** 在途计数 +1；从 0 起跳即开始爬升。 */\n  start: () => void\n  /** 在途计数 -1（夹到 0，多调不会变负）；归零才收。 */\n  finish: () => void\n  /** 强制归零并以 errorTone 收。 */\n  error: () => void\n  /** 不管还剩几笔在途一律收掉（路由跳走时用）。 */\n  finishAll: () => void\n  /** 切成确定进度：给了值就照它显示，内部爬升停止；再 start() 回到不确定。 */\n  set: (value: number) => void\n  /** 换一份全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\nexport function createLoadingBarService(options: LoadingBarServiceOptions = {}): LoadingBarService {\n  if (typeof document === 'undefined')\n    throw new Error('createLoadingBarService 需要 document；SSR 里请等到客户端再创建')\n\n  const { target, config, tone = 'brand', errorTone = 'danger', translations, ...barProps } = options\n  const holder = target ?? document.createElement('div')\n  if (!target)\n    ensurePortalRoot(document).appendChild(holder)\n\n  const configSource = createServiceConfig(config)\n\n  // 在途计数而不是布尔开关：并发请求里第一个回来时其余还在跑，\n  // 布尔开关会把条子提前收掉。\n  const state = reactive<{ pending: number, tone: Tone, value: number | undefined }>({\n    pending: 0,\n    tone,\n    value: undefined,\n  })\n\n  const Host = defineComponent({\n    name: 'XhLoadingBarServiceHost',\n    setup() {\n      configSource.provide()\n      // 直接从 api 渲染那三层，不走部件组件：这棵子树固定且全归服务自己拥有，\n      // 经上下文传 api 什么也没换来，却把「跨模块 provide/inject 必须对得上」\n      // 加成了一条本可以没有的前提\n      const service = useMachine(loadingBarMachine, () => ({\n        ...barProps,\n        loading: state.pending > 0,\n        tone: state.tone,\n        value: state.value,\n        translations: toValue(translations),\n      }))\n      const api = computed(() => connectLoadingBar(service, vueNormalize))\n      return () => h('div', api.value.getRootProps() as Record<string, unknown>, [\n        h('div', api.value.getTrackProps() as Record<string, unknown>, [\n          h('div', api.value.getRangeProps() as Record<string, unknown>),\n        ]),\n      ])\n    },\n  })\n\n  const app: App = createApp(Host)\n  const mounted = mountServiceHost(app, holder, 'loading-bar')\n\n  const settle = (nextTone: Tone): void => {\n    if (!mounted)\n      return\n    state.pending = 0\n    state.tone = nextTone\n    state.value = undefined\n  }\n\n  return {\n    // 宿主没挂起来时整体惰化：状态一动不动，残骸也就不会被叫醒\n    start: () => {\n      if (!mounted)\n        return\n      state.tone = tone\n      state.value = undefined\n      state.pending += 1\n    },\n    finish: () => {\n      if (!mounted)\n        return\n      state.pending = Math.max(0, state.pending - 1)\n      if (state.pending === 0)\n        state.value = undefined\n    },\n    error: () => settle(errorTone),\n    finishAll: () => settle(tone),\n    set: (value) => {\n      if (!mounted)\n        return\n      state.value = value\n    },\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      if (mounted)\n        app.unmount()\n      if (!target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":";;;;;;;;AAsDA,SAAgB,wBAAwB,UAAoC,CAAC,GAAsB;CACjG,IAAI,OAAO,aAAa,aACtB,MAAM,IAAI,MAAM,oDAAoD;CAEtE,MAAM,EAAE,QAAQ,QAAQ,OAAO,SAAS,YAAY,UAAU,cAAc,GAAG,aAAa;CAC5F,MAAM,SAAS,UAAU,SAAS,cAAc,KAAK;CACrD,IAAI,CAAC,QACH,iBAAiB,QAAQ,CAAC,CAAC,YAAY,MAAM;CAE/C,MAAM,eAAe,oBAAoB,MAAM;CAI/C,MAAM,QAAQ,SAAqE;EACjF,SAAS;EACT;EACA,OAAO,KAAA;CACT,CAAC;CAyBD,MAAM,MAAW,UAvBJ,gBAAgB;EAC3B,MAAM;EACN,QAAQ;GACN,aAAa,QAAQ;GAIrB,MAAM,UAAU,WAAW,0BAA0B;IACnD,GAAG;IACH,SAAS,MAAM,UAAU;IACzB,MAAM,MAAM;IACZ,OAAO,MAAM;IACb,cAAc,QAAQ,YAAY;GACpC,EAAE;GACF,MAAM,MAAM,eAAe,kBAAkB,SAAS,YAAY,CAAC;GACnE,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,CACzE,EAAE,OAAO,IAAI,MAAM,cAAc,GAA8B,CAC7D,EAAE,OAAO,IAAI,MAAM,cAAc,CAA4B,CAC/D,CAAC,CACH,CAAC;EACH;CACF,CAE8B,CAAC;CAC/B,MAAM,UAAU,iBAAiB,KAAK,QAAQ,aAAa;CAE3D,MAAM,UAAU,aAAyB;EACvC,IAAI,CAAC,SACH;EACF,MAAM,UAAU;EAChB,MAAM,OAAO;EACb,MAAM,QAAQ,KAAA;CAChB;CAEA,OAAO;EAEL,aAAa;GACX,IAAI,CAAC,SACH;GACF,MAAM,OAAO;GACb,MAAM,QAAQ,KAAA;GACd,MAAM,WAAW;EACnB;EACA,cAAc;GACZ,IAAI,CAAC,SACH;GACF,MAAM,UAAU,KAAK,IAAI,GAAG,MAAM,UAAU,CAAC;GAC7C,IAAI,MAAM,YAAY,GACpB,MAAM,QAAQ,KAAA;EAClB;EACA,aAAa,OAAO,SAAS;EAC7B,iBAAiB,OAAO,IAAI;EAC5B,MAAM,UAAU;GACd,IAAI,CAAC,SACH;GACF,MAAM,QAAQ;EAChB;EACA,YAAW,SAAQ,aAAa,IAAI,IAAI;EACxC,eAAe;GACb,IAAI,SACF,IAAI,QAAQ;GACd,IAAI,CAAC,QACH,OAAO,OAAO;EAClB;CACF;AACF"}
+{"version":3,"file":"loading-bar-service.js","names":[],"sources":["../../src/services/loading-bar-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// 提供 loading bar service 相关实现。\n\nimport type { Tone } from '@xihan-ui/core'\n// 全局命令式顶部进度条：自带一个挂到 body 的宿主应用，\n// start/finish 在任意模块作用域可调（路由守卫、请求拦截器），不要求调用点在组件树内。\n// 组件树内的组合用法仍走 XhLoadingBarRoot。\nimport type { LoadingBarServiceControllerState, LoadingBarTranslations } from '@xihan-ui/headless'\nimport type { App, MaybeRefOrGetter } from 'vue'\nimport type { XhConfig } from '../config/config'\nimport { ensurePortalRoot } from '@xihan-ui/core'\nimport { connectLoadingBar, createLoadingBarServiceController, loadingBarMachine } from '@xihan-ui/headless'\nimport { computed, createApp, defineComponent, h, shallowRef, toValue } from 'vue'\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 LoadingBarServiceOptions {\n  /** 正常收尾的语气，默认 brand。 */\n  tone?: Tone\n  /** error() 收尾使用的语气，默认 danger：出错的收尾要与正常收尾区分开。 */\n  errorTone?: Tone\n  height?: string | number\n  trickle?: boolean\n  trickleSpeed?: number\n  minimum?: number\n  fadeDuration?: number\n  translations?: MaybeRefOrGetter<Partial<LoadingBarTranslations>>\n  /**\n   * 提供给进度条子树的全局配置。\n   * 本服务自带宿主应用，无法接收组件树中的 provideXhConfig，需要与应用同语言时从这里提供；\n   * 传 ref/getter 即可在运行期跟随切换语言，也可以之后用 setConfig 推送。\n   */\n  config?: MaybeRefOrGetter<XhConfig>\n  /** 宿主容器；未提供时在 body 下新建一个。 */\n  target?: HTMLElement\n}\n\nexport interface LoadingBarService {\n  /** 在途计数 +1；从 0 起跳即开始爬升。 */\n  start: () => void\n  /** 在途计数 -1（夹取到 0，多次调用不会变负）；归零才收尾。 */\n  finish: () => void\n  /** 强制归零并以 errorTone 收尾。 */\n  error: () => void\n  /** 无论还剩多少笔在途一律收尾（路由跳转时使用）。 */\n  finishAll: () => void\n  /** 切换为确定进度：提供值时按值显示，内部爬升停止；再次 start() 回到不确定。 */\n  set: (value: number) => void\n  /** 更换全局配置源。 */\n  setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void\n  /** 卸载宿主应用并移除容器。 */\n  dispose: () => void\n}\n\nexport function createLoadingBarService(options: LoadingBarServiceOptions = {}): LoadingBarService {\n  if (typeof document === 'undefined')\n    throw new Error('createLoadingBarService 需要 document；SSR 里请等到客户端再创建')\n\n  const { target, config, tone = 'brand', errorTone = 'danger', translations, ...barProps } = options\n  const holder = target ?? document.createElement('div')\n  if (!target)\n    ensurePortalRoot(document).appendChild(holder)\n\n  const configSource = createServiceConfig(config)\n\n  let publishState: (next: LoadingBarServiceControllerState) => void = () => {}\n  const controller = createLoadingBarServiceController({\n    tone,\n    errorTone,\n    onStateChange: next => publishState(next),\n  })\n  const controllerState = shallowRef(controller.state)\n  publishState = next => void (controllerState.value = next)\n\n  const Host = defineComponent({\n    name: 'XhLoadingBarServiceHost',\n    setup() {\n      configSource.provide()\n      // 直接从 api 渲染那三层，不走部件组件：这棵子树固定且全归服务自己拥有，\n      // 经上下文传 api 什么也没换来，却把「跨模块 provide/inject 必须对得上」\n      // 加成了一条本可以没有的前提\n      const service = useMachine(loadingBarMachine, () => ({\n        ...barProps,\n        loading: controllerState.value.pending > 0,\n        tone: controllerState.value.tone,\n        value: controllerState.value.value,\n        translations: toValue(translations),\n      }))\n      const api = computed(() => connectLoadingBar(service, vueNormalize))\n      return () => h('div', api.value.getRootProps() as Record<string, unknown>, [\n        h('div', api.value.getTrackProps() as Record<string, unknown>, [\n          h('div', api.value.getRangeProps() as Record<string, unknown>),\n        ]),\n      ])\n    },\n  })\n\n  const app: App = createApp(Host)\n  const mounted = mountServiceHost(app, holder, 'loading-bar')\n  if (!mounted)\n    controller.dispose()\n\n  return {\n    start: controller.start,\n    finish: controller.finish,\n    error: controller.error,\n    finishAll: controller.finishAll,\n    set: controller.set,\n    setConfig: next => configSource.set(next),\n    dispose: () => {\n      controller.dispose()\n      if (mounted)\n        app.unmount()\n      if (!target)\n        holder.remove()\n    },\n  }\n}\n"],"mappings":";;;;;;;;AA4DA,SAAgB,wBAAwB,UAAoC,CAAC,GAAsB;CACjG,IAAI,OAAO,aAAa,aACtB,MAAM,IAAI,MAAM,oDAAoD;CAEtE,MAAM,EAAE,QAAQ,QAAQ,OAAO,SAAS,YAAY,UAAU,cAAc,GAAG,aAAa;CAC5F,MAAM,SAAS,UAAU,SAAS,cAAc,KAAK;CACrD,IAAI,CAAC,QACH,iBAAiB,QAAQ,CAAC,CAAC,YAAY,MAAM;CAE/C,MAAM,eAAe,oBAAoB,MAAM;CAE/C,IAAI,qBAAuE,CAAC;CAC5E,MAAM,aAAa,kCAAkC;EACnD;EACA;EACA,gBAAe,SAAQ,aAAa,IAAI;CAC1C,CAAC;CACD,MAAM,kBAAkB,WAAW,WAAW,KAAK;CACnD,gBAAe,SAAQ,MAAM,gBAAgB,QAAQ;CAyBrD,MAAM,MAAW,UAvBJ,gBAAgB;EAC3B,MAAM;EACN,QAAQ;GACN,aAAa,QAAQ;GAIrB,MAAM,UAAU,WAAW,0BAA0B;IACnD,GAAG;IACH,SAAS,gBAAgB,MAAM,UAAU;IACzC,MAAM,gBAAgB,MAAM;IAC5B,OAAO,gBAAgB,MAAM;IAC7B,cAAc,QAAQ,YAAY;GACpC,EAAE;GACF,MAAM,MAAM,eAAe,kBAAkB,SAAS,YAAY,CAAC;GACnE,aAAa,EAAE,OAAO,IAAI,MAAM,aAAa,GAA8B,CACzE,EAAE,OAAO,IAAI,MAAM,cAAc,GAA8B,CAC7D,EAAE,OAAO,IAAI,MAAM,cAAc,CAA4B,CAC/D,CAAC,CACH,CAAC;EACH;CACF,CAE8B,CAAC;CAC/B,MAAM,UAAU,iBAAiB,KAAK,QAAQ,aAAa;CAC3D,IAAI,CAAC,SACH,WAAW,QAAQ;CAErB,OAAO;EACL,OAAO,WAAW;EAClB,QAAQ,WAAW;EACnB,OAAO,WAAW;EAClB,WAAW,WAAW;EACtB,KAAK,WAAW;EAChB,YAAW,SAAQ,aAAa,IAAI,IAAI;EACxC,eAAe;GACb,WAAW,QAAQ;GACnB,IAAI,SACF,IAAI,QAAQ;GACd,IAAI,CAAC,QACH,OAAO,OAAO;EAClB;CACF;AACF"}

package/dist/services/mount-host.js

@@ -1,15 +1,15 @@
-import { DIAGNOSTIC_CODES, reportDiagnostic } from "@xihan-ui/kernel";
+import { DIAGNOSTIC_CODES, reportDiagnostic } from "@xihan-ui/core";
 //#region src/services/mount-host.ts
 /**
-* 把命令式服务的宿主应用挂上去，挂不起来也不连累调用方。
+* 挂载命令式服务的宿主应用，挂载失败也不影响调用方。
 *
-* 这几个服务是从路由守卫、请求拦截器这类地方懒建的——那些位置抛异常，
-* 后果不是「提示没弹出来」而是整次导航失败、整站白屏，而报错指向的是浮层部件，
-* 与真正的原因隔着十万八千里。一条轻提示、一根进度条都不该有这个权力。
+* 这几个服务是从路由守卫、请求拦截器等位置懒建的：这些位置抛异常，
+* 后果不是提示未弹出而是整次导航失败、整站白屏，而报错指向的是浮层部件，
+* 与真正的原因相距甚远。一条轻提示、一根进度条都不应有这种权力。
 *
-* 挂不起来时发一条诊断并交回 false，由调用方整体惰化：状态一律不再改动。
-* 半挂载的树仍订阅着响应式状态，继续写它只会让那棵残骸一遍遍重渲，
-* 每次都吐一串「slot invoked outside of the render function」，把控制台淹掉。
+* 挂载失败时发一条诊断并返回 false，由调用方整体惰化：状态一律不再改动。
+* 半挂载的树仍订阅着响应式状态，继续写它只会让残留的树反复重渲，
+* 每次都输出一串「slot invoked outside of the render function」，淹没控制台。
 */
 function mountServiceHost(app, holder, service) {
 	try {

package/dist/services/mount-host.js.map

@@ -1 +1 @@
-{"version":3,"file":"mount-host.js","names":[],"sources":["../../src/services/mount-host.ts"],"sourcesContent":["import type { App } from 'vue'\nimport { DIAGNOSTIC_CODES, reportDiagnostic } from '@xihan-ui/kernel'\n\n/**\n * 把命令式服务的宿主应用挂上去，挂不起来也不连累调用方。\n *\n * 这几个服务是从路由守卫、请求拦截器这类地方懒建的——那些位置抛异常，\n * 后果不是「提示没弹出来」而是整次导航失败、整站白屏，而报错指向的是浮层部件，\n * 与真正的原因隔着十万八千里。一条轻提示、一根进度条都不该有这个权力。\n *\n * 挂不起来时发一条诊断并交回 false，由调用方整体惰化：状态一律不再改动。\n * 半挂载的树仍订阅着响应式状态，继续写它只会让那棵残骸一遍遍重渲，\n * 每次都吐一串「slot invoked outside of the render function」，把控制台淹掉。\n */\nexport function mountServiceHost(app: App, holder: HTMLElement, service: string): boolean {\n  try {\n    app.mount(holder)\n    return true\n  }\n  catch (error) {\n    reportDiagnostic({\n      code: DIAGNOSTIC_CODES.warn,\n      level: 'warn',\n      message:\n        `[xh] ${service} 的宿主没挂起来，这个服务本次退化成空操作。`\n        + '常见原因是同一份组件模块被加载成了两份（链到工作区的库重建产物后，'\n        + 'dev server 的模块图会新旧混杂），清掉 node_modules/.vite 再重启即可。',\n      detail: { service, error },\n    })\n    // 不调 app.unmount()：mount 抛出时 Vue 并没把 isMounted 置真，\n    // 这时卸载只会再吐一条「Cannot unmount an app that is not mounted」\n    holder.remove()\n    return false\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,SAAgB,iBAAiB,KAAU,QAAqB,SAA0B;CACxF,IAAI;EACF,IAAI,MAAM,MAAM;EAChB,OAAO;CACT,SACO,OAAO;EACZ,iBAAiB;GACf,MAAM,iBAAiB;GACvB,OAAO;GACP,SACE,QAAQ,QAAQ;GAGlB,QAAQ;IAAE;IAAS;GAAM;EAC3B,CAAC;EAGD,OAAO,OAAO;EACd,OAAO;CACT;AACF"}
+{"version":3,"file":"mount-host.js","names":[],"sources":["../../src/services/mount-host.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// 提供 mount host 相关实现。\n\nimport type { App } from 'vue'\nimport { DIAGNOSTIC_CODES, reportDiagnostic } from '@xihan-ui/core'\n\n/**\n * 挂载命令式服务的宿主应用，挂载失败也不影响调用方。\n *\n * 这几个服务是从路由守卫、请求拦截器等位置懒建的：这些位置抛异常，\n * 后果不是提示未弹出而是整次导航失败、整站白屏，而报错指向的是浮层部件，\n * 与真正的原因相距甚远。一条轻提示、一根进度条都不应有这种权力。\n *\n * 挂载失败时发一条诊断并返回 false，由调用方整体惰化：状态一律不再改动。\n * 半挂载的树仍订阅着响应式状态，继续写它只会让残留的树反复重渲，\n * 每次都输出一串「slot invoked outside of the render function」，淹没控制台。\n */\nexport function mountServiceHost(app: App, holder: HTMLElement, service: string): boolean {\n  try {\n    app.mount(holder)\n    return true\n  }\n  catch (error) {\n    reportDiagnostic({\n      code: DIAGNOSTIC_CODES.warn,\n      level: 'warn',\n      message:\n        `[xh] ${service} 的宿主没挂起来，这个服务本次退化成空操作。`\n        + '常见原因是同一份组件模块被加载成了两份（链到工作区的库重建产物后，'\n        + 'dev server 的模块图会新旧混杂），清掉 node_modules/.vite 再重启即可。',\n      detail: { service, error },\n    })\n    // 不调 app.unmount()：mount 抛出时 Vue 并没把 isMounted 置真，\n    // 这时卸载只会再吐一条「Cannot unmount an app that is not mounted」\n    holder.remove()\n    return false\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAqBA,SAAgB,iBAAiB,KAAU,QAAqB,SAA0B;CACxF,IAAI;EACF,IAAI,MAAM,MAAM;EAChB,OAAO;CACT,SACO,OAAO;EACZ,iBAAiB;GACf,MAAM,iBAAiB;GACvB,OAAO;GACP,SACE,QAAQ,QAAQ;GAGlB,QAAQ;IAAE;IAAS;GAAM;EAC3B,CAAC;EAGD,OAAO,OAAO;EACd,OAAO;CACT;AACF"}

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

@@ -1,46 +1,58 @@
 import { XhConfig } from "../config/config.js";
 import { MaybeRefOrGetter } from "vue";
-import { NotificationOptions, NotificationPlacement, NotificationTranslations } from "@xihan-ui/headless";
+import { NotificationDedupe, NotificationOptions, NotificationPlacement, NotificationTranslations } from "@xihan-ui/headless";
 //#region src/services/notification-service.d.ts
 interface NotificationServiceOptions {
   /** 默认落位，默认 bottom-end；单条可用 options.placement 覆盖。 */
   placement?: NotificationPlacement;
-  /** 每个位置最多同时留几条，超出挤掉最旧的。不给即不限。 */
+  /** 每个位置最多同时保留几条，超出时先移除低优先级的、同级中移除最旧的。默认 5；传 Infinity 即不限。 */
   max?: number;
-  /** 同一摞内的间距（px），默认 16。 */
+  /** 重复的判定方式，默认 'id'；传 'content' 则同一内容合并为一条并计数。 */
+  dedupe?: NotificationDedupe;
+  /** 同一堆叠内的间距（px），默认 16。 */
   gap?: number;
   duration?: number;
   removeDelay?: number;
   pauseOnPageIdle?: boolean;
-  /** 通知的文案：那一摞的读屏名与卡片上那颗叉的读屏名，一个桶装完。 */
+  /** 通知的文案：堆叠区的读屏名与卡片上关闭按钮的读屏名，统一在一个桶中。 */
   translations?: MaybeRefOrGetter<Partial<NotificationTranslations>>;
   /**
-   * 喂给通知子树的全局配置（locale / translations / size / portalContainer）。
-   * 本服务自带宿主应用，接不到组件树里的 provideXhConfig，要让它跟应用同语言就从这里给；
-   * 传 ref/getter 即可运行期跟着切语言，也可以之后用 setConfig 推。
+   * 提供给通知子树的全局配置（locale / translations / size / portalContainer）。
+   * 本服务自带宿主应用，无法接收组件树中的 provideXhConfig，需要与应用同语言时从这里提供；
+   * 传 ref/getter 即可在运行期跟随切换语言，也可以之后用 setConfig 推送。
    */
   config?: MaybeRefOrGetter<XhConfig>;
-  /** 宿主容器；不给就在 body 下新建一个。 */
+  /** 宿主容器；未提供时在 body 下新建一个。 */
   target?: HTMLElement;
 }
+/**
+ * create 的入参。`actionLabel` 是卡片上行内动作按钮的文案，`onAction` 是按下它执行的动作：
+ * 回调不进入队列记录（该记录要能被整份替换、序列化、比对），服务按 id 单独保存一张表。
+ */
+interface NotificationCreateOptions extends NotificationOptions {
+  onAction?: () => void;
+}
 /** 类型糖的入参：只差 type 与 title，其余同 create。 */
-type NotificationMessageOptions = Omit<NotificationOptions, 'type' | 'title'>;
+type NotificationMessageOptions = Omit<NotificationCreateOptions, 'tone' | 'loading' | 'title'>;
 interface NotificationService {
-  /** 入队并返回 id；同 id 已存在则就地改写，位置不动。 */
-  create: (options?: NotificationOptions) => string;
+  /** 入队并返回 id；同 id 已存在则就地改写，被合并的返回被并入的那一条。 */
+  create: (options?: NotificationCreateOptions) => string;
   update: (id: string, options: Partial<NotificationOptions>) => void;
   dismiss: (id: string) => void;
   dismissAll: () => void;
   info: (title: string, options?: NotificationMessageOptions) => string;
   success: (title: string, options?: NotificationMessageOptions) => string;
   warning: (title: string, options?: NotificationMessageOptions) => string;
-  error: (title: string, options?: NotificationMessageOptions) => string;
-  /** 换一份全局配置源。 */
+  danger: (title: string, options?: NotificationMessageOptions) => string;
+  /** 暂停当前这些卡片的计时，'service' 这一路与指针、焦点并存。 */
+  pauseAll: () => void;
+  resumeAll: () => void;
+  /** 更换全局配置源。 */
   setConfig: (next: MaybeRefOrGetter<XhConfig> | undefined) => void;
   /** 卸载宿主应用并移除容器。 */
   dispose: () => void;
 }
 declare function createNotificationService(options?: NotificationServiceOptions): NotificationService;
 //#endregion
-export { NotificationMessageOptions, NotificationService, NotificationServiceOptions, createNotificationService };
+export { NotificationCreateOptions, NotificationMessageOptions, NotificationService, NotificationServiceOptions, createNotificationService };
 //# sourceMappingURL=notification-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"notification-service.d.ts","names":[],"sources":["../../src/services/notification-service.ts"],"mappings":";;;;UA8BiB;;EAEf,YAAY;;EAEZ;;EAEA;EACA;EACA;EACA;;EAEA,eAAe,iBAAiB,QAAQ;;;;;;EAMxC,SAAS,iBAAiB;;EAE1B,SAAS;;;KAIC,6BAA6B,KAAK;UAE7B;;EAEf,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;EACtC,UAAU;EACV;EACA,OAAO,eAAe,UAAU;EAChC,UAAU,eAAe,UAAU;EACnC,UAAU,eAAe,UAAU;EACnC,QAAQ,eAAe,UAAU;;EAEjC,YAAY,MAAM,iBAAiB;;EAEnC;;iBAiCc,0BAA0B,UAAS,6BAAkC"}
+{"version":3,"file":"notification-service.d.ts","names":[],"sources":["../../src/services/notification-service.ts"],"mappings":";;;;UAsCiB;;EAEf,YAAY;;EAEZ;;EAEA,SAAS;;EAET;EACA;EACA;EACA;;EAEA,eAAe,iBAAiB,QAAQ;;;;;;EAMxC,SAAS,iBAAiB;;EAE1B,SAAS;;;;;;UAOM,kCAAkC;EACjD;;;KAIU,6BAA6B,KAAK;UAE7B;;EAEf,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;EACtC,UAAU;EACV;EACA,OAAO,eAAe,UAAU;EAChC,UAAU,eAAe,UAAU;EACnC,UAAU,eAAe,UAAU;EACnC,SAAS,eAAe,UAAU;;EAElC;EACA;;EAEA,YAAY,MAAM,iBAAiB;;EAEnC;;iBAuCc,0BAA0B,UAAS,6BAAkC"}