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

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

@@ -1,4 +1,6 @@
+import { useOverlayExit } from "../../runtime/use-overlay-exit.js";
 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 { computed, ref } from "vue";
@@ -7,6 +9,7 @@ import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
 import { createPositionEngine } from "@xihan-ui/position";
 //#region src/components/date-picker/use-date-picker.ts
 function useDatePicker(props, handlers = {}) {
+	const xhConfig = useXhConfig();
 	const controlRef = ref(null);
 	const positionerRef = ref(null);
 	const contentRef = ref(null);
@@ -24,15 +27,16 @@ function useDatePicker(props, handlers = {}) {
 		field: useMachine(dateFieldMachine, () => datePickerFieldProps(root), scope),
 		fieldEnd: useMachine(dateFieldMachine, () => datePickerFieldEndProps(root), scope)
 	};
+	let config = null;
 	if (typeof document !== "undefined") {
-		const config = createRuntimeConfig({
+		config = createRuntimeConfig({
 			scope,
 			idGenerator: idGen
 		});
 		const registerLayer = () => config.layerRegistry.register({
 			kind: "popover",
 			node: () => contentRef.value,
-			branches: () => [controlRef.value].filter(Boolean),
+			branches: () => [controlRef.value, positionerRef.value].filter(Boolean),
 			isModal: () => false,
 			setModal: () => {},
 			surfaces: () => []
@@ -45,13 +49,20 @@ function useDatePicker(props, handlers = {}) {
 		root.refs.set("getContentEl", () => contentRef.value);
 	}
 	calendar.refs.set("getGridEl", () => gridRef.value);
+	const api = computed(() => connectDatePicker(services, vueNormalize));
 	return {
-		api: computed(() => connectDatePicker(services, vueNormalize)),
+		visible: useOverlayExit({
+			config,
+			isOpen: () => api.value.open,
+			contentRef
+		}),
+		api,
 		services,
 		controlRef,
 		positionerRef,
 		contentRef,
-		gridRef
+		gridRef,
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }
 //#endregion

package/dist/components/date-picker/use-date-picker.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-date-picker.js","names":[],"sources":["../../../src/components/date-picker/use-date-picker.ts"],"sourcesContent":["import type { CalendarSchema, DateFieldSchema, DatePickerApi, DatePickerSchema, DatePickerServices } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { ComputedRef, Ref } from 'vue'\nimport {\n  calendarMachine,\n  connectDatePicker,\n  dateFieldMachine,\n  datePickerCalendarProps,\n  datePickerFieldEndProps,\n  datePickerFieldProps,\n  datePickerMachine,\n} from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DatePickerContext {\n  api: ComputedRef<DatePickerApi>\n  /** 四台机器的把手，供部件上报 DOM 侧的事实。 */\n  services: DatePickerServices\n  controlRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  gridRef: Ref<HTMLElement | null>\n}\n\nexport function useDatePicker(\n  props: DatePickerSchema['props'],\n  handlers: Pick<DatePickerSchema['props'], 'onValueChange' | 'onOpenChange' | 'onFocusedValueChange'> = {},\n): DatePickerContext {\n  const controlRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n  const gridRef = ref<HTMLElement | null>(null)\n\n  // 四台机器共用一份 scope，part id 里带组件名区分；两组段位不产出 id，同 scope 不会撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n\n  // 三台内嵌机器的 props 都从编排机现读，编排机须先建立\n  const root = useMachine(datePickerMachine, () => ({ ...props, ...handlers }), scope)\n  const calendar = useMachine<CalendarSchema>(calendarMachine, () => datePickerCalendarProps(root), scope)\n  const field = useMachine<DateFieldSchema>(dateFieldMachine, () => datePickerFieldProps(root), scope)\n  // 终点那组段位无条件建：机器实例数不随模式变，非区间模式下它的值恒为空且不参与写值\n  const fieldEnd = useMachine<DateFieldSchema>(dateFieldMachine, () => datePickerFieldEndProps(root), scope)\n  const services: DatePickerServices = { root, calendar, field, fieldEnd }\n\n  if (typeof document !== 'undefined') {\n    const config: RuntimeConfig = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 整个输入行记为本层分支，点 trigger 或段位算层内交互\n      branches: () => [controlRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点取整个输入行\n    root.refs.set('config', config)\n    root.refs.set('registerLayer', registerLayer)\n    root.refs.set('position', createPositionEngine())\n    root.refs.set('getAnchorEl', () => controlRef.value)\n    root.refs.set('getFloatingEl', () => positionerRef.value)\n    root.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  // 跨月后的焦点落点要等重渲，日历机器推迟一拍再从这里取网格现查\n  calendar.refs.set('getGridEl', () => gridRef.value)\n\n  const api = computed(() => connectDatePicker(services, vueNormalize))\n  return { api, services, controlRef, positionerRef, contentRef, gridRef }\n}\n"],"mappings":";;;;;;;;AA6BA,SAAgB,cACd,OACA,WAAuG,CAAC,GACrF;CACnB,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,UAAU,IAAwB,IAAI;CAG5C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAGrC,MAAM,OAAO,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CACnF,MAAM,WAAW,WAA2B,uBAAuB,wBAAwB,IAAI,GAAG,KAAK;CAIvG,MAAM,WAA+B;EAAE;EAAM;EAAU,OAHzC,WAA4B,wBAAwB,qBAAqB,IAAI,GAAG,KAGnC;EAAG,UAD7C,WAA4B,wBAAwB,wBAAwB,IAAI,GAAG,KAC/B;CAAE;CAEvE,IAAI,OAAO,aAAa,aAAa;EACnC,MAAM,SAAwB,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG/E,MAAM,sBAA0D,OAAO,cAAc,SAAS;GAC5F,MAAM;GACN,YAAY,WAAW;GAEvB,gBAAgB,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,OAAO;GACjD,eAAe;GACf,gBAAgB,CAAC;GACjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,KAAK,KAAK,IAAI,UAAU,MAAM;EAC9B,KAAK,KAAK,IAAI,iBAAiB,aAAa;EAC5C,KAAK,KAAK,IAAI,YAAY,qBAAqB,CAAC;EAChD,KAAK,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACnD,KAAK,KAAK,IAAI,uBAAuB,cAAc,KAAK;EACxD,KAAK,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACtD;CAGA,SAAS,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAGlD,OAAO;EAAE,KADG,eAAe,kBAAkB,UAAU,YAAY,CACxD;EAAG;EAAU;EAAY;EAAe;EAAY;CAAQ;AACzE"}
+{"version":3,"file":"use-date-picker.js","names":[],"sources":["../../../src/components/date-picker/use-date-picker.ts"],"sourcesContent":["import type { CalendarSchema, DateFieldSchema, DatePickerApi, DatePickerSchema, DatePickerServices } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { ComputedRef, Ref } from 'vue'\nimport {\n  calendarMachine,\n  connectDatePicker,\n  dateFieldMachine,\n  datePickerCalendarProps,\n  datePickerFieldEndProps,\n  datePickerFieldProps,\n  datePickerMachine,\n} from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { createPositionEngine } from '@xihan-ui/position'\nimport { computed, ref } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useOverlayExit } from '../../runtime/use-overlay-exit'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DatePickerContext {\n  api: ComputedRef<DatePickerApi>\n  /** 四台机器的把手，供部件上报 DOM 侧的事实。 */\n  services: DatePickerServices\n  controlRef: Ref<HTMLElement | null>\n  positionerRef: Ref<HTMLElement | null>\n  contentRef: Ref<HTMLElement | null>\n  /** 此刻该不该渲染：退场动画播完之前仍为真。 */\n  visible: Ref<boolean>\n  gridRef: Ref<HTMLElement | null>\n  /** 浮层搬到哪儿：全局配置的 portalContainer > body。 */\n  portalTarget: ComputedRef<string | Element>\n}\n\nexport function useDatePicker(\n  props: DatePickerSchema['props'],\n  handlers: Pick<DatePickerSchema['props'], 'onValueChange' | 'onOpenChange' | 'onFocusedValueChange' | 'onActiveViewChange'> = {},\n): DatePickerContext {\n  const xhConfig = useXhConfig()\n  const controlRef = ref<HTMLElement | null>(null)\n  const positionerRef = ref<HTMLElement | null>(null)\n  const contentRef = ref<HTMLElement | null>(null)\n  const gridRef = ref<HTMLElement | null>(null)\n\n  // 四台机器共用一份 scope，part id 里带组件名区分；两组段位不产出 id，同 scope 不会撞\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n\n  // 三台内嵌机器的 props 都从编排机现读，编排机须先建立\n  const root = useMachine(datePickerMachine, () => ({ ...props, ...handlers }), scope)\n  const calendar = useMachine<CalendarSchema>(calendarMachine, () => datePickerCalendarProps(root), scope)\n  const field = useMachine<DateFieldSchema>(dateFieldMachine, () => datePickerFieldProps(root), scope)\n  // 终点那组段位无条件建：机器实例数不随模式变，非区间模式下它的值恒为空且不参与写值\n  const fieldEnd = useMachine<DateFieldSchema>(dateFieldMachine, () => datePickerFieldEndProps(root), scope)\n  const services: DatePickerServices = { root, calendar, field, fieldEnd }\n\n  // 服务端没有 DOM、也就没有退场：config 传 null 时闸门退化成「跟着展开态」\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({ scope, idGenerator: idGen })\n\n    // 只提供注册函数，入栈出栈由机器的 trackLayer 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'popover',\n      node: () => contentRef.value,\n      // 整个输入行记为本层分支，点 trigger 或段位算层内交互；\n      // 浮层壳一并记上：content 之外还浮着自绘滚动条，按住它拖动不该把浮层消解掉\n      branches: () => [controlRef.value, positionerRef.value].filter(Boolean) as Element[],\n      isModal: () => false,\n      setModal: () => {},\n      surfaces: () => [],\n    })\n\n    // 定位引擎由适配器注入，机器只经端口驱动；锚点取整个输入行\n    root.refs.set('config', config!)\n    root.refs.set('registerLayer', registerLayer)\n    root.refs.set('position', createPositionEngine())\n    root.refs.set('getAnchorEl', () => controlRef.value)\n    root.refs.set('getFloatingEl', () => positionerRef.value)\n    root.refs.set('getContentEl', () => contentRef.value)\n  }\n\n  // 跨月后的焦点落点要等重渲，日历机器推迟一拍再从这里取网格现查\n  calendar.refs.set('getGridEl', () => gridRef.value)\n\n  const api = computed(() => connectDatePicker(services, vueNormalize))\n  // 退场闸门：收起从跟着 open 走，改成跟着 presence 走\n  const visible = useOverlayExit({ config, isOpen: () => api.value.open, contentRef })\n  // 先问全局配置的落点，没有才落 body\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { visible, api, services, controlRef, positionerRef, contentRef, gridRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;;AAmCA,SAAgB,cACd,OACA,WAA8H,CAAC,GAC5G;CACnB,MAAM,WAAW,YAAY;CAC7B,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,gBAAgB,IAAwB,IAAI;CAClD,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,UAAU,IAAwB,IAAI;CAG5C,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CAGrC,MAAM,OAAO,WAAW,0BAA0B;EAAE,GAAG;EAAO,GAAG;CAAS,IAAI,KAAK;CACnF,MAAM,WAAW,WAA2B,uBAAuB,wBAAwB,IAAI,GAAG,KAAK;CAIvG,MAAM,WAA+B;EAAE;EAAM;EAAU,OAHzC,WAA4B,wBAAwB,qBAAqB,IAAI,GAAG,KAGnC;EAAG,UAD7C,WAA4B,wBAAwB,wBAAwB,IAAI,GAAG,KAC/B;CAAE;CAGvE,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAG1D,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GAGvB,gBAAgB,CAAC,WAAW,OAAO,cAAc,KAAK,CAAC,CAAC,OAAO,OAAO;GACtE,eAAe;GACf,gBAAgB,CAAC;GACjB,gBAAgB,CAAC;EACnB,CAAC;EAGD,KAAK,KAAK,IAAI,UAAU,MAAO;EAC/B,KAAK,KAAK,IAAI,iBAAiB,aAAa;EAC5C,KAAK,KAAK,IAAI,YAAY,qBAAqB,CAAC;EAChD,KAAK,KAAK,IAAI,qBAAqB,WAAW,KAAK;EACnD,KAAK,KAAK,IAAI,uBAAuB,cAAc,KAAK;EACxD,KAAK,KAAK,IAAI,sBAAsB,WAAW,KAAK;CACtD;CAGA,SAAS,KAAK,IAAI,mBAAmB,QAAQ,KAAK;CAElD,MAAM,MAAM,eAAe,kBAAkB,UAAU,YAAY,CAAC;CAMpE,OAAO;EAAE,SAJO,eAAe;GAAE;GAAQ,cAAc,IAAI,MAAM;GAAM;EAAW,CAInE;EAAG;EAAK;EAAU;EAAY;EAAe;EAAY;EAAS,cAF5D,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAE7B;CAAE;AAChG"}

package/dist/components/descriptions/context.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/descriptions/context.ts"],"sourcesContent":["import type { DescriptionsApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface DescriptionsContext {\n  api: ComputedRef<DescriptionsApi>\n}\n\nconst KEY: InjectionKey<DescriptionsContext> = Symbol('xh-descriptions')\n\nexport function provideDescriptions(ctx: DescriptionsContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDescriptionsContext(): DescriptionsContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Descriptions 部件必须用在 XhDescriptionsRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAyC,OAAO,iBAAiB;AAEvE,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+CAA+C;CACjE,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/descriptions/context.ts"],"sourcesContent":["import type { DescriptionsApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface DescriptionsContext {\n  api: ComputedRef<DescriptionsApi>\n}\n\nconst KEY: InjectionKey<DescriptionsContext> = Symbol.for('xh-descriptions')\n\nexport function provideDescriptions(ctx: DescriptionsContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDescriptionsContext(): DescriptionsContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Descriptions 部件必须用在 XhDescriptionsRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAyC,OAAO,IAAI,iBAAiB;AAE3E,SAAgB,oBAAoB,KAAgC;CAClE,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,yBAA8C;CAC5D,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,+CAA+C;CACjE,OAAO;AACT"}

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

@@ -1 +1 @@
-{"version":3,"file":"descriptions.d.ts","names":[],"sources":["../../../src/components/descriptions/descriptions.ts"],"mappings":";;;;cAQa,kCAAkB,8BAAA;;IAIA,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;;;;;;;;;IAHN,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;;;;;;;;;;;qCAcnC;cAGW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;qCAU7B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B"}
+{"version":3,"file":"descriptions.d.ts","names":[],"sources":["../../../src/components/descriptions/descriptions.ts"],"mappings":";;;;cASa,kCAAkB,8BAAA;;IAIA,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;;;;;;;;;IAHN,MAAA,SAAS;;;;;IAEP,MAAA,SAAS;;;;IACd,MAAA,SAAS;;;;;;;;;;;;;;qCAgBnC;cAGW,kCAAkB,8BAAA;;;;;;;;;;;;;;;;qCAU7B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B;cAEW,mCAAmB,8BAAA;;;;;;;;;;;;;;;;qCAU9B"}

package/dist/components/descriptions/descriptions.js

@@ -1,4 +1,5 @@
 import { vueNormalize } from "../../runtime/normalize-props.js";
+import { withXhConfig } from "../../config/config.js";
 import { provideDescriptions, useDescriptionsContext } from "./context.js";
 import { computed, defineComponent, h } from "vue";
 import { connectDescriptions } from "@xihan-ui/headless";
@@ -26,11 +27,12 @@ const XhDescriptionsRoot = defineComponent({
 		}
 	},
 	setup(props, { slots }) {
+		const configured = withXhConfig("descriptions", props);
 		const api = computed(() => connectDescriptions({
-			columns: props.columns,
-			bordered: props.bordered,
-			placement: props.placement,
-			size: props.size
+			columns: configured.columns,
+			bordered: configured.bordered,
+			placement: configured.placement,
+			size: configured.size
 		}, vueNormalize));
 		provideDescriptions({ api });
 		return () => h(props.as, api.value.getRootProps(), slots.default?.());

package/dist/components/descriptions/descriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"descriptions.js","names":[],"sources":["../../../src/components/descriptions/descriptions.ts"],"sourcesContent":["import type { DescriptionsColumns, DescriptionsPlacement } from '@xihan-ui/headless'\nimport type { Size } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport { connectDescriptions } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideDescriptions, useDescriptionsContext } from './context'\n\nexport const XhDescriptionsRoot = defineComponent({\n  name: 'XhDescriptionsRoot',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    columns: { type: Number as PropType<DescriptionsColumns>, default: undefined },\n    bordered: Boolean,\n    placement: { type: String as PropType<DescriptionsPlacement>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    /** 根渲染成哪个标签，默认 dl。 */\n    as: { type: String, default: 'dl' },\n  },\n  setup(props, { slots }) {\n    const api = computed(() => connectDescriptions({\n      columns: props.columns,\n      bordered: props.bordered,\n      placement: props.placement,\n      size: props.size,\n    }, vueNormalize))\n    provideDescriptions({ api })\n    return () => h(props.as, api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 一组「标签 + 取值」包一层，让它成为网格里的一格；dl 允许 div 包裹成对的 dt/dd\nexport const XhDescriptionsItem = defineComponent({\n  name: 'XhDescriptionsItem',\n  props: {\n    /** 每一格渲染成哪个标签，默认 div。 */\n    as: { type: String, default: 'div' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsLabel = defineComponent({\n  name: 'XhDescriptionsLabel',\n  props: {\n    /** 标签渲染成哪个标签，默认 dt。 */\n    as: { type: String, default: 'dt' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsValue = defineComponent({\n  name: 'XhDescriptionsValue',\n  props: {\n    /** 取值渲染成哪个标签，默认 dd。 */\n    as: { type: String, default: 'dd' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getValueProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAQA,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,OAAO;EACL,SAAS;GAAE,MAAM;GAAyC,SAAS,KAAA;EAAU;EAC7E,UAAU;EACV,WAAW;GAAE,MAAM;GAA2C,SAAS,KAAA;EAAU;EACjF,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;;EAE3D,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAK;CACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,eAAe,oBAAoB;GAC7C,SAAS,MAAM;GACf,UAAU,MAAM;GAChB,WAAW,MAAM;GACjB,MAAM,MAAM;EACd,GAAG,YAAY,CAAC;EAChB,oBAAoB,EAAE,IAAI,CAAC;EAC3B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAM,EACrC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC"}
+{"version":3,"file":"descriptions.js","names":[],"sources":["../../../src/components/descriptions/descriptions.ts"],"sourcesContent":["import type { DescriptionsColumns, DescriptionsPlacement } from '@xihan-ui/headless'\nimport type { Size } from '@xihan-ui/kernel'\nimport type { PropType } from 'vue'\nimport { connectDescriptions } from '@xihan-ui/headless'\nimport { computed, defineComponent, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { provideDescriptions, useDescriptionsContext } from './context'\n\nexport const XhDescriptionsRoot = defineComponent({\n  name: 'XhDescriptionsRoot',\n  // 有 connect 兜底的 prop 一律 default: undefined\n  props: {\n    columns: { type: Number as PropType<DescriptionsColumns>, default: undefined },\n    bordered: Boolean,\n    placement: { type: String as PropType<DescriptionsPlacement>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    /** 根渲染成哪个标签，默认 dl。 */\n    as: { type: String, default: 'dl' },\n  },\n  setup(props, { slots }) {\n    // withXhConfig 只能在 setup 期调，连接层在渲染期读这份代理\n    const configured = withXhConfig('descriptions', props)\n    const api = computed(() => connectDescriptions({\n      columns: configured.columns,\n      bordered: configured.bordered,\n      placement: configured.placement,\n      size: configured.size,\n    }, vueNormalize))\n    provideDescriptions({ api })\n    return () => h(props.as, api.value.getRootProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\n// 一组「标签 + 取值」包一层，让它成为网格里的一格；dl 允许 div 包裹成对的 dt/dd\nexport const XhDescriptionsItem = defineComponent({\n  name: 'XhDescriptionsItem',\n  props: {\n    /** 每一格渲染成哪个标签，默认 div。 */\n    as: { type: String, default: 'div' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getItemProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsLabel = defineComponent({\n  name: 'XhDescriptionsLabel',\n  props: {\n    /** 标签渲染成哪个标签，默认 dt。 */\n    as: { type: String, default: 'dt' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDescriptionsValue = defineComponent({\n  name: 'XhDescriptionsValue',\n  props: {\n    /** 取值渲染成哪个标签，默认 dd。 */\n    as: { type: String, default: 'dd' },\n  },\n  setup(props, { slots }) {\n    const ctx = useDescriptionsContext()\n    return () => h(props.as, ctx.api.value.getValueProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AASA,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CAEN,OAAO;EACL,SAAS;GAAE,MAAM;GAAyC,SAAS,KAAA;EAAU;EAC7E,UAAU;EACV,WAAW;GAAE,MAAM;GAA2C,SAAS,KAAA;EAAU;EACjF,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;;EAE3D,IAAI;GAAE,MAAM;GAAQ,SAAS;EAAK;CACpC;CACA,MAAM,OAAO,EAAE,SAAS;EAEtB,MAAM,aAAa,aAAa,gBAAgB,KAAK;EACrD,MAAM,MAAM,eAAe,oBAAoB;GAC7C,SAAS,WAAW;GACpB,UAAU,WAAW;GACrB,WAAW,WAAW;GACtB,MAAM,WAAW;EACnB,GAAG,YAAY,CAAC;EAChB,oBAAoB,EAAE,IAAI,CAAC;EAC3B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACjG;AACF,CAAC;AAGD,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAM,EACrC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,OAAO;;AAEL,IAAI;EAAE,MAAM;EAAQ,SAAS;CAAK,EACpC;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,uBAAuB;EACnC,aAAa,EAAE,MAAM,IAAI,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACtG;AACF,CAAC"}

package/dist/components/dialog/context.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/dialog/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { DialogContext } from './use-dialog'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<DialogContext> = Symbol('xh-dialog')\n\nexport function provideDialog(ctx: DialogContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDialogContext(): DialogContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Dialog 部件必须用在 XhDialogRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAmC,OAAO,WAAW;AAE3D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/dialog/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { DialogContext } from './use-dialog'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<DialogContext> = Symbol.for('xh-dialog')\n\nexport function provideDialog(ctx: DialogContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDialogContext(): DialogContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Dialog 部件必须用在 XhDialogRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAmC,OAAO,IAAI,WAAW;AAE/D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}

package/dist/components/dialog/dialog.d.ts

@@ -32,6 +32,10 @@ declare const XhDialogRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: boolean;
   };
+  initialFocus: {
+    type: StringConstructor;
+    default: undefined;
+  };
   size: {
     type: PropType<Size>;
     default: undefined;
@@ -71,6 +75,10 @@ declare const XhDialogRoot: import("vue").DefineComponent<import("vue").ExtractP
     type: BooleanConstructor;
     default: boolean;
   };
+  initialFocus: {
+    type: StringConstructor;
+    default: undefined;
+  };
   size: {
     type: PropType<Size>;
     default: undefined;
@@ -84,20 +92,29 @@ declare const XhDialogRoot: import("vue").DefineComponent<import("vue").ExtractP
   "onUpdate:open"?: ((_open: boolean) => any) | undefined;
 }>, {
   size: Size;
+  translations: Partial<import("@xihan-ui/headless").DialogTranslations> | undefined;
   open: boolean;
   defaultOpen: boolean;
-  translations: Partial<import("@xihan-ui/headless").DialogTranslations> | undefined;
   modal: boolean;
   role: "dialog" | "alertdialog";
   closeOnEscape: boolean;
   closeOnInteractOutside: boolean;
   restoreFocus: boolean;
+  initialFocus: string;
 }, SlotsType<{
   default?: (props: DialogRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhDialogTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhDialogTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+  asChild: BooleanConstructor;
+}>> & Readonly<{}>, {
+  asChild: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhDialogContent: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -1 +1 @@
-{"version":3,"file":"dialog.d.ts","names":[],"sources":["../../../src/components/dialog/dialog.ts"],"mappings":";;;;;KASK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAMG,MAAA;;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;;IACD,MAAA,SAAS;;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;IAVT,MAAA;;;;;;;;;;;;;;;;IAIA,MAAA,SAAS;;;;IACD,MAAA,SAAS;;;;;;;;;;;;;;;;;EAQ/B,WAAC,OAAO,wBAAwB;kCAW5C;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;8BAM1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCAwB1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"dialog.d.ts","names":[],"sources":["../../../src/components/dialog/dialog.ts"],"mappings":";;;;;KAUK,cAAc;;KAGP,sBAAsB,KAAK;cAE1B,4BAAY,8BAAA;;;;;;;;;;;IAMG,MAAA;;;;;;;;;;;;;;;;;;;;IAKA,MAAA,SAAS;;;;IACD,MAAA,SAAS;;;;;;EAIf,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;IAXT,MAAA;;;;;;;;;;;;;;;;;;;;IAKA,MAAA,SAAS;;;;IACD,MAAA,SAAS;;;;;;;;;;;;;;;;;;EAQ/B,WAAC,OAAO,wBAAwB;kCAW5C;cAEW,+BAAe,8BAAA;;;;;;;;;;qCAoB1B;cAEW,+BAAe,0BAAA,oBAAA,4BAAA;;qCA0B1B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6BAAa,0BAAA,oBAAA,4BAAA;;8BAMxB,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;8BAM9B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

package/dist/components/dialog/dialog.js

@@ -1,7 +1,8 @@
 import { withXhConfig } from "../../config/config.js";
+import { mergeIntoChild } from "../../runtime/as-child.js";
 import { provideDialog, useDialogContext } from "./context.js";
 import { useDialog } from "./use-dialog.js";
-import { Teleport, defineComponent, h } from "vue";
+import { Teleport, defineComponent, h, mergeProps } from "vue";
 //#region src/components/dialog/dialog.ts
 const XhDialogRoot = defineComponent({
 	name: "XhDialogRoot",
@@ -31,6 +32,10 @@ const XhDialogRoot = defineComponent({
 			type: Boolean,
 			default: true
 		},
+		initialFocus: {
+			type: String,
+			default: void 0
+		},
 		size: {
 			type: String,
 			default: void 0
@@ -60,25 +65,37 @@ const XhDialogRoot = defineComponent({
 });
 const XhDialogTrigger = defineComponent({
 	name: "XhDialogTrigger",
-	setup(_, { slots }) {
+	props: { 
+	/** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */
+asChild: Boolean },
+	setup(props, { slots }) {
 		const ctx = useDialogContext();
-		return () => h("button", ctx.api.value.getTriggerProps(), slots.default?.());
+		return () => {
+			const attrs = ctx.api.value.getTriggerProps();
+			const children = slots.default?.();
+			if (props.asChild) {
+				const merged = mergeIntoChild(children, attrs, "dialog");
+				if (merged) return merged;
+			}
+			return h("button", attrs, children);
+		};
 	}
 });
 const XhDialogContent = defineComponent({
 	name: "XhDialogContent",
-	setup(_, { slots }) {
+	inheritAttrs: false,
+	setup(_, { slots, attrs }) {
 		const ctx = useDialogContext();
 		return () => {
 			if (!ctx.rendered.value) return null;
 			const api = ctx.api.value;
-			return h(Teleport, { to: "body" }, [api.open || ctx.rendered.value ? h("div", {
+			return h(Teleport, { to: ctx.portalTarget.value }, [api.open || ctx.rendered.value ? h("div", {
 				...api.getBackdropProps(),
 				ref: (el) => {
 					ctx.backdropRef.value = el;
 				}
 			}) : null, h("div", api.getPositionerProps(), [h("div", {
-				...api.getContentProps(),
+				...mergeProps(api.getContentProps(), attrs),
 				ref: (el) => {
 					ctx.contentRef.value = el;
 				}

package/dist/components/dialog/dialog.js.map

@@ -1 +1 @@
-{"version":3,"file":"dialog.js","names":[],"sources":["../../../src/components/dialog/dialog.ts"],"sourcesContent":["import type { DialogApi, DialogSchema } from '@xihan-ui/headless'\nimport type { Size } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, Teleport } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideDialog, useDialogContext } from './context'\nimport { useDialog } from './use-dialog'\n\ntype DialogProps = DialogSchema['props']\n\n/** 默认插槽的载荷：展开态与改展开的动作。 */\nexport type DialogRootSlotProps = Pick<DialogApi, 'open' | 'setOpen'>\n\nexport const XhDialogRoot = defineComponent({\n  name: 'XhDialogRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: true },\n    role: { type: String as PropType<'dialog' | 'alertdialog'>, default: 'dialog' },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: true },\n    size: { type: String as PropType<Size>, default: undefined },\n    translations: { type: Object as PropType<DialogProps['translations']>, default: undefined },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DialogProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DialogProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DialogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DialogProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useDialog(withXhConfig('dialog', props) as DialogProps, notify)\n    provideDialog(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhDialogTrigger = defineComponent({\n  name: 'XhDialogTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogContent = defineComponent({\n  name: 'XhDialogContent',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => {\n      if (!ctx.rendered.value)\n        return null\n      const api = ctx.api.value\n      return h(Teleport, { to: 'body' }, [\n        api.open || ctx.rendered.value\n          ? h('div', {\n              ...api.getBackdropProps() as Record<string, unknown>,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', api.getPositionerProps() as Record<string, unknown>, [\n          h('div', {\n            ...api.getContentProps() as Record<string, unknown>,\n            ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n          }, slots.default?.()),\n        ]),\n      ])\n    }\n  },\n})\n\nexport const XhDialogTitle = defineComponent({\n  name: 'XhDialogTitle',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogDescription = defineComponent({\n  name: 'XhDialogDescription',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogCloseTrigger = defineComponent({\n  name: 'XhDialogCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;AAcA,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,OAAO;GAAE,MAAM;GAAS,SAAS;EAAK;EACtC,MAAM;GAAE,MAAM;GAA8C,SAAS;EAAS;EAC9E,eAAe;GAAE,MAAM;GAAS,SAAS;EAAK;EAC9C,wBAAwB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC5D,cAAc;GAAE,MAAM;GAAS,SAAS;EAAK;EAC7C,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,cAAc;GAAE,MAAM;GAAiD,SAAS,KAAA;EAAU;CAC5F;CAEA,OAAO;EACL,gBAAgB,aAAqD;EACrE,gBAAgB,UAA0D;CAC5E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAuC,YAAY;GACvD,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,UAAU,aAAa,UAAU,KAAK,GAAkB,MAAM;EAC1E,cAAc,GAAG;EACjB,aAAa,MAAM,UAAU;GAAE,MAAM,IAAI,IAAI,MAAM;GAAM,SAAS,IAAI,IAAI,MAAM;EAAQ,CAAC;CAC3F;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACxG;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa;GACX,IAAI,CAAC,IAAI,SAAS,OAChB,OAAO;GACT,MAAM,MAAM,IAAI,IAAI;GACpB,OAAO,EAAE,UAAU,EAAE,IAAI,OAAO,GAAG,CACjC,IAAI,QAAQ,IAAI,SAAS,QACrB,EAAE,OAAO;IACP,GAAG,IAAI,iBAAiB;IACxB,MAAM,OAAgB;KAAE,IAAI,YAAY,QAAQ;IAAkB;GACpE,CAAC,IACD,MACJ,EAAE,OAAO,IAAI,mBAAmB,GAA8B,CAC5D,EAAE,OAAO;IACP,GAAG,IAAI,gBAAgB;IACvB,MAAM,OAAgB;KAAE,IAAI,WAAW,QAAQ;IAAkB;GACnE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC,CACH,CAAC;EACH;CACF;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC"}
+{"version":3,"file":"dialog.js","names":[],"sources":["../../../src/components/dialog/dialog.ts"],"sourcesContent":["import type { DialogApi, DialogSchema } from '@xihan-ui/headless'\nimport type { Size } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps, Teleport } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { mergeIntoChild } from '../../runtime/as-child'\nimport { provideDialog, useDialogContext } from './context'\nimport { useDialog } from './use-dialog'\n\ntype DialogProps = DialogSchema['props']\n\n/** 默认插槽的载荷：展开态与改展开的动作。 */\nexport type DialogRootSlotProps = Pick<DialogApi, 'open' | 'setOpen'>\n\nexport const XhDialogRoot = defineComponent({\n  name: 'XhDialogRoot',\n  props: {\n    open: { type: Boolean, default: undefined },\n    defaultOpen: Boolean,\n    modal: { type: Boolean, default: true },\n    role: { type: String as PropType<'dialog' | 'alertdialog'>, default: 'dialog' },\n    closeOnEscape: { type: Boolean, default: true },\n    closeOnInteractOutside: { type: Boolean, default: undefined },\n    restoreFocus: { type: Boolean, default: true },\n    initialFocus: { type: String, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    translations: { type: Object as PropType<DialogProps['translations']>, default: undefined },\n  },\n  // open-change 携带 { open }，update:open 携带裸布尔\n  emits: {\n    'open-change': (_details: PayloadOf<DialogProps, 'onOpenChange'>) => true,\n    'update:open': (_open: PayloadOf<DialogProps, 'onOpenChange'>['open']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DialogRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: DialogProps['onOpenChange'] = (details) => {\n      emit('open-change', details)\n      emit('update:open', details.open)\n    }\n    const ctx = useDialog(withXhConfig('dialog', props) as DialogProps, notify)\n    provideDialog(ctx)\n    return () => slots.default?.({ open: ctx.api.value.open, setOpen: ctx.api.value.setOpen })\n  },\n})\n\nexport const XhDialogTrigger = defineComponent({\n  name: 'XhDialogTrigger',\n  props: {\n    /** 借用作者的子节点当触发器，不再渲染自己的包裹元素；子节点须恰好一个。 */\n    asChild: Boolean,\n  },\n  setup(props, { slots }) {\n    const ctx = useDialogContext()\n    return () => {\n      const attrs = ctx.api.value.getTriggerProps() as Record<string, unknown>\n      const children = slots.default?.()\n      // asChild：把触发器属性合到作者的节点上，不再自己渲染包裹元素\n      if (props.asChild) {\n        const merged = mergeIntoChild(children, attrs, 'dialog')\n        if (merged)\n          return merged\n      }\n      return h('button', attrs, children)\n    }\n  },\n})\n\nexport const XhDialogContent = defineComponent({\n  name: 'XhDialogContent',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 content 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = useDialogContext()\n    return () => {\n      if (!ctx.rendered.value)\n        return null\n      const api = ctx.api.value\n      return h(Teleport, { to: ctx.portalTarget.value }, [\n        api.open || ctx.rendered.value\n          ? h('div', {\n              ...api.getBackdropProps() as Record<string, unknown>,\n              ref: (el: unknown) => { ctx.backdropRef.value = el as HTMLElement },\n            })\n          : null,\n        h('div', api.getPositionerProps() as Record<string, unknown>, [\n          h('div', {\n            ...mergeProps(api.getContentProps() as Record<string, unknown>, attrs),\n            ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n          }, slots.default?.()),\n        ]),\n      ])\n    }\n  },\n})\n\nexport const XhDialogTitle = defineComponent({\n  name: 'XhDialogTitle',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('h2', ctx.api.value.getTitleProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogDescription = defineComponent({\n  name: 'XhDialogDescription',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('p', ctx.api.value.getDescriptionProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhDialogCloseTrigger = defineComponent({\n  name: 'XhDialogCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useDialogContext()\n    return () => h('button', ctx.api.value.getCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;;;AAeA,MAAa,eAAe,gBAAgB;CAC1C,MAAM;CACN,OAAO;EACL,MAAM;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC1C,aAAa;EACb,OAAO;GAAE,MAAM;GAAS,SAAS;EAAK;EACtC,MAAM;GAAE,MAAM;GAA8C,SAAS;EAAS;EAC9E,eAAe;GAAE,MAAM;GAAS,SAAS;EAAK;EAC9C,wBAAwB;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;EAC5D,cAAc;GAAE,MAAM;GAAS,SAAS;EAAK;EAC7C,cAAc;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACjD,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,cAAc;GAAE,MAAM;GAAiD,SAAS,KAAA;EAAU;CAC5F;CAEA,OAAO;EACL,gBAAgB,aAAqD;EACrE,gBAAgB,UAA0D;CAC5E;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAAuC,YAAY;GACvD,KAAK,eAAe,OAAO;GAC3B,KAAK,eAAe,QAAQ,IAAI;EAClC;EACA,MAAM,MAAM,UAAU,aAAa,UAAU,KAAK,GAAkB,MAAM;EAC1E,cAAc,GAAG;EACjB,aAAa,MAAM,UAAU;GAAE,MAAM,IAAI,IAAI,MAAM;GAAM,SAAS,IAAI,IAAI,MAAM;EAAQ,CAAC;CAC3F;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CACN,OAAO;;AAEL,SAAS,QACX;CACA,MAAM,OAAO,EAAE,SAAS;EACtB,MAAM,MAAM,iBAAiB;EAC7B,aAAa;GACX,MAAM,QAAQ,IAAI,IAAI,MAAM,gBAAgB;GAC5C,MAAM,WAAW,MAAM,UAAU;GAEjC,IAAI,MAAM,SAAS;IACjB,MAAM,SAAS,eAAe,UAAU,OAAO,QAAQ;IACvD,IAAI,QACF,OAAO;GACX;GACA,OAAO,EAAE,UAAU,OAAO,QAAQ;EACpC;CACF;AACF,CAAC;AAED,MAAa,kBAAkB,gBAAgB;CAC7C,MAAM;CAEN,cAAc;CACd,MAAM,GAAG,EAAE,OAAO,SAAS;EACzB,MAAM,MAAM,iBAAiB;EAC7B,aAAa;GACX,IAAI,CAAC,IAAI,SAAS,OAChB,OAAO;GACT,MAAM,MAAM,IAAI,IAAI;GACpB,OAAO,EAAE,UAAU,EAAE,IAAI,IAAI,aAAa,MAAM,GAAG,CACjD,IAAI,QAAQ,IAAI,SAAS,QACrB,EAAE,OAAO;IACP,GAAG,IAAI,iBAAiB;IACxB,MAAM,OAAgB;KAAE,IAAI,YAAY,QAAQ;IAAkB;GACpE,CAAC,IACD,MACJ,EAAE,OAAO,IAAI,mBAAmB,GAA8B,CAC5D,EAAE,OAAO;IACP,GAAG,WAAW,IAAI,gBAAgB,GAA8B,KAAK;IACrE,MAAM,OAAgB;KAAE,IAAI,WAAW,QAAQ;IAAkB;GACnE,GAAG,MAAM,UAAU,CAAC,CACtB,CAAC,CACH,CAAC;EACH;CACF;AACF,CAAC;AAED,MAAa,gBAAgB,gBAAgB;CAC3C,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,MAAM,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CAClG;AACF,CAAC;AAED,MAAa,sBAAsB,gBAAgB;CACjD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,KAAK,IAAI,IAAI,MAAM,oBAAoB,GAA8B,MAAM,UAAU,CAAC;CACvG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,iBAAiB;EAC7B,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,qBAAqB,GAA8B,MAAM,UAAU,CAAC;CAC7G;AACF,CAAC"}

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

@@ -5,6 +5,8 @@ import { Service } from "@xihan-ui/machine";
 interface DialogContext {
   service: Service<DialogSchema>;
   api: ComputedRef<DialogApi>;
+  /** 浮层搬到哪儿：全局配置 > 单一落点。 */
+  portalTarget: ComputedRef<string | Element>;
   rendered: Ref<boolean>;
   contentRef: Ref<HTMLElement | null>;
   backdropRef: Ref<HTMLElement | null>;

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

@@ -1 +1 @@
-{"version":3,"file":"use-dialog.d.ts","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"mappings":";;;;UAaiB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;EACjB,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,UACd,OAAO,uBACP,eAAe,wCACd"}
+{"version":3,"file":"use-dialog.d.ts","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"mappings":";;;;UAciB;EACf,SAAS,QAAQ;EACjB,KAAK,YAAY;;EAEjB,cAAc,qBAAqB;EACnC,UAAU;EACV,YAAY,IAAI;EAChB,aAAa,IAAI;;iBAGH,UACd,OAAO,uBACP,eAAe,wCACd"}

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

@@ -1,10 +1,11 @@
 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 { computed, onBeforeUnmount, ref, watch } from "vue";
+import { attachCssExit, createPresence } from "@xihan-ui/behavior/presence";
 import { connectDialog, dialogMachine } from "@xihan-ui/headless";
 import { createRuntimeConfig, createScope } from "@xihan-ui/kernel";
-import { attachCssExit, createPresence } from "@xihan-ui/behavior/presence";
 //#region src/components/dialog/use-dialog.ts
 function useDialog(props, onOpenChange) {
 	const contentRef = ref(null);
@@ -16,10 +17,13 @@ function useDialog(props, onOpenChange) {
 		onOpenChange
 	}), scope);
 	const rendered = ref(service.state.get() === "open");
+	const xhConfig = useXhConfig();
+	let config = null;
 	if (typeof document !== "undefined") {
-		const config = createRuntimeConfig({
+		config = createRuntimeConfig({
 			scope,
-			idGenerator: idGen
+			idGenerator: idGen,
+			scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null
 		});
 		const registerLayer = () => config.layerRegistry.register({
 			kind: "modal",
@@ -59,7 +63,8 @@ function useDialog(props, onOpenChange) {
 		api: computed(() => connectDialog(service, vueNormalize)),
 		rendered,
 		contentRef,
-		backdropRef
+		backdropRef,
+		portalTarget: computed(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? "body")
 	};
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-dialog.js","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"sourcesContent":["import type { PresenceHandle } from '@xihan-ui/behavior/presence'\nimport type { DialogApi, DialogSchema } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { attachCssExit, createPresence } from '@xihan-ui/behavior/presence'\nimport { connectDialog, dialogMachine } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DialogContext {\n  service: Service<DialogSchema>\n  api: ComputedRef<DialogApi>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useDialog(\n  props: DialogSchema['props'],\n  onOpenChange?: DialogSchema['props']['onOpenChange'],\n): DialogContext {\n  const contentRef = ref<HTMLElement | null>(null)\n  const backdropRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(dialogMachine, () => ({ ...props, onOpenChange }), scope)\n\n  // 初值取状态而不是 false：presence 只在有 DOM 时才建，服务端拿不到它。\n  // 服务端算不出 rendered 就只发一个空占位，客户端水合时补出整棵子树 = mismatch。\n  const rendered = ref(service.state.get() === 'open')\n\n  if (typeof document !== 'undefined') {\n    const config: RuntimeConfig = createRuntimeConfig({ scope, idGenerator: idGen })\n    // 只提供注册函数，入栈出栈由机器的 trackOverlay 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config.layerRegistry.register({\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => props.modal ?? true,\n      setModal: () => {},\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n    const presence: PresenceHandle = createPresence({\n      config,\n      open: service.state.get() === 'open',\n      onRenderedChange: (r) => {\n        rendered.value = r\n      },\n    })\n    rendered.value = presence.rendered\n\n    service.refs.set('config', config)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('presence', presence)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getTriggerEl', () => null)\n    service.refs.set('branches', () => [])\n\n    // data-state 提交到 DOM 之后再驱动 presence，让退场探测读到正确的 animationName\n    watch(() => service.state.get() === 'open', open => presence.update(open), { flush: 'post' })\n\n    // content 就位后把它的 CSS 退场动画接到 presence 退出租约，无动画时关闭即卸载\n    let detachExit: (() => void) | undefined\n    watch(contentRef, (el) => {\n      detachExit?.()\n      detachExit = el ? attachCssExit(el, presence) : undefined\n    }, { flush: 'post' })\n\n    onBeforeUnmount(() => {\n      detachExit?.()\n      presence.dispose()\n    })\n  }\n\n  const api = computed(() => connectDialog(service, vueNormalize))\n  return { service, api, rendered, contentRef, backdropRef }\n}\n"],"mappings":";;;;;;;;AAqBA,SAAgB,UACd,OACA,cACe;CACf,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO;CAAa,IAAI,KAAK;CAInF,MAAM,WAAW,IAAI,QAAQ,MAAM,IAAI,MAAM,MAAM;CAEnD,IAAI,OAAO,aAAa,aAAa;EACnC,MAAM,SAAwB,oBAAoB;GAAE;GAAO,aAAa;EAAM,CAAC;EAE/E,MAAM,sBAA0D,OAAO,cAAc,SAAS;GAC5F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe,MAAM,SAAS;GAC9B,gBAAgB,CAAC;GACjB,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,CAAC;EACD,MAAM,WAA2B,eAAe;GAC9C;GACA,MAAM,QAAQ,MAAM,IAAI,MAAM;GAC9B,mBAAmB,MAAM;IACvB,SAAS,QAAQ;GACnB;EACF,CAAC;EACD,SAAS,QAAQ,SAAS;EAE1B,QAAQ,KAAK,IAAI,UAAU,MAAM;EACjC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,QAAQ;EACrC,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,IAAI;EAC3C,QAAQ,KAAK,IAAI,kBAAkB,CAAC,CAAC;EAGrC,YAAY,QAAQ,MAAM,IAAI,MAAM,SAAQ,SAAQ,SAAS,OAAO,IAAI,GAAG,EAAE,OAAO,OAAO,CAAC;EAG5F,IAAI;EACJ,MAAM,aAAa,OAAO;GACxB,aAAa;GACb,aAAa,KAAK,cAAc,IAAI,QAAQ,IAAI,KAAA;EAClD,GAAG,EAAE,OAAO,OAAO,CAAC;EAEpB,sBAAsB;GACpB,aAAa;GACb,SAAS,QAAQ;EACnB,CAAC;CACH;CAGA,OAAO;EAAE;EAAS,KADN,eAAe,cAAc,SAAS,YAAY,CAC1C;EAAG;EAAU;EAAY;CAAY;AAC3D"}
+{"version":3,"file":"use-dialog.js","names":[],"sources":["../../../src/components/dialog/use-dialog.ts"],"sourcesContent":["import type { PresenceHandle } from '@xihan-ui/behavior/presence'\nimport type { DialogApi, DialogSchema } from '@xihan-ui/headless'\nimport type { Cleanup, Layer, RuntimeConfig } from '@xihan-ui/kernel'\nimport type { Service } from '@xihan-ui/machine'\nimport type { ComputedRef, Ref } from 'vue'\nimport { attachCssExit, createPresence } from '@xihan-ui/behavior/presence'\nimport { connectDialog, dialogMachine } from '@xihan-ui/headless'\nimport { createRuntimeConfig, createScope } from '@xihan-ui/kernel'\nimport { computed, onBeforeUnmount, ref, watch } from 'vue'\nimport { useXhConfig } from '../../config/config'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { createVueIdGenerator } from '../../runtime/vue-id'\n\nexport interface DialogContext {\n  service: Service<DialogSchema>\n  api: ComputedRef<DialogApi>\n  /** 浮层搬到哪儿：全局配置 > 单一落点。 */\n  portalTarget: ComputedRef<string | Element>\n  rendered: Ref<boolean>\n  contentRef: Ref<HTMLElement | null>\n  backdropRef: Ref<HTMLElement | null>\n}\n\nexport function useDialog(\n  props: DialogSchema['props'],\n  onOpenChange?: DialogSchema['props']['onOpenChange'],\n): DialogContext {\n  const contentRef = ref<HTMLElement | null>(null)\n  const backdropRef = ref<HTMLElement | null>(null)\n\n  const idGen = createVueIdGenerator()\n  const scope = createScope(null, idGen)\n  const service = useMachine(dialogMachine, () => ({ ...props, onOpenChange }), scope)\n\n  // 初值取状态而不是 false：presence 只在有 DOM 时才建，服务端拿不到它。\n  // 服务端算不出 rendered 就只发一个空占位，客户端水合时补出整棵子树 = mismatch。\n  const rendered = ref(service.state.get() === 'open')\n\n  const xhConfig = useXhConfig()\n  let config: RuntimeConfig | null = null\n\n  if (typeof document !== 'undefined') {\n    config = createRuntimeConfig({\n      scope,\n      idGenerator: idGen,\n      // 宿主把滚动搬进内容容器时 body 本身不滚，加锁会是空操作；这条把真正在滚的那层交给滚动锁\n      scrollRoot: () => xhConfig.value.scrollRoot?.() ?? null,\n    })\n    // 只提供注册函数，入栈出栈由机器的 trackOverlay 效应按展开态驱动\n    const registerLayer = (): { layer: Layer, dispose: Cleanup } => config!.layerRegistry.register({\n      kind: 'modal',\n      node: () => contentRef.value,\n      branches: () => [],\n      isModal: () => props.modal ?? true,\n      setModal: () => {},\n      surfaces: () => [backdropRef.value].filter(Boolean) as Element[],\n    })\n    const presence: PresenceHandle = createPresence({\n      config,\n      open: service.state.get() === 'open',\n      onRenderedChange: (r) => {\n        rendered.value = r\n      },\n    })\n    rendered.value = presence.rendered\n\n    service.refs.set('config', config!)\n    service.refs.set('registerLayer', registerLayer)\n    service.refs.set('presence', presence)\n    service.refs.set('getContentEl', () => contentRef.value)\n    service.refs.set('getTriggerEl', () => null)\n    service.refs.set('branches', () => [])\n\n    // data-state 提交到 DOM 之后再驱动 presence，让退场探测读到正确的 animationName\n    watch(() => service.state.get() === 'open', open => presence.update(open), { flush: 'post' })\n\n    // content 就位后把它的 CSS 退场动画接到 presence 退出租约，无动画时关闭即卸载\n    let detachExit: (() => void) | undefined\n    watch(contentRef, (el) => {\n      detachExit?.()\n      detachExit = el ? attachCssExit(el, presence) : undefined\n    }, { flush: 'post' })\n\n    onBeforeUnmount(() => {\n      detachExit?.()\n      presence.dispose()\n    })\n  }\n\n  const api = computed(() => connectDialog(service, vueNormalize))\n  const portalTarget = computed<string | Element>(() => xhConfig.value.portalContainer?.() ?? config?.portalContainer() ?? 'body')\n\n  return { service, api, rendered, contentRef, backdropRef, portalTarget }\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,UACd,OACA,cACe;CACf,MAAM,aAAa,IAAwB,IAAI;CAC/C,MAAM,cAAc,IAAwB,IAAI;CAEhD,MAAM,QAAQ,qBAAqB;CACnC,MAAM,QAAQ,YAAY,MAAM,KAAK;CACrC,MAAM,UAAU,WAAW,sBAAsB;EAAE,GAAG;EAAO;CAAa,IAAI,KAAK;CAInF,MAAM,WAAW,IAAI,QAAQ,MAAM,IAAI,MAAM,MAAM;CAEnD,MAAM,WAAW,YAAY;CAC7B,IAAI,SAA+B;CAEnC,IAAI,OAAO,aAAa,aAAa;EACnC,SAAS,oBAAoB;GAC3B;GACA,aAAa;GAEb,kBAAkB,SAAS,MAAM,aAAa,KAAK;EACrD,CAAC;EAED,MAAM,sBAA0D,OAAQ,cAAc,SAAS;GAC7F,MAAM;GACN,YAAY,WAAW;GACvB,gBAAgB,CAAC;GACjB,eAAe,MAAM,SAAS;GAC9B,gBAAgB,CAAC;GACjB,gBAAgB,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,OAAO;EACpD,CAAC;EACD,MAAM,WAA2B,eAAe;GAC9C;GACA,MAAM,QAAQ,MAAM,IAAI,MAAM;GAC9B,mBAAmB,MAAM;IACvB,SAAS,QAAQ;GACnB;EACF,CAAC;EACD,SAAS,QAAQ,SAAS;EAE1B,QAAQ,KAAK,IAAI,UAAU,MAAO;EAClC,QAAQ,KAAK,IAAI,iBAAiB,aAAa;EAC/C,QAAQ,KAAK,IAAI,YAAY,QAAQ;EACrC,QAAQ,KAAK,IAAI,sBAAsB,WAAW,KAAK;EACvD,QAAQ,KAAK,IAAI,sBAAsB,IAAI;EAC3C,QAAQ,KAAK,IAAI,kBAAkB,CAAC,CAAC;EAGrC,YAAY,QAAQ,MAAM,IAAI,MAAM,SAAQ,SAAQ,SAAS,OAAO,IAAI,GAAG,EAAE,OAAO,OAAO,CAAC;EAG5F,IAAI;EACJ,MAAM,aAAa,OAAO;GACxB,aAAa;GACb,aAAa,KAAK,cAAc,IAAI,QAAQ,IAAI,KAAA;EAClD,GAAG,EAAE,OAAO,OAAO,CAAC;EAEpB,sBAAsB;GACpB,aAAa;GACb,SAAS,QAAQ;EACnB,CAAC;CACH;CAKA,OAAO;EAAE;EAAS,KAHN,eAAe,cAAc,SAAS,YAAY,CAG1C;EAAG;EAAU;EAAY;EAAa,cAFrC,eAAiC,SAAS,MAAM,kBAAkB,KAAK,QAAQ,gBAAgB,KAAK,MAEpD;CAAE;AACzE"}

package/dist/components/download-trigger/download-trigger.d.ts

@@ -0,0 +1,66 @@
+import { PayloadOf } from "../../runtime/payload.js";
+import { PropType, SlotsType, VNode } from "vue";
+import { DownloadTriggerApi, DownloadTriggerData, DownloadTriggerSchema } from "@xihan-ui/headless";
+//#region src/components/download-trigger/download-trigger.d.ts
+type DownloadTriggerProps = DownloadTriggerSchema['props'];
+/** 默认插槽的载荷：下载状态与禁用、这次会写出的文件名，以及走一次下载的句柄。 */
+type DownloadTriggerSlotProps = Pick<DownloadTriggerApi, 'status' | 'preparing' | 'disabled' | 'fileName' | 'download'>;
+/**
+ * 触发一次浏览器下载的按钮。
+ *
+ * 默认插槽拿得到 `{ status, preparing, disabled, fileName, download }`，
+ * 取数在途时可以据 `preparing` 换掉按钮上的文字。
+ */
+declare const XhDownloadTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  data: {
+    type: PropType<DownloadTriggerData>;
+    default: undefined;
+  };
+  fileName: {
+    type: StringConstructor;
+    default: undefined;
+  };
+  mimeType: {
+    type: StringConstructor;
+    default: undefined;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  'download-complete': (_details: PayloadOf<DownloadTriggerProps, "onDownloadComplete">) => true;
+  'download-error': (_details: PayloadOf<DownloadTriggerProps, "onDownloadError">) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  data: {
+    type: PropType<DownloadTriggerData>;
+    default: undefined;
+  };
+  fileName: {
+    type: StringConstructor;
+    default: undefined;
+  };
+  mimeType: {
+    type: StringConstructor;
+    default: undefined;
+  };
+  disabled: {
+    type: BooleanConstructor;
+    default: undefined;
+  };
+}>> & Readonly<{
+  "onDownload-complete"?: ((_details: import("@xihan-ui/headless").DownloadTriggerCompleteDetails) => any) | undefined;
+  "onDownload-error"?: ((_details: import("@xihan-ui/headless").DownloadTriggerErrorDetails) => any) | undefined;
+}>, {
+  data: DownloadTriggerData;
+  disabled: boolean;
+  fileName: string;
+  mimeType: string;
+}, SlotsType<{
+  default?: (props: DownloadTriggerSlotProps) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+export { DownloadTriggerSlotProps, XhDownloadTrigger };
+//# sourceMappingURL=download-trigger.d.ts.map

package/dist/components/download-trigger/download-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-trigger.d.ts","names":[],"sources":["../../../src/components/download-trigger/download-trigger.ts"],"mappings":";;;;KAMK,uBAAuB;;KAGhB,2BAA2B,KACrC;;;;;;;cAUW,iCAAiB,8BAAA;;IAKkB,MAAA,SAAS;;;;;;;;;;;;;;;;;;EAOrB,sBAAA,UAAA,UAAU;EACb,mBAAA,UAAA,UAAU;;;IARK,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;EAW3C,WAAC,OAAO,6BAA6B;kCAgBjD"}

package/dist/components/download-trigger/download-trigger.js

@@ -0,0 +1,56 @@
+import { useDownloadTrigger } from "./use-download-trigger.js";
+import { defineComponent, h } from "vue";
+//#region src/components/download-trigger/download-trigger.ts
+/**
+* 触发一次浏览器下载的按钮。
+*
+* 默认插槽拿得到 `{ status, preparing, disabled, fileName, download }`，
+* 取数在途时可以据 `preparing` 换掉按钮上的文字。
+*/
+const XhDownloadTrigger = defineComponent({
+	name: "XhDownloadTrigger",
+	props: {
+		data: {
+			type: [
+				String,
+				Function,
+				Object
+			],
+			default: void 0
+		},
+		fileName: {
+			type: String,
+			default: void 0
+		},
+		mimeType: {
+			type: String,
+			default: void 0
+		},
+		disabled: {
+			type: Boolean,
+			default: void 0
+		}
+	},
+	emits: {
+		"download-complete": (_details) => true,
+		"download-error": (_details) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const ctx = useDownloadTrigger(props, {
+			onDownloadComplete: (details) => emit("download-complete", details),
+			onDownloadError: (details) => emit("download-error", details)
+		});
+		return () => h("button", ctx.api.value.getRootProps(), slots.default?.({
+			status: ctx.api.value.status,
+			preparing: ctx.api.value.preparing,
+			disabled: ctx.api.value.disabled,
+			fileName: ctx.api.value.fileName,
+			download: ctx.api.value.download
+		}));
+	}
+});
+//#endregion
+export { XhDownloadTrigger };
+
+//# sourceMappingURL=download-trigger.js.map

package/dist/components/download-trigger/download-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-trigger.js","names":[],"sources":["../../../src/components/download-trigger/download-trigger.ts"],"sourcesContent":["import type { DownloadTriggerApi, DownloadTriggerData, DownloadTriggerSchema } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { useDownloadTrigger } from './use-download-trigger'\n\ntype DownloadTriggerProps = DownloadTriggerSchema['props']\n\n/** 默认插槽的载荷：下载状态与禁用、这次会写出的文件名，以及走一次下载的句柄。 */\nexport type DownloadTriggerSlotProps = Pick<\n  DownloadTriggerApi,\n  'status' | 'preparing' | 'disabled' | 'fileName' | 'download'\n>\n\n/**\n * 触发一次浏览器下载的按钮。\n *\n * 默认插槽拿得到 `{ status, preparing, disabled, fileName, download }`，\n * 取数在途时可以据 `preparing` 换掉按钮上的文字。\n */\nexport const XhDownloadTrigger = defineComponent({\n  name: 'XhDownloadTrigger',\n  // 缺省值由机器与 connect 给出，这里一律 default: undefined\n  props: {\n    // 文本与 Blob 是值形态，函数形态点了才调用\n    data: { type: [String, Function, Object] as PropType<DownloadTriggerData>, default: undefined },\n    fileName: { type: String, default: undefined },\n    mimeType: { type: String, default: undefined },\n    disabled: { type: Boolean, default: undefined },\n  },\n  // download-complete 携带 { fileName }；download-error 携带 { error, fileName }\n  emits: {\n    'download-complete': (_details: PayloadOf<DownloadTriggerProps, 'onDownloadComplete'>) => true,\n    'download-error': (_details: PayloadOf<DownloadTriggerProps, 'onDownloadError'>) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: DownloadTriggerSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const ctx = useDownloadTrigger(props as DownloadTriggerProps, {\n      onDownloadComplete: details => emit('download-complete', details),\n      onDownloadError: details => emit('download-error', details),\n    })\n    // 用原生 button，激活交给平台\n    return () => h('button', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      status: ctx.api.value.status,\n      preparing: ctx.api.value.preparing,\n      disabled: ctx.api.value.disabled,\n      fileName: ctx.api.value.fileName,\n      download: ctx.api.value.download,\n    }))\n  },\n})\n"],"mappings":";;;;;;;;;AAoBA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CAEN,OAAO;EAEL,MAAM;GAAE,MAAM;IAAC;IAAQ;IAAU;GAAM;GAAoC,SAAS,KAAA;EAAU;EAC9F,UAAU;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC7C,UAAU;GAAE,MAAM;GAAS,SAAS,KAAA;EAAU;CAChD;CAEA,OAAO;EACL,sBAAsB,aAAoE;EAC1F,mBAAmB,aAAiE;CACtF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,MAAM,mBAAmB,OAA+B;GAC5D,qBAAoB,YAAW,KAAK,qBAAqB,OAAO;GAChE,kBAAiB,YAAW,KAAK,kBAAkB,OAAO;EAC5D,CAAC;EAED,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAChG,QAAQ,IAAI,IAAI,MAAM;GACtB,WAAW,IAAI,IAAI,MAAM;GACzB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;GACxB,UAAU,IAAI,IAAI,MAAM;EAC1B,CAAC,CAAC;CACJ;AACF,CAAC"}

package/dist/components/download-trigger/use-download-trigger.d.ts

@@ -0,0 +1,10 @@
+import { ComputedRef } from "vue";
+import { DownloadTriggerApi, DownloadTriggerSchema } from "@xihan-ui/headless";
+//#region src/components/download-trigger/use-download-trigger.d.ts
+interface DownloadTriggerContext {
+  api: ComputedRef<DownloadTriggerApi>;
+}
+declare function useDownloadTrigger(props: DownloadTriggerSchema['props'], callbacks?: Pick<DownloadTriggerSchema['props'], 'onDownloadComplete' | 'onDownloadError'>): DownloadTriggerContext;
+//#endregion
+export { DownloadTriggerContext, useDownloadTrigger };
+//# sourceMappingURL=use-download-trigger.d.ts.map

package/dist/components/download-trigger/use-download-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-download-trigger.d.ts","names":[],"sources":["../../../src/components/download-trigger/use-download-trigger.ts"],"mappings":";;;UAOiB;EACf,KAAK,YAAY;;iBAIH,mBACd,OAAO,gCACP,YAAW,KAAK,4EACf"}

package/dist/components/download-trigger/use-download-trigger.js

@@ -0,0 +1,16 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { computed } from "vue";
+import { connectDownloadTrigger, downloadTriggerMachine } from "@xihan-ui/headless";
+//#region src/components/download-trigger/use-download-trigger.ts
+function useDownloadTrigger(props, callbacks = {}) {
+	const service = useMachine(downloadTriggerMachine, () => ({
+		...props,
+		...callbacks
+	}));
+	return { api: computed(() => connectDownloadTrigger(service, vueNormalize)) };
+}
+//#endregion
+export { useDownloadTrigger };
+
+//# sourceMappingURL=use-download-trigger.js.map

package/dist/components/download-trigger/use-download-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-download-trigger.js","names":[],"sources":["../../../src/components/download-trigger/use-download-trigger.ts"],"sourcesContent":["import type { DownloadTriggerApi, DownloadTriggerSchema } from '@xihan-ui/headless'\nimport type { ComputedRef } from 'vue'\nimport { connectDownloadTrigger, downloadTriggerMachine } from '@xihan-ui/headless'\nimport { computed } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\n\nexport interface DownloadTriggerContext {\n  api: ComputedRef<DownloadTriggerApi>\n}\n\n// 不建 scope：connect 不派生任何 id\nexport function useDownloadTrigger(\n  props: DownloadTriggerSchema['props'],\n  callbacks: Pick<DownloadTriggerSchema['props'], 'onDownloadComplete' | 'onDownloadError'> = {},\n): DownloadTriggerContext {\n  // 两个回调由组件外壳（emit）或组合式调用方提供，随 props 一并喂给机器\n  const service = useMachine(downloadTriggerMachine, () => ({ ...props, ...callbacks }))\n  const api = computed(() => connectDownloadTrigger(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;AAYA,SAAgB,mBACd,OACA,YAA4F,CAAC,GACrE;CAExB,MAAM,UAAU,WAAW,+BAA+B;EAAE,GAAG;EAAO,GAAG;CAAU,EAAE;CAErF,OAAO,EAAE,KADG,eAAe,uBAAuB,SAAS,YAAY,CAC5D,EAAE;AACf"}

package/dist/components/drawer/context.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/drawer/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { DrawerContext } from './use-drawer'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<DrawerContext> = Symbol('xh-drawer')\n\nexport function provideDrawer(ctx: DrawerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDrawerContext(): DrawerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Drawer 部件必须用在 XhDrawerRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAmC,OAAO,WAAW;AAE3D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/drawer/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { DrawerContext } from './use-drawer'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<DrawerContext> = Symbol.for('xh-drawer')\n\nexport function provideDrawer(ctx: DrawerContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useDrawerContext(): DrawerContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Drawer 部件必须用在 XhDrawerRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAmC,OAAO,IAAI,WAAW;AAE/D,SAAgB,cAAc,KAA0B;CACtD,QAAQ,KAAK,GAAG;AAClB;AAEA,SAAgB,mBAAkC;CAChD,MAAM,MAAM,OAAO,KAAK,IAAI;CAC5B,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,mCAAmC;CACrD,OAAO;AACT"}