@xihan-ui/vue 2.1.0 → 3.1.0

package/dist/components/collapsible/collapsible.js.map

@@ -1 +1 @@
-{"version":3,"file":"collapsible.js","names":[],"sources":["../../../src/components/collapsible/collapsible.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// 提供 collapsible 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type { CollapsibleSchema } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { provideCollapsible, useCollapsibleContext } from './context'\nimport { useCollapsible } from './use-collapsible'\n\ntype CollapsibleProps = CollapsibleSchema['props']\n\nexport const XhCollapsibleRoot = defineComponent({\n  name: 'XhCollapsibleRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    disabled: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    dir: { type: String as PropType<Direction> },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<CollapsibleProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<CollapsibleProps, 'onOpenChange'>['open']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: CollapsibleProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useCollapsible(props as CollapsibleProps, notify)\n    provideCollapsible(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 触发器与其同排内容所在的行；只写触发器时可以省略它 */\nexport const XhCollapsibleHeader = defineComponent({\n  name: 'XhCollapsibleHeader',\n  setup(_, { slots }) {\n    const ctx = useCollapsibleContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCollapsibleTrigger = defineComponent({\n  name: 'XhCollapsibleTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useCollapsibleContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'collapsible')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhCollapsibleIndicator = defineComponent({\n  name: 'XhCollapsibleIndicator',\n  setup(_, { slots }) {\n    const ctx = useCollapsibleContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCollapsibleContent = defineComponent({\n  name: 'XhCollapsibleContent',\n  setup(_, { slots }) {\n    const ctx = useCollapsibleContext()\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"],"mappings":";;;;;;AAmBA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,UAAU;EACV,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,KAAK,EAAE,MAAM,OAA8B;CAC7C;CAEA,OAAO;EACL,gBAAgB,aAA0D;EAC1E,gBAAgB,UAA+D;CACjF;CACA,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA4C,YAAY;GAC5D,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,eAAe,OAA2B,MAAM;EAC5D,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;;AAGD,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CAEN,cAAc;CACd,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,sBAAsB;EAClC,aAAa;GACX,MAAM,OAAO,eAAe,IAAI,IAAI,MAAM,gBAAgB,GAA8B,KAAK;GAC7F,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,MAAM,aAAa;IAC3D,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,MAAM,QAAQ;EACnC;CACF;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,MAAM,UAAU,CAAC;CACtB;AACF,CAAC"}
+{"version":3,"file":"collapsible.js","names":[],"sources":["../../../src/components/collapsible/collapsible.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// 提供 collapsible 相关实现。\n\nimport type { Direction, Size, Tone } from '@xihan-ui/core'\nimport type { CollapsibleSchema } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { mergePartProps } from '../../runtime/merge-props'\nimport { provideCollapsible, useCollapsibleContext } from './context'\nimport { useCollapsible } from './use-collapsible'\n\ntype CollapsibleProps = CollapsibleSchema['props']\n\nexport const XhCollapsibleRoot = defineComponent({\n  name: 'XhCollapsibleRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    disabled: Boolean,\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    dir: { type: String as PropType<Direction> },\n    lazyMount: Boolean,\n    unmountOnExit: Boolean,\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<CollapsibleProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<CollapsibleProps, 'onOpenChange'>['open']) => true,\n  },\n  setup(props, { slots, emit }) {\n    const notify: CollapsibleProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useCollapsible(props as CollapsibleProps, notify)\n    provideCollapsible(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 触发器与其同排内容所在的行；只写触发器时可以省略它 */\nexport const XhCollapsibleHeader = defineComponent({\n  name: 'XhCollapsibleHeader',\n  setup(_, { slots }) {\n    const ctx = useCollapsibleContext()\n    return () => h('div', ctx.api.value.getHeaderProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCollapsibleTrigger = defineComponent({\n  name: 'XhCollapsibleTrigger',\n  // 直通属性自己合：Vue 默认把作者的处理器排在部件的后面，这里改成作者先跑\n  inheritAttrs: false,\n  props: {\n    /** 借用作者的子节点作为触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots, attrs }) {\n    const ctx = useCollapsibleContext()\n    return () => {\n      const part = mergePartProps(ctx.api.value.getTriggerProps() as Record<string, unknown>, attrs)\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, part, 'collapsible')\n        if (merged)\n          return merged\n      }\n      return h('button', part, children)\n    }\n  },\n})\n\nexport const XhCollapsibleIndicator = defineComponent({\n  name: 'XhCollapsibleIndicator',\n  setup(_, { slots }) {\n    const ctx = useCollapsibleContext()\n    return () => h('span', ctx.api.value.getIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCollapsibleContent = defineComponent({\n  name: 'XhCollapsibleContent',\n  setup(_, { slots }) {\n    const ctx = useCollapsibleContext()\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    }, ctx.api.value.isContentMounted(ctx.visible.value) ? slots.default?.() : undefined)\n  },\n})\n"],"mappings":";;;;;;AAmBA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,UAAU;EACV,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,KAAK,EAAE,MAAM,OAA8B;EAC3C,WAAW;EACX,eAAe;CACjB;CAEA,OAAO;EACL,gBAAgB,aAA0D;EAC1E,gBAAgB,UAA+D;CACjF;CACA,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA4C,YAAY;GAC5D,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,eAAe,OAA2B,MAAM;EAC5D,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;;AAGD,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,eAAe,GAA8B,MAAM,UAAU,CAAC;CACpG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CAEN,cAAc;CACd,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,OAAO,SAAS;EAC7B,MAAM,MAAM,sBAAsB;EAClC,aAAa;GACX,MAAM,OAAO,eAAe,IAAI,IAAI,MAAM,gBAAgB,GAA8B,KAAK;GAC7F,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,MAAM,aAAa;IAC3D,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,MAAM,QAAQ;EACnC;CACF;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,kBAAkB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,OAAO;GACpB,GAAG,IAAI,IAAI,MAAM,gBAAgB;GAGjC,OAAO,IAAI,QAAQ,QAAQ,KAAA,IAAY,EAAE,SAAS,OAAO;GACzD,MAAM,OAAgB;IAAE,IAAI,WAAW,QAAQ;GAAkB;EACnE,GAAG,IAAI,IAAI,MAAM,iBAAiB,IAAI,QAAQ,KAAK,IAAI,MAAM,UAAU,IAAI,KAAA,CAAS;CACtF;AACF,CAAC"}

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

@@ -13,7 +13,7 @@ declare const XhColorFieldRoot: import("vue").DefineComponent<import("vue").Extr
   defaultValue: {
     type: StringConstructor;
   };
-  /** 值串的写法：hex / rgba / hsla，默认 hex。 */
+  /** 值串的写法：hex / rgba / hsla / oklch，默认 hex。 */
   format: {
     type: PropType<ColorFormat>;
   };
@@ -60,6 +60,7 @@ declare const XhColorFieldRoot: import("vue").DefineComponent<import("vue").Extr
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  clear: () => true;
   'value-change': (_details: PayloadOf<ColorFieldProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<ColorFieldProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -70,7 +71,7 @@ declare const XhColorFieldRoot: import("vue").DefineComponent<import("vue").Extr
   defaultValue: {
     type: StringConstructor;
   };
-  /** 值串的写法：hex / rgba / hsla，默认 hex。 */
+  /** 值串的写法：hex / rgba / hsla / oklch，默认 hex。 */
   format: {
     type: PropType<ColorFormat>;
   };
@@ -117,6 +118,7 @@ declare const XhColorFieldRoot: import("vue").DefineComponent<import("vue").Extr
 }>> & Readonly<{
   "onValue-change"?: ((_details: import("@xihan-ui/headless").ColorFieldValueChangeDetails) => any) | undefined;
   "onUpdate:value"?: ((_value: string) => any) | undefined;
+  onClear?: (() => any) | undefined;
 }>, {
   required: boolean;
   invalid: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"color-field.d.ts","names":[],"sources":["../../../src/components/color-field/color-field.ts"],"mappings":";;;;;KAkBK,kBAAkB;KAEX,0BAA0B,KACpC;cAIW,gCAAgB,8BAAA;;;;;;;;;;IAOC,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;EAId,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;IAlBT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;EAQ/B,WAAC,OAAO,4BAA4B;kCAsBhD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAa5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"color-field.d.ts","names":[],"sources":["../../../src/components/color-field/color-field.ts"],"mappings":";;;;;KAmBK,kBAAkB;KAEX,0BAA0B,KACpC;cAIW,gCAAgB,8BAAA;;;;;;;;;;IAOC,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;EAKd,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;IAnBT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS;;;;;;;;;;;;;;EAS/B,WAAC,OAAO,4BAA4B;kCAsBhD;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAO5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAO9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAa5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,4 +1,5 @@
 import { withXhConfig } from "../../config/config.js";
+import { withHandlers } from "../../runtime/with-handlers.js";
 import { useFormControlProps } from "../form/use-form-control.js";
 import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideColorField, useColorFieldContext } from "./context.js";
@@ -11,7 +12,7 @@ const XhColorFieldRoot = defineComponent({
 		/** 颜色串；缺席即非受控。空串表示没有颜色。 */
 		value: { type: String },
 		defaultValue: { type: String },
-		/** 值串的写法：hex / rgba / hsla，默认 hex。 */
+		/** 值串的写法：hex / rgba / hsla / oklch，默认 hex。 */
 		format: { type: String },
 		/** 带透明度，默认关闭。 */
 		alpha: {
@@ -43,6 +44,7 @@ const XhColorFieldRoot = defineComponent({
 		translations: { type: Object }
 	},
 	emits: {
+		"clear": () => true,
 		"value-change": (_details) => true,
 		"update:value": (_value) => true
 	},
@@ -52,7 +54,7 @@ const XhColorFieldRoot = defineComponent({
 			emit("value-change", details);
 			emit("update:value", details.value);
 		};
-		const ctx = useColorField(withXhConfig("color-field", useFormControlProps(props)), notify);
+		const ctx = useColorField(withHandlers(withXhConfig("color-field", useFormControlProps(props)), { onClear: () => emit("clear") }), notify);
 		provideColorField(ctx);
 		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
 			value: ctx.api.value.value,

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

@@ -1 +1 @@
-{"version":3,"file":"color-field.js","names":[],"sources":["../../../src/components/color-field/color-field.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 field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { ColorFieldApi, ColorFieldSchema, ColorFormat } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideColorField, useColorFieldContext } from './context'\nimport { useColorField } from './use-color-field'\n\ntype ColorFieldProps = ColorFieldSchema['props']\n\nexport type ColorFieldRootSlotProps = Pick<\n  ColorFieldApi,\n  'value' | 'empty' | 'text' | 'editing' | 'valid' | 'invalid' | 'canClear' | 'setValue' | 'clear' | 'commit'\n>\n\nexport const XhColorFieldRoot = defineComponent({\n  name: 'XhColorFieldRoot',\n  props: {\n    /** 颜色串；缺席即非受控。空串表示没有颜色。 */\n    value: { type: String },\n    defaultValue: { type: String },\n    /** 值串的写法：hex / rgba / hsla，默认 hex。 */\n    format: { type: String as PropType<ColorFormat> },\n    /** 带透明度，默认关闭。 */\n    alpha: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    clearable: Boolean,\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<ColorFieldProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'value-change': (_details: PayloadOf<ColorFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ColorFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ColorFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: ColorFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useColorField(withXhConfig('color-field', useFormControlProps(props)) as ColorFieldProps, notify)\n    provideColorField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      empty: ctx.api.value.empty,\n      text: ctx.api.value.text,\n      editing: ctx.api.value.editing,\n      valid: ctx.api.value.valid,\n      invalid: ctx.api.value.invalid,\n      canClear: ctx.api.value.canClear,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n      commit: ctx.api.value.commit,\n    }))\n  },\n})\n\nexport const XhColorFieldLabel = defineComponent({\n  name: 'XhColorFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useColorFieldContext()\n    // 必须是原生 <label>，connect 把 for 写向 input\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorFieldControl = defineComponent({\n  name: 'XhColorFieldControl',\n  setup(_, { slots }) {\n    const ctx = useColorFieldContext()\n    // 视觉盒：色块、输入框与清空按钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 当前颜色的色块：色块面家族绘制棋盘格与描边，颜色由连接层写入私有槽。 */\nexport const XhColorFieldSwatch = defineComponent({\n  name: 'XhColorFieldSwatch',\n  setup() {\n    const ctx = useColorFieldContext()\n    return () => h('span', ctx.api.value.getSwatchProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhColorFieldInput = defineComponent({\n  name: 'XhColorFieldInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useColorFieldContext()\n    return () => h('input', fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps() as Record<string, unknown>,\n    }))\n  },\n})\n\nexport const XhColorFieldClearTrigger = defineComponent({\n  name: 'XhColorFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorFieldContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorFieldHiddenInput = defineComponent({\n  name: 'XhColorFieldHiddenInput',\n  setup() {\n    const ctx = useColorFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":";;;;;;;AAyBA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;;EAEL,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,OAAO;;EAE7B,QAAQ,EAAE,MAAM,OAAgC;;EAEhD,OAAO;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC3C,aAAa,EAAE,MAAM,OAAO;EAC5B,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,MAAM,EAAE,MAAM,OAAO;EACrB,WAAW;EACX,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAoD;CAC5E;CAEA,OAAO;EACL,iBAAiB,aAA0D;EAC3E,iBAAiB,WAAiE;CACpF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA4C,YAAY;GAC5D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,MAAM,cAAc,aAAa,eAAe,oBAAoB,KAAK,CAAC,GAAsB,MAAM;EAC5G,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,OAAO,IAAI,IAAI,MAAM;GACrB,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;GACvB,OAAO,IAAI,IAAI,MAAM;GACrB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,OAAO,IAAI,IAAI,MAAM;GACrB,QAAQ,IAAI,IAAI,MAAM;EACxB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,eAAe,CAA4B;CAClF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,QAAQ;EAEN,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EACvC,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,SAAS,WAAW,MAAM;GACvC,GAAG,YAAY;GACf,GAAG,IAAI,IAAI,MAAM,cAAc;EACjC,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,oBAAoB,CAA4B;CACxF;AACF,CAAC"}
+{"version":3,"file":"color-field.js","names":[],"sources":["../../../src/components/color-field/color-field.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 field 相关实现。\n\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/core'\nimport type { ColorFieldApi, ColorFieldSchema, ColorFormat } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { withHandlers } from '../../runtime/with-handlers'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport { provideColorField, useColorFieldContext } from './context'\nimport { useColorField } from './use-color-field'\n\ntype ColorFieldProps = ColorFieldSchema['props']\n\nexport type ColorFieldRootSlotProps = Pick<\n  ColorFieldApi,\n  'value' | 'empty' | 'text' | 'editing' | 'valid' | 'invalid' | 'canClear' | 'setValue' | 'clear' | 'commit'\n>\n\nexport const XhColorFieldRoot = defineComponent({\n  name: 'XhColorFieldRoot',\n  props: {\n    /** 颜色串；缺席即非受控。空串表示没有颜色。 */\n    value: { type: String },\n    defaultValue: { type: String },\n    /** 值串的写法：hex / rgba / hsla / oklch，默认 hex。 */\n    format: { type: String as PropType<ColorFormat> },\n    /** 带透明度，默认关闭。 */\n    alpha: { type: Boolean, default: undefined },\n    placeholder: { type: String },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    clearable: Boolean,\n    variant: { type: String as PropType<ControlVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<ColorFieldProps['translations']> },\n  },\n  // value-change 携带 { value }，update:value 携带裸串\n  emits: {\n    'clear': () => true,\n    'value-change': (_details: PayloadOf<ColorFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<ColorFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ColorFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: ColorFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useColorField(withHandlers(withXhConfig('color-field', useFormControlProps(props)), { onClear: () => emit('clear') }) as ColorFieldProps, notify)\n    provideColorField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      empty: ctx.api.value.empty,\n      text: ctx.api.value.text,\n      editing: ctx.api.value.editing,\n      valid: ctx.api.value.valid,\n      invalid: ctx.api.value.invalid,\n      canClear: ctx.api.value.canClear,\n      setValue: ctx.api.value.setValue,\n      clear: ctx.api.value.clear,\n      commit: ctx.api.value.commit,\n    }))\n  },\n})\n\nexport const XhColorFieldLabel = defineComponent({\n  name: 'XhColorFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useColorFieldContext()\n    // 必须是原生 <label>，connect 把 for 写向 input\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorFieldControl = defineComponent({\n  name: 'XhColorFieldControl',\n  setup(_, { slots }) {\n    const ctx = useColorFieldContext()\n    // 视觉盒：色块、输入框与清空按钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 当前颜色的色块：色块面家族绘制棋盘格与描边，颜色由连接层写入私有槽。 */\nexport const XhColorFieldSwatch = defineComponent({\n  name: 'XhColorFieldSwatch',\n  setup() {\n    const ctx = useColorFieldContext()\n    return () => h('span', ctx.api.value.getSwatchProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhColorFieldInput = defineComponent({\n  name: 'XhColorFieldInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useColorFieldContext()\n    return () => h('input', fieldLabel.value({\n      ...fieldWiring.value,\n      ...ctx.api.value.getInputProps() as Record<string, unknown>,\n    }))\n  },\n})\n\nexport const XhColorFieldClearTrigger = defineComponent({\n  name: 'XhColorFieldClearTrigger',\n  setup(_, { slots }) {\n    const ctx = useColorFieldContext()\n    return () => h('button', ctx.api.value.getClearTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhColorFieldHiddenInput = defineComponent({\n  name: 'XhColorFieldHiddenInput',\n  setup() {\n    const ctx = useColorFieldContext()\n    return () => h('input', ctx.api.value.getHiddenInputProps() as Record<string, unknown>)\n  },\n})\n"],"mappings":";;;;;;;;AA0BA,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,OAAO;;EAEL,OAAO,EAAE,MAAM,OAAO;EACtB,cAAc,EAAE,MAAM,OAAO;;EAE7B,QAAQ,EAAE,MAAM,OAAgC;;EAEhD,OAAO;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC3C,aAAa,EAAE,MAAM,OAAO;EAC5B,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC7C,MAAM,EAAE,MAAM,OAAO;EACrB,WAAW;EACX,SAAS,EAAE,MAAM,OAAmC;EACpD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAoD;CAC5E;CAEA,OAAO;EACL,eAAe;EACf,iBAAiB,aAA0D;EAC3E,iBAAiB,WAAiE;CACpF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA4C,YAAY;GAC5D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,MAAM,cAAc,aAAa,aAAa,eAAe,oBAAoB,KAAK,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,EAAE,CAAC,GAAsB,MAAM;EAC5J,kBAAkB,GAAG;EACrB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,OAAO,IAAI,IAAI,MAAM;GACrB,MAAM,IAAI,IAAI,MAAM;GACpB,SAAS,IAAI,IAAI,MAAM;GACvB,OAAO,IAAI,IAAI,MAAM;GACrB,SAAS,IAAI,IAAI,MAAM;GACvB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,OAAO,IAAI,IAAI,MAAM;GACrB,QAAQ,IAAI,IAAI,MAAM;EACxB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EAEjC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,QAAQ,IAAI,IAAI,MAAM,eAAe,CAA4B;CAClF;AACF,CAAC;AAED,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,QAAQ;EAEN,MAAM,cAAc,oBAAoB;EAExC,MAAM,aAAa,oBAAoB;EACvC,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,SAAS,WAAW,MAAM;GACvC,GAAG,YAAY;GACf,GAAG,IAAI,IAAI,MAAM,cAAc;EACjC,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,2BAA2B,gBAAgB;CACtD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC;AAED,MAAa,0BAA0B,gBAAgB;CACrD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,qBAAqB;EACjC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,oBAAoB,CAA4B;CACxF;AACF,CAAC"}

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

@@ -1,17 +1,30 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { Direction, Placement, Size } from "@xihan-ui/core";
-import { ColorFormat, ColorPickerApi, ColorPickerInputChannel, ColorPickerSchema, ColorPickerTranslations } from "@xihan-ui/headless";
+import { ControlVariant, Direction, Placement, Size } from "@xihan-ui/core";
+import { ColorFormat, ColorPickerApi, ColorPickerInputChannel, ColorPickerSchema, ColorPickerSelectionMode, ColorPickerTranslations } from "@xihan-ui/headless";
 //#region src/components/color-picker/color-picker.d.ts
 type ColorPickerProps = ColorPickerSchema['props'];
 /** 默认插槽的载荷：展开态、当前颜色的各种表示、预设色板、屏幕取色状态，以及修改展开与修改值两个动作。 */
-type ColorPickerRootSlotProps = Pick<ColorPickerApi, 'open' | 'value' | 'rgba' | 'hsva' | 'swatches' | 'picking' | 'eyeDropperSupported' | 'errors' | 'setOpen' | 'setValue' | 'clearError'>;
+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<{
+  /** 选中的颜色，值串数组；单选可写裸串。 */
   value: {
-    type: StringConstructor;
+    type: PropType<string | string[]>;
   };
   defaultValue: {
-    type: StringConstructor;
+    type: PropType<string | string[]>;
+  };
+  /** 选择模式，默认 single；multiple 时工作色是草稿、按「添加」收进值，色块点一下切换，输入行里排成标签。 */
+  selectionMode: {
+    type: PropType<ColorPickerSelectionMode>;
+  };
+  /** multiple 下最多选几个颜色。 */
+  maxSelected: {
+    type: NumberConstructor;
+  };
+  /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */
+  maxTagCount: {
+    type: NumberConstructor;
   };
   format: {
     type: PropType<ColorFormat>;
@@ -33,12 +46,25 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
   swatches: {
     type: PropType<string[]>;
   };
+  inline: BooleanConstructor;
+  recentColors: {
+    type: PropType<string[]>;
+  };
+  defaultRecentColors: {
+    type: PropType<string[]>;
+  };
+  maxRecentColors: {
+    type: NumberConstructor;
+  };
   name: {
     type: StringConstructor;
   };
   size: {
     type: PropType<Size>;
   };
+  variant: {
+    type: PropType<ControlVariant>;
+  };
   dir: {
     type: PropType<Direction>;
   };
@@ -59,12 +85,27 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
   'color-error': (_details: PayloadOf<ColorPickerProps, "onColorError">) => true;
   'update:value': (_value: PayloadOf<ColorPickerProps, "onValueChange">["value"]) => true;
   'update:open': (_open: PayloadOf<ColorPickerProps, "onOpenChange">["open"]) => true;
+  'recent-colors-change': (_details: PayloadOf<ColorPickerProps, "onRecentColorsChange">) => true;
+  'update:recentColors': (_recentColors: PayloadOf<ColorPickerProps, "onRecentColorsChange">["recentColors"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 选中的颜色，值串数组；单选可写裸串。 */
   value: {
-    type: StringConstructor;
+    type: PropType<string | string[]>;
   };
   defaultValue: {
-    type: StringConstructor;
+    type: PropType<string | string[]>;
+  };
+  /** 选择模式，默认 single；multiple 时工作色是草稿、按「添加」收进值，色块点一下切换，输入行里排成标签。 */
+  selectionMode: {
+    type: PropType<ColorPickerSelectionMode>;
+  };
+  /** multiple 下最多选几个颜色。 */
+  maxSelected: {
+    type: NumberConstructor;
+  };
+  /** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */
+  maxTagCount: {
+    type: NumberConstructor;
   };
   format: {
     type: PropType<ColorFormat>;
@@ -86,12 +127,25 @@ declare const XhColorPickerRoot: import("vue").DefineComponent<import("vue").Ext
   swatches: {
     type: PropType<string[]>;
   };
+  inline: BooleanConstructor;
+  recentColors: {
+    type: PropType<string[]>;
+  };
+  defaultRecentColors: {
+    type: PropType<string[]>;
+  };
+  maxRecentColors: {
+    type: NumberConstructor;
+  };
   name: {
     type: StringConstructor;
   };
   size: {
     type: PropType<Size>;
   };
+  variant: {
+    type: PropType<ControlVariant>;
+  };
   dir: {
     type: PropType<Direction>;
   };
@@ -106,15 +160,18 @@ 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;
+  "onUpdate:value"?: ((_value: string[]) => 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;
 }>, {
   disabled: boolean;
   open: boolean;
   defaultOpen: boolean;
   readOnly: boolean;
+  inline: boolean;
   alpha: boolean;
 }, SlotsType<{
   default?: (props: ColorPickerRootSlotProps) => VNode[];
@@ -192,9 +249,57 @@ declare const XhColorPickerEyeDropperTrigger: import("vue").DefineComponent<{},
 declare const XhColorPickerSwatchPicker: 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 XhColorPickerHiddenInput: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/**
+ * 最近使用色的挂载点，与预设色板同一套：其中放置的是 XhColorSwatchPickerItem。
+ * 未写默认插槽时按 recentColors 自动铺开格子；还没有最近使用色时挂载点收起。
+ */
+declare const XhColorPickerRecentSwatchPicker: 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>;
+/** 标签文字所在的块（tag 的 label）。 */
+declare const XhColorPickerTagLabel: 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>;
+/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的颜色，焦点不动。 */
+declare const XhColorPickerItemDeleteTrigger: 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>;
+/** 多选时一个选中颜色一个标签，即库内 tag 的 root（data-scope="tag"），标签前由皮肤画一个色点。 */
+declare const XhColorPickerTag: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 它代表哪个选中颜色。 */
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 它代表哪个选中颜色。 */
+  value: {
+    type: StringConstructor;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** 折叠的标签合成的一个标签：有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */
+declare const XhColorPickerOverflowTag: 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>;
+/**
+ * 标签行：多选时放在盒里、触发钮之前；单选时连接层给 hidden。
+ * 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。
+ */
+declare const XhColorPickerTagList: 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>;
+/** 「添加」：多选时把工作色收进值，浮层不收；单选时连接层给 hidden。文字由作者写。 */
+declare const XhColorPickerConfirmTrigger: 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 XhColorPickerHiddenInput: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}> | 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 { ColorPickerRootSlotProps, XhColorPickerAlphaSlider, XhColorPickerAreaThumb, XhColorPickerChannelInput, XhColorPickerContent, XhColorPickerControl, XhColorPickerEyeDropperTrigger, XhColorPickerHiddenInput, XhColorPickerHueSlider, XhColorPickerLabel, XhColorPickerPositioner, XhColorPickerRoot, XhColorPickerSaturationArea, XhColorPickerSwatch, XhColorPickerSwatchPicker, XhColorPickerTrigger, XhColorPickerValueText };
+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 };
 //# 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":";;;;;KA8BK,mBAAmB;;KAGZ,2BAA2B,KACrC;cAIW,iCAAiB,8BAAA;;;;;;;;IAMA,MAAA,SAAS;;;;;;;;;;;;;;;;;IAMR,MAAA;;;;;;IAEH,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACH,MAAA,SAAS;;;;;;IAEN,MAAA,SAAS,QAAQ;;;;;EAItB,iBAAA,UAAA,UAAU;EACX,gBAAA,UAAA,UAAU;EACV,gBAAA,UAAA,UAAU;EACX,iBAAA,QAAA,UAAU;EACZ,gBAAA,OAAA,UAAU;;;;;;;;;IApBP,MAAA,SAAS;;;;;;;;;;;;;;;;;IAMR,MAAA;;;;;;IAEH,MAAA,SAAS;;;IACV,MAAA,SAAS;;;IACH,MAAA,SAAS;;;;;;IAEN,MAAA,SAAS,QAAQ;;;;;;;;;;;;;;;EAWvC,WAAC,OAAO,6BAA6B;kCAgCjD;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAU/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAWjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,8BAAA;;;IAIH,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgBxC,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAY/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,2CAA2B,0BAAA,oBAAA,4BAAA;;8BAUtC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAMjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAOnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAOW,yCAAyB,8BAAA;;;IAIP,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAQtC,oDAAA;cAEW,8CAA8B,0BAAA,oBAAA,4BAAA;;8BAMzC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;cAOW,yCAAyB,0BAAA,oBAAA,4BAAA;;8BAWpC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,wCAAwB,0BAAA,oBAAA,4BAAA;;8BAMnC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"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,12 +1,13 @@
 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 { 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, useColorPickerContext } from "./context.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";
@@ -14,8 +15,15 @@ import { colorPickerToInputChannel } from "@xihan-ui/headless";
 const XhColorPickerRoot = defineComponent({
 	name: "XhColorPickerRoot",
 	props: {
-		value: { type: String },
-		defaultValue: { type: String },
+		/** 选中的颜色，值串数组；单选可写裸串。 */
+		value: { type: [String, Array] },
+		defaultValue: { type: [String, Array] },
+		/** 选择模式，默认 single；multiple 时工作色是草稿、按「添加」收进值，色块点一下切换，输入行里排成标签。 */
+		selectionMode: { type: String },
+		/** multiple 下最多选几个颜色。 */
+		maxSelected: { type: Number },
+		/** 多选时输入行最多摆几枚标签，其余折进 +N 那一枚；默认 3。 */
+		maxTagCount: { type: Number },
 		format: { type: String },
 		open: {
 			type: Boolean,
@@ -32,8 +40,13 @@ const XhColorPickerRoot = defineComponent({
 		},
 		alpha: Boolean,
 		swatches: { type: Array },
+		inline: Boolean,
+		recentColors: { type: Array },
+		defaultRecentColors: { type: Array },
+		maxRecentColors: { type: Number },
 		name: { type: String },
 		size: { type: String },
+		variant: { type: String },
 		dir: { type: String },
 		placement: { type: String },
 		offset: { type: Number },
@@ -44,7 +57,9 @@ const XhColorPickerRoot = defineComponent({
 		"open-change": (_details) => true,
 		"color-error": (_details) => true,
 		"update:value": (_value) => true,
-		"update:open": (_open) => true
+		"update:open": (_open) => true,
+		"recent-colors-change": (_details) => true,
+		"update:recentColors": (_recentColors) => true
 	},
 	slots: Object,
 	setup(props, { slots, emit }) {
@@ -57,24 +72,34 @@ const XhColorPickerRoot = defineComponent({
 			emit("update:open", details.open);
 		};
 		const notifyColorError = (details) => emit("color-error", details);
+		const notifyRecent = (details) => {
+			emit("recent-colors-change", details);
+			emit("update:recentColors", details.recentColors);
+		};
 		const ctx = useColorPicker(withXhConfig("color-picker", useFormControlProps(props)), {
 			onValueChange: notifyValue,
 			onOpenChange: notifyOpen,
-			onColorError: notifyColorError
+			onColorError: notifyColorError,
+			onRecentColorsChange: notifyRecent
 		});
 		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,
-			clearError: ctx.api.value.clearError
+			add: ctx.api.value.add,
+			clearError: ctx.api.value.clearError,
+			clearRecentColors: ctx.api.value.clearRecentColors
 		}));
 	}
 });
@@ -108,7 +133,7 @@ const XhColorPickerValueText = defineComponent({
 	name: "XhColorPickerValueText",
 	setup(_, { slots }) {
 		const ctx = useColorPickerContext();
-		return () => h("span", ctx.api.value.getValueTextProps(), slots.default?.() ?? ctx.api.value.value);
+		return () => h("span", ctx.api.value.getValueTextProps(), slots.default?.() ?? ctx.api.value.color);
 	}
 });
 const XhColorPickerSwatch = defineComponent({
@@ -233,14 +258,99 @@ const XhColorPickerSwatchPicker = defineComponent({
 		})));
 	}
 });
+/**
+* 最近使用色的挂载点，与预设色板同一套：其中放置的是 XhColorSwatchPickerItem。
+* 未写默认插槽时按 recentColors 自动铺开格子；还没有最近使用色时挂载点收起。
+*/
+const XhColorPickerRecentSwatchPicker = defineComponent({
+	name: "XhColorPickerRecentSwatchPicker",
+	setup(_, { slots }) {
+		const ctx = useColorPickerContext();
+		provideColorSwatchPicker(ctx.recentSwatchPicker);
+		return () => h("div", ctx.api.value.getRecentSwatchPickerProps(), slots.default?.() ?? ctx.api.value.recentSwatchPicker.swatches.map((node) => h(XhColorSwatchPickerItem, {
+			key: node.value,
+			value: node.value
+		})));
+	}
+});
+/** 标签文字所在的块（tag 的 label）。 */
+const XhColorPickerTagLabel = defineComponent({
+	name: "XhColorPickerTagLabel",
+	setup(_, { slots }) {
+		const ctx = useColorPickerContext();
+		return () => h("span", ctx.api.value.getTagLabelProps(), slots.default?.());
+	}
+});
+/** 标签内容：只有文字时替它包一层 label；作者自己写了节点则原样放行。库自身填入的文字（+N）恒包 label。 */
+function tagChildren(content) {
+	if (typeof content === "string") return [h(XhColorPickerTagLabel, null, () => content)];
+	return slotIsPlainText(content) ? [h(XhColorPickerTagLabel, null, () => content)] : content;
+}
+/** 标签中的删除按钮：即所在标签那份 tag 的 close-trigger，可及名使用 translations.deleteItem；点按摘掉所在标签的颜色，焦点不动。 */
+const XhColorPickerItemDeleteTrigger = defineComponent({
+	name: "XhColorPickerItemDeleteTrigger",
+	setup(_, { slots }) {
+		const ctx = useColorPickerContext();
+		const tag = useColorPickerTagContext();
+		return () => h("button", ctx.api.value.getItemDeleteTriggerProps({ value: tag.value() }), slots.default?.());
+	}
+});
+/** 多选时一个选中颜色一个标签，即库内 tag 的 root（data-scope="tag"），标签前由皮肤画一个色点。 */
+const XhColorPickerTag = defineComponent({
+	name: "XhColorPickerTag",
+	props: { 
+	/** 它代表哪个选中颜色。 */
+value: {
+		type: String,
+		required: true
+	} },
+	setup(props, { slots }) {
+		const ctx = useColorPickerContext();
+		provideColorPickerTag({ value: () => props.value });
+		return () => h("span", ctx.api.value.getTagProps({ value: props.value }), tagChildren(slots.default?.()));
+	}
+});
+/** 折叠的标签合成的一个标签：有插槽时使用插槽，否则显示 +N。没有折叠的标签时连接层写 hidden。 */
+const XhColorPickerOverflowTag = defineComponent({
+	name: "XhColorPickerOverflowTag",
+	setup(_, { slots }) {
+		const ctx = useColorPickerContext();
+		return () => h("span", ctx.api.value.getOverflowTagProps(), tagChildren(slots.default?.() ?? ctx.api.value.overflowText));
+	}
+});
+/**
+* 标签行：多选时放在盒里、触发钮之前；单选时连接层给 hidden。
+* 不写插槽即按 tags 铺出带删除钮的标签与 +N 那一枚，写了插槽由作者自己铺。
+*/
+const XhColorPickerTagList = defineComponent({
+	name: "XhColorPickerTagList",
+	setup(_, { slots }) {
+		const ctx = useColorPickerContext();
+		return () => h("span", ctx.api.value.getTagListProps(), slots.default ? slots.default() : [...ctx.api.value.tags.map((tag) => h(XhColorPickerTag, {
+			key: tag.value,
+			value: tag.value
+		}, () => [h(XhColorPickerTagLabel, null, () => tag.label), h(XhColorPickerItemDeleteTrigger)])), h(XhColorPickerOverflowTag)]);
+	}
+});
+/** 「添加」：多选时把工作色收进值，浮层不收；单选时连接层给 hidden。文字由作者写。 */
+const XhColorPickerConfirmTrigger = defineComponent({
+	name: "XhColorPickerConfirmTrigger",
+	setup(_, { slots }) {
+		const ctx = useColorPickerContext();
+		return () => h("button", ctx.api.value.getConfirmTriggerProps(), slots.default?.());
+	}
+});
 const XhColorPickerHiddenInput = defineComponent({
 	name: "XhColorPickerHiddenInput",
 	setup() {
 		const ctx = useColorPickerContext();
-		return () => h("input", ctx.api.value.getHiddenInputProps());
+		return () => ctx.api.value.selectionMode === "multiple" ? ctx.api.value.value.map((value) => h("input", {
+			key: value,
+			...ctx.api.value.getHiddenInputProps({ value })
+		})) : h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
 //#endregion
-export { XhColorPickerAlphaSlider, XhColorPickerAreaThumb, XhColorPickerChannelInput, XhColorPickerContent, XhColorPickerControl, XhColorPickerEyeDropperTrigger, XhColorPickerHiddenInput, XhColorPickerHueSlider, XhColorPickerLabel, XhColorPickerPositioner, XhColorPickerRoot, XhColorPickerSaturationArea, XhColorPickerSwatch, XhColorPickerSwatchPicker, XhColorPickerTrigger, XhColorPickerValueText };
+export { XhColorPickerAlphaSlider, XhColorPickerAreaThumb, XhColorPickerChannelInput, 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