@xihan-ui/vue 2.0.0 → 3.0.0

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

@@ -7,7 +7,7 @@ import { createRuntimeConfig, createScope } from "@xihan-ui/core";
 import { connectMenubar, createMenuTreeNode, menubarMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/menubar/use-menubar.ts
-function useMenubar(props, onValueChange, onSelect) {
+function useMenubar(props, onValueChange, onSelect, onCheckboxValueChange, onRadioValueChange) {
 	const xhConfig = useXhConfig();
 	const rootRef = ref(null);
 	const triggers = /* @__PURE__ */ new Map();
@@ -35,7 +35,9 @@ function useMenubar(props, onValueChange, onSelect) {
 	service = useMachine(menubarMachine, () => ({
 		...props,
 		onValueChange,
-		onSelect
+		onSelect,
+		onCheckboxValueChange,
+		onRadioValueChange
 	}), scope);
 	const put = (table) => (value, el) => {
 		if (el) table.set(value, el);

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

@@ -1 +1 @@
-{"version":3,"file":"use-menubar.js","names":[],"sources":["../../../src/components/menubar/use-menubar.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use menubar 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { MenubarApi, MenubarSchema, MenuTreeNode } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectMenubar, createMenuTreeNode, menubarMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref, shallowReactive } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\n/** 按 value 登记角色节点，浮层三件套据此取到当前展开的菜单项。 */\nexport type MenubarPartRegistry = (value: string, el: HTMLElement | null) => void\n\nexport interface MenubarContext {\n  service: Service<MenubarSchema>\n  api: ComputedRef<MenubarApi>\n  rootRef: Ref<HTMLElement | null>\n  registerTrigger: MenubarPartRegistry\n  registerPositioner: MenubarPartRegistry\n  registerContent: MenubarPartRegistry\n  /** 子菜单经 Portal 分离后的逻辑父节点。 */\n  tree: MenuTreeNode\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useMenubar(\n  props: MenubarSchema['props'],\n  onValueChange?: MenubarSchema['props']['onValueChange'],\n  onSelect?: MenubarSchema['props']['onSelect'],\n): MenubarContext {\n  const xhConfig = useXhConfig()\n  const rootRef = ref<HTMLElement | null>(null)\n  // 触发器只在事件与效应里被机器读，普通 Map 即可；定位层与内容还要派生「当前展开那张」的两支 ref\n  // （层注册的 node 与分支读它们），登记表得是响应式的，菜单后到时派生值才跟着更新\n  const triggers = new Map<string, HTMLElement>()\n  const positioners = shallowReactive(new Map<string, HTMLElement>())\n  const contents = shallowReactive(new Map<string, HTMLElement>())\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  let service: Service<MenubarSchema> | null = null\n  const tree = createMenuTreeNode({\n    getPositioner: () => {\n      const value = service?.context.get('value') ?? null\n      return value == null ? null : positioners.get(value) ?? null\n    },\n    isOpen: () => service?.state.get() === 'open',\n    close: () => service?.send({ type: 'CLOSE' }),\n    isRoot: () => true,\n    onRootSelect: (details) => {\n      const menu = service?.context.get('value') ?? null\n      if (menu != null)\n        onSelect?.({ menu, value: details.value })\n    },\n  })\n  service = useMachine(menubarMachine, () => ({ ...props, onValueChange, onSelect }), scope)\n\n  const put = (table: Map<string, HTMLElement>): MenubarPartRegistry => (value, el) => {\n    if (el)\n      table.set(value, el)\n    else\n      table.delete(value)\n  }\n  const current = (table: Map<string, HTMLElement>) => (): HTMLElement | null => {\n    const value = service.context.get('value') ?? null\n    return value == null ? null : table.get(value) ?? null\n  }\n  // 当前展开那张菜单的定位层与内容：层注册按它们记 node 与分支\n  const positionerRef = computed(current(positioners))\n  const contentRef = computed(current(contents))\n\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按有无菜单展开驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 整条菜单栏记为本层分支，点 trigger 与掠过换菜单都算层内交互；\n      // 当前那张的定位层一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [rootRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      // 菜单不带遮罩，没有可点关闭的表面\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', current(triggers))\n    service.refs.set('getFloatingEl', current(positioners))\n    service.refs.set('getContentEl', current(contents))\n    service.refs.set('getRootEl', () => rootRef.value)\n  }\n\n  const api = computed(() => connectMenubar(service, vueNormalize))\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return {\n    service,\n    api,\n    rootRef,\n    registerTrigger: put(triggers),\n    registerPositioner: put(positioners),\n    registerContent: put(contents),\n    tree,\n    portalTarget,\n  }\n}\n"],"mappings":";;;;;;;;;AAmCA,SAAgB,WACd,OACA,eACA,UACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,UAAU,IAAwB,IAAI;CAG5C,MAAM,2BAAW,IAAI,IAAyB;CAC9C,MAAM,cAAc,gCAAgB,IAAI,IAAyB,CAAC;CAClE,MAAM,WAAW,gCAAgB,IAAI,IAAyB,CAAC;CAE/D,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,IAAI,UAAyC;CAC7C,MAAM,OAAO,mBAAmB;EAC9B,qBAAqB;GACnB,MAAM,QAAQ,SAAS,QAAQ,IAAI,OAAO,KAAK;GAC/C,OAAO,SAAS,OAAO,OAAO,YAAY,IAAI,KAAK,KAAK;EAC1D;EACA,cAAc,SAAS,MAAM,IAAI,MAAM;EACvC,aAAa,SAAS,KAAK,EAAE,MAAM,QAAQ,CAAC;EAC5C,cAAc;EACd,eAAe,YAAY;GACzB,MAAM,OAAO,SAAS,QAAQ,IAAI,OAAO,KAAK;GAC9C,IAAI,QAAQ,MACV,WAAW;IAAE;IAAM,OAAO,QAAQ;GAAM,CAAC;EAC7C;CACF,CAAC;CACD,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;EAAe;CAAS,IAAI,KAAK;CAEzF,MAAM,OAAO,WAA0D,OAAO,OAAO;EACnF,IAAI,IACF,MAAM,IAAI,OAAO,EAAE;OAEnB,MAAM,OAAO,KAAK;CACtB;CACA,MAAM,WAAW,gBAA8D;EAC7E,MAAM,QAAQ,QAAQ,QAAQ,IAAI,OAAO,KAAK;EAC9C,OAAO,SAAS,OAAO,OAAO,MAAM,IAAI,KAAK,KAAK;CACpD;CAEA,MAAM,gBAAgB,SAAS,QAAQ,WAAW,CAAC;CACnD,MAAM,aAAa,SAAS,QAAQ,QAAQ,CAAC;CAE7C,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,QAAQ,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACnE,eAAe;GAEf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,eAAe,QAAQ,QAAQ,CAAC;EACjD,QAAQ,KAAK,IAAI,iBAAiB,QAAQ,WAAW,CAAC;EACtD,QAAQ,KAAK,IAAI,gBAAgB,QAAQ,QAAQ,CAAC;EAClD,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACnD;CAEA,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAEhE,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,OAAO;EACL;EACA;EACA;EACA,iBAAiB,IAAI,QAAQ;EAC7B,oBAAoB,IAAI,WAAW;EACnC,iBAAiB,IAAI,QAAQ;EAC7B;EACA;CACF;AACF"}
+{"version":3,"file":"use-menubar.js","names":[],"sources":["../../../src/components/menubar/use-menubar.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use menubar 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { MenubarApi, MenubarSchema, MenuTreeNode } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectMenubar, createMenuTreeNode, menubarMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref, shallowReactive } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\n/** 按 value 登记角色节点，浮层三件套据此取到当前展开的菜单项。 */\nexport type MenubarPartRegistry = (value: string, el: HTMLElement | null) => void\n\nexport interface MenubarContext {\n  service: Service<MenubarSchema>\n  api: ComputedRef<MenubarApi>\n  rootRef: Ref<HTMLElement | null>\n  registerTrigger: MenubarPartRegistry\n  registerPositioner: MenubarPartRegistry\n  registerContent: MenubarPartRegistry\n  /** 子菜单经 Portal 分离后的逻辑父节点。 */\n  tree: MenuTreeNode\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useMenubar(\n  props: MenubarSchema['props'],\n  onValueChange?: MenubarSchema['props']['onValueChange'],\n  onSelect?: MenubarSchema['props']['onSelect'],\n  onCheckboxValueChange?: MenubarSchema['props']['onCheckboxValueChange'],\n  onRadioValueChange?: MenubarSchema['props']['onRadioValueChange'],\n): MenubarContext {\n  const xhConfig = useXhConfig()\n  const rootRef = ref<HTMLElement | null>(null)\n  // 触发器只在事件与效应里被机器读，普通 Map 即可；定位层与内容还要派生「当前展开那张」的两支 ref\n  // （层注册的 node 与分支读它们），登记表得是响应式的，菜单后到时派生值才跟着更新\n  const triggers = new Map<string, HTMLElement>()\n  const positioners = shallowReactive(new Map<string, HTMLElement>())\n  const contents = shallowReactive(new Map<string, HTMLElement>())\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  let service: Service<MenubarSchema> | null = null\n  const tree = createMenuTreeNode({\n    getPositioner: () => {\n      const value = service?.context.get('value') ?? null\n      return value == null ? null : positioners.get(value) ?? null\n    },\n    isOpen: () => service?.state.get() === 'open',\n    close: () => service?.send({ type: 'CLOSE' }),\n    isRoot: () => true,\n    onRootSelect: (details) => {\n      const menu = service?.context.get('value') ?? null\n      if (menu != null)\n        onSelect?.({ menu, value: details.value })\n    },\n  })\n  service = useMachine(menubarMachine, () => ({ ...props, onValueChange, onSelect, onCheckboxValueChange, onRadioValueChange }), scope)\n\n  const put = (table: Map<string, HTMLElement>): MenubarPartRegistry => (value, el) => {\n    if (el)\n      table.set(value, el)\n    else\n      table.delete(value)\n  }\n  const current = (table: Map<string, HTMLElement>) => (): HTMLElement | null => {\n    const value = service.context.get('value') ?? null\n    return value == null ? null : table.get(value) ?? null\n  }\n  // 当前展开那张菜单的定位层与内容：层注册按它们记 node 与分支\n  const positionerRef = computed(current(positioners))\n  const contentRef = computed(current(contents))\n\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按有无菜单展开驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 整条菜单栏记为本层分支，点 trigger 与掠过换菜单都算层内交互；\n      // 当前那张的定位层一并记上：条目列表之外还浮着自绘滚动条，按住它拖动不该把菜单消解掉\n      branches: () => [rootRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      // 菜单不带遮罩，没有可点关闭的表面\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('position', createPositionEngine())\n    service.refs.set('getAnchorEl', current(triggers))\n    service.refs.set('getFloatingEl', current(positioners))\n    service.refs.set('getContentEl', current(contents))\n    service.refs.set('getRootEl', () => rootRef.value)\n  }\n\n  const api = computed(() => connectMenubar(service, vueNormalize))\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return {\n    service,\n    api,\n    rootRef,\n    registerTrigger: put(triggers),\n    registerPositioner: put(positioners),\n    registerContent: put(contents),\n    tree,\n    portalTarget,\n  }\n}\n"],"mappings":";;;;;;;;;AAmCA,SAAgB,WACd,OACA,eACA,UACA,uBACA,oBACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,UAAU,IAAwB,IAAI;CAG5C,MAAM,2BAAW,IAAI,IAAyB;CAC9C,MAAM,cAAc,gCAAgB,IAAI,IAAyB,CAAC;CAClE,MAAM,WAAW,gCAAgB,IAAI,IAAyB,CAAC;CAE/D,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,IAAI,UAAyC;CAC7C,MAAM,OAAO,mBAAmB;EAC9B,qBAAqB;GACnB,MAAM,QAAQ,SAAS,QAAQ,IAAI,OAAO,KAAK;GAC/C,OAAO,SAAS,OAAO,OAAO,YAAY,IAAI,KAAK,KAAK;EAC1D;EACA,cAAc,SAAS,MAAM,IAAI,MAAM;EACvC,aAAa,SAAS,KAAK,EAAE,MAAM,QAAQ,CAAC;EAC5C,cAAc;EACd,eAAe,YAAY;GACzB,MAAM,OAAO,SAAS,QAAQ,IAAI,OAAO,KAAK;GAC9C,IAAI,QAAQ,MACV,WAAW;IAAE;IAAM,OAAO,QAAQ;GAAM,CAAC;EAC7C;CACF,CAAC;CACD,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;EAAe;EAAU;EAAuB;CAAmB,IAAI,KAAK;CAEpI,MAAM,OAAO,WAA0D,OAAO,OAAO;EACnF,IAAI,IACF,MAAM,IAAI,OAAO,EAAE;OAEnB,MAAM,OAAO,KAAK;CACtB;CACA,MAAM,WAAW,gBAA8D;EAC7E,MAAM,QAAQ,QAAQ,QAAQ,IAAI,OAAO,KAAK;EAC9C,OAAO,SAAS,OAAO,OAAO,MAAM,IAAI,KAAK,KAAK;CACpD;CAEA,MAAM,gBAAgB,SAAS,QAAQ,WAAW,CAAC;CACnD,MAAM,aAAa,SAAS,QAAQ,QAAQ,CAAC;CAE7C,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,QAAQ,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACnE,eAAe;GAEf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EACnD,QAAQ,KAAK,IAAI,eAAe,QAAQ,QAAQ,CAAC;EACjD,QAAQ,KAAK,IAAI,iBAAiB,QAAQ,WAAW,CAAC;EACtD,QAAQ,KAAK,IAAI,gBAAgB,QAAQ,QAAQ,CAAC;EAClD,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACnD;CAEA,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAEhE,MAAM,eAAe,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAAM;CAE/H,OAAO;EACL;EACA;EACA;EACA,iBAAiB,IAAI,QAAQ;EAC7B,oBAAoB,IAAI,WAAW;EACnC,iBAAiB,IAAI,QAAQ;EAC7B;EACA;CACF;AACF"}

package/dist/components/message-feed/message-feed.d.ts

@@ -102,9 +102,21 @@ declare const XhMessageFeedItemLabel: import("vue").DefineComponent<{}, () => VN
 declare const XhMessageFeedScrollToEndTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 回到底部按钮上的未读数：放进按钮里；插槽留空时显示条数，没有未读时收起。 */
+declare const XhMessageFeedUnreadCount: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 消息之间的分隔（按日期分组）：是内容层的直接子节点、与条目平级，对读屏隐藏。 */
+declare const XhMessageFeedSeparator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 已发送、等首个片段时的呼吸点：放在列表之后，只在 status 为 submitted 时出现。 */
+declare const XhMessageFeedPendingIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhMessageFeedLiveRegion: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { MessageFeedRootSlotProps, XhMessageFeedItem, XhMessageFeedItemLabel, XhMessageFeedList, XhMessageFeedLiveRegion, XhMessageFeedRoot, XhMessageFeedScrollToEndTrigger, XhMessageFeedViewport };
+export { MessageFeedRootSlotProps, XhMessageFeedItem, XhMessageFeedItemLabel, XhMessageFeedList, XhMessageFeedLiveRegion, XhMessageFeedPendingIndicator, XhMessageFeedRoot, XhMessageFeedScrollToEndTrigger, XhMessageFeedSeparator, XhMessageFeedUnreadCount, XhMessageFeedViewport };
 //# sourceMappingURL=message-feed.d.ts.map

package/dist/components/message-feed/message-feed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-feed.d.ts","names":[],"sources":["../../../src/components/message-feed/message-feed.ts"],"mappings":";;;;;KAsBK,QAAQ;;KAyBD,2BAA2B,KACrC;cAWW,iCAAiB,8BAAA;;;;;IAKA,MAAA,SAAS;;;;;;;;;;IAGX,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAGtB,iBAAA,UAAA,UAAU;EACZ,eAAA,UAAA,UAAU;;;;;;IART,MAAA,SAAS;;;;;;;;;;IAGX,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;EAOvC,WAAC,OAAO,6BAA6B;kCAsBjD;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAUhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAU5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;IAMa,MAAA;;;;IACX,MAAA,SAAS;;;;;;;;;;;IADE,MAAA;;;;IACX,MAAA,SAAS;;;;;qCAoBvC;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAkBjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAM1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"message-feed.d.ts","names":[],"sources":["../../../src/components/message-feed/message-feed.ts"],"mappings":";;;;;KAsBK,QAAQ;;KAyBD,2BAA2B,KACrC;cAWW,iCAAiB,8BAAA;;;;;IAKA,MAAA,SAAS;;;;;;;;;;IAGX,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAGtB,iBAAA,UAAA,UAAU;EACZ,eAAA,UAAA,UAAU;;;;;;IART,MAAA,SAAS;;;;;;;;;;IAGX,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;EAOvC,WAAC,OAAO,6BAA6B;kCAsBjD;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAUhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAU5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;IAMa,MAAA;;;;IACX,MAAA,SAAS;;;;;;;;;;;IADE,MAAA;;;;IACX,MAAA,SAAS;;;;;qCAoBvC;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAkBjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAM1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/message-feed/message-feed.js

@@ -135,6 +135,30 @@ const XhMessageFeedScrollToEndTrigger = defineComponent({
 		return () => h("button", ctx.api.value.getScrollToEndTriggerProps(), slots.default?.());
 	}
 });
+/** 回到底部按钮上的未读数：放进按钮里；插槽留空时显示条数，没有未读时收起。 */
+const XhMessageFeedUnreadCount = defineComponent({
+	name: "XhMessageFeedUnreadCount",
+	setup(_, { slots }) {
+		const ctx = useMessageFeedContext();
+		return () => h("span", ctx.api.value.getUnreadCountProps(), slots.default?.() ?? String(ctx.api.value.unreadCount));
+	}
+});
+/** 消息之间的分隔（按日期分组）：是内容层的直接子节点、与条目平级，对读屏隐藏。 */
+const XhMessageFeedSeparator = defineComponent({
+	name: "XhMessageFeedSeparator",
+	setup(_, { slots }) {
+		const ctx = useMessageFeedContext();
+		return () => h("div", ctx.api.value.getSeparatorProps(), slots.default?.());
+	}
+});
+/** 已发送、等首个片段时的呼吸点：放在列表之后，只在 status 为 submitted 时出现。 */
+const XhMessageFeedPendingIndicator = defineComponent({
+	name: "XhMessageFeedPendingIndicator",
+	setup() {
+		const ctx = useMessageFeedContext();
+		return () => h("span", ctx.api.value.getPendingIndicatorProps());
+	}
+});
 const XhMessageFeedLiveRegion = defineComponent({
 	name: "XhMessageFeedLiveRegion",
 	setup(_, { slots }) {
@@ -143,6 +167,6 @@ const XhMessageFeedLiveRegion = defineComponent({
 	}
 });
 //#endregion
-export { XhMessageFeedItem, XhMessageFeedItemLabel, XhMessageFeedList, XhMessageFeedLiveRegion, XhMessageFeedRoot, XhMessageFeedScrollToEndTrigger, XhMessageFeedViewport };
+export { XhMessageFeedItem, XhMessageFeedItemLabel, XhMessageFeedList, XhMessageFeedLiveRegion, XhMessageFeedPendingIndicator, XhMessageFeedRoot, XhMessageFeedScrollToEndTrigger, XhMessageFeedSeparator, XhMessageFeedUnreadCount, XhMessageFeedViewport };
 
 //# sourceMappingURL=message-feed.js.map

package/dist/components/message-feed/message-feed.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-feed.js","names":[],"sources":["../../../src/components/message-feed/message-feed.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// 提供 message feed 相关实现。\n\nimport type { Size } from '@xihan-ui/core'\nimport type { MessageFeedApi, MessageFeedItemRole, MessageFeedSchema, MessageFeedStatus, MessageFeedTranslations } from '@xihan-ui/headless'\nimport type { PropType, Ref, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { MessageFeedContext } from './use-message-feed'\nimport { defineComponent, h, onBeforeUnmount, onMounted, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport {\n  provideMessageFeed,\n  provideMessageFeedItem,\n  useMessageFeedContext,\n  useMessageFeedItemContext,\n} from './context'\nimport { useMessageFeed } from './use-message-feed'\n\ntype Props = MessageFeedSchema['props']\n\n/** 本条持有焦点时，id 变更重新报告锚点，卸载时上报整份消息流失焦 */\nfunction reportItemFocus(ctx: MessageFeedContext, el: Ref<HTMLElement | null>, id: () => string): void {\n  watch(id, (next, prev) => {\n    if (next === prev)\n      return\n    const { service } = ctx\n    if (service.getStatus() !== 'Started')\n      return\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'ITEM.FOCUS', id: next })\n  })\n  onBeforeUnmount(() => {\n    const { service } = ctx\n    // 整份消息流一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n    if (service.getStatus() !== 'Started')\n      return\n    // 按「本条当下正持有焦点」判定，不按 id 比对\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'FEED.BLUR' })\n  })\n}\n\n/** 默认插槽的载荷：粘底状态、锚点，以及三个命令式入口。 */\nexport type MessageFeedRootSlotProps = Pick<\n  MessageFeedApi,\n  | 'status'\n  | 'atBottom'\n  | 'sticking'\n  | 'focusedId'\n  | 'showScrollToEndTrigger'\n  | 'scrollToBottom'\n  | 'scrollToItem'\n  | 'focusItem'\n>\n\nexport const XhMessageFeedRoot = defineComponent({\n  name: 'XhMessageFeedRoot',\n  // 缺省值由机器、connect 与粘底句柄给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    count: { type: Number },\n    status: { type: String as PropType<MessageFeedStatus> },\n    threshold: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<MessageFeedTranslations>> },\n  },\n  emits: {\n    'stick-change': (_details: PayloadOf<Props, 'onStickChange'>) => true,\n    'item-focus': (_details: PayloadOf<Props, 'onItemFocus'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MessageFeedRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useMessageFeed(withXhConfig('message-feed', props) as Props, {\n      onStickChange: details => emit('stick-change', details),\n      onItemFocus: details => emit('item-focus', details),\n    })\n    provideMessageFeed(ctx)\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: ctx.rootRef,\n    }, slots.default?.({\n      status: ctx.api.value.status,\n      atBottom: ctx.api.value.atBottom,\n      sticking: ctx.api.value.sticking,\n      focusedId: ctx.api.value.focusedId,\n      showScrollToEndTrigger: ctx.api.value.showScrollToEndTrigger,\n      scrollToBottom: ctx.api.value.scrollToBottom,\n      scrollToItem: ctx.api.value.scrollToItem,\n      focusItem: ctx.api.value.focusItem,\n    }))\n  },\n})\n\nexport const XhMessageFeedViewport = defineComponent({\n  name: 'XhMessageFeedViewport',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    // 把视口节点交给机器，由粘底句柄监听滚动\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhMessageFeedList = defineComponent({\n  name: 'XhMessageFeedList',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    // 把内容节点交给机器，由粘底句柄观察尺寸；条目必须是它的直接子节点\n    return () => h('div', {\n      ...ctx.api.value.getListProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhMessageFeedItem = defineComponent({\n  name: 'XhMessageFeedItem',\n  // 属性名一律带 item- 前缀：id 与 role 是 HTML 全局属性，落到节点上会与 role=article 打架\n  props: {\n    itemId: { type: String, required: true },\n    // 收字符串是为了让作者能直接写在标记上（`item-index=\"0\"`），与自定义元素那侧同形\n    itemIndex: { type: [Number, String] as PropType<number | string>, required: true },\n    itemRole: { type: String as PropType<MessageFeedItemRole> },\n    itemStreaming: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useMessageFeedContext()\n    const labelCount = ref(0)\n    const el = ref<HTMLElement | null>(null)\n    provideMessageFeedItem({ id: () => props.itemId, labelCount })\n    reportItemFocus(ctx, el, () => props.itemId)\n    return () => h('article', {\n      ...ctx.api.value.getItemProps({\n        id: props.itemId,\n        index: Number(props.itemIndex),\n        role: props.itemRole,\n        streaming: props.itemStreaming,\n        labelled: labelCount.value > 0,\n      }) as Record<string, unknown>,\n      ref: el,\n    }, slots.default?.())\n  },\n})\n\nexport const XhMessageFeedItemLabel = defineComponent({\n  name: 'XhMessageFeedItemLabel',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    const item = useMessageFeedItemContext()\n    // 渲出来了才登记：条目的 aria-labelledby 只在这个节点真在场时才指过来\n    onMounted(() => {\n      item.labelCount.value++\n    })\n    onBeforeUnmount(() => {\n      item.labelCount.value--\n    })\n    return () => h(\n      'span',\n      ctx.api.value.getItemLabelProps({ id: item.id() }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhMessageFeedScrollToEndTrigger = defineComponent({\n  name: 'XhMessageFeedScrollToEndTrigger',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    return () => h('button', ctx.api.value.getScrollToEndTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhMessageFeedLiveRegion = defineComponent({\n  name: 'XhMessageFeedLiveRegion',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    // 播报文本由宿主在一轮流结束时写进来\n    return () => h('div', ctx.api.value.getLiveRegionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"message-feed.js","names":[],"sources":["../../../src/components/message-feed/message-feed.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// 提供 message feed 相关实现。\n\nimport type { Size } from '@xihan-ui/core'\nimport type { MessageFeedApi, MessageFeedItemRole, MessageFeedSchema, MessageFeedStatus, MessageFeedTranslations } from '@xihan-ui/headless'\nimport type { PropType, Ref, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport type { MessageFeedContext } from './use-message-feed'\nimport { defineComponent, h, onBeforeUnmount, onMounted, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport {\n  provideMessageFeed,\n  provideMessageFeedItem,\n  useMessageFeedContext,\n  useMessageFeedItemContext,\n} from './context'\nimport { useMessageFeed } from './use-message-feed'\n\ntype Props = MessageFeedSchema['props']\n\n/** 本条持有焦点时，id 变更重新报告锚点，卸载时上报整份消息流失焦 */\nfunction reportItemFocus(ctx: MessageFeedContext, el: Ref<HTMLElement | null>, id: () => string): void {\n  watch(id, (next, prev) => {\n    if (next === prev)\n      return\n    const { service } = ctx\n    if (service.getStatus() !== 'Started')\n      return\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'ITEM.FOCUS', id: next })\n  })\n  onBeforeUnmount(() => {\n    const { service } = ctx\n    // 整份消息流一起卸载时根部件先停机，此刻送事件会在 dev 下抛\n    if (service.getStatus() !== 'Started')\n      return\n    // 按「本条当下正持有焦点」判定，不按 id 比对\n    if (el.value && service.scope.getActiveElement() === el.value)\n      service.send({ type: 'FEED.BLUR' })\n  })\n}\n\n/** 默认插槽的载荷：粘底状态、锚点，以及三个命令式入口。 */\nexport type MessageFeedRootSlotProps = Pick<\n  MessageFeedApi,\n  | 'status'\n  | 'atBottom'\n  | 'sticking'\n  | 'focusedId'\n  | 'showScrollToEndTrigger'\n  | 'scrollToBottom'\n  | 'scrollToItem'\n  | 'focusItem'\n>\n\nexport const XhMessageFeedRoot = defineComponent({\n  name: 'XhMessageFeedRoot',\n  // 缺省值由机器、connect 与粘底句柄给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    count: { type: Number },\n    status: { type: String as PropType<MessageFeedStatus> },\n    threshold: { type: Number },\n    loop: { type: Boolean, default: undefined },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<MessageFeedTranslations>> },\n  },\n  emits: {\n    'stick-change': (_details: PayloadOf<Props, 'onStickChange'>) => true,\n    'item-focus': (_details: PayloadOf<Props, 'onItemFocus'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: MessageFeedRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useMessageFeed(withXhConfig('message-feed', props) as Props, {\n      onStickChange: details => emit('stick-change', details),\n      onItemFocus: details => emit('item-focus', details),\n    })\n    provideMessageFeed(ctx)\n    return () => h('div', {\n      ...ctx.api.value.getRootProps() as Record<string, unknown>,\n      ref: ctx.rootRef,\n    }, slots.default?.({\n      status: ctx.api.value.status,\n      atBottom: ctx.api.value.atBottom,\n      sticking: ctx.api.value.sticking,\n      focusedId: ctx.api.value.focusedId,\n      showScrollToEndTrigger: ctx.api.value.showScrollToEndTrigger,\n      scrollToBottom: ctx.api.value.scrollToBottom,\n      scrollToItem: ctx.api.value.scrollToItem,\n      focusItem: ctx.api.value.focusItem,\n    }))\n  },\n})\n\nexport const XhMessageFeedViewport = defineComponent({\n  name: 'XhMessageFeedViewport',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    // 把视口节点交给机器，由粘底句柄监听滚动\n    return () => h('div', {\n      ...ctx.api.value.getViewportProps() as Record<string, unknown>,\n      ref: ctx.viewportRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhMessageFeedList = defineComponent({\n  name: 'XhMessageFeedList',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    // 把内容节点交给机器，由粘底句柄观察尺寸；条目必须是它的直接子节点\n    return () => h('div', {\n      ...ctx.api.value.getListProps() as Record<string, unknown>,\n      ref: ctx.contentRef,\n    }, slots.default?.())\n  },\n})\n\nexport const XhMessageFeedItem = defineComponent({\n  name: 'XhMessageFeedItem',\n  // 属性名一律带 item- 前缀：id 与 role 是 HTML 全局属性，落到节点上会与 role=article 打架\n  props: {\n    itemId: { type: String, required: true },\n    // 收字符串是为了让作者能直接写在标记上（`item-index=\"0\"`），与自定义元素那侧同形\n    itemIndex: { type: [Number, String] as PropType<number | string>, required: true },\n    itemRole: { type: String as PropType<MessageFeedItemRole> },\n    itemStreaming: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useMessageFeedContext()\n    const labelCount = ref(0)\n    const el = ref<HTMLElement | null>(null)\n    provideMessageFeedItem({ id: () => props.itemId, labelCount })\n    reportItemFocus(ctx, el, () => props.itemId)\n    return () => h('article', {\n      ...ctx.api.value.getItemProps({\n        id: props.itemId,\n        index: Number(props.itemIndex),\n        role: props.itemRole,\n        streaming: props.itemStreaming,\n        labelled: labelCount.value > 0,\n      }) as Record<string, unknown>,\n      ref: el,\n    }, slots.default?.())\n  },\n})\n\nexport const XhMessageFeedItemLabel = defineComponent({\n  name: 'XhMessageFeedItemLabel',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    const item = useMessageFeedItemContext()\n    // 渲出来了才登记：条目的 aria-labelledby 只在这个节点真在场时才指过来\n    onMounted(() => {\n      item.labelCount.value++\n    })\n    onBeforeUnmount(() => {\n      item.labelCount.value--\n    })\n    return () => h(\n      'span',\n      ctx.api.value.getItemLabelProps({ id: item.id() }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhMessageFeedScrollToEndTrigger = defineComponent({\n  name: 'XhMessageFeedScrollToEndTrigger',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    return () => h('button', ctx.api.value.getScrollToEndTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 回到底部按钮上的未读数：放进按钮里；插槽留空时显示条数，没有未读时收起。 */\nexport const XhMessageFeedUnreadCount = defineComponent({\n  name: 'XhMessageFeedUnreadCount',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    return () => h('span', ctx.api.value.getUnreadCountProps() as Record<string, unknown>, slots.default?.() ?? String(ctx.api.value.unreadCount))\n  },\n})\n\n/** 消息之间的分隔（按日期分组）：是内容层的直接子节点、与条目平级，对读屏隐藏。 */\nexport const XhMessageFeedSeparator = defineComponent({\n  name: 'XhMessageFeedSeparator',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    return () => h('div', ctx.api.value.getSeparatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 已发送、等首个片段时的呼吸点：放在列表之后，只在 status 为 submitted 时出现。 */\nexport const XhMessageFeedPendingIndicator = defineComponent({\n  name: 'XhMessageFeedPendingIndicator',\n  setup() {\n    const ctx = useMessageFeedContext()\n    return () => h('span', ctx.api.value.getPendingIndicatorProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhMessageFeedLiveRegion = defineComponent({\n  name: 'XhMessageFeedLiveRegion',\n  setup(_, { slots }) {\n    const ctx = useMessageFeedContext()\n    // 播报文本由宿主在一轮流结束时写进来\n    return () => h('div', ctx.api.value.getLiveRegionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

package/dist/components/navigation-menu/navigation-menu.d.ts

@@ -162,15 +162,72 @@ declare const XhNavigationMenuContent: import("vue").DefineComponent<import("vue
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 面板里一枝子级的开关：展开时紧跟其后的 XhNavigationMenuBranchContent 露出来 */
+declare const XhNavigationMenuBranchTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+}>> & Readonly<{}>, {
+  disabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 子级开关里的展开方向标记，展开时转向；身份与所在的开关同一份声明 */
+declare const XhNavigationMenuBranchIndicator: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 一枝子级的容器，写在面板里、紧跟自己的开关之后；收着时 hidden */
+declare const XhNavigationMenuBranchContent: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 面板内的链接项：href 由作者写，点击不拦截，只收起导航 */
 declare const XhNavigationMenuLink: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   current: BooleanConstructor;
+  /** 借用作者的子节点（如路由链接）作为链接，不再渲染自己的 `<a>`；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   current: BooleanConstructor;
+  /** 借用作者的子节点（如路由链接）作为链接，不再渲染自己的 `<a>`；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
 }>> & Readonly<{}>, {
   current: boolean;
+  asChild: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 指示条容器，位置由状态机计算后写入内联样式；渲染为 li 以 list 为定位参照系 */
 declare const XhNavigationMenuIndicator: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -181,5 +238,5 @@ declare const XhNavigationMenuViewport: import("vue").DefineComponent<{}, () =>
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { XhNavigationMenuContent, XhNavigationMenuIndicator, XhNavigationMenuItem, XhNavigationMenuLink, XhNavigationMenuList, XhNavigationMenuRoot, XhNavigationMenuTrigger, XhNavigationMenuTriggerIndicator, XhNavigationMenuViewport };
+export { XhNavigationMenuBranchContent, XhNavigationMenuBranchIndicator, XhNavigationMenuBranchTrigger, XhNavigationMenuContent, XhNavigationMenuIndicator, XhNavigationMenuItem, XhNavigationMenuLink, XhNavigationMenuList, XhNavigationMenuRoot, XhNavigationMenuTrigger, XhNavigationMenuTriggerIndicator, XhNavigationMenuViewport };
 //# sourceMappingURL=navigation-menu.d.ts.map

package/dist/components/navigation-menu/navigation-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-menu.d.ts","names":[],"sources":["../../../src/components/navigation-menu/navigation-menu.ts"],"mappings":";;;;;KAmBK,sBAAsB;;cAGd,oCAAoB,8BAAA;;IAIA,MAAA,SAAS;;;IACb,MAAA;;;IACO,MAAA;;;IACD,MAAA,SAAS;;;;;;;;;IAGjB,MAAA,SAAS;;;;;;;;;;;IAGA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAhBN,MAAA,SAAS;;;IACb,MAAA;;;IACO,MAAA;;;IACD,MAAA,SAAS;;;;;;;;;IAGjB,MAAA,SAAS;;;;;;;;;;;IAGA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;qCA0BnC;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAelC;;cAIW,gDAAgC,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAc3C;cAEW,uCAAuB,8BAAA;;;;;;;;;;;;MAgDlC,oDAAA;;cAGW,oCAAoB,8BAAA;;;;;;;;qCAe/B;;cAGW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"navigation-menu.d.ts","names":[],"sources":["../../../src/components/navigation-menu/navigation-menu.ts"],"mappings":";;;;;KAqBK,sBAAsB;;cAGd,oCAAoB,8BAAA;;IAIA,MAAA,SAAS;;;IACb,MAAA;;;IACO,MAAA;;;IACD,MAAA,SAAS;;;;;;;;;IAGjB,MAAA,SAAS;;;;;;;;;;;IAGA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAhBN,MAAA,SAAS;;;IACb,MAAA;;;IACO,MAAA;;;IACD,MAAA,SAAS;;;;;;;;;IAGjB,MAAA,SAAS;;;;;;;;;;;IAGA,MAAA,SAAS,QAAQ;;;IACzB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;qCA0BnC;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAS/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAelC;;cAIW,gDAAgC,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAc3C;cAEW,uCAAuB,8BAAA;;;;;;;;;;;;MAgDlC,oDAAA;;cAGW,6CAA6B,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAexC;;cAGW,+CAA+B,8BAAA;;;;;;;;;;;;MAa1C,oDAAA;;cAGW,6CAA6B,8BAAA;;;;;;;;;;;;MAaxC,oDAAA;;cAGW,oCAAoB,8BAAA;;;;;;;;;;;;;qCAqB/B;;cAGW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAMpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/navigation-menu/navigation-menu.js

@@ -1,5 +1,7 @@
 import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
 import { withXhConfig } from "../../config/config.js";
+import { mergePartProps } from "../../runtime/merge-props.js";
+import { mergeIntoChild } from "../../runtime/as-child.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { provideNavigationMenu, useNavigationMenuContext } from "./context.js";
 import { useNavigationMenu } from "./use-navigation-menu.js";
@@ -163,17 +165,72 @@ const XhNavigationMenuContent = defineComponent({
 		}, slots.default?.());
 	}
 });
+/** 面板里一枝子级的开关：展开时紧跟其后的 XhNavigationMenuBranchContent 露出来 */
+const XhNavigationMenuBranchTrigger = defineComponent({
+	name: "XhNavigationMenuBranchTrigger",
+	props: {
+		value: {
+			type: String,
+			required: true
+		},
+		disabled: {
+			type: Boolean,
+			default: void 0
+		}
+	},
+	setup(props, { slots }) {
+		const ctx = useNavigationMenuContext();
+		return () => h("button", ctx.api.value.getBranchTriggerProps({
+			value: props.value,
+			disabled: props.disabled
+		}), slots.default?.());
+	}
+});
+/** 子级开关里的展开方向标记，展开时转向；身份与所在的开关同一份声明 */
+const XhNavigationMenuBranchIndicator = defineComponent({
+	name: "XhNavigationMenuBranchIndicator",
+	props: { value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useNavigationMenuContext();
+		return () => h("span", ctx.api.value.getBranchIndicatorProps({ value: props.value }), slots.default?.());
+	}
+});
+/** 一枝子级的容器，写在面板里、紧跟自己的开关之后；收着时 hidden */
+const XhNavigationMenuBranchContent = defineComponent({
+	name: "XhNavigationMenuBranchContent",
+	props: { value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useNavigationMenuContext();
+		return () => h("div", ctx.api.value.getBranchContentProps({ value: props.value }), slots.default?.());
+	}
+});
 /** 面板内的链接项：href 由作者写，点击不拦截，只收起导航 */
 const XhNavigationMenuLink = defineComponent({
 	name: "XhNavigationMenuLink",
-	props: { current: Boolean },
-	setup(props, { slots }) {
+	inheritAttrs: false,
+	props: {
+		current: Boolean,
+		/** 借用作者的子节点（如路由链接）作为链接，不再渲染自己的 `<a>`；子节点须恰好一个。 */
+		asChild: Boolean
+	},
+	setup(props, { slots, attrs }) {
 		const ctx = useNavigationMenuContext();
 		const value = useId();
-		return () => h("a", ctx.api.value.getLinkProps({
-			value,
-			current: props.current
-		}), slots.default?.());
+		return () => {
+			const part = mergePartProps(ctx.api.value.getLinkProps({
+				value,
+				current: props.current
+			}), attrs);
+			const children = slots.default?.();
+			if (props.asChild) return mergeIntoChild(children, part, "navigation-menu", { applyAnatomy: true });
+			return h("a", part, children);
+		};
 	}
 });
 /** 指示条容器，位置由状态机计算后写入内联样式；渲染为 li 以 list 为定位参照系 */
@@ -194,16 +251,31 @@ const XhNavigationMenuViewport = defineComponent({
 });
 /**
 * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 一项一个 li：带 href 的铺为直达链接，其余铺为 trigger 加面板，面板内容由 panel 插槽提供。
+* 一项一个 li：带 href 的铺为直达链接，其余铺为 trigger 加面板。面板内容给了 panel 插槽就由它提供，
+* 否则按这一项的 children 铺开：带 href 的条目铺为链接，带 children 的铺为一枝子级（开关 + 箭头 + 子级里的链接）。
 * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
 */
 function renderDefaultTree(collection, panelSlot) {
-	return [h(XhNavigationMenuList, null, () => [...collection.map((node) => h(XhNavigationMenuItem, { key: node.value }, () => node.href != null ? [h(XhNavigationMenuLink, {
+	return [h(XhNavigationMenuList, null, () => [...collection.map((node) => h(XhNavigationMenuItem, { key: node.value }, () => node.href != null ? [renderLink(node)] : [h(XhNavigationMenuTrigger, { value: node.value }, () => node.label), h(XhNavigationMenuContent, { value: node.value }, () => panelSlot ? panelSlot(node) : renderPanelEntries(node.children))])), h(XhNavigationMenuIndicator)])];
+}
+function renderLink(node) {
+	return h(XhNavigationMenuLink, {
+		key: node.value,
 		href: node.href,
 		current: node.current
-	}, () => node.label)] : [h(XhNavigationMenuTrigger, { value: node.value }, () => node.label), h(XhNavigationMenuContent, { value: node.value }, () => panelSlot?.(node) ?? [])])), h(XhNavigationMenuIndicator)])];
+	}, () => node.label);
+}
+/** 面板条目：带 children 的铺为一枝子级，开关与容器相邻；其余铺为链接 */
+function renderPanelEntries(entries) {
+	return entries.flatMap((entry) => entry.children.length > 0 ? [h(XhNavigationMenuBranchTrigger, {
+		key: `${entry.value}:trigger`,
+		value: entry.value
+	}, () => [entry.label, h(XhNavigationMenuBranchIndicator, { value: entry.value })]), h(XhNavigationMenuBranchContent, {
+		key: `${entry.value}:content`,
+		value: entry.value
+	}, () => entry.children.map(renderLink))] : [renderLink(entry)]);
 }
 //#endregion
-export { XhNavigationMenuContent, XhNavigationMenuIndicator, XhNavigationMenuItem, XhNavigationMenuLink, XhNavigationMenuList, XhNavigationMenuRoot, XhNavigationMenuTrigger, XhNavigationMenuTriggerIndicator, XhNavigationMenuViewport };
+export { XhNavigationMenuBranchContent, XhNavigationMenuBranchIndicator, XhNavigationMenuBranchTrigger, XhNavigationMenuContent, XhNavigationMenuIndicator, XhNavigationMenuItem, XhNavigationMenuLink, XhNavigationMenuList, XhNavigationMenuRoot, XhNavigationMenuTrigger, XhNavigationMenuTriggerIndicator, XhNavigationMenuViewport };
 
 //# sourceMappingURL=navigation-menu.js.map

package/dist/components/navigation-menu/navigation-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-menu.js","names":[],"sources":["../../../src/components/navigation-menu/navigation-menu.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// 提供 navigation menu 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { NavigationMenuNode, NavigationMenuNodeMeta, NavigationMenuSchema, NavigationMenuTranslations } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, nextTick, onMounted, ref, useId } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { provideNavigationMenu, useNavigationMenuContext } from './context'\nimport { useNavigationMenu } from './use-navigation-menu'\n\ntype NavigationMenuProps = NavigationMenuSchema['props']\n\n/** 根节点渲染为 nav，收起的三条出口（指针离开、焦点离场、Escape）在这一层处理 */\nexport const XhNavigationMenuRoot = defineComponent({\n  name: 'XhNavigationMenuRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<NavigationMenuNode[]> },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    orientation: { type: String as PropType<Orientation> },\n    delayDuration: { type: Number },\n    skipDelayDuration: { type: Number },\n    dir: { type: String as PropType<Direction> },\n    loop: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NavigationMenuTranslations>> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值以支持 v-model:value\n  emits: {\n    'value-change': (_details: PayloadOf<NavigationMenuProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<NavigationMenuProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: NavigationMenuProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useNavigationMenu(withXhConfig('navigation-menu', props) as NavigationMenuProps, notify)\n    provideNavigationMenu(ctx)\n    return () => {\n      // 默认插槽里有真内容就照旧交给作者；只剩注释或空白时当没写，给了 collection 就按数据铺开整套结构\n      const authored = slots.default?.()\n      const children = slotPaints(authored)\n        ? authored\n        : (props.collection ? renderDefaultTree(ctx.api.value.collection, slots.panel) : undefined)\n      return h('nav', {\n        ...ctx.api.value.getRootProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement },\n      }, children)\n    }\n  },\n})\n\n// 用 ul 而非 div：站点导航是一组并列的去处，读屏会念\"列表，共 n 项\"。\nexport const XhNavigationMenuList = defineComponent({\n  name: 'XhNavigationMenuList',\n  setup(_, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h('ul', {\n      ...ctx.api.value.getListProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.listRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\n/** 一项渲染为一个 li；面板 content 写在同一个 li 内、紧跟 trigger 之后 */\nexport const XhNavigationMenuItem = defineComponent({\n  name: 'XhNavigationMenuItem',\n  setup(_, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h('li', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNavigationMenuTrigger = defineComponent({\n  name: 'XhNavigationMenuTrigger',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h(\n      'button',\n      ctx.api.value.getTriggerProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n// 面板常挂，靠 hidden 显隐，不做懒挂载\n/** 入口中表示下方还有面板的标记，展开时转向；身份与所在 trigger 同一份声明 */\nexport const XhNavigationMenuTriggerIndicator = defineComponent({\n  name: 'XhNavigationMenuTriggerIndicator',\n  props: {\n    value: { type: String, required: true },\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h(\n      'span',\n      ctx.api.value.getTriggerIndicatorProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhNavigationMenuContent = defineComponent({\n  name: 'XhNavigationMenuContent',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    // 一个面板一份退场闸门：它们各开各的、动画各跑各的，一份管不过来。\n    // 开合判据直接取 connect 这一帧的产出，不另起一套——两边各判一次迟早会说岔\n    const contentRef = ref<HTMLElement | null>(null)\n    let presence: PresenceHandle | null = null\n    const visible = useOverlayExit({\n      config: ctx.config,\n      isOpen: () => ctx.api.value.isOpen(props.value),\n      contentRef,\n      onPresence: (next) => {\n        const previous = presence\n        presence = next\n        if (ctx.service.getStatus() !== 'Started')\n          return\n        if (next) {\n          ctx.service.send({ type: 'PRESENCE.SET', value: props.value, presence: next, connected: true })\n        }\n        else if (previous) {\n          ctx.service.send({ type: 'PRESENCE.SET', value: props.value, presence: previous, connected: false })\n        }\n      },\n    })\n    // setup 期 Presence 早于根机器的 onMounted；挂载后补报一次，确保首帧句柄已入 Headless 表。\n    onMounted(() => {\n      // 子组件 mounted 早于父级根机器启动，再让出一次提交队列才可安全送事件。\n      void nextTick(() => {\n        if (presence && ctx.service.getStatus() === 'Started')\n          ctx.service.send({ type: 'PRESENCE.SET', value: props.value, presence, connected: true })\n      })\n    })\n    return () => h(\n      'div',\n      {\n        ...ctx.api.value.getContentProps({ value: props.value }) as Record<string, unknown>,\n        // 收起跟着闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场就一帧都\n        // 播不出来），所以真正的收起落成内联 display\n        style: visible.value ? undefined : { display: 'none' },\n        ref: (el: unknown) => { contentRef.value = el as HTMLElement | null },\n      },\n      slots.default?.(),\n    )\n  },\n})\n\n/** 面板内的链接项：href 由作者写，点击不拦截，只收起导航 */\nexport const XhNavigationMenuLink = defineComponent({\n  name: 'XhNavigationMenuLink',\n  props: {\n    current: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    // 链接身份：按压通道按它记按住的那一条，按实例生成，作者不必提供\n    const value = useId()\n    return () => h(\n      'a',\n      ctx.api.value.getLinkProps({ value, current: props.current }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/** 指示条容器，位置由状态机计算后写入内联样式；渲染为 li 以 list 为定位参照系 */\nexport const XhNavigationMenuIndicator = defineComponent({\n  name: 'XhNavigationMenuIndicator',\n  setup() {\n    const ctx = useNavigationMenuContext()\n    return () => h('li', ctx.api.value.getIndicatorProps() as Record<string, unknown>)\n  },\n})\n\n/** 可选的共享面板外壳，放在 root 内、list 之后 */\nexport const XhNavigationMenuViewport = defineComponent({\n  name: 'XhNavigationMenuViewport',\n  setup(_, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h('div', ctx.api.value.getViewportProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 一项一个 li：带 href 的铺为直达链接，其余铺为 trigger 加面板，面板内容由 panel 插槽提供。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n */\nfunction renderDefaultTree(\n  collection: readonly NavigationMenuNodeMeta[],\n  panelSlot?: (node: NavigationMenuNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    h(XhNavigationMenuList, null, () => [\n      ...collection.map(node => h(XhNavigationMenuItem, { key: node.value }, () => (\n        node.href != null\n          ? [h(XhNavigationMenuLink, { href: node.href, current: node.current }, () => node.label)]\n          : [\n              h(XhNavigationMenuTrigger, { value: node.value }, () => node.label),\n              h(XhNavigationMenuContent, { value: node.value }, () => panelSlot?.(node) ?? []),\n            ]\n      ))),\n      h(XhNavigationMenuIndicator),\n    ]),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"navigation-menu.js","names":[],"sources":["../../../src/components/navigation-menu/navigation-menu.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// 提供 navigation menu 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { PresenceHandle } from '@xihan-ui/core/presence'\nimport type { NavigationMenuNode, NavigationMenuNodeMeta, NavigationMenuSchema, NavigationMenuTranslations } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, nextTick, onMounted, ref, useId } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { slotPaints } from '../../runtime/slot-content'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { provideNavigationMenu, useNavigationMenuContext } from './context'\nimport { useNavigationMenu } from './use-navigation-menu'\n\ntype NavigationMenuProps = NavigationMenuSchema['props']\n\n/** 根节点渲染为 nav，收起的三条出口（指针离开、焦点离场、Escape）在这一层处理 */\nexport const XhNavigationMenuRoot = defineComponent({\n  name: 'XhNavigationMenuRoot',\n  // 缺省值由机器与 connect 决定；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    collection: { type: Array as PropType<NavigationMenuNode[]> },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    orientation: { type: String as PropType<Orientation> },\n    delayDuration: { type: Number },\n    skipDelayDuration: { type: Number },\n    dir: { type: String as PropType<Direction> },\n    loop: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NavigationMenuTranslations>> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值以支持 v-model:value\n  emits: {\n    'value-change': (_details: PayloadOf<NavigationMenuProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<NavigationMenuProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: NavigationMenuProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useNavigationMenu(withXhConfig('navigation-menu', props) as NavigationMenuProps, notify)\n    provideNavigationMenu(ctx)\n    return () => {\n      // 默认插槽里有真内容就照旧交给作者；只剩注释或空白时当没写，给了 collection 就按数据铺开整套结构\n      const authored = slots.default?.()\n      const children = slotPaints(authored)\n        ? authored\n        : (props.collection ? renderDefaultTree(ctx.api.value.collection, slots.panel) : undefined)\n      return h('nav', {\n        ...ctx.api.value.getRootProps() as Record<string, unknown>,\n        ref: (el: unknown) => { ctx.rootRef.value = el as HTMLElement },\n      }, children)\n    }\n  },\n})\n\n// 用 ul 而非 div：站点导航是一组并列的去处，读屏会念\"列表，共 n 项\"。\nexport const XhNavigationMenuList = defineComponent({\n  name: 'XhNavigationMenuList',\n  setup(_, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h('ul', {\n      ...ctx.api.value.getListProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.listRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\n/** 一项渲染为一个 li；面板 content 写在同一个 li 内、紧跟 trigger 之后 */\nexport const XhNavigationMenuItem = defineComponent({\n  name: 'XhNavigationMenuItem',\n  setup(_, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h('li', ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNavigationMenuTrigger = defineComponent({\n  name: 'XhNavigationMenuTrigger',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h(\n      'button',\n      ctx.api.value.getTriggerProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n// 面板常挂，靠 hidden 显隐，不做懒挂载\n/** 入口中表示下方还有面板的标记，展开时转向；身份与所在 trigger 同一份声明 */\nexport const XhNavigationMenuTriggerIndicator = defineComponent({\n  name: 'XhNavigationMenuTriggerIndicator',\n  props: {\n    value: { type: String, required: true },\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h(\n      'span',\n      ctx.api.value.getTriggerIndicatorProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhNavigationMenuContent = defineComponent({\n  name: 'XhNavigationMenuContent',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    // 一个面板一份退场闸门：它们各开各的、动画各跑各的，一份管不过来。\n    // 开合判据直接取 connect 这一帧的产出，不另起一套——两边各判一次迟早会说岔\n    const contentRef = ref<HTMLElement | null>(null)\n    let presence: PresenceHandle | null = null\n    const visible = useOverlayExit({\n      config: ctx.config,\n      isOpen: () => ctx.api.value.isOpen(props.value),\n      contentRef,\n      onPresence: (next) => {\n        const previous = presence\n        presence = next\n        if (ctx.service.getStatus() !== 'Started')\n          return\n        if (next) {\n          ctx.service.send({ type: 'PRESENCE.SET', value: props.value, presence: next, connected: true })\n        }\n        else if (previous) {\n          ctx.service.send({ type: 'PRESENCE.SET', value: props.value, presence: previous, connected: false })\n        }\n      },\n    })\n    // setup 期 Presence 早于根机器的 onMounted；挂载后补报一次，确保首帧句柄已入 Headless 表。\n    onMounted(() => {\n      // 子组件 mounted 早于父级根机器启动，再让出一次提交队列才可安全送事件。\n      void nextTick(() => {\n        if (presence && ctx.service.getStatus() === 'Started')\n          ctx.service.send({ type: 'PRESENCE.SET', value: props.value, presence, connected: true })\n      })\n    })\n    return () => h(\n      'div',\n      {\n        ...ctx.api.value.getContentProps({ value: props.value }) as Record<string, unknown>,\n        // 收起跟着闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场就一帧都\n        // 播不出来），所以真正的收起落成内联 display\n        style: visible.value ? undefined : { display: 'none' },\n        ref: (el: unknown) => { contentRef.value = el as HTMLElement | null },\n      },\n      slots.default?.(),\n    )\n  },\n})\n\n/** 面板里一枝子级的开关：展开时紧跟其后的 XhNavigationMenuBranchContent 露出来 */\nexport const XhNavigationMenuBranchTrigger = defineComponent({\n  name: 'XhNavigationMenuBranchTrigger',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h(\n      'button',\n      ctx.api.value.getBranchTriggerProps({ value: props.value, disabled: props.disabled }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/** 子级开关里的展开方向标记，展开时转向；身份与所在的开关同一份声明 */\nexport const XhNavigationMenuBranchIndicator = defineComponent({\n  name: 'XhNavigationMenuBranchIndicator',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h(\n      'span',\n      ctx.api.value.getBranchIndicatorProps({ value: props.value }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/** 一枝子级的容器，写在面板里、紧跟自己的开关之后；收着时 hidden */\nexport const XhNavigationMenuBranchContent = defineComponent({\n  name: 'XhNavigationMenuBranchContent',\n  props: {\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h(\n      'div',\n      ctx.api.value.getBranchContentProps({ value: props.value }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\n/** 面板内的链接项：href 由作者写，点击不拦截，只收起导航 */\nexport const XhNavigationMenuLink = defineComponent({\n  name: 'XhNavigationMenuLink',\n  // 直通属性自己合：作者的处理器排在部件前面，asChild 时连同部件属性一起落到作者的链接上\n  inheritAttrs: false,\n  props: {\n    current: Boolean,\n    /** 借用作者的子节点（如路由链接）作为链接，不再渲染自己的 `<a>`；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useNavigationMenuContext()\n    // 链接身份：按压通道按它记按住的那一条，按实例生成，作者不必提供\n    const value = useId()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getLinkProps({ value, current: props.current }) as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      if (props.asChild)\n        return mergeIntoChild(children, part, 'navigation-menu', { applyAnatomy: true })\n      return h('a', part, children)\n    }\n  },\n})\n\n/** 指示条容器，位置由状态机计算后写入内联样式；渲染为 li 以 list 为定位参照系 */\nexport const XhNavigationMenuIndicator = defineComponent({\n  name: 'XhNavigationMenuIndicator',\n  setup() {\n    const ctx = useNavigationMenuContext()\n    return () => h('li', ctx.api.value.getIndicatorProps() as Record<string, unknown>)\n  },\n})\n\n/** 可选的共享面板外壳，放在 root 内、list 之后 */\nexport const XhNavigationMenuViewport = defineComponent({\n  name: 'XhNavigationMenuViewport',\n  setup(_, { slots }) {\n    const ctx = useNavigationMenuContext()\n    return () => h('div', ctx.api.value.getViewportProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 一项一个 li：带 href 的铺为直达链接，其余铺为 trigger 加面板。面板内容给了 panel 插槽就由它提供，\n * 否则按这一项的 children 铺开：带 href 的条目铺为链接，带 children 的铺为一枝子级（开关 + 箭头 + 子级里的链接）。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n */\nfunction renderDefaultTree(\n  collection: readonly NavigationMenuNodeMeta[],\n  panelSlot?: (node: NavigationMenuNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    h(XhNavigationMenuList, null, () => [\n      ...collection.map(node => h(XhNavigationMenuItem, { key: node.value }, () => (\n        node.href != null\n          ? [renderLink(node)]\n          : [\n              h(XhNavigationMenuTrigger, { value: node.value }, () => node.label),\n              h(XhNavigationMenuContent, { value: node.value }, () => (panelSlot ? panelSlot(node) : renderPanelEntries(node.children))),\n            ]\n      ))),\n      h(XhNavigationMenuIndicator),\n    ]),\n  ]\n}\n\nfunction renderLink(node: NavigationMenuNodeMeta): VNode {\n  return h(XhNavigationMenuLink, { key: node.value, href: node.href, current: node.current }, () => node.label)\n}\n\n/** 面板条目：带 children 的铺为一枝子级，开关与容器相邻；其余铺为链接 */\nfunction renderPanelEntries(entries: readonly NavigationMenuNodeMeta[]): VNode[] {\n  return entries.flatMap(entry => (entry.children.length > 0\n    ? [\n        h(XhNavigationMenuBranchTrigger, { key: `${entry.value}:trigger`, value: entry.value }, () => [\n          entry.label,\n          h(XhNavigationMenuBranchIndicator, { value: entry.value }),\n        ]),\n        h(XhNavigationMenuBranchContent, { key: `${entry.value}:content`, value: entry.value }, () => entry.children.map(renderLink)),\n      ]\n    : [renderLink(entry)]))\n}\n"],"mappings":"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"}

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

@@ -1,8 +1,10 @@
-import { ComputedRef } from "vue";
+import { ComputedRef, Ref } from "vue";
 import { NotificationApi, NotificationItemApi, NotificationOptions } from "@xihan-ui/headless";
 //#region src/components/notification/context.d.ts
 interface NotificationContext {
   api: ComputedRef<NotificationApi>;
+  /** 作用域包装节点：条目到达的追踪挂在它上面。 */
+  rootRef: Ref<HTMLElement | null>;
   /** 入队并返回 id；同 id 已存在则就地改写，位置不变。 */
   create: (options?: NotificationOptions) => string;
   update: (id: string, options: Partial<NotificationOptions>) => void;
@@ -11,6 +13,8 @@ interface NotificationContext {
 }
 interface NotificationItemContext {
   api: ComputedRef<NotificationItemApi>;
+  /** 卡片根节点：退场动画从它上面探测。 */
+  rootRef: Ref<HTMLElement | null>;
 }
 declare function provideNotification(ctx: NotificationContext): void;
 declare function useNotificationContext(): NotificationContext;

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/notification/context.ts"],"mappings":";;;UAWiB;EACf,KAAK,YAAY;;EAEjB,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;EACtC,UAAU;EACV;;UAGe;EACf,KAAK,YAAY;;iBAMH,oBAAoB,KAAK;iBAIzB,0BAA0B;;iBAQ1B,kCAAkC;iBAIlC,wBAAwB,KAAK;iBAI7B,8BAA8B"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/notification/context.ts"],"mappings":";;;UAWiB;EACf,KAAK,YAAY;;EAEjB,SAAS,IAAI;;EAEb,SAAS,UAAU;EACnB,SAAS,YAAY,SAAS,QAAQ;EACtC,UAAU;EACV;;UAGe;EACf,KAAK,YAAY;;EAEjB,SAAS,IAAI;;iBAMC,oBAAoB,KAAK;iBAIzB,0BAA0B;;iBAQ1B,kCAAkC;iBAIlC,wBAAwB,KAAK;iBAI7B,8BAA8B"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/notification/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { NotificationApi, NotificationItemApi, NotificationOptions } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface NotificationContext {\n  api: ComputedRef<NotificationApi>\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}\n\nexport interface NotificationItemContext {\n  api: ComputedRef<NotificationItemApi>\n}\n\nconst KEY: InjectionKey<NotificationContext> = Symbol.for('xh-notification')\nconst ITEM_KEY: InjectionKey<NotificationItemContext> = Symbol.for('xh-notification-item')\n\nexport function provideNotification(ctx: NotificationContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNotificationContext(): NotificationContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Notification 部件必须用在 XhNotificationRoot 内')\n  return ctx\n}\n\n/** 注入队列上下文，不在队列内时返回 null 而非抛错。 */\nexport function useNotificationContextOptional(): NotificationContext | null {\n  return inject(KEY, null)\n}\n\nexport function provideNotificationItem(ctx: NotificationItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useNotificationItemContext(): NotificationItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Notification 卡片部件必须用在 XhNotificationItem 内')\n  return ctx\n}\n"],"mappings":";;AAwBA,MAAM,MAAyC,OAAO,IAAI,iBAAiB;AAC3E,MAAM,WAAkD,OAAO,IAAI,sBAAsB;AAEzF,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+CAA+C;CACjE,OAAO;AACT;;AAGA,SAAgB,iCAA6D;CAC3E,OAAO,OAAO,KAAK,IAAI;AACzB;AAEA,SAAgB,wBAAwB,KAAoC;CAC1E,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,6BAAsD;CACpE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iDAAiD;CACnE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/notification/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { NotificationApi, NotificationItemApi, NotificationOptions } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey, Ref } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface NotificationContext {\n  api: ComputedRef<NotificationApi>\n  /** 作用域包装节点：条目到达的追踪挂在它上面。 */\n  rootRef: Ref<HTMLElement | null>\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}\n\nexport interface NotificationItemContext {\n  api: ComputedRef<NotificationItemApi>\n  /** 卡片根节点：退场动画从它上面探测。 */\n  rootRef: Ref<HTMLElement | null>\n}\n\nconst KEY: InjectionKey<NotificationContext> = Symbol.for('xh-notification')\nconst ITEM_KEY: InjectionKey<NotificationItemContext> = Symbol.for('xh-notification-item')\n\nexport function provideNotification(ctx: NotificationContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNotificationContext(): NotificationContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Notification 部件必须用在 XhNotificationRoot 内')\n  return ctx\n}\n\n/** 注入队列上下文，不在队列内时返回 null 而非抛错。 */\nexport function useNotificationContextOptional(): NotificationContext | null {\n  return inject(KEY, null)\n}\n\nexport function provideNotificationItem(ctx: NotificationItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useNotificationItemContext(): NotificationItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Notification 卡片部件必须用在 XhNotificationItem 内')\n  return ctx\n}\n"],"mappings":";;AA4BA,MAAM,MAAyC,OAAO,IAAI,iBAAiB;AAC3E,MAAM,WAAkD,OAAO,IAAI,sBAAsB;AAEzF,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+CAA+C;CACjE,OAAO;AACT;;AAGA,SAAgB,iCAA6D;CAC3E,OAAO,OAAO,KAAK,IAAI;AACzB;AAEA,SAAgB,wBAAwB,KAAoC;CAC1E,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,6BAAsD;CACpE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iDAAiD;CACnE,OAAO;AACT"}