@xihan-ui/vue 1.1.0 → 2.0.0

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":["import type { MenubarApi, MenubarSchema } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { connectMenubar, menubarMachine } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } 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  /** 浮层搬到哪儿：全局配置的容器 > 运行时的浮层落点 > 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 而非响应式，这三份表只在事件与效应里被机器读\n  const triggers = new Map<string, HTMLElement>()\n  const positioners = new Map<string, HTMLElement>()\n  const contents = new Map<string, HTMLElement>()\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const 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\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: current(contents),\n      // 整条菜单栏记为本层分支，点 trigger 与掠过换菜单都算层内交互\n      branches: () => [rootRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\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    portalTarget,\n  }\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAgB,WACd,OACA,eACA,UACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,UAAU,IAAwB,IAAI;CAE5C,MAAM,2BAAW,IAAI,IAAyB;CAC9C,MAAM,8BAAc,IAAI,IAAyB;CACjD,MAAM,2BAAW,IAAI,IAAyB;CAE9C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;EAAe;CAAS,IAAI,KAAK;CAE/F,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,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,MAAM,QAAQ,QAAQ;GAEtB,gBAAgB,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,OAAO;GAC9C,eAAe;GACf,gBAAgB,CAAC;GAEjB,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;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): 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"}

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

@@ -0,0 +1,19 @@
+import { MessageFeedContext } from "./use-message-feed.js";
+import { Ref } from "vue";
+//#region src/components/message-feed/context.d.ts
+/** 条目把自己的身份传给 item-label：标签自身不必再写一遍 id。 */
+interface MessageFeedItemContext {
+  id: () => string;
+  /**
+   * 该条消息中作者渲染的 item-label 数量，由标签自行登记。
+   * 条目的可访问名据此决定指向它还是使用文案兜底：指向一个未渲染的 id 会使读屏读空。
+   */
+  labelCount: Ref<number>;
+}
+declare function provideMessageFeed(ctx: MessageFeedContext): void;
+declare function useMessageFeedContext(): MessageFeedContext;
+declare function provideMessageFeedItem(ctx: MessageFeedItemContext): void;
+declare function useMessageFeedItemContext(): MessageFeedItemContext;
+//#endregion
+export { MessageFeedItemContext, provideMessageFeed, provideMessageFeedItem, useMessageFeedContext, useMessageFeedItemContext };
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../../src/components/message-feed/context.ts"],"mappings":";;;;UAciB;EACf;;;;;EAKA,YAAY;;iBAKE,mBAAmB,KAAK;iBAIxB,yBAAyB;iBAOzB,uBAAuB,KAAK;iBAI5B,6BAA6B"}

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

@@ -0,0 +1,24 @@
+import { inject, provide } from "vue";
+//#region src/components/message-feed/context.ts
+const KEY = Symbol.for("xh-message-feed");
+const ITEM_KEY = Symbol.for("xh-message-feed-item");
+function provideMessageFeed(ctx) {
+	provide(KEY, ctx);
+}
+function useMessageFeedContext() {
+	const ctx = inject(KEY, null);
+	if (!ctx) throw new Error("[xh] MessageFeed 部件必须用在 XhMessageFeedRoot 内");
+	return ctx;
+}
+function provideMessageFeedItem(ctx) {
+	provide(ITEM_KEY, ctx);
+}
+function useMessageFeedItemContext() {
+	const ctx = inject(ITEM_KEY, null);
+	if (!ctx) throw new Error("[xh] MessageFeedItemLabel 必须用在 XhMessageFeedItem 内");
+	return ctx;
+}
+//#endregion
+export { provideMessageFeed, provideMessageFeedItem, useMessageFeedContext, useMessageFeedItemContext };
+
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/message-feed/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { InjectionKey, Ref } from 'vue'\nimport type { MessageFeedContext } from './use-message-feed'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<MessageFeedContext> = Symbol.for('xh-message-feed')\n\n/** 条目把自己的身份传给 item-label：标签自身不必再写一遍 id。 */\nexport interface MessageFeedItemContext {\n  id: () => string\n  /**\n   * 该条消息中作者渲染的 item-label 数量，由标签自行登记。\n   * 条目的可访问名据此决定指向它还是使用文案兜底：指向一个未渲染的 id 会使读屏读空。\n   */\n  labelCount: Ref<number>\n}\n\nconst ITEM_KEY: InjectionKey<MessageFeedItemContext> = Symbol.for('xh-message-feed-item')\n\nexport function provideMessageFeed(ctx: MessageFeedContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useMessageFeedContext(): MessageFeedContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] MessageFeed 部件必须用在 XhMessageFeedRoot 内')\n  return ctx\n}\n\nexport function provideMessageFeedItem(ctx: MessageFeedItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useMessageFeedItemContext(): MessageFeedItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] MessageFeedItemLabel 必须用在 XhMessageFeedItem 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAAwC,OAAO,IAAI,iBAAiB;AAY1E,MAAM,WAAiD,OAAO,IAAI,sBAAsB;AAExF,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT;AAEA,SAAgB,uBAAuB,KAAmC;CACxE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,4BAAoD;CAClE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,oDAAoD;CACtE,OAAO;AACT"}

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

@@ -0,0 +1,110 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, SlotsType, VNode } from "vue";
+import { Size } from "@xihan-ui/core";
+import { MessageFeedApi, MessageFeedItemRole, MessageFeedSchema, MessageFeedStatus, MessageFeedTranslations } from "@xihan-ui/headless";
+//#region src/components/message-feed/message-feed.d.ts
+type Props = MessageFeedSchema['props'];
+/** 默认插槽的载荷：粘底状态、锚点，以及三个命令式入口。 */
+type MessageFeedRootSlotProps = Pick<MessageFeedApi, 'status' | 'atBottom' | 'sticking' | 'focusedId' | 'showScrollToEndTrigger' | 'scrollToBottom' | 'scrollToItem' | 'focusItem'>;
+declare const XhMessageFeedRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  count: {
+    type: NumberConstructor;
+  };
+  status: {
+    type: PropType<MessageFeedStatus>;
+  };
+  threshold: {
+    type: NumberConstructor;
+  };
+  loop: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  size: {
+    type: PropType<Size>;
+  };
+  translations: {
+    type: PropType<Partial<MessageFeedTranslations>>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'stick-change': (_details: PayloadOf<Props, "onStickChange">) => true;
+  'item-focus': (_details: PayloadOf<Props, "onItemFocus">) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  count: {
+    type: NumberConstructor;
+  };
+  status: {
+    type: PropType<MessageFeedStatus>;
+  };
+  threshold: {
+    type: NumberConstructor;
+  };
+  loop: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  size: {
+    type: PropType<Size>;
+  };
+  translations: {
+    type: PropType<Partial<MessageFeedTranslations>>;
+  };
+}>> & Readonly<{
+  "onStick-change"?: ((_details: import("@xihan-ui/headless").MessageFeedStickChangeDetails) => any) | undefined;
+  "onItem-focus"?: ((_details: import("@xihan-ui/headless").MessageFeedItemFocusDetails) => any) | undefined;
+}>, {
+  loop: boolean;
+}, SlotsType<{
+  default?: (props: MessageFeedRootSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhMessageFeedViewport: 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 XhMessageFeedList: 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 XhMessageFeedItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  itemId: {
+    type: StringConstructor;
+    required: true;
+  };
+  itemIndex: {
+    type: PropType<number | string>;
+    required: true;
+  };
+  itemRole: {
+    type: PropType<MessageFeedItemRole>;
+  };
+  itemStreaming: 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<{
+  itemId: {
+    type: StringConstructor;
+    required: true;
+  };
+  itemIndex: {
+    type: PropType<number | string>;
+    required: true;
+  };
+  itemRole: {
+    type: PropType<MessageFeedItemRole>;
+  };
+  itemStreaming: BooleanConstructor;
+}>> & Readonly<{}>, {
+  itemStreaming: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhMessageFeedItemLabel: 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 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 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 };
+//# sourceMappingURL=message-feed.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,148 @@
+import { withXhConfig } from "../../config/config.js";
+import { provideMessageFeed, provideMessageFeedItem, useMessageFeedContext, useMessageFeedItemContext } from "./context.js";
+import { useMessageFeed } from "./use-message-feed.js";
+import { defineComponent, h, onBeforeUnmount, onMounted, ref, watch } from "vue";
+//#region src/components/message-feed/message-feed.ts
+/** 本条持有焦点时，id 变更重新报告锚点，卸载时上报整份消息流失焦 */
+function reportItemFocus(ctx, el, id) {
+	watch(id, (next, prev) => {
+		if (next === prev) return;
+		const { service } = ctx;
+		if (service.getStatus() !== "Started") return;
+		if (el.value && service.scope.getActiveElement() === el.value) service.send({
+			type: "ITEM.FOCUS",
+			id: next
+		});
+	});
+	onBeforeUnmount(() => {
+		const { service } = ctx;
+		if (service.getStatus() !== "Started") return;
+		if (el.value && service.scope.getActiveElement() === el.value) service.send({ type: "FEED.BLUR" });
+	});
+}
+const XhMessageFeedRoot = defineComponent({
+	name: "XhMessageFeedRoot",
+	props: {
+		count: { type: Number },
+		status: { type: String },
+		threshold: { type: Number },
+		loop: {
+			type: Boolean,
+			default: void 0
+		},
+		size: { type: String },
+		translations: { type: Object }
+	},
+	emits: {
+		"stick-change": (_details) => true,
+		"item-focus": (_details) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const ctx = useMessageFeed(withXhConfig("message-feed", props), {
+			onStickChange: (details) => emit("stick-change", details),
+			onItemFocus: (details) => emit("item-focus", details)
+		});
+		provideMessageFeed(ctx);
+		return () => h("div", {
+			...ctx.api.value.getRootProps(),
+			ref: ctx.rootRef
+		}, slots.default?.({
+			status: ctx.api.value.status,
+			atBottom: ctx.api.value.atBottom,
+			sticking: ctx.api.value.sticking,
+			focusedId: ctx.api.value.focusedId,
+			showScrollToEndTrigger: ctx.api.value.showScrollToEndTrigger,
+			scrollToBottom: ctx.api.value.scrollToBottom,
+			scrollToItem: ctx.api.value.scrollToItem,
+			focusItem: ctx.api.value.focusItem
+		}));
+	}
+});
+const XhMessageFeedViewport = defineComponent({
+	name: "XhMessageFeedViewport",
+	setup(_, { slots }) {
+		const ctx = useMessageFeedContext();
+		return () => h("div", {
+			...ctx.api.value.getViewportProps(),
+			ref: ctx.viewportRef
+		}, slots.default?.());
+	}
+});
+const XhMessageFeedList = defineComponent({
+	name: "XhMessageFeedList",
+	setup(_, { slots }) {
+		const ctx = useMessageFeedContext();
+		return () => h("div", {
+			...ctx.api.value.getListProps(),
+			ref: ctx.contentRef
+		}, slots.default?.());
+	}
+});
+const XhMessageFeedItem = defineComponent({
+	name: "XhMessageFeedItem",
+	props: {
+		itemId: {
+			type: String,
+			required: true
+		},
+		itemIndex: {
+			type: [Number, String],
+			required: true
+		},
+		itemRole: { type: String },
+		itemStreaming: Boolean
+	},
+	setup(props, { slots }) {
+		const ctx = useMessageFeedContext();
+		const labelCount = ref(0);
+		const el = ref(null);
+		provideMessageFeedItem({
+			id: () => props.itemId,
+			labelCount
+		});
+		reportItemFocus(ctx, el, () => props.itemId);
+		return () => h("article", {
+			...ctx.api.value.getItemProps({
+				id: props.itemId,
+				index: Number(props.itemIndex),
+				role: props.itemRole,
+				streaming: props.itemStreaming,
+				labelled: labelCount.value > 0
+			}),
+			ref: el
+		}, slots.default?.());
+	}
+});
+const XhMessageFeedItemLabel = defineComponent({
+	name: "XhMessageFeedItemLabel",
+	setup(_, { slots }) {
+		const ctx = useMessageFeedContext();
+		const item = useMessageFeedItemContext();
+		onMounted(() => {
+			item.labelCount.value++;
+		});
+		onBeforeUnmount(() => {
+			item.labelCount.value--;
+		});
+		return () => h("span", ctx.api.value.getItemLabelProps({ id: item.id() }), slots.default?.());
+	}
+});
+const XhMessageFeedScrollToEndTrigger = defineComponent({
+	name: "XhMessageFeedScrollToEndTrigger",
+	setup(_, { slots }) {
+		const ctx = useMessageFeedContext();
+		return () => h("button", ctx.api.value.getScrollToEndTriggerProps(), slots.default?.());
+	}
+});
+const XhMessageFeedLiveRegion = defineComponent({
+	name: "XhMessageFeedLiveRegion",
+	setup(_, { slots }) {
+		const ctx = useMessageFeedContext();
+		return () => h("div", ctx.api.value.getLiveRegionProps(), slots.default?.());
+	}
+});
+//#endregion
+export { XhMessageFeedItem, XhMessageFeedItemLabel, XhMessageFeedList, XhMessageFeedLiveRegion, XhMessageFeedRoot, XhMessageFeedScrollToEndTrigger, XhMessageFeedViewport };
+
+//# sourceMappingURL=message-feed.js.map

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

@@ -0,0 +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":";;;;;;AAyBA,SAAS,gBAAgB,KAAyB,IAA6B,IAAwB;CACrG,MAAM,KAAK,MAAM,SAAS;EACxB,IAAI,SAAS,MACX;EACF,MAAM,EAAE,YAAY;EACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;EACF,IAAI,GAAG,SAAS,QAAQ,MAAM,iBAAiB,MAAM,GAAG,OACtD,QAAQ,KAAK;GAAE,MAAM;GAAc,IAAI;EAAK,CAAC;CACjD,CAAC;CACD,sBAAsB;EACpB,MAAM,EAAE,YAAY;EAEpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;EAEF,IAAI,GAAG,SAAS,QAAQ,MAAM,iBAAiB,MAAM,GAAG,OACtD,QAAQ,KAAK,EAAE,MAAM,YAAY,CAAC;CACtC,CAAC;AACH;AAeA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,OAAO,EAAE,MAAM,OAAO;EACtB,QAAQ,EAAE,MAAM,OAAsC;EACtD,WAAW,EAAE,MAAM,OAAO;EAC1B,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAqD;CAC7E;CACA,OAAO;EACL,iBAAiB,aAAgD;EACjE,eAAe,aAA8C;CAC/D;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,MAAM,eAAe,aAAa,gBAAgB,KAAK,GAAY;GACvE,gBAAe,YAAW,KAAK,gBAAgB,OAAO;GACtD,cAAa,YAAW,KAAK,cAAc,OAAO;EACpD,CAAC;EACD,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,KAAK,IAAI;EACX,GAAG,MAAM,UAAU;GACjB,QAAQ,IAAI,IAAI,MAAM;GACtB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,WAAW,IAAI,IAAI,MAAM;GACzB,wBAAwB,IAAI,IAAI,MAAM;GACtC,gBAAgB,IAAI,IAAI,MAAM;GAC9B,cAAc,IAAI,IAAI,MAAM;GAC5B,WAAW,IAAI,IAAI,MAAM;EAC3B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,wBAAwB,gBAAgB;CACnD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAElC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,iBAAiB;GAClC,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAElC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,aAAa;GAC9B,KAAK,IAAI;EACX,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EACL,QAAQ;GAAE,MAAM;GAAQ,UAAU;EAAK;EAEvC,WAAW;GAAE,MAAM,CAAC,QAAQ,MAAM;GAAgC,UAAU;EAAK;EACjF,UAAU,EAAE,MAAM,OAAwC;EAC1D,eAAe;CACjB;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,sBAAsB;EAClC,MAAM,aAAa,IAAI,CAAC;EACxB,MAAM,KAAK,IAAwB,IAAI;EACvC,uBAAuB;GAAE,UAAU,MAAM;GAAQ;EAAW,CAAC;EAC7D,gBAAgB,KAAK,UAAU,MAAM,MAAM;EAC3C,aAAa,EAAE,WAAW;GACxB,GAAG,IAAI,IAAI,MAAM,aAAa;IAC5B,IAAI,MAAM;IACV,OAAO,OAAO,MAAM,SAAS;IAC7B,MAAM,MAAM;IACZ,WAAW,MAAM;IACjB,UAAU,WAAW,QAAQ;GAC/B,CAAC;GACD,KAAK;EACP,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,MAAM,OAAO,0BAA0B;EAEvC,gBAAgB;GACd,KAAK,WAAW;EAClB,CAAC;EACD,sBAAsB;GACpB,KAAK,WAAW;EAClB,CAAC;EACD,aAAa,EACX,QACA,IAAI,IAAI,MAAM,kBAAkB,EAAE,IAAI,KAAK,GAAG,EAAE,CAAC,GACjD,MAAM,UAAU,CAClB;CACF;AACF,CAAC;AAED,MAAa,kCAAkC,gBAAgB;CAC7D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,2BAA2B,GAA8B,MAAM,UAAU,CAAC;CACnH;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAElC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,mBAAmB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC"}

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

@@ -0,0 +1,20 @@
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
+import { MessageFeedApi, MessageFeedSchema } from "@xihan-ui/headless";
+//#region src/components/message-feed/use-message-feed.d.ts
+type Props = MessageFeedSchema['props'];
+interface MessageFeedContext {
+  api: ComputedRef<MessageFeedApi>;
+  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */
+  service: Service<MessageFeedSchema>;
+  /** 根节点，条目集合的归属容器。 */
+  rootRef: Ref<HTMLElement | null>;
+  /** overflow:auto 的滚动容器节点。 */
+  viewportRef: Ref<HTMLElement | null>;
+  /** 内容包裹层节点，尺寸变化的观察目标。 */
+  contentRef: Ref<HTMLElement | null>;
+}
+declare function useMessageFeed(props: Props, handlers?: Pick<Props, 'onStickChange' | 'onItemFocus'>): MessageFeedContext;
+//#endregion
+export { MessageFeedContext, useMessageFeed };
+//# sourceMappingURL=use-message-feed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-message-feed.d.ts","names":[],"sources":["../../../src/components/message-feed/use-message-feed.ts"],"mappings":";;;;KAiBK,QAAQ;UAEI;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;EAEjB,SAAS,IAAI;;EAEb,aAAa,IAAI;;EAEjB,YAAY,IAAI;;iBAGF,eACd,OAAO,OACP,WAAU,KAAK,0CACd"}

package/dist/components/{thread/use-thread.js → message-feed/use-message-feed.js}

@@ -2,34 +2,38 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
 import { computed, ref, watch } from "vue";
-import { connectThread, threadMachine } from "@xihan-ui/headless";
-import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
-//#region src/components/thread/use-thread.ts
-function useThread(props, onStickChange) {
+import { createRuntimeConfig, createScope } from "@xihan-ui/core";
+import { connectMessageFeed, messageFeedMachine } from "@xihan-ui/headless";
+//#region src/components/message-feed/use-message-feed.ts
+function useMessageFeed(props, handlers = {}) {
+	const rootRef = ref(null);
 	const viewportRef = ref(null);
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
-	const service = useMachine(threadMachine, () => ({
+	const service = useMachine(messageFeedMachine, () => ({
 		...props,
-		onStickChange
+		...handlers
 	}), scope);
 	if (typeof document !== "undefined") service.refs.set("config", createRuntimeConfig({
 		scope,
 		idGenerator: idGen
 	}));
+	service.refs.set("getRootEl", () => rootRef.value);
 	service.refs.set("getViewportEl", () => viewportRef.value);
 	service.refs.set("getContentEl", () => contentRef.value);
 	watch([viewportRef, contentRef], () => {
 		service.refs.get("stick")?.retarget();
 	});
 	return {
-		api: computed(() => connectThread(service, vueNormalize)),
+		api: computed(() => connectMessageFeed(service, vueNormalize)),
+		service,
+		rootRef,
 		viewportRef,
 		contentRef
 	};
 }
 //#endregion
-export { useThread };
+export { useMessageFeed };
 
-//# sourceMappingURL=use-thread.js.map
+//# sourceMappingURL=use-message-feed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-message-feed.js","names":[],"sources":["../../../src/components/message-feed/use-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// 提供 use message feed 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { MessageFeedApi, MessageFeedSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectMessageFeed, messageFeedMachine } from '@xihan-ui/headless'\nimport { computed, ref, watch } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\ntype Props = MessageFeedSchema['props']\n\nexport interface MessageFeedContext {\n  api: ComputedRef<MessageFeedApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<MessageFeedSchema>\n  /** 根节点，条目集合的归属容器。 */\n  rootRef: Ref<HTMLElement | null>\n  /** overflow:auto 的滚动容器节点。 */\n  viewportRef: Ref<HTMLElement | null>\n  /** 内容包裹层节点，尺寸变化的观察目标。 */\n  contentRef: Ref<HTMLElement | null>\n}\n\nexport function useMessageFeed(\n  props: Props,\n  handlers: Pick<Props, 'onStickChange' | 'onItemFocus'> = {},\n): MessageFeedContext {\n  const rootRef = ref<HTMLElement | null>(null)\n  const viewportRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(messageFeedMachine, () => ({ ...props, ...handlers }), scope)\n\n  // 无 DOM 环境不装 config，此时粘底效应整套不挂载\n  if (typeof document !== 'undefined')\n    service.refs.set('config', createRuntimeConfig({ scope, idGenerator: idGen }))\n\n  // 传 getter 而非节点本身，ref 在挂载后才有值\n  service.refs.set('getRootEl', () => rootRef.value)\n  service.refs.set('getViewportEl', () => viewportRef.value)\n  service.refs.set('getContentEl', () => contentRef.value)\n\n  // 节点变化后让句柄重绑\n  watch([viewportRef, contentRef], () => {\n    service.refs.get('stick')?.retarget()\n  })\n\n  const api = computed(() => connectMessageFeed(service, vueNormalize))\n  return { api, service, rootRef, viewportRef, contentRef }\n}\n"],"mappings":";;;;;;;AA+BA,SAAgB,eACd,OACA,WAAyD,CAAC,GACtC;CACpB,MAAM,UAAU,IAAwB,IAAI;CAC5C,MAAM,cAAc,IAAwB,IAAI;CAChD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,2BAA2B;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CAGvF,IAAI,OAAO,aAAa,aACtB,QAAQ,KAAK,IAAI,UAAU,oBAAoB;EAAE;EAAO,aAAa;CAAM,CAAC,CAAC;CAG/E,QAAQ,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CACjD,QAAQ,KAAK,IAAI,uBAAuB,YAAY,KAAK;CACzD,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CAGvD,MAAM,CAAC,aAAa,UAAU,SAAS;EACrC,QAAQ,KAAK,IAAI,OAAO,CAAC,EAAE,SAAS;CACtC,CAAC;CAGD,OAAO;EAAE,KADG,eAAe,mBAAmB,SAAS,YAAY,CACxD;EAAG;EAAS;EAAS;EAAa;CAAW;AAC1D"}

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/navigation-menu/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { NavigationMenuContext } from './use-navigation-menu'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<NavigationMenuContext> = Symbol.for('xh-navigation-menu')\n\nexport function provideNavigationMenu(ctx: NavigationMenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNavigationMenuContext(): NavigationMenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] NavigationMenu 部件必须用在 XhNavigationMenuRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAA2C,OAAO,IAAI,oBAAoB;AAEhF,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mDAAmD;CACrE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/navigation-menu/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport type { InjectionKey } from 'vue'\nimport type { NavigationMenuContext } from './use-navigation-menu'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<NavigationMenuContext> = Symbol.for('xh-navigation-menu')\n\nexport function provideNavigationMenu(ctx: NavigationMenuContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNavigationMenuContext(): NavigationMenuContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] NavigationMenu 部件必须用在 XhNavigationMenuRoot 内')\n  return ctx\n}\n"],"mappings":";;AAWA,MAAM,MAA2C,OAAO,IAAI,oBAAoB;AAEhF,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mDAAmD;CACrE,OAAO;AACT"}

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

@@ -1,54 +1,48 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, VNode } from "vue";
+import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
 import { NavigationMenuNode, NavigationMenuSchema, NavigationMenuTranslations } from "@xihan-ui/headless";
-import { Direction, Orientation, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/navigation-menu/navigation-menu.d.ts
 type NavigationMenuProps = NavigationMenuSchema['props'];
 /** 根节点渲染为 nav，收起的三条出口（指针离开、焦点离场、Escape）在这一层处理 */
 declare const XhNavigationMenuRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<NavigationMenuNode[]>;
-    default: undefined;
   };
   value: {
     type: PropType<string | null>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<string | null>;
-    default: undefined;
   };
   orientation: {
     type: PropType<Orientation>;
-    default: undefined;
   };
   delayDuration: {
     type: NumberConstructor;
-    default: undefined;
   };
   skipDelayDuration: {
     type: NumberConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
     default: undefined;
   };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   translations: {
     type: PropType<Partial<NavigationMenuTranslations>>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -58,63 +52,48 @@ declare const XhNavigationMenuRoot: import("vue").DefineComponent<import("vue").
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<NavigationMenuNode[]>;
-    default: undefined;
   };
   value: {
     type: PropType<string | null>;
-    default: undefined;
   };
   defaultValue: {
     type: PropType<string | null>;
-    default: undefined;
   };
   orientation: {
     type: PropType<Orientation>;
-    default: undefined;
   };
   delayDuration: {
     type: NumberConstructor;
-    default: undefined;
   };
   skipDelayDuration: {
     type: NumberConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   loop: {
     type: BooleanConstructor;
     default: undefined;
   };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   translations: {
     type: PropType<Partial<NavigationMenuTranslations>>;
-    default: undefined;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").NavigationMenuValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string | null) => any) | undefined;
 }>, {
-  value: string | null;
-  collection: NavigationMenuNode[];
-  defaultValue: string | null;
-  orientation: Orientation;
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  translations: Partial<NavigationMenuTranslations>;
   loop: boolean;
-  delayDuration: number;
-  skipDelayDuration: number;
+  disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhNavigationMenuList: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -146,6 +125,30 @@ declare const XhNavigationMenuTrigger: import("vue").DefineComponent<import("vue
 }>> & Readonly<{}>, {
   disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 入口中表示下方还有面板的标记，展开时转向；身份与所在 trigger 同一份声明 */
+declare const XhNavigationMenuTriggerIndicator: 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 XhNavigationMenuContent: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
     type: StringConstructor;
@@ -169,7 +172,7 @@ declare const XhNavigationMenuLink: import("vue").DefineComponent<import("vue").
 }>> & Readonly<{}>, {
   current: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-/** 指示条容器，位置由机器算好写入内联样式；渲染为 li 以 list 为定位参照系 */
+/** 指示条容器，位置由状态机计算后写入内联样式；渲染为 li 以 list 为定位参照系 */
 declare const XhNavigationMenuIndicator: 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>;
@@ -178,5 +181,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, XhNavigationMenuViewport };
+export { XhNavigationMenuContent, XhNavigationMenuIndicator, XhNavigationMenuItem, XhNavigationMenuLink, XhNavigationMenuList, XhNavigationMenuRoot, XhNavigationMenuTrigger, XhNavigationMenuTriggerIndicator, XhNavigationMenuViewport };
 //# sourceMappingURL=navigation-menu.d.ts.map