@xihan-ui/vue 1.0.0-alpha.3 → 1.0.0

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

@@ -56,11 +56,35 @@ declare const XhFieldLabel: import("vue").DefineComponent<{}, () => VNode<import
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 默认插槽的载荷：控件节点该挂的那组属性，作者把它交给自己渲染的控件。 */
 type FieldControlSlotProps = Record<string, unknown>;
-declare const XhFieldControl: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhFieldControl: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /**
+   * 把接线属性合到唯一的子节点上，缺省开。
+   *
+   * 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，
+   * 由封装内部调 useFieldControl 绑到真控件上。
+   */
+  asChild: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>, () => 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<{}>, {}, SlotsType<{
+}>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /**
+   * 把接线属性合到唯一的子节点上，缺省开。
+   *
+   * 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，
+   * 由封装内部调 useFieldControl 绑到真控件上。
+   */
+  asChild: {
+    type: BooleanConstructor;
+    default: boolean;
+  };
+}>> & Readonly<{}>, {
+  asChild: boolean;
+}, SlotsType<{
   default?: (props: FieldControlSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhFieldDescription: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {

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

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","names":[],"sources":["../../../src/components/field/field.ts"],"mappings":";;cAaa,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAoCtB;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;KAGU,wBAAwB;cAYvB,8BAAc,0BAAA,oBAAA,4BAAA;;;;;EAGb,WAAC,OAAO,0BAA0B;kCAiB9C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAe3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"field.d.ts","names":[],"sources":["../../../src/components/field/field.ts"],"mappings":";;cAaa,2BAAW,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAoCtB;cAEW,4BAAY,0BAAA,oBAAA,4BAAA;;8BAMvB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;KAGU,wBAAwB;cAYvB,8BAAc,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYb,WAAC,OAAO,0BAA0B;kCAiB9C;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,0BAAA,oBAAA,4BAAA;;8BAe3B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/field/field.js

@@ -1,6 +1,6 @@
+import { provideField, useFieldContext } from "./context.js";
 import { carriesOwnAnatomy } from "../../runtime/as-child.js";
 import { useOptionalFormContext, useOptionalFormField } from "../form/context.js";
-import { provideField, useFieldContext } from "./context.js";
 import { useField } from "./use-field.js";
 import { Comment, Text, cloneVNode, defineComponent, h } from "vue";
 //#region src/components/field/field.ts
@@ -71,14 +71,25 @@ function wiringOnly(controlProps) {
 }
 const XhFieldControl = defineComponent({
 	name: "XhFieldControl",
+	props: { 
+	/**
+	* 把接线属性合到唯一的子节点上，缺省开。
+	*
+	* 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，
+	* 由封装内部调 useFieldControl 绑到真控件上。
+	*/
+asChild: {
+		type: Boolean,
+		default: true
+	} },
 	slots: Object,
-	setup(_, { slots }) {
+	setup(props, { slots }) {
 		const ctx = useFieldContext();
 		return () => {
 			const controlProps = ctx.api.value.getControlProps();
 			const children = slots.default?.(controlProps) ?? [];
 			const nodes = attributable(children);
-			if (nodes.length !== 1) return children;
+			if (!props.asChild || nodes.length !== 1) return children;
 			const node = nodes[0];
 			return cloneVNode(node, carriesOwnAnatomy(node) ? wiringOnly(controlProps) : controlProps);
 		};
@@ -105,6 +116,6 @@ const XhFieldErrorText = defineComponent({
 	}
 });
 //#endregion
-export { XhFieldControl, XhFieldDescription, XhFieldErrorText, XhFieldLabel, XhFieldRoot };
+export { XhFieldControl, XhFieldDescription, XhFieldErrorText, XhFieldLabel, XhFieldRoot, wiringOnly };
 
 //# sourceMappingURL=field.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"field.js","names":[],"sources":["../../../src/components/field/field.ts"],"sourcesContent":["import type { FieldProps } from '@xihan-ui/headless'\nimport type { SlotsType, VNode } from 'vue'\nimport { cloneVNode, Comment, defineComponent, h, Text } from 'vue'\nimport { carriesOwnAnatomy } from '../../runtime/as-child'\nimport { useOptionalFormContext, useOptionalFormField } from '../form/context'\nimport { provideField, useFieldContext } from './context'\nimport { useField } from './use-field'\n\n/** 滤掉注释与纯文本节点，只留能挂属性的节点。 */\nfunction attributable(nodes: readonly VNode[]): VNode[] {\n  return nodes.filter(node => node.type !== Comment && node.type !== Text)\n}\n\nexport const XhFieldRoot = defineComponent({\n  name: 'XhFieldRoot',\n  // 三个布尔缺省 undefined：在 XhFormFieldGroup 里没写就从表单上下文自取，写了以写的为准\n  props: {\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    // 控件节点的 id，不占用根节点自己的 DOM id\n    controlId: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // getter 透传保住响应性：props 与表单 api 谁变都会带动 connect 重算\n    const merged: FieldProps = {\n      get invalid() {\n        return props.invalid ?? (form && handle ? form.api.value.isFieldInvalid(handle.name()) : undefined)\n      },\n      get required() {\n        return props.required ?? (form && handle ? form.api.value.isFieldRequired(handle.name()) : undefined)\n      },\n      get disabled() {\n        return props.disabled ?? (form && handle ? form.api.value.disabled : undefined)\n      },\n      get readOnly() {\n        return props.readOnly ?? (form && handle ? form.api.value.readOnly : undefined)\n      },\n      get controlId() {\n        return props.controlId\n      },\n    }\n    const ctx = useField(merged)\n    provideField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldLabel = defineComponent({\n  name: 'XhFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 默认插槽的载荷：控件节点该挂的那组属性，作者把它交给自己渲染的控件。 */\nexport type FieldControlSlotProps = Record<string, unknown>\n\n/** 去掉角色标记，只留接线属性（id 与 aria-*）。 */\nfunction wiringOnly(controlProps: Record<string, unknown>): Record<string, unknown> {\n  const rest: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(controlProps)) {\n    if (key !== 'data-scope' && key !== 'data-part')\n      rest[key] = value\n  }\n  return rest\n}\n\nexport const XhFieldControl = defineComponent({\n  name: 'XhFieldControl',\n  slots: Object as SlotsType<{\n    default?: (props: FieldControlSlotProps) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => {\n      const controlProps = ctx.api.value.getControlProps() as Record<string, unknown>\n      // control props 经 slot props 交给作者，控件节点由作者渲染\n      const children = slots.default?.(controlProps) ?? []\n      const nodes = attributable(children)\n      // 多个节点视为作者已用 slot props 自行接线\n      if (nodes.length !== 1)\n        return children\n      const node = nodes[0]!\n      // 单个节点合并属性；它自带角色标记时不覆盖，只落接线属性\n      return cloneVNode(node, carriesOwnAnatomy(node) ? wiringOnly(controlProps) : controlProps)\n    }\n  },\n})\n\nexport const XhFieldDescription = defineComponent({\n  name: 'XhFieldDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldErrorText = defineComponent({\n  name: 'XhFieldErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // 节点常挂，靠 hidden 显隐；插槽没给内容时在表单里自取该字段的错误文案\n    return () => {\n      const kids = slots.default?.()\n      const auto = (!kids || kids.length === 0) && form && handle\n        ? form.api.value.getFieldError(handle.name())\n        : undefined\n      return h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, kids?.length ? kids : auto)\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"field.js","names":[],"sources":["../../../src/components/field/field.ts"],"sourcesContent":["import type { FieldProps } from '@xihan-ui/headless'\nimport type { SlotsType, VNode } from 'vue'\nimport { cloneVNode, Comment, defineComponent, h, Text } from 'vue'\nimport { carriesOwnAnatomy } from '../../runtime/as-child'\nimport { useOptionalFormContext, useOptionalFormField } from '../form/context'\nimport { provideField, useFieldContext } from './context'\nimport { useField } from './use-field'\n\n/** 滤掉注释与纯文本节点，只留能挂属性的节点。 */\nfunction attributable(nodes: readonly VNode[]): VNode[] {\n  return nodes.filter(node => node.type !== Comment && node.type !== Text)\n}\n\nexport const XhFieldRoot = defineComponent({\n  name: 'XhFieldRoot',\n  // 三个布尔缺省 undefined：在 XhFormFieldGroup 里没写就从表单上下文自取，写了以写的为准\n  props: {\n    invalid: { type: Boolean, default: undefined },\n    required: { type: Boolean, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n    readOnly: { type: Boolean, default: undefined },\n    // 控件节点的 id，不占用根节点自己的 DOM id\n    controlId: { type: String, default: undefined },\n  },\n  setup(props, { slots }) {\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // getter 透传保住响应性：props 与表单 api 谁变都会带动 connect 重算\n    const merged: FieldProps = {\n      get invalid() {\n        return props.invalid ?? (form && handle ? form.api.value.isFieldInvalid(handle.name()) : undefined)\n      },\n      get required() {\n        return props.required ?? (form && handle ? form.api.value.isFieldRequired(handle.name()) : undefined)\n      },\n      get disabled() {\n        return props.disabled ?? (form && handle ? form.api.value.disabled : undefined)\n      },\n      get readOnly() {\n        return props.readOnly ?? (form && handle ? form.api.value.readOnly : undefined)\n      },\n      get controlId() {\n        return props.controlId\n      },\n    }\n    const ctx = useField(merged)\n    provideField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldLabel = defineComponent({\n  name: 'XhFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n/** 默认插槽的载荷：控件节点该挂的那组属性，作者把它交给自己渲染的控件。 */\nexport type FieldControlSlotProps = Record<string, unknown>\n\n/** 去掉角色标记，只留接线属性（id 与 aria-*）。 */\nexport function wiringOnly(controlProps: Record<string, unknown>): Record<string, unknown> {\n  const rest: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(controlProps)) {\n    if (key !== 'data-scope' && key !== 'data-part')\n      rest[key] = value\n  }\n  return rest\n}\n\nexport const XhFieldControl = defineComponent({\n  name: 'XhFieldControl',\n  props: {\n    /**\n     * 把接线属性合到唯一的子节点上，缺省开。\n     *\n     * 子节点是薄封装（根不是可聚焦元素）时关掉它：属性只经插槽载荷交出去，\n     * 由封装内部调 useFieldControl 绑到真控件上。\n     */\n    asChild: { type: Boolean, default: true },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: FieldControlSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useFieldContext()\n    return () => {\n      const controlProps = ctx.api.value.getControlProps() as Record<string, unknown>\n      // control props 经 slot props 交给作者，控件节点由作者渲染\n      const children = slots.default?.(controlProps) ?? []\n      const nodes = attributable(children)\n      // 关了 asChild、或不止一个节点：都视为作者已用 slot props 自行接线\n      if (!props.asChild || nodes.length !== 1)\n        return children\n      const node = nodes[0]!\n      // 单个节点合并属性；它自带角色标记时不覆盖，只落接线属性\n      return cloneVNode(node, carriesOwnAnatomy(node) ? wiringOnly(controlProps) : controlProps)\n    }\n  },\n})\n\nexport const XhFieldDescription = defineComponent({\n  name: 'XhFieldDescription',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhFieldErrorText = defineComponent({\n  name: 'XhFieldErrorText',\n  setup(_, { slots }) {\n    const ctx = useFieldContext()\n    const form = useOptionalFormContext()\n    const handle = useOptionalFormField()\n    // 节点常挂，靠 hidden 显隐；插槽没给内容时在表单里自取该字段的错误文案\n    return () => {\n      const kids = slots.default?.()\n      const auto = (!kids || kids.length === 0) && form && handle\n        ? form.api.value.getFieldError(handle.name())\n        : undefined\n      return h('p', ctx.api.value.getErrorTextProps() as Record<string, unknown>, kids?.length ? kids : auto)\n    }\n  },\n})\n"],"mappings":"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"}

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

@@ -0,0 +1,41 @@
+import { ComputedRef } from "vue";
+//#region src/components/field/use-field-control.d.ts
+/**
+ * 在薄封装内部取字段的控件接线属性（id 与 aria-*），把它们绑到真正可聚焦的那个节点上。
+ *
+ * XhFieldControl 默认把属性合到它唯一的子节点上，而子节点是组件时合的是组件根——
+ * 封装的根往往是个 div，label 的 for 指过去就聚不到焦（for 只对可标注元素生效），
+ * 而且这种失效不报错。封装内部调一次本组合式，接线就落在该落的节点上。
+ *
+ * 外层要写 `<XhFieldControl :as-child="false">`，否则属性会被合两遍。
+ * 不在字段里时返回空对象，封装照样能单独用。
+ */
+declare function useFieldControl(): ComputedRef<Record<string, unknown>>;
+/**
+ * 只取字段的「状态接线」（说明、校验、只读），不含 id 与名字。
+ *
+ * 给库自己的薄封装用：XhFieldControl 默认把整套属性合到封装根上，id 与
+ * aria-labelledby 落在那里是对的（label 的 for 得指得到一个真节点）；但
+ * aria-describedby 与 aria-invalid 落在根上就等于没落——焦点进的是里面那个
+ * input / button，读屏只念焦点所在节点的描述，说明与错误文本因此播报不出来。
+ * 封装把这几条补到真控件上，两边不冲突：id 只有一份，描述有两份不影响播报。
+ *
+ * 作者自己写封装时用上面那个 useFieldControl（配 `:as-child="false"`），
+ * 那条路整套属性都落到真控件上。
+ */
+declare function useFieldStateWiring(): ComputedRef<Record<string, unknown>>;
+/**
+ * 把字段标签的 id 并进这份属性里的名字链，供库自己的薄封装包在渲染属性外面。
+ *
+ * 复合控件的可聚焦部件自带 aria-labelledby，指的是它自己的 label 部件。套进字段时
+ * 作者用的是字段的标签、组件那个 label 部件根本没渲染，这条引用于是指向一个不存在的
+ * 节点——按 accname 规则悬空 IDREF 直接跳过，而名字也回退不到 label 的 for：for 指的
+ * 是封装根那个 div，只对可标注元素生效。结果是焦点所在的那个控件一个名字都没有。
+ *
+ * 字段的标签排在最前，控件自己的那截（值文本这类）跟在后面，两边都念得到。
+ * 不在字段里时属性原样返回。
+ */
+declare function useFieldLabelWiring(): ComputedRef<(props: Record<string, unknown>) => Record<string, unknown>>;
+//#endregion
+export { useFieldControl, useFieldLabelWiring, useFieldStateWiring };
+//# sourceMappingURL=use-field-control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-control.d.ts","names":[],"sources":["../../../src/components/field/use-field-control.ts"],"mappings":";;;;;;;;;;;;iBAegB,mBAAmB,YAAY;;;;;;;;;;;;;iBAqB/B,uBAAuB,YAAY;;;;;;;;;;;;iBA0BnC,uBAAuB,aAAa,OAAO,4BAA4B"}

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

@@ -0,0 +1,77 @@
+import { useOptionalFieldContext } from "./context.js";
+import { wiringOnly } from "./field.js";
+import { computed } from "vue";
+//#region src/components/field/use-field-control.ts
+/**
+* 在薄封装内部取字段的控件接线属性（id 与 aria-*），把它们绑到真正可聚焦的那个节点上。
+*
+* XhFieldControl 默认把属性合到它唯一的子节点上，而子节点是组件时合的是组件根——
+* 封装的根往往是个 div，label 的 for 指过去就聚不到焦（for 只对可标注元素生效），
+* 而且这种失效不报错。封装内部调一次本组合式，接线就落在该落的节点上。
+*
+* 外层要写 `<XhFieldControl :as-child="false">`，否则属性会被合两遍。
+* 不在字段里时返回空对象，封装照样能单独用。
+*/
+function useFieldControl() {
+	const ctx = useOptionalFieldContext();
+	return computed(() => {
+		if (!ctx) return {};
+		return wiringOnly(ctx.api.value.getControlProps());
+	});
+}
+/**
+* 只取字段的「状态接线」（说明、校验、只读），不含 id 与名字。
+*
+* 给库自己的薄封装用：XhFieldControl 默认把整套属性合到封装根上，id 与
+* aria-labelledby 落在那里是对的（label 的 for 得指得到一个真节点）；但
+* aria-describedby 与 aria-invalid 落在根上就等于没落——焦点进的是里面那个
+* input / button，读屏只念焦点所在节点的描述，说明与错误文本因此播报不出来。
+* 封装把这几条补到真控件上，两边不冲突：id 只有一份，描述有两份不影响播报。
+*
+* 作者自己写封装时用上面那个 useFieldControl（配 `:as-child="false"`），
+* 那条路整套属性都落到真控件上。
+*/
+function useFieldStateWiring() {
+	const ctx = useOptionalFieldContext();
+	return computed(() => {
+		if (!ctx) return {};
+		const control = ctx.api.value.getControlProps();
+		const wiring = {};
+		for (const key of [
+			"aria-describedby",
+			"aria-invalid",
+			"aria-required",
+			"aria-readonly"
+		]) if (control[key] !== void 0) wiring[key] = control[key];
+		return wiring;
+	});
+}
+/**
+* 把字段标签的 id 并进这份属性里的名字链，供库自己的薄封装包在渲染属性外面。
+*
+* 复合控件的可聚焦部件自带 aria-labelledby，指的是它自己的 label 部件。套进字段时
+* 作者用的是字段的标签、组件那个 label 部件根本没渲染，这条引用于是指向一个不存在的
+* 节点——按 accname 规则悬空 IDREF 直接跳过，而名字也回退不到 label 的 for：for 指的
+* 是封装根那个 div，只对可标注元素生效。结果是焦点所在的那个控件一个名字都没有。
+*
+* 字段的标签排在最前，控件自己的那截（值文本这类）跟在后面，两边都念得到。
+* 不在字段里时属性原样返回。
+*/
+function useFieldLabelWiring() {
+	const ctx = useOptionalFieldContext();
+	return computed(() => {
+		const labelId = ctx?.api.value.labelId;
+		return (props) => {
+			if (!labelId) return props;
+			const own = props["aria-labelledby"];
+			return {
+				...props,
+				"aria-labelledby": typeof own === "string" && own ? `${labelId} ${own}` : labelId
+			};
+		};
+	});
+}
+//#endregion
+export { useFieldControl, useFieldLabelWiring, useFieldStateWiring };
+
+//# sourceMappingURL=use-field-control.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-field-control.js","names":[],"sources":["../../../src/components/field/use-field-control.ts"],"sourcesContent":["import type { ComputedRef } from 'vue'\nimport { computed } from 'vue'\nimport { useOptionalFieldContext } from './context'\nimport { wiringOnly } from './field'\n\n/**\n * 在薄封装内部取字段的控件接线属性（id 与 aria-*），把它们绑到真正可聚焦的那个节点上。\n *\n * XhFieldControl 默认把属性合到它唯一的子节点上，而子节点是组件时合的是组件根——\n * 封装的根往往是个 div，label 的 for 指过去就聚不到焦（for 只对可标注元素生效），\n * 而且这种失效不报错。封装内部调一次本组合式，接线就落在该落的节点上。\n *\n * 外层要写 `<XhFieldControl :as-child=\"false\">`，否则属性会被合两遍。\n * 不在字段里时返回空对象，封装照样能单独用。\n */\nexport function useFieldControl(): ComputedRef<Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => {\n    if (!ctx)\n      return {}\n    return wiringOnly(ctx.api.value.getControlProps() as Record<string, unknown>)\n  })\n}\n\n/**\n * 只取字段的「状态接线」（说明、校验、只读），不含 id 与名字。\n *\n * 给库自己的薄封装用：XhFieldControl 默认把整套属性合到封装根上，id 与\n * aria-labelledby 落在那里是对的（label 的 for 得指得到一个真节点）；但\n * aria-describedby 与 aria-invalid 落在根上就等于没落——焦点进的是里面那个\n * input / button，读屏只念焦点所在节点的描述，说明与错误文本因此播报不出来。\n * 封装把这几条补到真控件上，两边不冲突：id 只有一份，描述有两份不影响播报。\n *\n * 作者自己写封装时用上面那个 useFieldControl（配 `:as-child=\"false\"`），\n * 那条路整套属性都落到真控件上。\n */\nexport function useFieldStateWiring(): ComputedRef<Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => {\n    if (!ctx)\n      return {}\n    const control = ctx.api.value.getControlProps() as Record<string, unknown>\n    const wiring: Record<string, unknown> = {}\n    for (const key of ['aria-describedby', 'aria-invalid', 'aria-required', 'aria-readonly']) {\n      if (control[key] !== undefined)\n        wiring[key] = control[key]\n    }\n    return wiring\n  })\n}\n\n/**\n * 把字段标签的 id 并进这份属性里的名字链，供库自己的薄封装包在渲染属性外面。\n *\n * 复合控件的可聚焦部件自带 aria-labelledby，指的是它自己的 label 部件。套进字段时\n * 作者用的是字段的标签、组件那个 label 部件根本没渲染，这条引用于是指向一个不存在的\n * 节点——按 accname 规则悬空 IDREF 直接跳过，而名字也回退不到 label 的 for：for 指的\n * 是封装根那个 div，只对可标注元素生效。结果是焦点所在的那个控件一个名字都没有。\n *\n * 字段的标签排在最前，控件自己的那截（值文本这类）跟在后面，两边都念得到。\n * 不在字段里时属性原样返回。\n */\nexport function useFieldLabelWiring(): ComputedRef<(props: Record<string, unknown>) => Record<string, unknown>> {\n  const ctx = useOptionalFieldContext()\n  return computed(() => {\n    const labelId = ctx?.api.value.labelId\n    return (props: Record<string, unknown>) => {\n      if (!labelId)\n        return props\n      const own = props['aria-labelledby']\n      return {\n        ...props,\n        'aria-labelledby': typeof own === 'string' && own ? `${labelId} ${own}` : labelId,\n      }\n    }\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,kBAAwD;CACtE,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,IAAI,CAAC,KACH,OAAO,CAAC;EACV,OAAO,WAAW,IAAI,IAAI,MAAM,gBAAgB,CAA4B;CAC9E,CAAC;AACH;;;;;;;;;;;;;AAcA,SAAgB,sBAA4D;CAC1E,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,IAAI,CAAC,KACH,OAAO,CAAC;EACV,MAAM,UAAU,IAAI,IAAI,MAAM,gBAAgB;EAC9C,MAAM,SAAkC,CAAC;EACzC,KAAK,MAAM,OAAO;GAAC;GAAoB;GAAgB;GAAiB;EAAe,GACrF,IAAI,QAAQ,SAAS,KAAA,GACnB,OAAO,OAAO,QAAQ;EAE1B,OAAO;CACT,CAAC;AACH;;;;;;;;;;;;AAaA,SAAgB,sBAAgG;CAC9G,MAAM,MAAM,wBAAwB;CACpC,OAAO,eAAe;EACpB,MAAM,UAAU,KAAK,IAAI,MAAM;EAC/B,QAAQ,UAAmC;GACzC,IAAI,CAAC,SACH,OAAO;GACT,MAAM,MAAM,MAAM;GAClB,OAAO;IACL,GAAG;IACH,mBAAmB,OAAO,QAAQ,YAAY,MAAM,GAAG,QAAQ,GAAG,QAAQ;GAC5E;EACF;CACF,CAAC;AACH"}

package/dist/components/fieldset/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/fieldset/context.ts
-const KEY = Symbol("xh-fieldset");
+const KEY = Symbol.for("xh-fieldset");
 function provideFieldset(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/fieldset/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/fieldset/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FieldsetContext } from './use-fieldset'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FieldsetContext> = Symbol('xh-fieldset')\n\nexport function provideFieldset(ctx: FieldsetContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFieldsetContext(): FieldsetContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Fieldset 部件必须用在 XhFieldsetRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAqC,OAAO,aAAa;AAE/D,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/fieldset/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FieldsetContext } from './use-fieldset'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FieldsetContext> = Symbol.for('xh-fieldset')\n\nexport function provideFieldset(ctx: FieldsetContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFieldsetContext(): FieldsetContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Fieldset 部件必须用在 XhFieldsetRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAqC,OAAO,IAAI,aAAa;AAEnE,SAAgB,gBAAgB,KAA4B;CAC1D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,qBAAsC;CACpD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,uCAAuC;CACzD,OAAO;AACT"}

package/dist/components/file-upload/context.js

@@ -1,7 +1,7 @@
 import { inject, provide } from "vue";
 //#region src/components/file-upload/context.ts
-const KEY = Symbol("xh-file-upload");
-const ITEM_KEY = Symbol("xh-file-upload-item");
+const KEY = Symbol.for("xh-file-upload");
+const ITEM_KEY = Symbol.for("xh-file-upload-item");
 function provideFileUpload(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/file-upload/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/file-upload/context.ts"],"sourcesContent":["import type { FileUploadItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { FileUploadContext } from './use-file-upload'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的文件，供 item-name / item-size-text / 删除按钮这些子部件复用同一份声明。 */\nexport interface FileUploadItemContext {\n  item: ComputedRef<FileUploadItemProps>\n}\n\nconst KEY: InjectionKey<FileUploadContext> = Symbol('xh-file-upload')\nconst ITEM_KEY: InjectionKey<FileUploadItemContext> = Symbol('xh-file-upload-item')\n\nexport function provideFileUpload(ctx: FileUploadContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFileUploadContext(): FileUploadContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 部件必须用在 XhFileUploadRoot 内')\n  return ctx\n}\n\nexport function provideFileUploadItem(ctx: FileUploadItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useFileUploadItemContext(): FileUploadItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 条目子部件必须用在 XhFileUploadItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAuC,OAAO,gBAAgB;AACpE,MAAM,WAAgD,OAAO,qBAAqB;AAElF,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;AAEA,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/file-upload/context.ts"],"sourcesContent":["import type { FileUploadItemProps } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport type { FileUploadContext } from './use-file-upload'\nimport { inject, provide } from 'vue'\n\n/** 条目自报的文件，供 item-name / item-size-text / 删除按钮这些子部件复用同一份声明。 */\nexport interface FileUploadItemContext {\n  item: ComputedRef<FileUploadItemProps>\n}\n\nconst KEY: InjectionKey<FileUploadContext> = Symbol.for('xh-file-upload')\nconst ITEM_KEY: InjectionKey<FileUploadItemContext> = Symbol.for('xh-file-upload-item')\n\nexport function provideFileUpload(ctx: FileUploadContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFileUploadContext(): FileUploadContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 部件必须用在 XhFileUploadRoot 内')\n  return ctx\n}\n\nexport function provideFileUploadItem(ctx: FileUploadItemContext): void {\n  provide(ITEM_KEY, ctx)\n}\n\nexport function useFileUploadItemContext(): FileUploadItemContext {\n  const ctx = inject(ITEM_KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FileUpload 条目子部件必须用在 XhFileUploadItem 内')\n  return ctx\n}\n"],"mappings":";;AAUA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AACxE,MAAM,WAAgD,OAAO,IAAI,qBAAqB;AAEtF,SAAgB,kBAAkB,KAA8B;CAC9D,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,uBAA0C;CACxD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,2CAA2C;CAC7D,OAAO;AACT;AAEA,SAAgB,sBAAsB,KAAkC;CACtE,QAAQ,UAAU,GAAG;AACvB;AAEA,SAAgB,2BAAkD;CAChE,MAAM,MAAM,OAAO,UAAU,IAAI;CACjC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,8CAA8C;CAChE,OAAO;AACT"}

package/dist/components/flex/flex.d.ts

@@ -2,6 +2,10 @@ import { PropType } from "vue";
 import { FlexProps } from "@xihan-ui/headless";
 //#region src/components/flex/flex.d.ts
 declare const XhFlex: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  orientation: {
+    type: PropType<FlexProps["orientation"]>;
+    default: undefined;
+  };
   direction: {
     type: PropType<FlexProps["direction"]>;
     default: undefined;
@@ -23,6 +27,10 @@ declare const XhFlex: import("vue").DefineComponent<import("vue").ExtractPropTyp
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  orientation: {
+    type: PropType<FlexProps["orientation"]>;
+    default: undefined;
+  };
   direction: {
     type: PropType<FlexProps["direction"]>;
     default: undefined;
@@ -42,6 +50,7 @@ declare const XhFlex: import("vue").DefineComponent<import("vue").ExtractPropTyp
   wrap: BooleanConstructor;
   inline: BooleanConstructor;
 }>> & Readonly<{}>, {
+  orientation: import("@xihan-ui/kernel").Orientation | undefined;
   wrap: boolean;
   direction: import("@xihan-ui/headless").FlexDirection | undefined;
   align: import("@xihan-ui/headless").FlexAlign | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"flex.d.ts","names":[],"sources":["../../../src/components/flex/flex.ts"],"mappings":";;;cAMa,sBAAM,8BAAA;;IAIc,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;;IAHH,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;;;;;qCAWlC"}
+{"version":3,"file":"flex.d.ts","names":[],"sources":["../../../src/components/flex/flex.ts"],"mappings":";;;cAMa,sBAAM,8BAAA;;IAIgB,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;;IAJD,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;IACP,MAAA,SAAS;;;;IACb,MAAA,SAAS;;;;;;;;;;;;;qCAWlC"}

package/dist/components/flex/flex.js

@@ -5,6 +5,10 @@ import { connectFlex } from "@xihan-ui/headless";
 const XhFlex = defineComponent({
 	name: "XhFlex",
 	props: {
+		orientation: {
+			type: String,
+			default: void 0
+		},
 		direction: {
 			type: String,
 			default: void 0

package/dist/components/flex/flex.js.map

@@ -1 +1 @@
-{"version":3,"file":"flex.js","names":[],"sources":["../../../src/components/flex/flex.ts"],"sourcesContent":["import type { FlexProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectFlex } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport const XhFlex = defineComponent({\n  name: 'XhFlex',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    direction: { type: String as PropType<FlexProps['direction']>, default: undefined },\n    align: { type: String as PropType<FlexProps['align']>, default: undefined },\n    justify: { type: String as PropType<FlexProps['justify']>, default: undefined },\n    gap: { type: String as PropType<FlexProps['gap']>, default: undefined },\n    wrap: Boolean,\n    inline: Boolean,\n  },\n  setup(props, { slots }) {\n    return () => h(\n      'div',\n      connectFlex(props as FlexProps, vueNormalize).getRootProps() as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;AAMA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EACL,WAAW;GAAE,MAAM;GAA4C,SAAS,KAAA;EAAU;EAClF,OAAO;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;EAC1E,SAAS;GAAE,MAAM;GAA0C,SAAS,KAAA;EAAU;EAC9E,KAAK;GAAE,MAAM;GAAsC,SAAS,KAAA;EAAU;EACtE,MAAM;EACN,QAAQ;CACV;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,aAAa,EACX,OACA,YAAY,OAAoB,YAAY,CAAC,CAAC,aAAa,GAC3D,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}
+{"version":3,"file":"flex.js","names":[],"sources":["../../../src/components/flex/flex.ts"],"sourcesContent":["import type { FlexProps } from '@xihan-ui/headless'\nimport type { PropType } from 'vue'\nimport { connectFlex } from '@xihan-ui/headless'\nimport { defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\n\nexport const XhFlex = defineComponent({\n  name: 'XhFlex',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    orientation: { type: String as PropType<FlexProps['orientation']>, default: undefined },\n    direction: { type: String as PropType<FlexProps['direction']>, default: undefined },\n    align: { type: String as PropType<FlexProps['align']>, default: undefined },\n    justify: { type: String as PropType<FlexProps['justify']>, default: undefined },\n    gap: { type: String as PropType<FlexProps['gap']>, default: undefined },\n    wrap: Boolean,\n    inline: Boolean,\n  },\n  setup(props, { slots }) {\n    return () => h(\n      'div',\n      connectFlex(props as FlexProps, vueNormalize).getRootProps() as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n"],"mappings":";;;;AAMA,MAAa,SAAS,gBAAgB;CACpC,MAAM;CAEN,OAAO;EACL,aAAa;GAAE,MAAM;GAA8C,SAAS,KAAA;EAAU;EACtF,WAAW;GAAE,MAAM;GAA4C,SAAS,KAAA;EAAU;EAClF,OAAO;GAAE,MAAM;GAAwC,SAAS,KAAA;EAAU;EAC1E,SAAS;GAAE,MAAM;GAA0C,SAAS,KAAA;EAAU;EAC9E,KAAK;GAAE,MAAM;GAAsC,SAAS,KAAA;EAAU;EACtE,MAAM;EACN,QAAQ;CACV;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,aAAa,EACX,OACA,YAAY,OAAoB,YAAY,CAAC,CAAC,aAAa,GAC3D,MAAM,UAAU,CAClB;CACF;AACF,CAAC"}

package/dist/components/float-button/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/float-button/context.ts
-const KEY = Symbol("xh-float-button");
+const KEY = Symbol.for("xh-float-button");
 function provideFloatButton(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/float-button/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/float-button/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FloatButtonContext } from './use-float-button'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FloatButtonContext> = Symbol('xh-float-button')\n\nexport function provideFloatButton(ctx: FloatButtonContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFloatButtonContext(): FloatButtonContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FloatButton 部件必须用在 XhFloatButtonRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAwC,OAAO,iBAAiB;AAEtE,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/float-button/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FloatButtonContext } from './use-float-button'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FloatButtonContext> = Symbol.for('xh-float-button')\n\nexport function provideFloatButton(ctx: FloatButtonContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFloatButtonContext(): FloatButtonContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FloatButton 部件必须用在 XhFloatButtonRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAwC,OAAO,IAAI,iBAAiB;AAE1E,SAAgB,mBAAmB,KAA+B;CAChE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,wBAA4C;CAC1D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,6CAA6C;CAC/D,OAAO;AACT"}

package/dist/components/float-button/float-button.d.ts

@@ -69,10 +69,10 @@ declare const XhFloatButtonRoot: import("vue").DefineComponent<import("vue").Ext
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
   disabled: boolean;
+  offset: number;
+  translations: Partial<FloatButtonTranslations>;
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<FloatButtonTranslations>;
-  offset: number;
   expandTrigger: FloatButtonExpandTrigger;
   placement: FloatButtonPlacement;
   shape: FloatButtonShape;

package/dist/components/floating-panel/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/floating-panel/context.ts
-const KEY = Symbol("xh-floating-panel");
+const KEY = Symbol.for("xh-floating-panel");
 function provideFloatingPanel(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/floating-panel/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/floating-panel/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FloatingPanelContext } from './use-floating-panel'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FloatingPanelContext> = Symbol('xh-floating-panel')\n\nexport function provideFloatingPanel(ctx: FloatingPanelContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFloatingPanelContext(): FloatingPanelContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FloatingPanel 部件必须用在 XhFloatingPanelRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAA0C,OAAO,mBAAmB;AAE1E,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iDAAiD;CACnE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/floating-panel/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FloatingPanelContext } from './use-floating-panel'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FloatingPanelContext> = Symbol.for('xh-floating-panel')\n\nexport function provideFloatingPanel(ctx: FloatingPanelContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFloatingPanelContext(): FloatingPanelContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] FloatingPanel 部件必须用在 XhFloatingPanelRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAA0C,OAAO,IAAI,mBAAmB;AAE9E,SAAgB,qBAAqB,KAAiC;CACpE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,0BAAgD;CAC9D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iDAAiD;CACnE,OAAO;AACT"}

package/dist/components/floating-panel/floating-panel.d.ts

@@ -142,9 +142,9 @@ declare const XhFloatingPanelRoot: import("vue").DefineComponent<import("vue").E
 }>, {
   size: FloatingPanelSize;
   disabled: boolean;
+  translations: Partial<import("@xihan-ui/headless").FloatingPanelTranslations> | undefined;
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<import("@xihan-ui/headless").FloatingPanelTranslations> | undefined;
   position: FloatingPanelPosition;
   stage: FloatingPanelStage;
   defaultPosition: FloatingPanelPosition;

package/dist/components/form/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/form/context.ts
-const KEY = Symbol("xh-form");
+const KEY = Symbol.for("xh-form");
 function provideForm(ctx) {
 	provide(KEY, ctx);
 }
@@ -13,7 +13,7 @@ function useFormContext() {
 function useOptionalFormContext() {
 	return inject(KEY, null);
 }
-const FIELD_KEY = Symbol("xh-form-field");
+const FIELD_KEY = Symbol.for("xh-form-field");
 function provideFormField(handle) {
 	provide(FIELD_KEY, handle);
 }

package/dist/components/form/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/form/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FormContext } from './use-form'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FormContext> = Symbol('xh-form')\n\nexport function provideForm(ctx: FormContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFormContext(): FormContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Form 部件必须用在 XhFormRoot 内')\n  return ctx\n}\n\n/** 表单外也能用的部件（如 Field）从这里拿：不在表单里就是 null。 */\nexport function useOptionalFormContext(): FormContext | null {\n  return inject(KEY, null)\n}\n\n/** 字段容器把字段名交给后代：Field 据此从表单上下文自取校验态。 */\nexport interface FormFieldHandle {\n  name: () => string\n}\n\nconst FIELD_KEY: InjectionKey<FormFieldHandle> = Symbol('xh-form-field')\n\nexport function provideFormField(handle: FormFieldHandle): void {\n  provide(FIELD_KEY, handle)\n}\n\nexport function useOptionalFormField(): FormFieldHandle | null {\n  return inject(FIELD_KEY, null)\n}\n"],"mappings":";;AAIA,MAAM,MAAiC,OAAO,SAAS;AAEvD,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;;AAGA,SAAgB,yBAA6C;CAC3D,OAAO,OAAO,KAAK,IAAI;AACzB;AAOA,MAAM,YAA2C,OAAO,eAAe;AAEvE,SAAgB,iBAAiB,QAA+B;CAC9D,QAAQ,WAAW,MAAM;AAC3B;AAEA,SAAgB,uBAA+C;CAC7D,OAAO,OAAO,WAAW,IAAI;AAC/B"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/form/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { FormContext } from './use-form'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<FormContext> = Symbol.for('xh-form')\n\nexport function provideForm(ctx: FormContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useFormContext(): FormContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Form 部件必须用在 XhFormRoot 内')\n  return ctx\n}\n\n/** 表单外也能用的部件（如 Field）从这里拿：不在表单里就是 null。 */\nexport function useOptionalFormContext(): FormContext | null {\n  return inject(KEY, null)\n}\n\n/** 字段容器把字段名交给后代：Field 据此从表单上下文自取校验态。 */\nexport interface FormFieldHandle {\n  name: () => string\n}\n\nconst FIELD_KEY: InjectionKey<FormFieldHandle> = Symbol.for('xh-form-field')\n\nexport function provideFormField(handle: FormFieldHandle): void {\n  provide(FIELD_KEY, handle)\n}\n\nexport function useOptionalFormField(): FormFieldHandle | null {\n  return inject(FIELD_KEY, null)\n}\n"],"mappings":";;AAIA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT;;AAGA,SAAgB,yBAA6C;CAC3D,OAAO,OAAO,KAAK,IAAI;AACzB;AAOA,MAAM,YAA2C,OAAO,IAAI,eAAe;AAE3E,SAAgB,iBAAiB,QAA+B;CAC9D,QAAQ,WAAW,MAAM;AAC3B;AAEA,SAAgB,uBAA+C;CAC7D,OAAO,OAAO,WAAW,IAAI;AAC/B"}

package/dist/components/grid/context.js

@@ -1,6 +1,6 @@
 import { inject, provide } from "vue";
 //#region src/components/grid/context.ts
-const KEY = Symbol("xh-grid");
+const KEY = Symbol.for("xh-grid");
 function provideGrid(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/grid/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/grid/context.ts"],"sourcesContent":["import type { GridApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface GridContext {\n  api: ComputedRef<GridApi>\n}\n\nconst KEY: InjectionKey<GridContext> = Symbol('xh-grid')\n\nexport function provideGrid(ctx: GridContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useGridContext(): GridContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Grid 部件必须用在 XhGridRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAiC,OAAO,SAAS;AAEvD,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/grid/context.ts"],"sourcesContent":["import type { GridApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface GridContext {\n  api: ComputedRef<GridApi>\n}\n\nconst KEY: InjectionKey<GridContext> = Symbol.for('xh-grid')\n\nexport function provideGrid(ctx: GridContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useGridContext(): GridContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Grid 部件必须用在 XhGridRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAiC,OAAO,IAAI,SAAS;AAE3D,SAAgB,YAAY,KAAwB;CAClD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,iBAA8B;CAC5C,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+BAA+B;CACjD,OAAO;AACT"}

package/dist/components/heatmap/context.js

@@ -1,10 +1,10 @@
 import { inject, provide } from "vue";
 //#region src/components/heatmap/context.ts
-const KEY = Symbol("xh-heatmap");
+const KEY = Symbol.for("xh-heatmap");
 /** 月块把自己的月份身份传给块内的行：一行由「哪个月 + 月内第几周」定位。 */
-const MONTH_KEY = Symbol("xh-heatmap-month");
+const MONTH_KEY = Symbol.for("xh-heatmap-month");
 /** 行把自己的行身份传给行里的格子：矩阵的一格由「哪一行 + 哪一列」定位。 */
-const ROW_KEY = Symbol("xh-heatmap-row");
+const ROW_KEY = Symbol.for("xh-heatmap-row");
 function provideHeatmap(ctx) {
 	provide(KEY, ctx);
 }

package/dist/components/heatmap/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/heatmap/context.ts"],"sourcesContent":["import type { ComputedRef, InjectionKey } from 'vue'\nimport type { HeatmapContext } from './use-heatmap'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<HeatmapContext> = Symbol('xh-heatmap')\n\n/** 月块把自己的月份身份传给块内的行：一行由「哪个月 + 月内第几周」定位。 */\nconst MONTH_KEY: InjectionKey<ComputedRef<string>> = Symbol('xh-heatmap-month')\n\n/** 行把自己的行身份传给行里的格子：矩阵的一格由「哪一行 + 哪一列」定位。 */\nconst ROW_KEY: InjectionKey<ComputedRef<string | undefined>> = Symbol('xh-heatmap-row')\n\nexport function provideHeatmap(ctx: HeatmapContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useHeatmapContext(): HeatmapContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Heatmap 部件必须用在 XhHeatmapRoot 内')\n  return ctx\n}\n\nexport function provideHeatmapMonth(month: ComputedRef<string>): void {\n  provide(MONTH_KEY, month)\n}\n\n/** 没写在月块里就没有月份身份，行自己再从 props 上找。 */\nexport function useHeatmapMonth(): ComputedRef<string> | null {\n  return inject(MONTH_KEY, null)\n}\n\nexport function provideHeatmapRow(row: ComputedRef<string | undefined>): void {\n  provide(ROW_KEY, row)\n}\n\nexport function useHeatmapRow(): ComputedRef<string | undefined> | null {\n  return inject(ROW_KEY, null)\n}\n"],"mappings":";;AAIA,MAAM,MAAoC,OAAO,YAAY;;AAG7D,MAAM,YAA+C,OAAO,kBAAkB;;AAG9E,MAAM,UAAyD,OAAO,gBAAgB;AAEtF,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT;AAEA,SAAgB,oBAAoB,OAAkC;CACpE,QAAQ,WAAW,KAAK;AAC1B;;AAGA,SAAgB,kBAA8C;CAC5D,OAAO,OAAO,WAAW,IAAI;AAC/B;AAEA,SAAgB,kBAAkB,KAA4C;CAC5E,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,gBAAwD;CACtE,OAAO,OAAO,SAAS,IAAI;AAC7B"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/heatmap/context.ts"],"sourcesContent":["import type { ComputedRef, InjectionKey } from 'vue'\nimport type { HeatmapContext } from './use-heatmap'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<HeatmapContext> = Symbol.for('xh-heatmap')\n\n/** 月块把自己的月份身份传给块内的行：一行由「哪个月 + 月内第几周」定位。 */\nconst MONTH_KEY: InjectionKey<ComputedRef<string>> = Symbol.for('xh-heatmap-month')\n\n/** 行把自己的行身份传给行里的格子：矩阵的一格由「哪一行 + 哪一列」定位。 */\nconst ROW_KEY: InjectionKey<ComputedRef<string | undefined>> = Symbol.for('xh-heatmap-row')\n\nexport function provideHeatmap(ctx: HeatmapContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useHeatmapContext(): HeatmapContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Heatmap 部件必须用在 XhHeatmapRoot 内')\n  return ctx\n}\n\nexport function provideHeatmapMonth(month: ComputedRef<string>): void {\n  provide(MONTH_KEY, month)\n}\n\n/** 没写在月块里就没有月份身份，行自己再从 props 上找。 */\nexport function useHeatmapMonth(): ComputedRef<string> | null {\n  return inject(MONTH_KEY, null)\n}\n\nexport function provideHeatmapRow(row: ComputedRef<string | undefined>): void {\n  provide(ROW_KEY, row)\n}\n\nexport function useHeatmapRow(): ComputedRef<string | undefined> | null {\n  return inject(ROW_KEY, null)\n}\n"],"mappings":";;AAIA,MAAM,MAAoC,OAAO,IAAI,YAAY;;AAGjE,MAAM,YAA+C,OAAO,IAAI,kBAAkB;;AAGlF,MAAM,UAAyD,OAAO,IAAI,gBAAgB;AAE1F,SAAgB,eAAe,KAA2B;CACxD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,oBAAoC;CAClD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,qCAAqC;CACvD,OAAO;AACT;AAEA,SAAgB,oBAAoB,OAAkC;CACpE,QAAQ,WAAW,KAAK;AAC1B;;AAGA,SAAgB,kBAA8C;CAC5D,OAAO,OAAO,WAAW,IAAI;AAC/B;AAEA,SAAgB,kBAAkB,KAA4C;CAC5E,QAAQ,SAAS,GAAG;AACtB;AAEA,SAAgB,gBAAwD;CACtE,OAAO,OAAO,SAAS,IAAI;AAC7B"}

package/dist/components/heatmap/heatmap.d.ts

@@ -146,10 +146,10 @@ declare const XhHeatmapRoot: import("vue").DefineComponent<import("vue").Extract
   "onCell-focus"?: ((_details: HeatmapCellDetails) => any) | undefined;
   "onCell-active"?: ((_details: HeatmapCellDetails | null) => any) | undefined;
 }>, {
-  size: Size;
   value: HeatmapValue[];
   dir: Direction;
   tone: Tone;
+  size: Size;
   translations: Partial<HeatmapTranslations>;
   variant: HeatmapVariant;
   locale: string;

package/dist/components/hotkeys/hotkeys.d.ts

@@ -8,6 +8,8 @@ import { Size } from "@xihan-ui/kernel";
  *
  * 内容整份由 keys 与平台算出，组件不收默认插槽——键帽上写什么、连接符出不出，
  * 两个平台的答案不一样，内容另有来源就对不上了。
+ *
+ * 注册与渲染是两件事：只要注册不要键帽就直接用 useHotkeys。
  */
 declare const XhHotkeys: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   keys: {
@@ -75,9 +77,9 @@ declare const XhHotkeys: import("vue").DefineComponent<import("vue").ExtractProp
   "onHot-key"?: ((_details: import("@xihan-ui/headless").HotkeysTriggerDetails) => any) | undefined;
 }>, {
   keys: string[];
-  target: HotkeysTarget;
   size: Size;
   translations: Partial<HotkeysTranslations>;
+  target: HotkeysTarget;
   platform: HotkeysPlatform;
   preventDefault: boolean;
   enabled: boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"hotkeys.d.ts","names":[],"sources":["../../../src/components/hotkeys/hotkeys.ts"],"mappings":";;;;;;;;;;;cAea,yBAAS,8BAAA;;IAIK,MAAA;;;;IACK,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;;;;;;;;;IAGX,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAI3B,YAAA,UAAA,UAAU;;;IAVT,MAAA;;;;IACK,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;;;;;;;;;IAGX,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;qCA8DnD"}
+{"version":3,"file":"hotkeys.d.ts","names":[],"sources":["../../../src/components/hotkeys/hotkeys.ts"],"mappings":";;;;;;;;;;;;;cAgBa,yBAAS,8BAAA;;IAIK,MAAA;;;;IACK,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;;;;;;;;;IAGX,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;EAI3B,YAAA,UAAA,UAAU;;;IAVT,MAAA;;;;IACK,MAAA,SAAS;;;;IACX,MAAA,SAAS;;;;;;;;;;;;IAGX,MAAA,SAAS;;;;IACD,MAAA,SAAS,QAAQ;;;;;;;;;;;;;qCAqCnD"}

package/dist/components/hotkeys/hotkeys.js

@@ -1,13 +1,14 @@
-import { vueNormalize } from "../../runtime/normalize-props.js";
 import { withXhConfig } from "../../config/config.js";
-import { computed, defineComponent, h, onBeforeUnmount, onMounted, ref, watchEffect } from "vue";
-import { connectHotkeys, detectHotkeysPlatform } from "@xihan-ui/headless";
+import { useHotkeys } from "./use-hotkeys.js";
+import { defineComponent, h, ref } from "vue";
 //#region src/components/hotkeys/hotkeys.ts
 /**
 * 把一组键铺成一排键帽，并按 target 指定的节点接住这次组合。
 *
 * 内容整份由 keys 与平台算出，组件不收默认插槽——键帽上写什么、连接符出不出，
 * 两个平台的答案不一样，内容另有来源就对不上了。
+*
+* 注册与渲染是两件事：只要注册不要键帽就直接用 useHotkeys。
 */
 const XhHotkeys = defineComponent({
 	name: "XhHotkeys",
@@ -44,36 +45,17 @@ const XhHotkeys = defineComponent({
 	emits: { "hot-key": (_details) => true },
 	setup(props, { emit }) {
 		const rootEl = ref(null);
-		const detected = ref("auto");
-		onMounted(() => {
-			detected.value = detectHotkeysPlatform();
-		});
 		const merged = withXhConfig("hotkeys", props);
-		const api = computed(() => connectHotkeys({
+		const { api } = useHotkeys(() => ({
 			keys: props.keys,
-			platform: props.platform && props.platform !== "auto" ? props.platform : detected.value,
+			platform: props.platform,
 			target: props.target,
 			preventDefault: props.preventDefault,
 			enabled: props.enabled,
 			size: props.size,
 			translations: merged.translations,
 			onHotKey: (details) => emit("hot-key", details)
-		}, vueNormalize));
-		const onKeyDown = (event) => api.value.handleKeyDown(event);
-		let bound = null;
-		const unbind = () => {
-			bound?.removeEventListener("keydown", onKeyDown);
-			bound = null;
-		};
-		watchEffect(() => {
-			const el = rootEl.value;
-			const next = el === null ? null : api.value.target === "parent" ? el.parentElement : el.ownerDocument;
-			if (next === bound) return;
-			unbind();
-			bound = next;
-			bound?.addEventListener("keydown", onKeyDown);
-		});
-		onBeforeUnmount(unbind);
+		}), rootEl);
 		return () => {
 			const current = api.value;
 			const separatorProps = current.getSeparatorProps();