@xihan-ui/vue 1.0.0 → 2.0.0

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.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"}
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/components/pagination/context.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 context 相关实现。\n\nimport 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":";;AAWA,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,55 +1,56 @@
 import { PayloadOf } from "../../runtime/payload.js";
 import { PropType, SlotsType, VNode } from "vue";
+import { Direction, Placement, Size, Tone } from "@xihan-ui/core";
 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' | '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;
-    default: undefined;
   };
   pageSize: {
     type: NumberConstructor;
-    default: undefined;
   };
   defaultPageSize: {
     type: NumberConstructor;
-    default: undefined;
   };
   pageSizeOptions: {
     type: PropType<number[]>;
-    default: undefined;
   };
   page: {
     type: NumberConstructor;
-    default: undefined;
   };
   defaultPage: {
     type: NumberConstructor;
-    default: undefined;
   };
   siblingCount: {
     type: NumberConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<PaginationTranslations>>;
-    default: undefined;
+  };
+  placement: {
+    type: PropType<Placement>;
+  };
+  offset: {
+    type: NumberConstructor;
+  };
+  openDelay: {
+    type: NumberConstructor;
+  };
+  closeDelay: {
+    type: NumberConstructor;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
@@ -61,66 +62,55 @@ declare const XhPaginationRoot: import("vue").DefineComponent<import("vue").Extr
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
   count: {
     type: NumberConstructor;
-    default: undefined;
   };
   pageSize: {
     type: NumberConstructor;
-    default: undefined;
   };
   defaultPageSize: {
     type: NumberConstructor;
-    default: undefined;
   };
   pageSizeOptions: {
     type: PropType<number[]>;
-    default: undefined;
   };
   page: {
     type: NumberConstructor;
-    default: undefined;
   };
   defaultPage: {
     type: NumberConstructor;
-    default: undefined;
   };
   siblingCount: {
     type: NumberConstructor;
-    default: undefined;
   };
   dir: {
     type: PropType<Direction>;
-    default: undefined;
   };
   translations: {
     type: PropType<Partial<PaginationTranslations>>;
-    default: undefined;
+  };
+  placement: {
+    type: PropType<Placement>;
+  };
+  offset: {
+    type: NumberConstructor;
+  };
+  openDelay: {
+    type: NumberConstructor;
+  };
+  closeDelay: {
+    type: NumberConstructor;
   };
   tone: {
     type: PropType<Tone>;
-    default: undefined;
   };
   size: {
     type: PropType<Size>;
-    default: undefined;
   };
 }>> & 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;
-}>, {
-  dir: Direction;
-  tone: Tone;
-  size: Size;
-  translations: Partial<PaginationTranslations>;
-  page: number;
-  defaultPage: number;
-  count: number;
-  pageSize: number;
-  pageSizeOptions: number[];
-  defaultPageSize: number;
-  siblingCount: number;
-}, SlotsType<{
+}>, {}, SlotsType<{
   default?: (props: PaginationRootSlotProps) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const XhPaginationPrevTrigger: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
@@ -142,8 +132,8 @@ declare const XhPaginationItem: import("vue").DefineComponent<import("vue").Extr
     required: true;
   };
 }>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhPaginationEllipsis: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-  /** 这是哪一侧的省略位：首页与窗口之间是 start，窗口与末页之间是 end。 */
+declare const XhPaginationEllipsisTrigger: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 该省略位所在的一侧：首页与窗口之间是 start，窗口与末页之间是 end。 */
   side: {
     type: PropType<PaginationEllipsisSide>;
     default: string;
@@ -151,7 +141,7 @@ declare const XhPaginationEllipsis: import("vue").DefineComponent<import("vue").
 }>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
   [key: string]: any;
 }>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-  /** 这是哪一侧的省略位：首页与窗口之间是 start，窗口与末页之间是 end。 */
+  /** 该省略位所在的一侧：首页与窗口之间是 start，窗口与末页之间是 end。 */
   side: {
     type: PropType<PaginationEllipsisSide>;
     default: string;
@@ -159,17 +149,54 @@ declare const XhPaginationEllipsis: import("vue").DefineComponent<import("vue").
 }>> & Readonly<{}>, {
   side: PaginationEllipsisSide;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhPaginationPageSizeSelect: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 信息区：未写默认插槽时铺设 api.summaryText */
+declare const XhPaginationSummary: 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;
+    summaryText: string;
+    start: number;
+    end: number;
+    count: number;
   }) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const XhPaginationPositioner: import("vue").DefineComponent<{}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** 跳页输入框：输入页码按回车即跳转 */
+declare const XhPaginationJumper: 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>;
+/**
+ * 每页条数控制器：装配的是库内的 select，不再是原生下拉。
+ *
+ * 组合发生在这一层：连接层把整份 select 的 api 放在 api.pageSizeSelect 上，
+ * 这里据此铺设角色节点（DOM 上带 data-scope="select"，使用 select 的皮肤）。
+ * 档位与档位文字都由连接层从 pageSizeOptions 与 translations.pageSizeOption 计算。
+ */
+declare const XhPaginationPageSizeSelect: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 本实例的 PageSizeSelect Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>[], {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 本实例的 PageSizeSelect Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const XhPaginationPositioner: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  /** 本实例的省略页 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  /** 本实例的省略页 Portal 容器；优先于应用级配置。 */
+  container: {
+    type: PropType<Element>;
+  };
+}>> & 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<{
@@ -178,5 +205,5 @@ declare const XhPaginationContent: import("vue").DefineComponent<{}, () => VNode
   }) => VNode[];
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-export { PaginationRootSlotProps, XhPaginationContent, XhPaginationEllipsis, XhPaginationItem, XhPaginationNextTrigger, XhPaginationPageSizeSelect, XhPaginationPositioner, XhPaginationPrevTrigger, XhPaginationRoot };
+export { PaginationRootSlotProps, XhPaginationContent, XhPaginationEllipsisTrigger, XhPaginationItem, XhPaginationJumper, XhPaginationNextTrigger, XhPaginationPageSizeSelect, XhPaginationPositioner, XhPaginationPrevTrigger, XhPaginationRoot, XhPaginationSummary };
 //# 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":";;;;;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"}
+{"version":3,"file":"pagination.d.ts","names":[],"sources":["../../../src/components/pagination/pagination.ts"],"mappings":";;;;;KAkBK,kBAAkB;;KAGX,0BAA0B,KACpC;cAmBW,gCAAgB,8BAAA;;;;;;;;;;;IAOS,MAAA;;;;;;;;;;;;IAIX,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACpB,MAAA,SAAS;;;;;;;;;;;;IAId,MAAA,SAAS;;;IACT,MAAA,SAAS;;;;;EAKP,gBAAA,UAAA,UAAU;EACb,gBAAA,OAAA,UAAU;EACF,qBAAA,UAAA;EACA,oBAAA,WAAA;;;;;;;;;;;;IAnBG,MAAA;;;;;;;;;;;;IAIX,MAAA,SAAS;;;IACA,MAAA,SAAS,QAAQ;;;IACpB,MAAA,SAAS;;;;;;;;;;;;IAId,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,2CAA2B,8BAAA;;;IAIZ,MAAA,SAAS;;;;;;;;IAAT,MAAA,SAAS;;;;;qCAgBnC;;cAGW,mCAAmB,0BAAA,oBAAA,4BAAA;;;EAGlB,WAAC;IAAS;IAAqB;IAAe;IAAa;QAAoB;kCAoB3F;;cAGW,kCAAkB,0BAAA,oBAAA,4BAAA;;8BAM7B,qCAAA,iDAAA,aAAA,eAAA,oDAAA;;;;;;;;cASW,0CAA0B,8BAAA;;;IAIN,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAgDxC,oDAAA;cAEW,sCAAsB,8BAAA;;;IAIF,MAAA,SAAS;;;;;;;IAAT,MAAA,SAAS;;MAiBxC,oDAAA;cAEW,mCAAmB,0BAAA,oBAAA,4BAAA;;;EAGlB,WAAC;IAAS;QAAsB;kCAkB5C"}

package/dist/components/pagination/pagination.js

@@ -1,56 +1,28 @@
 import { withXhConfig } from "../../config/config.js";
+import { XhPortal } from "../../runtime/portal.js";
 import { useScrollbars } from "../../runtime/use-scrollbars.js";
 import { providePagination, usePaginationContext } from "./context.js";
 import { usePagination } from "./use-pagination.js";
-import { Teleport, defineComponent, h, mergeProps } from "vue";
+import { defineComponent, h, mergeProps } from "vue";
 //#region src/components/pagination/pagination.ts
 const XhPaginationRoot = defineComponent({
 	name: "XhPaginationRoot",
 	props: {
-		count: {
-			type: Number,
-			default: void 0
-		},
-		pageSize: {
-			type: Number,
-			default: void 0
-		},
-		defaultPageSize: {
-			type: Number,
-			default: void 0
-		},
-		pageSizeOptions: {
-			type: Array,
-			default: void 0
-		},
-		page: {
-			type: Number,
-			default: void 0
-		},
-		defaultPage: {
-			type: Number,
-			default: void 0
-		},
-		siblingCount: {
-			type: Number,
-			default: void 0
-		},
-		dir: {
-			type: String,
-			default: void 0
-		},
-		translations: {
-			type: Object,
-			default: void 0
-		},
-		tone: {
-			type: String,
-			default: void 0
-		},
-		size: {
-			type: String,
-			default: void 0
-		}
+		count: { type: Number },
+		pageSize: { type: Number },
+		defaultPageSize: { type: Number },
+		pageSizeOptions: { type: Array },
+		page: { type: Number },
+		defaultPage: { type: Number },
+		siblingCount: { type: Number },
+		dir: { type: String },
+		translations: { type: Object },
+		placement: { type: String },
+		offset: { type: Number },
+		openDelay: { type: Number },
+		closeDelay: { type: Number },
+		tone: { type: String },
+		size: { type: String }
 	},
 	emits: {
 		"page-change": (_details) => true,
@@ -116,10 +88,10 @@ const XhPaginationItem = defineComponent({
 		return () => h("button", ctx.api.value.getItemProps({ page: Number(props.value) }), slots.default?.());
 	}
 });
-const XhPaginationEllipsis = defineComponent({
-	name: "XhPaginationEllipsis",
+const XhPaginationEllipsisTrigger = defineComponent({
+	name: "XhPaginationEllipsisTrigger",
 	props: { 
-	/** 这是哪一侧的省略位：首页与窗口之间是 start，窗口与末页之间是 end。 */
+	/** 该省略位所在的一侧：首页与窗口之间是 start，窗口与末页之间是 end。 */
 side: {
 		type: String,
 		default: "start"
@@ -129,7 +101,7 @@ side: {
 		return () => {
 			const open = ctx.api.value.openEllipsis === props.side;
 			return h("button", {
-				...ctx.api.value.getEllipsisProps({ side: props.side }),
+				...ctx.api.value.getEllipsisTriggerProps({ side: props.side }),
 				ref: (el) => {
 					if (open) ctx.ellipsisRef.value = el;
 				}
@@ -137,27 +109,91 @@ side: {
 		};
 	}
 });
-const XhPaginationPageSizeSelect = defineComponent({
-	name: "XhPaginationPageSizeSelect",
+/** 信息区：未写默认插槽时铺设 api.summaryText */
+const XhPaginationSummary = defineComponent({
+	name: "XhPaginationSummary",
 	slots: Object,
 	setup(_, { slots }) {
 		const ctx = usePaginationContext();
-		return () => h("select", ctx.api.value.getPageSizeSelectProps(), slots.default ? slots.default({
-			options: ctx.api.value.pageSizeOptions,
-			label: (size) => String(size)
-		}) : ctx.api.value.pageSizeOptions.map((size) => h("option", {
-			key: size,
-			value: String(size)
-		}, String(size))));
+		return () => {
+			const api = ctx.api.value;
+			return h("div", api.getSummaryProps(), slots.default ? slots.default({
+				summaryText: api.summaryText,
+				start: api.pageRange.start,
+				end: api.pageRange.end,
+				count: api.count
+			}) : api.summaryText);
+		};
+	}
+});
+/** 跳页输入框：输入页码按回车即跳转 */
+const XhPaginationJumper = defineComponent({
+	name: "XhPaginationJumper",
+	setup() {
+		const ctx = usePaginationContext();
+		return () => h("input", ctx.api.value.getJumperProps());
+	}
+});
+/**
+* 每页条数控制器：装配的是库内的 select，不再是原生下拉。
+*
+* 组合发生在这一层：连接层把整份 select 的 api 放在 api.pageSizeSelect 上，
+* 这里据此铺设角色节点（DOM 上带 data-scope="select"，使用 select 的皮肤）。
+* 档位与档位文字都由连接层从 pageSizeOptions 与 translations.pageSizeOption 计算。
+*/
+const XhPaginationPageSizeSelect = defineComponent({
+	name: "XhPaginationPageSizeSelect",
+	props: { 
+	/** 本实例的 PageSizeSelect Portal 容器；优先于应用级配置。 */
+container: { type: Object } },
+	inheritAttrs: false,
+	setup(props, { attrs }) {
+		const ctx = usePaginationContext();
+		return () => {
+			const api = ctx.api.value;
+			const select = api.pageSizeSelect;
+			return [h("div", mergeProps(api.getPageSizeSelectProps(), attrs), [h("div", select.getRootProps(), [h("div", select.getControlProps(), [h("button", {
+				...select.getTriggerProps(),
+				ref: (el) => {
+					ctx.pageSizeTriggerRef.value = el;
+				}
+			}, [h("span", select.getValueTextProps(), select.displayText), h("span", select.getIndicatorProps())])])])]), h(XhPortal, {
+				to: props.container ?? ctx.portalTarget.value,
+				source: ctx.pageSizeTriggerRef
+			}, () => [h("div", {
+				...select.getPositionerProps(),
+				ref: (el) => {
+					ctx.pageSizePositionerRef.value = el;
+				}
+			}, [h("div", {
+				...select.getContentProps(),
+				style: ctx.pageSizeVisible.value ? void 0 : { display: "none" },
+				ref: (el) => {
+					ctx.pageSizeContentRef.value = el;
+				}
+			}, [h("div", select.getListProps(), select.collection.map((option) => h("div", {
+				...select.getItemProps({ value: option.value }),
+				key: option.value
+			}, [h("span", select.getItemTextProps({ value: option.value }), option.label), h("span", select.getItemIndicatorProps({ value: option.value }))])))])])])];
+		};
 	}
 });
 const XhPaginationPositioner = defineComponent({
 	name: "XhPaginationPositioner",
+	props: { 
+	/** 本实例的省略页 Portal 容器；优先于应用级配置。 */
+container: { type: Object } },
 	inheritAttrs: false,
-	setup(_, { slots, attrs }) {
+	setup(props, { slots, attrs }) {
 		const ctx = usePaginationContext();
-		const bars = useScrollbars({ scrollable: () => ctx.contentRef.value });
-		return () => h(Teleport, { to: ctx.portalTarget.value }, [h("div", {
+		const bars = useScrollbars({
+			scrollable: () => ctx.contentRef.value,
+			props: { size: "sm" }
+		});
+		return () => h(XhPortal, {
+			to: props.container ?? ctx.portalTarget.value,
+			source: ctx.ellipsisRef
+		}, () => [h("div", {
 			...mergeProps(ctx.api.value.getPositionerProps(), attrs),
 			ref: (el) => {
 				ctx.positionerRef.value = el;
@@ -184,6 +220,6 @@ const XhPaginationContent = defineComponent({
 	}
 });
 //#endregion
-export { XhPaginationContent, XhPaginationEllipsis, XhPaginationItem, XhPaginationNextTrigger, XhPaginationPageSizeSelect, XhPaginationPositioner, XhPaginationPrevTrigger, XhPaginationRoot };
+export { XhPaginationContent, XhPaginationEllipsisTrigger, XhPaginationItem, XhPaginationJumper, XhPaginationNextTrigger, XhPaginationPageSizeSelect, XhPaginationPositioner, XhPaginationPrevTrigger, XhPaginationRoot, XhPaginationSummary };
 
 //# sourceMappingURL=pagination.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","names":[],"sources":["../../../src/components/pagination/pagination.ts"],"sourcesContent":["import type { PaginationApi, PaginationEllipsisSide, PaginationPageSizeChangeDetails, PaginationSchema, PaginationTranslations } from '@xihan-ui/headless'\nimport type { Direction, Size, Tone } 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 { useScrollbars } from '../../runtime/use-scrollbars'\nimport { providePagination, usePaginationContext } from './context'\nimport { usePagination } from './use-pagination'\n\ntype PaginationProps = PaginationSchema['props']\n\n/** 默认插槽的载荷：当前页与总量口径、页码序列与条目区间、前后页页码，以及翻页与按当前页切数据的动作。 */\nexport type PaginationRootSlotProps = Pick<\n  PaginationApi,\n  | 'page'\n  | 'pageSize'\n  | 'pageSizeOptions'\n  | 'pageItems'\n  | 'openEllipsis'\n  | 'count'\n  | 'totalPages'\n  | 'pages'\n  | 'pageRange'\n  | 'previousPage'\n  | 'nextPage'\n  | 'setPage'\n  | 'goToPrevPage'\n  | 'goToNextPage'\n  | 'setPageSize'\n  | 'slice'\n>\n\nexport const XhPaginationRoot = defineComponent({\n  name: 'XhPaginationRoot',\n  // 缺省值由 connect 给出，这里一律 default: undefined\n  props: {\n    count: { type: Number, default: undefined },\n    pageSize: { type: Number, default: undefined },\n    defaultPageSize: { type: Number, default: undefined },\n    pageSizeOptions: { type: Array as PropType<number[]>, default: undefined },\n    page: { type: Number, default: undefined },\n    defaultPage: { type: Number, default: undefined },\n    siblingCount: { type: Number, default: undefined },\n    dir: { type: String as PropType<Direction>, default: undefined },\n    translations: { type: Object as PropType<Partial<PaginationTranslations>>, default: undefined },\n    tone: { type: String as PropType<Tone>, default: undefined },\n    size: { type: String as PropType<Size>, default: undefined },\n  },\n  // page-change 携带 { page, pageSize }，update:page 携带裸页码；\n  // 换档同时改页码，两个 update 都发，v-model:page 与 v-model:page-size 才不会各说各话\n  emits: {\n    'page-change': (_details: PayloadOf<PaginationProps, 'onPageChange'>) => true,\n    'update:page': (_page: PayloadOf<PaginationProps, 'onPageChange'>['page']) => true,\n    'page-size-change': (_details: PaginationPageSizeChangeDetails) => true,\n    'update:pageSize': (_pageSize: PaginationPageSizeChangeDetails['pageSize']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PaginationRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PaginationProps['onPageChange'] = (details) => {\n      emit('page-change', details)\n      emit('update:page', details.page)\n    }\n    const notifyPageSize: PaginationProps['onPageSizeChange'] = (details) => {\n      emit('page-size-change', details)\n      emit('update:pageSize', details.pageSize)\n      emit('update:page', details.page)\n    }\n    const ctx = usePagination(withXhConfig('pagination', props) as PaginationProps, notify, notifyPageSize)\n    providePagination(ctx)\n    // 根节点渲染为 nav 地标\n    return () => h('nav', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      page: ctx.api.value.page,\n      pageSize: ctx.api.value.pageSize,\n      pageSizeOptions: ctx.api.value.pageSizeOptions,\n      count: ctx.api.value.count,\n      totalPages: ctx.api.value.totalPages,\n      pages: ctx.api.value.pages,\n      pageItems: ctx.api.value.pageItems,\n      openEllipsis: ctx.api.value.openEllipsis,\n      pageRange: ctx.api.value.pageRange,\n      previousPage: ctx.api.value.previousPage,\n      nextPage: ctx.api.value.nextPage,\n      setPage: ctx.api.value.setPage,\n      goToPrevPage: ctx.api.value.goToPrevPage,\n      goToNextPage: ctx.api.value.goToNextPage,\n      setPageSize: ctx.api.value.setPageSize,\n      slice: ctx.api.value.slice,\n    }))\n  },\n})\n\nexport const XhPaginationPrevTrigger = defineComponent({\n  name: 'XhPaginationPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPaginationNextTrigger = defineComponent({\n  name: 'XhPaginationNextTrigger',\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPaginationItem = defineComponent({\n  name: 'XhPaginationItem',\n  props: {\n    // 这一项对应的页码，兼收字符串\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = usePaginationContext()\n    return () => h(\n      'button',\n      ctx.api.value.getItemProps({ page: Number(props.value) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhPaginationEllipsis = defineComponent({\n  name: 'XhPaginationEllipsis',\n  props: {\n    /** 这是哪一侧的省略位：首页与窗口之间是 start，窗口与末页之间是 end。 */\n    side: { type: String as PropType<PaginationEllipsisSide>, default: 'start' },\n  },\n  setup(props, { slots }) {\n    const ctx = usePaginationContext()\n    // 摊开的那一个是定位锚点；两个省略位共用一份定位层，谁开着谁认领\n    return () => {\n      const open = ctx.api.value.openEllipsis === props.side\n      return h('button', {\n        ...ctx.api.value.getEllipsisProps({ side: props.side }) as Record<string, unknown>,\n        ref: (el: unknown) => {\n          if (open)\n            ctx.ellipsisRef.value = el as HTMLElement\n        },\n      }, slots.default?.())\n    }\n  },\n})\n\nexport const XhPaginationPageSizeSelect = defineComponent({\n  name: 'XhPaginationPageSizeSelect',\n  slots: Object as SlotsType<{\n    default?: (props: { options: number[], label: (size: number) => string }) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    // 档位由作者渲染成 option：原生 select 的子节点不是角色节点，用不着再立一个部件\n    return () => h(\n      'select',\n      ctx.api.value.getPageSizeSelectProps() as Record<string, unknown>,\n      slots.default\n        ? slots.default({\n            options: ctx.api.value.pageSizeOptions,\n            label: (size: number) => String(size),\n          })\n        : ctx.api.value.pageSizeOptions.map(size =>\n            h('option', { key: size, value: String(size) }, String(size)),\n          ),\n    )\n  },\n})\n\nexport const XhPaginationPositioner = defineComponent({\n  name: 'XhPaginationPositioner',\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(_, { slots, attrs }) {\n    const ctx = usePaginationContext()\n    // 折叠页码列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(Teleport, { to: ctx.portalTarget.value }, [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhPaginationContent = defineComponent({\n  name: 'XhPaginationContent',\n  slots: Object as SlotsType<{\n    default?: (props: { pages: number[] }) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    return () => {\n      const open = ctx.api.value.openEllipsis\n      const folded = ctx.api.value.pageItems.find(\n        item => item.type === 'ellipsis' && item.side === open,\n      )\n      return h('div', {\n        ...ctx.api.value.getContentProps() as Record<string, unknown>,\n        // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}\n        // （补了退场就一帧都播不出来），真正的收起落成内联 display\n        style: ctx.visible.value ? undefined : { display: 'none' },\n        ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n      }, slots.default?.({ pages: folded?.type === 'ellipsis' ? folded.pages : [] }))\n    }\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"pagination.js","names":[],"sources":["../../../src/components/pagination/pagination.ts"],"sourcesContent":["/*\n * Copyright (c) 2021-Present XiHanFun and contributors.\n * Licensed under the MIT License. See LICENSE in the project root for license information.\n */\n\n// 提供 pagination 相关实现。\n\nimport type { Direction, Placement, Size, Tone } from '@xihan-ui/core'\nimport type { PaginationApi, PaginationEllipsisSide, PaginationPageSizeChangeDetails, PaginationSchema, PaginationTranslations } from '@xihan-ui/headless'\nimport type { PropType, SlotsType, VNode } from 'vue'\nimport type { PayloadOf } from '../../runtime/payload'\nimport { defineComponent, h, mergeProps } from 'vue'\nimport { withXhConfig } from '../../config/config'\nimport { XhPortal } from '../../runtime/portal'\nimport { useScrollbars } from '../../runtime/use-scrollbars'\nimport { providePagination, usePaginationContext } from './context'\nimport { usePagination } from './use-pagination'\n\ntype PaginationProps = PaginationSchema['props']\n\n/** 默认插槽的载荷：当前页与总量口径、页码序列与条目区间、前后页页码，以及翻页与按当前页切分数据的动作。 */\nexport type PaginationRootSlotProps = Pick<\n  PaginationApi,\n  | 'page'\n  | 'pageSize'\n  | 'pageSizeOptions'\n  | 'pageItems'\n  | 'openEllipsis'\n  | 'count'\n  | 'totalPages'\n  | 'pages'\n  | 'pageRange'\n  | 'previousPage'\n  | 'nextPage'\n  | 'setPage'\n  | 'goToPrevPage'\n  | 'goToNextPage'\n  | 'setPageSize'\n  | 'slice'\n>\n\nexport const XhPaginationRoot = defineComponent({\n  name: 'XhPaginationRoot',\n  // 缺省值由 connect 给出；普通类型省略 default，Boolean 显式保留 undefined\n  props: {\n    count: { type: Number },\n    pageSize: { type: Number },\n    defaultPageSize: { type: Number },\n    pageSizeOptions: { type: Array as PropType<number[]> },\n    page: { type: Number },\n    defaultPage: { type: Number },\n    siblingCount: { type: Number },\n    dir: { type: String as PropType<Direction> },\n    translations: { type: Object as PropType<Partial<PaginationTranslations>> },\n    placement: { type: String as PropType<Placement> },\n    offset: { type: Number },\n    openDelay: { type: Number },\n    closeDelay: { type: Number },\n    tone: { type: String as PropType<Tone> },\n    size: { type: String as PropType<Size> },\n  },\n  // page-change 携带 { page, pageSize }，update:page 携带裸页码；\n  // 换档同时改页码，两个 update 都发，v-model:page 与 v-model:page-size 才不会各说各话\n  emits: {\n    'page-change': (_details: PayloadOf<PaginationProps, 'onPageChange'>) => true,\n    'update:page': (_page: PayloadOf<PaginationProps, 'onPageChange'>['page']) => true,\n    'page-size-change': (_details: PaginationPageSizeChangeDetails) => true,\n    'update:pageSize': (_pageSize: PaginationPageSizeChangeDetails['pageSize']) => true,\n  },\n  slots: Object as SlotsType<{\n    default?: (props: PaginationRootSlotProps) => VNode[]\n  }>,\n  setup(props, { slots, emit }) {\n    const notify: PaginationProps['onPageChange'] = (details) => {\n      emit('page-change', details)\n      emit('update:page', details.page)\n    }\n    const notifyPageSize: PaginationProps['onPageSizeChange'] = (details) => {\n      emit('page-size-change', details)\n      emit('update:pageSize', details.pageSize)\n      emit('update:page', details.page)\n    }\n    const ctx = usePagination(withXhConfig('pagination', props) as PaginationProps, notify, notifyPageSize)\n    providePagination(ctx)\n    // 根节点渲染为 nav 地标\n    return () => h('nav', ctx.api.value.getRootProps() as Record<string, unknown>, slots.default?.({\n      page: ctx.api.value.page,\n      pageSize: ctx.api.value.pageSize,\n      pageSizeOptions: ctx.api.value.pageSizeOptions,\n      count: ctx.api.value.count,\n      totalPages: ctx.api.value.totalPages,\n      pages: ctx.api.value.pages,\n      pageItems: ctx.api.value.pageItems,\n      openEllipsis: ctx.api.value.openEllipsis,\n      pageRange: ctx.api.value.pageRange,\n      previousPage: ctx.api.value.previousPage,\n      nextPage: ctx.api.value.nextPage,\n      setPage: ctx.api.value.setPage,\n      goToPrevPage: ctx.api.value.goToPrevPage,\n      goToNextPage: ctx.api.value.goToNextPage,\n      setPageSize: ctx.api.value.setPageSize,\n      slice: ctx.api.value.slice,\n    }))\n  },\n})\n\nexport const XhPaginationPrevTrigger = defineComponent({\n  name: 'XhPaginationPrevTrigger',\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    return () => h('button', ctx.api.value.getPrevTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPaginationNextTrigger = defineComponent({\n  name: 'XhPaginationNextTrigger',\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    return () => h('button', ctx.api.value.getNextTriggerProps() as Record<string, unknown>, slots.default?.())\n  },\n})\n\nexport const XhPaginationItem = defineComponent({\n  name: 'XhPaginationItem',\n  props: {\n    // 这一项对应的页码，兼收字符串\n    value: { type: [Number, String] as PropType<number | string>, required: true },\n  },\n  setup(props, { slots }) {\n    const ctx = usePaginationContext()\n    return () => h(\n      'button',\n      ctx.api.value.getItemProps({ page: Number(props.value) }) as Record<string, unknown>,\n      slots.default?.(),\n    )\n  },\n})\n\nexport const XhPaginationEllipsisTrigger = defineComponent({\n  name: 'XhPaginationEllipsisTrigger',\n  props: {\n    /** 该省略位所在的一侧：首页与窗口之间是 start，窗口与末页之间是 end。 */\n    side: { type: String as PropType<PaginationEllipsisSide>, default: 'start' },\n  },\n  setup(props, { slots }) {\n    const ctx = usePaginationContext()\n    // 摊开的那一个是定位锚点；两个省略位共用一份定位层，谁开着谁认领\n    return () => {\n      const open = ctx.api.value.openEllipsis === props.side\n      return h('button', {\n        ...ctx.api.value.getEllipsisTriggerProps({ side: props.side }) as Record<string, unknown>,\n        ref: (el: unknown) => {\n          if (open)\n            ctx.ellipsisRef.value = el as HTMLElement\n        },\n      }, slots.default?.())\n    }\n  },\n})\n\n/** 信息区：未写默认插槽时铺设 api.summaryText */\nexport const XhPaginationSummary = defineComponent({\n  name: 'XhPaginationSummary',\n  slots: Object as SlotsType<{\n    default?: (props: { summaryText: string, start: number, end: number, count: number }) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    return () => {\n      const api = ctx.api.value\n      return h(\n        'div',\n        api.getSummaryProps() as Record<string, unknown>,\n        slots.default\n          ? slots.default({\n              summaryText: api.summaryText,\n              start: api.pageRange.start,\n              end: api.pageRange.end,\n              count: api.count,\n            })\n          : api.summaryText,\n      )\n    }\n  },\n})\n\n/** 跳页输入框：输入页码按回车即跳转 */\nexport const XhPaginationJumper = defineComponent({\n  name: 'XhPaginationJumper',\n  setup() {\n    const ctx = usePaginationContext()\n    return () => h('input', ctx.api.value.getJumperProps() as Record<string, unknown>)\n  },\n})\n\n/**\n * 每页条数控制器：装配的是库内的 select，不再是原生下拉。\n *\n * 组合发生在这一层：连接层把整份 select 的 api 放在 api.pageSizeSelect 上，\n * 这里据此铺设角色节点（DOM 上带 data-scope=\"select\"，使用 select 的皮肤）。\n * 档位与档位文字都由连接层从 pageSizeOptions 与 translations.pageSizeOption 计算。\n */\nexport const XhPaginationPageSizeSelect = defineComponent({\n  name: 'XhPaginationPageSizeSelect',\n  props: {\n    /** 本实例的 PageSizeSelect Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 渲染出来是「挂载点 + 被搬走的浮层」两截，作者写的 class 与 style 得自己接住落到挂载点上\n  inheritAttrs: false,\n  setup(props, { attrs }) {\n    const ctx = usePaginationContext()\n    return () => {\n      const api = ctx.api.value\n      const select = api.pageSizeSelect\n      return [\n        h('div', mergeProps(api.getPageSizeSelectProps() as Record<string, unknown>, attrs), [\n          h('div', select.getRootProps() as Record<string, unknown>, [\n            h('div', select.getControlProps() as Record<string, unknown>, [\n              h('button', {\n                ...select.getTriggerProps() as Record<string, unknown>,\n                ref: (el: unknown) => { ctx.pageSizeTriggerRef.value = el as HTMLElement },\n              }, [\n                h('span', select.getValueTextProps() as Record<string, unknown>, select.displayText),\n                h('span', select.getIndicatorProps() as Record<string, unknown>),\n              ]),\n            ]),\n          ]),\n        ]),\n        h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.pageSizeTriggerRef }, () => [\n          h('div', {\n            ...select.getPositionerProps() as Record<string, unknown>,\n            ref: (el: unknown) => { ctx.pageSizePositionerRef.value = el as HTMLElement },\n          }, [\n            h('div', {\n              ...select.getContentProps() as Record<string, unknown>,\n              // 收起跟着退场闸门走，与省略位那层同一套写法\n              style: ctx.pageSizeVisible.value ? undefined : { display: 'none' },\n              ref: (el: unknown) => { ctx.pageSizeContentRef.value = el as HTMLElement },\n            }, [\n              h('div', select.getListProps() as Record<string, unknown>, select.collection.map(option =>\n                h('div', {\n                  ...select.getItemProps({ value: option.value }) as Record<string, unknown>,\n                  key: option.value,\n                }, [\n                  h('span', select.getItemTextProps({ value: option.value }) as Record<string, unknown>, option.label),\n                  h('span', select.getItemIndicatorProps({ value: option.value }) as Record<string, unknown>),\n                ]))),\n            ]),\n          ]),\n        ]),\n      ]\n    }\n  },\n})\n\nexport const XhPaginationPositioner = defineComponent({\n  name: 'XhPaginationPositioner',\n  props: {\n    /** 本实例的省略页 Portal 容器；优先于应用级配置。 */\n    container: { type: Object as PropType<Element> },\n  },\n  // 根是 Teleport，Vue 不会把直通属性合上去，作者写的 class 与 style 得自己接住落到 positioner 上\n  inheritAttrs: false,\n  setup(props, { slots, attrs }) {\n    const ctx = usePaginationContext()\n    // 折叠页码列表的自绘条：与 content 同级、绝对定位不占布局，壳是这层已经 fixed 的 positioner\n    // 浮层里的条子走 4px 档（§6.6）\n    const bars = useScrollbars({ scrollable: () => ctx.contentRef.value, props: { size: 'sm' } })\n    // 搬到 portal 落点：留在原地的话，宿主祖先只要建了层叠上下文就能盖住浮层\n    return () => h(XhPortal, { to: props.container ?? ctx.portalTarget.value, source: ctx.ellipsisRef }, () => [\n      h('div', {\n        ...mergeProps(ctx.api.value.getPositionerProps() as Record<string, unknown>, attrs),\n        ref: (el: unknown) => { ctx.positionerRef.value = el as HTMLElement },\n      }, [...(slots.default?.() ?? []), ...bars.render()]),\n    ])\n  },\n})\n\nexport const XhPaginationContent = defineComponent({\n  name: 'XhPaginationContent',\n  slots: Object as SlotsType<{\n    default?: (props: { pages: number[] }) => VNode[]\n  }>,\n  setup(_, { slots }) {\n    const ctx = usePaginationContext()\n    return () => {\n      const open = ctx.api.value.openEllipsis\n      const folded = ctx.api.value.pageItems.find(\n        item => item.type === 'ellipsis' && item.side === open,\n      )\n      return h('div', {\n        ...ctx.api.value.getContentProps() as Record<string, unknown>,\n        // 收起跟着退场闸门走：皮肤刻意没给 content 补 [hidden]{display:none}\n        // （补了退场就一帧都播不出来），真正的收起落成内联 display\n        style: ctx.visible.value ? undefined : { display: 'none' },\n        ref: (el: unknown) => { ctx.contentRef.value = el as HTMLElement },\n      }, slots.default?.({ pages: folded?.type === 'ellipsis' ? folded.pages : [] }))\n    }\n  },\n})\n"],"mappings":"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"}

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

@@ -3,16 +3,22 @@ import { PaginationApi, PaginationSchema } from "@xihan-ui/headless";
 //#region src/components/pagination/use-pagination.d.ts
 interface PaginationContext {
   api: ComputedRef<PaginationApi>;
-  /** 摊开的那个省略位，定位锚点。 */
+  /** 展开的省略位，定位锚点。 */
   ellipsisRef: Ref<HTMLElement | null>;
   /** 被定位的浮层。 */
   positionerRef: Ref<HTMLElement | null>;
   /** 消解层节点。 */
   contentRef: Ref<HTMLElement | null>;
-  /** 此刻该不该渲染：退场动画播完之前仍为真。 */
+  /** 当前是否应当渲染：退场动画播完之前仍为真。 */
   visible: Ref<boolean>;
-  /** 浮层搬到哪儿：全局配置的 portalContainer > body。 */
+  /** 浮层迁移到的位置：全局配置的 portalContainer > body。 */
   portalTarget: ComputedRef<string | Element>;
+  /** 每页条数下拉的触发器，它是该层的定位锚点。 */
+  pageSizeTriggerRef: Ref<HTMLElement | null>;
+  pageSizePositionerRef: Ref<HTMLElement | null>;
+  pageSizeContentRef: Ref<HTMLElement | null>;
+  /** 下拉层当前是否应当渲染；与省略位层各自使用独立的闸门。 */
+  pageSizeVisible: Ref<boolean>;
 }
 declare function usePagination(props: PaginationSchema['props'], onPageChange?: PaginationSchema['props']['onPageChange'], onPageSizeChange?: PaginationSchema['props']['onPageSizeChange']): PaginationContext;
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"use-pagination.d.ts","names":[],"sources":["../../../src/components/pagination/use-pagination.ts"],"mappings":";;;UAaiB;EACf,KAAK,YAAY;;EAEjB,aAAa,IAAI;;EAEjB,eAAe,IAAI;;EAEnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;iBAGrB,cACd,OAAO,2BACP,eAAe,2CACf,mBAAmB,gDAClB"}
+{"version":3,"file":"use-pagination.d.ts","names":[],"sources":["../../../src/components/pagination/use-pagination.ts"],"mappings":";;;UAoBiB;EACf,KAAK,YAAY;;EAEjB,aAAa,IAAI;;EAEjB,eAAe,IAAI;;EAEnB,YAAY,IAAI;;EAEhB,SAAS;;EAET,cAAc,qBAAqB;;EAEnC,oBAAoB,IAAI;EACxB,uBAAuB,IAAI;EAC3B,oBAAoB,IAAI;;EAExB,iBAAiB;;iBAGH,cACd,OAAO,2BACP,eAAe,2CACf,mBAAmB,gDAClB"}