@xihan-ui/vue 4.2.0 → 5.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"checkbox-group.js","names":[],"sources":["../../../src/components/checkbox-group/checkbox-group.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 checkbox group 相关实现。\n\nimport type { Orientation, Size, Tone } from '@xihan-ui/core'\nimport type {\n  CheckboxGroupApi,\n  CheckboxGroupItemProps,\n  CheckboxGroupNode,\n  CheckboxGroupNodeMeta,\n  CheckboxGroupSchema,\n  CheckboxGroupVariant,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { computed, defineComponent, h, onBeforeUnmount, onMounted } from 'vue'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideCheckboxGroup,\n  provideCheckboxGroupItem,\n  useCheckboxGroupContext,\n  useCheckboxGroupItemContext,\n} from './context'\nimport { useCheckboxGroup } from './use-checkbox-group'\n\ntype CheckboxGroupProps = CheckboxGroupSchema['props']\n\n/** 默认插槽的载荷：整组的选中集合与全选态，以及整体替换与翻转单值的方法。 */\nexport type CheckboxGroupRootSlotProps = Pick<\n  CheckboxGroupApi,\n  'value' | 'checkedState' | 'atMax' | 'atMin' | 'isChecked' | 'setValue' | 'toggleValue'\n>\n\nexport const XhCheckboxGroupRoot = defineComponent({\n  name: 'XhCheckboxGroupRoot',\n  props: {\n    collection: { type: Array as PropType<CheckboxGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    itemValues: { type: Array as PropType<string[]> },\n    min: { type: Number },\n    max: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    name: { type: String },\n    orientation: { type: String as PropType<Orientation> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<CheckboxGroupVariant> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<CheckboxGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<CheckboxGroupProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CheckboxGroupRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (props: CheckboxGroupNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: CheckboxGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useCheckboxGroup(useFormControlProps(props) as CheckboxGroupProps, notify)\n    provideCheckboxGroup(ctx)\n    // 放进表单字段时，字段的标题与说明接到组上：读屏进组时念组名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => {\n      // 标题文字不论手写选项还是数据驱动都由根铺出：手写选项时不必再写 label 部件\n      const title = slots.label?.() ?? (props.label != null ? [props.label] : null)\n      return h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }), slots.default\n        ? [...renderLabel(title), ...slots.default({\n            value: ctx.api.value.value,\n            checkedState: ctx.api.value.checkedState,\n            atMax: ctx.api.value.atMax,\n            atMin: ctx.api.value.atMin,\n            isChecked: ctx.api.value.isChecked,\n            setValue: ctx.api.value.setValue,\n            toggleValue: ctx.api.value.toggleValue,\n          })]\n        : props.collection\n          ? renderDefaultTree(ctx.api.value.collection, title, slots.item)\n          : renderLabel(title))\n    }\n  },\n})\n\nexport const XhCheckboxGroupLabel = defineComponent({\n  name: 'XhCheckboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    // 渲出来了才登记：根的 aria-labelledby 只在这个节点真在场时才指过来\n    onMounted(() => {\n      ctx.labelCount.value++\n    })\n    onBeforeUnmount(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItem = defineComponent({\n  name: 'XhCheckboxGroupItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const item = computed<CheckboxGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideCheckboxGroupItem({ item })\n    // 表单影子由条目自行装配，不暴露成独立组件，作者只写方框与文本\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\nexport const XhCheckboxGroupIndicator = defineComponent({\n  name: 'XhCheckboxGroupIndicator',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    // 插槽留给作者放对勾图形，方框本身对读屏隐藏\n    return () => h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItemText = defineComponent({\n  name: 'XhCheckboxGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItemDescription = defineComponent({\n  name: 'XhCheckboxGroupItemDescription',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupSelectAllTrigger = defineComponent({\n  name: 'XhCheckboxGroupSelectAllTrigger',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    // 与条目同形的 role=checkbox 节点，渲染为 div，Space 由 connect 接管\n    return () => h('div', ctx.api.value.getSelectAllTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/**\n * 未写默认插槽时按 collection 铺开的整套结构，作者只提供数据。\n * 与手写部件产出的 DOM 完全一致，需要修改结构时写默认插槽，行为不变。\n * 全选控件不在其中：它是可选部件，需要时写默认插槽。\n */\nfunction renderDefaultTree(\n  collection: readonly CheckboxGroupNodeMeta[],\n  label: (VNode | string)[] | null,\n  itemSlot?: (node: CheckboxGroupNodeMeta) => VNode[],\n): VNode[] {\n  return [\n    ...renderLabel(label),\n    ...collection.map(node =>\n      h(XhCheckboxGroupItem, { key: node.value, value: node.value }, () => [\n        h(XhCheckboxGroupIndicator),\n        h(XhCheckboxGroupItemText, null, () => itemSlot?.(node) ?? node.label),\n        ...(node.description != null ? [h(XhCheckboxGroupItemDescription, null, () => node.description)] : []),\n      ]),\n    ),\n  ]\n}\n\n/** 组标题：给了文字或 label 插槽才铺 label 部件。 */\nfunction renderLabel(title: (VNode | string)[] | null): VNode[] {\n  return title ? [h(XhCheckboxGroupLabel, null, () => title)] : []\n}\n"],"mappings":"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"}
+{"version":3,"file":"checkbox-group.js","names":[],"sources":["../../../src/components/checkbox-group/checkbox-group.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 checkbox group 相关实现。\n\nimport type { Orientation, Size, Tone } from '@xihan-ui/core'\nimport type {\n  CheckboxGroupApi,\n  CheckboxGroupItemProps,\n  CheckboxGroupNode,\n  CheckboxGroupNodeMeta,\n  CheckboxGroupSchema,\n  CheckboxGroupVariant,\n  StructureChild,\n} from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { checkboxGroupStructure } from '@xihan-ui/headless'\nimport { computed, defineComponent, h, onUnmounted } from 'vue'\nimport { renderStructure } from '../../runtime/structure'\nimport { useFieldGroupWiring, useFieldLabelWiring } from '../field/use-field-control'\nimport { useFormControlProps } from '../form/use-form-control'\nimport {\n  provideCheckboxGroup,\n  provideCheckboxGroupItem,\n  useCheckboxGroupContext,\n  useCheckboxGroupItemContext,\n} from './context'\nimport { useCheckboxGroup } from './use-checkbox-group'\n\ntype CheckboxGroupProps = CheckboxGroupSchema['props']\n\n/** 默认插槽的载荷：整组的选中集合与全选态，以及整体替换与翻转单值的方法。 */\nexport type CheckboxGroupRootSlotProps = Pick<\n  CheckboxGroupApi,\n  'value' | 'checkedState' | 'atMax' | 'atMin' | 'isChecked' | 'setValue' | 'toggleValue'\n>\n\nexport const XhCheckboxGroupRoot = defineComponent({\n  name: 'XhCheckboxGroupRoot',\n  props: {\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\n    collection: { type: Array as PropType<CheckboxGroupNode[]> },\n    /** 标题文字。提供后不必再写 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    // 缺席值 undefined 表示非受控\n    value: { type: Array as PropType<string[]> },\n    defaultValue: { type: Array as PropType<string[]> },\n    itemValues: { type: Array as PropType<string[]> },\n    min: { type: Number },\n    max: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    name: { type: String },\n    orientation: { type: String as PropType<Orientation> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    variant: { type: String as PropType<CheckboxGroupVariant> },\n  },\n  // value-change 携带 { value }，update:value 携带裸数组\n  emits: {\n    'value-change': (_details: PayloadOf<CheckboxGroupProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<CheckboxGroupProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: CheckboxGroupRootSlotProps) => VNode[]\n    label?: () => VNode[]\n    item?: (props: CheckboxGroupNodeMeta) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: CheckboxGroupProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useCheckboxGroup(useFormControlProps(props) as CheckboxGroupProps, notify)\n    provideCheckboxGroup(ctx)\n    // 放进表单字段时，字段的标题与说明接到组上：读屏进组时念组名与说明\n    const fieldWiring = useFieldGroupWiring()\n    const fieldLabel = useFieldLabelWiring()\n    return () => {\n      // 标题文字不论手写选项还是数据驱动都由根铺出：手写选项时不必再写 label 部件\n      const title = slots.label?.() ?? (props.label != null ? [props.label] : null)\n      return h('div', fieldLabel.value({ ...fieldWiring.value, ...ctx.api.value.getRootProps() as Record<string, unknown> }), slots.default\n        ? [...renderLabel(title), ...slots.default({\n            value: ctx.api.value.value,\n            checkedState: ctx.api.value.checkedState,\n            atMax: ctx.api.value.atMax,\n            atMin: ctx.api.value.atMin,\n            isChecked: ctx.api.value.isChecked,\n            setValue: ctx.api.value.setValue,\n            toggleValue: ctx.api.value.toggleValue,\n          })]\n        : renderDefaultStructure(ctx.api.value, props.label, { label: slots.label, item: slots.item }))\n    }\n  },\n})\n\nexport const XhCheckboxGroupLabel = defineComponent({\n  name: 'XhCheckboxGroupLabel',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    // 渲出来就登记，在 setup 里同步做：排在条目之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    return () => h('span', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItem = defineComponent({\n  name: 'XhCheckboxGroupItem',\n  props: {\n    value: { type: String, required: true },\n    // 缺省交给 connect 回 collection 里查，写死 false 会盖掉数据里的禁用\n    disabled: { type: Boolean, default: undefined },\n  },\n  setup(props, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const item = computed<CheckboxGroupItemProps>(() => ({ value: props.value, disabled: props.disabled }))\n    provideCheckboxGroupItem({ item })\n    // 表单影子由条目自行装配，不暴露成独立组件，作者只写方框与文本\n    return () => h('div', ctx.api.value.getItemProps(item.value) as Record<string, unknown>, [\n      h('input', ctx.api.value.getHiddenInputProps(item.value) as Record<string, unknown>),\n      ...(slots.default?.() ?? []),\n    ])\n  },\n})\n\nexport const XhCheckboxGroupIndicator = defineComponent({\n  name: 'XhCheckboxGroupIndicator',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    // 插槽留给作者放对勾图形，方框本身对读屏隐藏\n    return () => h('span', ctx.api.value.getIndicatorProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItemText = defineComponent({\n  name: 'XhCheckboxGroupItemText',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    return () => h('span', ctx.api.value.getItemTextProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupItemDescription = defineComponent({\n  name: 'XhCheckboxGroupItemDescription',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    const { item } = useCheckboxGroupItemContext()\n    return () => h('span', ctx.api.value.getItemDescriptionProps(item.value) as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhCheckboxGroupSelectAllTrigger = defineComponent({\n  name: 'XhCheckboxGroupSelectAllTrigger',\n  setup(_, { slots }) {\n    const ctx = useCheckboxGroupContext()\n    // 与条目同形的 role=checkbox 节点，渲染为 div，Space 由 connect 接管\n    return () => h('div', ctx.api.value.getSelectAllTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 标准结构里各部件对应的组件；条目里的表单影子由 XhCheckboxGroupItem 自行装配，铺结构时去掉这一格。 */\nconst CHECKBOX_GROUP_PARTS = {\n  'label': XhCheckboxGroupLabel,\n  'item': XhCheckboxGroupItem,\n  'indicator': XhCheckboxGroupIndicator,\n  'item-text': XhCheckboxGroupItemText,\n  'item-description': XhCheckboxGroupItemDescription,\n}\n\nfunction withoutSelfAssembled(nodes: readonly StructureChild[]): StructureChild[] {\n  return nodes.flatMap((node): StructureChild[] => {\n    if (!('part' in node))\n      return [node]\n    if (node.part === 'hidden-input')\n      return []\n    return [node.children ? { ...node, children: withoutSelfAssembled(node.children) } : node]\n  })\n}\n\ninterface CheckboxGroupStructureSlots {\n  label?: () => VNode[]\n  item?: (node: CheckboxGroupNodeMeta) => VNode[]\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 checkboxGroupStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题与条目文字由对应插槽接管；全选控件要用时写默认插槽。\n */\nfunction renderDefaultStructure(api: CheckboxGroupApi, label: string | undefined, content: CheckboxGroupStructureSlots): VNode[] {\n  const nodes = checkboxGroupStructure(api, { label, slotted: name => content[name as keyof CheckboxGroupStructureSlots] != null })\n  return renderStructure(withoutSelfAssembled(nodes), CHECKBOX_GROUP_PARTS, (node) => {\n    switch (node.slot?.name) {\n      case 'label':\n        return content.label?.()\n      case 'item':\n        return content.item?.(node.data as CheckboxGroupNodeMeta) ?? (node.data as CheckboxGroupNodeMeta).label\n      default:\n        return undefined\n    }\n  })\n}\n\n/** 组标题：给了文字或 label 插槽才铺 label 部件。 */\nfunction renderLabel(title: (VNode | string)[] | null): VNode[] {\n  return title ? [h(XhCheckboxGroupLabel, null, () => title)] : []\n}\n"],"mappings":"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"}

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

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

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

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

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

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CitationPreviewMode, CitationSchema, CitationSource } from "@xihan-ui/headless";
 import { PropType, VNode } from "vue";
 import { Direction, Placement, Size } from "@xihan-ui/core";
-import { CitationPreviewMode, CitationSchema, CitationSource } from "@xihan-ui/headless";
 //#region src/components/citation/citation.d.ts
 type CitationProps = CitationSchema['props'];
 declare const XhCitationRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{

package/dist/components/citation/citation.js

@@ -3,8 +3,8 @@ import { XhPortal } from "../../runtime/portal.js";
 import { slotPaints } from "../../runtime/slot-content.js";
 import { provideCitation, provideCitationSource, useCitationContext, useCitationSource } from "./context.js";
 import { useCitation } from "./use-citation.js";
-import { computed, defineComponent, h, mergeProps } from "vue";
 import { citationSourceTitle } from "@xihan-ui/headless";
+import { computed, defineComponent, h, mergeProps } from "vue";
 //#region src/components/citation/citation.ts
 const XhCitationRoot = defineComponent({
 	name: "XhCitationRoot",

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

@@ -1,6 +1,6 @@
 import { CitationContext } from "./use-citation.js";
-import { ComputedRef } from "vue";
 import { CitationSourceItemProps } from "@xihan-ui/headless";
+import { ComputedRef } from "vue";
 //#region src/components/citation/context.d.ts
 declare function provideCitation(context: CitationContext): void;
 declare function useCitationContext(): CitationContext;

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

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

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

@@ -2,9 +2,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 { citationAnatomy, citationMachine, connectCitation } from "@xihan-ui/headless";
 import { computed, ref } from "vue";
 import { createRuntimeConfig, createScope } from "@xihan-ui/core";
-import { citationAnatomy, citationMachine, connectCitation } from "@xihan-ui/headless";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/citation/use-citation.ts
 const triggerSelector = citationAnatomy.build().trigger.selector;

package/dist/components/clipboard/clipboard.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { ClipboardApi, ClipboardSchema, ClipboardTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ActionVariant, Size, Tone } from "@xihan-ui/core";
-import { ClipboardApi, ClipboardSchema, ClipboardTranslations } from "@xihan-ui/headless";
 //#region src/components/clipboard/clipboard.d.ts
 type ClipboardProps = ClipboardSchema['props'];
 /** 默认插槽的载荷：复制状态、当前要复制的文本，以及执行一次复制的句柄。 */

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

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","names":[],"sources":["../../../src/components/clipboard/clipboard.ts"],"mappings":";;;;;KAgBK,iBAAiB;;KAGV,yBAAyB,KAAK;cAE7B,+BAAe,8BAAA;;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIrB,kBAAA,UAAA,UAAU;EACb,eAAA,UAAA,UAAU;;;;;;;;;;;;;IARR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;EAQvC,WAAC,OAAO,2BAA2B;kCAe/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAU5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,8BAAA;;;;;;;;;;qCAe/B"}
+{"version":3,"file":"clipboard.d.ts","names":[],"sources":["../../../src/components/clipboard/clipboard.ts"],"mappings":";;;;;KAgBK,iBAAiB;;KAGV,yBAAyB,KAAK;cAE7B,+BAAe,8BAAA;;;;;;;;;;;;IAOG,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;EAIrB,kBAAA,UAAA,UAAU;EACb,eAAA,UAAA,UAAU;;;;;;;;;;;;;IARR,MAAA,SAAS;;;IACZ,MAAA,SAAS;;;IACT,MAAA,SAAS;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;EAQvC,WAAC,OAAO,2BAA2B;kCAe/C;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAY3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAO3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAOjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;cAGW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAU5B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,8BAAA;;;;;;;;;;qCAe/B"}

package/dist/components/clipboard/clipboard.js

@@ -1,7 +1,7 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideClipboard, useClipboardContext } from "./context.js";
 import { useClipboard } from "./use-clipboard.js";
-import { defineComponent, h } from "vue";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/clipboard/clipboard.ts
 const XhClipboardRoot = defineComponent({
 	name: "XhClipboardRoot",
@@ -40,6 +40,10 @@ const XhClipboardLabel = defineComponent({
 	name: "XhClipboardLabel",
 	setup(_, { slots }) {
 		const ctx = useClipboardContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });

package/dist/components/clipboard/clipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.js","names":[],"sources":["../../../src/components/clipboard/clipboard.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// 提供 clipboard 相关实现。\n\nimport type { ActionVariant, Size, Tone } from '@xihan-ui/core'\nimport type { ClipboardApi, ClipboardSchema, ClipboardTranslations } 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 { provideClipboard, useClipboardContext } from './context'\nimport { useClipboard } from './use-clipboard'\n\ntype ClipboardProps = ClipboardSchema['props']\n\n/** 默认插槽的载荷：复制状态、当前要复制的文本，以及执行一次复制的句柄。 */\nexport type ClipboardRootSlotProps = Pick<ClipboardApi, 'status' | 'copied' | 'value' | 'copy'>\n\nexport const XhClipboardRoot = defineComponent({\n  name: 'XhClipboardRoot',\n  props: {\n    // 属性缺席即没给要复制的文本，落回空串\n    value: { type: String },\n    timeout: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ActionVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<ClipboardTranslations>> },\n  },\n  // status-change 携带 { status }；copy-error 携带 { error, value }\n  emits: {\n    'status-change': (_details: PayloadOf<ClipboardProps, 'onStatusChange'>) => true,\n    'copy-error': (_details: PayloadOf<ClipboardProps, 'onCopyError'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ClipboardRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useClipboard(withXhConfig('clipboard', props) as ClipboardProps, {\n      onStatusChange: details => emit('status-change', details),\n      onCopyError: details => emit('copy-error', details),\n    })\n    provideClipboard(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      status: ctx.api.value.status,\n      copied: ctx.api.value.copied,\n      value: ctx.api.value.value,\n      copy: ctx.api.value.copy,\n    }))\n  },\n})\n\nexport const XhClipboardLabel = defineComponent({\n  name: 'XhClipboardLabel',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    // 必须是原生 <label>，connect 把 for 写向 input\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhClipboardControl = defineComponent({\n  name: 'XhClipboardControl',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhClipboardInput = defineComponent({\n  name: 'XhClipboardInput',\n  setup() {\n    const ctx = useClipboardContext()\n    // 自己渲染 <input>，label 的 for 指向这个节点\n    return () => h('input', ctx.api.value.getInputProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhClipboardCopyTrigger = defineComponent({\n  name: 'XhClipboardCopyTrigger',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    // 原生 <button>，激活行为交给平台\n    return () => h('button', ctx.api.value.getCopyTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 复制成功的播报区：读屏可朗读，屏幕上不占位。未提供内容时朗读 announcement。 */\nexport const XhClipboardStatus = defineComponent({\n  name: 'XhClipboardStatus',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    return () => h(\n      'span',\n      ctx.api.value.getStatusProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.announcement,\n    )\n  },\n})\n\nexport const XhClipboardIndicator = defineComponent({\n  name: 'XhClipboardIndicator',\n  props: {\n    /** 该标记属于哪一侧：true = 复制成功后的对勾，false（默认）= 平时的复制图标。 */\n    copied: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useClipboardContext()\n    // 节点常挂并叠在同一格，切换时保持按钮宽度\n    return () => h(\n      'span',\n      ctx.api.value.getIndicatorProps({ copied: props.copied }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;AAqBA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,OAAO;EAEL,OAAO,EAAE,MAAM,OAAO;EACtB,SAAS,EAAE,MAAM,OAAO;EACxB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS,EAAE,MAAM,OAAkC;EACnD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAmD;CAC3E;CAEA,OAAO;EACL,kBAAkB,aAA0D;EAC5E,eAAe,aAAuD;CACxE;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,MAAM,aAAa,aAAa,aAAa,KAAK,GAAqB;GAC3E,iBAAgB,YAAW,KAAK,iBAAiB,OAAO;GACxD,cAAa,YAAW,KAAK,cAAc,OAAO;EACpD,CAAC;EACD,iBAAiB,GAAG;EACpB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,QAAQ,IAAI,IAAI,MAAM;GACtB,QAAQ,IAAI,IAAI,MAAM;GACtB,OAAO,IAAI,IAAI,MAAM;GACrB,MAAM,IAAI,IAAI,MAAM;EACtB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAEhC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,oBAAoB;EAEhC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,CAA4B;CAClF;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAEhC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EACX,QACA,IAAI,IAAI,MAAM,eAAe,GAC7B,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,YACrC;CACF;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,OAAO;;AAEL,QAAQ,QACV;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,oBAAoB;EAEhC,aAAa,EACX,QACA,IAAI,IAAI,MAAM,kBAAkB,EAAE,QAAQ,MAAM,OAAO,CAAC,GACxD,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}
+{"version":3,"file":"clipboard.js","names":[],"sources":["../../../src/components/clipboard/clipboard.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// 提供 clipboard 相关实现。\n\nimport type { ActionVariant, Size, Tone } from '@xihan-ui/core'\nimport type { ClipboardApi, ClipboardSchema, ClipboardTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideClipboard, useClipboardContext } from './context'\nimport { useClipboard } from './use-clipboard'\n\ntype ClipboardProps = ClipboardSchema['props']\n\n/** 默认插槽的载荷：复制状态、当前要复制的文本，以及执行一次复制的句柄。 */\nexport type ClipboardRootSlotProps = Pick<ClipboardApi, 'status' | 'copied' | 'value' | 'copy'>\n\nexport const XhClipboardRoot = defineComponent({\n  name: 'XhClipboardRoot',\n  props: {\n    // 属性缺席即没给要复制的文本，落回空串\n    value: { type: String },\n    timeout: { type: Number },\n    disabled: { type: Boolean, default: undefined },\n    variant: { type: String as PropType<ActionVariant> },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n    translations: { type: Object as PropType<Partial<ClipboardTranslations>> },\n  },\n  // status-change 携带 { status }；copy-error 携带 { error, value }\n  emits: {\n    'status-change': (_details: PayloadOf<ClipboardProps, 'onStatusChange'>) => true,\n    'copy-error': (_details: PayloadOf<ClipboardProps, 'onCopyError'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: ClipboardRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useClipboard(withXhConfig('clipboard', props) as ClipboardProps, {\n      onStatusChange: details => emit('status-change', details),\n      onCopyError: details => emit('copy-error', details),\n    })\n    provideClipboard(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      status: ctx.api.value.status,\n      copied: ctx.api.value.copied,\n      value: ctx.api.value.value,\n      copy: ctx.api.value.copy,\n    }))\n  },\n})\n\nexport const XhClipboardLabel = defineComponent({\n  name: 'XhClipboardLabel',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\n    // 必须是原生 <label>，connect 把 for 写向 input\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhClipboardControl = defineComponent({\n  name: 'XhClipboardControl',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhClipboardInput = defineComponent({\n  name: 'XhClipboardInput',\n  setup() {\n    const ctx = useClipboardContext()\n    // 自己渲染 <input>，label 的 for 指向这个节点\n    return () => h('input', ctx.api.value.getInputProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhClipboardCopyTrigger = defineComponent({\n  name: 'XhClipboardCopyTrigger',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    // 原生 <button>，激活行为交给平台\n    return () => h('button', ctx.api.value.getCopyTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 复制成功的播报区：读屏可朗读，屏幕上不占位。未提供内容时朗读 announcement。 */\nexport const XhClipboardStatus = defineComponent({\n  name: 'XhClipboardStatus',\n  setup(_, { slots }) {\n    const ctx = useClipboardContext()\n    return () => h(\n      'span',\n      ctx.api.value.getStatusProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.announcement,\n    )\n  },\n})\n\nexport const XhClipboardIndicator = defineComponent({\n  name: 'XhClipboardIndicator',\n  props: {\n    /** 该标记属于哪一侧：true = 复制成功后的对勾，false（默认）= 平时的复制图标。 */\n    copied: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useClipboardContext()\n    // 节点常挂并叠在同一格，切换时保持按钮宽度\n    return () => h(\n      'span',\n      ctx.api.value.getIndicatorProps({ copied: props.copied }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;;AAqBA,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,OAAO;EAEL,OAAO,EAAE,MAAM,OAAO;EACtB,SAAS,EAAE,MAAM,OAAO;EACxB,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC9C,SAAS,EAAE,MAAM,OAAkC;EACnD,MAAM,EAAE,MAAM,OAAyB;EACvC,MAAM,EAAE,MAAM,OAAyB;EACvC,cAAc,EAAE,MAAM,OAAmD;CAC3E;CAEA,OAAO;EACL,kBAAkB,aAA0D;EAC5E,eAAe,aAAuD;CACxE;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,MAAM,aAAa,aAAa,aAAa,KAAK,GAAqB;GAC3E,iBAAgB,YAAW,KAAK,iBAAiB,OAAO;GACxD,cAAa,YAAW,KAAK,cAAc,OAAO;EACpD,CAAC;EACD,iBAAiB,GAAG;EACpB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,QAAQ,IAAI,IAAI,MAAM;GACtB,QAAQ,IAAI,IAAI,MAAM;GACtB,OAAO,IAAI,IAAI,MAAM;GACrB,MAAM,IAAI,IAAI,MAAM;EACtB,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAEhC,IAAI,WAAW;EACf,kBAAkB;GAChB,IAAI,WAAW;EACjB,CAAC;EAED,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,mBAAmB,gBAAgB;CAC9C,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,oBAAoB;EAEhC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,CAA4B;CAClF;AACF,CAAC;AAED,MAAa,yBAAyB,gBAAgB;CACpD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAEhC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CAC5G;AACF,CAAC;;AAGD,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,oBAAoB;EAChC,aAAa,EACX,QACA,IAAI,IAAI,MAAM,eAAe,GAC7B,MAAM,UAAU,KAAK,IAAI,IAAI,MAAM,YACrC;CACF;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,OAAO;;AAEL,QAAQ,QACV;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,oBAAoB;EAEhC,aAAa,EACX,QACA,IAAI,IAAI,MAAM,kBAAkB,EAAE,QAAQ,MAAM,OAAO,CAAC,GACxD,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}

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

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { ClipboardApi, ClipboardSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/clipboard/use-clipboard.d.ts
 interface ClipboardContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhClipboardLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<ClipboardApi>;
 }
 declare function useClipboard(props: ClipboardSchema['props'], callbacks?: Pick<ClipboardSchema['props'], 'onStatusChange' | 'onCopyError'>): ClipboardContext;

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

@@ -1 +1 @@
-{"version":3,"file":"use-clipboard.d.ts","names":[],"sources":["../../../src/components/clipboard/use-clipboard.ts"],"mappings":";;;UAciB;EACf,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,YAAW,KAAK,8DACf"}
+{"version":3,"file":"use-clipboard.d.ts","names":[],"sources":["../../../src/components/clipboard/use-clipboard.ts"],"mappings":";;;UAciB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,aACd,OAAO,0BACP,YAAW,KAAK,8DACf"}

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

@@ -1,14 +1,19 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { clipboardMachine, connectClipboard } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/clipboard/use-clipboard.ts
 function useClipboard(props, callbacks = {}) {
+	const labelCount = ref(0);
 	const service = useMachine(clipboardMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		...callbacks
 	}));
-	return { api: computed(() => connectClipboard(service, vueNormalize)) };
+	return {
+		labelCount,
+		api: computed(() => connectClipboard(service, vueNormalize))
+	};
 }
 //#endregion
 export { useClipboard };

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

@@ -1 +1 @@
-{"version":3,"file":"use-clipboard.js","names":[],"sources":["../../../src/components/clipboard/use-clipboard.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use clipboard 相关实现。\n\nimport type { ClipboardApi, ClipboardSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { clipboardMachine, connectClipboard } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ClipboardContext {\n  api: ComputedRef<ClipboardApi>\n}\n\nexport function useClipboard(\n  props: ClipboardSchema['props'],\n  callbacks: Pick<ClipboardSchema['props'], 'onStatusChange' | 'onCopyError'> = {},\n): ClipboardContext {\n  const service = useMachine(clipboardMachine, () => ({ ...props, ...callbacks }))\n  const api = computed(() => connectClipboard(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAkBA,SAAgB,aACd,OACA,YAA8E,CAAC,GAC7D;CAClB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,GAAG;CAAU,EAAE;CAE/E,OAAO,EAAE,KADG,eAAe,iBAAiB,SAAS,YAAY,CACtD,EAAE;AACf"}
+{"version":3,"file":"use-clipboard.js","names":[],"sources":["../../../src/components/clipboard/use-clipboard.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 use clipboard 相关实现。\n\nimport type { ClipboardApi, ClipboardSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { clipboardMachine, connectClipboard } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ClipboardContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhClipboardLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<ClipboardApi>\n}\n\nexport function useClipboard(\n  props: ClipboardSchema['props'],\n  callbacks: Pick<ClipboardSchema['props'], 'onStatusChange' | 'onCopyError'> = {},\n): ClipboardContext {\n  const labelCount = ref(0)\n  const service = useMachine(clipboardMachine, () => ({ ...props, labelled: labelCount.value > 0, ...callbacks }))\n  const api = computed(() => connectClipboard(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;AAuBA,SAAgB,aACd,OACA,YAA8E,CAAC,GAC7D;CAClB,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,yBAAyB;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG,GAAG;CAAU,EAAE;CAE/G,OAAO;EAAE;EAAY,KADT,eAAe,iBAAiB,SAAS,YAAY,CAC1C;CAAE;AAC3B"}

package/dist/components/code-view/code-view.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CodeLine, CodeViewApi, CodeViewProps, CodeViewTranslations } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { HighlighterPort, Size } from "@xihan-ui/core";
-import { CodeLine, CodeViewApi, CodeViewProps, CodeViewTranslations } from "@xihan-ui/headless";
 //#region src/components/code-view/code-view.d.ts
 /** 默认插槽的载荷：语言、行数与折叠状态，以及切换折叠的句柄。 */
 type CodeViewRootSlotProps = Pick<CodeViewApi, 'lang' | 'lineCount' | 'lines' | 'foldable' | 'clamped' | 'setClamped'>;

package/dist/components/code-view/code-view.js

@@ -1,8 +1,8 @@
 import { withXhConfig } from "../../config/config.js";
 import { provideCodeView, useCodeViewContext } from "./context.js";
 import { useCodeView } from "./use-code-view.js";
-import { defineComponent, h, onBeforeUnmount, onMounted, shallowRef } from "vue";
 import { createCodeViewHighlighterResource } from "@xihan-ui/headless";
+import { defineComponent, h, onBeforeUnmount, onMounted, shallowRef } from "vue";
 //#region src/components/code-view/code-view.ts
 const defaultHighlighter = createCodeViewHighlighterResource(() => import("@xihan-ui/code-highlight"));
 const XhCodeViewRoot = defineComponent({

package/dist/components/code-view/use-code-view.d.ts

@@ -1,6 +1,6 @@
+import { CodeViewApi, CodeViewProps, CodeViewSchema } from "@xihan-ui/headless";
 import { ComputedRef, Ref } from "vue";
 import { Service } from "@xihan-ui/core";
-import { CodeViewApi, CodeViewProps, CodeViewSchema } from "@xihan-ui/headless";
 //#region src/components/code-view/use-code-view.d.ts
 interface CodeViewContext {
   api: ComputedRef<CodeViewApi>;

package/dist/components/code-view/use-code-view.js

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

package/dist/components/collapsible/collapsible.d.ts

@@ -1,7 +1,7 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { CollapsibleSchema } from "@xihan-ui/headless";
 import { PropType } from "vue";
 import { Direction, Size, Tone } from "@xihan-ui/core";
-import { CollapsibleSchema } from "@xihan-ui/headless";
 //#region src/components/collapsible/collapsible.d.ts
 type CollapsibleProps = CollapsibleSchema['props'];
 declare const XhCollapsibleRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{

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

@@ -1,5 +1,5 @@
-import { ComputedRef, Ref } from "vue";
 import { CollapsibleApi, CollapsibleSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/collapsible/use-collapsible.d.ts
 interface CollapsibleContext {
   api: ComputedRef<CollapsibleApi>;

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

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

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

@@ -1,11 +1,20 @@
 import { PayloadOf } from "../../runtime/payload.js";
+import { ColorFieldApi, ColorFieldSchema } from "@xihan-ui/headless";
 import { PropType, SlotsType, VNode } from "vue";
 import { ControlVariant, Size, Tone } from "@xihan-ui/core";
-import { ColorFieldApi, ColorFieldSchema, ColorFormat } from "@xihan-ui/headless";
+import { ColorFormat } from "@xihan-ui/core/color";
 //#region src/components/color-field/color-field.d.ts
 type ColorFieldProps = ColorFieldSchema['props'];
 type ColorFieldRootSlotProps = Pick<ColorFieldApi, 'value' | 'empty' | 'text' | 'editing' | 'valid' | 'invalid' | 'canClear' | 'setValue' | 'clear' | 'commit'>;
 declare const XhColorFieldRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   /** 颜色串；缺席即非受控。空串表示没有颜色。 */
   value: {
     type: StringConstructor;
@@ -64,6 +73,14 @@ declare const XhColorFieldRoot: import("vue").DefineComponent<import("vue").Extr
   'value-change': (_details: PayloadOf<ColorFieldProps, "onValueChange">) => true;
   'update:value': (_value: PayloadOf<ColorFieldProps, "onValueChange">["value"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+  label: {
+    type: StringConstructor;
+  };
+  /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+  ariaLabel: {
+    type: StringConstructor;
+  };
   /** 颜色串；缺席即非受控。空串表示没有颜色。 */
   value: {
     type: StringConstructor;
@@ -128,6 +145,7 @@ declare const XhColorFieldRoot: import("vue").DefineComponent<import("vue").Extr
   alpha: boolean;
 }, SlotsType<{
   default?: (props: ColorFieldRootSlotProps) => VNode[];
+  label?: () => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhColorFieldLabel: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;

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":";;;;;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"}
+{"version":3,"file":"color-field.d.ts","names":[],"sources":["../../../src/components/color-field/color-field.ts"],"mappings":";;;;;;KAsBK,kBAAkB;KAEX,0BAA0B,KACpC;cAIW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;IAWC,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;EACtC,cAAM;kCA2BhB;cAEW,iCAAiB,0BAAA,oBAAA,4BAAA;;8BAY5B,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,14 +1,20 @@
+import { renderStructure } from "../../runtime/structure.js";
 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";
 import { useColorField } from "./use-color-field.js";
-import { defineComponent, h } from "vue";
+import { colorFieldStructure } from "@xihan-ui/headless";
+import { defineComponent, h, onUnmounted } from "vue";
 //#region src/components/color-field/color-field.ts
 const XhColorFieldRoot = defineComponent({
 	name: "XhColorFieldRoot",
 	props: {
+		/** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */
+		label: { type: String },
+		/** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */
+		ariaLabel: { type: String },
 		/** 颜色串；缺席即非受控。空串表示没有颜色。 */
 		value: { type: String },
 		defaultValue: { type: String },
@@ -56,24 +62,31 @@ const XhColorFieldRoot = defineComponent({
 		};
 		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,
-			empty: ctx.api.value.empty,
-			text: ctx.api.value.text,
-			editing: ctx.api.value.editing,
-			valid: ctx.api.value.valid,
-			invalid: ctx.api.value.invalid,
-			canClear: ctx.api.value.canClear,
-			setValue: ctx.api.value.setValue,
-			clear: ctx.api.value.clear,
-			commit: ctx.api.value.commit
-		}));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getRootProps(), slots.default ? slots.default({
+				value: api.value,
+				empty: api.empty,
+				text: api.text,
+				editing: api.editing,
+				valid: api.valid,
+				invalid: api.invalid,
+				canClear: api.canClear,
+				setValue: api.setValue,
+				clear: api.clear,
+				commit: api.commit
+			}) : renderDefaultStructure(api, props.label, props.name !== void 0, slots.label));
+		};
 	}
 });
 const XhColorFieldLabel = defineComponent({
 	name: "XhColorFieldLabel",
 	setup(_, { slots }) {
 		const ctx = useColorFieldContext();
+		ctx.labelCount.value++;
+		onUnmounted(() => {
+			ctx.labelCount.value--;
+		});
 		return () => h("label", ctx.api.value.getLabelProps(), slots.default?.());
 	}
 });
@@ -118,6 +131,26 @@ const XhColorFieldHiddenInput = defineComponent({
 		return () => h("input", ctx.api.value.getHiddenInputProps());
 	}
 });
+/** 标准结构里各部件对应的组件。 */
+const COLOR_FIELD_PARTS = {
+	"label": XhColorFieldLabel,
+	"control": XhColorFieldControl,
+	"swatch": XhColorFieldSwatch,
+	"input": XhColorFieldInput,
+	"clear-trigger": XhColorFieldClearTrigger,
+	"hidden-input": XhColorFieldHiddenInput
+};
+/**
+* 未写默认插槽时铺开的整套结构：照 headless 的 colorFieldStructure 渲，
+* 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。
+*/
+function renderDefaultStructure(api, label, hiddenInput, labelSlot) {
+	return renderStructure(colorFieldStructure(api, {
+		label,
+		hiddenInput,
+		slotted: (name) => name === "label" && labelSlot != null
+	}), COLOR_FIELD_PARTS, (node) => node.slot ? labelSlot?.() : void 0);
+}
 //#endregion
 export { XhColorFieldClearTrigger, XhColorFieldControl, XhColorFieldHiddenInput, XhColorFieldInput, XhColorFieldLabel, XhColorFieldRoot, XhColorFieldSwatch };
 

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 { 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":"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"}
+{"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 { ColorFormat } from '@xihan-ui/core/color'\nimport type { ColorFieldApi, ColorFieldSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { colorFieldStructure } from '@xihan-ui/headless'\nimport { defineComponent, h, onUnmounted } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { renderStructure } from '../../runtime/structure'\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    /** 标题文字。不写默认插槽时铺 label 部件；需要放置其他内容时改用 label 插槽。 */\n    label: { type: String },\n    /** 不显示出来的名字，写成 aria-label 落在与字段标签同一个部件上；放进字段或渲染了 label 部件时以它们为准。 */\n    ariaLabel: { type: String },\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    label?: () => 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 () => {\n      const api = ctx.api.value\n      return h('div', api.getRootProps() as Record<string, unknown>, slots.default\n        ? slots.default({\n            value: api.value,\n            empty: api.empty,\n            text: api.text,\n            editing: api.editing,\n            valid: api.valid,\n            invalid: api.invalid,\n            canClear: api.canClear,\n            setValue: api.setValue,\n            clear: api.clear,\n            commit: api.commit,\n          })\n        : renderDefaultStructure(api, props.label, props.name !== undefined, slots.label))\n    }\n  },\n})\n\nexport const XhColorFieldLabel = defineComponent({\n  name: 'XhColorFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useColorFieldContext()\n    // 渲出来就登记，在 setup 里同步做：排在输入之前时首帧与服务端直出就带上名字\n    ctx.labelCount.value++\n    onUnmounted(() => {\n      ctx.labelCount.value--\n    })\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\n/** 标准结构里各部件对应的组件。 */\nconst COLOR_FIELD_PARTS = {\n  'label': XhColorFieldLabel,\n  'control': XhColorFieldControl,\n  'swatch': XhColorFieldSwatch,\n  'input': XhColorFieldInput,\n  'clear-trigger': XhColorFieldClearTrigger,\n  'hidden-input': XhColorFieldHiddenInput,\n}\n\n/**\n * 未写默认插槽时铺开的整套结构：照 headless 的 colorFieldStructure 渲，\n * 与 Web Components 不写部件时元素生成的节点出自同一份。标题由 label 插槽接管。\n */\nfunction renderDefaultStructure(api: ColorFieldApi, label: string | undefined, hiddenInput: boolean, labelSlot?: () => VNode[]): VNode[] {\n  const nodes = colorFieldStructure(api, { label, hiddenInput, slotted: name => name === 'label' && labelSlot != null })\n  return renderStructure(nodes, COLOR_FIELD_PARTS, node => (node.slot ? labelSlot?.() : undefined))\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,12 @@
-import { ComputedRef } from "vue";
 import { ColorFieldApi, ColorFieldSchema } from "@xihan-ui/headless";
+import { ComputedRef, Ref } from "vue";
 //#region src/components/color-field/use-color-field.d.ts
 interface ColorFieldContext {
+  /**
+   * 已渲染的 label 部件数量，由 XhColorFieldLabel 在 setup 里同步登记、卸载时撤销。
+   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。
+   */
+  labelCount: Ref<number>;
   api: ComputedRef<ColorFieldApi>;
 }
 declare function useColorField(props: ColorFieldSchema['props'], onValueChange?: ColorFieldSchema['props']['onValueChange']): ColorFieldContext;

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

@@ -1 +1 @@
-{"version":3,"file":"use-color-field.d.ts","names":[],"sources":["../../../src/components/color-field/use-color-field.ts"],"mappings":";;;UAciB;EACf,KAAK,YAAY;;iBAGH,cACd,OAAO,2BACP,gBAAgB,6CACf"}
+{"version":3,"file":"use-color-field.d.ts","names":[],"sources":["../../../src/components/color-field/use-color-field.ts"],"mappings":";;;UAciB;;;;;EAKf,YAAY;EACZ,KAAK,YAAY;;iBAGH,cACd,OAAO,2BACP,gBAAgB,6CACf"}

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

@@ -1,14 +1,19 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
 import { useMachine } from "../../runtime/use-machine.js";
-import { computed } from "vue";
 import { colorFieldMachine, connectColorField } from "@xihan-ui/headless";
+import { computed, ref } from "vue";
 //#region src/components/color-field/use-color-field.ts
 function useColorField(props, onValueChange) {
+	const labelCount = ref(0);
 	const service = useMachine(colorFieldMachine, () => ({
 		...props,
+		labelled: labelCount.value > 0,
 		onValueChange
 	}));
-	return { api: computed(() => connectColorField(service, vueNormalize)) };
+	return {
+		labelCount,
+		api: computed(() => connectColorField(service, vueNormalize))
+	};
 }
 //#endregion
 export { useColorField };

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

@@ -1 +1 @@
-{"version":3,"file":"use-color-field.js","names":[],"sources":["../../../src/components/color-field/use-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// 提供 use color field 相关实现。\n\nimport type { ColorFieldApi, ColorFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { colorFieldMachine, connectColorField } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ColorFieldContext {\n  api: ComputedRef<ColorFieldApi>\n}\n\nexport function useColorField(\n  props: ColorFieldSchema['props'],\n  onValueChange?: ColorFieldSchema['props']['onValueChange'],\n): ColorFieldContext {\n  const service = useMachine(colorFieldMachine, () => ({ ...props, onValueChange }))\n  const api = computed(() => connectColorField(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAkBA,SAAgB,cACd,OACA,eACmB;CACnB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO;CAAc,EAAE;CAEjF,OAAO,EAAE,KADG,eAAe,kBAAkB,SAAS,YAAY,CACvD,EAAE;AACf"}
+{"version":3,"file":"use-color-field.js","names":[],"sources":["../../../src/components/color-field/use-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// 提供 use color field 相关实现。\n\nimport type { ColorFieldApi, ColorFieldSchema } from '@xihan-ui/headless'\nimport type { ComputedRef, Ref } from 'vue'\nimport { colorFieldMachine, connectColorField } from '@xihan-ui/headless'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface ColorFieldContext {\n  /**\n   * 已渲染的 label 部件数量，由 XhColorFieldLabel 在 setup 里同步登记、卸载时撤销。\n   * 可聚焦部件的 aria-labelledby 据此决定指不指过去：label 排在输入之前时，首帧与服务端直出就带上名字。\n   */\n  labelCount: Ref<number>\n  api: ComputedRef<ColorFieldApi>\n}\n\nexport function useColorField(\n  props: ColorFieldSchema['props'],\n  onValueChange?: ColorFieldSchema['props']['onValueChange'],\n): ColorFieldContext {\n  const labelCount = ref(0)\n  const service = useMachine(colorFieldMachine, () => ({ ...props, labelled: labelCount.value > 0, onValueChange }))\n  const api = computed(() => connectColorField(service, vueNormalize))\n  return { labelCount, api }\n}\n"],"mappings":";;;;;AAuBA,SAAgB,cACd,OACA,eACmB;CACnB,MAAM,aAAa,IAAI,CAAC;CACxB,MAAM,UAAU,WAAW,0BAA0B;EAAE,GAAG;EAAO,UAAU,WAAW,QAAQ;EAAG;CAAc,EAAE;CAEjH,OAAO;EAAE;EAAY,KADT,eAAe,kBAAkB,SAAS,YAAY,CAC3C;CAAE;AAC3B"}