niuma-ui 2.0.3 → 2.0.9

package/dist/components/switch/src/RsSwitch.impl.js

@@ -1,9 +1,22 @@
-import { SwitchRoot, SwitchThumb } from "../../_shared/src/reka.js";
+import { useRsFormContext } from "../../form/src/form-utils.js";
 import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
-import { computed, createCommentVNode, createElementBlock, createVNode, defineComponent, mergeModels, normalizeClass, openBlock, renderSlot, unref, useId, useModel, withCtx } from "vue";
+import { resolveRsSwitchChecked, resolveRsSwitchNext } from "./switch-utils.js";
+import { computed, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeModels, normalizeClass, openBlock, renderSlot, useId, useModel, useTemplateRef, withModifiers } from "vue";
 //#region src/components/switch/src/RsSwitch.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = ["for"];
+var _hoisted_1 = [
+	"id",
+	"name",
+	"checked",
+	"disabled",
+	"aria-checked",
+	"aria-label"
+];
+var _hoisted_2 = {
+	key: 0,
+	class: "rs-switch__label"
+};
 var RsSwitch_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsSwitch",
 	__name: "RsSwitch",
 	props: /*@__PURE__*/ mergeModels({
 		disabled: {
@@ -13,6 +26,7 @@ var RsSwitch_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 		size: {},
 		ariaLabel: {},
 		id: {},
+		name: {},
 		checkedValue: {
 			type: [
 				Boolean,
@@ -41,50 +55,68 @@ var RsSwitch_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineC
 		"modelModifiers": {}
 	}),
 	emits: /*@__PURE__*/ mergeModels(["change"], ["update:modelValue"]),
-	setup(__props, { emit: __emit }) {
+	setup(__props, { expose: __expose, emit: __emit }) {
 		const model = useModel(__props, "modelValue");
 		const props = __props;
 		const emit = __emit;
+		const formContext = useRsFormContext();
 		const autoId = useId();
 		const inputId = computed(() => props.id || autoId);
+		const inputRef = useTemplateRef("inputRef");
 		const resolvedSize = useResolvedRsComponentSize(() => props.size);
-		/** Reka Switch 只吃 boolean；对外 v-model 按 checkedValue / uncheckedValue 映射 */
-		const isChecked = computed(() => Object.is(model.value, props.checkedValue));
+		const resolvedDisabled = computed(() => props.disabled || Boolean(formContext?.disabled.value));
+		const isChecked = computed(() => resolveRsSwitchChecked(model.value, props.checkedValue));
 		const rootClass = computed(() => [
 			"rs-switch",
 			`rs-switch--${resolvedSize.value}`,
 			{
 				"rs-switch--checked": isChecked.value,
-				"rs-switch--disabled": props.disabled
+				"rs-switch--disabled": resolvedDisabled.value
 			}
 		]);
-		function onUpdate(checked) {
-			const next = checked ? props.checkedValue : props.uncheckedValue;
+		function writeChecked(checked) {
+			const next = resolveRsSwitchNext(checked, props.checkedValue, props.uncheckedValue);
 			if (Object.is(model.value, next)) return;
 			model.value = next;
 			emit("change", next);
 		}
+		function onNativeChange(event) {
+			if (resolvedDisabled.value) return;
+			writeChecked(event.target.checked);
+		}
+		function onTrackClick(event) {
+			event.preventDefault();
+			event.stopPropagation();
+			if (resolvedDisabled.value) return;
+			writeChecked(!isChecked.value);
+		}
+		__expose({ focus: () => {
+			inputRef.value?.focus();
+		} });
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("div", { class: normalizeClass(rootClass.value) }, [createVNode(unref(SwitchRoot), {
-				id: inputId.value,
-				class: "rs-switch__root",
-				"model-value": isChecked.value,
-				disabled: __props.disabled,
-				"aria-label": __props.ariaLabel,
-				"onUpdate:modelValue": onUpdate
-			}, {
-				default: withCtx(() => [createVNode(unref(SwitchThumb), { class: "rs-switch__thumb" })]),
-				_: 1
-			}, 8, [
-				"id",
-				"model-value",
-				"disabled",
-				"aria-label"
-			]), _ctx.$slots.default ? (openBlock(), createElementBlock("label", {
-				key: 0,
-				class: "rs-switch__label",
-				for: inputId.value
-			}, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_1)) : createCommentVNode("", true)], 2);
+			return openBlock(), createElementBlock("label", { class: normalizeClass(rootClass.value) }, [
+				createElementVNode("input", {
+					id: inputId.value,
+					ref_key: "inputRef",
+					ref: inputRef,
+					class: "rs-switch__input",
+					type: "checkbox",
+					role: "switch",
+					name: __props.name,
+					checked: isChecked.value,
+					disabled: resolvedDisabled.value,
+					"aria-checked": isChecked.value ? "true" : "false",
+					"aria-label": __props.ariaLabel,
+					onChange: onNativeChange,
+					onClick: _cache[0] || (_cache[0] = withModifiers(() => {}, ["stop"]))
+				}, null, 40, _hoisted_1),
+				createElementVNode("span", {
+					class: "rs-switch__root",
+					"aria-hidden": "true",
+					onClick: onTrackClick
+				}, [..._cache[1] || (_cache[1] = [createElementVNode("span", { class: "rs-switch__thumb" }, null, -1)])]),
+				_ctx.$slots.default ? (openBlock(), createElementBlock("span", _hoisted_2, [renderSlot(_ctx.$slots, "default", {}, void 0, true)])) : createCommentVNode("", true)
+			], 2);
 		};
 	}
 });

package/dist/components/switch/src/RsSwitch.js

@@ -1,7 +1,8 @@
 import './RsSwitch.css'
+import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.js";
 import RsSwitch_vue_vue_type_script_setup_true_lang_default from "./RsSwitch.impl.js";
 
 //#region src/components/switch/src/RsSwitch.vue
-var RsSwitch_default = RsSwitch_vue_vue_type_script_setup_true_lang_default;
+var RsSwitch_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsSwitch_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-ba0ee1d6"]]);
 //#endregion
 export { RsSwitch_default as default };

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

@@ -0,0 +1,4 @@
+/** Switch v-model 取值：默认 boolean，也可为业务码如 'Y'/'N'、1/0 */
+export type RsSwitchValue = boolean | string | number;
+export declare function resolveRsSwitchChecked(value: RsSwitchValue, checkedValue: RsSwitchValue): boolean;
+export declare function resolveRsSwitchNext(checked: boolean, checkedValue: RsSwitchValue, uncheckedValue: RsSwitchValue): RsSwitchValue;

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

@@ -0,0 +1,9 @@
+//#region src/components/switch/src/switch-utils.ts
+function resolveRsSwitchChecked(value, checkedValue) {
+	return Object.is(value, checkedValue);
+}
+function resolveRsSwitchNext(checked, checkedValue, uncheckedValue) {
+	return checked ? checkedValue : uncheckedValue;
+}
+//#endregion
+export { resolveRsSwitchChecked, resolveRsSwitchNext };

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) {
 		/**

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

@@ -5,7 +5,7 @@ import { unwrapSelectEntry } from "../../../select/src/select-utils.js";
 import RsSelect_default from "../../../select/src/RsSelect.js";
 import RsDatePicker_default from "../../../date-picker/src/RsDatePicker.js";
 import { applyFocusMode, isNullDraft, nullToEditText, resolveCellEditorInputType, usesOverlayEditor } from "../utils/table-edit-utils.js";
-import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeModels, nextTick, normalizeClass, onMounted, openBlock, ref, toDisplayString, unref, useId, useModel, vModelText, watch, withDirectives, withModifiers } from "vue";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeModels, nextTick, normalizeClass, onBeforeUnmount, onMounted, openBlock, ref, toDisplayString, unref, useId, useModel, vModelText, watch, withDirectives, withModifiers } from "vue";
 //#region src/components/table/src/table-body/RsTableCellEditor.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = [
 	"title",
@@ -30,6 +30,7 @@ var _hoisted_5 = [
 	"disabled"
 ];
 var RsTableCellEditor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsTableCellEditor",
 	__name: "RsTableCellEditor",
 	props: /*@__PURE__*/ mergeModels({
 		valueType: { default: "text" },
@@ -64,6 +65,7 @@ var RsTableCellEditor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*
 	], ["update:modelValue"]),
 	setup(__props, { emit: __emit }) {
 		const { t } = useRsI18n();
+		let blurCommitTimer = 0;
 		const props = __props;
 		const model = useModel(__props, "modelValue");
 		const emit = __emit;
@@ -161,13 +163,19 @@ var RsTableCellEditor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*
 		}
 		function onBlur() {
 			if (isDate.value && dateOverlayOpen.value) {
-				window.setTimeout(() => {
+				window.clearTimeout(blurCommitTimer);
+				blurCommitTimer = window.setTimeout(() => {
+					blurCommitTimer = 0;
 					if (shouldCommitOnBlur()) emit("commit");
 				}, 0);
 				return;
 			}
 			if (shouldCommitOnBlur()) emit("commit");
 		}
+		onBeforeUnmount(() => {
+			window.clearTimeout(blurCommitTimer);
+			blurCommitTimer = 0;
+		});
 		function onKeydown(event) {
 			if (event.isComposing || composing.value) {
 				if (event.key === "Process") return;

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

@@ -4,6 +4,7 @@ import { Fragment, createCommentVNode, createElementBlock, defineComponent, norm
 var _hoisted_1 = { key: 0 };
 var _hoisted_2 = ["data-col-key"];
 var RsTableColGroup_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsTableColGroup",
 	__name: "RsTableColGroup",
 	setup(__props) {
 		const view = useRsTableView();

package/dist/components/table/src/table-footer/RsTableSummaryRow.impl.js

@@ -4,6 +4,7 @@ var _hoisted_1 = { class: "rs-table__summary-row" };
 var _hoisted_2 = ["colspan"];
 var _hoisted_3 = ["data-col-key"];
 var RsTableSummaryRow_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsTableSummaryRow",
 	__name: "RsTableSummaryRow",
 	props: {
 		columns: {},

package/dist/components/table/src/table-header/RsTableHeader.impl.js

@@ -36,6 +36,7 @@ var _hoisted_10 = {
 };
 var _hoisted_11 = ["onMousedown"];
 var RsTableHeader_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsTableHeader",
 	__name: "RsTableHeader",
 	setup(__props) {
 		const view = useRsTableView();

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

@@ -233,16 +233,16 @@ export type RsTableCellTooltipMode = 'overflow' | 'always';
 export declare function columnUsesSharedTooltip<T extends RsTableRowData>(column: RsTableColumn<T>): boolean;
 export declare function resolveCellTooltipMode<T extends RsTableRowData>(column: RsTableColumn<T>): RsTableCellTooltipMode | null;
 export declare function resolveCellTooltipText<T extends RsTableRowData>(column: RsTableColumn<T>, row: T, index: number): string;
-export declare function compareTableValues(a: unknown, b: unknown): number;
+export declare function compareTableValues(a: unknown, b: unknown, locale?: string): number;
 export declare function toggleSortState(current: RsTableSortState | null, key: string): RsTableSortState | null;
 export declare function toggleMultiSortState(sorts: readonly RsTableSortState[], key: string, maxSort?: number): RsTableSortState[];
 export declare function getSortOrderForKey(sorts: readonly RsTableSortState[], key: string): RsTableSortOrder;
 export declare function getSortPriorityForKey(sorts: readonly RsTableSortState[], key: string): number;
-export declare function compareTableRowsBySort<T extends RsTableRowData>(left: T, right: T, column: RsTableColumn<T>, order: Exclude<RsTableSortOrder, null>): number;
-export declare function sortTableRows<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], sort: RsTableSortState | null): T[];
-export declare function sortTableRowsMulti<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], sorts: readonly RsTableSortState[]): T[];
-export declare function filterTableRows<T extends RsTableRowData>(rows: readonly T[], query: string, columns: readonly RsTableColumn<T>[], keys?: string[]): T[];
-export declare function filterTableRowsByColumnFilters<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], filters: Record<string, string>): T[];
+export declare function compareTableRowsBySort<T extends RsTableRowData>(left: T, right: T, column: RsTableColumn<T>, order: Exclude<RsTableSortOrder, null>, locale?: string): number;
+export declare function sortTableRows<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], sort: RsTableSortState | null, locale?: string): T[];
+export declare function sortTableRowsMulti<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], sorts: readonly RsTableSortState[], locale?: string): T[];
+export declare function filterTableRows<T extends RsTableRowData>(rows: readonly T[], query: string, columns: readonly RsTableColumn<T>[], keys?: string[], locale?: string): T[];
+export declare function filterTableRowsByColumnFilters<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], filters: Record<string, string>, locale?: string): T[];
 export declare function isColumnFilterActive(filters: Record<string, string>, key: string): boolean;
 export declare function resolveGroupKey<T extends RsTableRowData>(row: T, groupBy: RsTableGroupBy<T>): string;
 export declare function groupTableRows<T extends RsTableRowData>(rows: readonly T[], groupBy: RsTableGroupBy<T>, labelFormatter?: (key: string) => string): RsTableRowEntry<T>[];
@@ -261,6 +261,7 @@ export declare function buildTableEntries<T extends RsTableRowData>(rows: readon
     groupBy?: RsTableGroupBy<T>;
     groupLabel?: (key: string) => string;
     remoteSort?: boolean;
+    locale?: string;
 }): RsTableRowEntry<T>[];
 export declare function injectExpandRows<T extends RsTableRowData>(entries: readonly RsTableRowEntry<T>[], expandedKeys: ReadonlySet<string>, rowKey?: RsTableRowKey<T>, rowExpandable?: (row: T, index: number) => boolean): RsTableRowEntry<T>[];
 export declare function toggleExpandedRowKeys(keys: readonly string[], key: string): string[];
@@ -309,6 +310,7 @@ export declare function filterTableTreeRows<T extends RsTableRowData>(rows: read
     childrenField?: string;
     filterKeys?: string[];
     columnFilters?: Record<string, string>;
+    locale?: string;
 }): T[];
 /** 树排序：仅对同级节点排序，递归处理子树 */
 export declare function sortTableTreeRows<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], options: {
@@ -316,6 +318,7 @@ export declare function sortTableTreeRows<T extends RsTableRowData>(rows: readon
     sort?: RsTableSortState | null;
     sorts?: readonly RsTableSortState[];
     multiSort?: boolean;
+    locale?: string;
 }): T[];
 /**
  * 按展开 key 展平可见树行为表格 row entries（不含 detail expand 行）。
@@ -342,6 +345,7 @@ export declare function buildTableTreeEntries<T extends RsTableRowData>(rows: re
     filterKeys?: string[];
     columnFilters?: Record<string, string>;
     remoteSort?: boolean;
+    locale?: string;
 }): RsTableRowEntry<T>[];
 /** 按表格 size 解析树缩进默认值 */
 export declare function resolveTableTreeIndent(size?: RsTableSize, custom?: number): number;

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

@@ -53,12 +53,12 @@ function resolveCellTooltipText(column, row, index) {
 	}
 	return String(value);
 }
-function compareTableValues(a, b) {
+function compareTableValues(a, b, locale) {
 	if (a === b) return 0;
 	if (a === void 0 || a === null) return -1;
 	if (b === void 0 || b === null) return 1;
 	if (typeof a === "number" && typeof b === "number") return a - b;
-	return formatComparableValue(a).localeCompare(formatComparableValue(b));
+	return formatComparableValue(a).localeCompare(formatComparableValue(b), locale);
 }
 function toggleSortState(current, key) {
 	if (current?.key !== key) return {
@@ -95,40 +95,40 @@ function getSortPriorityForKey(sorts, key) {
 	const index = sorts.findIndex((item) => item.key === key);
 	return index >= 0 ? index + 1 : 0;
 }
-function compareTableRowsBySort(left, right, column, order) {
+function compareTableRowsBySort(left, right, column, order, locale) {
 	const direction = order === "asc" ? 1 : -1;
 	if (column.sorter) return column.sorter(left, right) * direction;
-	return compareTableValues(getCellValue(left, column), getCellValue(right, column)) * direction;
+	return compareTableValues(getCellValue(left, column), getCellValue(right, column), locale) * direction;
 }
-function sortTableRows(rows, columns, sort) {
+function sortTableRows(rows, columns, sort, locale) {
 	if (!sort) return rows;
 	const column = columns.find((item) => item.key === sort.key);
 	if (!column) return rows;
-	return [...rows].sort((left, right) => compareTableRowsBySort(left, right, column, sort.order));
+	return [...rows].sort((left, right) => compareTableRowsBySort(left, right, column, sort.order, locale));
 }
-function sortTableRowsMulti(rows, columns, sorts) {
+function sortTableRowsMulti(rows, columns, sorts, locale) {
 	if (sorts.length === 0) return rows;
 	return [...rows].sort((left, right) => {
 		for (const sort of sorts) {
 			const column = columns.find((item) => item.key === sort.key);
 			if (!column) continue;
-			const compare = compareTableRowsBySort(left, right, column, sort.order);
+			const compare = compareTableRowsBySort(left, right, column, sort.order, locale);
 			if (compare !== 0) return compare;
 		}
 		return 0;
 	});
 }
-function filterTableRows(rows, query, columns, keys) {
+function filterTableRows(rows, query, columns, keys, locale) {
 	const trimmed = query.trim();
 	if (!trimmed) return rows;
 	const searchKeys = keys ?? columns.map((column) => column.key);
-	const lower = trimmed.toLowerCase();
+	const lower = trimmed.toLocaleLowerCase(locale);
 	return rows.filter((row) => searchKeys.some((key) => {
 		const column = columns.find((item) => item.key === key);
-		return formatComparableValue(column ? getCellValue(row, column) : row[key]).toLowerCase().includes(lower);
+		return formatComparableValue(column ? getCellValue(row, column) : row[key]).toLocaleLowerCase(locale).includes(lower);
 	}));
 }
-function filterTableRowsByColumnFilters(rows, columns, filters) {
+function filterTableRowsByColumnFilters(rows, columns, filters, locale) {
 	const active = Object.entries(filters).map(([key, query]) => [key, query.trim()]).filter(([, query]) => query.length > 0);
 	if (!active.length) return rows;
 	const columnMap = new Map(columns.map((column) => [column.key, column]));
@@ -137,8 +137,8 @@ function filterTableRowsByColumnFilters(rows, columns, filters) {
 		if (!column) return true;
 		const value = getCellValue(row, column);
 		if (column.filter) return column.filter(value, row, query);
-		const lower = query.toLowerCase();
-		return formatComparableValue(value).toLowerCase().includes(lower);
+		const lower = query.toLocaleLowerCase(locale);
+		return formatComparableValue(value).toLocaleLowerCase(locale).includes(lower);
 	}));
 }
 function isColumnFilterActive(filters, key) {
@@ -202,16 +202,16 @@ function reorderTableRows(rows, dragIndex, dropIndex, position) {
 function buildTableEntries(rows, columns, options = {}) {
 	let processed = rows;
 	const filterText = options.filterText ?? "";
-	if (filterText.trim()) processed = filterTableRows(processed, filterText, columns, options.filterKeys);
+	if (filterText.trim()) processed = filterTableRows(processed, filterText, columns, options.filterKeys, options.locale);
 	const columnFilters = options.columnFilters ?? {};
-	if (Object.values(columnFilters).some((q) => q.trim())) processed = filterTableRowsByColumnFilters(processed, columns, columnFilters);
+	if (Object.values(columnFilters).some((q) => q.trim())) processed = filterTableRowsByColumnFilters(processed, columns, columnFilters, options.locale);
 	if (!options.remoteSort) {
-		if (options.multiSort && options.sorts?.length) processed = sortTableRowsMulti(processed, columns, options.sorts);
-		else if (options.sort) processed = sortTableRows(processed, columns, options.sort);
+		if (options.multiSort && options.sorts?.length) processed = sortTableRowsMulti(processed, columns, options.sorts, options.locale);
+		else if (options.sort) processed = sortTableRows(processed, columns, options.sort, options.locale);
 	}
 	if (options.groupBy) {
 		const groupBy = options.groupBy;
-		processed = [...processed].sort((left, right) => compareTableValues(resolveGroupKey(left, groupBy), resolveGroupKey(right, groupBy)));
+		processed = [...processed].sort((left, right) => compareTableValues(resolveGroupKey(left, groupBy), resolveGroupKey(right, groupBy), options.locale));
 		return groupTableRows(processed, groupBy, options.groupLabel);
 	}
 	return processed.map((row, rowIndex) => ({
@@ -363,8 +363,8 @@ function filterTableTreeRows(rows, query, columns, options = {}) {
 	if (!trimmed && !hasColumnFilters) return rows;
 	const matchesSelf = (row) => {
 		let ok = true;
-		if (trimmed) ok = filterTableRows([row], trimmed, columns, options.filterKeys).length > 0;
-		if (ok && hasColumnFilters) ok = filterTableRowsByColumnFilters([row], columns, columnFilters).length > 0;
+		if (trimmed) ok = filterTableRows([row], trimmed, columns, options.filterKeys, options.locale).length > 0;
+		if (ok && hasColumnFilters) ok = filterTableRowsByColumnFilters([row], columns, columnFilters, options.locale).length > 0;
 		return ok;
 	};
 	const walk = (items) => {
@@ -385,8 +385,8 @@ function filterTableTreeRows(rows, query, columns, options = {}) {
 function sortTableTreeRows(rows, columns, options) {
 	const childrenField = options.childrenField ?? "children";
 	let sorted;
-	if (options.multiSort && options.sorts?.length) sorted = sortTableRowsMulti(rows, columns, options.sorts);
-	else if (options.sort) sorted = sortTableRows(rows, columns, options.sort);
+	if (options.multiSort && options.sorts?.length) sorted = sortTableRowsMulti(rows, columns, options.sorts, options.locale);
+	else if (options.sort) sorted = sortTableRows(rows, columns, options.sort, options.locale);
 	else sorted = rows;
 	return sorted.map((row) => {
 		const children = getTableTreeChildren(row, childrenField);
@@ -435,13 +435,15 @@ function buildTableTreeEntries(rows, columns, expandedKeys, options) {
 	if (filterText.trim() || Object.values(columnFilters).some((q) => q.trim())) processed = filterTableTreeRows(processed, filterText, columns, {
 		childrenField,
 		filterKeys: options.filterKeys,
-		columnFilters
+		columnFilters,
+		locale: options.locale
 	});
 	if (!options.remoteSort && (options.sort || options.multiSort && options.sorts?.length)) processed = sortTableTreeRows(processed, columns, {
 		childrenField,
 		sort: options.sort,
 		sorts: options.sorts,
-		multiSort: options.multiSort
+		multiSort: options.multiSort,
+		locale: options.locale
 	});
 	return flattenVisibleTableTreeEntries(processed, expandedKeys, {
 		childrenField,