niuma-ui 2.0.4 → 2.0.9

package/dist/components/steps/src/RsSteps.d.ts

@@ -1,22 +1,86 @@
-import type { RsStepItem, RsStepsOrientation, RsStepsSize } from './steps-utils';
+import type { RsStepItem, RsStepStatus, RsStepsLabelPlacement, RsStepsOrientation, RsStepsSize, RsStepsType } from './steps-utils';
 type __VLS_Props = {
     items: RsStepItem[];
     orientation?: RsStepsOrientation;
     size?: RsStepsSize;
     clickable?: boolean;
+    /** 标题在指示器旁（end）或下方（bottom）。竖排时仍在旁。 */
+    labelPlacement?: RsStepsLabelPlacement;
+    /** default 数字/图标；dot 圆点。 */
+    type?: RsStepsType;
+    /** 覆盖当前步状态（单项 status 仍优先）。 */
+    status?: RsStepStatus;
+    /** 当前步完成百分比 0–100。只影响 default + process 指示器。 */
+    percent?: number;
+    ariaLabel?: string;
+    id?: string;
 };
+declare function goTo(value: string): boolean;
+declare function next(): string | undefined;
+declare function prev(): string | undefined;
+declare function focus(value?: string): void;
 type __VLS_ModelProps = {
     modelValue?: string;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: string | undefined) => any;
+declare var __VLS_9: {
+    item: RsStepItem;
+    index: number;
+    status: RsStepStatus;
+    active: boolean;
+    disabled: boolean;
+}, __VLS_11: {
+    item: RsStepItem;
+    index: number;
+    status: RsStepStatus;
+    active: boolean;
+    disabled: boolean;
+}, __VLS_28: {
+    item: RsStepItem;
+    index: number;
+    status: RsStepStatus;
+    active: boolean;
+    disabled: boolean;
+}, __VLS_30: {
+    item: RsStepItem;
+    index: number;
+    status: RsStepStatus;
+    active: boolean;
+    disabled: boolean;
+};
+type __VLS_Slots = {} & {
+    item?: (props: typeof __VLS_9) => any;
+} & {
+    icon?: (props: typeof __VLS_11) => any;
+} & {
+    title?: (props: typeof __VLS_28) => any;
+} & {
+    description?: (props: typeof __VLS_30) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    next: typeof next;
+    prev: typeof prev;
+    goTo: typeof goTo;
+    focus: typeof focus;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    change: (value: string, item: RsStepItem) => any;
+    click: (item: RsStepItem, event: MouseEvent) => any;
+    "update:modelValue": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+    onChange?: ((value: string, item: RsStepItem) => any) | undefined;
+    onClick?: ((item: RsStepItem, event: MouseEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
-    size: RsStepsSize;
+    type: RsStepsType;
     orientation: RsStepsOrientation;
+    labelPlacement: RsStepsLabelPlacement;
     clickable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/steps/src/RsSteps.impl.js

@@ -1,53 +1,193 @@
-import { resolveStepStatus } from "./steps-utils.js";
-import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeModels, normalizeClass, openBlock, renderList, toDisplayString, unref, useModel } from "vue";
+import { useRsConfigOptional } from "../../../composables/useRsConfig.js";
+import { resolveDirMode } from "../../../locale/apply.js";
+import { useRsI18n } from "../../../composables/useRsI18n.js";
+import RsIcon_default from "../../icon/src/RsIcon.js";
+import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
+import { buildStepRenderItems, clampStepPercent, resolveActiveStepIndex, resolveAdjacentStepValue, resolveSelectableStepValues, resolveStepKeyboardMove } from "./steps-utils.js";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, defineComponent, mergeModels, mergeProps, normalizeClass, normalizeStyle, openBlock, ref, renderList, renderSlot, resolveDynamicComponent, toDisplayString, unref, useModel, withCtx } from "vue";
 //#region src/components/steps/src/RsSteps.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = ["disabled", "onClick"];
-var _hoisted_2 = { class: "rs-steps__indicator" };
-var _hoisted_3 = { class: "rs-steps__body" };
-var _hoisted_4 = { class: "rs-steps__title" };
-var _hoisted_5 = {
+var _hoisted_1 = ["id", "aria-label"];
+var _hoisted_2 = { class: "rs-steps__list" };
+var _hoisted_3 = ["aria-current"];
+var _hoisted_4 = { class: "rs-steps__mark" };
+var _hoisted_5 = { class: "rs-steps__body" };
+var _hoisted_6 = { class: "rs-steps__title" };
+var _hoisted_7 = {
 	key: 0,
 	class: "rs-steps__description"
 };
-var _hoisted_6 = {
-	key: 0,
-	class: "rs-steps__separator"
-};
+var _hoisted_8 = { class: "rs-steps__status" };
 var RsSteps_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsSteps",
 	__name: "RsSteps",
 	props: /*@__PURE__*/ mergeModels({
 		items: {},
 		orientation: { default: "horizontal" },
-		size: { default: "md" },
+		size: {},
 		clickable: {
 			type: Boolean,
 			default: false
-		}
+		},
+		labelPlacement: { default: "end" },
+		type: { default: "default" },
+		status: {},
+		percent: {},
+		ariaLabel: {},
+		id: {}
 	}, {
-		"modelValue": {},
+		"modelValue": { default: "" },
 		"modelModifiers": {}
 	}),
-	emits: ["update:modelValue"],
-	setup(__props) {
+	emits: /*@__PURE__*/ mergeModels(["change", "click"], ["update:modelValue"]),
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const model = useModel(__props, "modelValue");
 		const props = __props;
-		const activeIndex = computed(() => Math.max(0, props.items.findIndex((item) => item.value === model.value)));
-		function selectStep(item) {
+		const emit = __emit;
+		const { t, locale } = useRsI18n();
+		const config = useRsConfigOptional();
+		const rootRef = ref(null);
+		const resolvedSize = useResolvedRsComponentSize(() => props.size);
+		const writingDir = computed(() => resolveDirMode(config?.dir.value ?? "auto", locale.value));
+		const activeIndex = computed(() => resolveActiveStepIndex(props.items, model.value));
+		const rows = computed(() => buildStepRenderItems(props.items, activeIndex.value, props.type, props.status));
+		const selectableValues = computed(() => resolveSelectableStepValues(props.items));
+		const resolvedPercent = computed(() => clampStepPercent(props.percent));
+		const navLabel = computed(() => props.ariaLabel || t("steps.label"));
+		const currentValue = computed(() => props.items[activeIndex.value]?.value);
+		function statusLabel(status) {
+			return t(`steps.${status}`);
+		}
+		function slotProps(row) {
+			return {
+				item: row.item,
+				index: row.index,
+				status: row.status,
+				active: row.active,
+				disabled: row.disabled
+			};
+		}
+		function showPercent(row) {
+			return props.type === "default" && row.status === "process" && resolvedPercent.value != null;
+		}
+		function findTrigger(value) {
+			const root = rootRef.value;
+			if (!root) return null;
+			const nodes = root.querySelectorAll("[data-rs-step]");
+			for (const node of nodes) if (node.dataset.rsStep === value) return node;
+			return null;
+		}
+		function goTo(value) {
+			const item = props.items.find((entry) => entry.value === value);
+			if (!item || item.disabled) return false;
+			if (model.value === value) return true;
+			model.value = value;
+			emit("change", value, item);
+			return true;
+		}
+		function next() {
+			const value = resolveAdjacentStepValue(selectableValues.value, currentValue.value, 1);
+			return value && goTo(value) ? value : void 0;
+		}
+		function prev() {
+			const value = resolveAdjacentStepValue(selectableValues.value, currentValue.value, -1);
+			return value && goTo(value) ? value : void 0;
+		}
+		function focus(value) {
+			const target = value || currentValue.value || selectableValues.value[0];
+			if (!target) return;
+			findTrigger(target)?.focus();
+		}
+		function selectStep(item, event) {
+			emit("click", item, event);
 			if (!props.clickable || item.disabled) return;
-			model.value = item.value;
+			goTo(item.value);
+		}
+		function onKeydown(event) {
+			if (!props.clickable) return;
+			const target = event.target;
+			if (!(target instanceof HTMLElement) || !target.closest("[data-rs-step]")) return;
+			if (target.closest("input, textarea, select, [contenteditable=\"true\"]")) return;
+			const move = resolveStepKeyboardMove(event.key, props.orientation, writingDir.value === "rtl");
+			if (move == null) return;
+			const values = selectableValues.value;
+			if (values.length === 0) return;
+			event.preventDefault();
+			const focused = target.closest("[data-rs-step]")?.dataset.rsStep;
+			let nextValue;
+			if (move === "start") nextValue = values[0];
+			else if (move === "end") nextValue = values[values.length - 1];
+			else nextValue = resolveAdjacentStepValue(values, focused, move);
+			if (nextValue) focus(nextValue);
 		}
+		__expose({
+			next,
+			prev,
+			goTo,
+			focus
+		});
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("ol", { class: normalizeClass(["rs-steps", [`rs-steps--${__props.orientation}`, `rs-steps--${__props.size}`]]) }, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item, index) => {
+			return openBlock(), createElementBlock("nav", {
+				id: __props.id,
+				ref_key: "rootRef",
+				ref: rootRef,
+				class: normalizeClass(["rs-steps", [
+					`rs-steps--${__props.orientation}`,
+					`rs-steps--${unref(resolvedSize)}`,
+					`rs-steps--label-${__props.labelPlacement}`,
+					`rs-steps--${__props.type}`,
+					{ "rs-steps--clickable": __props.clickable }
+				]]),
+				"aria-label": navLabel.value,
+				onKeydown
+			}, [createElementVNode("ol", _hoisted_2, [(openBlock(true), createElementBlock(Fragment, null, renderList(rows.value, (row, index) => {
 				return openBlock(), createElementBlock("li", {
-					key: item.value,
-					class: normalizeClass(["rs-steps__item", `rs-steps__item--${unref(resolveStepStatus)(index, activeIndex.value, item.status)}`])
-				}, [createElementVNode("button", {
-					type: "button",
+					key: row.item.value,
+					class: normalizeClass(["rs-steps__item", [`rs-steps__item--${row.status}`, {
+						"rs-steps__item--active": row.active,
+						"rs-steps__item--disabled": row.disabled
+					}]]),
+					"aria-current": row.active ? "step" : void 0
+				}, [(openBlock(), createBlock(resolveDynamicComponent(__props.clickable ? "button" : "div"), {
+					type: __props.clickable ? "button" : void 0,
 					class: "rs-steps__trigger",
-					disabled: !__props.clickable || item.disabled,
-					onClick: ($event) => selectStep(item)
-				}, [createElementVNode("span", _hoisted_2, toDisplayString(index + 1), 1), createElementVNode("span", _hoisted_3, [createElementVNode("span", _hoisted_4, toDisplayString(item.title), 1), item.description ? (openBlock(), createElementBlock("span", _hoisted_5, toDisplayString(item.description), 1)) : createCommentVNode("", true)])], 8, _hoisted_1), index < __props.items.length - 1 ? (openBlock(), createElementBlock("span", _hoisted_6)) : createCommentVNode("", true)], 2);
-			}), 128))], 2);
+					"data-rs-step": row.item.value,
+					tabindex: __props.clickable && !row.disabled ? 0 : -1,
+					"aria-disabled": row.disabled ? "true" : void 0,
+					onClick: ($event) => selectStep(row.item, $event)
+				}, {
+					default: withCtx(() => [renderSlot(_ctx.$slots, "item", mergeProps({ ref_for: true }, slotProps(row)), () => [createElementVNode("span", {
+						class: normalizeClass(["rs-steps__indicator", { "rs-steps__indicator--percent": showPercent(row) }]),
+						style: normalizeStyle(showPercent(row) ? { "--rs-steps-percent": String(resolvedPercent.value) } : void 0)
+					}, [createElementVNode("span", _hoisted_4, [renderSlot(_ctx.$slots, "icon", mergeProps({ ref_for: true }, slotProps(row)), () => [row.indicator === "icon" && row.item.icon ? (openBlock(), createBlock(RsIcon_default, {
+						key: 0,
+						name: row.item.icon,
+						size: unref(resolvedSize)
+					}, null, 8, ["name", "size"])) : row.indicator === "check" ? (openBlock(), createBlock(RsIcon_default, {
+						key: 1,
+						name: "check",
+						size: unref(resolvedSize)
+					}, null, 8, ["size"])) : row.indicator === "error" ? (openBlock(), createBlock(RsIcon_default, {
+						key: 2,
+						name: "x",
+						size: unref(resolvedSize)
+					}, null, 8, ["size"])) : row.indicator !== "dot" ? (openBlock(), createElementBlock(Fragment, { key: 3 }, [createTextVNode(toDisplayString(row.index + 1), 1)], 64)) : createCommentVNode("", true)], true)])], 6), createElementVNode("span", _hoisted_5, [
+						createElementVNode("span", _hoisted_6, [renderSlot(_ctx.$slots, "title", mergeProps({ ref_for: true }, slotProps(row)), () => [createTextVNode(toDisplayString(row.item.title), 1)], true)]),
+						row.item.description || _ctx.$slots.description ? (openBlock(), createElementBlock("span", _hoisted_7, [renderSlot(_ctx.$slots, "description", mergeProps({ ref_for: true }, slotProps(row)), () => [createTextVNode(toDisplayString(row.item.description), 1)], true)])) : createCommentVNode("", true),
+						createElementVNode("span", _hoisted_8, toDisplayString(statusLabel(row.status)), 1)
+					])], true)]),
+					_: 2
+				}, 1032, [
+					"type",
+					"data-rs-step",
+					"tabindex",
+					"aria-disabled",
+					"onClick"
+				])), index < rows.value.length - 1 ? (openBlock(), createElementBlock("span", {
+					key: 0,
+					class: normalizeClass(["rs-steps__separator", { "rs-steps__separator--finish": row.completedSeparator }]),
+					"aria-hidden": "true"
+				}, null, 2)) : createCommentVNode("", true)], 10, _hoisted_3);
+			}), 128))])], 42, _hoisted_1);
 		};
 	}
 });

package/dist/components/steps/src/RsSteps.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import RsSteps_vue_vue_type_script_setup_true_lang_default from "./RsSteps.impl.js";
 
 //#region src/components/steps/src/RsSteps.vue
-var RsSteps_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsSteps_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-b7fdd868"]]);
+var RsSteps_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsSteps_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-773a38b0"]]);
 //#endregion
 export { RsSteps_default as default };

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

@@ -1,12 +1,62 @@
+import type { RsComponentSize } from '../../../theme/types';
 export type RsStepStatus = 'wait' | 'process' | 'finish' | 'error';
 export type RsStepsOrientation = 'horizontal' | 'vertical';
-export type RsStepsSize = 'sm' | 'md';
+export type RsStepsSize = RsComponentSize;
+export type RsStepsLabelPlacement = 'end' | 'bottom';
+export type RsStepsType = 'default' | 'dot';
 export interface RsStepItem {
     value: string;
     title: string;
     description?: string;
     status?: RsStepStatus;
     disabled?: boolean;
+    /** Lucide kebab-case。有值时覆盖默认数字 / 勾 / 叉。 */
+    icon?: string;
 }
+export interface RsStepsRenderItem {
+    item: RsStepItem;
+    index: number;
+    status: RsStepStatus;
+    active: boolean;
+    disabled: boolean;
+    completedSeparator: boolean;
+    indicator: 'number' | 'icon' | 'check' | 'error' | 'dot';
+}
+export interface RsStepsItemSlot {
+    item: RsStepItem;
+    index: number;
+    status: RsStepStatus;
+    active: boolean;
+    disabled: boolean;
+}
+export interface RsStepsExpose {
+    /** 跳到下一个未禁用步骤。已在末级或没有可选项时返回 undefined。 */
+    next: () => string | undefined;
+    /** 跳到上一个未禁用步骤。已在首级或没有可选项时返回 undefined。 */
+    prev: () => string | undefined;
+    /** 跳到指定 value。找不到或禁用时返回 false。 */
+    goTo: (value: string) => boolean;
+    /** 焦点落到指定步骤；未传则落到当前步。不可点时也能落（tabindex=-1）。 */
+    focus: (value?: string) => void;
+}
+export type RsStepsInstance = RsStepsExpose & {
+    $el: HTMLElement;
+};
 export declare function resolveStepStatus(index: number, activeIndex: number, explicit?: RsStepStatus): RsStepStatus;
 export declare function isStepSeparatorCompleted(status: RsStepStatus): boolean;
+/** model 对不上任一项时回退 0，与原先 Math.max(0, findIndex) 一致。 */
+export declare function resolveActiveStepIndex(items: readonly RsStepItem[], value?: string): number;
+/**
+ * 单项 status 优先；当前步可用组件级 status 覆盖自动推导（对标 Ant Design status）。
+ */
+export declare function resolveCurrentStepStatus(index: number, activeIndex: number, itemStatus?: RsStepStatus, currentStatus?: RsStepStatus): RsStepStatus;
+export declare function clampStepPercent(percent?: number): number | undefined;
+export declare function resolveSelectableStepValues(items: readonly RsStepItem[]): string[];
+export declare function resolveAdjacentStepValue(values: readonly string[], current: string | undefined, delta: number): string | undefined;
+/**
+ * 可点步骤的键盘位移。竖排只用上下；横排左右在 RTL 下对调。
+ * Home / End 返回端点；不处理的键返回 null。
+ */
+export declare function resolveStepKeyboardMove(key: string, orientation: RsStepsOrientation, rtl?: boolean): number | 'start' | 'end' | null;
+export declare function resolveStepIndicator(status: RsStepStatus, type: RsStepsType, icon?: string): RsStepsRenderItem['indicator'];
+export declare function buildStepRenderItems(items: readonly RsStepItem[], activeIndex: number, type?: RsStepsType, currentStatus?: RsStepStatus): RsStepsRenderItem[];

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

@@ -8,5 +8,71 @@ function resolveStepStatus(index, activeIndex, explicit) {
 function isStepSeparatorCompleted(status) {
 	return status === "finish";
 }
+/** model 对不上任一项时回退 0，与原先 Math.max(0, findIndex) 一致。 */
+function resolveActiveStepIndex(items, value) {
+	return Math.max(0, items.findIndex((item) => item.value === value));
+}
+/**
+* 单项 status 优先；当前步可用组件级 status 覆盖自动推导（对标 Ant Design status）。
+*/
+function resolveCurrentStepStatus(index, activeIndex, itemStatus, currentStatus) {
+	if (itemStatus) return itemStatus;
+	if (index === activeIndex && currentStatus) return currentStatus;
+	return resolveStepStatus(index, activeIndex);
+}
+function clampStepPercent(percent) {
+	if (percent == null || Number.isNaN(Number(percent))) return void 0;
+	return Math.min(100, Math.max(0, Number(percent)));
+}
+function resolveSelectableStepValues(items) {
+	const values = [];
+	for (const item of items) if (!item.disabled) values.push(item.value);
+	return values;
+}
+function resolveAdjacentStepValue(values, current, delta) {
+	if (values.length === 0) return void 0;
+	const index = current ? values.indexOf(current) : -1;
+	let next = index + delta;
+	if (index < 0) next = delta > 0 ? 0 : values.length - 1;
+	if (next < 0 || next >= values.length) return void 0;
+	return values[next];
+}
+/**
+* 可点步骤的键盘位移。竖排只用上下；横排左右在 RTL 下对调。
+* Home / End 返回端点；不处理的键返回 null。
+*/
+function resolveStepKeyboardMove(key, orientation, rtl = false) {
+	if (key === "Home") return "start";
+	if (key === "End") return "end";
+	if (orientation === "vertical") {
+		if (key === "ArrowUp") return -1;
+		if (key === "ArrowDown") return 1;
+		return null;
+	}
+	if (key === "ArrowLeft") return rtl ? 1 : -1;
+	if (key === "ArrowRight") return rtl ? -1 : 1;
+	return null;
+}
+function resolveStepIndicator(status, type, icon) {
+	if (type === "dot") return "dot";
+	if (icon) return "icon";
+	if (status === "finish") return "check";
+	if (status === "error") return "error";
+	return "number";
+}
+function buildStepRenderItems(items, activeIndex, type = "default", currentStatus) {
+	return items.map((item, index) => {
+		const status = resolveCurrentStepStatus(index, activeIndex, item.status, currentStatus);
+		return {
+			item,
+			index,
+			status,
+			active: index === activeIndex,
+			disabled: Boolean(item.disabled),
+			completedSeparator: isStepSeparatorCompleted(status),
+			indicator: resolveStepIndicator(status, type, item.icon)
+		};
+	});
+}
 //#endregion
-export { isStepSeparatorCompleted, resolveStepStatus };
+export { buildStepRenderItems, clampStepPercent, isStepSeparatorCompleted, resolveActiveStepIndex, resolveAdjacentStepValue, resolveCurrentStepStatus, resolveSelectableStepValues, resolveStepIndicator, resolveStepKeyboardMove, resolveStepStatus };

package/dist/components/table/src/RsTable.impl.js

@@ -31,6 +31,7 @@ var _hoisted_3 = {
 var _hoisted_4 = { key: 0 };
 var _hoisted_5 = ["colspan"];
 var RsTable_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsTable",
 	inheritAttrs: false,
 	__name: "RsTable",
 	props: /*@__PURE__*/ mergeDefaults({
@@ -174,6 +175,7 @@ var RsTable_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 		const emit = __emit;
 		const slots = useSlots();
 		const { t } = useRsI18n();
+		const resolvedNullLabel = computed(() => props.nullLabel ?? t("table.nullValue"));
 		const sharedTipRef = ref(null);
 		const { state: cellTipState, onPointerOver: onCellTipOver, onPointerOut: onCellTipOut, hide: hideCellTooltip } = useTableCellTooltip({
 			enabled: () => props.cellTooltip,
@@ -462,7 +464,7 @@ var RsTable_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 				rowCommit: () => props.rowCommit,
 				allowNull: () => props.allowNull,
 				editFocusMode: () => props.editFocusMode,
-				nullLabel: () => props.nullLabel
+				nullLabel: () => resolvedNullLabel.value
 			},
 			layout: {
 				useFixedColumnLayout,
@@ -587,7 +589,7 @@ var RsTable_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 				items: unref(ctxMenuItems),
 				onSelect: unref(onCtxMenuSelect)
 			}, {
-				default: withCtx(() => [createElementVNode("div", mergeProps({ class: ["rs-table-shell", {
+				default: withCtx(() => [createElementVNode("div", mergeProps({ class: ["rs-table-shell rs-motion-reduce", {
 					"rs-table-shell--ctx": contextMenuEnabled.value,
 					"rs-table-shell--fill": __props.fill
 				}] }, unref(shellBind), { onContextmenu: _cache[4] || (_cache[4] = (...args) => unref(onTableContextmenu) && unref(onTableContextmenu)(...args)) }), [createElementVNode("div", {

package/dist/components/table/src/composables/useRsTableContextMenu.d.ts

@@ -55,20 +55,36 @@ export declare function useRsTableContextMenu<T extends RsTableRowData>(options:
         key: string;
         label: string;
         icon?: string | undefined;
+        hint?: string | undefined;
         disabled?: boolean | undefined;
         danger?: boolean | undefined;
         separator?: boolean | undefined;
         children?: /*elided*/ any[] | undefined;
         shortcut?: string | undefined;
+        type?: import("../../../context-menu").RsContextMenuItemType | undefined;
+        checked?: boolean | undefined;
+        group?: string | undefined;
+        href?: string | undefined;
+        target?: string | undefined;
+        rel?: string | undefined;
+        closeOnSelect?: boolean | undefined;
     }[], RsContextMenuItem[] | {
         key: string;
         label: string;
         icon?: string | undefined;
+        hint?: string | undefined;
         disabled?: boolean | undefined;
         danger?: boolean | undefined;
         separator?: boolean | undefined;
         children?: /*elided*/ any[] | undefined;
         shortcut?: string | undefined;
+        type?: import("../../../context-menu").RsContextMenuItemType | undefined;
+        checked?: boolean | undefined;
+        group?: string | undefined;
+        href?: string | undefined;
+        target?: string | undefined;
+        rel?: string | undefined;
+        closeOnSelect?: boolean | undefined;
     }[]>;
     refreshCtxMenuItems: () => void;
     onCtxMenuSelect: (key: string) => Promise<void>;

package/dist/components/table/src/composables/useRsTableContextMenu.js

@@ -93,7 +93,7 @@ function useRsTableContextMenu(options) {
 		}
 	}
 	/**
-	* 捕获阶段预填：须早于 ContextMenuTrigger 冒泡打开。
+	* 捕获阶段预填：须早于右键菜单在冒泡阶段打开。
 	*/
 	function onContextmenuCapture(event) {
 		if (!read(options.enabled)) return;

package/dist/components/table/src/composables/useRsTableEngine.js

@@ -1,3 +1,4 @@
+import { useRsI18n } from "../../../../composables/useRsI18n.js";
 import { buildTableEntries, buildTableTreeEntries, buildTableTreeNodeIndex, collectTableTreeExpandableKeys, injectExpandRows, isTableRowDisabled, resolveRowKey, resolveSelectAllState, resolveTableTreeIndent } from "../utils/table-utils.js";
 import { computed, ref, watch } from "vue";
 //#region src/components/table/src/composables/useRsTableEngine.ts
@@ -22,6 +23,7 @@ function read(source) {
 *          行勾选/展开的「交互处理函数」仍留在 RsTable（依赖 DOM 与其它 UI 状态）。
 */
 function useRsTableEngine(options) {
+	const { locale } = useRsI18n();
 	const internalSort = ref(options.defaultSort ?? null);
 	const internalSorts = ref([...options.defaultSorts]);
 	const internalSelectedRowKeys = ref([...options.defaultSelectedRowKeys]);
@@ -133,7 +135,8 @@ function useRsTableEngine(options) {
 			filterText: read(options.filterText),
 			filterKeys: read(options.filterKeys),
 			columnFilters: read(options.columnFilters),
-			remoteSort: read(options.remoteSort)
+			remoteSort: read(options.remoteSort),
+			locale: locale.value
 		});
 		return injectExpandRows(buildTableEntries(data, columns, {
 			sort: sortState.value,
@@ -144,7 +147,8 @@ function useRsTableEngine(options) {
 			columnFilters: read(options.columnFilters),
 			groupBy: read(options.groupBy),
 			groupLabel: read(options.groupLabel),
-			remoteSort: read(options.remoteSort)
+			remoteSort: read(options.remoteSort),
+			locale: locale.value
 		}), expandedKeySet.value, rowKey, read(options.rowExpandable));
 	});
 	/**

package/dist/components/table/src/composables/useRsTableScrollLayout.js

@@ -153,6 +153,8 @@ function useRsTableScrollLayout(options) {
 		viewportResizeObserver.observe(el);
 	}
 	function disposeScrollLayout() {
+		restoreGeneration += 1;
+		restoringScroll = false;
 		viewportResizeObserver?.disconnect();
 		viewportResizeObserver = null;
 		if (scrollRafId) {

package/dist/components/table/src/composables/useRsTableShell.d.ts

@@ -130,20 +130,36 @@ export declare function useRsTableShell<T extends RsTableRowData>(options: UseRs
         key: string;
         label: string;
         icon?: string | undefined;
+        hint?: string | undefined;
         disabled?: boolean | undefined;
         danger?: boolean | undefined;
         separator?: boolean | undefined;
         children?: /*elided*/ any[] | undefined;
         shortcut?: string | undefined;
+        type?: import("../../../context-menu").RsContextMenuItemType | undefined;
+        checked?: boolean | undefined;
+        group?: string | undefined;
+        href?: string | undefined;
+        target?: string | undefined;
+        rel?: string | undefined;
+        closeOnSelect?: boolean | undefined;
     }[], RsContextMenuItem[] | {
         key: string;
         label: string;
         icon?: string | undefined;
+        hint?: string | undefined;
         disabled?: boolean | undefined;
         danger?: boolean | undefined;
         separator?: boolean | undefined;
         children?: /*elided*/ any[] | undefined;
         shortcut?: string | undefined;
+        type?: import("../../../context-menu").RsContextMenuItemType | undefined;
+        checked?: boolean | undefined;
+        group?: string | undefined;
+        href?: string | undefined;
+        target?: string | undefined;
+        rel?: string | undefined;
+        closeOnSelect?: boolean | undefined;
     }[]>;
     refreshCtxMenuItems: () => void;
     onCtxMenuSelect: (key: string) => Promise<void>;

package/dist/components/table/src/rs-table-props.d.ts

@@ -113,6 +113,7 @@ export interface RsTableProps<T extends RsTableRowData = RsTableRowData> {
     rowPending?: (row: T, index: number) => boolean;
     showRowStatus?: boolean;
     allowNull?: boolean;
+    /** 空值展示。未传时用 table.nullValue */
     nullLabel?: string;
     editFocusMode?: RsTableCellEditFocusMode;
     editKeyboard?: boolean;
@@ -309,7 +310,6 @@ export declare const RS_TABLE_PROP_DEFAULTS: {
     rowCommit: boolean;
     showRowStatus: boolean;
     allowNull: boolean;
-    nullLabel: string;
     editFocusMode: "end";
     editKeyboard: boolean;
     editUndo: boolean;

package/dist/components/table/src/rs-table-props.js

@@ -50,7 +50,6 @@ var RS_TABLE_PROP_DEFAULTS = {
 	rowCommit: false,
 	showRowStatus: true,
 	allowNull: true,
-	nullLabel: "(NULL)",
 	editFocusMode: "end",
 	editKeyboard: true,
 	editUndo: true,

package/dist/components/table/src/table-body/RsTableBody.impl.js

@@ -30,6 +30,7 @@ var _hoisted_12 = ["colspan"];
 var _hoisted_13 = { key: 2 };
 var _hoisted_14 = ["colspan"];
 var RsTableBody_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsTableBody",
 	__name: "RsTableBody",
 	setup(__props) {
 		/**