@xihan-ui/vue 4.1.0 → 5.0.0

package/dist/components/radio-group/radio-group.js

@@ -1,12 +1,16 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideRadioGroup, provideRadioGroupItem, useRadioGroupContext, useRadioGroupItemContext } from "./context.js";
 import { useRadioGroup } from "./use-radio-group.js";
-import { computed, defineComponent, h, onBeforeUnmount, onMounted, ref, watch } from "vue";
+import { radioGroupStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, onBeforeUnmount, onUnmounted, ref, watch } from "vue";
 //#region src/components/radio-group/radio-group.ts
 const XhRadioGroupRoot = defineComponent({
 	name: "XhRadioGroupRoot",
 	props: {
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		collection: { type: Array },
 		/** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */
 		label: { type: String },
@@ -64,7 +68,10 @@ const XhRadioGroupRoot = defineComponent({
 					...ctx.api.value.getRootProps()
 				}),
 				ref: ctx.rootRef
-			}, slots.default ? [...renderLabel(title), ...slots.default()] : props.collection ? renderDefaultTree(ctx.api.value.collection, ctx.api.value.variant === "segmented", title, slots.item) : renderLabel(title));
+			}, slots.default ? [...renderLabel(title), ...slots.default()] : renderDefaultStructure(ctx.api.value, props.label, {
+				label: slots.label,
+				item: slots.item
+			}));
 		};
 	}
 });
@@ -72,10 +79,8 @@ const XhRadioGroupLabel = defineComponent({
 	name: "XhRadioGroupLabel",
 	setup(_, { slots }) {
 		const ctx = useRadioGroupContext();
-		onMounted(() => {
-			ctx.labelCount.value++;
-		});
-		onBeforeUnmount(() => {
+		ctx.labelCount.value++;
+		onUnmounted(() => {
 			ctx.labelCount.value--;
 		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
@@ -158,24 +163,41 @@ const XhRadioGroupItemDescription = defineComponent({
 		return () => h("span", ctx.api.value.getItemDescriptionProps(item.value), slots.default?.());
 	}
 });
+/** 标准结构里各部件对应的组件；条目里的表单影子与圆圈由 XhRadioGroupItem 自行装配，铺结构时去掉这两格。 */
+const RADIO_GROUP_PARTS = {
+	"label": XhRadioGroupLabel,
+	"thumb": XhRadioGroupThumb,
+	"item": XhRadioGroupItem,
+	"item-icon": XhRadioGroupItemIcon,
+	"item-text": XhRadioGroupItemText,
+	"item-description": XhRadioGroupItemDescription
+};
+const SELF_ASSEMBLED = /* @__PURE__ */ new Set(["hidden-input", "indicator"]);
+function withoutSelfAssembled(nodes) {
+	return nodes.flatMap((node) => {
+		if (!("part" in node)) return [node];
+		if (SELF_ASSEMBLED.has(node.part)) return [];
+		return [node.children ? {
+			...node,
+			children: withoutSelfAssembled(node.children)
+		} : node];
+	});
+}
 /**
-* 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。
-* 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。
-* segmented 形态的滑块排在条目之前：它绝对定位，依靠文档序让后面的条目覆盖在它上面，文字才不会被遮住。
+* 未写默认插槽时铺开的整套结构：照 headless 的 radioGroupStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题与条目文字由对应插槽接管。
 */
-function renderDefaultTree(collection, segmented, label, itemSlot) {
-	return [
-		...renderLabel(label),
-		...segmented ? [h(XhRadioGroupThumb)] : [],
-		...collection.map((node) => h(XhRadioGroupItem, {
-			key: node.value,
-			value: node.value
-		}, () => [
-			...node.icon != null ? [h(XhRadioGroupItemIcon, null, () => node.icon)] : [],
-			h(XhRadioGroupItemText, null, () => itemSlot?.(node) ?? node.label),
-			...node.description != null ? [h(XhRadioGroupItemDescription, null, () => node.description)] : []
-		]))
-	];
+function renderDefaultStructure(api, label, content) {
+	return renderStructure(withoutSelfAssembled(radioGroupStructure(api, {
+		label,
+		slotted: (name) => content[name] != null
+	})), RADIO_GROUP_PARTS, (node) => {
+		switch (node.slot?.name) {
+			case "label": return content.label?.();
+			case "item": return content.item?.(node.data) ?? node.data.label;
+			default: return;
+		}
+	});
 }
 /** 组标题：给了文字或 label 插槽才铺 label 部件。 */
 function renderLabel(title) {

package/dist/components/radio-group/radio-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.js","names":[],"sources":["../../../src/components/radio-group/radio-group.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// 提供 radio group 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { RadioGroupItemProps, RadioGroupNode, RadioGroupNodeMeta, RadioGroupSchema, RadioGroupVariant } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, onMounted, ref, watch } from 'vue'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideRadioGroup, provideRadioGroupItem, useRadioGroupContext, useRadioGroupItemContext } from './context'\nimport { useRadioGroup } from './use-radio-group'\n\ntype RadioGroupProps = RadioGroupSchema['props']\n\nexport const XhRadioGroupRoot = defineComponent({\n  name: 'XhRadioGroupRoot',\n  props: {\n    collection: { type: Array as PropType<RadioGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    name: { type: String },\n    loop: { type: Boolean, default: undefined },\n    block: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<RadioGroupVariant> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<RadioGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<RadioGroupProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: RadioGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useRadioGroup(useFormControlProps(props) as RadioGroupProps, notify)\n    provideRadioGroup(ctx)\n    // 放进表单字段时，字段的标题与说明接到组上：读屏进组时念组名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => {\n      // 标题文字不论手写选项还是数据驱动都由根铺出：手写选项时不必再写 label 部件\n      const title = slots.label?.() ?? (props.label != null ? [props.label] : null)\n      return h(\n        'div',\n        { ...fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }), ref: ctx.rootRef },\n        slots.default\n          ? [...renderLabel(title), ...slots.default()]\n          : props.collection\n            ? renderDefaultTree(\n                ctx.api.value.collection,\n                ctx.api.value.variant === 'segmented',\n                title,\n                slots.item,\n              )\n            : renderLabel(title),\n      )\n    }\n  },\n})\n\nexport const XhRadioGroupLabel = defineComponent({\n  name: 'XhRadioGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    // 渲出来了才登记：根的 aria-labelledby 只在这个节点真在场时才指过来\n    onMounted(() => {\n      ctx.labelCount.value++\n    })\n    onBeforeUnmount(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** segmented 形态里滑动的选中标记，位置由状态机测量后写入内联样式的私有槽；没有落点时收起。须写在条目之前。 */\nexport const XhRadioGroupThumb = defineComponent({\n  name: 'XhRadioGroupThumb',\n  setup() {\n    const ctx = useRadioGroupContext()\n    return () => h('span', ctx.api.value.getThumbProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhRadioGroupItem = defineComponent({\n  name: 'XhRadioGroupItem',\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 = useRadioGroupContext()\n    const item = computed<RadioGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideRadioGroupItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'GROUP.BLUR' })\n    })\n    // 隐藏输入与 indicator 由条目自行装配，不暴露成独立组件\n    return () => h('div', { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl }, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\n/** 条目文字前的图标位：纯装饰，对读屏隐藏。 */\nexport const XhRadioGroupItemIcon = defineComponent({\n  name: 'XhRadioGroupItemIcon',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemIconProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRadioGroupItemText = defineComponent({\n  name: 'XhRadioGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRadioGroupItemDescription = defineComponent({\n  name: 'XhRadioGroupItemDescription',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * segmented 形态的滑块排在条目之前：它绝对定位，依靠文档序让后面的条目覆盖在它上面，文字才不会被遮住。\n */\nfunction renderDefaultTree(\n  collection: readonly RadioGroupNodeMeta[],\n  segmented: boolean,\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: RadioGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...renderLabel(label),\n    ...(segmented ? [h(XhRadioGroupThumb)] : []),\n    // 条目内的 hidden-input 与 indicator 由 XhRadioGroupItem 自行装配\n    ...collection.map(node => h(XhRadioGroupItem, { key: node.value, value: node.value }, () => [\n      ...(node.icon != null ? [h(XhRadioGroupItemIcon, null, () => node.icon)] : []),\n      h(XhRadioGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n      ...(node.description != null ? [h(XhRadioGroupItemDescription, null, () => node.description)] : []),\n    ])),\n  ]\n}\n\n/** 组标题：给了文字或 label 插槽才铺 label 部件。 */\nfunction renderLabel(title: (VNode | string)[] | null): VNode[] {\n  return title ? [h(XhRadioGroupLabel, null, () => title)] : []\n}\n"],"mappings":"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"}
+{"version":3,"file":"radio-group.js","names":[],"sources":["../../../src/components/radio-group/radio-group.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// 提供 radio group 相关实现。\n\nimport type { Direction, Orientation, Size, Tone } from '@xihan-ui/core'\nimport type { RadioGroupApi, RadioGroupItemProps, RadioGroupNode, RadioGroupNodeMeta, RadioGroupSchema, RadioGroupVariant, StructureChild } from '@xihan-ui/headless'\nimport type { PropType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { radioGroupStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onBeforeUnmount, onUnmounted, ref, watch } from 'vue'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideRadioGroup, provideRadioGroupItem, useRadioGroupContext, useRadioGroupItemContext } from './context'\nimport { useRadioGroup } from './use-radio-group'\n\ntype RadioGroupProps = RadioGroupSchema['props']\n\nexport const XhRadioGroupRoot = defineComponent({\n  name: 'XhRadioGroupRoot',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    collection: { type: Array as PropType<RadioGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    value: { type: String as PropType<string | null> },\n    defaultValue: { type: String as PropType<string | null> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    orientation: { type: String as PropType<Orientation> },\n    dir: { type: String as PropType<Direction> },\n    name: { type: String },\n    loop: { type: Boolean, default: undefined },\n    block: { type: Boolean, default: undefined },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<RadioGroupVariant> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<RadioGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<RadioGroupProps, 'onValueChange'>['value']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: RadioGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useRadioGroup(useFormControlProps(props) as RadioGroupProps, notify)\n    provideRadioGroup(ctx)\n    // 放进表单字段时，字段的标题与说明接到组上：读屏进组时念组名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => {\n      // 标题文字不论手写选项还是数据驱动都由根铺出：手写选项时不必再写 label 部件\n      const title = slots.label?.() ?? (props.label != null ? [props.label] : null)\n      return h(\n        'div',\n        { ...fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }), ref: ctx.rootRef },\n        slots.default\n          ? [...renderLabel(title), ...slots.default()]\n          : renderDefaultStructure(ctx.api.value, props.label, { label: slots.label, item: slots.item }),\n      )\n    }\n  },\n})\n\nexport const XhRadioGroupLabel = defineComponent({\n  name: 'XhRadioGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    // 渲出来就登记，在 setup 里同步做：排在条目之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** segmented 形态里滑动的选中标记，位置由状态机测量后写入内联样式的私有槽；没有落点时收起。须写在条目之前。 */\nexport const XhRadioGroupThumb = defineComponent({\n  name: 'XhRadioGroupThumb',\n  setup() {\n    const ctx = useRadioGroupContext()\n    return () => h('span', ctx.api.value.getThumbProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhRadioGroupItem = defineComponent({\n  name: 'XhRadioGroupItem',\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 = useRadioGroupContext()\n    const item = computed<RadioGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideRadioGroupItem({ item })\n    // 本条目持有焦点时，value 变更重报焦点条目，卸载时上报整组失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => props.value, (next, prev) => {\n      if (next === prev)\n        return\n      const svc = ctx.service\n      if (svc.getStatus() !== 'Started')\n        return\n      if (itemEl.value && svc.scope.getActiveElement() === itemEl.value)\n        svc.send({ type: 'ITEM.FOCUS', value: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按 value 比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'GROUP.BLUR' })\n    })\n    // 隐藏输入与 indicator 由条目自行装配，不暴露成独立组件\n    return () => h('div', { ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>, ref: itemEl }, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\n/** 条目文字前的图标位：纯装饰，对读屏隐藏。 */\nexport const XhRadioGroupItemIcon = defineComponent({\n  name: 'XhRadioGroupItemIcon',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemIconProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRadioGroupItemText = defineComponent({\n  name: 'XhRadioGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRadioGroupItemDescription = defineComponent({\n  name: 'XhRadioGroupItemDescription',\n  setup(_, { slots }) {\n    const ctx = useRadioGroupContext()\n    const { item } = useRadioGroupItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件；条目里的表单影子与圆圈由 XhRadioGroupItem 自行装配，铺结构时去掉这两格。 */\nconst RADIO_GROUP_PARTS = {\n  'label': XhRadioGroupLabel,\n  'thumb': XhRadioGroupThumb,\n  'item': XhRadioGroupItem,\n  'item-icon': XhRadioGroupItemIcon,\n  'item-text': XhRadioGroupItemText,\n  'item-description': XhRadioGroupItemDescription,\n}\n\nconst SELF_ASSEMBLED = new Set(['hidden-input', 'indicator'])\n\nfunction withoutSelfAssembled(nodes: readonly StructureChild[]): StructureChild[] {\n  return nodes.flatMap((node): StructureChild[] => {\n    if (!('part' in node))\n      return [node]\n    if (SELF_ASSEMBLED.has(node.part))\n      return []\n    return [node.children ? { ...node, children: withoutSelfAssembled(node.children) } : node]\n  })\n}\n\ninterface RadioGroupStructureSlots {\n  label?: () => VNode[]\n  item?: (node: RadioGroupNodeMeta) => VNode[]\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 radioGroupStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题与条目文字由对应插槽接管。\n */\nfunction renderDefaultStructure(api: RadioGroupApi, label: string | undefined, content: RadioGroupStructureSlots): VNode[] {\n  const nodes = radioGroupStructure(api, { label, slotted: name => content[name as keyof RadioGroupStructureSlots] != null })\n  return renderStructure(withoutSelfAssembled(nodes), RADIO_GROUP_PARTS, (node) => {\n    switch (node.slot?.name) {\n      case 'label':\n        return content.label?.()\n      case 'item':\n        return content.item?.(node.data as RadioGroupNodeMeta) ?? (node.data as RadioGroupNodeMeta).label\n      default:\n        return undefined\n    }\n  })\n}\n\n/** 组标题：给了文字或 label 插槽才铺 label 部件。 */\nfunction renderLabel(title: (VNode | string)[] | null): VNode[] {\n  return title ? [h(XhRadioGroupLabel, null, () => title)] : []\n}\n"],"mappings":"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"}

package/dist/components/radio-group/use-radio-group.d.ts

@@ -1,6 +1,6 @@
+import { RadioGroupApi, RadioGroupSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { RadioGroupApi, RadioGroupSchema } from "@xihan-ui/headless";
 //#region src/components/radio-group/use-radio-group.d.ts
 interface RadioGroupContext {
   api: ComputedRef<RadioGroupApi>;

package/dist/components/radio-group/use-radio-group.js

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectRadioGroup, radioGroupMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectRadioGroup, radioGroupMachine } from "@xihan-ui/headless";
 //#region src/components/radio-group/use-radio-group.ts
 function useRadioGroup(props, onValueChange) {
 	const scope = createScope(null, createVueIdGenerator());

package/dist/components/rating/rating.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { RatingApi, RatingItemState, RatingSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction, Size, Tone } from "@xihan-ui/core";
-import { RatingApi, RatingItemState, RatingSchema } from "@xihan-ui/headless";
 //#region src/components/rating/rating.d.ts
 type RatingProps = RatingSchema['props'];
 /** 默认插槽的载荷：评分与预览值、星星序号表，以及取单颗星状态与改写评分的句柄。 */
@@ -9,6 +9,14 @@ type RatingRootSlotProps = Pick<RatingApi, 'value' | 'hoveredValue' | 'highlight
 /** 条目默认插槽的载荷：该颗星的选中、点亮与半亮状态。 */
 type RatingItemSlotProps = RatingItemState;
 declare const XhRatingRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: NumberConstructor;
   };
@@ -35,6 +43,10 @@ declare const XhRatingRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
   };
@@ -57,6 +69,14 @@ declare const XhRatingRoot: import("vue").DefineComponent<import("vue").ExtractP
   'update:value': (_value: PayloadOf<RatingProps, "onValueChange">["value"]) => true;
   'hover-change': (_details: PayloadOf<RatingProps, "onHoverChange">) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   value: {
     type: NumberConstructor;
   };
@@ -83,6 +103,10 @@ declare const XhRatingRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: undefined;
   };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   name: {
     type: StringConstructor;
   };
@@ -104,12 +128,14 @@ declare const XhRatingRoot: import("vue").DefineComponent<import("vue").ExtractP
   "onHover-change"?: ((_details: import("@xihan-ui/headless").RatingHoverChangeDetails) => any) | undefined;
 }>, {
   required: boolean;
+  invalid: boolean;
   disabled: boolean;
   readOnly: boolean;
   allowHalf: boolean;
   allowClear: boolean;
 }, SlotsType<{
   default?: (props: RatingRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhRatingLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

package/dist/components/rating/rating.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rating.d.ts","names":[],"sources":["../../../src/components/rating/rating.ts"],"mappings":";;;;;KAkBK,cAAc;;KAGP,sBAAsB,KAChC;;KAYU,sBAAsB;cAErB,4BAAY,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaE,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;EAId,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACR,iBAAA,UAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATd,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;EAS/B,WAAC,OAAO,wBAAwB;kCAwB5C;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAS1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,8BAAA;;IAIc,MAAA;;;;;;;IAAA,MAAA;;;;EAGzB,WAAC,OAAO,wBAAwB;kCA+B5C;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"rating.d.ts","names":[],"sources":["../../../src/components/rating/rating.ts"],"mappings":";;;;;KAoBK,cAAc;;KAGP,sBAAsB,KAChC;;KAYU,sBAAsB;cAErB,4BAAY,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkBE,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;EAId,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;EACR,iBAAA,UAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATd,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,wBAAwB;EAClC,cAAM;kCA6BhB;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAWxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAS1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,4BAAY,8BAAA;;IAIc,MAAA;;;;;;;IAAA,MAAA;;;;EAGzB,WAAC,OAAO,wBAAwB;kCAwC5C;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/rating/rating.js

@@ -1,13 +1,19 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideRating, useRatingContext } from "./context.js";
 import { useRating } from "./use-rating.js";
-import { computed, defineComponent, h, onBeforeUnmount, ref, watch } from "vue";
+import { hasNamingContent, ratingStructure } from "@xihan-ui/headless";
+import { computed, defineComponent, h, onBeforeUnmount, onMounted, onUnmounted, onUpdated, ref, watch } from "vue";
 //#region src/components/rating/rating.ts
 const XhRatingRoot = defineComponent({
 	name: "XhRatingRoot",
 	props: {
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		value: { type: Number },
 		defaultValue: { type: Number },
 		count: { type: Number },
@@ -28,6 +34,10 @@ const XhRatingRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		invalid: {
+			type: Boolean,
+			default: void 0
+		},
 		name: { type: String },
 		dir: { type: String },
 		tone: { type: String },
@@ -53,22 +63,29 @@ const XhRatingRoot = defineComponent({
 			onHoverChange
 		});
 		provideRating(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
-			value: ctx.api.value.value,
-			hoveredValue: ctx.api.value.hoveredValue,
-			highlightedValue: ctx.api.value.highlightedValue,
-			count: ctx.api.value.count,
-			empty: ctx.api.value.empty,
-			items: ctx.api.value.items,
-			getItemState: ctx.api.value.getItemState,
-			setValue: ctx.api.value.setValue
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				value: api.value,
+				hoveredValue: api.hoveredValue,
+				highlightedValue: api.highlightedValue,
+				count: api.count,
+				empty: api.empty,
+				items: api.items,
+				getItemState: api.getItemState,
+				setValue: api.setValue
+			}) : renderDefaultStructure(api, props.label, props.name !== void 0, slots.label));
+		};
 	}
 });
 const XhRatingLabel = defineComponent({
 	name: "XhRatingLabel",
 	setup(_, { slots }) {
 		const ctx = useRatingContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -116,8 +133,17 @@ const XhRatingItem = defineComponent({
 			if (service.getStatus() !== "Started") return;
 			if (itemEl.value && service.scope.getActiveElement() === itemEl.value) service.send({ type: "CONTROL.BLUR" });
 		});
+		const authored = ref(false);
+		const readAuthored = () => {
+			if (itemEl.value) authored.value = hasNamingContent(itemEl.value);
+		};
+		onMounted(readAuthored);
+		onUpdated(readAuthored);
 		return () => h("span", {
-			...ctx.api.value.getItemProps(item.value),
+			...ctx.api.value.getItemProps({
+				...item.value,
+				authored: authored.value
+			}),
 			ref: itemEl
 		}, slots.default?.(ctx.api.value.getItemState(item.value)));
 	}
@@ -129,6 +155,24 @@ const XhRatingHiddenInput = defineComponent({
 		return () => h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const RATING_PARTS = {
+	"label": XhRatingLabel,
+	"control": XhRatingControl,
+	"item": XhRatingItem,
+	"hidden-input": XhRatingHiddenInput
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 ratingStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, hiddenInput, labelSlot) {
+	return renderStructure(ratingStructure(api, {
+		label,
+		hiddenInput,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), RATING_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhRatingControl, XhRatingHiddenInput, XhRatingItem, XhRatingLabel, XhRatingRoot, XhRatingValueText };
 

package/dist/components/rating/rating.js.map

@@ -1 +1 @@
-{"version":3,"file":"rating.js","names":[],"sources":["../../../src/components/rating/rating.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// 提供 rating 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type { RatingApi, RatingItemState, RatingSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideRating, useRatingContext } from './context'\nimport { useRating } from './use-rating'\n\ntype RatingProps = RatingSchema['props']\n\n/** 默认插槽的载荷：评分与预览值、星星序号表，以及取单颗星状态与改写评分的句柄。 */\nexport type RatingRootSlotProps = Pick<\n  RatingApi,\n  | 'value'\n  | 'hoveredValue'\n  | 'highlightedValue'\n  | 'count'\n  | 'empty'\n  | 'items'\n  | 'getItemState'\n  | 'setValue'\n>\n\n/** 条目默认插槽的载荷：该颗星的选中、点亮与半亮状态。 */\nexport type RatingItemSlotProps = RatingItemState\n\nexport const XhRatingRoot = defineComponent({\n  name: 'XhRatingRoot',\n  props: {\n    // 缺席值 undefined 表示非受控\n    value: { type: Number },\n    defaultValue: { type: Number },\n    count: { type: Number },\n    allowHalf: Boolean,\n    allowClear: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    dir: { type: String as PropType<Direction> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<RatingProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值；hover-change 是预览通道\n  emits: {\n    'value-change': (_details: PayloadOf<RatingProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<RatingProps, 'onValueChange'>['value']) => true,\n    'hover-change': (_details: PayloadOf<RatingProps, 'onHoverChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: RatingRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: RatingProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onHoverChange: RatingProps['onHoverChange'] = (details) => {\n      emit('hover-change', details)\n    }\n    const ctx = useRating(withXhConfig('rating', useFormControlProps(props)) as RatingProps, { onValueChange, onHoverChange })\n    provideRating(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      hoveredValue: ctx.api.value.hoveredValue,\n      highlightedValue: ctx.api.value.highlightedValue,\n      count: ctx.api.value.count,\n      empty: ctx.api.value.empty,\n      // 条目序号列表，供 v-for 渲染星星\n      items: ctx.api.value.items,\n      getItemState: ctx.api.value.getItemState,\n      setValue: ctx.api.value.setValue,\n    }))\n  },\n})\n\nexport const XhRatingLabel = defineComponent({\n  name: 'XhRatingLabel',\n  setup(_, { slots }) {\n    const ctx = useRatingContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRatingControl = defineComponent({\n  name: 'XhRatingControl',\n  setup(_, { slots }) {\n    const ctx = useRatingContext()\n    // 放进表单字段时，字段的标题与说明接到星组上：读屏进组时念组名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getControlProps() as Record<string, unknown> }), slots.default?.())\n  },\n})\n\nexport const XhRatingValueText = defineComponent({\n  name: 'XhRatingValueText',\n  setup(_, { slots }) {\n    const ctx = useRatingContext()\n    // 分值文本：写在 root 里、control 的兄弟；没给内容就填当前该点亮到的那个数\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.valueText,\n    )\n  },\n})\n\nexport const XhRatingItem = defineComponent({\n  name: 'XhRatingItem',\n  props: {\n    // 星序号，兼收字符串；往下传前统一归成数字\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: RatingItemSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useRatingContext()\n    const item = computed(() => ({ value: Number(props.value) }))\n\n    // 本条目持有焦点时，序号变更重报焦点条目，卸载时上报评分带失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => item.value.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', index: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按序号比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'CONTROL.BLUR' })\n    })\n\n    return () => h('span', {\n      ...ctx.api.value.getItemProps(item.value) as Record<string, unknown>,\n      ref: itemEl,\n    }, slots.default?.(ctx.api.value.getItemState(item.value)))\n  },\n})\n\nexport const XhRatingHiddenInput = defineComponent({\n  name: 'XhRatingHiddenInput',\n  setup() {\n    const ctx = useRatingContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"rating.js","names":[],"sources":["../../../src/components/rating/rating.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// 提供 rating 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type { RatingApi, RatingItemState, RatingSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { hasNamingContent, ratingStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onBeforeUnmount, onMounted, onUnmounted, onUpdated, ref, watch } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideRating, useRatingContext } from './context'\nimport { useRating } from './use-rating'\n\ntype RatingProps = RatingSchema['props']\n\n/** 默认插槽的载荷：评分与预览值、星星序号表，以及取单颗星状态与改写评分的句柄。 */\nexport type RatingRootSlotProps = Pick<\n  RatingApi,\n  | 'value'\n  | 'hoveredValue'\n  | 'highlightedValue'\n  | 'count'\n  | 'empty'\n  | 'items'\n  | 'getItemState'\n  | 'setValue'\n>\n\n/** 条目默认插槽的载荷：该颗星的选中、点亮与半亮状态。 */\nexport type RatingItemSlotProps = RatingItemState\n\nexport const XhRatingRoot = defineComponent({\n  name: 'XhRatingRoot',\n  props: {\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Number },\n    defaultValue: { type: Number },\n    count: { type: Number },\n    allowHalf: Boolean,\n    allowClear: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    dir: { type: String as PropType<Direction> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<RatingProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸值；hover-change 是预览通道\n  emits: {\n    'value-change': (_details: PayloadOf<RatingProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<RatingProps, 'onValueChange'>['value']) => true,\n    'hover-change': (_details: PayloadOf<RatingProps, 'onHoverChange'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: RatingRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const onValueChange: RatingProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const onHoverChange: RatingProps['onHoverChange'] = (details) => {\n      emit('hover-change', details)\n    }\n    const ctx = useRating(withXhConfig('rating', useFormControlProps(props)) as RatingProps, { onValueChange, onHoverChange })\n    provideRating(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getRootProps() as Record<string, unknown>, slots.default\n        ? slots.default({\n            value: api.value,\n            hoveredValue: api.hoveredValue,\n            highlightedValue: api.highlightedValue,\n            count: api.count,\n            empty: api.empty,\n            // 条目序号列表，供 v-for 渲染星星\n            items: api.items,\n            getItemState: api.getItemState,\n            setValue: api.setValue,\n          })\n        : renderDefaultStructure(api, props.label, props.name !== undefined, slots.label))\n    }\n  },\n})\n\nexport const XhRatingLabel = defineComponent({\n  name: 'XhRatingLabel',\n  setup(_, { slots }) {\n    const ctx = useRatingContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhRatingControl = defineComponent({\n  name: 'XhRatingControl',\n  setup(_, { slots }) {\n    const ctx = useRatingContext()\n    // 放进表单字段时，字段的标题与说明接到星组上：读屏进组时念组名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getControlProps() as Record<string, unknown> }), slots.default?.())\n  },\n})\n\nexport const XhRatingValueText = defineComponent({\n  name: 'XhRatingValueText',\n  setup(_, { slots }) {\n    const ctx = useRatingContext()\n    // 分值文本：写在 root 里、control 的兄弟；没给内容就填当前该点亮到的那个数\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.valueText,\n    )\n  },\n})\n\nexport const XhRatingItem = defineComponent({\n  name: 'XhRatingItem',\n  props: {\n    // 星序号，兼收字符串；往下传前统一归成数字\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: RatingItemSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useRatingContext()\n    const item = computed(() => ({ value: Number(props.value) }))\n\n    // 本条目持有焦点时，序号变更重报焦点条目，卸载时上报评分带失焦\n    const itemEl = ref<HTMLElement | null>(null)\n    watch(() => item.value.value, (next, prev) => {\n      if (next === prev)\n        return\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'ITEM.FOCUS', index: next })\n    })\n    onBeforeUnmount(() => {\n      const { service } = ctx\n      if (service.getStatus() !== 'Started')\n        return\n      // 按「本节点当下正持有焦点」判定，不按序号比对\n      if (itemEl.value && service.scope.getActiveElement() === itemEl.value)\n        service.send({ type: 'CONTROL.BLUR' })\n    })\n\n    // 作者在星里放了自己的内容（文字或带名字的节点）就以内容为名，connect 不写缺省名；按渲染出的节点判断\n    const authored = ref(false)\n    const readAuthored = (): void => {\n      if (itemEl.value)\n        authored.value = hasNamingContent(itemEl.value)\n    }\n    onMounted(readAuthored)\n    onUpdated(readAuthored)\n\n    return () => h('span', {\n      ...ctx.api.value.getItemProps({ ...item.value, authored: authored.value }) as Record<string, unknown>,\n      ref: itemEl,\n    }, slots.default?.(ctx.api.value.getItemState(item.value)))\n  },\n})\n\nexport const XhRatingHiddenInput = defineComponent({\n  name: 'XhRatingHiddenInput',\n  setup() {\n    const ctx = useRatingContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件。 */\nconst RATING_PARTS = {\n  'label': XhRatingLabel,\n  'control': XhRatingControl,\n  'item': XhRatingItem,\n  'hidden-input': XhRatingHiddenInput,\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 ratingStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: RatingApi, label: string | undefined, hiddenInput: boolean, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = ratingStructure(api, { label, hiddenInput, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(nodes, RATING_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

package/dist/components/rating/use-rating.d.ts

@@ -1,8 +1,13 @@
-import { ComputedRef } from "vue";
-import { Service } from "@xihan-ui/core";
 import { RatingApi, RatingSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
+import { Service } from "@xihan-ui/core";
 //#region src/components/rating/use-rating.d.ts
 interface RatingContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhRatingLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<RatingApi>;
   /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */
   service: Service<RatingSchema>;

package/dist/components/rating/use-rating.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-rating.d.ts","names":[],"sources":["../../../src/components/rating/use-rating.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,UACd,OAAO,uBACP,YAAW,KAAK,4DACf"}
+{"version":3,"file":"use-rating.d.ts","names":[],"sources":["../../../src/components/rating/use-rating.ts"],"mappings":";;;;UAiBiB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;EAEjB,SAAS,QAAQ;;iBAGH,UACd,OAAO,uBACP,YAAW,KAAK,4DACf"}

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

@@ -1,16 +1,20 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
-import { computed } from "vue";
-import { createScope } from "@xihan-ui/core";
 import { connectRating, ratingMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
+import { createScope } from "@xihan-ui/core";
 //#region src/components/rating/use-rating.ts
 function useRating(props, callbacks = {}) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(ratingMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...callbacks
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	return {
+		labelCount,
 		api: computed(() => connectRating(service, vueNormalize)),
 		service
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"use-rating.js","names":[],"sources":["../../../src/components/rating/use-rating.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 rating 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { RatingApi, RatingSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectRating, ratingMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface RatingContext {\n  api: ComputedRef<RatingApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<RatingSchema>\n}\n\nexport function useRating(\n  props: RatingSchema['props'],\n  callbacks: Pick<RatingSchema['props'], 'onValueChange' | 'onHoverChange'> = {},\n): RatingContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(ratingMachine, () => ({ ...props, ...callbacks }), scope)\n  const api = computed(() => connectRating(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAuBA,SAAgB,UACd,OACA,YAA4E,CAAC,GAC9D;CAGf,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO,GAAG;CAAU,IAD5D,YAAY,MADZ,qBACsB,CAC8C,CAAC;CAEnF,OAAO;EAAE,KADG,eAAe,cAAc,SAAS,YAAY,CACnD;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-rating.js","names":[],"sources":["../../../src/components/rating/use-rating.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 rating 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { RatingApi, RatingSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { connectRating, ratingMachine } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface RatingContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhRatingLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<RatingApi>\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<RatingSchema>\n}\n\nexport function useRating(\n  props: RatingSchema['props'],\n  callbacks: Pick<RatingSchema['props'], 'onValueChange' | 'onHoverChange'> = {},\n): RatingContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const labelCount = ref(0)\n  const service = useMachine(ratingMachine, () => ({ ...props, labelled: labelCount.value > 0, ...callbacks }), scope)\n  const api = computed(() => connectRating(service, vueNormalize))\n  return { labelCount, api, service }\n}\n"],"mappings":";;;;;;;AA4BA,SAAgB,UACd,OACA,YAA4E,CAAC,GAC9D;CAEf,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CACrC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAU,IAAI,KAAK;CAEnH,OAAO;EAAE;EAAY,KADT,eAAe,cAAc,SAAS,YAAY,CACvC;EAAG;CAAQ;AACpC"}

package/dist/components/reasoning/reasoning.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { ReasoningApi, ReasoningTranslations, ToolCallSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { ReasoningApi, ReasoningTranslations, ToolCallSchema } from "@xihan-ui/headless";
 //#region src/components/reasoning/reasoning.d.ts
 type MachineProps = ToolCallSchema['props'];
 /** 默认插槽的载荷：开合、是否仍在思考、思考时长，以及当前应显示的状态文案。 */
@@ -84,8 +84,8 @@ declare const XhReasoningRoot: import("vue").DefineComponent<import("vue").Extra
   disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
-  streaming: boolean;
   autoDisclosure: boolean;
+  streaming: boolean;
 }, SlotsType<{
   default?: (props: ReasoningRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/reasoning/use-reasoning.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef, Ref } from "vue";
 import { ReasoningApi, ReasoningProps, ToolCallSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/reasoning/use-reasoning.d.ts
 type MachineProps = ToolCallSchema['props'];
 interface ReasoningContext {

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

@@ -2,9 +2,9 @@ import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectReasoning, toolCallMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectReasoning, toolCallMachine } from "@xihan-ui/headless";
 //#region src/components/reasoning/use-reasoning.ts
 function useReasoning(machineProps, viewProps) {
 	const idGen = createVueIdGenerator();

package/dist/components/resizable/resizable.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { ResizableDimensions, ResizableOffset, ResizableSchema, ResizableTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { Direction } from "@xihan-ui/core";
-import { ResizableDimensions, ResizableOffset, ResizableSchema, ResizableTranslations } from "@xihan-ui/headless";
 import { ResizeEdge } from "@xihan-ui/pointer";
 //#region src/components/resizable/resizable.d.ts
 type ResizableProps = ResizableSchema['props'];

package/dist/components/resizable/use-resizable.d.ts

@@ -1,6 +1,6 @@
+import { ResizableApi, ResizableSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { ResizableApi, ResizableSchema } from "@xihan-ui/headless";
 //#region src/components/resizable/use-resizable.d.ts
 interface ResizableContext {
   api: ComputedRef<ResizableApi>;

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

@@ -1,9 +1,9 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { connectResizable, resizableMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectResizable, resizableMachine } from "@xihan-ui/headless";
 //#region src/components/resizable/use-resizable.ts
 function useResizable(props, onDimensionsChange, onDimensionsChangeEnd) {
 	const rootRef = ref(null);

package/dist/components/sankey-chart/sankey-chart.d.ts

@@ -1,6 +1,6 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { ChartDatumDetails, ChartKey, NumberFormatSpec, SankeyChartApi, SankeyChartSchema, SankeyChartTranslations, SankeyLinkColor, SankeyLinkDatum, SankeyNodeAlign, SankeyNodeDatum, SankeyNodeSort, SankeyOrientation, SankeyTooltipModel } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/sankey-chart/sankey-chart.d.ts
 type SankeyChartProps = SankeyChartSchema['props'];
 /** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */
@@ -137,15 +137,15 @@ declare const XhSankeyChartRoot: import("vue").DefineComponent<import("vue").Ext
     type: PropType<Partial<SankeyChartTranslations>>;
   };
 }>> & Readonly<{
-  "onHidden-series-change"?: ((_details: import("@xihan-ui/headless").ChartHiddenSeriesChangeDetails) => any) | undefined;
-  "onUpdate:hiddenSeries"?: ((_hidden: string[]) => any) | undefined;
-  "onActive-key-change"?: ((_details: import("@xihan-ui/headless").ChartActiveKeyChangeDetails) => any) | undefined;
-  "onUpdate:activeKey"?: ((_key: ChartKey | null) => any) | undefined;
   "onDatum-active"?: ((_details: ChartDatumDetails | null) => any) | undefined;
   "onDatum-press"?: ((_details: ChartDatumDetails) => any) | undefined;
+  "onActive-key-change"?: ((_details: import("@xihan-ui/headless").ChartActiveKeyChangeDetails) => any) | undefined;
+  "onUpdate:activeKey"?: ((_key: ChartKey | null) => any) | undefined;
+  "onHidden-series-change"?: ((_details: import("@xihan-ui/headless").ChartHiddenSeriesChangeDetails) => any) | undefined;
+  "onUpdate:hiddenSeries"?: ((_hidden: string[]) => any) | undefined;
 }>, {
-  pending: boolean;
   animated: boolean;
+  pending: boolean;
 }, SlotsType<{
   /** 自行摆放部件；不写时铺开缺省结构：图例、视口（绘图区与空态）、提示框。 */
   default?: (props: SankeyChartRootSlotProps) => VNode[];

package/dist/components/sankey-chart/use-sankey-chart.d.ts

@@ -1,6 +1,6 @@
+import { SankeyChartApi, SankeyChartSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { SankeyChartApi, SankeyChartSchema } from "@xihan-ui/headless";
 //#region src/components/sankey-chart/use-sankey-chart.d.ts
 /** 对外的回调：由外壳（emit）或组合式调用方提供，随 props 一并喂给机器。 */
 type SankeyChartNotifiers = Pick<SankeyChartSchema['props'], 'onHiddenSeriesChange' | 'onActiveKeyChange' | 'onDatumActive' | 'onDatumPress'>;

package/dist/components/sankey-chart/use-sankey-chart.js

@@ -1,7 +1,7 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed, ref } from "vue";
 import { connectSankeyChart, sankeyChartMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/sankey-chart/use-sankey-chart.ts
 /** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */
 function useSankeyChart(props, notify) {