niuma-ui 1.2.6 → 1.2.8

package/dist/components/RsTreeSelect.js

@@ -0,0 +1,8 @@
+import './RsTreeSelect.css'
+import _plugin_vue_export_helper_default from "../_virtual/_plugin-vue_export-helper.js";
+import RsTreeSelect_vue_vue_type_script_setup_true_lang_default from "./RsTreeSelect.impl.js";
+
+//#region src/components/RsTreeSelect.vue
+var RsTreeSelect_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsTreeSelect_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-a057dd37"]]);
+//#endregion
+export { RsTreeSelect_default as default };

package/dist/components/cascader-utils.d.ts

@@ -0,0 +1,16 @@
+import type { RsSelectValue } from './select-utils';
+/** 级联选项，对齐 Ant Cascader options */
+export interface RsCascaderOption {
+    label: string;
+    value: RsSelectValue;
+    disabled?: boolean;
+    children?: RsCascaderOption[];
+    isLeaf?: boolean;
+}
+export type RsCascaderPath = RsSelectValue[];
+export type RsCascaderExpandTrigger = 'click' | 'hover';
+export declare function findCascaderOption(options: readonly RsCascaderOption[], value: RsSelectValue): RsCascaderOption | undefined;
+export declare function cascaderColumns(options: readonly RsCascaderOption[], path: RsCascaderPath): RsCascaderOption[][];
+export declare function cascaderLabels(options: readonly RsCascaderOption[], path: RsCascaderPath): string[];
+export declare function cascaderDisplay(options: readonly RsCascaderOption[], path: RsCascaderPath, separator?: string): string;
+export declare function isCascaderLeaf(option: RsCascaderOption): boolean;

package/dist/components/cascader-utils.js

@@ -0,0 +1,39 @@
+//#region src/components/cascader-utils.ts
+function findCascaderOption(options, value) {
+	return options.find((item) => String(item.value) === String(value));
+}
+function cascaderColumns(options, path) {
+	const columns = [options.slice()];
+	let level = options;
+	for (const token of path) {
+		const children = findCascaderOption(level, token)?.children;
+		if (!children?.length) break;
+		columns.push(children);
+		level = children;
+	}
+	return columns;
+}
+function cascaderLabels(options, path) {
+	const labels = [];
+	let level = options;
+	for (const token of path) {
+		const current = findCascaderOption(level, token);
+		if (!current) {
+			labels.push(String(token));
+			break;
+		}
+		labels.push(current.label);
+		level = current.children ?? [];
+	}
+	return labels;
+}
+function cascaderDisplay(options, path, separator = " / ") {
+	return cascaderLabels(options, path).join(separator);
+}
+function isCascaderLeaf(option) {
+	if (option.isLeaf === true) return true;
+	if (option.isLeaf === false) return false;
+	return !option.children?.length;
+}
+//#endregion
+export { cascaderColumns, cascaderDisplay, cascaderLabels, findCascaderOption, isCascaderLeaf };

package/dist/components/mentions-utils.d.ts

@@ -0,0 +1,46 @@
+export interface RsMentionOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+export interface RsMentionActive {
+    prefix: string;
+    query: string;
+    start: number;
+    end: number;
+}
+export declare function resolveMentionPrefixes(prefix: string | readonly string[]): string[];
+/** 光标前最近一个前缀 + 查询词（不含空格） */
+export declare function findActiveMention(text: string, cursor: number, prefixes: readonly string[], split?: string): RsMentionActive | null;
+export declare function applyMention(text: string, active: RsMentionActive, value: string, split?: string): {
+    text: string;
+    cursor: number;
+};
+export interface RsMentionCaretBox {
+    top: number;
+    left: number;
+    height: number;
+}
+export interface RsMentionPopupBox {
+    top: number;
+    left: number;
+    placement: 'top' | 'bottom';
+}
+export declare function stepMentionIndex(options: readonly RsMentionOption[], current: number, delta: 1 | -1): number;
+/** 视口内避让：下边不够就翻到上方，左右夹进窗口。 */
+export declare function placeMentionPopup(caret: RsMentionCaretBox, popup: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}, gap?: number): RsMentionPopupBox;
+export interface RsTextareaCaretMeter {
+    measure: (textarea: HTMLTextAreaElement, index: number) => RsMentionCaretBox;
+    dispose: () => void;
+}
+/** 复用隐藏镜像节点，避免每次按键 insert/remove 逼 reflow。 */
+export declare function createTextareaCaretMeter(): RsTextareaCaretMeter;
+/** 相对 textarea 内容区的光标坐标（已扣滚动）。测试 / 单次调用用；热路径请复用 meter。 */
+export declare function measureTextareaCaret(textarea: HTMLTextAreaElement, index: number): RsMentionCaretBox;
+export declare function filterMentionOptions(options: readonly RsMentionOption[], query: string): RsMentionOption[];

package/dist/components/mentions-utils.js

@@ -0,0 +1,128 @@
+import { placeAnchoredPopup, stepEnabledIndex } from "./overlay-utils.js";
+//#region src/components/mentions-utils.ts
+function resolveMentionPrefixes(prefix) {
+	return (Array.isArray(prefix) ? prefix : [prefix]).map(String).filter(Boolean);
+}
+/** 光标前最近一个前缀 + 查询词（不含空格） */
+function findActiveMention(text, cursor, prefixes, split = " ") {
+	const head = text.slice(0, Math.max(0, cursor));
+	let found = null;
+	for (const token of prefixes) {
+		const at = head.lastIndexOf(token);
+		if (at < 0) continue;
+		const after = head.slice(at + token.length);
+		if (after.includes(split) || after.includes("\n")) continue;
+		if (!found || at > found.start) found = {
+			prefix: token,
+			query: after,
+			start: at,
+			end: cursor
+		};
+	}
+	return found;
+}
+function applyMention(text, active, value, split = " ") {
+	const insert = `${active.prefix}${value}${split}`;
+	return {
+		text: `${text.slice(0, active.start)}${insert}${text.slice(active.end)}`,
+		cursor: active.start + insert.length
+	};
+}
+function stepMentionIndex(options, current, delta) {
+	return stepEnabledIndex(options, current, delta);
+}
+/** 视口内避让：下边不够就翻到上方，左右夹进窗口。 */
+function placeMentionPopup(caret, popup, viewport, gap = 4) {
+	const box = placeAnchoredPopup(caret, popup, viewport, gap);
+	return {
+		top: box.top,
+		left: box.left,
+		placement: box.placement
+	};
+}
+var MIRROR_STYLE_KEYS = [
+	"boxSizing",
+	"width",
+	"height",
+	"overflowX",
+	"overflowY",
+	"borderTopWidth",
+	"borderRightWidth",
+	"borderBottomWidth",
+	"borderLeftWidth",
+	"paddingTop",
+	"paddingRight",
+	"paddingBottom",
+	"paddingLeft",
+	"fontStyle",
+	"fontVariant",
+	"fontWeight",
+	"fontStretch",
+	"fontSize",
+	"fontFamily",
+	"letterSpacing",
+	"textIndent",
+	"textTransform",
+	"wordSpacing",
+	"tabSize",
+	"lineHeight",
+	"whiteSpace",
+	"wordWrap"
+];
+/** 复用隐藏镜像节点，避免每次按键 insert/remove 逼 reflow。 */
+function createTextareaCaretMeter() {
+	let mirror = null;
+	let marker = null;
+	function ensure() {
+		if (mirror && marker) return {
+			mirror,
+			marker
+		};
+		mirror = document.createElement("div");
+		mirror.setAttribute("aria-hidden", "true");
+		const s = mirror.style;
+		s.position = "absolute";
+		s.visibility = "hidden";
+		s.pointerEvents = "none";
+		s.whiteSpace = "pre-wrap";
+		s.wordWrap = "break-word";
+		s.top = "0";
+		s.left = "-9999px";
+		marker = document.createElement("span");
+		marker.textContent = ".";
+		document.body.appendChild(mirror);
+		return {
+			mirror,
+			marker
+		};
+	}
+	function measure(textarea, index) {
+		const { mirror: box, marker: caret } = ensure();
+		const style = window.getComputedStyle(textarea);
+		for (const key of MIRROR_STYLE_KEYS) box.style.setProperty(key.replace(/[A-Z]/g, (ch) => `-${ch.toLowerCase()}`), style[key]);
+		const text = textarea.value.slice(0, Math.max(0, index));
+		box.textContent = text.endsWith("\n") ? `${text}\u00a0` : text;
+		box.appendChild(caret);
+		return {
+			top: caret.offsetTop - textarea.scrollTop,
+			left: caret.offsetLeft - textarea.scrollLeft,
+			height: caret.offsetHeight || parseFloat(style.lineHeight) || 16
+		};
+	}
+	function dispose() {
+		mirror?.remove();
+		mirror = null;
+		marker = null;
+	}
+	return {
+		measure,
+		dispose
+	};
+}
+function filterMentionOptions(options, query) {
+	const q = query.trim().toLowerCase();
+	if (!q) return options.filter((item) => !item.disabled);
+	return options.filter((item) => !item.disabled && (item.label.toLowerCase().includes(q) || item.value.toLowerCase().includes(q)));
+}
+//#endregion
+export { applyMention, createTextareaCaretMeter, filterMentionOptions, findActiveMention, placeMentionPopup, resolveMentionPrefixes, stepMentionIndex };

package/dist/components/overlay-utils.d.ts

@@ -21,3 +21,34 @@ export declare const RS_TOAST_DEFAULT_POSITION: RsToastPosition;
 export declare const RS_TOAST_DEFAULT_GAP = 4;
 export declare const rsToastPositions: readonly ["top-center", "top-left", "top-right", "bottom-center", "bottom-left", "bottom-right"];
 export declare function rsFeedbackIconClass(tone: RsFeedbackTone): string;
+/** 视口内锚点矩形（输入框、插入符等）。 */
+export interface RsOverlayAnchorBox {
+    top: number;
+    left: number;
+    height: number;
+    width?: number;
+}
+export interface RsOverlayPopupSize {
+    width: number;
+    height: number;
+}
+export interface RsOverlayViewport {
+    width: number;
+    height: number;
+}
+/** 锚点浮层最终盒子。placement 供翻转后的样式钩子使用。 */
+export interface RsOverlayBox {
+    top: number;
+    left: number;
+    width: number;
+    placement: 'top' | 'bottom';
+}
+/**
+ * 把浮层贴到锚点：优先下方，视口不够则翻到上方，左右夹进窗口。
+ * 对齐 WAI-ARIA APG 浮层惯例与 CSS overflow 避让，不跟某一家组件库的 API。
+ */
+export declare function placeAnchoredPopup(anchor: RsOverlayAnchorBox, popup: RsOverlayPopupSize, viewport: RsOverlayViewport, gap?: number): RsOverlayBox;
+/** 在可选项里按方向跳过 disabled，供 combobox / listbox 方向键与 Home / End。 */
+export declare function stepEnabledIndex<T extends {
+    disabled?: boolean;
+}>(options: readonly T[], current: number, delta: 1 | -1): number;

package/dist/components/overlay-utils.js

@@ -13,5 +13,33 @@ var rsToastPositions = [
 function rsFeedbackIconClass(tone) {
 	return `rs-feedback-icon rs-feedback-icon--${tone}`;
 }
+/**
+* 把浮层贴到锚点：优先下方，视口不够则翻到上方，左右夹进窗口。
+* 对齐 WAI-ARIA APG 浮层惯例与 CSS overflow 避让，不跟某一家组件库的 API。
+*/
+function placeAnchoredPopup(anchor, popup, viewport, gap = 4) {
+	const below = anchor.top + anchor.height + gap;
+	const above = anchor.top - popup.height - gap;
+	const placement = below + popup.height <= viewport.height || above < gap ? "bottom" : "top";
+	const top = placement === "bottom" ? below : Math.max(gap, above);
+	const width = Math.min(popup.width, Math.max(0, viewport.width - gap * 2));
+	const maxLeft = Math.max(gap, viewport.width - width - gap);
+	return {
+		top,
+		left: Math.min(Math.max(gap, anchor.left), maxLeft),
+		width,
+		placement
+	};
+}
+/** 在可选项里按方向跳过 disabled，供 combobox / listbox 方向键与 Home / End。 */
+function stepEnabledIndex(options, current, delta) {
+	if (!options.length) return 0;
+	let index = current;
+	for (let n = 0; n < options.length; n += 1) {
+		index = (index + delta + options.length) % options.length;
+		if (!options[index]?.disabled) return index;
+	}
+	return Math.max(0, current);
+}
 //#endregion
-export { RS_TOAST_DEFAULT_GAP, RS_TOAST_DEFAULT_POSITION, rsFeedbackIconClass, rsToastPositions };
+export { RS_TOAST_DEFAULT_GAP, RS_TOAST_DEFAULT_POSITION, placeAnchoredPopup, rsFeedbackIconClass, rsToastPositions, stepEnabledIndex };

package/dist/components/select-utils.d.ts

@@ -3,6 +3,14 @@ export type RsSelectValue = string | number;
 export type RsSelectOptionFilterProp = string;
 export type RsSelectPlacement = 'top' | 'bottom' | 'left' | 'right';
 export type RsSelectStatus = 'error' | 'warning' | '';
+/** 对齐 Ant Design 5 Select variant；搜索仍在面板内，不改触发器打字。 */
+export type RsSelectVariant = 'outlined' | 'filled' | 'borderless';
+/** 多选折叠：数字为上限；responsive 按触发器宽度收。 */
+export type RsSelectMaxTagCount = number | 'responsive';
+export declare function splitSelectLabelHighlight(label: string, keyword: string): Array<{
+    text: string;
+    highlight: boolean;
+}>;
 /** 自定义过滤（对齐 Ant Design filterOption）。返回 false 则隐藏该项。 */
 export type RsSelectFilterOption = (query: string, option: RsSelectOption) => boolean;
 /** 过滤后排序（对齐 Ant Design filterSort） */
@@ -41,6 +49,7 @@ export type RsSelectModelValue = RsSelectValue | RsSelectValue[] | RsSelectLabel
  * 按泛型收窄后的 v-model。
  * 默认单选、值为 string：宿主 `@update:model-value="(v: string) => void"` 可直接赋值。
  * `multiple` / `labelInValue` 为字面量 true 时收成数组或 labeled；为 `boolean` 时保留联合。
+ * 组件本体的 defineModel 用 RsSelectModelValue（multiple / labelInValue 是运行时 boolean）。
  */
 export type RsSelectResolvedModel<Value extends RsSelectValue = string, Multiple extends boolean = false, LabelInValue extends boolean = false> = LabelInValue extends true ? Multiple extends true ? RsSelectLabeledValue[] : Multiple extends false ? RsSelectLabeledValue | '' : RsSelectLabeledValue | RsSelectLabeledValue[] | '' : Multiple extends true ? Value[] : Multiple extends false ? Value | '' : Value | Value[] | '';
 /**
@@ -48,6 +57,12 @@ export type RsSelectResolvedModel<Value extends RsSelectValue = string, Multiple
  * 选项若传入 value: ''，对内映射为此哨兵，避免崩溃；对外读写仍为 ''。
  */
 export declare const RS_SELECT_EMPTY_VALUE = "__rs_select_empty__";
+/**
+ * Vue 对泛型 boolean prop 不会按 Boolean 收口。
+ * 模板写 `multiple` 时运行时可能是 ''；个别版本还会落到 attrs 变成 'true' / 'multiple'。
+ * Boolean('') 为 false，会把多选打成单选。
+ */
+export declare function isSelectMultiple(value: unknown): boolean;
 /** 业务 value → ComboboxItem token（空串走哨兵；数字转为十进制字符串） */
 export declare function toComboboxValue(value: RsSelectValue): string;
 /** ComboboxItem token → 业务字符串（仅还原空串哨兵，不恢复 number） */

package/dist/components/select-utils.js

@@ -1,9 +1,45 @@
 //#region src/components/select-utils.ts
+function splitSelectLabelHighlight(label, keyword) {
+	const query = keyword.trim();
+	if (!query) return [{
+		text: label,
+		highlight: false
+	}];
+	const lowerLabel = label.toLowerCase();
+	const lowerQuery = query.toLowerCase();
+	const index = lowerLabel.indexOf(lowerQuery);
+	if (index < 0) return [{
+		text: label,
+		highlight: false
+	}];
+	const parts = [];
+	if (index > 0) parts.push({
+		text: label.slice(0, index),
+		highlight: false
+	});
+	parts.push({
+		text: label.slice(index, index + query.length),
+		highlight: true
+	});
+	if (index + query.length < label.length) parts.push({
+		text: label.slice(index + query.length),
+		highlight: false
+	});
+	return parts;
+}
 /**
 * Reka ComboboxItem 禁止 value 为空串（空串表示未选中 / placeholder）。
 * 选项若传入 value: ''，对内映射为此哨兵，避免崩溃；对外读写仍为 ''。
 */
 var RS_SELECT_EMPTY_VALUE = "__rs_select_empty__";
+/**
+* Vue 对泛型 boolean prop 不会按 Boolean 收口。
+* 模板写 `multiple` 时运行时可能是 ''；个别版本还会落到 attrs 变成 'true' / 'multiple'。
+* Boolean('') 为 false，会把多选打成单选。
+*/
+function isSelectMultiple(value) {
+	return value === true || value === "" || value === "true" || value === "multiple";
+}
 /** 业务 value → ComboboxItem token（空串走哨兵；数字转为十进制字符串） */
 function toComboboxValue(value) {
 	return value === "" ? RS_SELECT_EMPTY_VALUE : String(value);
@@ -208,4 +244,4 @@ function splitByTokenSeparators(raw, separators) {
 	return raw.split(found);
 }
 //#endregion
-export { RS_SELECT_EMPTY_VALUE, buildOptionDisabledMap, buildOptionLabelMap, comboboxBindingToTokens, filterSelectOptions, findSelectOption, flattenSelectOptions, flattenSelectValues, fromComboboxValue, isSelectLabeledValue, isSelectOptionGroup, normalizeSelectOptions, optionDisplayLabel, packSelectModel, restoreSelectValue, restoreSelectValues, selectModelEntries, sortSelectOptions, splitByTokenSeparators, toComboboxValue, toLabeledValue, toSelectedTokens, unwrapSelectEntry };
+export { RS_SELECT_EMPTY_VALUE, buildOptionDisabledMap, buildOptionLabelMap, comboboxBindingToTokens, filterSelectOptions, findSelectOption, flattenSelectOptions, flattenSelectValues, fromComboboxValue, isSelectLabeledValue, isSelectMultiple, isSelectOptionGroup, normalizeSelectOptions, optionDisplayLabel, packSelectModel, restoreSelectValue, restoreSelectValues, selectModelEntries, sortSelectOptions, splitByTokenSeparators, splitSelectLabelHighlight, toComboboxValue, toLabeledValue, toSelectedTokens, unwrapSelectEntry };

package/dist/components/table/RsTableCellEditor.impl.js

@@ -1,6 +1,7 @@
 import { useRsI18n } from "../../composables/useRsI18n.js";
 import RsInput_default from "../RsInput.js";
 import RsInputNumber_default from "../RsInputNumber.js";
+import { unwrapSelectEntry } from "../select-utils.js";
 import RsSelect_default from "../RsSelect.js";
 import RsDatePicker_default from "../RsDatePicker.js";
 import { applyFocusMode, isNullDraft, nullToEditText, resolveCellEditorInputType, usesOverlayEditor } from "./table-edit-utils.js";
@@ -194,8 +195,13 @@ var RsTableCellEditor_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*
 				emit("commit");
 			}
 		}
+		function selectDraftTokens(value) {
+			if (Array.isArray(value)) return value.map((item) => unwrapSelectEntry(item)).filter((item) => item !== null).map(String);
+			const raw = unwrapSelectEntry(value);
+			return raw == null ? "" : String(raw);
+		}
 		function onSelectUpdate(value) {
-			const tokens = Array.isArray(value) ? value.map(String) : String(value);
+			const tokens = selectDraftTokens(value);
 			if (tokens === "" || Array.isArray(tokens) && tokens.length === 0) {
 				if (!props.editorOptions?.clearable) return;
 				model.value = props.allowNull ? nullToEditText() : "";

package/dist/components/use-rs-select.d.ts

@@ -15,7 +15,9 @@ export interface RsSelectEngineProps {
     remote?: boolean;
     virtual?: boolean;
     virtualThreshold?: number;
-    maxTagCount?: number;
+    maxTagCount?: number | 'responsive';
+    /** 远程 @search 防抖毫秒；0 立即发 */
+    debounce?: number;
     maxTagPlaceholder?: string | ((omitted: number) => string);
     maxTagTooltip?: boolean;
     maxTagTextLength?: number;
@@ -40,12 +42,13 @@ export type RsSelectEngineEmit = {
  * Select 过滤、选中、多选 tag、creatable / 分隔符提交。
  * 组件模板只消费返回值；表单校验仍留在 SFC。
  */
-export declare function useRsSelect(props: RsSelectEngineProps, model: ModelRef<RsSelectModelValue>, open: ModelRef<boolean>, searchQuery: ModelRef<string>, emit: RsSelectEngineEmit, t: RsTranslateFn): {
+export declare function useRsSelect<T extends RsSelectModelValue = RsSelectModelValue>(props: RsSelectEngineProps, model: ModelRef<T>, open: ModelRef<boolean>, searchQuery: ModelRef<string>, emit: RsSelectEngineEmit, t: RsTranslateFn): {
     normalizedOptions: import("vue").ComputedRef<import("./select-utils").RsSelectOptions>;
     resolvedPlaceholder: import("vue").ComputedRef<string>;
     resolvedSearchPlaceholder: import("vue").ComputedRef<string>;
     resolvedEmptyText: import("vue").ComputedRef<string>;
     resolvedLoadingText: import("vue").ComputedRef<string>;
+    isMultiple: import("vue").ComputedRef<boolean>;
     isSearchable: import("vue").ComputedRef<boolean>;
     labelMap: import("vue").ComputedRef<Map<string, string>>;
     useVirtual: import("vue").ComputedRef<boolean>;

package/dist/components/use-rs-select.js

@@ -1,6 +1,6 @@
 import { useFilter } from "./reka.js";
-import { buildOptionDisabledMap, buildOptionLabelMap, comboboxBindingToTokens, filterSelectOptions, findSelectOption, flattenSelectOptions, flattenSelectValues, fromComboboxValue, isSelectLabeledValue, normalizeSelectOptions, optionDisplayLabel, packSelectModel, restoreSelectValue, restoreSelectValues, selectModelEntries, sortSelectOptions, splitByTokenSeparators, toComboboxValue, toSelectedTokens } from "./select-utils.js";
-import { computed, nextTick, watch } from "vue";
+import { buildOptionDisabledMap, buildOptionLabelMap, comboboxBindingToTokens, filterSelectOptions, findSelectOption, flattenSelectOptions, flattenSelectValues, fromComboboxValue, isSelectLabeledValue, isSelectMultiple, normalizeSelectOptions, optionDisplayLabel, packSelectModel, restoreSelectValue, restoreSelectValues, selectModelEntries, sortSelectOptions, splitByTokenSeparators, toComboboxValue, toSelectedTokens } from "./select-utils.js";
+import { computed, nextTick, onUnmounted, watch } from "vue";
 //#region src/components/use-rs-select.ts
 /**
 * Select 过滤、选中、多选 tag、creatable / 分隔符提交。
@@ -8,6 +8,7 @@ import { computed, nextTick, watch } from "vue";
 */
 function useRsSelect(props, model, open, searchQuery, emit, t) {
 	const { contains } = useFilter({ sensitivity: "base" });
+	const isMultiple = computed(() => isSelectMultiple(props.multiple));
 	const normalizedOptions = computed(() => normalizeSelectOptions(props.options, props.fieldNames));
 	const resolvedPlaceholder = computed(() => props.placeholder ?? t("select.placeholder"));
 	const resolvedSearchPlaceholder = computed(() => props.searchPlaceholder ?? t("select.searchPlaceholder"));
@@ -46,11 +47,12 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 		if (!canCreate.value) return values;
 		return [createValue.value, ...values.filter((item) => String(item) !== createValue.value)];
 	});
-	const selectedValues = computed(() => toSelectedTokens(model.value, Boolean(props.multiple)));
+	const selectedValues = computed(() => toSelectedTokens(model.value, isMultiple.value));
 	const hasValue = computed(() => selectedValues.value.length > 0);
 	const visibleTagTokens = computed(() => {
 		const all = selectedValues.value;
-		if (!props.multiple || props.maxTagCount == null || all.length <= props.maxTagCount) return all;
+		if (!isMultiple.value || props.maxTagCount == null || props.maxTagCount === "responsive") return all;
+		if (all.length <= props.maxTagCount) return all;
 		return all.slice(0, Math.max(0, props.maxTagCount));
 	});
 	const omittedTagCount = computed(() => Math.max(0, selectedValues.value.length - visibleTagTokens.value.length));
@@ -82,7 +84,7 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 		if (!max || max < 1 || label.length <= max) return label;
 		return `${label.slice(0, max)}…`;
 	}
-	const atMultipleLimit = computed(() => Boolean(props.multiple) && props.multipleLimit != null && props.multipleLimit > 0 && selectedValues.value.length >= props.multipleLimit);
+	const atMultipleLimit = computed(() => isMultiple.value && props.multipleLimit != null && props.multipleLimit > 0 && selectedValues.value.length >= props.multipleLimit);
 	function isOptionLimited(option) {
 		if (!atMultipleLimit.value) return false;
 		return !selectedValues.value.includes(toComboboxValue(option.value));
@@ -93,11 +95,11 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 		return option ? isOptionLimited(option) : false;
 	}
 	const singleDisplayLabel = computed(() => {
-		if (props.multiple || !hasValue.value) return "";
+		if (isMultiple.value || !hasValue.value) return "";
 		return tokenLabel(selectedValues.value[0]);
 	});
 	function writeTokens(tokens) {
-		model.value = packSelectModel(restoreSelectValues(tokens, normalizedOptions.value), normalizedOptions.value, Boolean(props.multiple), Boolean(props.labelInValue));
+		model.value = packSelectModel(restoreSelectValues(tokens, normalizedOptions.value), normalizedOptions.value, isMultiple.value, Boolean(props.labelInValue));
 	}
 	function emitSelectionDiff(prev, next) {
 		const prevSet = new Set(prev);
@@ -113,12 +115,12 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 	}
 	const comboboxModel = computed({
 		get() {
-			if (props.multiple) return selectedValues.value.map((token) => token);
+			if (isMultiple.value) return selectedValues.value;
 			return hasValue.value ? selectedValues.value[0] : void 0;
 		},
 		set(value) {
 			const prev = selectedValues.value;
-			const tokens = comboboxBindingToTokens(value, Boolean(props.multiple));
+			const tokens = comboboxBindingToTokens(value, isMultiple.value);
 			emitSelectionDiff(prev, tokens);
 			writeTokens(tokens);
 			if (props.autoClearSearchValue) searchQuery.value = "";
@@ -132,7 +134,7 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 		if (!next) return;
 		const values = currentValues();
 		if (values.some((item) => String(item) === next)) return;
-		if (props.multiple) {
+		if (isMultiple.value) {
 			if (atMultipleLimit.value) return;
 			const prev = selectedValues.value;
 			const packed = packSelectModel([...values, next], normalizedOptions.value, true, Boolean(props.labelInValue));
@@ -147,7 +149,7 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 		if (props.autoClearSearchValue) searchQuery.value = "";
 	}
 	function consumeTokenSeparators(raw) {
-		if (!props.multiple && !props.creatable) return;
+		if (!isMultiple.value && !props.creatable) return;
 		const parts = splitByTokenSeparators(raw, props.tokenSeparators ?? []);
 		if (!parts) return;
 		const rest = parts.pop() ?? "";
@@ -159,26 +161,35 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 				const prev = selectedValues.value;
 				const key = toComboboxValue(matched.value);
 				if (prev.includes(key)) continue;
-				if (props.multiple && atMultipleLimit.value) continue;
-				const nextTokens = props.multiple ? [...prev, key] : [key];
+				if (isMultiple.value && atMultipleLimit.value) continue;
+				const nextTokens = isMultiple.value ? [...prev, key] : [key];
 				emitSelectionDiff(prev, nextTokens);
 				writeTokens(nextTokens);
-				if (!props.multiple) open.value = false;
+				if (!isMultiple.value) open.value = false;
 			} else if (props.creatable) commitCreatedValue(token);
 		}
 		if (rest !== raw) searchQuery.value = rest;
 	}
+	let searchTimer;
 	watch(searchQuery, (query) => {
-		if (props.remote) emit("search", query);
+		if (props.remote) {
+			const wait = props.debounce ?? 0;
+			if (searchTimer) clearTimeout(searchTimer);
+			if (wait <= 0) emit("search", query);
+			else searchTimer = setTimeout(() => emit("search", query), wait);
+		}
 		if (props.tokenSeparators?.length) consumeTokenSeparators(query);
 	});
+	onUnmounted(() => {
+		if (searchTimer) clearTimeout(searchTimer);
+	});
 	watch(open, async (isOpen) => {
 		if (isOpen) {
 			const pending = searchQuery.value;
 			await nextTick();
 			await nextTick();
 			if (pending) searchQuery.value = pending;
-			else if (props.fillSearchWithValue && !props.multiple && hasValue.value) searchQuery.value = singleDisplayLabel.value;
+			else if (props.fillSearchWithValue && !isMultiple.value && hasValue.value) searchQuery.value = singleDisplayLabel.value;
 			else searchQuery.value = "";
 			return;
 		}
@@ -196,19 +207,19 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 		event.stopPropagation();
 		emitSelectionDiff(selectedValues.value, []);
 		emit("clear");
-		model.value = props.multiple ? [] : "";
+		model.value = isMultiple.value ? [] : "";
 	}
 	function removeTag(value, event) {
 		event.preventDefault();
 		event.stopPropagation();
-		if (!props.multiple) return;
+		if (!isMultiple.value) return;
 		const prev = selectedValues.value;
 		const tokens = prev.filter((item) => item !== value);
 		emitSelectionDiff(prev, tokens);
 		writeTokens(tokens);
 	}
 	function setValue(value) {
-		if (props.multiple) {
+		if (isMultiple.value) {
 			writeTokens(toSelectedTokens(Array.isArray(value) ? value : value !== "" && value != null ? [value] : [], true));
 			return;
 		}
@@ -229,6 +240,7 @@ function useRsSelect(props, model, open, searchQuery, emit, t) {
 		resolvedSearchPlaceholder,
 		resolvedEmptyText,
 		resolvedLoadingText,
+		isMultiple,
 		isSearchable,
 		labelMap,
 		useVirtual,

package/dist/composables/useRsTableShell.js

@@ -1,10 +1,10 @@
+import { resolveVirtualListHeight } from "../components/virtual-list-utils.js";
 import { resolveScrollWidth, selectRowKeys } from "../components/table-utils.js";
 import { RS_TABLE_PREFIX_COL_WIDTH, measureRsTablePrefixWidth, useRsTableColumnVirtual } from "./useRsTableColumnVirtual.js";
 import { useRsTableColumnLayout } from "./useRsTableColumnLayout.js";
 import { useRsTableColumnResize } from "./useRsTableColumnResize.js";
 import { useRsTableContextMenu } from "./useRsTableContextMenu.js";
 import { useRsTableInteraction } from "./useRsTableInteraction.js";
-import { resolveVirtualListHeight } from "../components/virtual-list-utils.js";
 import { computed } from "vue";
 //#region src/composables/useRsTableShell.ts
 /**

package/dist/index.d.ts

@@ -35,6 +35,10 @@ export { default as RsLabel } from './components/RsLabel.js';
 export { default as RsLink } from './components/RsLink.js';
 export { default as RsMenu } from './components/RsMenu.js';
 export { default as RsSelect } from './components/RsSelect.js';
+export { default as RsAutoComplete } from './components/RsAutoComplete.js';
+export { default as RsCascader } from './components/RsCascader.js';
+export { default as RsTreeSelect } from './components/RsTreeSelect.js';
+export { default as RsMentions } from './components/RsMentions.js';
 export { default as RsScrollbar } from './components/RsScrollbar.js';
 export { default as RsAvatar } from './components/RsAvatar.js';
 export { default as RsCard } from './components/RsCard.js';
@@ -100,10 +104,12 @@ export type { RsContextMenuItem } from './components/context-menu-utils';
 export type { RsDropdownItem, RsDropdownItemGroup, RsDropdownItems } from './components/dropdown-utils';
 export type { RsMenuItem, RsMenuItemGroup, RsMenuItems } from './components/menu-utils';
 export type { RsScrollbarOrientation, RsScrollbarType } from './components/scrollbar-utils';
-export type { RsSelectFieldNames, RsSelectFilterOption, RsSelectFilterSort, RsSelectGetPopupContainer, RsSelectLabeledValue, RsSelectModelValue, RsSelectResolvedModel, RsSelectOption, RsSelectOptionFilterProp, RsSelectOptionGroup, RsSelectOptionInput, RsSelectOptions, RsSelectOptionsInput, RsSelectPlacement, RsSelectStatus, RsSelectValue, } from './components/select-utils';
+export type { RsSelectFieldNames, RsSelectFilterOption, RsSelectFilterSort, RsSelectGetPopupContainer, RsSelectLabeledValue, RsSelectModelValue, RsSelectResolvedModel, RsSelectOption, RsSelectOptionFilterProp, RsSelectOptionGroup, RsSelectOptionInput, RsSelectOptions, RsSelectOptionsInput, RsSelectPlacement, RsSelectStatus, RsSelectMaxTagCount, RsSelectVariant, RsSelectValue, } from './components/select-utils';
+export type { RsCascaderExpandTrigger, RsCascaderOption, RsCascaderPath, } from './components/cascader-utils';
+export type { RsMentionActive, RsMentionCaretBox, RsMentionOption, RsMentionPopupBox, } from './components/mentions-utils';
 export { RS_SELECT_EMPTY_VALUE, fromComboboxValue, isSelectLabeledValue, normalizeSelectOptions, optionDisplayLabel, packSelectModel, restoreSelectValue, toComboboxValue, unwrapSelectEntry, } from './components/select-utils';
-export type { RsFeedbackTone, RsToastPosition, RsToastType } from './components/overlay-utils';
-export { RS_TOAST_DEFAULT_GAP, RS_TOAST_DEFAULT_POSITION, rsToastPositions, rsFeedbackIconClass } from './components/overlay-utils';
+export type { RsFeedbackTone, RsToastPosition, RsToastType, RsOverlayAnchorBox, RsOverlayBox } from './components/overlay-utils';
+export { RS_TOAST_DEFAULT_GAP, RS_TOAST_DEFAULT_POSITION, rsToastPositions, rsFeedbackIconClass, placeAnchoredPopup, stepEnabledIndex } from './components/overlay-utils';
 export type { RsFormContext, RsFormErrorRender, RsFormErrorRenderContext, RsFormFieldExpose, RsFormItemContext, RsFormListContext, RsFormListField, RsFormListOperations, RsFormFieldValidationResult, RsFormGap, RsFormLabelAlign, RsFormLabelPosition, RsFormMaxWidth, RsFormSize, RsFormValidateStatus, RsFormValidationResult, } from './components/form-utils';
 export { cloneFormFieldValue, isRsFormItemBoundControl, provideRsFormItemContext, provideRsFormListContext, RS_FORM_INJECTION_KEY, RS_FORM_ITEM_INJECTION_KEY, RS_FORM_LIST_INJECTION_KEY, resolveFieldRules, useRsFormContext, useRsFormField, useRsFormItemContext, useRsFormListContext, } from './components/form-utils';
 export type { RsFormNamePath } from './components/form-path';