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

package/dist/components/notification/notification.js

@@ -0,0 +1,179 @@
+import { withXhConfig } from "../../config/config.js";
+import { provideNotification, provideNotificationItem, useNotificationContext, useNotificationItemContext } from "./context.js";
+import { useNotification, useNotificationItem } from "./use-notification.js";
+import { Fragment, defineComponent, h } from "vue";
+//#region src/components/notification/notification.ts
+const XhNotificationRoot = defineComponent({
+	name: "XhNotificationRoot",
+	props: {
+		items: {
+			type: Array,
+			default: void 0
+		},
+		defaultItems: {
+			type: Array,
+			default: void 0
+		},
+		placement: {
+			type: String,
+			default: void 0
+		},
+		max: {
+			type: Number,
+			default: void 0
+		},
+		gap: {
+			type: Number,
+			default: void 0
+		},
+		duration: {
+			type: Number,
+			default: void 0
+		},
+		removeDelay: {
+			type: Number,
+			default: void 0
+		},
+		pauseOnPageIdle: {
+			type: Boolean,
+			default: void 0
+		},
+		translations: {
+			type: Object,
+			default: void 0
+		}
+	},
+	emits: {
+		"items-change": (_details) => true,
+		"update:items": (_items) => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const notify = (details) => {
+			emit("items-change", details);
+			emit("update:items", details.items);
+		};
+		const ctx = useNotification(withXhConfig("notification", props), notify);
+		provideNotification(ctx);
+		return () => h("div", ctx.api.value.getRootProps(), slots.default?.({
+			items: ctx.api.value.visibleNotifications,
+			placements: ctx.api.value.placements,
+			count: ctx.api.value.count,
+			getItemsByPlacement: ctx.api.value.getItemsByPlacement,
+			create: ctx.create,
+			update: ctx.update,
+			dismiss: ctx.dismiss,
+			dismissAll: ctx.dismissAll
+		}));
+	}
+});
+const XhNotificationGroup = defineComponent({
+	name: "XhNotificationGroup",
+	props: { placement: {
+		type: String,
+		default: void 0
+	} },
+	slots: Object,
+	setup(props, { slots }) {
+		const ctx = useNotificationContext();
+		return () => {
+			const api = ctx.api.value;
+			const groupProps = api.getGroupProps({ placement: props.placement });
+			const placement = groupProps["data-placement"];
+			const list = api.getItemsByPlacement(placement);
+			return h("div", groupProps, slots.default ? list.map((item) => h(Fragment, { key: item.id }, slots.default({ item }))) : void 0);
+		};
+	}
+});
+/** 单条卡片。生命周期复用 toast 那台机器：会自己消失的卡片，这一行为与消息来源无关。 */
+const XhNotificationItem = defineComponent({
+	name: "XhNotificationItem",
+	props: {
+		id: {
+			type: String,
+			default: void 0
+		},
+		title: {
+			type: String,
+			default: void 0
+		},
+		description: {
+			type: String,
+			default: void 0
+		},
+		type: {
+			type: String,
+			default: void 0
+		},
+		duration: {
+			type: Number,
+			default: void 0
+		},
+		removeDelay: {
+			type: Number,
+			default: void 0
+		},
+		closable: {
+			type: Boolean,
+			default: void 0
+		},
+		pauseOnPageIdle: {
+			type: Boolean,
+			default: void 0
+		},
+		translations: {
+			type: Object,
+			default: void 0
+		}
+	},
+	emits: {
+		"status-change": (_details) => true,
+		"action": () => true
+	},
+	slots: Object,
+	setup(props, { slots, emit }) {
+		const ctx = useNotificationItem(withXhConfig("notification", props), (details) => emit("status-change", details), () => emit("action"));
+		provideNotificationItem(ctx);
+		return () => h("div", ctx.api.value.getItemProps(), slots.default?.({ item: ctx.api.value }));
+	}
+});
+/** 类型指示符。作者不写内容时由皮肤按 data-type 画一枚兜底字形。 */
+const XhNotificationItemIndicator = defineComponent({
+	name: "XhNotificationItemIndicator",
+	setup(_, { slots }) {
+		const ctx = useNotificationItemContext();
+		return () => h("span", ctx.api.value.getItemIndicatorProps(), slots.default?.());
+	}
+});
+const XhNotificationItemTitle = defineComponent({
+	name: "XhNotificationItemTitle",
+	setup(_, { slots }) {
+		const ctx = useNotificationItemContext();
+		return () => h("div", ctx.api.value.getItemTitleProps(), slots.default?.() ?? ctx.api.value.title);
+	}
+});
+const XhNotificationItemDescription = defineComponent({
+	name: "XhNotificationItemDescription",
+	setup(_, { slots }) {
+		const ctx = useNotificationItemContext();
+		return () => h("div", ctx.api.value.getItemDescriptionProps(), slots.default?.() ?? ctx.api.value.description);
+	}
+});
+const XhNotificationItemActionTrigger = defineComponent({
+	name: "XhNotificationItemActionTrigger",
+	setup(_, { slots }) {
+		const ctx = useNotificationItemContext();
+		return () => h("button", ctx.api.value.getItemActionTriggerProps(), slots.default?.());
+	}
+});
+const XhNotificationItemCloseTrigger = defineComponent({
+	name: "XhNotificationItemCloseTrigger",
+	setup(_, { slots }) {
+		const ctx = useNotificationItemContext();
+		return () => h("button", ctx.api.value.getItemCloseTriggerProps(), slots.default?.());
+	}
+});
+//#endregion
+export { XhNotificationGroup, XhNotificationItem, XhNotificationItemActionTrigger, XhNotificationItemCloseTrigger, XhNotificationItemDescription, XhNotificationItemIndicator, XhNotificationItemTitle, XhNotificationRoot };
+
+//# sourceMappingURL=notification.js.map

package/dist/components/notification/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","names":[],"sources":["../../../src/components/notification/notification.ts"],"sourcesContent":["import type { NotificationItemApi, NotificationOptions, NotificationPlacement, NotificationRecord, NotificationSchema, NotificationTranslations, ResolvedNotification, ToastSchema, ToastType } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, Fragment, h } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { provideNotification, provideNotificationItem, useNotificationContext, useNotificationItemContext } from './context'\nimport { useNotification, useNotificationItem } from './use-notification'\n\ntype NotificationProps = NotificationSchema['props']\n\n/** 默认插槽的载荷：当前可见的通知队列与它的落位分组，以及入队、改写、关闭的命令。 */\nexport interface NotificationRootSlotProps {\n  items: ResolvedNotification[]\n  placements: NotificationPlacement[]\n  count: number\n  getItemsByPlacement: (placement: NotificationPlacement) => ResolvedNotification[]\n  create: (options?: NotificationOptions) => string\n  update: (id: string, options: Partial<NotificationOptions>) => void\n  dismiss: (id: string) => void\n  dismissAll: () => void\n}\n\nexport const XhNotificationRoot = defineComponent({\n  name: 'XhNotificationRoot',\n  // 缺省值由 connect 决定，这里一律 default: undefined\n  props: {\n    items: { type: Array as PropType<NotificationRecord[]>, default: undefined },\n    defaultItems: { type: Array as PropType<NotificationRecord[]>, default: undefined },\n    placement: { type: String as PropType<NotificationPlacement>, default: undefined },\n    max: { type: Number, default: undefined },\n    gap: { type: Number, default: undefined },\n    duration: { type: Number, default: undefined },\n    removeDelay: { type: Number, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>>, default: undefined },\n  },\n  // items-change 携带 { items }，update:items 携带裸队列以支持 v-model:items\n  emits: {\n    'items-change': (_details: PayloadOf<NotificationProps, 'onItemsChange'>) => true,\n    'update:items': (_items: PayloadOf<NotificationProps, 'onItemsChange'>['items']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NotificationProps['onItemsChange'] = (details) => {\n      emit('items-change', details)\n      emit('update:items', details.items)\n    }\n    const ctx = useNotification(withXhConfig('notification', props) as NotificationProps, notify)\n    provideNotification(ctx)\n    // 根节点是地标容器，插槽作用域里一并暴露队列与增删改命令\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      items: ctx.api.value.visibleNotifications,\n      placements: ctx.api.value.placements,\n      count: ctx.api.value.count,\n      getItemsByPlacement: ctx.api.value.getItemsByPlacement,\n      create: ctx.create,\n      update: ctx.update,\n      dismiss: ctx.dismiss,\n      dismissAll: ctx.dismissAll,\n    }))\n  },\n})\n\n/** 默认插槽的载荷：这一组里逐条铺开的通知。 */\nexport interface NotificationGroupSlotProps {\n  item: ResolvedNotification\n}\n\nexport const XhNotificationGroup = defineComponent({\n  name: 'XhNotificationGroup',\n  props: {\n    // 不写就用 notification 的 placement；写了就只收这个位置上的条目\n    placement: { type: String as PropType<NotificationPlacement>, default: undefined },\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NotificationGroupSlotProps) => VNode[]\n  }>,\n  setup(props, { slots }) {\n    const ctx = useNotificationContext()\n    return () => {\n      const api = ctx.api.value\n      const groupProps = api.getGroupProps({ placement: props.placement }) as Record<string, unknown>\n      // 落位从 group 自己的产出里读回，不在这边重算缺省\n      const placement = groupProps['data-placement'] as NotificationPlacement\n      const list = api.getItemsByPlacement(placement)\n      // 每条通知按队列身份 id 给 key，避免节点被就地复用\n      return h(\n        'div',\n        groupProps,\n        slots.default ? list.map(item => h(Fragment, { key: item.id }, slots.default!({ item }))) : undefined,\n      )\n    }\n  },\n})\n\n/** 单条卡片。生命周期复用 toast 那台机器：会自己消失的卡片，这一行为与消息来源无关。 */\nexport const XhNotificationItem = defineComponent({\n  name: 'XhNotificationItem',\n  // 缺省值由 connect 决定，这里一律 default: undefined\n  props: {\n    id: { type: String, default: undefined },\n    title: { type: String, default: undefined },\n    description: { type: String, default: undefined },\n    type: { type: String as PropType<ToastType>, default: undefined },\n    duration: { type: Number, default: undefined },\n    removeDelay: { type: Number, default: undefined },\n    closable: { type: Boolean, default: undefined },\n    pauseOnPageIdle: { type: Boolean, default: undefined },\n    translations: { type: Object as PropType<Partial<NotificationTranslations>>, default: undefined },\n  },\n  emits: {\n    'status-change': (_details: PayloadOf<ToastSchema['props'], 'onStatusChange'>) => true,\n    'action': () => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: { item: NotificationItemApi }) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    // 桶名写 notification 而不是 toast：卡片跑的虽然是 toast 那台机器，\n    // 但它的文案该跟着通知走——写 toast 的话，改这颗叉的读屏名会连所有轻提示一起改\n    const ctx = useNotificationItem(\n      withXhConfig('notification', props) as ToastSchema['props'],\n      details => emit('status-change', details),\n      () => emit('action'),\n    )\n    provideNotificationItem(ctx)\n    return () => h(\n      'div',\n      ctx.api.value.getItemProps() as Record<string, unknown>,\n      slots.default?.({ item: ctx.api.value }),\n    )\n  },\n})\n\n/** 类型指示符。作者不写内容时由皮肤按 data-type 画一枚兜底字形。 */\nexport const XhNotificationItemIndicator = defineComponent({\n  name: 'XhNotificationItemIndicator',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('span', ctx.api.value.getItemIndicatorProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemTitle = defineComponent({\n  name: 'XhNotificationItemTitle',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    // 作者没写内容就用队列里那条记录的标题\n    return () => h(\n      'div',\n      ctx.api.value.getItemTitleProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.title,\n    )\n  },\n})\n\nexport const XhNotificationItemDescription = defineComponent({\n  name: 'XhNotificationItemDescription',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h(\n      'div',\n      ctx.api.value.getItemDescriptionProps() as Record<string, unknown>,\n      slots.default?.() ?? ctx.api.value.description,\n    )\n  },\n})\n\nexport const XhNotificationItemActionTrigger = defineComponent({\n  name: 'XhNotificationItemActionTrigger',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('button', ctx.api.value.getItemActionTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNotificationItemCloseTrigger = defineComponent({\n  name: 'XhNotificationItemCloseTrigger',\n  setup(_, { slots }) {\n    const ctx = useNotificationItemContext()\n    return () => h('button', ctx.api.value.getItemCloseTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

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

@@ -0,0 +1,14 @@
+import { NotificationContext, NotificationItemContext } from "./context.js";
+import { MaybeRefOrGetter } from "vue";
+import { NotificationSchema, ToastSchema } from "@xihan-ui/headless";
+//#region src/components/notification/use-notification.d.ts
+/** props 收 ref/getter 时每帧现取，文案之类的量可以运行期换。 */
+declare function useNotification(props: MaybeRefOrGetter<NotificationSchema['props']>, onItemsChange?: NotificationSchema['props']['onItemsChange']): NotificationContext;
+/**
+ * 单条卡片。生命周期复用 toast 那台机器——那是「会自己消失的卡片」这一通用行为。
+ * 退场走完由这里回队列删记录：队列在外层，卡片自己不认识它。
+ */
+declare function useNotificationItem(props: ToastSchema['props'], onStatusChange?: ToastSchema['props']['onStatusChange'], onAction?: ToastSchema['props']['onAction']): NotificationItemContext;
+//#endregion
+export { useNotification, useNotificationItem };
+//# sourceMappingURL=use-notification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-notification.d.ts","names":[],"sources":["../../../src/components/notification/use-notification.ts"],"mappings":";;;;;iBAUgB,gBACd,OAAO,iBAAiB,8BACxB,gBAAgB,+CACf;;;;;iBAiBa,oBACd,OAAO,sBACP,iBAAiB,wCACjB,WAAW,mCACV"}

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

@@ -0,0 +1,42 @@
+import { vueNormalize } from "../../runtime/normalize-props.js";
+import { useMachine } from "../../runtime/use-machine.js";
+import { useNotificationContextOptional } from "./context.js";
+import { computed, toValue } from "vue";
+import { connectNotification, connectNotificationItem, notificationMachine, toastMachine } from "@xihan-ui/headless";
+//#region src/components/notification/use-notification.ts
+/** props 收 ref/getter 时每帧现取，文案之类的量可以运行期换。 */
+function useNotification(props, onItemsChange) {
+	const service = useMachine(notificationMachine, () => ({
+		...toValue(props),
+		onItemsChange
+	}));
+	const api = computed(() => connectNotification(service, vueNormalize));
+	return {
+		api,
+		create: (options) => api.value.create(options),
+		update: (id, options) => api.value.update(id, options),
+		dismiss: (id) => api.value.dismiss(id),
+		dismissAll: () => api.value.dismissAll()
+	};
+}
+/**
+* 单条卡片。生命周期复用 toast 那台机器——那是「会自己消失的卡片」这一通用行为。
+* 退场走完由这里回队列删记录：队列在外层，卡片自己不认识它。
+*/
+function useNotificationItem(props, onStatusChange, onAction) {
+	const queue = useNotificationContextOptional();
+	const notifyStatus = (details) => {
+		onStatusChange?.(details);
+		if (details.status === "unmounted") queue?.dismiss(details.id);
+	};
+	const service = useMachine(toastMachine, () => ({
+		...props,
+		onStatusChange: notifyStatus,
+		onAction
+	}));
+	return { api: computed(() => connectNotificationItem(service, vueNormalize)) };
+}
+//#endregion
+export { useNotification, useNotificationItem };
+
+//# sourceMappingURL=use-notification.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-notification.js","names":[],"sources":["../../../src/components/notification/use-notification.ts"],"sourcesContent":["import type { NotificationSchema, ToastSchema } from '@xihan-ui/headless'\nimport type { MaybeRefOrGetter } from 'vue'\nimport type { NotificationContext, NotificationItemContext } from './context'\nimport { connectNotification, connectNotificationItem, notificationMachine, toastMachine } from '@xihan-ui/headless'\nimport { computed, toValue } from 'vue'\nimport { vueNormalize } from '../../runtime/normalize-props'\nimport { useMachine } from '../../runtime/use-machine'\nimport { useNotificationContextOptional } from './context'\n\n/** props 收 ref/getter 时每帧现取，文案之类的量可以运行期换。 */\nexport function useNotification(\n  props: MaybeRefOrGetter<NotificationSchema['props']>,\n  onItemsChange?: NotificationSchema['props']['onItemsChange'],\n): NotificationContext {\n  const service = useMachine(notificationMachine, () => ({ ...toValue(props), onItemsChange }))\n  const api = computed(() => connectNotification(service, vueNormalize))\n  // 四个命令在顶层摊平，函数身份稳定，可解构后随时调用且不读取队列\n  return {\n    api,\n    create: options => api.value.create(options),\n    update: (id, options) => api.value.update(id, options),\n    dismiss: id => api.value.dismiss(id),\n    dismissAll: () => api.value.dismissAll(),\n  }\n}\n\n/**\n * 单条卡片。生命周期复用 toast 那台机器——那是「会自己消失的卡片」这一通用行为。\n * 退场走完由这里回队列删记录：队列在外层，卡片自己不认识它。\n */\nexport function useNotificationItem(\n  props: ToastSchema['props'],\n  onStatusChange?: ToastSchema['props']['onStatusChange'],\n  onAction?: ToastSchema['props']['onAction'],\n): NotificationItemContext {\n  const queue = useNotificationContextOptional()\n  const notifyStatus: ToastSchema['props']['onStatusChange'] = (details) => {\n    onStatusChange?.(details)\n    if (details.status === 'unmounted')\n      queue?.dismiss(details.id)\n  }\n  const service = useMachine(toastMachine, () => ({ ...props, onStatusChange: notifyStatus, onAction }))\n  const api = computed(() => connectNotificationItem(service, vueNormalize))\n  return { api }\n}\n"],"mappings":";;;;;;;AAUA,SAAgB,gBACd,OACA,eACqB;CACrB,MAAM,UAAU,WAAW,4BAA4B;EAAE,GAAG,QAAQ,KAAK;EAAG;CAAc,EAAE;CAC5F,MAAM,MAAM,eAAe,oBAAoB,SAAS,YAAY,CAAC;CAErE,OAAO;EACL;EACA,SAAQ,YAAW,IAAI,MAAM,OAAO,OAAO;EAC3C,SAAS,IAAI,YAAY,IAAI,MAAM,OAAO,IAAI,OAAO;EACrD,UAAS,OAAM,IAAI,MAAM,QAAQ,EAAE;EACnC,kBAAkB,IAAI,MAAM,WAAW;CACzC;AACF;;;;;AAMA,SAAgB,oBACd,OACA,gBACA,UACyB;CACzB,MAAM,QAAQ,+BAA+B;CAC7C,MAAM,gBAAwD,YAAY;EACxE,iBAAiB,OAAO;EACxB,IAAI,QAAQ,WAAW,aACrB,OAAO,QAAQ,QAAQ,EAAE;CAC7B;CACA,MAAM,UAAU,WAAW,qBAAqB;EAAE,GAAG;EAAO,gBAAgB;EAAc;CAAS,EAAE;CAErG,OAAO,EAAE,KADG,eAAe,wBAAwB,SAAS,YAAY,CAC7D,EAAE;AACf"}

package/dist/components/number-animation/number-animation.d.ts

@@ -101,10 +101,10 @@ declare const XhNumberAnimation: import("vue").DefineComponent<import("vue").Ext
 }>> & Readonly<{
   onFinish?: ((_details: NumberAnimationFinishDetails) => any) | undefined;
 }>, {
-  size: Size;
   tone: Tone;
-  separator: string;
+  size: Size;
   to: number;
+  separator: string;
   active: boolean;
   precision: number;
   live: NumberAnimationLive;

package/dist/components/number-field/context.js

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

package/dist/components/number-field/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/number-field/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { NumberFieldContext } from './use-number-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<NumberFieldContext> = Symbol('xh-number-field')\n\nexport function provideNumberField(ctx: NumberFieldContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNumberFieldContext(): NumberFieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] NumberField 部件必须用在 XhNumberFieldRoot 内')\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/number-field/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { NumberFieldContext } from './use-number-field'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<NumberFieldContext> = Symbol.for('xh-number-field')\n\nexport function provideNumberField(ctx: NumberFieldContext): void {\n  provide(KEY, ctx)\n}\n\nexport function useNumberFieldContext(): NumberFieldContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] NumberField 部件必须用在 XhNumberFieldRoot 内')\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/number-field/number-field.d.ts

@@ -140,14 +140,14 @@ declare const XhNumberFieldRoot: import("vue").DefineComponent<import("vue").Ext
   required: boolean;
   name: string;
   invalid: boolean;
-  size: Size;
   value: string;
   defaultValue: string;
   tone: Tone;
+  size: Size;
   disabled: boolean;
-  max: number;
-  variant: ControlVariant;
   readOnly: boolean;
+  variant: ControlVariant;
+  max: number;
   min: number;
   format: ((value: number) => string) | undefined;
   parse: ((text: string) => number) | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"number-field.d.ts","names":[],"sources":["../../../src/components/number-field/number-field.ts"],"mappings":";;;;;KAQK,mBAAmB;;KAGZ,2BAA2B,KACrC;cAIW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiBC,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;;;EAIV,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATR,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ3B,WAAC,OAAO,6BAA6B;kCAoBjD;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"number-field.d.ts","names":[],"sources":["../../../src/components/number-field/number-field.ts"],"mappings":";;;;;KASK,mBAAmB;;KAGZ,2BAA2B,KACrC;cAIW,iCAAiB,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiBC,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;;;EAIV,iBAAA,UAAA,UAAU;EACZ,iBAAA,QAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IATR,MAAA,SAAS;;;;IACZ,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;IACN,MAAA,SAAS;;;;IACR,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ3B,WAAC,OAAO,6BAA6B;kCAoBjD;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAO/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAU7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,6CAA6B,0BAAA,oBAAA,4BAAA;;8BAMxC,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}

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

@@ -1,3 +1,4 @@
+import { useFieldLabelWiring, useFieldStateWiring } from "../field/use-field-control.js";
 import { provideNumberField, useNumberFieldContext } from "./context.js";
 import { useNumberField } from "./use-number-field.js";
 import { defineComponent, h } from "vue";
@@ -107,8 +108,13 @@ const XhNumberFieldControl = defineComponent({
 const XhNumberFieldInput = defineComponent({
 	name: "XhNumberFieldInput",
 	setup() {
+		const fieldWiring = useFieldStateWiring();
+		const fieldLabel = useFieldLabelWiring();
 		const ctx = useNumberFieldContext();
-		return () => h("input", ctx.api.value.getInputProps());
+		return () => h("input", fieldLabel.value({
+			...ctx.api.value.getInputProps(),
+			...fieldWiring.value
+		}));
 	}
 });
 const XhNumberFieldIncrementTrigger = defineComponent({

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

@@ -1 +1 @@
-{"version":3,"file":"number-field.js","names":[],"sources":["../../../src/components/number-field/number-field.ts"],"sourcesContent":["import type { NumberFieldApi, NumberFieldSchema } from '@xihan-ui/headless'\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { provideNumberField, useNumberFieldContext } from './context'\nimport { useNumberField } from './use-number-field'\n\ntype NumberFieldProps = NumberFieldSchema['props']\n\n/** 默认插槽的载荷：原始输入串与其数值、增减是否还走得动，以及写值、增减的命令。 */\nexport type NumberFieldRootSlotProps = Pick<\n  NumberFieldApi,\n  'value' | 'valueAsNumber' | 'empty' | 'canIncrement' | 'canDecrement' | 'setValue' | 'increment' | 'decrement'\n>\n\nexport const XhNumberFieldRoot = defineComponent({\n  name: 'XhNumberFieldRoot',\n  props: {\n    // 值是原始输入串；default: undefined 表示非受控\n    value: { type: String, default: undefined },\n    defaultValue: { type: String, default: undefined },\n    min: { type: Number, default: undefined },\n    max: { type: Number, default: undefined },\n    step: { type: Number, default: undefined },\n    largeStep: { type: Number, default: undefined },\n    disabled: Boolean,\n    readOnly: Boolean,\n    required: Boolean,\n    invalid: Boolean,\n    name: { type: String, default: undefined },\n    changeDelay: { type: Number, default: undefined },\n    changeInterval: { type: Number, default: undefined },\n    variant: { type: String as PropType<ControlVariant>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    parse: { type: Function as PropType<NumberFieldProps['parse']>, default: undefined },\n    format: { type: Function as PropType<NumberFieldProps['format']>, default: undefined },\n  },\n  // value-change 携带 { value, valueAsNumber }，update:value 携带裸串\n  emits: {\n    'value-change': (_details: PayloadOf<NumberFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<NumberFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NumberFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NumberFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useNumberField(props as NumberFieldProps, notify)\n    provideNumberField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      valueAsNumber: ctx.api.value.valueAsNumber,\n      empty: ctx.api.value.empty,\n      canIncrement: ctx.api.value.canIncrement,\n      canDecrement: ctx.api.value.canDecrement,\n      setValue: ctx.api.value.setValue,\n      increment: ctx.api.value.increment,\n      decrement: ctx.api.value.decrement,\n    }))\n  },\n})\n\nexport const XhNumberFieldLabel = defineComponent({\n  name: 'XhNumberFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldControl = defineComponent({\n  name: 'XhNumberFieldControl',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    // 视觉盒：输入框与加减钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldInput = defineComponent({\n  name: 'XhNumberFieldInput',\n  setup() {\n    const ctx = useNumberFieldContext()\n    return () => h('input', ctx.api.value.getInputProps() as Record<string, unknown>)\n  },\n})\n\nexport const XhNumberFieldIncrementTrigger = defineComponent({\n  name: 'XhNumberFieldIncrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getIncrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldDecrementTrigger = defineComponent({\n  name: 'XhNumberFieldDecrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getDecrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":";;;;AAgBA,MAAa,oBAAoB,gBAAgB;CAC/C,MAAM;CACN,OAAO;EAEL,OAAO;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC1C,cAAc;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACjD,KAAK;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACxC,KAAK;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACxC,MAAM;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACzC,WAAW;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAC9C,UAAU;EACV,UAAU;EACV,UAAU;EACV,SAAS;EACT,MAAM;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACzC,aAAa;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EAChD,gBAAgB;GAAE,MAAM;GAAQ,SAAS,KAAA;EAAU;EACnD,SAAS;GAAE,MAAM;GAAoC,SAAS,KAAA;EAAU;EACxE,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,MAAM;GAAE,MAAM;GAA0B,SAAS,KAAA;EAAU;EAC3D,OAAO;GAAE,MAAM;GAAiD,SAAS,KAAA;EAAU;EACnF,QAAQ;GAAE,MAAM;GAAkD,SAAS,KAAA;EAAU;CACvF;CAEA,OAAO;EACL,iBAAiB,aAA2D;EAC5E,iBAAiB,WAAkE;CACrF;CACA,OAAO;CAGP,MAAM,OAAO,EAAE,OAAO,QAAQ;EAC5B,MAAM,UAA6C,YAAY;GAC7D,KAAK,gBAAgB,OAAO;GAC5B,KAAK,gBAAgB,QAAQ,KAAK;EACpC;EACA,MAAM,MAAM,eAAe,OAA2B,MAAM;EAC5D,mBAAmB,GAAG;EACtB,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,aAAa,GAA8B,MAAM,UAAU;GAC7F,OAAO,IAAI,IAAI,MAAM;GACrB,eAAe,IAAI,IAAI,MAAM;GAC7B,OAAO,IAAI,IAAI,MAAM;GACrB,cAAc,IAAI,IAAI,MAAM;GAC5B,cAAc,IAAI,IAAI,MAAM;GAC5B,UAAU,IAAI,IAAI,MAAM;GACxB,WAAW,IAAI,IAAI,MAAM;GACzB,WAAW,IAAI,IAAI,MAAM;EAC3B,CAAC,CAAC;CACJ;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,uBAAuB,gBAAgB;CAClD,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAElC,aAAa,EAAE,OAAO,IAAI,IAAI,MAAM,gBAAgB,GAA8B,MAAM,UAAU,CAAC;CACrG;AACF,CAAC;AAED,MAAa,qBAAqB,gBAAgB;CAChD,MAAM;CACN,QAAQ;EACN,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,SAAS,IAAI,IAAI,MAAM,cAAc,CAA4B;CAClF;AACF,CAAC;AAED,MAAa,gCAAgC,gBAAgB;CAC3D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,yBAAyB,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC;AAED,MAAa,gCAAgC,gBAAgB;CAC3D,MAAM;CACN,MAAM,GAAG,EAAE,SAAS;EAClB,MAAM,MAAM,sBAAsB;EAClC,aAAa,EAAE,UAAU,IAAI,IAAI,MAAM,yBAAyB,GAA8B,MAAM,UAAU,CAAC;CACjH;AACF,CAAC"}
+{"version":3,"file":"number-field.js","names":[],"sources":["../../../src/components/number-field/number-field.ts"],"sourcesContent":["import type { NumberFieldApi, NumberFieldSchema } from '@xihan-ui/headless'\nimport type { ControlVariant, Size, Tone } from '@xihan-ui/kernel'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h } from 'vue'\nimport { useFieldLabelWiring, useFieldStateWiring } from '../field/use-field-control'\nimport { provideNumberField, useNumberFieldContext } from './context'\nimport { useNumberField } from './use-number-field'\n\ntype NumberFieldProps = NumberFieldSchema['props']\n\n/** 默认插槽的载荷：原始输入串与其数值、增减是否还走得动，以及写值、增减的命令。 */\nexport type NumberFieldRootSlotProps = Pick<\n  NumberFieldApi,\n  'value' | 'valueAsNumber' | 'empty' | 'canIncrement' | 'canDecrement' | 'setValue' | 'increment' | 'decrement'\n>\n\nexport const XhNumberFieldRoot = defineComponent({\n  name: 'XhNumberFieldRoot',\n  props: {\n    // 值是原始输入串；default: undefined 表示非受控\n    value: { type: String, default: undefined },\n    defaultValue: { type: String, default: undefined },\n    min: { type: Number, default: undefined },\n    max: { type: Number, default: undefined },\n    step: { type: Number, default: undefined },\n    largeStep: { type: Number, default: undefined },\n    disabled: Boolean,\n    readOnly: Boolean,\n    required: Boolean,\n    invalid: Boolean,\n    name: { type: String, default: undefined },\n    changeDelay: { type: Number, default: undefined },\n    changeInterval: { type: Number, default: undefined },\n    variant: { type: String as PropType<ControlVariant>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n    parse: { type: Function as PropType<NumberFieldProps['parse']>, default: undefined },\n    format: { type: Function as PropType<NumberFieldProps['format']>, default: undefined },\n  },\n  // value-change 携带 { value, valueAsNumber }，update:value 携带裸串\n  emits: {\n    'value-change': (_details: PayloadOf<NumberFieldProps, 'onValueChange'>) => true,\n    'update:value': (_value: PayloadOf<NumberFieldProps, 'onValueChange'>['value']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: NumberFieldRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: NumberFieldProps['onValueChange'] = (details) => {\n      emit('value-change', details)\n      emit('update:value', details.value)\n    }\n    const ctx = useNumberField(props as NumberFieldProps, notify)\n    provideNumberField(ctx)\n    return () => h('div', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      value: ctx.api.value.value,\n      valueAsNumber: ctx.api.value.valueAsNumber,\n      empty: ctx.api.value.empty,\n      canIncrement: ctx.api.value.canIncrement,\n      canDecrement: ctx.api.value.canDecrement,\n      setValue: ctx.api.value.setValue,\n      increment: ctx.api.value.increment,\n      decrement: ctx.api.value.decrement,\n    }))\n  },\n})\n\nexport const XhNumberFieldLabel = defineComponent({\n  name: 'XhNumberFieldLabel',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('label', ctx.api.value.getLabelProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldControl = defineComponent({\n  name: 'XhNumberFieldControl',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    // 视觉盒：输入框与加减钮都放进来，皮肤把描边、底色、聚焦环画在它身上\n    return () => h('div', ctx.api.value.getControlProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldInput = defineComponent({\n  name: 'XhNumberFieldInput',\n  setup() {\n    // 字段的说明与校验状态要落在真控件上，不能停在封装根的 div 上\n    const fieldWiring = useFieldStateWiring()\n    // 字段的标签也得并进名字链：控件自带的那条指的是它自己那个没渲染的 label 部件\n    const fieldLabel = useFieldLabelWiring()\n    const ctx = useNumberFieldContext()\n    return () => h('input', fieldLabel.value({ ...ctx.api.value.getInputProps() as Record<string, unknown>, ...fieldWiring.value }))\n  },\n})\n\nexport const XhNumberFieldIncrementTrigger = defineComponent({\n  name: 'XhNumberFieldIncrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getIncrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhNumberFieldDecrementTrigger = defineComponent({\n  name: 'XhNumberFieldDecrementTrigger',\n  setup(_, { slots }) {\n    const ctx = useNumberFieldContext()\n    return () => h('button', ctx.api.value.getDecrementTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n"],"mappings":"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"}

package/dist/components/page-header/context.js

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

package/dist/components/page-header/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/page-header/context.ts"],"sourcesContent":["import type { PageHeaderApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface PageHeaderContext {\n  api: ComputedRef<PageHeaderApi>\n}\n\nconst KEY: InjectionKey<PageHeaderContext> = Symbol('xh-page-header')\n\nexport function providePageHeader(ctx: PageHeaderContext): void {\n  provide(KEY, ctx)\n}\n\nexport function usePageHeaderContext(): PageHeaderContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] PageHeader 部件必须用在 XhPageHeaderRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAuC,OAAO,gBAAgB;AAEpE,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"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/page-header/context.ts"],"sourcesContent":["import type { PageHeaderApi } from '@xihan-ui/headless'\nimport type { ComputedRef, InjectionKey } from 'vue'\nimport { inject, provide } from 'vue'\n\nexport interface PageHeaderContext {\n  api: ComputedRef<PageHeaderApi>\n}\n\nconst KEY: InjectionKey<PageHeaderContext> = Symbol.for('xh-page-header')\n\nexport function providePageHeader(ctx: PageHeaderContext): void {\n  provide(KEY, ctx)\n}\n\nexport function usePageHeaderContext(): PageHeaderContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] PageHeader 部件必须用在 XhPageHeaderRoot 内')\n  return ctx\n}\n"],"mappings":";;AAQA,MAAM,MAAuC,OAAO,IAAI,gBAAgB;AAExE,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"}

package/dist/components/pagination/context.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/pagination/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { PaginationContext } from './use-pagination'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<PaginationContext> = Symbol('xh-pagination')\n\nexport function providePagination(ctx: PaginationContext): void {\n  provide(KEY, ctx)\n}\n\nexport function usePaginationContext(): PaginationContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Pagination 部件必须用在 XhPaginationRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAuC,OAAO,eAAe;AAEnE,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"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/pagination/context.ts"],"sourcesContent":["import type { InjectionKey } from 'vue'\nimport type { PaginationContext } from './use-pagination'\nimport { inject, provide } from 'vue'\n\nconst KEY: InjectionKey<PaginationContext> = Symbol.for('xh-pagination')\n\nexport function providePagination(ctx: PaginationContext): void {\n  provide(KEY, ctx)\n}\n\nexport function usePaginationContext(): PaginationContext {\n  const ctx = inject(KEY, null)\n  if (!ctx)\n    throw new Error('[xh] Pagination 部件必须用在 XhPaginationRoot 内')\n  return ctx\n}\n"],"mappings":";;AAIA,MAAM,MAAuC,OAAO,IAAI,eAAe;AAEvE,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"}

package/dist/components/pagination/pagination.d.ts

@@ -1,11 +1,11 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
-import { PaginationApi, PaginationSchema, PaginationTranslations } from "@xihan-ui/headless";
+import { PaginationApi, PaginationEllipsisSide, PaginationPageSizeChangeDetails, PaginationSchema, PaginationTranslations } from "@xihan-ui/headless";
 import { Direction, Size, Tone } from "@xihan-ui/kernel";
 //#region src/components/pagination/pagination.d.ts
 type PaginationProps = PaginationSchema['props'];
 /** 默认插槽的载荷：当前页与总量口径、页码序列与条目区间、前后页页码，以及翻页与按当前页切数据的动作。 */
-type PaginationRootSlotProps = Pick<PaginationApi, 'page' | 'pageSize' | 'count' | 'totalPages' | 'pages' | 'pageRange' | 'previousPage' | 'nextPage' | 'setPage' | 'goToPrevPage' | 'goToNextPage' | 'slice'>;
+type PaginationRootSlotProps = Pick<PaginationApi, 'page' | 'pageSize' | 'pageSizeOptions' | 'pageItems' | 'openEllipsis' | 'count' | 'totalPages' | 'pages' | 'pageRange' | 'previousPage' | 'nextPage' | 'setPage' | 'goToPrevPage' | 'goToNextPage' | 'setPageSize' | 'slice'>;
 declare const XhPaginationRoot: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
   count: {
     type: NumberConstructor;
@@ -15,6 +15,14 @@ declare const XhPaginationRoot: import("vue").DefineComponent<import("vue").Extr
     type: NumberConstructor;
     default: undefined;
   };
+  defaultPageSize: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+  pageSizeOptions: {
+    type: PropType<number[]>;
+    default: undefined;
+  };
   page: {
     type: NumberConstructor;
     default: undefined;
@@ -48,6 +56,8 @@ declare const XhPaginationRoot: import("vue").DefineComponent<import("vue").Extr
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   'page-change': (_details: PayloadOf<PaginationProps, "onPageChange">) => true;
   'update:page': (_page: PayloadOf<PaginationProps, "onPageChange">["page"]) => true;
+  'page-size-change': (_details: PaginationPageSizeChangeDetails) => true;
+  'update:pageSize': (_pageSize: PaginationPageSizeChangeDetails["pageSize"]) => true;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   count: {
     type: NumberConstructor;
@@ -57,6 +67,14 @@ declare const XhPaginationRoot: import("vue").DefineComponent<import("vue").Extr
     type: NumberConstructor;
     default: undefined;
   };
+  defaultPageSize: {
+    type: NumberConstructor;
+    default: undefined;
+  };
+  pageSizeOptions: {
+    type: PropType<number[]>;
+    default: undefined;
+  };
   page: {
     type: NumberConstructor;
     default: undefined;
@@ -88,15 +106,19 @@ declare const XhPaginationRoot: import("vue").DefineComponent<import("vue").Extr
 }>> & Readonly<{
   "onPage-change"?: ((_details: import("@xihan-ui/headless").PaginationPageChangeDetails) => any) | undefined;
   "onUpdate:page"?: ((_page: number) => any) | undefined;
+  "onPage-size-change"?: ((_details: PaginationPageSizeChangeDetails) => any) | undefined;
+  "onUpdate:pageSize"?: ((_pageSize: number) => any) | undefined;
 }>, {
-  size: Size;
   dir: Direction;
   tone: Tone;
+  size: Size;
   translations: Partial<PaginationTranslations>;
   count: number;
   page: number;
   defaultPage: number;
   pageSize: number;
+  pageSizeOptions: number[];
+  defaultPageSize: number;
   siblingCount: number;
 }, SlotsType<{
   default?: (props: PaginationRootSlotProps) => VNode[];
@@ -120,9 +142,41 @@ declare const XhPaginationItem: import("vue").DefineComponent<import("vue").Extr
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhPaginationEllipsis: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+declare const XhPaginationEllipsis: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 这是哪一侧的省略位：首页与窗口之间是 start，窗口与末页之间是 end。 */
+  side: {
+    type: PropType<PaginationEllipsisSide>;
+    default: string;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 这是哪一侧的省略位：首页与窗口之间是 start，窗口与末页之间是 end。 */
+  side: {
+    type: PropType<PaginationEllipsisSide>;
+    default: string;
+  };
+}>> & Readonly<{}>, {
+  side: PaginationEllipsisSide;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhPaginationPageSizeSelect: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
+  default?: (props: {
+    options: number[];
+    label: (size: number) => string;
+  }) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhPaginationPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhPaginationContent: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, SlotsType<{
+  default?: (props: {
+    pages: number[];
+  }) => VNode[];
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { PaginationRootSlotProps, XhPaginationEllipsis, XhPaginationItem, XhPaginationNextTrigger, XhPaginationPrevTrigger, XhPaginationRoot };
+export { PaginationRootSlotProps, XhPaginationContent, XhPaginationEllipsis, XhPaginationItem, XhPaginationNextTrigger, XhPaginationPageSizeSelect, XhPaginationPositioner, XhPaginationPrevTrigger, XhPaginationRoot };
 //# sourceMappingURL=pagination.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","names":[],"sources":["../../../src/components/pagination/pagination.ts"],"mappings":";;;;;KASK,kBAAkB;;KAGX,0BAA0B,KACpC;cAeW,gCAAgB,8BAAA;;;;;;;;;;;;;;;;;;;;;;IASF,MAAA,SAAS;;;;IACA,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAIP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;;;;;;;;;;;;;;;;;;;;;;;IARV,MAAA,SAAS;;;;IACA,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;EAQvB,WAAC,OAAO,4BAA4B;kCAyBhD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA;cAEW,oCAAoB,0BAAA,oBAAA,4BAAA;;8BAM/B,qCAAA,iDAAA,aAAA,eAAA,oDAAA"}
+{"version":3,"file":"pagination.d.ts","names":[],"sources":["../../../src/components/pagination/pagination.ts"],"mappings":";;;;;KAUK,kBAAkB;;KAGX,0BAA0B,KACpC;cAmBW,gCAAgB,8BAAA;;;;;;;;;;;;;;IAOS,MAAA;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACA,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;EAKP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACF,qBAAA,UAAA;EACA,oBAAA,WAAA;;;;;;;;;;;;;;;IAfG,MAAA;;;;;;;;;;;;;;;;IAIX,MAAA,SAAS;;;;IACA,MAAA,SAAS,QAAQ;;;;IACzB,MAAA,SAAS;;;;IACT,MAAA,SAAS;;;;;;;;;;;;;;;;;;;;;EAWvB,WAAC,OAAO,4BAA4B;kCAkChD;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,uCAAuB,0BAAA,oBAAA,4BAAA;;8BAMlC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,gCAAgB,8BAAA;;IAIU,MAAA;;;;;;;IAAA,MAAA;;;MAUrC,oDAAA;cAEW,oCAAoB,8BAAA;;;IAIL,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAgBnC;cAEW,0CAA0B,0BAAA,oBAAA,4BAAA;;;EAGzB,WAAC;IAAS;IAAmB,QAAQ;QAA8B;kCAkB/E;cAEW,sCAAsB,0BAAA,oBAAA,4BAAA;;8BAgBjC,qCAAA,iDAAA,aAAA,eAAA,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;;EAGlB,WAAC;IAAS;QAAsB;kCAkB5C"}