@xihan-ui/vue 2.1.0 → 3.1.0

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

@@ -7,6 +7,7 @@ interface CascaderContext {
   service: Service<CascaderSchema>;
   api: ComputedRef<CascaderApi>;
   triggerRef: Ref<HTMLElement | null>;
+  controlRef: Ref<HTMLElement | null>;
   positionerRef: Ref<HTMLElement | null>;
   contentRef: Ref<HTMLElement | null>;
   /** 当前是否应当渲染：退场动画播完之前仍为真。 */
@@ -14,7 +15,7 @@ interface CascaderContext {
   /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */
   portalTarget: ComputedRef<string | Element>;
 }
-declare function useCascader(props: CascaderSchema['props'], handlers?: Pick<CascaderSchema['props'], 'onValueChange' | 'onOpenChange'>): CascaderContext;
+declare function useCascader(props: CascaderSchema['props'], handlers?: Pick<CascaderSchema['props'], 'onValueChange' | 'onOpenChange' | 'onBranchLoadStart' | 'onBranchLoad' | 'onBranchLoadError'>): CascaderContext;
 //#endregion
 export { CascaderContext, useCascader };
 //# sourceMappingURL=use-cascader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-cascader.d.ts","names":[],"sources":["../../../src/components/cascader/use-cascader.ts"],"mappings":";;;;UAoBiB;;EAEf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,YACd,OAAO,yBACP,WAAU,KAAK,6DACd"}
+{"version":3,"file":"use-cascader.d.ts","names":[],"sources":["../../../src/components/cascader/use-cascader.ts"],"mappings":";;;;UAoBiB;;EAEf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,YAAY,IAAI;EAChB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,YACd,OAAO,yBACP,WAAU,KAAK,0HACd"}

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

@@ -11,6 +11,7 @@ import { createPositionEngine } from "@xihan-ui/position";
 function useCascader(props, handlers = {}) {
 	const xhConfig = useXhConfig();
 	const triggerRef = ref(null);
+	const controlRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
 	const idGen = createVueIdGenerator();
@@ -35,7 +36,8 @@ function useCascader(props, handlers = {}) {
 		service.refs.set("config", config);
 		service.refs.set("registerLayer", registerLayer);
 		service.refs.set("position", createPositionEngine());
-		service.refs.set("getAnchorEl", () => triggerRef.value);
+		service.refs.set("getAnchorEl", () => controlRef.value ?? triggerRef.value);
+		service.refs.set("getTriggerEl", () => triggerRef.value);
 		service.refs.set("getFloatingEl", () => positionerRef.value);
 		service.refs.set("getContentEl", () => contentRef.value);
 	}
@@ -50,6 +52,7 @@ function useCascader(props, handlers = {}) {
 		service,
 		api,
 		triggerRef,
+		controlRef,
 		positionerRef,
 		contentRef,
 		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")

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

@@ -1 +1 @@
-{"version":3,"file":"use-cascader.js","names":[],"sources":["../../../src/components/cascader/use-cascader.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 cascader 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { CascaderApi, CascaderSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { cascaderMachine, connectCascader } 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 CascaderContext {\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<CascaderSchema>\n  api: ComputedRef<CascaderApi>\n  triggerRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useCascader(\n  props: CascaderSchema['props'],\n  handlers: Pick<CascaderSchema['props'], 'onValueChange' | 'onOpenChange'> = {},\n): CascaderContext {\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(cascaderMachine, () => ({ ...props, ...handlers }), 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      // 浮层壳一并记上：content 之外还浮着自绘滚动条，按住它拖动不该把浮层消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点取 trigger\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(() => connectCascader(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  // 先问全局配置的落点，没有才落 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":";;;;;;;;;;AAiCA,SAAgB,YACd,OACA,WAA4E,CAAC,GAC5D;CACjB,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,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAS,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;GACf,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,gBAAgB,SAAS,YAAY,CAAC;CAWjE,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-cascader.js","names":[],"sources":["../../../src/components/cascader/use-cascader.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 cascader 相关实现。\n\nimport type { Cleanup, Layer, RuntimeConfig, Service } from '@xihan-ui/core'\nimport type { CascaderApi, CascaderSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/core'\nimport { cascaderMachine, connectCascader } 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 CascaderContext {\n  /** 状态机实例，供部件上报 DOM 侧的事实（如条目卸载带走了焦点）。 */\n  service: Service<CascaderSchema>\n  api: ComputedRef<CascaderApi>\n  triggerRef: Ref<HTMLElement | null>\n  controlRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 当前是否应当渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useCascader(\n  props: CascaderSchema['props'],\n  handlers: Pick<CascaderSchema['props'], 'onValueChange' | 'onOpenChange' | 'onBranchLoadStart' | 'onBranchLoad' | 'onBranchLoadError'> = {},\n): CascaderContext {\n  const xhConfig = useXhConfig()\n  const triggerRef = ref<HTMLElement | null>(null)\n  const controlRef = 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(cascaderMachine, () => ({ ...props, ...handlers }), 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      // 浮层壳一并记上：content 之外还浮着自绘滚动条，按住它拖动不该把浮层消解掉\n      branches: () => [triggerRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => 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    // 锚点是字段盒：面板起始缘与盒对齐；作者没写 control 时退回触发器\n    service.refs.set('getAnchorEl', () => controlRef.value ?? triggerRef.value)\n    service.refs.set('getTriggerEl', () => triggerRef.value)\n    service.refs.set('getFloatingEl', () => positionerRef.value)\n    service.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  const api = computed(() => connectCascader(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  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, service, api, triggerRef, controlRef, positionerRef, contentRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAkCA,SAAgB,YACd,OACA,WAAyI,CAAC,GACzH;CACjB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,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,wBAAwB;EAAE,GAAG;EAAO,GAAG;CAAS,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;GACf,gBAAgB,CAAC;EACnB,CAAC;EAGD,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,qBAAqB,CAAC;EAEnD,QAAQ,KAAK,IAAI,qBAAqB,WAAW,SAAS,WAAW,KAAK;EAC1E,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,uBAAuB,cAAc,KAAK;EAC3D,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACzD;CAEA,MAAM,MAAM,eAAe,gBAAgB,SAAS,YAAY,CAAC;CAWjE,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;EAAY;EAAe;EAAY,cAF9D,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAE3B;CAAE;AAClG"}

package/dist/components/checkbox/checkbox.js

@@ -1,6 +1,6 @@
+import { slotPaints } from "../../runtime/slot-content.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
-import { slotPaints } from "../../runtime/slot-content.js";
 import { useCheckbox } from "./use-checkbox.js";
 import { defineComponent, h, useId } from "vue";
 //#region src/components/checkbox/checkbox.ts

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

@@ -1,11 +1,11 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
 import { Orientation, Size, Tone } from "@xihan-ui/core";
-import { CheckboxGroupApi, CheckboxGroupNode, CheckboxGroupNodeMeta, CheckboxGroupSchema } from "@xihan-ui/headless";
+import { CheckboxGroupApi, CheckboxGroupNode, CheckboxGroupNodeMeta, CheckboxGroupSchema, CheckboxGroupVariant } from "@xihan-ui/headless";
 //#region src/components/checkbox-group/checkbox-group.d.ts
 type CheckboxGroupProps = CheckboxGroupSchema['props'];
 /** 默认插槽的载荷：整组的选中集合与全选态，以及整体替换与翻转单值的方法。 */
-type CheckboxGroupRootSlotProps = Pick<CheckboxGroupApi, 'value' | 'checkedState' | 'isChecked' | 'setValue' | 'toggleValue'>;
+type CheckboxGroupRootSlotProps = Pick<CheckboxGroupApi, 'value' | 'checkedState' | 'atMax' | 'atMin' | 'isChecked' | 'setValue' | 'toggleValue'>;
 declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   collection: {
     type: PropType<CheckboxGroupNode[]>;
@@ -23,6 +23,12 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
   itemValues: {
     type: PropType<string[]>;
   };
+  min: {
+    type: NumberConstructor;
+  };
+  max: {
+    type: NumberConstructor;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;
@@ -47,6 +53,9 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
   size: {
     type: PropType<Size>;
   };
+  variant: {
+    type: PropType<CheckboxGroupVariant>;
+  };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -69,6 +78,12 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
   itemValues: {
     type: PropType<string[]>;
   };
+  min: {
+    type: NumberConstructor;
+  };
+  max: {
+    type: NumberConstructor;
+  };
   disabled: {
     type: BooleanConstructor;
     default: undefined;
@@ -93,6 +108,9 @@ declare const XhCheckboxGroupRoot: import("vue").DefineComponent<import("vue").E
   size: {
     type: PropType<Size>;
   };
+  variant: {
+    type: PropType<CheckboxGroupVariant>;
+  };
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").CheckboxGroupValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
@@ -137,9 +155,12 @@ declare const XhCheckboxGroupIndicator: import("vue").DefineComponent<{}, () =>
 declare const XhCheckboxGroupItemText: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCheckboxGroupItemDescription: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhCheckboxGroupSelectAllTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { CheckboxGroupRootSlotProps, XhCheckboxGroupIndicator, XhCheckboxGroupItem, XhCheckboxGroupItemText, XhCheckboxGroupLabel, XhCheckboxGroupRoot, XhCheckboxGroupSelectAllTrigger };
+export { CheckboxGroupRootSlotProps, XhCheckboxGroupIndicator, XhCheckboxGroupItem, XhCheckboxGroupItemDescription, XhCheckboxGroupItemText, XhCheckboxGroupLabel, XhCheckboxGroupRoot, XhCheckboxGroupSelectAllTrigger };
 //# sourceMappingURL=checkbox-group.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkbox-group.d.ts","names":[],"sources":["../../../src/components/checkbox-group/checkbox-group.ts"],"mappings":";;;;;KA2BK,qBAAqB;;KAGd,6BAA6B,KACvC;cAIW,mCAAmB,8BAAA;;IAGC,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;IAKE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAIN,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IAlBN,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;IAKE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;;;;;;EAQvB,WAAC,OAAO,+BAA+B;EACzC,cAAM;EACP,QAAC,OAAO,0BAA0B;kCAyB3C;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAiB9B;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAQnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAO1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"checkbox-group.d.ts","names":[],"sources":["../../../src/components/checkbox-group/checkbox-group.ts"],"mappings":";;;;;KA6BK,qBAAqB;;KAGd,6BAA6B,KACvC;cAIW,mCAAmB,8BAAA;;IAGC,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;IAOE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;EAIT,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;IArBN,MAAA,SAAS;;;;;;;IAId,MAAA;;;IACO,MAAA;;;IACF,MAAA;;;;;;;;;;;;;;;;;;;;;;;;IAOE,MAAA,SAAS;;;IAChB,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACN,MAAA,SAAS;;;;;;;;;;EAQ1B,WAAC,OAAO,+BAA+B;EACzC,cAAM;EACP,QAAC,OAAO,0BAA0B;kCA8B3C;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAa/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;;;;;;;qCAiB9B;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAQnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAOlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,8CAA8B,0BAAA,oBAAA,4BAAA;;8BAOzC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+CAA+B,0BAAA,oBAAA,4BAAA;;8BAO1C,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,7 +1,8 @@
 import { useFormControlProps } from "../form/use-form-control.js";
+import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideCheckboxGroup, provideCheckboxGroupItem, useCheckboxGroupContext, useCheckboxGroupItemContext } from "./context.js";
 import { useCheckboxGroup } from "./use-checkbox-group.js";
-import { computed, defineComponent, h } from "vue";
+import { computed, defineComponent, h, onBeforeUnmount, onMounted } from "vue";
 //#region src/components/checkbox-group/checkbox-group.ts
 const XhCheckboxGroupRoot = defineComponent({
 	name: "XhCheckboxGroupRoot",
@@ -12,6 +13,8 @@ const XhCheckboxGroupRoot = defineComponent({
 		value: { type: Array },
 		defaultValue: { type: Array },
 		itemValues: { type: Array },
+		min: { type: Number },
+		max: { type: Number },
 		disabled: {
 			type: Boolean,
 			default: void 0
@@ -27,7 +30,8 @@ const XhCheckboxGroupRoot = defineComponent({
 		name: { type: String },
 		orientation: { type: String },
 		tone: { type: String },
-		size: { type: String }
+		size: { type: String },
+		variant: { type: String }
 	},
 	emits: {
 		"value-change": (_details) => true,
@@ -41,19 +45,35 @@ const XhCheckboxGroupRoot = defineComponent({
 		};
 		const ctx = useCheckboxGroup(useFormControlProps(props), notify);
 		provideCheckboxGroup(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default ? slots.default({
-			value: ctx.api.value.value,
-			checkedState: ctx.api.value.checkedState,
-			isChecked: ctx.api.value.isChecked,
-			setValue: ctx.api.value.setValue,
-			toggleValue: ctx.api.value.toggleValue
-		}) : props.collection ? renderDefaultTree(ctx.api.value.collection, slots.label?.() ?? (props.label != null ? [props.label] : null), slots.item) : []);
+		const fieldWiring = useFieldGroupWiring();
+		const fieldLabel = useFieldLabelWiring();
+		return () => {
+			const title = slots.label?.() ?? (props.label != null ? [props.label] : null);
+			return h("div", fieldLabel.value({
+				...fieldWiring.value,
+				...ctx.api.value.getRootProps()
+			}), slots.default ? [...renderLabel(title), ...slots.default({
+				value: ctx.api.value.value,
+				checkedState: ctx.api.value.checkedState,
+				atMax: ctx.api.value.atMax,
+				atMin: ctx.api.value.atMin,
+				isChecked: ctx.api.value.isChecked,
+				setValue: ctx.api.value.setValue,
+				toggleValue: ctx.api.value.toggleValue
+			})] : props.collection ? renderDefaultTree(ctx.api.value.collection, title, slots.item) : renderLabel(title));
+		};
 	}
 });
 const XhCheckboxGroupLabel = defineComponent({
 	name: "XhCheckboxGroupLabel",
 	setup(_, { slots }) {
 		const ctx = useCheckboxGroupContext();
+		onMounted(() => {
+			ctx.labelCount.value++;
+		});
+		onBeforeUnmount(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("span", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -95,6 +115,14 @@ const XhCheckboxGroupItemText = defineComponent({
 		return () => h("span", ctx.api.value.getItemTextProps(item.value), slots.default?.());
 	}
 });
+const XhCheckboxGroupItemDescription = defineComponent({
+	name: "XhCheckboxGroupItemDescription",
+	setup(_, { slots }) {
+		const ctx = useCheckboxGroupContext();
+		const { item } = useCheckboxGroupItemContext();
+		return () => h("span", ctx.api.value.getItemDescriptionProps(item.value), slots.default?.());
+	}
+});
 const XhCheckboxGroupSelectAllTrigger = defineComponent({
 	name: "XhCheckboxGroupSelectAllTrigger",
 	setup(_, { slots }) {
@@ -108,12 +136,20 @@ const XhCheckboxGroupSelectAllTrigger = defineComponent({
 * 全选控件不在其中：它是可选部件，需要时写默认插槽。
 */
 function renderDefaultTree(collection, label, itemSlot) {
-	return [...label ? [h(XhCheckboxGroupLabel, null, () => label)] : [], ...collection.map((node) => h(XhCheckboxGroupItem, {
+	return [...renderLabel(label), ...collection.map((node) => h(XhCheckboxGroupItem, {
 		key: node.value,
 		value: node.value
-	}, () => [h(XhCheckboxGroupIndicator), h(XhCheckboxGroupItemText, null, () => itemSlot?.(node) ?? node.label)]))];
+	}, () => [
+		h(XhCheckboxGroupIndicator),
+		h(XhCheckboxGroupItemText, null, () => itemSlot?.(node) ?? node.label),
+		...node.description != null ? [h(XhCheckboxGroupItemDescription, null, () => node.description)] : []
+	]))];
+}
+/** 组标题：给了文字或 label 插槽才铺 label 部件。 */
+function renderLabel(title) {
+	return title ? [h(XhCheckboxGroupLabel, null, () => title)] : [];
 }
 //#endregion
-export { XhCheckboxGroupIndicator, XhCheckboxGroupItem, XhCheckboxGroupItemText, XhCheckboxGroupLabel, XhCheckboxGroupRoot, XhCheckboxGroupSelectAllTrigger };
+export { XhCheckboxGroupIndicator, XhCheckboxGroupItem, XhCheckboxGroupItemDescription, XhCheckboxGroupItemText, XhCheckboxGroupLabel, XhCheckboxGroupRoot, XhCheckboxGroupSelectAllTrigger };
 
 //# sourceMappingURL=checkbox-group.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkbox-group.js","names":[],"sources":["../../../src/components/checkbox-group/checkbox-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// 提供 checkbox group 相关实现。\n\nimport type { Orientation, Size, Tone } from '@xihan-ui/core'\nimport type {\n  CheckboxGroupApi,\n  CheckboxGroupItemProps,\n  CheckboxGroupNode,\n  CheckboxGroupNodeMeta,\n  CheckboxGroupSchema,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h } from 'vue'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideCheckboxGroup,\n  provideCheckboxGroupItem,\n  useCheckboxGroupContext,\n  useCheckboxGroupItemContext,\n} from './context'\nimport { useCheckboxGroup } from './use-checkbox-group'\n\ntype CheckboxGroupProps = CheckboxGroupSchema['props']\n\n/** 默认插槽的载荷：整组的选中集合与全选态，以及整体替换与翻转单值的方法。 */\nexport type CheckboxGroupRootSlotProps = Pick<\n  CheckboxGroupApi,\n  'value' | 'checkedState' | 'isChecked' | 'setValue' | 'toggleValue'\n>\n\nexport const XhCheckboxGroupRoot = defineComponent({\n  name: 'XhCheckboxGroupRoot',\n  props: {\n    collection: { type: Array as PropType<CheckboxGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    itemValues: { type: Array as PropType<string[]> },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    orientation: { type: String as PropType<Orientation> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<CheckboxGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<CheckboxGroupProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CheckboxGroupRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (props: CheckboxGroupNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: CheckboxGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useCheckboxGroup(useFormControlProps(props) as CheckboxGroupProps, notify)\n    provideCheckboxGroup(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default\n      ? slots.default({\n          value: ctx.api.value.value,\n          checkedState: ctx.api.value.checkedState,\n          isChecked: ctx.api.value.isChecked,\n          setValue: ctx.api.value.setValue,\n          toggleValue: ctx.api.value.toggleValue,\n        })\n      : props.collection\n        ? renderDefaultTree(\n            ctx.api.value.collection,\n            slots.label?.() ?? (props.label != null ? [props.label] : null),\n            slots.item,\n          )\n        : [])\n  },\n})\n\nexport const XhCheckboxGroupLabel = defineComponent({\n  name: 'XhCheckboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItem = defineComponent({\n  name: 'XhCheckboxGroupItem',\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 = useCheckboxGroupContext()\n    const item = computed<CheckboxGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideCheckboxGroupItem({ item })\n    // 表单影子由条目自行装配，不暴露成独立组件，作者只写方框与文本\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\nexport const XhCheckboxGroupIndicator = defineComponent({\n  name: 'XhCheckboxGroupIndicator',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    // 插槽留给作者放对勾图形，方框本身对读屏隐藏\n    return () => h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItemText = defineComponent({\n  name: 'XhCheckboxGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupSelectAllTrigger = defineComponent({\n  name: 'XhCheckboxGroupSelectAllTrigger',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    // 与条目同形的 role=checkbox 节点，渲染为 div，Space 由 connect 接管\n    return () => h('div', ctx.api.value.getSelectAllTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 全选控件不在其中：它是可选部件，需要时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly CheckboxGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: CheckboxGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...(label ? [h(XhCheckboxGroupLabel, null, () => label)] : []),\n    ...collection.map(node =>\n      h(XhCheckboxGroupItem, { key: node.value, value: node.value }, () => [\n        h(XhCheckboxGroupIndicator),\n        h(XhCheckboxGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n      ]),\n    ),\n  ]\n}\n"],"mappings":"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"}
+{"version":3,"file":"checkbox-group.js","names":[],"sources":["../../../src/components/checkbox-group/checkbox-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// 提供 checkbox group 相关实现。\n\nimport type { Orientation, Size, Tone } from '@xihan-ui/core'\nimport type {\n  CheckboxGroupApi,\n  CheckboxGroupItemProps,\n  CheckboxGroupNode,\n  CheckboxGroupNodeMeta,\n  CheckboxGroupSchema,\n  CheckboxGroupVariant,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, onMounted } from 'vue'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideCheckboxGroup,\n  provideCheckboxGroupItem,\n  useCheckboxGroupContext,\n  useCheckboxGroupItemContext,\n} from './context'\nimport { useCheckboxGroup } from './use-checkbox-group'\n\ntype CheckboxGroupProps = CheckboxGroupSchema['props']\n\n/** 默认插槽的载荷：整组的选中集合与全选态，以及整体替换与翻转单值的方法。 */\nexport type CheckboxGroupRootSlotProps = Pick<\n  CheckboxGroupApi,\n  'value' | 'checkedState' | 'atMax' | 'atMin' | 'isChecked' | 'setValue' | 'toggleValue'\n>\n\nexport const XhCheckboxGroupRoot = defineComponent({\n  name: 'XhCheckboxGroupRoot',\n  props: {\n    collection: { type: Array as PropType<CheckboxGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    itemValues: { type: Array as PropType<string[]> },\n    min: { type: Number },\n    max: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    orientation: { type: String as PropType<Orientation> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<CheckboxGroupVariant> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<CheckboxGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<CheckboxGroupProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CheckboxGroupRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (props: CheckboxGroupNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: CheckboxGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useCheckboxGroup(useFormControlProps(props) as CheckboxGroupProps, notify)\n    provideCheckboxGroup(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('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }), slots.default\n        ? [...renderLabel(title), ...slots.default({\n            value: ctx.api.value.value,\n            checkedState: ctx.api.value.checkedState,\n            atMax: ctx.api.value.atMax,\n            atMin: ctx.api.value.atMin,\n            isChecked: ctx.api.value.isChecked,\n            setValue: ctx.api.value.setValue,\n            toggleValue: ctx.api.value.toggleValue,\n          })]\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, title, slots.item)\n          : renderLabel(title))\n    }\n  },\n})\n\nexport const XhCheckboxGroupLabel = defineComponent({\n  name: 'XhCheckboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\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\nexport const XhCheckboxGroupItem = defineComponent({\n  name: 'XhCheckboxGroupItem',\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 = useCheckboxGroupContext()\n    const item = computed<CheckboxGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideCheckboxGroupItem({ item })\n    // 表单影子由条目自行装配，不暴露成独立组件，作者只写方框与文本\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\nexport const XhCheckboxGroupIndicator = defineComponent({\n  name: 'XhCheckboxGroupIndicator',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    // 插槽留给作者放对勾图形，方框本身对读屏隐藏\n    return () => h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItemText = defineComponent({\n  name: 'XhCheckboxGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItemDescription = defineComponent({\n  name: 'XhCheckboxGroupItemDescription',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupSelectAllTrigger = defineComponent({\n  name: 'XhCheckboxGroupSelectAllTrigger',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    // 与条目同形的 role=checkbox 节点，渲染为 div，Space 由 connect 接管\n    return () => h('div', ctx.api.value.getSelectAllTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 全选控件不在其中：它是可选部件，需要时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly CheckboxGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: CheckboxGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...renderLabel(label),\n    ...collection.map(node =>\n      h(XhCheckboxGroupItem, { key: node.value, value: node.value }, () => [\n        h(XhCheckboxGroupIndicator),\n        h(XhCheckboxGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n        ...(node.description != null ? [h(XhCheckboxGroupItemDescription, null, () => node.description)] : []),\n      ]),\n    ),\n  ]\n}\n\n/** 组标题：给了文字或 label 插槽才铺 label 部件。 */\nfunction renderLabel(title: (VNode | string)[] | null): VNode[] {\n  return title ? [h(XhCheckboxGroupLabel, null, () => title)] : []\n}\n"],"mappings":"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"}

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

@@ -1,10 +1,15 @@
-import { ComputedRef } from "vue";
+import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
 import { CheckboxGroupApi, CheckboxGroupSchema } from "@xihan-ui/headless";
 //#region src/components/checkbox-group/use-checkbox-group.d.ts
 interface CheckboxGroupContext {
   api: ComputedRef<CheckboxGroupApi>;
   service: Service<CheckboxGroupSchema>;
+  /**
+   * 已挂载的 label 部件数量，由 XhCheckboxGroupLabel 自行登记。
+   * 根的 aria-labelledby 据此决定输不输出：只看 label 属性有没有值不够，手写选项时标题可能根本没渲染。
+   */
+  labelCount: Ref<number>;
 }
 declare function useCheckboxGroup(props: CheckboxGroupSchema['props'], onValueChange?: CheckboxGroupSchema['props']['onValueChange']): CheckboxGroupContext;
 //#endregion

package/dist/components/checkbox-group/use-checkbox-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-checkbox-group.d.ts","names":[],"sources":["../../../src/components/checkbox-group/use-checkbox-group.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;iBAGH,iBACd,OAAO,8BACP,gBAAgB,gDACf"}
+{"version":3,"file":"use-checkbox-group.d.ts","names":[],"sources":["../../../src/components/checkbox-group/use-checkbox-group.ts"],"mappings":";;;;UAiBiB;EACf,KAAK,YAAY;EACjB,SAAS,QAAQ;;;;;EAKjB,YAAY;;iBAGE,iBACd,OAAO,8BACP,gBAAgB,gDACf"}

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

@@ -1,18 +1,22 @@
 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 { computed, ref } from "vue";
 import { createScope } from "@xihan-ui/core";
 import { checkboxGroupMachine, connectCheckboxGroup } from "@xihan-ui/headless";
 //#region src/components/checkbox-group/use-checkbox-group.ts
 function useCheckboxGroup(props, onValueChange) {
+	const scope = createScope(null, createVueIdGenerator());
+	const labelCount = ref(0);
 	const service = useMachine(checkboxGroupMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onValueChange
-	}), createScope(null, createVueIdGenerator()));
+	}), scope);
 	return {
 		api: computed(() => connectCheckboxGroup(service, vueNormalize)),
-		service
+		service,
+		labelCount
 	};
 }
 //#endregion

package/dist/components/checkbox-group/use-checkbox-group.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-checkbox-group.js","names":[],"sources":["../../../src/components/checkbox-group/use-checkbox-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// 提供 use checkbox group 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { CheckboxGroupApi, CheckboxGroupSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { checkboxGroupMachine, connectCheckboxGroup } 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 CheckboxGroupContext {\n  api: ComputedRef<CheckboxGroupApi>\n  service: Service<CheckboxGroupSchema>\n}\n\nexport function useCheckboxGroup(\n  props: CheckboxGroupSchema['props'],\n  onValueChange?: CheckboxGroupSchema['props']['onValueChange'],\n): CheckboxGroupContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // onValueChange 由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(checkboxGroupMachine, () => ({ ...props, onValueChange }), scope)\n  const api = computed(() => connectCheckboxGroup(service, vueNormalize))\n  return { api, service }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,iBACd,OACA,eACsB;CAItB,MAAM,UAAU,WAAW,6BAA6B;EAAE,GAAG;EAAO;CAAc,IAFpE,YAAY,MADZ,qBACsB,CAEsD,CAAC;CAE3F,OAAO;EAAE,KADG,eAAe,qBAAqB,SAAS,YAAY,CAC1D;EAAG;CAAQ;AACxB"}
+{"version":3,"file":"use-checkbox-group.js","names":[],"sources":["../../../src/components/checkbox-group/use-checkbox-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// 提供 use checkbox group 相关实现。\n\nimport type { Service } from '@xihan-ui/core'\nimport type { CheckboxGroupApi, CheckboxGroupSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { createScope } from '@xihan-ui/core'\nimport { checkboxGroupMachine, connectCheckboxGroup } 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 CheckboxGroupContext {\n  api: ComputedRef<CheckboxGroupApi>\n  service: Service<CheckboxGroupSchema>\n  /**\n   * 已挂载的 label 部件数量，由 XhCheckboxGroupLabel 自行登记。\n   * 根的 aria-labelledby 据此决定输不输出：只看 label 属性有没有值不够，手写选项时标题可能根本没渲染。\n   */\n  labelCount: Ref<number>\n}\n\nexport function useCheckboxGroup(\n  props: CheckboxGroupSchema['props'],\n  onValueChange?: CheckboxGroupSchema['props']['onValueChange'],\n): CheckboxGroupContext {\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  // onValueChange 由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const labelCount = ref(0)\n  const service = useMachine(checkboxGroupMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange }), scope)\n  const api = computed(() => connectCheckboxGroup(service, vueNormalize))\n  return { api, service, labelCount }\n}\n"],"mappings":";;;;;;;AA2BA,SAAgB,iBACd,OACA,eACsB;CAEtB,MAAM,QAAQ,YAAY,MADZ,qBACsB,CAAC;CAErC,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,6BAA6B;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;CAAc,IAAI,KAAK;CAE3H,OAAO;EAAE,KADG,eAAe,qBAAqB,SAAS,YAAY,CAC1D;EAAG;EAAS;CAAW;AACpC"}

package/dist/components/citation/citation.d.ts

@@ -0,0 +1,211 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, VNode } from "vue";
+import { Direction, Placement, Size } from "@xihan-ui/core";
+import { CitationPreviewMode, CitationSchema, CitationSource } from "@xihan-ui/headless";
+//#region src/components/citation/citation.d.ts
+type CitationProps = CitationSchema['props'];
+declare const XhCitationRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  sources: {
+    type: PropType<CitationSource[]>;
+  };
+  activeSourceId: {
+    type: PropType<string | null>;
+  };
+  defaultActiveSourceId: {
+    type: PropType<string | null>;
+  };
+  open: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  defaultOpen: BooleanConstructor;
+  disabled: BooleanConstructor;
+  loop: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  dir: {
+    type: PropType<Direction>;
+  };
+  size: {
+    type: PropType<Size>;
+  };
+  previewMode: {
+    type: PropType<CitationPreviewMode>;
+  };
+  openDelay: {
+    type: NumberConstructor;
+  };
+  closeDelay: {
+    type: NumberConstructor;
+  };
+  skipDelayDuration: {
+    type: NumberConstructor;
+  };
+  placement: {
+    type: PropType<Placement>;
+  };
+  offset: {
+    type: NumberConstructor;
+  };
+  translations: {
+    type: PropType<CitationProps["translations"]>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'active-source-change': (_details: PayloadOf<CitationProps, "onActiveSourceChange">) => true;
+  'update:activeSourceId': (_sourceId: string | null) => true;
+  'open-change': (_details: PayloadOf<CitationProps, "onOpenChange">) => true;
+  'update:open': (_open: boolean) => true;
+  'source-open': (_details: PayloadOf<CitationProps, "onSourceOpen">) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  sources: {
+    type: PropType<CitationSource[]>;
+  };
+  activeSourceId: {
+    type: PropType<string | null>;
+  };
+  defaultActiveSourceId: {
+    type: PropType<string | null>;
+  };
+  open: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  defaultOpen: BooleanConstructor;
+  disabled: BooleanConstructor;
+  loop: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  dir: {
+    type: PropType<Direction>;
+  };
+  size: {
+    type: PropType<Size>;
+  };
+  previewMode: {
+    type: PropType<CitationPreviewMode>;
+  };
+  openDelay: {
+    type: NumberConstructor;
+  };
+  closeDelay: {
+    type: NumberConstructor;
+  };
+  skipDelayDuration: {
+    type: NumberConstructor;
+  };
+  placement: {
+    type: PropType<Placement>;
+  };
+  offset: {
+    type: NumberConstructor;
+  };
+  translations: {
+    type: PropType<CitationProps["translations"]>;
+  };
+}>> & Readonly<{
+  "onOpen-change"?: ((_details: import("@xihan-ui/headless").CitationOpenChangeDetails) => any) | undefined;
+  "onUpdate:open"?: ((_open: boolean) => any) | undefined;
+  "onActive-source-change"?: ((_details: import("@xihan-ui/headless").CitationActiveSourceChangeDetails) => any) | undefined;
+  "onUpdate:activeSourceId"?: ((_sourceId: string | null) => any) | undefined;
+  "onSource-open"?: ((_details: import("@xihan-ui/headless").CitationSourceOpenDetails) => any) | undefined;
+}>, {
+  loop: boolean;
+  disabled: boolean;
+  open: boolean;
+  defaultOpen: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationText: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 这一处引用的来源；一处引多个来源时改写 sourceIds，两者只写一个。 */
+  sourceId: StringConstructor;
+  /** 一处引用多个来源，预览里可以在它们之间轮换。 */
+  sourceIds: {
+    type: PropType<readonly string[]>;
+  };
+  citationId: StringConstructor;
+  anchorIndex: NumberConstructor;
+  disabled: BooleanConstructor;
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 这一处引用的来源；一处引多个来源时改写 sourceIds，两者只写一个。 */
+  sourceId: StringConstructor;
+  /** 一处引用多个来源，预览里可以在它们之间轮换。 */
+  sourceIds: {
+    type: PropType<readonly string[]>;
+  };
+  citationId: StringConstructor;
+  anchorIndex: NumberConstructor;
+  disabled: BooleanConstructor;
+}>> & Readonly<{}>, {
+  disabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/**
+ * hover 档的浮层定位壳：预览放进它里面，锚定到当前那处引用旁并搬到 portal 落点。
+ * inline 档不搬家，皮肤把它排成 display: contents，里面的预览照常在正文流里。
+ */
+declare const XhCitationPositioner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 本实例的 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationPreview: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  sourceId: {
+    type: StringConstructor;
+    required: true;
+  };
+  anchorIndex: NumberConstructor;
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  sourceId: {
+    type: StringConstructor;
+    required: true;
+  };
+  anchorIndex: NumberConstructor;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationSourceLink: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationSourceIndex: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationSourceTitle: import("vue").DefineComponent<{}, () => VNode, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationSourceMeta: import("vue").DefineComponent<{}, () => VNode, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationSource: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  sourceId: {
+    type: StringConstructor;
+    required: true;
+  };
+  disabled: BooleanConstructor;
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  sourceId: {
+    type: StringConstructor;
+    required: true;
+  };
+  disabled: BooleanConstructor;
+}>> & Readonly<{}>, {
+  disabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhCitationList: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { XhCitationList, XhCitationPositioner, XhCitationPreview, XhCitationRoot, XhCitationSource, XhCitationSourceIndex, XhCitationSourceLink, XhCitationSourceMeta, XhCitationSourceTitle, XhCitationText, XhCitationTrigger };
+//# sourceMappingURL=citation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"citation.d.ts","names":[],"sources":["../../../src/components/citation/citation.ts"],"mappings":";;;;;KAmBK,gBAAgB;cAER,8BAAc,8BAAA;;IAGG,MAAA,SAAS;;;IACD,MAAA;;;IACO,MAAA;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;;;IAEN,MAAA,SAAS;;;;;EAGN,yBAAA,UAAA,UAAU;EACR,0BAAA;EACX,gBAAA,UAAA,UAAU;EACb,gBAAA;EACG,gBAAA,UAAA,UAAU;;;IAtBV,MAAA,SAAS;;;IACD,MAAA;;;IACO,MAAA;;;;;;;;;;;;;IAKlB,MAAA,SAAS;;;IACR,MAAA,SAAS;;;IACF,MAAA,SAAS;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;;;IAEN,MAAA,SAAS;;;;;;;;;;;;;qCA4B3C;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAMzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,8BAAA;;;;;IAME,MAAA;;;;;;;;;;;;IAAA,MAAA;;;;;;;qCAS9B;;;;;cAMW,oCAAoB,8BAAA;;;IAIA,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,iCAAiB,8BAAA;;;;;;;;;;;;;;MAgB5B,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,qCAAqB,0BAAA,oBAAA,4BAAA;;8BAOhC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAeW,qCAAqB,0BAVzB,iCAAK,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAiBD,oCAAoB,0BAjBxB,iCAAK,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAwBD,gCAAgB,8BAAA;;;;;;;;;;;;;;;;qCAc3B;cAEW,8BAAc,0BAAA,oBAAA,4BAAA;;8BAWzB,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}