@xihan-ui/vue 4.2.0 → 5.0.0

package/dist/components/color-picker/color-picker.d.ts

@@ -1,12 +1,21 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { ColorPickerApi, ColorPickerInputChannel, ColorPickerSchema, ColorPickerSelectionMode, ColorPickerTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Direction, Placement, Size } from "@xihan-ui/core";
-import { ColorFormat, ColorPickerApi, ColorPickerInputChannel, ColorPickerSchema, ColorPickerSelectionMode, ColorPickerTranslations } from "@xihan-ui/headless";
+import { ColorFormat } from "@xihan-ui/core/color";
 //#region src/components/color-picker/color-picker.d.ts
 type ColorPickerProps = ColorPickerSchema['props'];
 /** 默认插槽的载荷：展开态、当前颜色的各种表示、预设色板、屏幕取色状态，以及修改展开与修改值两个动作。 */
 type ColorPickerRootSlotProps = Pick<ColorPickerApi, 'open' | 'value' | 'color' | 'canAdd' | 'rgba' | 'hsva' | 'swatches' | 'recentColors' | 'picking' | 'eyeDropperSupported' | 'errors' | 'setOpen' | 'setValue' | 'add' | 'clearError' | 'clearRecentColors'>;
 declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   /** 选中的颜色，值串数组；单选可写裸串。 */
   value: {
     type: PropType<string | string[]>;
@@ -42,6 +51,14 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
     type: BooleanConstructor;
     default: undefined;
   };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   alpha: BooleanConstructor;
   swatches: {
     type: PropType<string[]>;
@@ -59,6 +76,10 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
   name: {
     type: StringConstructor;
   };
+  /** 单选未选（值为空数组）时值文字显示的提示；缺省取 translations.placeholder。 */
+  placeholder: {
+    type: StringConstructor;
+  };
   size: {
     type: PropType<Size>;
   };
@@ -87,7 +108,16 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
   'update:open': (_open: PayloadOf<ColorPickerProps, "onOpenChange">["open"]) => true;
   'recent-colors-change': (_details: PayloadOf<ColorPickerProps, "onRecentColorsChange">) => true;
   'update:recentColors': (_recentColors: PayloadOf<ColorPickerProps, "onRecentColorsChange">["recentColors"]) => true;
+  clear: () => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   /** 选中的颜色，值串数组；单选可写裸串。 */
   value: {
     type: PropType<string | string[]>;
@@ -123,6 +153,14 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
     type: BooleanConstructor;
     default: undefined;
   };
+  invalid: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+  required: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
   alpha: BooleanConstructor;
   swatches: {
     type: PropType<string[]>;
@@ -140,6 +178,10 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
   name: {
     type: StringConstructor;
   };
+  /** 单选未选（值为空数组）时值文字显示的提示；缺省取 translations.placeholder。 */
+  placeholder: {
+    type: StringConstructor;
+  };
   size: {
     type: PropType<Size>;
   };
@@ -161,12 +203,15 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").ColorPickerValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string[]) => any) | undefined;
+  onClear?: (() => any) | undefined;
   "onOpen-change"?: ((_details: import("@xihan-ui/headless").ColorPickerOpenChangeDetails) => any) | undefined;
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
   "onColor-error"?: ((_details: import("@xihan-ui/headless").ColorPickerErrorDetails) => any) | undefined;
   "onRecent-colors-change"?: ((_details: import("@xihan-ui/headless").ColorPickerRecentColorsChangeDetails) => any) | undefined;
   "onUpdate:recentColors"?: ((_recentColors: string[]) => any) | undefined;
 }>, {
+  required: boolean;
+  invalid: boolean;
   disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
@@ -175,6 +220,7 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
   alpha: boolean;
 }, SlotsType<{
   default?: (props: ColorPickerRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhColorPickerLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -185,6 +231,9 @@ declare const XhColorPickerControl: import("vue").DefineComponent<{}, () => VNod
 declare const XhColorPickerTrigger: 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 XhColorPickerClearTrigger: 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 XhColorPickerValueText: 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>;
@@ -301,5 +350,5 @@ declare const XhColorPickerHiddenInput: import("vue").DefineComponent<{}, () =>
   [key: string]: any;
 }>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { ColorPickerRootSlotProps, XhColorPickerAlphaSlider, XhColorPickerAreaThumb, XhColorPickerChannelInput, XhColorPickerConfirmTrigger, XhColorPickerContent, XhColorPickerControl, XhColorPickerEyeDropperTrigger, XhColorPickerHiddenInput, XhColorPickerHueSlider, XhColorPickerItemDeleteTrigger, XhColorPickerLabel, XhColorPickerOverflowTag, XhColorPickerPositioner, XhColorPickerRecentSwatchPicker, XhColorPickerRoot, XhColorPickerSaturationArea, XhColorPickerSwatch, XhColorPickerSwatchPicker, XhColorPickerTag, XhColorPickerTagLabel, XhColorPickerTagList, XhColorPickerTrigger, XhColorPickerValueText };
+export { ColorPickerRootSlotProps, XhColorPickerAlphaSlider, XhColorPickerAreaThumb, XhColorPickerChannelInput, XhColorPickerClearTrigger, XhColorPickerConfirmTrigger, XhColorPickerContent, XhColorPickerControl, XhColorPickerEyeDropperTrigger, XhColorPickerHiddenInput, XhColorPickerHueSlider, XhColorPickerItemDeleteTrigger, XhColorPickerLabel, XhColorPickerOverflowTag, XhColorPickerPositioner, XhColorPickerRecentSwatchPicker, XhColorPickerRoot, XhColorPickerSaturationArea, XhColorPickerSwatch, XhColorPickerSwatchPicker, XhColorPickerTag, XhColorPickerTagLabel, XhColorPickerTagList, XhColorPickerTrigger, XhColorPickerValueText };
 //# sourceMappingURL=color-picker.d.ts.map

package/dist/components/color-picker/color-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color-picker.d.ts","names":[],"sources":["../../../src/components/color-picker/color-picker.ts"],"mappings":"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"}
+{"version":3,"file":"color-picker.d.ts","names":[],"sources":["../../../src/components/color-picker/color-picker.ts"],"mappings":"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"}

package/dist/components/color-picker/color-picker.js

@@ -1,20 +1,26 @@
+import { renderStructure } from "../../runtime/structure.js";
 import { withXhConfig } from "../../config/config.js";
 import { XhPortal } from "../../runtime/portal.js";
 import { slotIsPlainText } from "../../runtime/slot-content.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { useFormControlProps } from "../form/use-form-control.js";
+import { useFieldGroupWiring, useFieldLabelWiring } from "../field/use-field-control.js";
 import { provideColorSlider } from "../color-slider/context.js";
 import { XhColorSliderControl, XhColorSliderThumb, XhColorSliderTrack } from "../color-slider/color-slider.js";
 import { provideColorSwatchPicker } from "../color-swatch-picker/context.js";
 import { XhColorSwatchPickerItem } from "../color-swatch-picker/color-swatch-picker.js";
 import { provideColorPicker, provideColorPickerTag, useColorPickerContext, useColorPickerTagContext } from "./context.js";
 import { useColorPicker } from "./use-color-picker.js";
-import { computed, defineComponent, h, mergeProps } from "vue";
-import { colorPickerToInputChannel } from "@xihan-ui/headless";
+import { colorPickerStructure, colorPickerToInputChannel } from "@xihan-ui/headless";
+import { computed, defineComponent, h, mergeProps, onUnmounted } from "vue";
 //#region src/components/color-picker/color-picker.ts
 const XhColorPickerRoot = defineComponent({
 	name: "XhColorPickerRoot",
 	props: {
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		/** 选中的颜色，值串数组；单选可写裸串。 */
 		value: { type: [String, Array] },
 		defaultValue: { type: [String, Array] },
@@ -38,6 +44,14 @@ const XhColorPickerRoot = defineComponent({
 			type: Boolean,
 			default: void 0
 		},
+		invalid: {
+			type: Boolean,
+			default: void 0
+		},
+		required: {
+			type: Boolean,
+			default: void 0
+		},
 		alpha: Boolean,
 		swatches: { type: Array },
 		inline: Boolean,
@@ -45,6 +59,8 @@ const XhColorPickerRoot = defineComponent({
 		defaultRecentColors: { type: Array },
 		maxRecentColors: { type: Number },
 		name: { type: String },
+		/** 单选未选（值为空数组）时值文字显示的提示；缺省取 translations.placeholder。 */
+		placeholder: { type: String },
 		size: { type: String },
 		variant: { type: String },
 		dir: { type: String },
@@ -59,7 +75,8 @@ const XhColorPickerRoot = defineComponent({
 		"update:value": (_value) => true,
 		"update:open": (_open) => true,
 		"recent-colors-change": (_details) => true,
-		"update:recentColors": (_recentColors) => true
+		"update:recentColors": (_recentColors) => true,
+		"clear": () => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -80,33 +97,41 @@ const XhColorPickerRoot = defineComponent({
 			onValueChange: notifyValue,
 			onOpenChange: notifyOpen,
 			onColorError: notifyColorError,
-			onRecentColorsChange: notifyRecent
+			onRecentColorsChange: notifyRecent,
+			onClear: () => emit("clear")
 		});
 		provideColorPicker(ctx);
-		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
-			open: ctx.api.value.open,
-			value: ctx.api.value.value,
-			color: ctx.api.value.color,
-			canAdd: ctx.api.value.canAdd,
-			rgba: ctx.api.value.rgba,
-			hsva: ctx.api.value.hsva,
-			swatches: ctx.api.value.swatches,
-			recentColors: ctx.api.value.recentColors,
-			picking: ctx.api.value.picking,
-			eyeDropperSupported: ctx.api.value.eyeDropperSupported,
-			errors: ctx.api.value.errors,
-			setOpen: ctx.api.value.setOpen,
-			setValue: ctx.api.value.setValue,
-			add: ctx.api.value.add,
-			clearError: ctx.api.value.clearError,
-			clearRecentColors: ctx.api.value.clearRecentColors
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				open: api.open,
+				value: api.value,
+				color: api.color,
+				canAdd: api.canAdd,
+				rgba: api.rgba,
+				hsva: api.hsva,
+				swatches: api.swatches,
+				recentColors: api.recentColors,
+				picking: api.picking,
+				eyeDropperSupported: api.eyeDropperSupported,
+				errors: api.errors,
+				setOpen: api.setOpen,
+				setValue: api.setValue,
+				add: api.add,
+				clearError: api.clearError,
+				clearRecentColors: api.clearRecentColors
+			}) : renderDefaultStructure(api, props.label, props.name !== void 0, slots.label));
+		};
 	}
 });
 const XhColorPickerLabel = defineComponent({
 	name: "XhColorPickerLabel",
 	setup(_, { slots }) {
 		const ctx = useColorPickerContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -120,20 +145,32 @@ const XhColorPickerControl = defineComponent({
 const XhColorPickerTrigger = defineComponent({
 	name: "XhColorPickerTrigger",
 	setup(_, { slots }) {
+		const fieldWiring = useFieldGroupWiring();
+		const fieldLabel = useFieldLabelWiring();
 		const ctx = useColorPickerContext();
 		return () => h("button", {
-			...ctx.api.value.getTriggerProps(),
+			...fieldLabel.value({
+				...fieldWiring.value,
+				...ctx.api.value.getTriggerProps()
+			}),
 			ref: (el) => {
 				ctx.triggerRef.value = el;
 			}
 		}, slots.default?.());
 	}
 });
+const XhColorPickerClearTrigger = defineComponent({
+	name: "XhColorPickerClearTrigger",
+	setup(_, { slots }) {
+		const ctx = useColorPickerContext();
+		return () => h("button", ctx.api.value.getClearTriggerProps(), slots.default?.());
+	}
+});
 const XhColorPickerValueText = defineComponent({
 	name: "XhColorPickerValueText",
 	setup(_, { slots }) {
 		const ctx = useColorPickerContext();
-		return () => h("span", ctx.api.value.getValueTextProps(), slots.default?.() ?? ctx.api.value.color);
+		return () => h("span", ctx.api.value.getValueTextProps(), slots.default?.() ?? ctx.api.value.valueText);
 	}
 });
 const XhColorPickerSwatch = defineComponent({
@@ -351,7 +388,61 @@ const XhColorPickerHiddenInput = defineComponent({
 		})) : h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
+/** 标准结构里各部件对应的组件；委派部件按「组件名/部件名」查，色板的每一格自己铺表单影子、色块与选中标记。 */
+const COLOR_PICKER_PARTS = {
+	"label": XhColorPickerLabel,
+	"control": XhColorPickerControl,
+	"tag-list": XhColorPickerTagList,
+	"trigger": XhColorPickerTrigger,
+	"clear-trigger": XhColorPickerClearTrigger,
+	"value-text": XhColorPickerValueText,
+	"swatch": XhColorPickerSwatch,
+	"positioner": XhColorPickerPositioner,
+	"content": XhColorPickerContent,
+	"saturation-area": XhColorPickerSaturationArea,
+	"area-thumb": XhColorPickerAreaThumb,
+	"hue-slider": XhColorPickerHueSlider,
+	"alpha-slider": XhColorPickerAlphaSlider,
+	"channel-input": XhColorPickerChannelInput,
+	"swatch-picker": XhColorPickerSwatchPicker,
+	"recent-swatch-picker": XhColorPickerRecentSwatchPicker,
+	"confirm-trigger": XhColorPickerConfirmTrigger,
+	"hidden-input": XhColorPickerHiddenInput,
+	"color-slider/control": XhColorSliderControl,
+	"color-slider/track": XhColorSliderTrack,
+	"color-slider/thumb": XhColorSliderThumb,
+	"color-swatch-picker/item": XhColorSwatchPickerItem,
+	"tag/tag": XhColorPickerTag,
+	"tag/tag-label": XhColorPickerTagLabel,
+	"tag/item-delete-trigger": XhColorPickerItemDeleteTrigger,
+	"tag/overflow-tag": XhColorPickerOverflowTag
+};
+/** 色板的每一格自己铺表单影子、色块与选中标记，铺结构时去掉这几格。 */
+function withoutSelfAssembled(nodes) {
+	return nodes.map((node) => {
+		if (!("part" in node) || !node.children) return node;
+		if (node.component === "color-swatch-picker" && node.part === "item") return {
+			...node,
+			children: []
+		};
+		return {
+			...node,
+			children: withoutSelfAssembled(node.children)
+		};
+	});
+}
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 colorPickerStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, hiddenInput, labelSlot) {
+	return renderStructure(withoutSelfAssembled(colorPickerStructure(api, {
+		label,
+		hiddenInput,
+		slotted: (name) => name === "label" && labelSlot != null
+	})), COLOR_PICKER_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
-export { XhColorPickerAlphaSlider, XhColorPickerAreaThumb, XhColorPickerChannelInput, XhColorPickerConfirmTrigger, XhColorPickerContent, XhColorPickerControl, XhColorPickerEyeDropperTrigger, XhColorPickerHiddenInput, XhColorPickerHueSlider, XhColorPickerItemDeleteTrigger, XhColorPickerLabel, XhColorPickerOverflowTag, XhColorPickerPositioner, XhColorPickerRecentSwatchPicker, XhColorPickerRoot, XhColorPickerSaturationArea, XhColorPickerSwatch, XhColorPickerSwatchPicker, XhColorPickerTag, XhColorPickerTagLabel, XhColorPickerTagList, XhColorPickerTrigger, XhColorPickerValueText };
+export { XhColorPickerAlphaSlider, XhColorPickerAreaThumb, XhColorPickerChannelInput, XhColorPickerClearTrigger, XhColorPickerConfirmTrigger, XhColorPickerContent, XhColorPickerControl, XhColorPickerEyeDropperTrigger, XhColorPickerHiddenInput, XhColorPickerHueSlider, XhColorPickerItemDeleteTrigger, XhColorPickerLabel, XhColorPickerOverflowTag, XhColorPickerPositioner, XhColorPickerRecentSwatchPicker, XhColorPickerRoot, XhColorPickerSaturationArea, XhColorPickerSwatch, XhColorPickerSwatchPicker, XhColorPickerTag, XhColorPickerTagLabel, XhColorPickerTagList, XhColorPickerTrigger, XhColorPickerValueText };
 
 //# sourceMappingURL=color-picker.js.map

package/dist/components/color-picker/color-picker.js.map

@@ -1 +1 @@
-{"version":3,"file":"color-picker.js","names":[],"sources":["../../../src/components/color-picker/color-picker.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// 提供 color picker 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size } from '@xihan-ui/core'\nimport type {\n  ColorFormat,\n  ColorPickerApi,\n  ColorPickerInputChannel,\n  ColorPickerSchema,\n  ColorPickerSelectionMode,\n  ColorPickerTranslations,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { colorPickerToInputChannel } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { slotIsPlainText } from '../../runtime/slot-content'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { XhColorSliderControl, XhColorSliderThumb, XhColorSliderTrack } from '../color-slider/color-slider'\nimport { provideColorSlider } from '../color-slider/context'\nimport { XhColorSwatchPickerItem } from '../color-swatch-picker/color-swatch-picker'\nimport { provideColorSwatchPicker } from '../color-swatch-picker/context'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideColorPicker, provideColorPickerTag, useColorPickerContext, useColorPickerTagContext } from './context'\nimport { useColorPicker } from './use-color-picker'\n\ntype ColorPickerProps = ColorPickerSchema['props']\n\n/** 默认插槽的载荷：展开态、当前颜色的各种表示、预设色板、屏幕取色状态，以及修改展开与修改值两个动作。 */\nexport type ColorPickerRootSlotProps = Pick<\n  ColorPickerApi,\n  'open' | 'value' | 'color' | 'canAdd' | 'rgba' | 'hsva' | 'swatches' | 'recentColors' | 'picking' | 'eyeDropperSupported' | 'errors' | 'setOpen' | 'setValue' | 'add' | 'clearError' | 'clearRecentColors'\n>\n\nexport const XhColorPickerRoot = defineComponent({\n  name: 'XhColorPickerRoot',\n  // 缺省值由 connect 与机器给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 选中的颜色，值串数组；单选可写裸串。 */\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    /** 选择模式，默认 single；multiple 时工作色是草稿、按「添加」收进值，色块点一下切换，输入行里排成标签。 */\n    selectionMode: { type: String as PropType<ColorPickerSelectionMode> },\n    /** multiple 下最多选几个颜色。 */\n    maxSelected: { type: Number },\n    /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */\n    maxTagCount: { type: Number },\n    format: { type: String as PropType<ColorFormat> },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    alpha: Boolean,\n    swatches: { type: Array as PropType<string[]> },\n    inline: Boolean,\n    // 缺席值 undefined 表示非受控\n    recentColors: { type: Array as PropType<string[]> },\n    defaultRecentColors: { type: Array as PropType<string[]> },\n    maxRecentColors: { type: Number },\n    name: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<ControlVariant> },\n    dir: { type: String as PropType<Direction> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    translations: { type: Object as PropType<Partial<ColorPickerTranslations>> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<ColorPickerProps, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<ColorPickerProps, 'onOpenChange'>) => true,\n    'color-error': (_details: PayloadOf<ColorPickerProps, 'onColorError'>) => true,\n    'update:value': (_value: PayloadOf<ColorPickerProps, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<ColorPickerProps, 'onOpenChange'>['open']) => true,\n    'recent-colors-change': (_details: PayloadOf<ColorPickerProps, 'onRecentColorsChange'>) => true,\n    'update:recentColors': (_recentColors: PayloadOf<ColorPickerProps, 'onRecentColorsChange'>['recentColors']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ColorPickerRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: ColorPickerProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyOpen: ColorPickerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifyColorError: ColorPickerProps['onColorError'] = details => emit('color-error', details)\n    const notifyRecent: ColorPickerProps['onRecentColorsChange'] = (details) => {\n      emit('recent-colors-change', details)\n      emit('update:recentColors', details.recentColors)\n    }\n    const ctx = useColorPicker(withXhConfig('color-picker', useFormControlProps(props)) as ColorPickerProps, {\n      onValueChange: notifyValue,\n      onOpenChange: notifyOpen,\n      onColorError: notifyColorError,\n      onRecentColorsChange: notifyRecent,\n    })\n    provideColorPicker(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      open: ctx.api.value.open,\n      value: ctx.api.value.value,\n      color: ctx.api.value.color,\n      canAdd: ctx.api.value.canAdd,\n      rgba: ctx.api.value.rgba,\n      hsva: ctx.api.value.hsva,\n      swatches: ctx.api.value.swatches,\n      recentColors: ctx.api.value.recentColors,\n      picking: ctx.api.value.picking,\n      eyeDropperSupported: ctx.api.value.eyeDropperSupported,\n      errors: ctx.api.value.errors,\n      setOpen: ctx.api.value.setOpen,\n      setValue: ctx.api.value.setValue,\n      add: ctx.api.value.add,\n      clearError: ctx.api.value.clearError,\n      clearRecentColors: ctx.api.value.clearRecentColors,\n    }))\n  },\n})\n\nexport const XhColorPickerLabel = defineComponent({\n  name: 'XhColorPickerLabel',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerControl = defineComponent({\n  name: 'XhColorPickerControl',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 描边、底色与聚焦环所在的那一层，触发按钮与尾部动作钮在里面并排\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerTrigger = defineComponent({\n  name: 'XhColorPickerTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 原生 button，激活交给平台；同时是浮层的定位锚点\n    return () => h('button', {\n      ...ctx.api.value.getTriggerProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhColorPickerValueText = defineComponent({\n  name: 'XhColorPickerValueText',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 有插槽用插槽，否则显示工作色的值串\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.color,\n    )\n  },\n})\n\nexport const XhColorPickerSwatch = defineComponent({\n  name: 'XhColorPickerSwatch',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('span', ctx.api.value.getSwatchProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerPositioner = defineComponent({\n  name: 'XhColorPickerPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useColorPickerContext()\n    // 面板的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；条子走浮层 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhColorPickerContent = defineComponent({\n  name: 'XhColorPickerContent',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhColorPickerSaturationArea = defineComponent({\n  name: 'XhColorPickerSaturationArea',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 区域节点交给机器，矩形在指针事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getSaturationAreaProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.areaRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhColorPickerAreaThumb = defineComponent({\n  name: 'XhColorPickerAreaThumb',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('div', ctx.api.value.getAreaThumbProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 色相滑块的挂载点，同时充当该滑块的根节点：其中放置的是 XhColorSlider* 普通部件\n * （control / track / thumb / label / value-text），DOM 带 data-scope=\"color-slider\"。\n * 未写默认插槽时铺开最简结构：一条轨道加一个拇指。\n */\nexport const XhColorPickerHueSlider = defineComponent({\n  name: 'XhColorPickerHueSlider',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSlider(ctx.hueSlider)\n    return () => h('div', ctx.api.value.getHueSliderProps() as Record<string, unknown>, slots.default?.() ?? renderSliderTree())\n  },\n})\n\n/** 透明度滑块的挂载点，同上；alpha 关闭时整条禁用。 */\nexport const XhColorPickerAlphaSlider = defineComponent({\n  name: 'XhColorPickerAlphaSlider',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSlider(ctx.alphaSlider)\n    return () => h('div', ctx.api.value.getAlphaSliderProps() as Record<string, unknown>, slots.default?.() ?? renderSliderTree())\n  },\n})\n\n/** 未写默认插槽时的滑块内部：control 中一条 track 与一个 thumb，与手写部件产出的 DOM 一致。 */\nfunction renderSliderTree(): VNode[] {\n  return [h(XhColorSliderControl, null, () => [h(XhColorSliderTrack), h(XhColorSliderThumb)])]\n}\n\nexport const XhColorPickerChannelInput = defineComponent({\n  name: 'XhColorPickerChannelInput',\n  props: {\n    /** 该输入框编辑的通道：hex 是整串，r/g/b 是分量，a 是透明度百分数；默认或无法识别时按 hex 处理。 */\n    channel: { type: String as PropType<ColorPickerInputChannel> },\n  },\n  setup(props) {\n    const ctx = useColorPickerContext()\n    const channel = computed(() => colorPickerToInputChannel(props.channel))\n    // 通道身份由本部件自己声明，不必嵌在通道滑杆内\n    return () => h('input', ctx.api.value.getChannelInputProps({ channel: channel.value }) as Record<string, unknown>)\n  },\n})\n\nexport const XhColorPickerEyeDropperTrigger = defineComponent({\n  name: 'XhColorPickerEyeDropperTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('button', ctx.api.value.getEyeDropperTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 预设色板的挂载点，同时充当色板的根节点（role=radiogroup、方向键与 roving tabindex 都在它上面）：\n * 其中放置的是 XhColorSwatchPickerItem，DOM 带 data-scope=\"color-swatch-picker\"。\n * 未写默认插槽时按 swatches 自动铺开格子。\n */\nexport const XhColorPickerSwatchPicker = defineComponent({\n  name: 'XhColorPickerSwatchPicker',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSwatchPicker(ctx.swatchPicker)\n    return () => h(\n      'div',\n      ctx.api.value.getSwatchPickerProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.swatchPicker.swatches.map(node => h(XhColorSwatchPickerItem, { key: node.value, value: node.value })),\n    )\n  },\n})\n\n/**\n * 最近使用色的挂载点，与预设色板同一套：其中放置的是 XhColorSwatchPickerItem。\n * 未写默认插槽时按 recentColors 自动铺开格子；还没有最近使用色时挂载点收起。\n */\nexport const XhColorPickerRecentSwatchPicker = defineComponent({\n  name: 'XhColorPickerRecentSwatchPicker',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSwatchPicker(ctx.recentSwatchPicker)\n    return () => h(\n      'div',\n      ctx.api.value.getRecentSwatchPickerProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.recentSwatchPicker.swatches.map(node => h(XhColorSwatchPickerItem, { key: node.value, value: node.value })),\n    )\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）。 */\nexport const XhColorPickerTagLabel = defineComponent({\n  name: 'XhColorPickerTagLabel',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签内容：只有文字时替它包一层 label；作者自己写了节点则原样放行。库自身填入的文字（+N）恒包 label。 */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhColorPickerTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhColorPickerTagLabel, null, () => content)] : content\n}\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的颜色，焦点不动。 */\nexport const XhColorPickerItemDeleteTrigger = defineComponent({\n  name: 'XhColorPickerItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    const tag = useColorPickerTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 多选时一个选中颜色一个标签，即库内 tag 的 root（data-scope=\"tag\"），标签前由皮肤画一个色点。 */\nexport const XhColorPickerTag = defineComponent({\n  name: 'XhColorPickerTag',\n  props: {\n    /** 它代表哪个选中颜色。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorPickerTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhColorPickerOverflowTag = defineComponent({\n  name: 'XhColorPickerOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/**\n * 标签行：多选时放在盒里、触发钮之前；单选时连接层给 hidden。\n * 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。\n */\nexport const XhColorPickerTagList = defineComponent({\n  name: 'XhColorPickerTagList',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default\n      ? slots.default()\n      : [\n          ...ctx.api.value.tags.map(tag => h(XhColorPickerTag, { key: tag.value, value: tag.value }, () => [\n            h(XhColorPickerTagLabel, null, () => tag.label),\n            h(XhColorPickerItemDeleteTrigger),\n          ])),\n          h(XhColorPickerOverflowTag),\n        ])\n  },\n})\n\n/** 「添加」：多选时把工作色收进值，浮层不收；单选时连接层给 hidden。文字由作者写。 */\nexport const XhColorPickerConfirmTrigger = defineComponent({\n  name: 'XhColorPickerConfirmTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('button', ctx.api.value.getConfirmTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerHiddenInput = defineComponent({\n  name: 'XhColorPickerHiddenInput',\n  setup() {\n    const ctx = useColorPickerContext()\n    // 多选时一个选中值一份同名输入，表单按原生多值收；单选仍是一份\n    return () => ctx.api.value.selectionMode === 'multiple'\n      ? ctx.api.value.value.map(value => h('input', { key: value, ...ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown> }))\n      : h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"color-picker.js","names":[],"sources":["../../../src/components/color-picker/color-picker.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// 提供 color picker 相关实现。\n\nimport type { ControlVariant, Direction, Placement, Size } from '@xihan-ui/core'\nimport type { ColorFormat } from '@xihan-ui/core/color'\nimport type {\n  ColorPickerApi,\n  ColorPickerInputChannel,\n  ColorPickerSchema,\n  ColorPickerSelectionMode,\n  ColorPickerTranslations,\n  StructureChild,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { colorPickerStructure, colorPickerToInputChannel } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, mergeProps, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { slotIsPlainText } from '../../runtime/slot-content'\nimport { renderStructure } from '../../runtime/structure'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { XhColorSliderControl, XhColorSliderThumb, XhColorSliderTrack } from '../color-slider/color-slider'\nimport { provideColorSlider } from '../color-slider/context'\nimport { XhColorSwatchPickerItem } from '../color-swatch-picker/color-swatch-picker'\nimport { provideColorSwatchPicker } from '../color-swatch-picker/context'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideColorPicker, provideColorPickerTag, useColorPickerContext, useColorPickerTagContext } from './context'\nimport { useColorPicker } from './use-color-picker'\n\ntype ColorPickerProps = ColorPickerSchema['props']\n\n/** 默认插槽的载荷：展开态、当前颜色的各种表示、预设色板、屏幕取色状态，以及修改展开与修改值两个动作。 */\nexport type ColorPickerRootSlotProps = Pick<\n  ColorPickerApi,\n  'open' | 'value' | 'color' | 'canAdd' | 'rgba' | 'hsva' | 'swatches' | 'recentColors' | 'picking' | 'eyeDropperSupported' | 'errors' | 'setOpen' | 'setValue' | 'add' | 'clearError' | 'clearRecentColors'\n>\n\nexport const XhColorPickerRoot = defineComponent({\n  name: 'XhColorPickerRoot',\n  // 缺省值由 connect 与机器给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    /** 选中的颜色，值串数组；单选可写裸串。 */\n    value: { type: [String, Array] as PropType<string | string[]> },\n    defaultValue: { type: [String, Array] as PropType<string | string[]> },\n    /** 选择模式，默认 single；multiple 时工作色是草稿、按「添加」收进值，色块点一下切换，输入行里排成标签。 */\n    selectionMode: { type: String as PropType<ColorPickerSelectionMode> },\n    /** multiple 下最多选几个颜色。 */\n    maxSelected: { type: Number },\n    /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */\n    maxTagCount: { type: Number },\n    format: { type: String as PropType<ColorFormat> },\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\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    alpha: Boolean,\n    swatches: { type: Array as PropType<string[]> },\n    inline: Boolean,\n    // 缺席值 undefined 表示非受控\n    recentColors: { type: Array as PropType<string[]> },\n    defaultRecentColors: { type: Array as PropType<string[]> },\n    maxRecentColors: { type: Number },\n    name: { type: String },\n    /** 单选未选（值为空数组）时值文字显示的提示；缺省取 translations.placeholder。 */\n    placeholder: { type: String },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<ControlVariant> },\n    dir: { type: String as PropType<Direction> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    translations: { type: Object as PropType<Partial<ColorPickerTranslations>> },\n  },\n  // *-change 携带 details 对象，update:* 携带裸值\n  emits: {\n    'value-change': (_details: PayloadOf<ColorPickerProps, 'onValueChange'>) => true,\n    'open-change': (_details: PayloadOf<ColorPickerProps, 'onOpenChange'>) => true,\n    'color-error': (_details: PayloadOf<ColorPickerProps, 'onColorError'>) => true,\n    'update:value': (_value: PayloadOf<ColorPickerProps, 'onValueChange'>['value']) => true,\n    'update:open': (_open: PayloadOf<ColorPickerProps, 'onOpenChange'>['open']) => true,\n    'recent-colors-change': (_details: PayloadOf<ColorPickerProps, 'onRecentColorsChange'>) => true,\n    'update:recentColors': (_recentColors: PayloadOf<ColorPickerProps, 'onRecentColorsChange'>['recentColors']) => true,\n    // 用户按清空钮清掉了值：先发值变化，再发它\n    'clear': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ColorPickerRootSlotProps) => VNode[]\n    label?: () => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notifyValue: ColorPickerProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const notifyOpen: ColorPickerProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const notifyColorError: ColorPickerProps['onColorError'] = details => emit('color-error', details)\n    const notifyRecent: ColorPickerProps['onRecentColorsChange'] = (details) => {\n      emit('recent-colors-change', details)\n      emit('update:recentColors', details.recentColors)\n    }\n    const ctx = useColorPicker(withXhConfig('color-picker', useFormControlProps(props)) as ColorPickerProps, {\n      onValueChange: notifyValue,\n      onOpenChange: notifyOpen,\n      onColorError: notifyColorError,\n      onRecentColorsChange: notifyRecent,\n      onClear: () => emit('clear'),\n    })\n    provideColorPicker(ctx)\n    return () => {\n      const api = ctx.api.value\n      return h('div', api.getRootProps() as Record<string, unknown>, slots.default\n        ? slots.default({\n            open: api.open,\n            value: api.value,\n            color: api.color,\n            canAdd: api.canAdd,\n            rgba: api.rgba,\n            hsva: api.hsva,\n            swatches: api.swatches,\n            recentColors: api.recentColors,\n            picking: api.picking,\n            eyeDropperSupported: api.eyeDropperSupported,\n            errors: api.errors,\n            setOpen: api.setOpen,\n            setValue: api.setValue,\n            add: api.add,\n            clearError: api.clearError,\n            clearRecentColors: api.clearRecentColors,\n          })\n        : renderDefaultStructure(api, props.label, props.name !== undefined, slots.label))\n    }\n  },\n})\n\nexport const XhColorPickerLabel = defineComponent({\n  name: 'XhColorPickerLabel',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerControl = defineComponent({\n  name: 'XhColorPickerControl',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 描边、底色与聚焦环所在的那一层，触发按钮与尾部动作钮在里面并排\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerTrigger = defineComponent({\n  name: 'XhColorPickerTrigger',\n  setup(_, { slots }) {\n    // 放进字段时字段的说明与错误文案接到触发钮上；按钮不收 aria-required / aria-readonly，只取描述链，\n    // aria-invalid 由组件自己按字段状态投影\n    const fieldWiring = useFieldGroupWiring()\n    // 字段的标签并进名字链，排在当前值前面\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useColorPickerContext()\n    // 原生 button，激活交给平台；同时是浮层的定位锚点\n    return () => h('button', {\n      ...fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getTriggerProps() as Record<string, unknown> }),\n      ref: (el: unknown) => { ctx.triggerRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhColorPickerClearTrigger = defineComponent({\n  name: 'XhColorPickerClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 触发钮的兄弟节点：单选有值时才显示，按下清回未选\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerValueText = defineComponent({\n  name: 'XhColorPickerValueText',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 有插槽用插槽，否则显示工作色的值串；单选未选时是占位提示\n    return () => h(\n      'span',\n      ctx.api.value.getValueTextProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.valueText,\n    )\n  },\n})\n\nexport const XhColorPickerSwatch = defineComponent({\n  name: 'XhColorPickerSwatch',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('span', ctx.api.value.getSwatchProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerPositioner = defineComponent({\n  name: 'XhColorPickerPositioner',\n  props: {\n    /** 本实例的 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = useColorPickerContext()\n    // 面板的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner；条子走浮层 4px 档\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.triggerRef, present: ctx.visible.value }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhColorPickerContent = defineComponent({\n  name: 'XhColorPickerContent',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('div', {\n      ...ctx.api.value.getContentProps() as Record<string, unknown>,\n      // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}（补了退场\n      // 就一帧都播不出来），所以真正的收起落成内联 display——节点始终留在原地\n      style: ctx.visible.value ? undefined : { display: 'none' },\n      ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhColorPickerSaturationArea = defineComponent({\n  name: 'XhColorPickerSaturationArea',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    // 区域节点交给机器，矩形在指针事件里现量\n    return () => h('div', {\n      ...ctx.api.value.getSaturationAreaProps() as Record<string, unknown>,\n      ref: (el: unknown) => { ctx.areaRef.value = el as HTMLElement },\n    }, slots.default?.())\n  },\n})\n\nexport const XhColorPickerAreaThumb = defineComponent({\n  name: 'XhColorPickerAreaThumb',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('div', ctx.api.value.getAreaThumbProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 色相滑块的挂载点，同时充当该滑块的根节点：其中放置的是 XhColorSlider* 普通部件\n * （control / track / thumb / label / value-text），DOM 带 data-scope=\"color-slider\"。\n * 未写默认插槽时铺开最简结构：一条轨道加一个拇指。\n */\nexport const XhColorPickerHueSlider = defineComponent({\n  name: 'XhColorPickerHueSlider',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSlider(ctx.hueSlider)\n    return () => h('div', ctx.api.value.getHueSliderProps() as Record<string, unknown>, slots.default?.() ?? renderSliderTree())\n  },\n})\n\n/** 透明度滑块的挂载点，同上；alpha 关闭时整条禁用。 */\nexport const XhColorPickerAlphaSlider = defineComponent({\n  name: 'XhColorPickerAlphaSlider',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSlider(ctx.alphaSlider)\n    return () => h('div', ctx.api.value.getAlphaSliderProps() as Record<string, unknown>, slots.default?.() ?? renderSliderTree())\n  },\n})\n\n/** 未写默认插槽时的滑块内部：control 中一条 track 与一个 thumb，与手写部件产出的 DOM 一致。 */\nfunction renderSliderTree(): VNode[] {\n  return [h(XhColorSliderControl, null, () => [h(XhColorSliderTrack), h(XhColorSliderThumb)])]\n}\n\nexport const XhColorPickerChannelInput = defineComponent({\n  name: 'XhColorPickerChannelInput',\n  props: {\n    /** 该输入框编辑的通道：hex 是整串，r/g/b 是分量，a 是透明度百分数；默认或无法识别时按 hex 处理。 */\n    channel: { type: String as PropType<ColorPickerInputChannel> },\n  },\n  setup(props) {\n    const ctx = useColorPickerContext()\n    const channel = computed(() => colorPickerToInputChannel(props.channel))\n    // 通道身份由本部件自己声明，不必嵌在通道滑杆内\n    return () => h('input', ctx.api.value.getChannelInputProps({ channel: channel.value }) as Record<string, unknown>)\n  },\n})\n\nexport const XhColorPickerEyeDropperTrigger = defineComponent({\n  name: 'XhColorPickerEyeDropperTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('button', ctx.api.value.getEyeDropperTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 预设色板的挂载点，同时充当色板的根节点（role=radiogroup、方向键与 roving tabindex 都在它上面）：\n * 其中放置的是 XhColorSwatchPickerItem，DOM 带 data-scope=\"color-swatch-picker\"。\n * 未写默认插槽时按 swatches 自动铺开格子。\n */\nexport const XhColorPickerSwatchPicker = defineComponent({\n  name: 'XhColorPickerSwatchPicker',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSwatchPicker(ctx.swatchPicker)\n    return () => h(\n      'div',\n      ctx.api.value.getSwatchPickerProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.swatchPicker.swatches.map(node => h(XhColorSwatchPickerItem, { key: node.value, value: node.value })),\n    )\n  },\n})\n\n/**\n * 最近使用色的挂载点，与预设色板同一套：其中放置的是 XhColorSwatchPickerItem。\n * 未写默认插槽时按 recentColors 自动铺开格子；还没有最近使用色时挂载点收起。\n */\nexport const XhColorPickerRecentSwatchPicker = defineComponent({\n  name: 'XhColorPickerRecentSwatchPicker',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorSwatchPicker(ctx.recentSwatchPicker)\n    return () => h(\n      'div',\n      ctx.api.value.getRecentSwatchPickerProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.recentSwatchPicker.swatches.map(node => h(XhColorSwatchPickerItem, { key: node.value, value: node.value })),\n    )\n  },\n})\n\n/** 标签文字所在的块（tag 的 label）。 */\nexport const XhColorPickerTagLabel = defineComponent({\n  name: 'XhColorPickerTagLabel',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('span', ctx.api.value.getTagLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标签内容：只有文字时替它包一层 label；作者自己写了节点则原样放行。库自身填入的文字（+N）恒包 label。 */\nfunction tagChildren(content: VNode[] | string | undefined): VNode[] | string | undefined {\n  if (typeof content === 'string')\n    return [h(XhColorPickerTagLabel, null, () => content)]\n  return slotIsPlainText(content) ? [h(XhColorPickerTagLabel, null, () => content)] : content\n}\n\n/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的颜色，焦点不动。 */\nexport const XhColorPickerItemDeleteTrigger = defineComponent({\n  name: 'XhColorPickerItemDeleteTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    const tag = useColorPickerTagContext()\n    return () => h('button', ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }) as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 多选时一个选中颜色一个标签，即库内 tag 的 root（data-scope=\"tag\"），标签前由皮肤画一个色点。 */\nexport const XhColorPickerTag = defineComponent({\n  name: 'XhColorPickerTag',\n  props: {\n    /** 它代表哪个选中颜色。 */\n    value: { type: String, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = useColorPickerContext()\n    provideColorPickerTag({ value: () => props.value })\n    return () => h('span', ctx.api.value.getTagProps({ value: props.value }) as Record<string, unknown>, tagChildren(slots.default?.()))\n  },\n})\n\n/** 折叠的标签合成的一个标签：有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */\nexport const XhColorPickerOverflowTag = defineComponent({\n  name: 'XhColorPickerOverflowTag',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h(\n      'span',\n      ctx.api.value.getOverflowTagProps() as Record<string, unknown>,\n      tagChildren(slots.default?.() ?? ctx.api.value.overflowText),\n    )\n  },\n})\n\n/**\n * 标签行：多选时放在盒里、触发钮之前；单选时连接层给 hidden。\n * 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。\n */\nexport const XhColorPickerTagList = defineComponent({\n  name: 'XhColorPickerTagList',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('span', ctx.api.value.getTagListProps() as Record<string, unknown>, slots.default\n      ? slots.default()\n      : [\n          ...ctx.api.value.tags.map(tag => h(XhColorPickerTag, { key: tag.value, value: tag.value }, () => [\n            h(XhColorPickerTagLabel, null, () => tag.label),\n            h(XhColorPickerItemDeleteTrigger),\n          ])),\n          h(XhColorPickerOverflowTag),\n        ])\n  },\n})\n\n/** 「添加」：多选时把工作色收进值，浮层不收；单选时连接层给 hidden。文字由作者写。 */\nexport const XhColorPickerConfirmTrigger = defineComponent({\n  name: 'XhColorPickerConfirmTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorPickerContext()\n    return () => h('button', ctx.api.value.getConfirmTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorPickerHiddenInput = defineComponent({\n  name: 'XhColorPickerHiddenInput',\n  setup() {\n    const ctx = useColorPickerContext()\n    // 多选时一个选中值一份同名输入，表单按原生多值收；单选仍是一份\n    return () => ctx.api.value.selectionMode === 'multiple'\n      ? ctx.api.value.value.map(value => h('input', { key: value, ...ctx.api.value.getHiddenInputProps({ value }) as Record<string, unknown> }))\n      : h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n\n/** 标准结构里各部件对应的组件；委派部件按「组件名/部件名」查，色板的每一格自己铺表单影子、色块与选中标记。 */\nconst COLOR_PICKER_PARTS = {\n  'label': XhColorPickerLabel,\n  'control': XhColorPickerControl,\n  'tag-list': XhColorPickerTagList,\n  'trigger': XhColorPickerTrigger,\n  'clear-trigger': XhColorPickerClearTrigger,\n  'value-text': XhColorPickerValueText,\n  'swatch': XhColorPickerSwatch,\n  'positioner': XhColorPickerPositioner,\n  'content': XhColorPickerContent,\n  'saturation-area': XhColorPickerSaturationArea,\n  'area-thumb': XhColorPickerAreaThumb,\n  'hue-slider': XhColorPickerHueSlider,\n  'alpha-slider': XhColorPickerAlphaSlider,\n  'channel-input': XhColorPickerChannelInput,\n  'swatch-picker': XhColorPickerSwatchPicker,\n  'recent-swatch-picker': XhColorPickerRecentSwatchPicker,\n  'confirm-trigger': XhColorPickerConfirmTrigger,\n  'hidden-input': XhColorPickerHiddenInput,\n  'color-slider/control': XhColorSliderControl,\n  'color-slider/track': XhColorSliderTrack,\n  'color-slider/thumb': XhColorSliderThumb,\n  'color-swatch-picker/item': XhColorSwatchPickerItem,\n  'tag/tag': XhColorPickerTag,\n  'tag/tag-label': XhColorPickerTagLabel,\n  'tag/item-delete-trigger': XhColorPickerItemDeleteTrigger,\n  'tag/overflow-tag': XhColorPickerOverflowTag,\n}\n\n/** 色板的每一格自己铺表单影子、色块与选中标记，铺结构时去掉这几格。 */\nfunction withoutSelfAssembled(nodes: readonly StructureChild[]): StructureChild[] {\n  return nodes.map((node): StructureChild => {\n    if (!('part' in node) || !node.children)\n      return node\n    if (node.component === 'color-swatch-picker' && node.part === 'item')\n      return { ...node, children: [] }\n    return { ...node, children: withoutSelfAssembled(node.children) }\n  })\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 colorPickerStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: ColorPickerApi, label: string | undefined, hiddenInput: boolean, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = colorPickerStructure(api, { label, hiddenInput, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(withoutSelfAssembled(nodes), COLOR_PICKER_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

package/dist/components/color-picker/use-color-picker.d.ts

@@ -1,10 +1,15 @@
 import { ColorSliderContext } from "../color-slider/use-color-slider.js";
 import { ColorSwatchPickerContext } from "../color-swatch-picker/use-color-swatch-picker.js";
+import { ColorPickerApi, ColorPickerSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { ColorPickerApi, ColorPickerSchema } from "@xihan-ui/headless";
 //#region src/components/color-picker/use-color-picker.d.ts
 interface ColorPickerContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhColorPickerLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   service: Service<ColorPickerSchema>;
   api: ComputedRef<ColorPickerApi>;
   /** 触发器，同时是浮层的定位锚点。 */
@@ -27,7 +32,7 @@ interface ColorPickerContext {
   /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */
   portalTarget: ComputedRef<string | Element>;
 }
-declare function useColorPicker(props: ColorPickerSchema['props'], handlers?: Pick<ColorPickerSchema['props'], 'onValueChange' | 'onOpenChange' | 'onColorError' | 'onRecentColorsChange'>): ColorPickerContext;
+declare function useColorPicker(props: ColorPickerSchema['props'], handlers?: Pick<ColorPickerSchema['props'], 'onValueChange' | 'onOpenChange' | 'onColorError' | 'onRecentColorsChange' | 'onClear'>): ColorPickerContext;
 //#endregion
 export { ColorPickerContext, useColorPicker };
 //# sourceMappingURL=use-color-picker.d.ts.map

package/dist/components/color-picker/use-color-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-color-picker.d.ts","names":[],"sources":["../../../src/components/color-picker/use-color-picker.ts"],"mappings":";;;;;;UAiCiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,SAAS,IAAI;;;;;EAKb,WAAW;EACX,aAAa;EACb,cAAc;;EAEd,oBAAoB;;EAEpB,cAAc,qBAAqB;;iBAGrB,eACd,OAAO,4BACP,WAAU,KAAK,0GACd"}
+{"version":3,"file":"use-color-picker.d.ts","names":[],"sources":["../../../src/components/color-picker/use-color-picker.ts"],"mappings":";;;;;;UAiCiB;;;;;EAKf,YAAY;EACZ,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,YAAY,IAAI;EAChB,eAAe,IAAI;EACnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,SAAS,IAAI;;;;;EAKb,WAAW;EACX,aAAa;EACb,cAAc;;EAEd,oBAAoB;;EAEpB,cAAc,qBAAqB;;iBAGrB,eACd,OAAO,4BACP,WAAU,KAAK,sHACd"}

package/dist/components/color-picker/use-color-picker.js

@@ -3,9 +3,9 @@ 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 { colorPickerAlphaSliderProps, colorPickerHueSliderProps, colorPickerMachine, colorPickerRecentSwatchPickerProps, colorPickerSwatchPickerProps, colorSliderMachine, colorSliderSliderProps, colorSwatchPickerMachine, connectColorPicker, sliderMachine } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { colorPickerAlphaSliderProps, colorPickerHueSliderProps, colorPickerMachine, colorPickerRecentSwatchPickerProps, colorPickerSwatchPickerProps, colorSliderMachine, colorSliderSliderProps, colorSwatchPickerMachine, connectColorPicker, sliderMachine } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/color-picker/use-color-picker.ts
 function useColorPicker(props, handlers = {}) {
@@ -16,19 +16,26 @@ function useColorPicker(props, handlers = {}) {
 	const areaRef = ref(null);
 	const idGen = createVueIdGenerator();
 	const scope = createScope(null, idGen);
+	const labelCount = ref(0);
 	const service = useMachine(colorPickerMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...handlers
 	}), scope);
 	const colorSlider = (sliderProps) => {
-		const root = useMachine(colorSliderMachine, () => sliderProps(service), scope);
+		const labelCount = ref(0);
+		const root = useMachine(colorSliderMachine, () => ({
+			...sliderProps(service),
+			labelled: labelCount.value > 0
+		}), scope);
 		const slider = useMachine(sliderMachine, () => colorSliderSliderProps(root), scope);
 		const trackRef = ref(null);
 		slider.refs.set("getTrackEl", () => trackRef.value);
 		return {
 			root,
 			slider,
-			trackRef
+			trackRef,
+			labelCount
 		};
 	};
 	const hue = colorSlider(colorPickerHueSliderProps);
@@ -86,6 +93,7 @@ function useColorPicker(props, handlers = {}) {
 	});
 	const portalTarget = computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body");
 	return {
+		labelCount,
 		visible,
 		service,
 		api,
@@ -96,12 +104,14 @@ function useColorPicker(props, handlers = {}) {
 		hueSlider: {
 			api: computed(() => api.value.hueSlider),
 			service: hue.root,
-			trackRef: hue.trackRef
+			trackRef: hue.trackRef,
+			labelCount: hue.labelCount
 		},
 		alphaSlider: {
 			api: computed(() => api.value.alphaSlider),
 			service: alpha.root,
-			trackRef: alpha.trackRef
+			trackRef: alpha.trackRef,
+			labelCount: alpha.labelCount
 		},
 		swatchPicker: {
 			api: computed(() => api.value.swatchPicker),