niuma-ui 2.0.4 → 2.1.0

package/dist/components/pagination/src/RsPagination.impl.js

@@ -1,11 +1,13 @@
+import { useRsConfigOptional } from "../../../composables/useRsConfig.js";
+import { resolveDirMode } from "../../../locale/apply.js";
 import { useRsI18n } from "../../../composables/useRsI18n.js";
-import RsButton_default from "../../button/src/RsButton.js";
+import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
 import RsInput_default from "../../input/src/RsInput.js";
 import RsSelect_default from "../../select/src/RsSelect.js";
-import { DEFAULT_PAGE_SIZE_OPTIONS, clampPage, getPageCount, getPaginationRange } from "./pagination-utils.js";
-import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeModels, normalizeClass, openBlock, ref, renderList, toDisplayString, unref, useModel, watch, withCtx } from "vue";
+import { DEFAULT_PAGE_SIZE_OPTIONS, buildPaginationPagerItems, clampPage, getPageCount, getPaginationRange, paginationItemKey, resolveAdjacentPagerKey, resolveFocusablePagerKeys, resolvePaginationKeyboardMove, resolvePaginationSize, shouldHidePagination } from "./pagination-utils.js";
+import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, guardReactiveProps, mergeModels, mergeProps, normalizeClass, normalizeProps, openBlock, ref, renderList, renderSlot, toDisplayString, unref, useModel, watch } from "vue";
 //#region src/components/pagination/src/RsPagination.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = ["aria-label"];
+var _hoisted_1 = ["id", "aria-label"];
 var _hoisted_2 = {
 	key: 0,
 	class: "rs-pagination__summary"
@@ -13,24 +15,39 @@ var _hoisted_2 = {
 var _hoisted_3 = { class: "rs-pagination__buttons" };
 var _hoisted_4 = {
 	key: 0,
-	class: "rs-pagination__ellipsis"
+	class: "rs-pagination__ellipsis",
+	"aria-hidden": "true"
 };
 var _hoisted_5 = {
+	key: 1,
+	class: "rs-pagination__simple"
+};
+var _hoisted_6 = [
+	"data-rs-pagination",
+	"disabled",
+	"tabindex",
+	"aria-current",
+	"aria-label",
+	"onClick"
+];
+var _hoisted_7 = {
 	key: 1,
 	class: "rs-pagination__jumper"
 };
-var _hoisted_6 = { class: "rs-pagination__jumper-label" };
-var _hoisted_7 = { class: "rs-pagination__jumper-input" };
-var _hoisted_8 = {
+var _hoisted_8 = { class: "rs-pagination__jumper-label" };
+var _hoisted_9 = { class: "rs-pagination__jumper-input" };
+var _hoisted_10 = {
 	key: 0,
 	class: "rs-pagination__jumper-suffix"
 };
-var _hoisted_9 = {
+var _hoisted_11 = ["disabled"];
+var _hoisted_12 = {
 	key: 2,
 	class: "rs-pagination__size"
 };
 var controlRadius = "sm";
 var RsPagination_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsPagination",
 	__name: "RsPagination",
 	props: /*@__PURE__*/ mergeModels({
 		total: {},
@@ -51,32 +68,74 @@ var RsPagination_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ def
 			type: Boolean,
 			default: false
 		},
+		showFirstLast: {
+			type: Boolean,
+			default: false
+		},
+		simple: {
+			type: Boolean,
+			default: false
+		},
+		hideOnSinglePage: {
+			type: Boolean,
+			default: false
+		},
 		pageSizeOptions: { default: () => DEFAULT_PAGE_SIZE_OPTIONS },
 		disabled: {
 			type: Boolean,
 			default: false
 		},
-		size: { default: "md" }
+		size: {},
+		align: { default: "start" },
+		ariaLabel: {},
+		id: {}
 	}, {
 		"page": { default: 1 },
 		"pageModifiers": {},
 		"pageSize": { default: 20 },
 		"pageSizeModifiers": {}
 	}),
-	emits: ["update:page", "update:pageSize"],
-	setup(__props) {
+	emits: /*@__PURE__*/ mergeModels(["change", "pageSizeChange"], ["update:page", "update:pageSize"]),
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const page = useModel(__props, "page");
 		const pageSize = useModel(__props, "pageSize");
 		const props = __props;
-		const { t } = useRsI18n();
+		const emit = __emit;
+		const { t, locale } = useRsI18n();
+		const config = useRsConfigOptional();
+		const rootRef = ref(null);
 		const jumpPageInput = ref(String(page.value));
+		const inheritedSize = useResolvedRsComponentSize(() => props.size);
+		const resolvedSize = computed(() => resolvePaginationSize(inheritedSize.value));
+		const writingDir = computed(() => resolveDirMode(config?.dir.value ?? "auto", locale.value));
 		const pageCount = computed(() => getPageCount(props.total, pageSize.value));
+		const hidden = computed(() => shouldHidePagination(props.hideOnSinglePage, pageCount.value));
 		const range = computed(() => getPaginationRange(page.value, pageCount.value, props.siblingCount));
+		const pagerItems = computed(() => buildPaginationPagerItems({
+			page: page.value,
+			pageCount: pageCount.value,
+			range: range.value,
+			simple: props.simple,
+			showFirstLast: props.showFirstLast,
+			disabled: props.disabled
+		}));
+		const focusableKeys = computed(() => resolveFocusablePagerKeys(pagerItems.value));
 		const summaryText = computed(() => t("pagination.summary", "{total, plural, one {# item} other {# items}}", { total: props.total }));
+		const simpleText = computed(() => t("pagination.simple", "{page} / {pageCount}", {
+			page: page.value,
+			pageCount: pageCount.value
+		}));
+		const navLabel = computed(() => props.ariaLabel || t("pagination.label"));
+		const summarySlot = computed(() => ({
+			total: props.total,
+			page: page.value,
+			pageSize: pageSize.value,
+			pageCount: pageCount.value
+		}));
 		const pageSizeSelectValue = computed({
 			get: () => String(pageSize.value),
 			set: (value) => {
-				pageSize.value = Number(value);
+				setPageSize(Number(value));
 			}
 		});
 		const pageSizeSelectOptions = computed(() => props.pageSizeOptions.map((option) => ({
@@ -84,17 +143,67 @@ var RsPagination_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ def
 			value: String(option)
 		})));
 		const showJumper = computed(() => props.showQuickJumper && pageCount.value > 1);
-		/** 页码按钮用 sm 圆角，避免 Button 默认 full 胶囊 */
-		const controlSize = computed(() => props.size);
+		const controlSize = computed(() => resolvedSize.value);
 		watch(pageCount, (count) => {
-			page.value = clampPage(page.value, count);
+			const next = clampPage(page.value, count);
+			if (next === page.value) return;
+			page.value = next;
+			emit("change", next, pageSize.value);
 		});
 		watch(page, (value) => {
 			jumpPageInput.value = String(value);
 		});
-		function go(next) {
-			if (props.disabled) return;
-			page.value = clampPage(next, pageCount.value);
+		function setPage(next) {
+			if (props.disabled) return false;
+			const clamped = clampPage(next, pageCount.value);
+			if (clamped === page.value) {
+				jumpPageInput.value = String(clamped);
+				return false;
+			}
+			page.value = clamped;
+			emit("change", clamped, pageSize.value);
+			return true;
+		}
+		function setPageSize(next) {
+			if (props.disabled) return false;
+			const size = Number.isFinite(next) && next > 0 ? Math.floor(next) : pageSize.value;
+			const sizeChanged = size !== pageSize.value;
+			if (sizeChanged) pageSize.value = size;
+			const nextPage = clampPage(page.value, getPageCount(props.total, size));
+			const pageChanged = nextPage !== page.value;
+			if (pageChanged) page.value = nextPage;
+			if (sizeChanged) emit("pageSizeChange", size, nextPage);
+			if (sizeChanged || pageChanged) emit("change", nextPage, size);
+			return sizeChanged;
+		}
+		function goTo(next) {
+			return setPage(next);
+		}
+		function prev() {
+			if (page.value <= 1) return void 0;
+			return setPage(page.value - 1) ? page.value : void 0;
+		}
+		function next() {
+			if (page.value >= pageCount.value) return void 0;
+			return setPage(page.value + 1) ? page.value : void 0;
+		}
+		function first() {
+			if (page.value <= 1) return void 0;
+			return setPage(1) ? page.value : void 0;
+		}
+		function last() {
+			if (page.value >= pageCount.value) return void 0;
+			return setPage(pageCount.value) ? page.value : void 0;
+		}
+		function findPager(key) {
+			return rootRef.value?.querySelector(`[data-rs-pagination="${key}"]`) ?? null;
+		}
+		function focus(targetPage) {
+			(findPager(targetPage != null ? paginationItemKey("page", clampPage(targetPage, pageCount.value)) : paginationItemKey("page", page.value)) ?? findPager(focusableKeys.value[0] ?? ""))?.focus();
+		}
+		function activate(item) {
+			if (item.disabled || item.type === "ellipsis" || item.type === "simple") return;
+			setPage(item.page);
 		}
 		function confirmJump() {
 			if (props.disabled) return;
@@ -103,90 +212,124 @@ var RsPagination_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ def
 				jumpPageInput.value = String(page.value);
 				return;
 			}
-			go(parsed);
+			setPage(parsed);
 			jumpPageInput.value = String(page.value);
 		}
+		function itemAriaLabel(item) {
+			if (item.type === "page") return item.active ? t("pagination.current", "Page {page}, current", { page: item.page }) : t("pagination.pageN", "Page {page}", { page: item.page });
+			if (item.type === "first") return t("pagination.first");
+			if (item.type === "last") return t("pagination.last");
+			if (item.type === "prev") return t("pagination.prev");
+			if (item.type === "next") return t("pagination.next");
+		}
+		function defaultItemLabel(item) {
+			if (item.type === "page") return String(item.page);
+			if (item.type === "first") return t("pagination.first");
+			if (item.type === "last") return t("pagination.last");
+			if (item.type === "prev") return t("pagination.prev");
+			if (item.type === "next") return t("pagination.next");
+			if (item.type === "simple") return simpleText.value;
+			return "…";
+		}
+		function slotProps(item) {
+			return {
+				type: item.type,
+				page: item.page,
+				active: item.active,
+				disabled: item.disabled
+			};
+		}
+		function isButton(type) {
+			return type !== "ellipsis" && type !== "simple";
+		}
+		function onKeydown(event) {
+			if (props.disabled || hidden.value) return;
+			const target = event.target;
+			if (!(target instanceof HTMLElement) || !target.closest("[data-rs-pagination]")) return;
+			if (target.closest("input, textarea, select, [contenteditable=\"true\"]")) return;
+			if (target.closest(".rs-pagination__jumper, .rs-pagination__size")) return;
+			const move = resolvePaginationKeyboardMove(event.key, writingDir.value === "rtl");
+			if (move == null) return;
+			const nextKey = resolveAdjacentPagerKey(focusableKeys.value, target.closest("[data-rs-pagination]")?.dataset.rsPagination, move);
+			if (!nextKey) return;
+			event.preventDefault();
+			findPager(nextKey)?.focus();
+		}
+		__expose({
+			goTo,
+			prev,
+			next,
+			first,
+			last,
+			focus
+		});
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("nav", {
-				class: normalizeClass(["rs-pagination", [`rs-pagination--${__props.size}`, { "rs-pagination--no-jump-confirm": !__props.showJumpConfirm }]]),
-				"aria-label": unref(t)("pagination.label")
+			return !hidden.value ? (openBlock(), createElementBlock("nav", {
+				key: 0,
+				id: __props.id,
+				ref_key: "rootRef",
+				ref: rootRef,
+				class: normalizeClass(["rs-pagination", [
+					`rs-pagination--${resolvedSize.value}`,
+					`rs-pagination--align-${__props.align}`,
+					{
+						"rs-pagination--no-jump-confirm": !__props.showJumpConfirm,
+						"rs-pagination--disabled": __props.disabled,
+						"rs-pagination--simple": __props.simple
+					}
+				]]),
+				"aria-label": navLabel.value,
+				onKeydown
 			}, [
-				__props.showSummary ? (openBlock(), createElementBlock("span", _hoisted_2, toDisplayString(summaryText.value), 1)) : createCommentVNode("", true),
-				createElementVNode("div", _hoisted_3, [
-					createVNode(RsButton_default, {
-						variant: "ghost",
-						size: controlSize.value,
-						radius: controlRadius,
-						disabled: __props.disabled || page.value <= 1,
-						onClick: _cache[0] || (_cache[0] = ($event) => go(page.value - 1))
-					}, {
-						default: withCtx(() => [createTextVNode(toDisplayString(unref(t)("pagination.prev")), 1)]),
-						_: 1
-					}, 8, ["size", "disabled"]),
-					(openBlock(true), createElementBlock(Fragment, null, renderList(range.value, (item, index) => {
-						return openBlock(), createElementBlock(Fragment, { key: `${item}-${index}` }, [item === "ellipsis" ? (openBlock(), createElementBlock("span", _hoisted_4, "...")) : (openBlock(), createBlock(RsButton_default, {
-							key: 1,
-							variant: "text",
-							tone: item === page.value ? "primary" : "neutral",
-							size: controlSize.value,
-							radius: controlRadius,
-							class: normalizeClass(["rs-pagination__page", { "rs-pagination__page--active": item === page.value }]),
-							disabled: __props.disabled,
-							onClick: ($event) => go(item)
-						}, {
-							default: withCtx(() => [createTextVNode(toDisplayString(item), 1)]),
-							_: 2
-						}, 1032, [
-							"tone",
-							"size",
-							"class",
-							"disabled",
-							"onClick"
-						]))], 64);
-					}), 128)),
-					createVNode(RsButton_default, {
-						variant: "ghost",
-						size: controlSize.value,
-						radius: controlRadius,
-						disabled: __props.disabled || page.value >= pageCount.value,
-						onClick: _cache[1] || (_cache[1] = ($event) => go(page.value + 1))
-					}, {
-						default: withCtx(() => [createTextVNode(toDisplayString(unref(t)("pagination.next")), 1)]),
-						_: 1
-					}, 8, ["size", "disabled"])
-				]),
-				showJumper.value ? (openBlock(), createElementBlock("div", _hoisted_5, [
-					createElementVNode("span", _hoisted_6, toDisplayString(unref(t)("pagination.jumpTo")), 1),
-					createElementVNode("div", _hoisted_7, [createVNode(RsInput_default, {
+				__props.showSummary ? (openBlock(), createElementBlock("span", _hoisted_2, [renderSlot(_ctx.$slots, "summary", normalizeProps(guardReactiveProps(summarySlot.value)), () => [createTextVNode(toDisplayString(summaryText.value), 1)], true)])) : createCommentVNode("", true),
+				createElementVNode("div", _hoisted_3, [(openBlock(true), createElementBlock(Fragment, null, renderList(pagerItems.value, (item) => {
+					return openBlock(), createElementBlock(Fragment, { key: item.key }, [item.type === "ellipsis" ? (openBlock(), createElementBlock("span", _hoisted_4, [renderSlot(_ctx.$slots, "item", mergeProps({ ref_for: true }, slotProps(item)), () => [_cache[2] || (_cache[2] = createTextVNode("…", -1))], true)])) : item.type === "simple" ? (openBlock(), createElementBlock("span", _hoisted_5, [renderSlot(_ctx.$slots, "item", mergeProps({ ref_for: true }, slotProps(item)), () => [createTextVNode(toDisplayString(simpleText.value), 1)], true)])) : isButton(item.type) ? (openBlock(), createElementBlock("button", {
+						key: 2,
+						type: "button",
+						class: normalizeClass(["rs-pagination__item", {
+							"rs-pagination__page": item.type === "page",
+							"rs-pagination__page--active": item.active,
+							"rs-pagination__item--active": item.active
+						}]),
+						"data-rs-pagination": item.key,
+						disabled: item.disabled,
+						tabindex: item.disabled ? -1 : 0,
+						"aria-current": item.active ? "page" : void 0,
+						"aria-label": itemAriaLabel(item),
+						onClick: ($event) => activate(item)
+					}, [renderSlot(_ctx.$slots, "item", mergeProps({ ref_for: true }, slotProps(item)), () => [createTextVNode(toDisplayString(defaultItemLabel(item)), 1)], true)], 10, _hoisted_6)) : createCommentVNode("", true)], 64);
+				}), 128))]),
+				showJumper.value ? (openBlock(), createElementBlock("div", _hoisted_7, [
+					createElementVNode("span", _hoisted_8, toDisplayString(unref(t)("pagination.jumpTo")), 1),
+					createElementVNode("div", _hoisted_9, [createVNode(RsInput_default, {
 						modelValue: jumpPageInput.value,
-						"onUpdate:modelValue": _cache[2] || (_cache[2] = ($event) => jumpPageInput.value = $event),
+						"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => jumpPageInput.value = $event),
 						size: controlSize.value,
 						radius: controlRadius,
 						disabled: __props.disabled,
+						"show-validate-message": false,
+						"aria-label": unref(t)("pagination.jumpTo"),
 						onPressEnter: confirmJump,
 						onBlur: confirmJump
 					}, null, 8, [
 						"modelValue",
 						"size",
-						"disabled"
+						"disabled",
+						"aria-label"
 					])]),
-					unref(t)("pagination.jumpPageSuffix") ? (openBlock(), createElementBlock("span", _hoisted_8, toDisplayString(unref(t)("pagination.jumpPageSuffix")), 1)) : createCommentVNode("", true),
-					__props.showJumpConfirm ? (openBlock(), createBlock(RsButton_default, {
+					unref(t)("pagination.jumpPageSuffix") ? (openBlock(), createElementBlock("span", _hoisted_10, toDisplayString(unref(t)("pagination.jumpPageSuffix")), 1)) : createCommentVNode("", true),
+					__props.showJumpConfirm ? (openBlock(), createElementBlock("button", {
 						key: 1,
-						variant: "ghost",
-						size: controlSize.value,
-						radius: controlRadius,
-						class: "rs-pagination__jumper-btn",
+						type: "button",
+						class: "rs-pagination__item rs-pagination__jumper-btn",
+						"data-rs-pagination": "confirm",
 						disabled: __props.disabled,
 						onClick: confirmJump
-					}, {
-						default: withCtx(() => [createTextVNode(toDisplayString(unref(t)("pagination.jumpConfirm")), 1)]),
-						_: 1
-					}, 8, ["size", "disabled"])) : createCommentVNode("", true)
+					}, toDisplayString(unref(t)("pagination.jumpConfirm")), 9, _hoisted_11)) : createCommentVNode("", true)
 				])) : createCommentVNode("", true),
-				__props.showPageSize ? (openBlock(), createElementBlock("div", _hoisted_9, [createVNode(RsSelect_default, {
+				__props.showPageSize ? (openBlock(), createElementBlock("div", _hoisted_12, [createVNode(RsSelect_default, {
 					modelValue: pageSizeSelectValue.value,
-					"onUpdate:modelValue": _cache[3] || (_cache[3] = ($event) => pageSizeSelectValue.value = $event),
+					"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => pageSizeSelectValue.value = $event),
 					options: pageSizeSelectOptions.value,
 					size: controlSize.value,
 					radius: controlRadius,
@@ -200,7 +343,7 @@ var RsPagination_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ def
 					"disabled",
 					"placeholder"
 				])])) : createCommentVNode("", true)
-			], 10, _hoisted_1);
+			], 42, _hoisted_1)) : createCommentVNode("", true);
 		};
 	}
 });

package/dist/components/pagination/src/RsPagination.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import RsPagination_vue_vue_type_script_setup_true_lang_default from "./RsPagination.impl.js";
 
 //#region src/components/pagination/src/RsPagination.vue
-var RsPagination_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsPagination_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-6db615ba"]]);
+var RsPagination_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsPagination_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-84ae3155"]]);
 //#endregion
 export { RsPagination_default as default };

package/dist/components/pagination/src/pagination-utils.d.ts

@@ -1,4 +1,44 @@
+import type { RsComponentSize } from '../../../theme/types';
 export declare const DEFAULT_PAGE_SIZE_OPTIONS: readonly [10, 20, 50, 100];
+/**
+ * 分页尺寸（对齐 Ant Design Pagination：small / medium / large）。
+ * 不提供 ssm：页码按钮过小不利于点击。ConfigProvider 的 ssm 会落到 sm。
+ */
+export type RsPaginationSize = Extract<RsComponentSize, 'sm' | 'md' | 'lg'>;
+export type RsPaginationAlign = 'start' | 'center' | 'end';
+export type RsPaginationItemType = 'page' | 'prev' | 'next' | 'first' | 'last' | 'ellipsis' | 'simple';
+export interface RsPaginationItemSlot {
+    type: RsPaginationItemType;
+    page: number;
+    active: boolean;
+    disabled: boolean;
+}
+export interface RsPaginationSummarySlot {
+    total: number;
+    page: number;
+    pageSize: number;
+    pageCount: number;
+}
+export interface RsPaginationPagerItem extends RsPaginationItemSlot {
+    key: string;
+}
+export interface RsPaginationExpose {
+    /** 跳到指定页。越界会夹紧。禁用或未变化时返回 false。 */
+    goTo: (page: number) => boolean;
+    /** 上一页。已在首页或禁用时返回 undefined。 */
+    prev: () => number | undefined;
+    /** 下一页。已在末页或禁用时返回 undefined。 */
+    next: () => number | undefined;
+    /** 第一页。已在首页或禁用时返回 undefined。 */
+    first: () => number | undefined;
+    /** 最后一页。已在末页或禁用时返回 undefined。 */
+    last: () => number | undefined;
+    /** 焦点落到指定页码按钮；未传则落到当前页。 */
+    focus: (page?: number) => void;
+}
+export type RsPaginationInstance = RsPaginationExpose & {
+    $el: HTMLElement;
+};
 export declare function getPageCount(total: number, pageSize: number): number;
 export declare function clampPage(page: number, pageCount: number): number;
 export declare function getPaginationRange(page: number, pageCount: number, siblingCount?: number): Array<number | 'ellipsis'>;
@@ -7,3 +47,22 @@ export declare function createPageSizeSelectOptions(options?: readonly number[])
     label: string;
     value: string;
 }[];
+/** 未传或非法尺寸落到 md；ssm 与 sm 都按 sm。 */
+export declare function resolvePaginationSize(size?: RsComponentSize | null): RsPaginationSize;
+export declare function shouldHidePagination(hideOnSinglePage: boolean, pageCount: number): boolean;
+/**
+ * 页码条键盘位移。左右在 RTL 下对调。
+ * Home / End 返回端点；不处理的键返回 null。
+ */
+export declare function resolvePaginationKeyboardMove(key: string, rtl?: boolean): number | 'start' | 'end' | null;
+export declare function paginationItemKey(type: RsPaginationItemType, page?: number): string;
+export declare function buildPaginationPagerItems(options: {
+    page: number;
+    pageCount: number;
+    range: ReadonlyArray<number | 'ellipsis'>;
+    simple: boolean;
+    showFirstLast: boolean;
+    disabled: boolean;
+}): RsPaginationPagerItem[];
+export declare function resolveFocusablePagerKeys(items: readonly RsPaginationPagerItem[]): string[];
+export declare function resolveAdjacentPagerKey(keys: readonly string[], current: string | undefined, move: number | 'start' | 'end'): string | undefined;

package/dist/components/pagination/src/pagination-utils.js

@@ -49,5 +49,109 @@ function createPageSizeSelectOptions(options = DEFAULT_PAGE_SIZE_OPTIONS) {
 		value: String(value)
 	}));
 }
+/** 未传或非法尺寸落到 md；ssm 与 sm 都按 sm。 */
+function resolvePaginationSize(size) {
+	if (size === "lg") return "lg";
+	if (size === "sm" || size === "ssm") return "sm";
+	return "md";
+}
+function shouldHidePagination(hideOnSinglePage, pageCount) {
+	return hideOnSinglePage && pageCount <= 1;
+}
+/**
+* 页码条键盘位移。左右在 RTL 下对调。
+* Home / End 返回端点；不处理的键返回 null。
+*/
+function resolvePaginationKeyboardMove(key, rtl = false) {
+	if (key === "Home") return "start";
+	if (key === "End") return "end";
+	if (key === "ArrowLeft") return rtl ? 1 : -1;
+	if (key === "ArrowRight") return rtl ? -1 : 1;
+	return null;
+}
+function paginationItemKey(type, page = 0) {
+	return type === "page" ? `page-${page}` : type;
+}
+function buildPaginationPagerItems(options) {
+	const { page, pageCount, range, simple, showFirstLast, disabled } = options;
+	const items = [];
+	const atFirst = page <= 1;
+	const atLast = page >= pageCount;
+	if (showFirstLast) items.push({
+		key: "first",
+		type: "first",
+		page: 1,
+		active: false,
+		disabled: disabled || atFirst
+	});
+	items.push({
+		key: "prev",
+		type: "prev",
+		page: Math.max(1, page - 1),
+		active: false,
+		disabled: disabled || atFirst
+	});
+	if (simple) items.push({
+		key: "simple",
+		type: "simple",
+		page,
+		active: false,
+		disabled: false
+	});
+	else {
+		let ellipsisIndex = 0;
+		for (const entry of range) {
+			if (entry === "ellipsis") {
+				items.push({
+					key: `ellipsis-${ellipsisIndex}`,
+					type: "ellipsis",
+					page: 0,
+					active: false,
+					disabled: false
+				});
+				ellipsisIndex += 1;
+				continue;
+			}
+			items.push({
+				key: paginationItemKey("page", entry),
+				type: "page",
+				page: entry,
+				active: entry === page,
+				disabled
+			});
+		}
+	}
+	items.push({
+		key: "next",
+		type: "next",
+		page: Math.min(pageCount, page + 1),
+		active: false,
+		disabled: disabled || atLast
+	});
+	if (showFirstLast) items.push({
+		key: "last",
+		type: "last",
+		page: pageCount,
+		active: false,
+		disabled: disabled || atLast
+	});
+	return items;
+}
+function resolveFocusablePagerKeys(items) {
+	const keys = [];
+	for (const item of items) {
+		if (item.type === "ellipsis" || item.type === "simple" || item.disabled) continue;
+		keys.push(item.key);
+	}
+	return keys;
+}
+function resolveAdjacentPagerKey(keys, current, move) {
+	if (keys.length === 0) return void 0;
+	if (move === "start") return keys[0];
+	if (move === "end") return keys.at(-1);
+	let from = current ? keys.indexOf(current) : -1;
+	if (from < 0) from = move > 0 ? -1 : keys.length;
+	return keys[from + move];
+}
 //#endregion
-export { DEFAULT_PAGE_SIZE_OPTIONS, clampPage, createPageSizeSelectOptions, getPageCount, getPaginationRange, slicePageData };
+export { DEFAULT_PAGE_SIZE_OPTIONS, buildPaginationPagerItems, clampPage, createPageSizeSelectOptions, getPageCount, getPaginationRange, paginationItemKey, resolveAdjacentPagerKey, resolveFocusablePagerKeys, resolvePaginationKeyboardMove, resolvePaginationSize, shouldHidePagination, slicePageData };

package/dist/components/popover/index.d.ts

@@ -1 +1,2 @@
 export { default as RsPopover } from './src/RsPopover.js';
+export type { RsPopoverAlign, RsPopoverExpose, RsPopoverGetPopupContainer, RsPopoverInstance, RsPopoverSide, RsPopoverTrigger, RsPopoverWidth, } from './src/popover-utils';