@xihan-ui/vue 4.2.0 → 5.0.0

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

@@ -3,9 +3,10 @@ import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useXhConfig } from "../../config/config.js";
 import { useMachine } from "../../runtime/use-machine.js";
 import { createVueIdGenerator } from "../../runtime/vue-id.js";
+import { useTitleDescriptionPresence } from "../../runtime/title-description.js";
+import { connectPopover, popoverMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { connectPopover, popoverMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/popover/use-popover.ts
 function usePopover(props, onOpenChange) {
@@ -15,8 +16,10 @@ function usePopover(props, onOpenChange) {
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
+	const presence = useTitleDescriptionPresence();
 	const service = useMachine(popoverMachine, () => ({
 		...props,
+		parts: presence.parts.value,
 		onOpenChange
 	}), scope);
 	let config = null;
@@ -28,7 +31,11 @@ function usePopover(props, onOpenChange) {
 		const registerLayer = () => config.layerRegistry.register({
 			kind: "popover",
 			node: () => contentRef.value,
-			branches: () => [triggerRef.value, positionerRef.value].filter(Boolean),
+			branches: () => [
+				triggerRef.value,
+				props.anchor,
+				positionerRef.value
+			].filter(Boolean),
 			isModal: () => props.modal ?? false,
 			surfaces: () => []
 		});
@@ -52,7 +59,9 @@ function usePopover(props, onOpenChange) {
 		triggerRef,
 		positionerRef,
 		contentRef,
-		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body"),
+		portalSource: computed(() => props.anchor !== void 0 ? void 0 : triggerRef),
+		presence
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-popover.js","names":[],"sources":["../../../src/components/popover/use-popover.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 popover 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PopoverApi, PopoverSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectPopover, popoverMachine } from '@xihan-ui/headless'\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 { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface PopoverContext {\n  service: Service<PopoverSchema>\n  api: ComputedRef<PopoverApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function usePopover(\n  props: PopoverSchema['props'],\n  onOpenChange?: PopoverSchema['props']['onOpenChange'],\n): PopoverContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = 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(popoverMachine, () => ({ ...props, onOpenChange }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\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: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => props.modal ?? false,\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', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectPopover(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAgCA,SAAgB,WACd,OACA,cACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO;CAAa,IAAI,KAAK;CAGpF,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,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe,MAAM,SAAS;GAC9B,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,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAWhE,OAAO;EAAE,SATO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAIe;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY,cAFlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEvC;CAAE;AACtF"}
+{"version":3,"file":"use-popover.js","names":[],"sources":["../../../src/components/popover/use-popover.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 popover 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { PopoverApi, PopoverSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport type { TitleDescriptionPresence } from '../../runtime/title-description'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { connectPopover, popoverMachine } from '@xihan-ui/headless'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useTitleDescriptionPresence } from '../../runtime/title-description'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface PopoverContext {\n  service: Service<PopoverSchema>\n  api: ComputedRef<PopoverApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的容器 > 运行时的浮层落点 > body。 */\n  portalTarget: ComputedRef<string | Element>\n  /**\n   * 落点的视觉环境从哪取：缺省取 trigger；写了 anchor（哪怕暂时是 null）时为空，由 Portal 在 positioner 原位放来源标记。\n   */\n  portalSource: ComputedRef<Ref<HTMLElement | null> | undefined>\n  /** 标题与说明在不在场，由 XhPopoverTitle / XhPopoverDescription 登记；content 只引用在场的部件。 */\n  presence: TitleDescriptionPresence\n}\n\nexport function usePopover(\n  props: PopoverSchema['props'],\n  onOpenChange?: PopoverSchema['props']['onOpenChange'],\n): PopoverContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const presence = useTitleDescriptionPresence()\n  const service = useMachine(popoverMachine, () => ({ ...props, parts: presence.parts.value, onOpenChange }), scope)\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\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: () => [triggerRef.value, props.anchor, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => props.modal ?? false,\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', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectPopover(service, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({\n    config,\n    isOpen: () => api.value.open,\n    contentRef,\n    onPresence: presence => service.refs.set('presence', presence),\n  })\n  // 全局配置写了容器就用它，否则落到运行时那个单一浮层落点；没有 DOM 时才回到 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  const portalSource = computed(() => (props.anchor !== undefined ? undefined : triggerRef))\n\n  return { visible, service, api, triggerRef, positionerRef, contentRef, portalTarget, portalSource, presence }\n}\n"],"mappings":";;;;;;;;;;;AAwCA,SAAgB,WACd,OACA,cACgB;CAChB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAE/C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,WAAW,4BAA4B;CAC7C,MAAM,UAAU,WAAW,uBAAuB;EAAE,GAAG;EAAO,OAAO,SAAS,MAAM;EAAO;CAAa,IAAI,KAAK;CAGjH,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;IAAC,WAAW;IAAO,MAAM;IAAQ,cAAc;GAAK,CAAC,CAAC,OAAO,OAAO;GACpF,eAAe,MAAM,SAAS;GAC9B,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,qBAAqB,WAAW,KAAK;EACtD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,eAAe,SAAS,YAAY,CAAC;CAahE,OAAO;EAAE,SAXO,eAAe;GAC7B;GACA,cAAc,IAAI,MAAM;GACxB;GACA,aAAY,aAAY,QAAQ,KAAK,IAAI,YAAY,QAAQ;EAC/D,CAMe;EAAG;EAAS;EAAK;EAAY;EAAe;EAAY,cAJlD,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAIvC;EAAG,cAFhE,eAAgB,MAAM,WAAW,KAAA,IAAY,KAAA,IAAY,UAEkB;EAAG;CAAS;AAC9G"}

package/dist/components/progress/progress.d.ts

@@ -1,6 +1,6 @@
+import { ProgressGapPosition, ProgressIndicator, ProgressScaleOptions, ProgressSemantics, ProgressThreshold, ProgressTranslations, ProgressVariant } from "@xihan-ui/headless";
 import { PropType, VNode } from "vue";
 import { Size, Tone } from "@xihan-ui/core";
-import { ProgressGapPosition, ProgressIndicator, ProgressScaleOptions, ProgressSemantics, ProgressThreshold, ProgressTranslations, ProgressVariant } from "@xihan-ui/headless";
 //#region src/components/progress/progress.d.ts
 declare const XhProgress: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   value: {
@@ -124,9 +124,9 @@ declare const XhProgress: import("vue").DefineComponent<import("vue").ExtractPro
   };
 }>> & Readonly<{}>, {
   value: number;
+  scale: boolean | ProgressScaleOptions;
   max: number;
   indeterminate: boolean;
-  scale: boolean | ProgressScaleOptions;
   striped: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion

package/dist/components/progress/progress.js

@@ -1,8 +1,8 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
 import { slotPaints } from "../../runtime/slot-content.js";
-import { defineComponent, h } from "vue";
 import { connectProgress } from "@xihan-ui/headless";
+import { defineComponent, h } from "vue";
 //#region src/components/progress/progress.ts
 /** 刻度值的容器：没开刻度时不渲染。线形里连刻度线一起放，环形的刻度线画在 canvas 里。 */
 function renderScale(a, withTicks) {

package/dist/components/prompt-input/prompt-input.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { PromptInputApi, PromptInputSchema, PromptInputSubmitKey, PromptInputTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { PromptInputApi, PromptInputSchema, PromptInputSubmitKey, PromptInputTranslations } from "@xihan-ui/headless";
 //#region src/components/prompt-input/prompt-input.d.ts
 type Props = PromptInputSchema['props'];
 /** 默认插槽的载荷：草稿文本与四个状态，以及改写、提交、停止三个动作。 */

package/dist/components/prompt-input/use-prompt-input.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef } from "vue";
 import { PromptInputApi, PromptInputSchema } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/prompt-input/use-prompt-input.d.ts
 type Props = PromptInputSchema['props'];
 interface PromptInputCallbacks {

package/dist/components/prompt-input/use-prompt-input.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 { connectPromptInput, promptInputMachine } from "@xihan-ui/headless";
 import { computed } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectPromptInput, promptInputMachine } from "@xihan-ui/headless";
 //#region src/components/prompt-input/use-prompt-input.ts
 function usePromptInput(props, callbacks = {}) {
 	const service = useMachine(promptInputMachine, () => ({

package/dist/components/question-flow/question-flow.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { QuestionFlowAnswers, QuestionFlowApi, QuestionFlowNotes, QuestionFlowQuestion, QuestionFlowSchema, QuestionFlowStatus, QuestionFlowTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { QuestionFlowAnswers, QuestionFlowApi, QuestionFlowNotes, QuestionFlowQuestion, QuestionFlowSchema, QuestionFlowStatus, QuestionFlowTranslations } from "@xihan-ui/headless";
 //#region src/components/question-flow/question-flow.d.ts
 type Props = QuestionFlowSchema['props'];
 /** 默认插槽的载荷：进度、当前题，以及各条动作入口。 */

package/dist/components/question-flow/use-question-flow.d.ts

@@ -1,5 +1,5 @@
-import { ComputedRef, Ref } from "vue";
 import { QuestionFlowApi, QuestionFlowSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/question-flow/use-question-flow.d.ts
 type Props = QuestionFlowSchema['props'];
 interface QuestionFlowCallbacks {

package/dist/components/question-flow/use-question-flow.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 { connectQuestionFlow, questionFlowMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
-import { connectQuestionFlow, questionFlowMachine } from "@xihan-ui/headless";
 //#region src/components/question-flow/use-question-flow.ts
 function useQuestionFlow(props, callbacks = {}) {
 	const scope = createScope(null, createVueIdGenerator());

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

@@ -1,6 +1,6 @@
 import { PayloadOf } from "../../runtime/payload.js";
-import { PropType, SlotsType, VNode } from "vue";
 import { ChartDatumDetails, ChartKey, ChartRow, NumberFormatSpec, RadarChartApi, RadarChartSchema, RadarChartTranslations, RadarCurve, RadarIndicator, RadarScale, RadarShape, RadarTooltipModel } from "@xihan-ui/headless";
+import { PropType, SlotsType, VNode } from "vue";
 //#region src/components/radar-chart/radar-chart.d.ts
 type RadarChartProps = RadarChartSchema['props'];
 /** 默认插槽的载荷：自行摆放部件时用得上的状态与动作。 */
@@ -163,16 +163,16 @@ declare const XhRadarChartRoot: import("vue").DefineComponent<import("vue").Extr
     type: PropType<Partial<RadarChartTranslations>>;
   };
 }>> & 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;
 }>, {
   area: boolean;
-  pending: boolean;
   animated: boolean;
+  pending: boolean;
   ringLabels: boolean;
 }, SlotsType<{
   /** 自行摆放部件；不写时铺开缺省结构：图例、视口（绘图区与空态）、提示框。 */

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

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

package/dist/components/radar-chart/use-radar-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 { connectRadarChart, radarChartMachine } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/radar-chart/use-radar-chart.ts
 /** 量测、度量与文字度量器都在状态机的效应里做，DOM 取值口经 refs 交入。 */
 function useRadarChart(props, notify) {

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

@@ -1,10 +1,14 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { RadioGroupNode, RadioGroupSchema, RadioGroupVariant } from "@xihan-ui/headless";
 import { PropType, VNode } from "vue";
 import { Direction, Orientation, Size, Tone } from "@xihan-ui/core";
-import { RadioGroupNode, RadioGroupSchema, RadioGroupVariant } from "@xihan-ui/headless";
 //#region src/components/radio-group/radio-group.d.ts
 type RadioGroupProps = RadioGroupSchema['props'];
 declare const XhRadioGroupRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<RadioGroupNode[]>;
   };
@@ -66,6 +70,10 @@ declare const XhRadioGroupRoot: import("vue").DefineComponent<import("vue").Extr
   'value-change': (_details: PayloadOf<RadioGroupProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<RadioGroupProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   collection: {
     type: PropType<RadioGroupNode[]>;
   };

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

@@ -1 +1 @@
-{"version":3,"file":"radio-group.d.ts","names":[],"sources":["../../../src/components/radio-group/radio-group.ts"],"mappings":";;;;;KAiBK,kBAAkB;cAEV,gCAAgB,8BAAA;;IAGI,MAAA,SAAS;;;;;;;IAGb,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;EAIT,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IArBN,MAAA,SAAS;;;;;;;IAGb,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;qCAoCtC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAa5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC3B;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"radio-group.d.ts","names":[],"sources":["../../../src/components/radio-group/radio-group.ts"],"mappings":";;;;;KAmBK,kBAAkB;cAEV,gCAAgB,8BAAA;;;;;;IAKI,MAAA,SAAS;;;;;;;IAGb,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;EAIT,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;IArBN,MAAA,SAAS;;;;;;;IAGb,MAAA;;;IACO,MAAA;;;;;;;;;;;;;;;;;;;IAKD,MAAA,SAAS;;;IACjB,MAAA,SAAS;;;;;;;;;;;;;;IAIR,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;;;qCA6BtC;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAW5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAM5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAqC3B;;cAGW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAOtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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":";;;;;;AAmBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,YAAY,EAAE,MAAM,MAAoC;;EAExD,OAAO,EAAE,MAAM,OAAO;EACtB,OAAO,EAAE,MAAM,OAAkC;EACjD,cAAc,EAAE,MAAM,OAAkC;EACxD,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,aAAa,EAAE,MAAM,OAAgC;EACrD,KAAK,EAAE,MAAM,OAA8B;EAC3C,MAAM,EAAE,MAAM,OAAO;EACrB,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,OAAO;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC3C,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,SAAS,EAAE,MAAM,OAAsC;CACzD;CAEA,OAAO;EACL,iBAAiB,aAA0D;EAC3E,iBAAiB,WAAiE;CACpF;CACA,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA4C,YAAY;GAC5D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,MAAM,cAAc,oBAAoB,KAAK,GAAsB,MAAM;EAC/E,kBAAkB,GAAG;EAErB,MAAM,cAAc,oBAAoB;EACxC,MAAM,aAAa,oBAAoB;EACvC,aAAa;GAEX,MAAM,QAAQ,MAAM,QAAQ,MAAM,MAAM,SAAS,OAAO,CAAC,MAAM,KAAK,IAAI;GACxE,OAAO,EACL,OACA;IAAE,GAAG,WAAW,MAAM;KAAE,GAAG,YAAY;KAAO,GAAG,IAAI,IAAI,MAAM,aAAa;IAA6B,CAAC;IAAG,KAAK,IAAI;GAAQ,GAC9H,MAAM,UACF,CAAC,GAAG,YAAY,KAAK,GAAG,GAAG,MAAM,QAAQ,CAAC,IAC1C,MAAM,aACJ,kBACE,IAAI,IAAI,MAAM,YACd,IAAI,IAAI,MAAM,YAAY,aAC1B,OACA,MAAM,IACR,IACA,YAAY,KAAK,CACzB;EACF;CACF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,gBAAgB;GACd,IAAI,WAAW;EACjB,CAAC;EACD,sBAAsB;GACpB,IAAI,WAAW;EACjB,CAAC;EACD,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,cAAc,CAA4B;CACjF;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;EACL,OAAO;GAAE,MAAM;GAAQ,UAAU;EAAK;EAEtC,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAChD;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,qBAAqB;EACjC,MAAM,OAAO,gBAAqC;GAAE,OAAO,MAAM;GAAO,UAAU,MAAM;EAAS,EAAE;EACnG,sBAAsB,EAAE,KAAK,CAAC;EAE9B,MAAM,SAAS,IAAwB,IAAI;EAC3C,YAAY,MAAM,QAAQ,MAAM,SAAS;GACvC,IAAI,SAAS,MACX;GACF,MAAM,MAAM,IAAI;GAChB,IAAI,IAAI,UAAU,MAAM,WACtB;GACF,IAAI,OAAO,SAAS,IAAI,MAAM,iBAAiB,MAAM,OAAO,OAC1D,IAAI,KAAK;IAAE,MAAM;IAAc,OAAO;GAAK,CAAC;EAChD,CAAC;EACD,sBAAsB;GACpB,MAAM,EAAE,YAAY;GACpB,IAAI,QAAQ,UAAU,MAAM,WAC1B;GAEF,IAAI,OAAO,SAAS,QAAQ,MAAM,iBAAiB,MAAM,OAAO,OAC9D,QAAQ,KAAK,EAAE,MAAM,aAAa,CAAC;EACvC,CAAC;EAED,aAAa,EAAE,OAAO;GAAE,GAAG,IAAI,IAAI,MAAM,aAAa,KAAK,KAAK;GAA8B,KAAK;EAAO,GAAG;GAC3G,EAAE,SAAS,IAAI,IAAI,MAAM,oBAAoB,KAAK,KAAK,CAA4B;GACnF,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,KAAK,KAAK,CAA4B;GAChF,GAAI,MAAM,UAAU,KAAK,CAAC;EAC5B,CAAC;CACH;AACF,CAAC;;AAGD,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,SAAS,yBAAyB;EAC1C,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,SAAS,yBAAyB;EAC1C,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,iBAAiB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC;AAED,MAAa,8BAA8B,gBAAgB;CACzD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,MAAM,EAAE,SAAS,yBAAyB;EAC1C,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,wBAAwB,KAAK,KAAK,GAA8B,MAAM,UAAU,CAAC;CACxH;AACF,CAAC;;;;;;AAOD,SAAS,kBACP,YACA,WACA,OACA,UACS;CACT,OAAO;EACL,GAAG,YAAY,KAAK;EACpB,GAAI,YAAY,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC;EAE1C,GAAG,WAAW,KAAI,SAAQ,EAAE,kBAAkB;GAAE,KAAK,KAAK;GAAO,OAAO,KAAK;EAAM,SAAS;GAC1F,GAAI,KAAK,QAAQ,OAAO,CAAC,EAAE,sBAAsB,YAAY,KAAK,IAAI,CAAC,IAAI,CAAC;GAC5E,EAAE,sBAAsB,YAAY,WAAW,IAAI,KAAK,KAAK,KAAK;GAClE,GAAI,KAAK,eAAe,OAAO,CAAC,EAAE,6BAA6B,YAAY,KAAK,WAAW,CAAC,IAAI,CAAC;EACnG,CAAC,CAAC;CACJ;AACF;;AAGA,SAAS,YAAY,OAA2C;CAC9D,OAAO,QAAQ,CAAC,EAAE,mBAAmB,YAAY,KAAK,CAAC,IAAI,CAAC;AAC9D"}
+{"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"}