npm - @blueking/bk-user-selector - Versions diffs - 0.1.5 → 0.1.7 - Mend

@blueking/bk-user-selector 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +144 -34
package/package.json +6 -3
package/typings/components/selection-popover.vue.d.ts +8 -2
package/typings/components/user-selector.vue.d.ts +14 -2
package/typings/hooks/use-api-config.d.ts +33 -0
package/typings/locale/en-us.d.ts +1 -0
package/typings/locale/zh-cn.d.ts +1 -0
package/typings/types/index.d.ts +50 -0
package/typings/utils/logger.d.ts +9 -1
package/vue2/index.es.min.js +5514 -2529
package/vue2/index.iife.min.js +6260 -3177
package/vue2/index.umd.min.js +5690 -2704
package/vue2/vue2.css +53 -8
package/vue3/index.es.min.js +1232 -285
package/vue3/index.iife.min.js +5499 -2521
package/vue3/index.umd.min.js +1232 -285
package/vue3/vue3.css +53 -8

package/vue3/index.umd.min.js CHANGED Viewed

@@ -6,12 +6,13 @@
 	], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global.lesscodeCustomComponentLibrary = {}, global.Vue, global.bkui_vue));
 })(this, function(exports, vue, bkui_vue) {
 	var __vite_style__ = document.createElement("style");
-	__vite_style__.textContent = "@charset \"UTF-8\";.me-tag[data-v-a1054364] {\n  position: absolute;\n  top: 50%;\n  right: 8px;\n  z-index: 1;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 24px;\n  height: 24px;\n  padding: 0 8px;\n  font-size: 12px;\n  color: #4d4f56;\n  white-space: nowrap;\n  cursor: pointer;\n  background-color: #e1ecff;\n  border-radius: 50%;\n  transform: translateY(-50%);\n}\n.me-tag[data-v-a1054364]:hover {\n  color: #3a84ff;\n  background-color: #cddffe;\n}\n.me-tag.disabled[data-v-a1054364] {\n  color: #c4c6cc;\n  cursor: not-allowed;\n  background-color: #f0f1f5;\n}.dropdown-content[data-v-9173accf] {\n  min-height: 40px;\n  max-height: 300px;\n  padding: 5px 0;\n  overflow-y: auto;\n}\n.dropdown-content .no-data[data-v-9173accf] {\n  padding: 10px;\n  color: #979ba5;\n  text-align: center;\n}\n.dropdown-content .user-group .group-header[data-v-9173accf] {\n  display: flex;\n  align-items: center;\n  padding: 8px 12px;\n  color: #979ba5;\n}\n.dropdown-content .user-group .group-header .group-count[data-v-9173accf] {\n  margin-left: 4px;\n}\n.dropdown-content .user-option[data-v-9173accf] {\n  display: flex;\n  align-items: center;\n  height: 32px;\n  padding: 8px 12px;\n  cursor: pointer;\n}\n.dropdown-content .user-option[data-v-9173accf]:hover, .dropdown-content .user-option.is-highlighted[data-v-9173accf] {\n  background-color: #f5f7fa;\n}.user-tag[data-v-d1173d20] {\n  height: 24px;\n  margin-right: 4px;\n  margin-left: 0;\n}\n.user-tag.draggable[data-v-d1173d20] {\n  cursor: move;\n}\n.user-tag.active[data-v-d1173d20] {\n  background-color: #e1ecff;\n  border-color: #3a84ff;\n}\n.user-tag.is-custom[data-v-d1173d20] {\n  color: #ea3636;\n  background-color: #feebea;\n  border-color: rgba(234, 53, 54, 0.3019607843);\n}\n.user-tag.is-custom[data-v-d1173d20]:hover {\n  background-color: #fedddc;\n}\n.user-tag .tag-content .user-name[data-v-d1173d20] {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  font-size: 12px;\n  white-space: nowrap;\n}\n.bk-user-selector[data-v-089550be] {\n  position: relative;\n  width: 100%;\n  height: 32px;\n  font-size: 12px;\n}\n.bk-user-selector.is-disabled[data-v-089550be] {\n  pointer-events: none;\n  cursor: not-allowed;\n  background-color: #dcdee5;\n}\n.bk-user-selector.is-textarea[data-v-089550be] {\n  height: auto;\n  min-height: 32px;\n}\n.bk-user-selector .tags-container[data-v-089550be] {\n  position: relative;\n  min-height: 32px;\n  padding: 3px 10px 3px 8px;\n  background-color: #fff;\n  border: 1px solid #c4c6cc;\n  border-radius: 2px;\n  transition: all 0.2s ease;\n}\n.bk-user-selector .tags-container.focused[data-v-089550be] {\n  border-color: #3a84ff;\n  box-shadow: 0 0 0 2px rgba(58, 132, 255, 0.1);\n}\n.bk-user-selector .tags-container.tags-container-collapsed[data-v-089550be] {\n  display: flex;\n  flex-wrap: wrap;\n  row-gap: 4px;\n  align-items: center;\n  /* 与 .tag-list 一致：避免默认 stretch 拉高行高后 align-items:center 把首行顶离上边框 */\n  align-content: flex-start;\n}\n.bk-user-selector .tag-list[data-v-089550be] {\n  display: flex;\n  flex-wrap: wrap;\n  row-gap: 4px;\n  align-items: center;\n  align-content: flex-start;\n}\n.bk-user-selector .tag-wrapper[data-v-089550be] {\n  display: inline-flex;\n  align-items: center;\n  max-width: 100%;\n}\n.bk-user-selector .search-input[data-v-089550be] {\n  min-width: 20px;\n  height: 24px;\n  outline: none;\n  background: transparent;\n  border: none;\n}\n.bk-user-selector .search-input[data-v-089550be]::placeholder {\n  color: #c4c6cc;\n}\n.bk-user-selector .search-input.input-inline[data-v-089550be] {\n  min-width: 20px;\n}\n.bk-user-selector .search-input.input-last[data-v-089550be], .bk-user-selector .search-input.search-input-collapsed[data-v-089550be] {\n  flex: 1;\n}\n.hidden-users[data-v-089550be] {\n  padding: 6px 10px;\n}.bk-user-selector-popover {\n  padding: 0 !important;\n}\n.bk-user-selector.is-textarea .me-tag {\n  top: 4px;\n  transform: none;\n}/*$vite$:1*/";
+	__vite_style__.textContent = "@charset \"UTF-8\";.me-tag[data-v-a1054364] {\n  position: absolute;\n  top: 50%;\n  right: 8px;\n  z-index: 1;\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 24px;\n  height: 24px;\n  padding: 0 8px;\n  font-size: 12px;\n  color: #4d4f56;\n  white-space: nowrap;\n  cursor: pointer;\n  background-color: #e1ecff;\n  border-radius: 50%;\n  transform: translateY(-50%);\n}\n.me-tag[data-v-a1054364]:hover {\n  color: #3a84ff;\n  background-color: #cddffe;\n}\n.me-tag.disabled[data-v-a1054364] {\n  color: #c4c6cc;\n  cursor: not-allowed;\n  background-color: #f0f1f5;\n}.dropdown-content[data-v-9173accf] {\n  min-height: 40px;\n  max-height: 300px;\n  padding: 5px 0;\n}\n.dropdown-content .no-data[data-v-9173accf] {\n  padding: 10px;\n  color: #979ba5;\n  text-align: center;\n}\n.dropdown-panels[data-v-9173accf] {\n  display: block;\n}\n.dropdown-panel[data-v-9173accf] {\n  min-width: 0;\n  max-height: 290px;\n  overflow-y: auto;\n}\n.dropdown-panels.is-two-column[data-v-9173accf] {\n  display: flex;\n}\n.dropdown-panels.is-two-column .dropdown-panel[data-v-9173accf] {\n  width: 50%;\n}\n.dropdown-panels.is-two-column .dropdown-panel + .dropdown-panel[data-v-9173accf] {\n  border-left: 1px solid #eaebf0;\n}\n.group-header[data-v-9173accf] {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  padding: 8px 12px;\n  color: #979ba5;\n}\n.group-header .group-name[data-v-9173accf],\n.group-header .group-count[data-v-9173accf] {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n.user-group[data-v-9173accf],\n.dropdown-panel-main[data-v-9173accf],\n.dropdown-panel-recent[data-v-9173accf] {\n  min-width: 0;\n}\n.user-option[data-v-9173accf] {\n  display: flex;\n  align-items: center;\n  min-width: 0;\n  height: 32px;\n  padding: 8px 12px;\n  cursor: pointer;\n}\n.user-option[data-v-9173accf]:hover, .user-option.is-highlighted[data-v-9173accf] {\n  background-color: #f5f7fa;\n}\n.dropdown-panel[data-v-9173accf] .user-render,\n.dropdown-panel[data-v-9173accf] .user-main,\n.dropdown-panel[data-v-9173accf] .user-name,\n.dropdown-panel[data-v-9173accf] .tenant-name,\n.user-option[data-v-9173accf] .user-render,\n.user-option[data-v-9173accf] .user-main,\n.user-option[data-v-9173accf] .user-name,\n.user-option[data-v-9173accf] .tenant-name {\n  min-width: 0;\n}\n.dropdown-panel[data-v-9173accf] .user-name,\n.dropdown-panel[data-v-9173accf] .tenant-name,\n.user-option[data-v-9173accf] .user-name,\n.user-option[data-v-9173accf] .tenant-name {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}.user-tag[data-v-d1173d20] {\n  height: 24px;\n  margin-right: 4px;\n  margin-left: 0;\n}\n.user-tag.draggable[data-v-d1173d20] {\n  cursor: move;\n}\n.user-tag.active[data-v-d1173d20] {\n  background-color: #e1ecff;\n  border-color: #3a84ff;\n}\n.user-tag.is-custom[data-v-d1173d20] {\n  color: #ea3636;\n  background-color: #feebea;\n  border-color: rgba(234, 53, 54, 0.3019607843);\n}\n.user-tag.is-custom[data-v-d1173d20]:hover {\n  background-color: #fedddc;\n}\n.user-tag .tag-content .user-name[data-v-d1173d20] {\n  overflow: hidden;\n  text-overflow: ellipsis;\n  font-size: 12px;\n  white-space: nowrap;\n}\n.bk-user-selector[data-v-089550be] {\n  position: relative;\n  width: 100%;\n  height: 32px;\n  font-size: 12px;\n}\n.bk-user-selector.is-disabled[data-v-089550be] {\n  pointer-events: none;\n  cursor: not-allowed;\n  background-color: #dcdee5;\n}\n.bk-user-selector.is-textarea[data-v-089550be] {\n  height: auto;\n  min-height: 32px;\n}\n.bk-user-selector .tags-container[data-v-089550be] {\n  position: relative;\n  min-height: 32px;\n  padding: 3px 10px 3px 8px;\n  background-color: #fff;\n  border: 1px solid #c4c6cc;\n  border-radius: 2px;\n  transition: all 0.2s ease;\n}\n.bk-user-selector .tags-container.focused[data-v-089550be] {\n  border-color: #3a84ff;\n  box-shadow: 0 0 0 2px rgba(58, 132, 255, 0.1);\n}\n.bk-user-selector .tags-container.tags-container-collapsed[data-v-089550be] {\n  display: flex;\n  flex-wrap: wrap;\n  row-gap: 4px;\n  /* 与 .tag-list 一致：避免默认 stretch 拉高行高后 align-items:center 把首行顶离上边框 */\n  align-content: flex-start;\n  align-items: center;\n}\n.bk-user-selector .tag-list[data-v-089550be] {\n  display: flex;\n  flex-wrap: wrap;\n  row-gap: 4px;\n  align-content: flex-start;\n  align-items: center;\n}\n.bk-user-selector .tag-wrapper[data-v-089550be] {\n  display: inline-flex;\n  align-items: center;\n  max-width: 100%;\n}\n.bk-user-selector .search-input[data-v-089550be] {\n  min-width: 20px;\n  height: 24px;\n  outline: none;\n  background: transparent;\n  border: none;\n}\n.bk-user-selector .search-input[data-v-089550be]::placeholder {\n  color: #c4c6cc;\n}\n.bk-user-selector .search-input.input-inline[data-v-089550be] {\n  min-width: 20px;\n}\n.bk-user-selector .search-input.input-last[data-v-089550be], .bk-user-selector .search-input.search-input-collapsed[data-v-089550be] {\n  flex: 1;\n}\n.hidden-users[data-v-089550be] {\n  padding: 6px 10px;\n}.bk-user-selector-popover {\n  padding: 0 !important;\n}\n.bk-user-selector.is-textarea .me-tag {\n  top: 4px;\n  transform: none;\n}/*$vite$:1*/";
 	document.head.appendChild(__vite_style__);
 	Object.defineProperties(exports, {
 		__esModule: { value: true },
 		[Symbol.toStringTag]: { value: "Module" }
 	});
+	//#region \0rolldown/runtime.js
 	var __create = Object.create;
 	var __defProp = Object.defineProperty;
 	var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -33,6 +34,8 @@
 		value: mod,
 		enumerable: true
 	}) : target, mod));
+	//#endregion
+	//#region src/constants/index.ts
 	var import_Sortable = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
 		/**!
 		* Sortable 1.15.6
@@ -70,11 +73,11 @@
 			}
 			function _typeof(obj) {
 				"@babel/helpers - typeof";
-				if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") _typeof = function(obj$1) {
-					return typeof obj$1;
+				if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") _typeof = function(obj) {
+					return typeof obj;
 				};
-				else _typeof = function(obj$1) {
-					return obj$1 && typeof Symbol === "function" && obj$1.constructor === Symbol && obj$1 !== Symbol.prototype ? "symbol" : typeof obj$1;
+				else _typeof = function(obj) {
+					return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj;
 				};
 				return _typeof(obj);
 			}
@@ -234,6 +237,15 @@
 				if (scrollingElement) return scrollingElement;
 				else return document.documentElement;
 			}
+			/**
+			* Returns the "bounding client rect" of given element
+			* @param  {HTMLElement} el                       The element whose boundingClientRect is wanted
+			* @param  {[Boolean]} relativeToContainingBlock  Whether the rect should be relative to the containing block of (including) the container
+			* @param  {[Boolean]} relativeToNonStaticParent  Whether the rect should be relative to the relative parent of (including) the contaienr
+			* @param  {[Boolean]} undoScale                  Whether the container's scale() should be undone
+			* @param  {[HTMLElement]} container              The parent the element will be placed in
+			* @return {Object}                               The boundingClientRect of el, with specified adjustments
+			*/
 			function getRect(el, relativeToContainingBlock, relativeToNonStaticParent, undoScale, container) {
 				if (!el.getBoundingClientRect && el !== window) return;
 				var elRect, top, left, bottom, right, height, width;
@@ -286,6 +298,13 @@
 					height
 				};
 			}
+			/**
+			* Checks if a side of an element is scrolled past a side of its parents
+			* @param  {HTMLElement}  el           The element who's side being scrolled out of view is in question
+			* @param  {String}       elSide       Side of the element in question ('top', 'left', 'right', 'bottom')
+			* @param  {String}       parentSide   Side of the parent in question ('top', 'left', 'right', 'bottom')
+			* @return {HTMLElement}               The parent scroll element that the el's side is scrolled past, or null if there is no such element
+			*/
 			function isScrolledPast(el, elSide, parentSide) {
 				var parent = getParentAutoScrollElement(el, true), elSideVal = getRect(el)[elSide];
 				while (parent) {
@@ -298,10 +317,18 @@
 				}
 				return false;
 			}
+			/**
+			* Gets nth child of el, ignoring hidden children, sortable's elements (does not ignore clone if it's visible)
+			* and non-draggable elements
+			* @param  {HTMLElement} el       The parent element
+			* @param  {Number} childNum      The index of the child
+			* @param  {Object} options       Parent Sortable's options
+			* @return {HTMLElement}          The child at index childNum, or null if not found
+			*/
 			function getChild(el, childNum, options, includeDragEl) {
 				var currentChild = 0, i = 0, children = el.children;
 				while (i < children.length) {
-					if (children[i].style.display !== "none" && children[i] !== Sortable$1.ghost && (includeDragEl || children[i] !== Sortable$1.dragged) && closest(children[i], options.draggable, el, false)) {
+					if (children[i].style.display !== "none" && children[i] !== Sortable.ghost && (includeDragEl || children[i] !== Sortable.dragged) && closest(children[i], options.draggable, el, false)) {
 						if (currentChild === childNum) return children[i];
 						currentChild++;
 					}
@@ -309,17 +336,36 @@
 				}
 				return null;
 			}
+			/**
+			* Gets the last child in the el, ignoring ghostEl or invisible elements (clones)
+			* @param  {HTMLElement} el       Parent element
+			* @param  {selector} selector    Any other elements that should be ignored
+			* @return {HTMLElement}          The last child, ignoring ghostEl
+			*/
 			function lastChild(el, selector) {
 				var last = el.lastElementChild;
-				while (last && (last === Sortable$1.ghost || css(last, "display") === "none" || selector && !matches(last, selector))) last = last.previousElementSibling;
+				while (last && (last === Sortable.ghost || css(last, "display") === "none" || selector && !matches(last, selector))) last = last.previousElementSibling;
 				return last || null;
 			}
+			/**
+			* Returns the index of an element within its parent for a selected set of
+			* elements
+			* @param  {HTMLElement} el
+			* @param  {selector} selector
+			* @return {number}
+			*/
 			function index(el, selector) {
-				var index$1 = 0;
+				var index = 0;
 				if (!el || !el.parentNode) return -1;
-				while (el = el.previousElementSibling) if (el.nodeName.toUpperCase() !== "TEMPLATE" && el !== Sortable$1.clone && (!selector || matches(el, selector))) index$1++;
-				return index$1;
+				while (el = el.previousElementSibling) if (el.nodeName.toUpperCase() !== "TEMPLATE" && el !== Sortable.clone && (!selector || matches(el, selector))) index++;
+				return index;
 			}
+			/**
+			* Returns the scroll offset of the given element, added with all the scroll offsets of parent elements.
+			* The value is returned in real pixels.
+			* @param  {HTMLElement} el
+			* @return {Array}             Offsets in the format of [left, top]
+			*/
 			function getRelativeScrollOffset(el) {
 				var offsetLeft = 0, offsetTop = 0, winScroller = getWindowScrollingElement();
 				if (el) do {
@@ -329,6 +375,12 @@
 				} while (el !== winScroller && (el = el.parentNode));
 				return [offsetLeft, offsetTop];
 			}
+			/**
+			* Returns the index of the object within the given array
+			* @param  {Array} arr   Array that may or may not hold the object
+			* @param  {Object} obj  An object that has a key-value pair unique to and identical to a key-value pair in the object you want to find
+			* @return {Number}      The index of the object in the array, or -1
+			*/
 			function indexOfObject(arr, obj) {
 				for (var i in arr) {
 					if (!arr.hasOwnProperty(i)) continue;
@@ -403,11 +455,11 @@
 				css(el, "width", "");
 				css(el, "height", "");
 			}
-			function getChildContainingRectFromElement(container, options, ghostEl$1) {
+			function getChildContainingRectFromElement(container, options, ghostEl) {
 				var rect = {};
 				Array.from(container.children).forEach(function(child) {
 					var _rect$left, _rect$top, _rect$right, _rect$bottom;
-					if (!closest(child, options.draggable, container, false) || child.animated || child === ghostEl$1) return;
+					if (!closest(child, options.draggable, container, false) || child.animated || child === ghostEl) return;
 					var childRect = getRect(child);
 					rect.left = Math.min((_rect$left = rect.left) !== null && _rect$left !== void 0 ? _rect$left : Infinity, childRect.left);
 					rect.top = Math.min((_rect$top = rect.top) !== null && _rect$top !== void 0 ? _rect$top : Infinity, childRect.top);
@@ -428,7 +480,7 @@
 						animationStates = [];
 						if (!this.options.animation) return;
 						[].slice.call(this.el.children).forEach(function(child) {
-							if (css(child, "display") === "none" || child === Sortable$1.ghost) return;
+							if (css(child, "display") === "none" || child === Sortable.ghost) return;
 							animationStates.push({
 								target: child,
 								rect: getRect(child)
@@ -535,7 +587,7 @@
 					});
 					plugins.push(plugin);
 				},
-				pluginEvent: function pluginEvent$1(eventName, sortable, evt) {
+				pluginEvent: function pluginEvent(eventName, sortable, evt) {
 					var _this = this;
 					this.eventCanceled = false;
 					evt.cancel = function() {
@@ -548,7 +600,7 @@
 						if (sortable.options[plugin.pluginName] && sortable[plugin.pluginName][eventName]) sortable[plugin.pluginName][eventName](_objectSpread2({ sortable }, evt));
 					});
 				},
-				initializePlugins: function initializePlugins(sortable, el, defaults$1, options) {
+				initializePlugins: function initializePlugins(sortable, el, defaults, options) {
 					plugins.forEach(function(plugin) {
 						var pluginName = plugin.pluginName;
 						if (!sortable.options[pluginName] && !plugin.initializeByDefault) return;
@@ -556,7 +608,7 @@
 						initialized.sortable = sortable;
 						initialized.options = sortable.options;
 						sortable[pluginName] = initialized;
-						_extends(defaults$1, initialized.defaults);
+						_extends(defaults, initialized.defaults);
 					});
 					for (var option in sortable.options) {
 						if (!sortable.options.hasOwnProperty(option)) continue;
@@ -582,8 +634,8 @@
 				}
 			};
 			function dispatchEvent(_ref) {
-				var sortable = _ref.sortable, rootEl$1 = _ref.rootEl, name = _ref.name, targetEl = _ref.targetEl, cloneEl$1 = _ref.cloneEl, toEl = _ref.toEl, fromEl = _ref.fromEl, oldIndex$1 = _ref.oldIndex, newIndex$1 = _ref.newIndex, oldDraggableIndex$1 = _ref.oldDraggableIndex, newDraggableIndex$1 = _ref.newDraggableIndex, originalEvent = _ref.originalEvent, putSortable$1 = _ref.putSortable, extraEventProperties = _ref.extraEventProperties;
-				sortable = sortable || rootEl$1 && rootEl$1[expando];
+				var sortable = _ref.sortable, rootEl = _ref.rootEl, name = _ref.name, targetEl = _ref.targetEl, cloneEl = _ref.cloneEl, toEl = _ref.toEl, fromEl = _ref.fromEl, oldIndex = _ref.oldIndex, newIndex = _ref.newIndex, oldDraggableIndex = _ref.oldDraggableIndex, newDraggableIndex = _ref.newDraggableIndex, originalEvent = _ref.originalEvent, putSortable = _ref.putSortable, extraEventProperties = _ref.extraEventProperties;
+				sortable = sortable || rootEl && rootEl[expando];
 				if (!sortable) return;
 				var evt, options = sortable.options, onName = "on" + name.charAt(0).toUpperCase() + name.substr(1);
 				if (window.CustomEvent && !IE11OrLess && !Edge) evt = new CustomEvent(name, {
@@ -594,25 +646,25 @@
 					evt = document.createEvent("Event");
 					evt.initEvent(name, true, true);
 				}
-				evt.to = toEl || rootEl$1;
-				evt.from = fromEl || rootEl$1;
-				evt.item = targetEl || rootEl$1;
-				evt.clone = cloneEl$1;
-				evt.oldIndex = oldIndex$1;
-				evt.newIndex = newIndex$1;
-				evt.oldDraggableIndex = oldDraggableIndex$1;
-				evt.newDraggableIndex = newDraggableIndex$1;
+				evt.to = toEl || rootEl;
+				evt.from = fromEl || rootEl;
+				evt.item = targetEl || rootEl;
+				evt.clone = cloneEl;
+				evt.oldIndex = oldIndex;
+				evt.newIndex = newIndex;
+				evt.oldDraggableIndex = oldDraggableIndex;
+				evt.newDraggableIndex = newDraggableIndex;
 				evt.originalEvent = originalEvent;
-				evt.pullMode = putSortable$1 ? putSortable$1.lastPutMode : void 0;
+				evt.pullMode = putSortable ? putSortable.lastPutMode : void 0;
 				var allEventProperties = _objectSpread2(_objectSpread2({}, extraEventProperties), PluginManager.getEventProperties(name, sortable));
 				for (var option in allEventProperties) evt[option] = allEventProperties[option];
-				if (rootEl$1) rootEl$1.dispatchEvent(evt);
+				if (rootEl) rootEl.dispatchEvent(evt);
 				if (options[onName]) options[onName].call(sortable, evt);
 			}
 			var _excluded = ["evt"];
-			var pluginEvent = function pluginEvent$1(eventName, sortable) {
+			var pluginEvent = function pluginEvent(eventName, sortable) {
 				var _ref = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {}, originalEvent = _ref.evt, data = _objectWithoutProperties(_ref, _excluded);
-				PluginManager.pluginEvent.bind(Sortable$1)(eventName, sortable, _objectSpread2({
+				PluginManager.pluginEvent.bind(Sortable)(eventName, sortable, _objectSpread2({
 					dragEl,
 					parentEl,
 					ghostEl,
@@ -623,7 +675,7 @@
 					cloneHidden,
 					dragStarted: moved,
 					putSortable,
-					activeSortable: Sortable$1.active,
+					activeSortable: Sortable.active,
 					originalEvent,
 					oldIndex,
 					oldDraggableIndex,
@@ -659,13 +711,14 @@
 				}, info));
 			}
 			var dragEl, parentEl, ghostEl, rootEl, nextEl, lastDownEl, cloneEl, cloneHidden, oldIndex, newIndex, oldDraggableIndex, newDraggableIndex, activeGroup, putSortable, awaitingDragStarted = false, ignoreNextClick = false, sortables = [], tapEvt, touchEvt, lastDx, lastDy, tapDistanceLeft, tapDistanceTop, moved, lastTarget, lastDirection, pastFirstInvertThresh = false, isCircumstantialInvert = false, targetMoveDistance, ghostRelativeParent, ghostRelativeParentInitialScroll = [], _silent = false, savedInputChecked = [];
+			/** @const */
 			var documentExists = typeof document !== "undefined", PositionGhostAbsolutely = IOS, CSSFloatProperty = Edge || IE11OrLess ? "cssFloat" : "float", supportDraggable = documentExists && !ChromeForAndroid && !IOS && "draggable" in document.createElement("div"), supportCssPointerEvents = function() {
 				if (!documentExists) return;
 				if (IE11OrLess) return false;
 				var el = document.createElement("x");
 				el.style.cssText = "pointer-events:auto";
 				return el.style.pointerEvents === "auto";
-			}(), _detectDirection = function _detectDirection$1(el, options) {
+			}(), _detectDirection = function _detectDirection(el, options) {
 				var elCSS = css(el), elWidth = parseInt(elCSS.width) - parseInt(elCSS.paddingLeft) - parseInt(elCSS.paddingRight) - parseInt(elCSS.borderLeftWidth) - parseInt(elCSS.borderRightWidth), child1 = getChild(el, 0, options), child2 = getChild(el, 1, options), firstChildCSS = child1 && css(child1), secondChildCSS = child2 && css(child2), firstChildWidth = firstChildCSS && parseInt(firstChildCSS.marginLeft) + parseInt(firstChildCSS.marginRight) + getRect(child1).width, secondChildWidth = secondChildCSS && parseInt(secondChildCSS.marginLeft) + parseInt(secondChildCSS.marginRight) + getRect(child2).width;
 				if (elCSS.display === "flex") return elCSS.flexDirection === "column" || elCSS.flexDirection === "column-reverse" ? "vertical" : "horizontal";
 				if (elCSS.display === "grid") return elCSS.gridTemplateColumns.split(" ").length <= 1 ? "vertical" : "horizontal";
@@ -674,10 +727,10 @@
 					return child2 && (secondChildCSS.clear === "both" || secondChildCSS.clear === touchingSideChild2) ? "vertical" : "horizontal";
 				}
 				return child1 && (firstChildCSS.display === "block" || firstChildCSS.display === "flex" || firstChildCSS.display === "table" || firstChildCSS.display === "grid" || firstChildWidth >= elWidth && elCSS[CSSFloatProperty] === "none" || child2 && elCSS[CSSFloatProperty] === "none" && firstChildWidth + secondChildWidth > elWidth) ? "vertical" : "horizontal";
-			}, _dragElInRowColumn = function _dragElInRowColumn$1(dragRect, targetRect, vertical) {
+			}, _dragElInRowColumn = function _dragElInRowColumn(dragRect, targetRect, vertical) {
 				var dragElS1Opp = vertical ? dragRect.left : dragRect.top, dragElS2Opp = vertical ? dragRect.right : dragRect.bottom, dragElOppLength = vertical ? dragRect.width : dragRect.height, targetS1Opp = vertical ? targetRect.left : targetRect.top, targetS2Opp = vertical ? targetRect.right : targetRect.bottom, targetOppLength = vertical ? targetRect.width : targetRect.height;
 				return dragElS1Opp === targetS1Opp || dragElS2Opp === targetS2Opp || dragElS1Opp + dragElOppLength / 2 === targetS1Opp + targetOppLength / 2;
-			}, _detectNearestEmptySortable = function _detectNearestEmptySortable$1(x, y) {
+			}, _detectNearestEmptySortable = function _detectNearestEmptySortable(x, y) {
 				var ret;
 				sortables.some(function(sortable) {
 					var threshold = sortable[expando].options.emptyInsertThreshold;
@@ -686,14 +739,14 @@
 					if (insideHorizontally && insideVertically) return ret = sortable;
 				});
 				return ret;
-			}, _prepareGroup = function _prepareGroup$1(options) {
+			}, _prepareGroup = function _prepareGroup(options) {
 				function toFn(value, pull) {
-					return function(to, from, dragEl$2, evt) {
+					return function(to, from, dragEl, evt) {
 						var sameGroup = to.options.group.name && from.options.group.name && to.options.group.name === from.options.group.name;
 						if (value == null && (pull || sameGroup)) return true;
 						else if (value == null || value === false) return false;
 						else if (pull && value === "clone") return value;
-						else if (typeof value === "function") return toFn(value(to, from, dragEl$2, evt), pull)(to, from, dragEl$2, evt);
+						else if (typeof value === "function") return toFn(value(to, from, dragEl, evt), pull)(to, from, dragEl, evt);
 						else {
 							var otherGroup = (pull ? to : from).options.group.name;
 							return value === true || typeof value === "string" && value === otherGroup || value.join && value.indexOf(otherGroup) > -1;
@@ -708,9 +761,9 @@
 				group.checkPut = toFn(originalGroup.put);
 				group.revertClone = originalGroup.revertClone;
 				options.group = group;
-			}, _hideGhostForTarget = function _hideGhostForTarget$1() {
+			}, _hideGhostForTarget = function _hideGhostForTarget() {
 				if (!supportCssPointerEvents && ghostEl) css(ghostEl, "display", "none");
-			}, _unhideGhostForTarget = function _unhideGhostForTarget$1() {
+			}, _unhideGhostForTarget = function _unhideGhostForTarget() {
 				if (!supportCssPointerEvents && ghostEl) css(ghostEl, "display", "");
 			};
 			if (documentExists && !ChromeForAndroid) document.addEventListener("click", function(evt) {
@@ -722,7 +775,7 @@
 					return false;
 				}
 			}, true);
-			var nearestEmptyInsertDetectEvent = function nearestEmptyInsertDetectEvent$1(evt) {
+			var nearestEmptyInsertDetectEvent = function nearestEmptyInsertDetectEvent(evt) {
 				if (dragEl) {
 					evt = evt.touches ? evt.touches[0] : evt;
 					var nearest = _detectNearestEmptySortable(evt.clientX, evt.clientY);
@@ -736,15 +789,20 @@
 					}
 				}
 			};
-			var _checkOutsideTargetEl = function _checkOutsideTargetEl$1(evt) {
+			var _checkOutsideTargetEl = function _checkOutsideTargetEl(evt) {
 				if (dragEl) dragEl.parentNode[expando]._isOutsideThisEl(evt.target);
 			};
-			function Sortable$1(el, options) {
+			/**
+			* @class  Sortable
+			* @param  {HTMLElement}  el
+			* @param  {Object}       [options]
+			*/
+			function Sortable(el, options) {
 				if (!(el && el.nodeType && el.nodeType === 1)) throw "Sortable: `el` must be an HTMLElement, not ".concat({}.toString.call(el));
 				this.el = el;
 				this.options = options = _extends({}, options);
 				el[expando] = this;
-				var defaults$1 = {
+				var defaults = {
 					group: null,
 					sort: true,
 					disabled: false,
@@ -766,8 +824,8 @@
 					preventOnFilter: true,
 					animation: 0,
 					easing: null,
-					setData: function setData(dataTransfer, dragEl$2) {
-						dataTransfer.setData("Text", dragEl$2.textContent);
+					setData: function setData(dataTransfer, dragEl) {
+						dataTransfer.setData("Text", dragEl.textContent);
 					},
 					dropBubble: false,
 					dragoverBubble: false,
@@ -783,11 +841,11 @@
 						x: 0,
 						y: 0
 					},
-					supportPointer: Sortable$1.supportPointer !== false && "PointerEvent" in window && (!Safari || IOS),
+					supportPointer: Sortable.supportPointer !== false && "PointerEvent" in window && (!Safari || IOS),
 					emptyInsertThreshold: 5
 				};
-				PluginManager.initializePlugins(this, el, defaults$1);
-				for (var name in defaults$1) !(name in options) && (options[name] = defaults$1[name]);
+				PluginManager.initializePlugins(this, el, defaults);
+				for (var name in defaults) !(name in options) && (options[name] = defaults[name]);
 				_prepareGroup(options);
 				for (var fn in this) if (fn.charAt(0) === "_" && typeof this[fn] === "function") this[fn] = this[fn].bind(this);
 				this.nativeDraggable = options.forceFallback ? false : supportDraggable;
@@ -805,8 +863,8 @@
 				options.store && options.store.get && this.sort(options.store.get(this) || []);
 				_extends(this, AnimationStateManager());
 			}
-			Sortable$1.prototype = {
-				constructor: Sortable$1,
+			Sortable.prototype = (			/** @lends Sortable.prototype */ {
+				constructor: Sortable,
 				_isOutsideThisEl: function _isOutsideThisEl(target) {
 					if (!this.el.contains(target) && target !== this.el) lastTarget = null;
 				},
@@ -874,7 +932,7 @@
 						nextEl = dragEl.nextSibling;
 						lastDownEl = target;
 						activeGroup = options.group;
-						Sortable$1.dragged = dragEl;
+						Sortable.dragged = dragEl;
 						tapEvt = {
 							target: dragEl,
 							clientX: (touch || evt).clientX,
@@ -885,9 +943,9 @@
 						this._lastX = (touch || evt).clientX;
 						this._lastY = (touch || evt).clientY;
 						dragEl.style["will-change"] = "all";
-						dragStartFn = function dragStartFn$1() {
+						dragStartFn = function dragStartFn() {
 							pluginEvent("delayEnded", _this, { evt });
-							if (Sortable$1.eventCanceled) {
+							if (Sortable.eventCanceled) {
 								_this._onDrop();
 								return;
 							}
@@ -921,7 +979,7 @@
 						}
 						pluginEvent("delayStart", this, { evt });
 						if (options.delay && (!options.delayOnTouchOnly || touch) && (!this.nativeDraggable || !(Edge || IE11OrLess))) {
-							if (Sortable$1.eventCanceled) {
+							if (Sortable.eventCanceled) {
 								this._onDrop();
 								return;
 							}
@@ -984,7 +1042,7 @@
 						var options = this.options;
 						!fallback && toggleClass(dragEl, options.dragClass, false);
 						toggleClass(dragEl, options.ghostClass, true);
-						Sortable$1.active = this;
+						Sortable.active = this;
 						fallback && this._appendGhost();
 						_dispatchEvent({
 							sortable: this,
@@ -1025,7 +1083,7 @@
 				_onTouchMove: function _onTouchMove(evt) {
 					if (tapEvt) {
 						var options = this.options, fallbackTolerance = options.fallbackTolerance, fallbackOffset = options.fallbackOffset, touch = evt.touches ? evt.touches[0] : evt, ghostMatrix = ghostEl && matrix(ghostEl, true), scaleX = ghostEl && ghostMatrix && ghostMatrix.a, scaleY = ghostEl && ghostMatrix && ghostMatrix.d, relativeScrollOffset = PositionGhostAbsolutely && ghostRelativeParent && getRelativeScrollOffset(ghostRelativeParent), dx = (touch.clientX - tapEvt.clientX + fallbackOffset.x) / (scaleX || 1) + (relativeScrollOffset ? relativeScrollOffset[0] - ghostRelativeParentInitialScroll[0] : 0) / (scaleX || 1), dy = (touch.clientY - tapEvt.clientY + fallbackOffset.y) / (scaleY || 1) + (relativeScrollOffset ? relativeScrollOffset[1] - ghostRelativeParentInitialScroll[1] : 0) / (scaleY || 1);
-						if (!Sortable$1.active && !awaitingDragStarted) {
+						if (!Sortable.active && !awaitingDragStarted) {
 							if (fallbackTolerance && Math.max(Math.abs(touch.clientX - this._lastX), Math.abs(touch.clientY - this._lastY)) < fallbackTolerance) return;
 							this._onDragStart(evt, true);
 						}
@@ -1082,7 +1140,7 @@
 						css(ghostEl, "position", PositionGhostAbsolutely ? "absolute" : "fixed");
 						css(ghostEl, "zIndex", "100000");
 						css(ghostEl, "pointerEvents", "none");
-						Sortable$1.ghost = ghostEl;
+						Sortable.ghost = ghostEl;
 						container.appendChild(ghostEl);
 						css(ghostEl, "transform-origin", tapDistanceLeft / parseInt(ghostEl.style.width) * 100 + "% " + tapDistanceTop / parseInt(ghostEl.style.height) * 100 + "%");
 					}
@@ -1092,23 +1150,23 @@
 					var dataTransfer = evt.dataTransfer;
 					var options = _this.options;
 					pluginEvent("dragStart", this, { evt });
-					if (Sortable$1.eventCanceled) {
+					if (Sortable.eventCanceled) {
 						this._onDrop();
 						return;
 					}
 					pluginEvent("setupClone", this);
-					if (!Sortable$1.eventCanceled) {
+					if (!Sortable.eventCanceled) {
 						cloneEl = clone(dragEl);
 						cloneEl.removeAttribute("id");
 						cloneEl.draggable = false;
 						cloneEl.style["will-change"] = "";
 						this._hideClone();
 						toggleClass(cloneEl, this.options.chosenClass, false);
-						Sortable$1.clone = cloneEl;
+						Sortable.clone = cloneEl;
 					}
 					_this.cloneId = _nextTick(function() {
 						pluginEvent("clone", _this);
-						if (Sortable$1.eventCanceled) return;
+						if (Sortable.eventCanceled) return;
 						if (!_this.options.removeCloneOnHide) rootEl.insertBefore(cloneEl, dragEl);
 						_this._hideClone();
 						_dispatchEvent({
@@ -1139,7 +1197,7 @@
 					if (Safari) css(document.body, "user-select", "none");
 				},
 				_onDragOver: function _onDragOver(evt) {
-					var el = this.el, target = evt.target, dragRect, targetRect, revert, options = this.options, group = options.group, activeSortable = Sortable$1.active, isOwner = activeGroup === group, canSort = options.sort, fromSortable = putSortable || activeSortable, vertical, _this = this, completedFired = false;
+					var el = this.el, target = evt.target, dragRect, targetRect, revert, options = this.options, group = options.group, activeSortable = Sortable.active, isOwner = activeGroup === group, canSort = options.sort, fromSortable = putSortable || activeSortable, vertical, _this = this, completedFired = false;
 					if (_silent) return;
 					function dragOverEvent(name, extra) {
 						pluginEvent(name, _this, _objectSpread2({
@@ -1153,8 +1211,8 @@
 							fromSortable,
 							target,
 							completed,
-							onMove: function onMove(target$1, after$1) {
-								return _onMove(rootEl, el, dragEl, dragRect, target$1, getRect(target$1), evt, after$1);
+							onMove: function onMove(target, after) {
+								return _onMove(rootEl, el, dragEl, dragRect, target, getRect(target), evt, after);
 							},
 							changed
 						}, extra));
@@ -1173,8 +1231,8 @@
 								toggleClass(dragEl, putSortable ? putSortable.options.ghostClass : activeSortable.options.ghostClass, false);
 								toggleClass(dragEl, options.ghostClass, true);
 							}
-							if (putSortable !== _this && _this !== Sortable$1.active) putSortable = _this;
-							else if (_this === Sortable$1.active && putSortable) putSortable = null;
+							if (putSortable !== _this && _this !== Sortable.active) putSortable = _this;
+							else if (_this === Sortable.active && putSortable) putSortable = null;
 							if (fromSortable === _this) _this._ignoreWhileAnimating = target;
 							_this.animateAll(function() {
 								dragOverEvent("dragOverAnimationComplete");
@@ -1208,20 +1266,20 @@
 					if (evt.preventDefault !== void 0) evt.cancelable && evt.preventDefault();
 					target = closest(target, options.draggable, el, true);
 					dragOverEvent("dragOver");
-					if (Sortable$1.eventCanceled) return completedFired;
+					if (Sortable.eventCanceled) return completedFired;
 					if (dragEl.contains(evt.target) || target.animated && target.animatingX && target.animatingY || _this._ignoreWhileAnimating === target) return completed(false);
 					ignoreNextClick = false;
 					if (activeSortable && !options.disabled && (isOwner ? canSort || (revert = parentEl !== rootEl) : putSortable === this || (this.lastPutMode = activeGroup.checkPull(this, activeSortable, dragEl, evt)) && group.checkPut(this, activeSortable, dragEl, evt))) {
 						vertical = this._getDirection(evt, target) === "vertical";
 						dragRect = getRect(dragEl);
 						dragOverEvent("dragOverValid");
-						if (Sortable$1.eventCanceled) return completedFired;
+						if (Sortable.eventCanceled) return completedFired;
 						if (revert) {
 							parentEl = rootEl;
 							capture();
 							this._hideClone();
 							dragOverEvent("revert");
-							if (!Sortable$1.eventCanceled) if (nextEl) rootEl.insertBefore(dragEl, nextEl);
+							if (!Sortable.eventCanceled) if (nextEl) rootEl.insertBefore(dragEl, nextEl);
 							else rootEl.appendChild(dragEl);
 							return completed(true);
 						}
@@ -1317,7 +1375,7 @@
 					parentEl = dragEl && dragEl.parentNode;
 					newIndex = index(dragEl);
 					newDraggableIndex = index(dragEl, options.draggable);
-					if (Sortable$1.eventCanceled) {
+					if (Sortable.eventCanceled) {
 						this._nulling();
 						return;
 					}
@@ -1403,7 +1461,7 @@
 									});
 								}
 							}
-							if (Sortable$1.active) {
+							if (Sortable.active) {
 								if (newIndex == null || newIndex === -1) {
 									newIndex = oldIndex;
 									newDraggableIndex = oldDraggableIndex;
@@ -1422,7 +1480,7 @@
 				},
 				_nulling: function _nulling() {
 					pluginEvent("nulling", this);
-					rootEl = dragEl = parentEl = ghostEl = nextEl = cloneEl = lastDownEl = cloneHidden = tapEvt = touchEvt = moved = newIndex = newDraggableIndex = oldIndex = oldDraggableIndex = lastTarget = lastDirection = putSortable = activeGroup = Sortable$1.dragged = Sortable$1.ghost = Sortable$1.clone = Sortable$1.active = null;
+					rootEl = dragEl = parentEl = ghostEl = nextEl = cloneEl = lastDownEl = cloneHidden = tapEvt = touchEvt = moved = newIndex = newDraggableIndex = oldIndex = oldDraggableIndex = lastTarget = lastDirection = putSortable = activeGroup = Sortable.dragged = Sortable.ghost = Sortable.clone = Sortable.active = null;
 					savedInputChecked.forEach(function(el) {
 						el.checked = true;
 					});
@@ -1455,16 +1513,16 @@
 					return order;
 				},
 				sort: function sort(order, useAnimation) {
-					var items = {}, rootEl$1 = this.el;
+					var items = {}, rootEl = this.el;
 					this.toArray().forEach(function(id, i) {
-						var el = rootEl$1.children[i];
-						if (closest(el, this.options.draggable, rootEl$1, false)) items[id] = el;
+						var el = rootEl.children[i];
+						if (closest(el, this.options.draggable, rootEl, false)) items[id] = el;
 					}, this);
 					useAnimation && this.captureAnimationState();
 					order.forEach(function(id) {
 						if (items[id]) {
-							rootEl$1.removeChild(items[id]);
-							rootEl$1.appendChild(items[id]);
+							rootEl.removeChild(items[id]);
+							rootEl.appendChild(items[id]);
 						}
 					});
 					useAnimation && this.animateAll();
@@ -1497,8 +1555,8 @@
 						off(el, "dragover", this);
 						off(el, "dragenter", this);
 					}
-					Array.prototype.forEach.call(el.querySelectorAll("[draggable]"), function(el$1) {
-						el$1.removeAttribute("draggable");
+					Array.prototype.forEach.call(el.querySelectorAll("[draggable]"), function(el) {
+						el.removeAttribute("draggable");
 					});
 					this._onDrop();
 					this._disableDelayedDragEvents();
@@ -1508,20 +1566,20 @@
 				_hideClone: function _hideClone() {
 					if (!cloneHidden) {
 						pluginEvent("hideClone", this);
-						if (Sortable$1.eventCanceled) return;
+						if (Sortable.eventCanceled) return;
 						css(cloneEl, "display", "none");
 						if (this.options.removeCloneOnHide && cloneEl.parentNode) cloneEl.parentNode.removeChild(cloneEl);
 						cloneHidden = true;
 					}
 				},
-				_showClone: function _showClone(putSortable$1) {
-					if (putSortable$1.lastPutMode !== "clone") {
+				_showClone: function _showClone(putSortable) {
+					if (putSortable.lastPutMode !== "clone") {
 						this._hideClone();
 						return;
 					}
 					if (cloneHidden) {
 						pluginEvent("showClone", this);
-						if (Sortable$1.eventCanceled) return;
+						if (Sortable.eventCanceled) return;
 						if (dragEl.parentNode == rootEl && !this.options.group.revertClone) rootEl.insertBefore(cloneEl, dragEl);
 						else if (nextEl) rootEl.insertBefore(cloneEl, nextEl);
 						else rootEl.appendChild(cloneEl);
@@ -1530,12 +1588,12 @@
 						cloneHidden = false;
 					}
 				}
-			};
+			});
 			function _globalDragOver(evt) {
 				if (evt.dataTransfer) evt.dataTransfer.dropEffect = "move";
 				evt.cancelable && evt.preventDefault();
 			}
-			function _onMove(fromEl, toEl, dragEl$2, dragRect, targetEl, targetRect, originalEvent, willInsertAfter) {
+			function _onMove(fromEl, toEl, dragEl, dragRect, targetEl, targetRect, originalEvent, willInsertAfter) {
 				var evt, sortable = fromEl[expando], onMoveFn = sortable.options.onMove, retVal;
 				if (window.CustomEvent && !IE11OrLess && !Edge) evt = new CustomEvent("move", {
 					bubbles: true,
@@ -1547,7 +1605,7 @@
 				}
 				evt.to = toEl;
 				evt.from = fromEl;
-				evt.dragged = dragEl$2;
+				evt.dragged = dragEl;
 				evt.draggedRect = dragRect;
 				evt.related = targetEl || toEl;
 				evt.relatedRect = targetRect || getRect(toEl);
@@ -1591,10 +1649,22 @@
 				}
 				return 0;
 			}
+			/**
+			* Gets the direction dragEl must be swapped relative to target in order to make it
+			* seem that dragEl has been "inserted" into that element's position
+			* @param  {HTMLElement} target       The target whose position dragEl is being inserted at
+			* @return {Number}                   Direction dragEl must be swapped
+			*/
 			function _getInsertDirection(target) {
 				if (index(dragEl) < index(target)) return 1;
 				else return -1;
 			}
+			/**
+			* Generate id
+			* @param   {HTMLElement} el
+			* @returns {String}
+			* @private
+			*/
 			function _generateId(el) {
 				var str = el.tagName + el.className + el.src + el.href + el.textContent, i = str.length, sum = 0;
 				while (i--) sum += str.charCodeAt(i);
@@ -1616,9 +1686,9 @@
 				return clearTimeout(id);
 			}
 			if (documentExists) on(document, "touchmove", function(evt) {
-				if ((Sortable$1.active || awaitingDragStarted) && evt.cancelable) evt.preventDefault();
+				if ((Sortable.active || awaitingDragStarted) && evt.cancelable) evt.preventDefault();
 			});
-			Sortable$1.utils = {
+			Sortable.utils = {
 				on,
 				off,
 				css,
@@ -1638,22 +1708,36 @@
 				getChild,
 				expando
 			};
-			Sortable$1.get = function(element) {
+			/**
+			* Get the Sortable instance of an element
+			* @param  {HTMLElement} element The element
+			* @return {Sortable|undefined}         The instance of Sortable
+			*/
+			Sortable.get = function(element) {
 				return element[expando];
 			};
-			Sortable$1.mount = function() {
-				for (var _len = arguments.length, plugins$1 = new Array(_len), _key = 0; _key < _len; _key++) plugins$1[_key] = arguments[_key];
-				if (plugins$1[0].constructor === Array) plugins$1 = plugins$1[0];
-				plugins$1.forEach(function(plugin) {
+			/**
+			* Mount a plugin to Sortable
+			* @param  {...SortablePlugin|SortablePlugin[]} plugins       Plugins being mounted
+			*/
+			Sortable.mount = function() {
+				for (var _len = arguments.length, plugins = new Array(_len), _key = 0; _key < _len; _key++) plugins[_key] = arguments[_key];
+				if (plugins[0].constructor === Array) plugins = plugins[0];
+				plugins.forEach(function(plugin) {
 					if (!plugin.prototype || !plugin.prototype.constructor) throw "Sortable: Mounted plugin must be a constructor function, not ".concat({}.toString.call(plugin));
-					if (plugin.utils) Sortable$1.utils = _objectSpread2(_objectSpread2({}, Sortable$1.utils), plugin.utils);
+					if (plugin.utils) Sortable.utils = _objectSpread2(_objectSpread2({}, Sortable.utils), plugin.utils);
 					PluginManager.mount(plugin);
 				});
 			};
-			Sortable$1.create = function(el, options) {
-				return new Sortable$1(el, options);
+			/**
+			* Create sortable instance
+			* @param {HTMLElement}  el
+			* @param {Object}      [options]
+			*/
+			Sortable.create = function(el, options) {
+				return new Sortable(el, options);
 			};
-			Sortable$1.version = version;
+			Sortable.version = version;
 			var autoScrolls = [], scrollEl, scrollRootEl, scrolling = false, lastAutoScrollX, lastAutoScrollY, touchEvt$1, pointerElemChangedInterval;
 			function AutoScrollPlugin() {
 				function AutoScroll() {
@@ -1667,7 +1751,7 @@
 					for (var fn in this) if (fn.charAt(0) === "_" && typeof this[fn] === "function") this[fn] = this[fn].bind(this);
 				}
 				AutoScroll.prototype = {
-					dragStarted: function dragStarted$1(_ref) {
+					dragStarted: function dragStarted(_ref) {
 						var originalEvent = _ref.originalEvent;
 						if (this.sortable.nativeDraggable) on(document, "dragover", this._handleAutoScroll);
 						else if (this.options.supportPointer) on(document, "pointermove", this._handleFallbackAutoScroll);
@@ -1678,7 +1762,7 @@
 						var originalEvent = _ref2.originalEvent;
 						if (!this.options.dragOverBubble && !originalEvent.rootEl) this._handleAutoScroll(originalEvent);
 					},
-					drop: function drop$1() {
+					drop: function drop() {
 						if (this.sortable.nativeDraggable) off(document, "dragover", this._handleAutoScroll);
 						else {
 							off(document, "pointermove", this._handleFallbackAutoScroll);
@@ -1731,24 +1815,24 @@
 				});
 			}
 			function clearAutoScrolls() {
-				autoScrolls.forEach(function(autoScroll$1) {
-					clearInterval(autoScroll$1.pid);
+				autoScrolls.forEach(function(autoScroll) {
+					clearInterval(autoScroll.pid);
 				});
 				autoScrolls = [];
 			}
 			function clearPointerElemChangedInterval() {
 				clearInterval(pointerElemChangedInterval);
 			}
-			var autoScroll = throttle(function(evt, options, rootEl$1, isFallback) {
+			var autoScroll = throttle(function(evt, options, rootEl, isFallback) {
 				if (!options.scroll) return;
 				var x = (evt.touches ? evt.touches[0] : evt).clientX, y = (evt.touches ? evt.touches[0] : evt).clientY, sens = options.scrollSensitivity, speed = options.scrollSpeed, winScroller = getWindowScrollingElement();
 				var scrollThisInstance = false, scrollCustomFn;
-				if (scrollRootEl !== rootEl$1) {
-					scrollRootEl = rootEl$1;
+				if (scrollRootEl !== rootEl) {
+					scrollRootEl = rootEl;
 					clearAutoScrolls();
 					scrollEl = options.scroll;
 					scrollCustomFn = options.scrollFn;
-					if (scrollEl === true) scrollEl = getParentAutoScrollElement(rootEl$1, true);
+					if (scrollEl === true) scrollEl = getParentAutoScrollElement(rootEl, true);
 				}
 				var layersOut = 0;
 				var currentParent = scrollEl;
@@ -1774,11 +1858,11 @@
 						if (vx != 0 || vy != 0) {
 							scrollThisInstance = true;
 							autoScrolls[layersOut].pid = setInterval(function() {
-								if (isFallback && this.layer === 0) Sortable$1.active._onTouchMove(touchEvt$1);
+								if (isFallback && this.layer === 0) Sortable.active._onTouchMove(touchEvt$1);
 								var scrollOffsetY = autoScrolls[this.layer].vy ? autoScrolls[this.layer].vy * speed : 0;
 								var scrollOffsetX = autoScrolls[this.layer].vx ? autoScrolls[this.layer].vx * speed : 0;
 								if (typeof scrollCustomFn === "function") {
-									if (scrollCustomFn.call(Sortable$1.dragged.parentNode[expando], scrollOffsetX, scrollOffsetY, evt, touchEvt$1, autoScrolls[this.layer].el) !== "continue") return;
+									if (scrollCustomFn.call(Sortable.dragged.parentNode[expando], scrollOffsetX, scrollOffsetY, evt, touchEvt$1, autoScrolls[this.layer].el) !== "continue") return;
 								}
 								scrollBy(autoScrolls[this.layer].el, scrollOffsetX, scrollOffsetY);
 							}.bind({ layer: layersOut }), 24);
@@ -1788,10 +1872,10 @@
 				} while (options.bubbleScroll && currentParent !== winScroller && (currentParent = getParentAutoScrollElement(currentParent, false)));
 				scrolling = scrollThisInstance;
 			}, 30);
-			var drop = function drop$1(_ref) {
-				var originalEvent = _ref.originalEvent, putSortable$1 = _ref.putSortable, dragEl$2 = _ref.dragEl, activeSortable = _ref.activeSortable, dispatchSortableEvent = _ref.dispatchSortableEvent, hideGhostForTarget = _ref.hideGhostForTarget, unhideGhostForTarget = _ref.unhideGhostForTarget;
+			var drop = function drop(_ref) {
+				var originalEvent = _ref.originalEvent, putSortable = _ref.putSortable, dragEl = _ref.dragEl, activeSortable = _ref.activeSortable, dispatchSortableEvent = _ref.dispatchSortableEvent, hideGhostForTarget = _ref.hideGhostForTarget, unhideGhostForTarget = _ref.unhideGhostForTarget;
 				if (!originalEvent) return;
-				var toSortable = putSortable$1 || activeSortable;
+				var toSortable = putSortable || activeSortable;
 				hideGhostForTarget();
 				var touch = originalEvent.changedTouches && originalEvent.changedTouches.length ? originalEvent.changedTouches[0] : originalEvent;
 				var target = document.elementFromPoint(touch.clientX, touch.clientY);
@@ -1799,8 +1883,8 @@
 				if (toSortable && !toSortable.el.contains(target)) {
 					dispatchSortableEvent("spill");
 					this.onSpill({
-						dragEl: dragEl$2,
-						putSortable: putSortable$1
+						dragEl,
+						putSortable
 					});
 				}
 			};
@@ -1811,14 +1895,14 @@
 					this.startIndex = _ref2.oldDraggableIndex;
 				},
 				onSpill: function onSpill(_ref3) {
-					var dragEl$2 = _ref3.dragEl, putSortable$1 = _ref3.putSortable;
+					var dragEl = _ref3.dragEl, putSortable = _ref3.putSortable;
 					this.sortable.captureAnimationState();
-					if (putSortable$1) putSortable$1.captureAnimationState();
+					if (putSortable) putSortable.captureAnimationState();
 					var nextSibling = getChild(this.sortable.el, this.startIndex, this.options);
-					if (nextSibling) this.sortable.el.insertBefore(dragEl$2, nextSibling);
-					else this.sortable.el.appendChild(dragEl$2);
+					if (nextSibling) this.sortable.el.insertBefore(dragEl, nextSibling);
+					else this.sortable.el.appendChild(dragEl);
 					this.sortable.animateAll();
-					if (putSortable$1) putSortable$1.animateAll();
+					if (putSortable) putSortable.animateAll();
 				},
 				drop
 			};
@@ -1826,10 +1910,10 @@
 			function Remove() {}
 			Remove.prototype = {
 				onSpill: function onSpill(_ref4) {
-					var dragEl$2 = _ref4.dragEl;
+					var dragEl = _ref4.dragEl;
 					var parentSortable = _ref4.putSortable || this.sortable;
 					parentSortable.captureAnimationState();
-					dragEl$2.parentNode && dragEl$2.parentNode.removeChild(dragEl$2);
+					dragEl.parentNode && dragEl.parentNode.removeChild(dragEl);
 					parentSortable.animateAll();
 				},
 				drop
@@ -1860,16 +1944,16 @@
 						completed(true);
 						cancel();
 					},
-					drop: function drop$1(_ref3) {
-						var activeSortable = _ref3.activeSortable, putSortable$1 = _ref3.putSortable, dragEl$2 = _ref3.dragEl;
-						var toSortable = putSortable$1 || this.sortable;
+					drop: function drop(_ref3) {
+						var activeSortable = _ref3.activeSortable, putSortable = _ref3.putSortable, dragEl = _ref3.dragEl;
+						var toSortable = putSortable || this.sortable;
 						var options = this.options;
 						lastSwapEl && toggleClass(lastSwapEl, options.swapClass, false);
-						if (lastSwapEl && (options.swap || putSortable$1 && putSortable$1.options.swap)) {
-							if (dragEl$2 !== lastSwapEl) {
+						if (lastSwapEl && (options.swap || putSortable && putSortable.options.swap)) {
+							if (dragEl !== lastSwapEl) {
 								toSortable.captureAnimationState();
 								if (toSortable !== activeSortable) activeSortable.captureAnimationState();
-								swapNodes(dragEl$2, lastSwapEl);
+								swapNodes(dragEl, lastSwapEl);
 								toSortable.animateAll();
 								if (toSortable !== activeSortable) activeSortable.animateAll();
 							}
@@ -1910,12 +1994,12 @@
 						selectedClass: "sortable-selected",
 						multiDragKey: null,
 						avoidImplicitDeselect: false,
-						setData: function setData(dataTransfer, dragEl$2) {
+						setData: function setData(dataTransfer, dragEl) {
 							var data = "";
 							if (multiDragElements.length && multiDragSortable === sortable) multiDragElements.forEach(function(multiDragElement, i) {
 								data += (!i ? "" : ", ") + multiDragElement.textContent;
 							});
-							else data = dragEl$2.textContent;
+							else data = dragEl.textContent;
 							dataTransfer.setData("Text", data);
 						}
 					};
@@ -1943,23 +2027,23 @@
 						sortable._hideClone();
 						cancel();
 					},
-					clone: function clone$1(_ref3) {
-						var sortable = _ref3.sortable, rootEl$1 = _ref3.rootEl, dispatchSortableEvent = _ref3.dispatchSortableEvent, cancel = _ref3.cancel;
+					clone: function clone(_ref3) {
+						var sortable = _ref3.sortable, rootEl = _ref3.rootEl, dispatchSortableEvent = _ref3.dispatchSortableEvent, cancel = _ref3.cancel;
 						if (!this.isMultiDrag) return;
 						if (!this.options.removeCloneOnHide) {
 							if (multiDragElements.length && multiDragSortable === sortable) {
-								insertMultiDragClones(true, rootEl$1);
+								insertMultiDragClones(true, rootEl);
 								dispatchSortableEvent("clone");
 								cancel();
 							}
 						}
 					},
 					showClone: function showClone(_ref4) {
-						var cloneNowShown = _ref4.cloneNowShown, rootEl$1 = _ref4.rootEl, cancel = _ref4.cancel;
+						var cloneNowShown = _ref4.cloneNowShown, rootEl = _ref4.rootEl, cancel = _ref4.cancel;
 						if (!this.isMultiDrag) return;
-						insertMultiDragClones(false, rootEl$1);
-						multiDragClones.forEach(function(clone$1) {
-							css(clone$1, "display", "");
+						insertMultiDragClones(false, rootEl);
+						multiDragClones.forEach(function(clone) {
+							css(clone, "display", "");
 						});
 						cloneNowShown();
 						clonesHidden = false;
@@ -1970,9 +2054,9 @@
 						_ref5.sortable;
 						var cloneNowHidden = _ref5.cloneNowHidden, cancel = _ref5.cancel;
 						if (!this.isMultiDrag) return;
-						multiDragClones.forEach(function(clone$1) {
-							css(clone$1, "display", "none");
-							if (_this.options.removeCloneOnHide && clone$1.parentNode) clone$1.parentNode.removeChild(clone$1);
+						multiDragClones.forEach(function(clone) {
+							css(clone, "display", "none");
+							if (_this.options.removeCloneOnHide && clone.parentNode) clone.parentNode.removeChild(clone);
 						});
 						cloneNowHidden();
 						clonesHidden = true;
@@ -1989,7 +2073,7 @@
 						});
 						dragStarted = true;
 					},
-					dragStarted: function dragStarted$1(_ref7) {
+					dragStarted: function dragStarted(_ref7) {
 						var _this2 = this;
 						var sortable = _ref7.sortable;
 						if (!this.isMultiDrag) return;
@@ -2026,7 +2110,7 @@
 						}
 					},
 					revert: function revert(_ref9) {
-						var fromSortable = _ref9.fromSortable, rootEl$1 = _ref9.rootEl, sortable = _ref9.sortable, dragRect = _ref9.dragRect;
+						var fromSortable = _ref9.fromSortable, rootEl = _ref9.rootEl, sortable = _ref9.sortable, dragRect = _ref9.dragRect;
 						if (multiDragElements.length > 1) {
 							multiDragElements.forEach(function(multiDragElement) {
 								sortable.addAnimationState({
@@ -2038,21 +2122,21 @@
 								fromSortable.removeAnimationState(multiDragElement);
 							});
 							folding = false;
-							insertMultiDragElements(!this.options.removeCloneOnHide, rootEl$1);
+							insertMultiDragElements(!this.options.removeCloneOnHide, rootEl);
 						}
 					},
 					dragOverCompleted: function dragOverCompleted(_ref10) {
-						var sortable = _ref10.sortable, isOwner = _ref10.isOwner, insertion = _ref10.insertion, activeSortable = _ref10.activeSortable, parentEl$1 = _ref10.parentEl, putSortable$1 = _ref10.putSortable;
+						var sortable = _ref10.sortable, isOwner = _ref10.isOwner, insertion = _ref10.insertion, activeSortable = _ref10.activeSortable, parentEl = _ref10.parentEl, putSortable = _ref10.putSortable;
 						var options = this.options;
 						if (insertion) {
 							if (isOwner) activeSortable._hideClone();
 							initialFolding = false;
-							if (options.animation && multiDragElements.length > 1 && (folding || !isOwner && !activeSortable.options.sort && !putSortable$1)) {
+							if (options.animation && multiDragElements.length > 1 && (folding || !isOwner && !activeSortable.options.sort && !putSortable)) {
 								var dragRectAbsolute = getRect(dragEl$1, false, true, true);
 								multiDragElements.forEach(function(multiDragElement) {
 									if (multiDragElement === dragEl$1) return;
 									setRect(multiDragElement, dragRectAbsolute);
-									parentEl$1.appendChild(multiDragElement);
+									parentEl.appendChild(multiDragElement);
 								});
 								folding = true;
 							}
@@ -2061,13 +2145,13 @@
 								if (multiDragElements.length > 1) {
 									var clonesHiddenBefore = clonesHidden;
 									activeSortable._showClone(sortable);
-									if (activeSortable.options.animation && !clonesHidden && clonesHiddenBefore) multiDragClones.forEach(function(clone$1) {
+									if (activeSortable.options.animation && !clonesHidden && clonesHiddenBefore) multiDragClones.forEach(function(clone) {
 										activeSortable.addAnimationState({
-											target: clone$1,
+											target: clone,
 											rect: clonesFromRect
 										});
-										clone$1.fromRect = clonesFromRect;
-										clone$1.thisAnimationDuration = null;
+										clone.fromRect = clonesFromRect;
+										clone.thisAnimationDuration = null;
 									});
 								} else activeSortable._showClone(sortable);
 							}
@@ -2091,11 +2175,11 @@
 							removeMultiDragElements();
 						}
 					},
-					drop: function drop$1(_ref12) {
-						var evt = _ref12.originalEvent, rootEl$1 = _ref12.rootEl, parentEl$1 = _ref12.parentEl, sortable = _ref12.sortable, dispatchSortableEvent = _ref12.dispatchSortableEvent, oldIndex$1 = _ref12.oldIndex, putSortable$1 = _ref12.putSortable;
-						var toSortable = putSortable$1 || this.sortable;
+					drop: function drop(_ref12) {
+						var evt = _ref12.originalEvent, rootEl = _ref12.rootEl, parentEl = _ref12.parentEl, sortable = _ref12.sortable, dispatchSortableEvent = _ref12.dispatchSortableEvent, oldIndex = _ref12.oldIndex, putSortable = _ref12.putSortable;
+						var toSortable = putSortable || this.sortable;
 						if (!evt) return;
-						var options = this.options, children = parentEl$1.children;
+						var options = this.options, children = parentEl.children;
 						if (!dragStarted) {
 							if (options.multiDragKey && !this.multiDragKeyDown) this._deselectMultiDrag();
 							toggleClass(dragEl$1, options.selectedClass, !~multiDragElements.indexOf(dragEl$1));
@@ -2103,7 +2187,7 @@
 								multiDragElements.push(dragEl$1);
 								dispatchEvent({
 									sortable,
-									rootEl: rootEl$1,
+									rootEl,
 									name: "select",
 									targetEl: dragEl$1,
 									originalEvent: evt
@@ -2122,15 +2206,15 @@
 										var filter = options.filter;
 										for (; i < n; i++) {
 											if (~multiDragElements.indexOf(children[i])) continue;
-											if (!closest(children[i], options.draggable, parentEl$1, false)) continue;
+											if (!closest(children[i], options.draggable, parentEl, false)) continue;
 											if (filter && (typeof filter === "function" ? filter.call(sortable, evt, children[i], sortable) : filter.split(",").some(function(criteria) {
-												return closest(children[i], criteria.trim(), parentEl$1, false);
+												return closest(children[i], criteria.trim(), parentEl, false);
 											}))) continue;
 											toggleClass(children[i], options.selectedClass, true);
 											multiDragElements.push(children[i]);
 											dispatchEvent({
 												sortable,
-												rootEl: rootEl$1,
+												rootEl,
 												name: "select",
 												targetEl: children[i],
 												originalEvent: evt
@@ -2144,7 +2228,7 @@
 								lastMultiDragSelect = null;
 								dispatchEvent({
 									sortable,
-									rootEl: rootEl$1,
+									rootEl,
 									name: "deselect",
 									targetEl: dragEl$1,
 									originalEvent: evt
@@ -2153,7 +2237,7 @@
 						}
 						if (dragStarted && this.isMultiDrag) {
 							folding = false;
-							if ((parentEl$1[expando].options.sort || parentEl$1 !== rootEl$1) && multiDragElements.length > 1) {
+							if ((parentEl[expando].options.sort || parentEl !== rootEl) && multiDragElements.length > 1) {
 								var dragRect = getRect(dragEl$1), multiDragIndex = index(dragEl$1, ":not(." + this.options.selectedClass + ")");
 								if (!initialFolding && options.animation) dragEl$1.thisAnimationDuration = null;
 								toSortable.captureAnimationState();
@@ -2174,11 +2258,11 @@
 									}
 									removeMultiDragElements();
 									multiDragElements.forEach(function(multiDragElement) {
-										if (children[multiDragIndex]) parentEl$1.insertBefore(multiDragElement, children[multiDragIndex]);
-										else parentEl$1.appendChild(multiDragElement);
+										if (children[multiDragIndex]) parentEl.insertBefore(multiDragElement, children[multiDragIndex]);
+										else parentEl.appendChild(multiDragElement);
 										multiDragIndex++;
 									});
-									if (oldIndex$1 === index(dragEl$1)) {
+									if (oldIndex === index(dragEl$1)) {
 										var update = false;
 										multiDragElements.forEach(function(multiDragElement) {
 											if (multiDragElement.sortableIndex !== index(multiDragElement)) {
@@ -2199,8 +2283,8 @@
 							}
 							multiDragSortable = toSortable;
 						}
-						if (rootEl$1 === parentEl$1 || putSortable$1 && putSortable$1.lastPutMode !== "clone") multiDragClones.forEach(function(clone$1) {
-							clone$1.parentNode && clone$1.parentNode.removeChild(clone$1);
+						if (rootEl === parentEl || putSortable && putSortable.lastPutMode !== "clone") multiDragClones.forEach(function(clone) {
+							clone.parentNode && clone.parentNode.removeChild(clone);
 						});
 					},
 					nullingGlobal: function nullingGlobal() {
@@ -2254,10 +2338,10 @@
 							multiDragElements.push(el);
 						},
 						deselect: function deselect(el) {
-							var sortable = el.parentNode[expando], index$1 = multiDragElements.indexOf(el);
-							if (!sortable || !sortable.options.multiDrag || !~index$1) return;
+							var sortable = el.parentNode[expando], index = multiDragElements.indexOf(el);
+							if (!sortable || !sortable.options.multiDrag || !~index) return;
 							toggleClass(el, sortable.options.selectedClass, false);
-							multiDragElements.splice(index$1, 1);
+							multiDragElements.splice(index, 1);
 						}
 					},
 					eventProperties: function eventProperties() {
@@ -2268,13 +2352,13 @@
 								multiDragElement,
 								index: multiDragElement.sortableIndex
 							});
-							var newIndex$1;
-							if (folding && multiDragElement !== dragEl$1) newIndex$1 = -1;
-							else if (folding) newIndex$1 = index(multiDragElement, ":not(." + _this3.options.selectedClass + ")");
-							else newIndex$1 = index(multiDragElement);
+							var newIndex;
+							if (folding && multiDragElement !== dragEl$1) newIndex = -1;
+							else if (folding) newIndex = index(multiDragElement, ":not(." + _this3.options.selectedClass + ")");
+							else newIndex = index(multiDragElement);
 							newIndicies.push({
 								multiDragElement,
-								index: newIndex$1
+								index: newIndex
 							});
 						});
 						return {
@@ -2292,18 +2376,23 @@
 					} }
 				});
 			}
-			function insertMultiDragElements(clonesInserted, rootEl$1) {
+			function insertMultiDragElements(clonesInserted, rootEl) {
 				multiDragElements.forEach(function(multiDragElement, i) {
-					var target = rootEl$1.children[multiDragElement.sortableIndex + (clonesInserted ? Number(i) : 0)];
-					if (target) rootEl$1.insertBefore(multiDragElement, target);
-					else rootEl$1.appendChild(multiDragElement);
+					var target = rootEl.children[multiDragElement.sortableIndex + (clonesInserted ? Number(i) : 0)];
+					if (target) rootEl.insertBefore(multiDragElement, target);
+					else rootEl.appendChild(multiDragElement);
 				});
 			}
-			function insertMultiDragClones(elementsInserted, rootEl$1) {
-				multiDragClones.forEach(function(clone$1, i) {
-					var target = rootEl$1.children[clone$1.sortableIndex + (elementsInserted ? Number(i) : 0)];
-					if (target) rootEl$1.insertBefore(clone$1, target);
-					else rootEl$1.appendChild(clone$1);
+			/**
+			* Insert multi-drag clones
+			* @param  {[Boolean]} elementsInserted  Whether the multi-drag elements are inserted
+			* @param  {HTMLElement} rootEl
+			*/
+			function insertMultiDragClones(elementsInserted, rootEl) {
+				multiDragClones.forEach(function(clone, i) {
+					var target = rootEl.children[clone.sortableIndex + (elementsInserted ? Number(i) : 0)];
+					if (target) rootEl.insertBefore(clone, target);
+					else rootEl.appendChild(clone);
 				});
 			}
 			function removeMultiDragElements() {
@@ -2312,24 +2401,128 @@
 					multiDragElement.parentNode && multiDragElement.parentNode.removeChild(multiDragElement);
 				});
 			}
-			Sortable$1.mount(new AutoScrollPlugin());
-			Sortable$1.mount(Remove, Revert);
-			Sortable$1.mount(new SwapPlugin());
-			Sortable$1.mount(new MultiDragPlugin());
-			return Sortable$1;
+			Sortable.mount(new AutoScrollPlugin());
+			Sortable.mount(Remove, Revert);
+			Sortable.mount(new SwapPlugin());
+			Sortable.mount(new MultiDragPlugin());
+			return Sortable;
 		}));
 	})))());
-	const DEFAULT_EXACT_SEARCH_KEY = "bk_username";
-	const USER_TYPE = {
+	/** 默认精确搜索字段 */
+	var DEFAULT_EXACT_SEARCH_KEY = "bk_username";
+	/** 用户类型 */
+	var USER_TYPE = {
 		USER: "user",
 		VIRTUAL: "virtual",
 		CUSTOM: "custom",
 		USER_GROUP: "userGroup"
 	};
+	//#endregion
+	//#region src/hooks/use-api-config.ts
+	var API_CONFIG_KEY = Symbol("bkUserSelectorApiConfig");
+	var TENANT_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+	var globalApiConfig = {
+		apiBaseUrl: "",
+		tenantId: "",
+		allowedApiOrigins: [],
+		allowPrivateApiHost: false,
+		allowCrossOriginCredentials: false
+	};
+	var getCurrentOrigin = () => {
+		if (typeof window === "undefined" || !window.location?.origin) return "http://localhost";
+		return window.location.origin;
+	};
+	var isPrivateIpv4 = (hostname) => {
+		const segments = hostname.split(".").map(Number);
+		if (segments.length !== 4 || segments.some(Number.isNaN)) return false;
+		const [a, b] = segments;
+		if (a === 10 || a === 127) return true;
+		if (a === 172 && b >= 16 && b <= 31) return true;
+		if (a === 192 && b === 168) return true;
+		if (a === 169 && b === 254) return true;
+		if (a === 100 && b >= 64 && b <= 127) return true;
+		return false;
+	};
+	var isPrivateHost = (hostname) => {
+		const normalizedHost = hostname.toLowerCase();
+		if (normalizedHost === "localhost" || normalizedHost === "[::1]" || normalizedHost === "::1") return true;
+		if (isPrivateIpv4(normalizedHost)) return true;
+		if (normalizedHost.startsWith("fc") || normalizedHost.startsWith("fd")) return true;
+		return false;
+	};
+	var normalizeAllowedOrigins = (allowedApiOrigins = []) => {
+		const currentOrigin = getCurrentOrigin();
+		return Array.from(new Set(allowedApiOrigins.map((origin) => {
+			try {
+				const parsed = new URL(origin, currentOrigin);
+				if (!["http:", "https:"].includes(parsed.protocol)) return "";
+				return parsed.origin;
+			} catch {
+				return "";
+			}
+		}).filter(Boolean)));
+	};
+	var sanitizeApiBaseUrl = (apiBaseUrl, allowedApiOrigins = [], allowPrivateApiHost = false) => {
+		if (!apiBaseUrl) return "";
+		try {
+			const parsed = new URL(apiBaseUrl, getCurrentOrigin());
+			if (!["http:", "https:"].includes(parsed.protocol)) {
+				console.warn("[bk-user-selector] apiBaseUrl 仅支持 http/https 协议");
+				return "";
+			}
+			if (!allowPrivateApiHost && isPrivateHost(parsed.hostname)) {
+				console.warn("[bk-user-selector] apiBaseUrl 指向私网或 localhost，已被安全策略拦截");
+				return "";
+			}
+			const normalizedAllowedOrigins = normalizeAllowedOrigins(allowedApiOrigins);
+			if (normalizedAllowedOrigins.length > 0 && !normalizedAllowedOrigins.includes(parsed.origin)) {
+				console.warn("[bk-user-selector] apiBaseUrl 未命中 allowedApiOrigins 白名单，已被安全策略拦截");
+				return "";
+			}
+			const normalizedPath = parsed.pathname.replace(/\/+$/, "");
+			return `${parsed.origin}${normalizedPath}`;
+		} catch {
+			console.warn("[bk-user-selector] apiBaseUrl 格式非法，已被安全策略拦截");
+			return "";
+		}
+	};
+	var sanitizeTenantId = (tenantId) => {
+		const normalizedTenantId = String(tenantId || "").trim();
+		if (!normalizedTenantId) return "";
+		if (!TENANT_ID_PATTERN.test(normalizedTenantId)) {
+			console.warn("[bk-user-selector] tenantId 格式非法，已被安全策略拦截");
+			return "";
+		}
+		return normalizedTenantId;
+	};
+	var getApiConfig = () => {
+		return globalApiConfig;
+	};
+	var provideApiConfig = (apiBaseUrl, tenantId, allowedApiOrigins = [], allowPrivateApiHost = false, allowCrossOriginCredentials = false, callbacks = {}) => {
+		const normalizedAllowedOrigins = normalizeAllowedOrigins(allowedApiOrigins);
+		globalApiConfig = {
+			apiBaseUrl: sanitizeApiBaseUrl(apiBaseUrl, normalizedAllowedOrigins, allowPrivateApiHost),
+			tenantId: sanitizeTenantId(tenantId),
+			allowedApiOrigins: normalizedAllowedOrigins,
+			allowPrivateApiHost,
+			allowCrossOriginCredentials,
+			onError: callbacks.onError,
+			onUnauthorized: callbacks.onUnauthorized
+		};
+		(0, vue.provide)(API_CONFIG_KEY, globalApiConfig);
+	};
+	//#endregion
+	//#region src/hooks/use-jsonp.ts
+	/**
+	* 生成回调函数名
+	*/
 	var generateCallbackName = () => {
 		return `__jsonp_callback_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
 	};
-	const jsonpRequest = (requestUrl, options = {}) => {
+	/**
+	* JSONP 请求函数
+	*/
+	var jsonpRequest = (requestUrl, options = {}) => {
 		return new Promise((resolve, reject) => {
 			const url = (0, vue.unref)(requestUrl);
 			const { timeout = 1e3 * 60 * 2, params } = options;
@@ -2358,6 +2551,8 @@
 			document.head.appendChild(script);
 		});
 	};
+	//#endregion
+	//#region src/utils/logger.ts
 	var PREFIX = "[BkUserSelector]";
 	var LOG_LEVELS = {
 		debug: 0,
@@ -2369,10 +2564,16 @@
 		enabled: true,
 		level: "warn"
 	};
+	/**
+	* 检查是否应该输出日志
+	*/
 	var shouldLog = (level) => {
 		return config.enabled && LOG_LEVELS[level] >= LOG_LEVELS[config.level];
 	};
-	const logger = {
+	/**
+	* 日志工具
+	*/
+	var logger = {
 		debug: (message, ...args) => {
 			if (shouldLog("debug")) console.debug(`${PREFIX} ${message}`, ...args);
 		},
@@ -2386,32 +2587,132 @@
 			if (shouldLog("error")) console.error(`${PREFIX} ${message}`, error);
 		}
 	};
-	const handleApiError = (operation, error) => {
-		logger.error(`${operation}失败:`, error);
+	/**
+	* 安全调用用户回调
+	* 用户回调如果抛错不应影响组件正常流程
+	*/
+	var safeInvoke = (handler, error) => {
+		if (!handler) return;
+		try {
+			handler(error);
+		} catch (err) {
+			console.error(`${PREFIX} error handler threw:`, err);
+		}
 	};
-	const warnMissingParams = (operation, params) => {
+	/**
+	* 构造 ApiError 对象
+	*/
+	var buildApiError = (scene, cause, status, isUnauthorized = false) => ({
+		scene,
+		cause,
+		status,
+		isUnauthorized
+	});
+	/**
+	* API 错误处理
+	* - 打印错误日志（兜底）
+	* - 触发 apiConfig.onError 回调
+	* - 如果是 401，额外触发 apiConfig.onUnauthorized 回调
+	*/
+	var handleApiError = (operation, error, apiConfig, status, isUnauthorized = false) => {
+		if (isUnauthorized) logger.warn(`${operation}: 登录态已失效，请重新登录`);
+		else logger.error(`${operation}失败:`, error);
+		const apiError = buildApiError(operation, error, status, isUnauthorized);
+		if (isUnauthorized) safeInvoke(apiConfig?.onUnauthorized, apiError);
+		safeInvoke(apiConfig?.onError, apiError);
+	};
+	/**
+	* 参数校验警告
+	*/
+	var warnMissingParams = (operation, params) => {
 		logger.warn(`${operation}需要提供有效的参数: ${params.join(", ")}`);
 	};
-	const getTenants = async (apiBaseUrl, tenantId) => {
-		if (!apiBaseUrl || !tenantId) {
+	//#endregion
+	//#region src/api/user.ts
+	/**
+	* 用户选择器相关API
+	* @module api/user
+	*/
+	var UNAUTHORIZED_STATUS = 401;
+	var resolveRequestCredentials = (url, allowCrossOriginCredentials) => {
+		if (typeof window === "undefined" || !window.location?.origin) return "same-origin";
+		try {
+			if (new URL(url, window.location.origin).origin === window.location.origin) return "include";
+			return allowCrossOriginCredentials ? "include" : "omit";
+		} catch {
+			return "same-origin";
+		}
+	};
+	var resolveApiSecurityConfig = (apiBaseUrl, tenantId) => {
+		const globalConfig = getApiConfig();
+		const resolvedAllowPrivateApiHost = globalConfig.allowPrivateApiHost;
+		const resolvedAllowedApiOrigins = globalConfig.allowedApiOrigins;
+		return {
+			allowCrossOriginCredentials: globalConfig.allowCrossOriginCredentials,
+			apiBaseUrl: sanitizeApiBaseUrl(globalConfig.apiBaseUrl || apiBaseUrl, resolvedAllowedApiOrigins, resolvedAllowPrivateApiHost),
+			tenantId: sanitizeTenantId(globalConfig.tenantId || tenantId),
+			apiConfig: globalConfig
+		};
+	};
+	/**
+	* 统一处理响应状态码，401 时构造 ApiError 并触发回调，然后抛出错误
+	*/
+	var ensureResponseOk = (response, scene, apiConfig) => {
+		if (response.ok) return;
+		if (response.status === UNAUTHORIZED_STATUS) {
+			const error = /* @__PURE__ */ new Error(`${scene}失败: 登录态已失效`);
+			handleApiError(scene, error, apiConfig, response.status, true);
+			throw error;
+		}
+		throw new Error(`${response.status} ${response.statusText}`);
+	};
+	/**
+	* 从抛出的错误中尽力提取 HTTP 状态码
+	*/
+	var extractStatus = (error) => {
+		if (typeof error === "object" && error !== null && "status" in error) {
+			const status = error.status;
+			return typeof status === "number" ? status : void 0;
+		}
+		if (error instanceof Error) {
+			const match = /^(\d{3})\s/.exec(error.message);
+			if (match) return Number(match[1]);
+		}
+	};
+	/**
+	* 获取本租户所有数据来源的租户信息
+	* @param apiBaseUrl - API基础URL
+	* @param tenantId - 租户ID
+	* @returns 租户列表Promise
+	*/
+	var getTenants = async (apiBaseUrl, tenantId) => {
+		const resolvedConfig = resolveApiSecurityConfig(apiBaseUrl, tenantId);
+		if (!resolvedConfig.apiBaseUrl || !resolvedConfig.tenantId) {
 			warnMissingParams("获取租户信息", ["apiBaseUrl", "tenantId"]);
 			return [];
 		}
 		try {
-			const url = `${apiBaseUrl}/api/v3/open-web/tenant/data-source-owner-tenants/`;
+			const url = `${resolvedConfig.apiBaseUrl}/api/v3/open-web/tenant/data-source-owner-tenants/`;
+			const requestCredentials = resolveRequestCredentials(url, resolvedConfig.allowCrossOriginCredentials);
 			const response = await fetch(url, {
 				method: "GET",
-				headers: { "x-bk-tenant-id": tenantId },
-				credentials: "include"
+				headers: { "x-bk-tenant-id": resolvedConfig.tenantId },
+				credentials: requestCredentials
 			});
-			if (!response.ok) throw new Error(`${response.status} ${response.statusText}`);
+			ensureResponseOk(response, "获取租户信息", resolvedConfig.apiConfig);
 			return (await response.json()).data || [];
 		} catch (error) {
-			handleApiError("获取租户信息", error);
+			const status = extractStatus(error);
+			if (status !== UNAUTHORIZED_STATUS) handleApiError("获取租户信息", error, resolvedConfig.apiConfig, status, false);
 			return [];
 		}
 	};
-	const searchUsers = async (params) => {
+	/**
+	* 模糊搜索用户
+	* @param params - 搜索参数
+	* @returns 用户列表Promise
+	*/
+	var searchUsers = async (params) => {
 		const { apiBaseUrl, tenantId, keyword, enableMultiTenantMode = true } = params;
 		if (!enableMultiTenantMode) try {
 			return await getUserList(apiBaseUrl, {
@@ -2422,7 +2723,8 @@
 		} catch {
 			return [];
 		}
-		if (!keyword || !apiBaseUrl || !tenantId) {
+		const resolvedConfig = resolveApiSecurityConfig(apiBaseUrl, tenantId);
+		if (!keyword || !resolvedConfig.apiBaseUrl || !resolvedConfig.tenantId) {
 			warnMissingParams("搜索用户", [
 				"apiBaseUrl",
 				"tenantId",
@@ -2431,20 +2733,27 @@
 			return [];
 		}
 		try {
-			const url = `${apiBaseUrl}/api/v3/open-web/tenant/users/-/search/?keyword=${encodeURIComponent(keyword)}`;
+			const url = `${resolvedConfig.apiBaseUrl}/api/v3/open-web/tenant/users/-/search/?keyword=${encodeURIComponent(keyword)}`;
+			const requestCredentials = resolveRequestCredentials(url, resolvedConfig.allowCrossOriginCredentials);
 			const response = await fetch(url, {
 				method: "GET",
-				headers: { "x-bk-tenant-id": tenantId },
-				credentials: "include"
+				headers: { "x-bk-tenant-id": resolvedConfig.tenantId },
+				credentials: requestCredentials
 			});
-			if (!response.ok) throw new Error(`${response.status} ${response.statusText}`);
+			ensureResponseOk(response, "搜索用户", resolvedConfig.apiConfig);
 			return (await response.json()).data || [];
 		} catch (error) {
-			handleApiError("搜索用户", error);
+			const status = extractStatus(error);
+			if (status !== UNAUTHORIZED_STATUS) handleApiError("搜索用户", error, resolvedConfig.apiConfig, status, false);
 			return [];
 		}
 	};
-	const lookupUsers = async (params) => {
+	/**
+	* 批量精准查找用户
+	* @param params - 查找参数
+	* @returns 查找到的用户列表Promise
+	*/
+	var lookupUsers = async (params) => {
 		const { apiBaseUrl, tenantId, exactSearchKey = "bk_username", usersList = [], enableMultiTenantMode = true } = params;
 		const users = usersList.filter(Boolean).map((user) => typeof user === "string" ? user.trim() : String(user).trim());
 		if (!enableMultiTenantMode) try {
@@ -2453,7 +2762,8 @@
 		} catch {
 			return [];
 		}
-		if (users.length === 0 || !apiBaseUrl || !tenantId) {
+		const resolvedConfig = resolveApiSecurityConfig(apiBaseUrl, tenantId);
+		if (users.length === 0 || !resolvedConfig.apiBaseUrl || !resolvedConfig.tenantId) {
 			warnMissingParams("批量查找用户", [
 				"apiBaseUrl",
 				"tenantId",
@@ -2462,20 +2772,27 @@
 			return [];
 		}
 		try {
-			const url = `${apiBaseUrl}/api/v3/open-web/tenant/users/-/lookup/?lookups=${users.join(",")}&lookup_fields=${exactSearchKey}`;
+			const url = `${resolvedConfig.apiBaseUrl}/api/v3/open-web/tenant/users/-/lookup/?lookups=${users.join(",")}&lookup_fields=${exactSearchKey}`;
+			const requestCredentials = resolveRequestCredentials(url, resolvedConfig.allowCrossOriginCredentials);
 			const response = await fetch(url, {
 				method: "GET",
-				headers: { "x-bk-tenant-id": tenantId },
-				credentials: "include"
+				headers: { "x-bk-tenant-id": resolvedConfig.tenantId },
+				credentials: requestCredentials
 			});
-			if (!response.ok) throw new Error(`${response.status} ${response.statusText}`);
+			ensureResponseOk(response, "批量查找用户", resolvedConfig.apiConfig);
 			return (await response.json()).data || [];
 		} catch (error) {
-			handleApiError("批量查找用户", error);
+			const status = extractStatus(error);
+			if (status !== UNAUTHORIZED_STATUS) handleApiError("批量查找用户", error, resolvedConfig.apiConfig, status, false);
 			return [];
 		}
 	};
-	const formatUsers = (users, enableMultiTenantMode = true) => {
+	/**
+	* 将API返回的用户数据格式化为组件所需格式
+	* @param users - API返回的用户列表
+	* @returns 格式化后的用户列表
+	*/
+	var formatUsers = (users, enableMultiTenantMode = true) => {
 		if (!users || !Array.isArray(users)) return [];
 		if (!enableMultiTenantMode) return users.map((user) => ({
 			...user,
@@ -2492,7 +2809,13 @@
 			...user
 		}));
 	};
-	const getUserList = async (url, params) => {
+	/**
+	* 获取用户列表（兼容旧版本的人员选择器）
+	* @param url - 请求的 URL
+	* @param params - 请求参数
+	* @returns 用户列表
+	*/
+	var getUserList = async (url, params) => {
 		const { userIds, keyword, pageSize = 20, page = 1, appCode = "bk-magicbox" } = params;
 		return (await jsonpRequest(url, { params: {
 			exact_lookups: userIds?.join(",") || void 0,
@@ -2502,9 +2825,23 @@
 			app_code: appCode
 		} }))?.results || [];
 	};
-	const useCurrentUser = (options) => {
+	//#endregion
+	//#region src/hooks/use-current-user.ts
+	/**
+	* 当前用户处理 Hook
+	* @module hooks/useCurrentUser
+	*/
+	/**
+	* 当前用户处理 Hook
+	* @param options - 配置选项
+	* @returns 当前用户相关方法
+	*/
+	var useCurrentUser = (options) => {
 		const { apiBaseUrl, tenantId, currentUserId, exactSearchKey = DEFAULT_EXACT_SEARCH_KEY, enableMultiTenantMode = true } = options;
 		const loading = (0, vue.ref)(false);
+		/**
+		* 获取当前用户信息
+		*/
 		const fetchCurrentUser = async () => {
 			if (!currentUserId) return null;
 			loading.value = true;
@@ -2529,6 +2866,9 @@
 			fetchCurrentUser
 		};
 	};
+	//#endregion
+	//#region ../../node_modules/.pnpm/js-cookie@3.0.5/node_modules/js-cookie/dist/js.cookie.mjs
+	/*! js-cookie v3.0.5 | MIT */
 	function assign(target) {
 		for (var i = 1; i < arguments.length; i++) {
 			var source = arguments[i];
@@ -2585,8 +2925,8 @@
 			withAttributes: function(attributes) {
 				return init(this.converter, assign({}, this.attributes, attributes));
 			},
-			withConverter: function(converter$1) {
-				return init(assign({}, this.converter, converter$1), this.attributes);
+			withConverter: function(converter) {
+				return init(assign({}, this.converter, converter), this.attributes);
 			}
 		}, {
 			attributes: { value: Object.freeze(defaultAttributes) },
@@ -2594,22 +2934,30 @@
 		});
 	}
 	var api = init(defaultConverter, { path: "/" });
+	//#endregion
+	//#region src/locale/en-us.ts
 	var en_us_default = {
 		我: "Me",
 		请输入人员名称搜索: "Please enter the name of the user to search",
+		最近选择: "Recent selections",
 		用户群组: "User Group",
 		无匹配人员: "No matching users",
 		虚拟账号: "Virtual Account",
 		用户: "User"
 	};
+	//#endregion
+	//#region src/locale/zh-cn.ts
 	var zh_cn_default = {
 		我: "我",
 		请输入人员名称搜索: "请输入人员名称搜索",
+		最近选择: "最近选择",
 		用户群组: "用户群组",
 		无匹配人员: "无匹配人员",
 		虚拟账号: "虚拟账号",
 		用户: "用户"
 	};
+	//#endregion
+	//#region src/hooks/use-i18n.ts
 	var BLUEKINNG_LANGUAGE = "blueking_language";
 	var languageMap = {
 		"en-US": en_us_default,
@@ -2648,9 +2996,28 @@
 			t
 		};
 	};
-	const useInputHandler = (options) => {
+	//#endregion
+	//#region src/hooks/use-input-handler.ts
+	/**
+	* 输入处理公共逻辑 Hook
+	* @module hooks/useInputHandler
+	*/
+	/**
+	* 输入处理公共逻辑 Hook
+	* @param options - 配置选项
+	* @returns 输入处理相关方法
+	*/
+	var useInputHandler = (options) => {
 		const { apiBaseUrl, tenantId, searchQuery, selectedUsers, allowCreate = false, freePaste = false, enableMultiTenantMode = true, maxCount = 0, onAddUser, onBatchAddUsers } = options;
 		const isPasting = (0, vue.ref)(false);
+		/** 单次粘贴最多处理数量（后端限制） */
+		const MAX_PASTE_USERS = 100;
+		/** 批量查询每批数量（不超过后端限制） */
+		const LOOKUP_BATCH_SIZE = 100;
+		/**
+		* 创建自定义用户对象
+		* @param loginName - 用户登录名
+		*/
 		const createCustomUser = (loginName) => ({
 			id: loginName,
 			name: loginName,
@@ -2658,19 +3025,47 @@
 			tenantId: "",
 			login_name: loginName
 		});
+		/**
+		* 解析粘贴文本为用户列表
+		* @param text - 粘贴的文本
+		*/
 		const parsePastedText = (text) => {
-			return text.split(/[,，;\n\s]+/).filter(Boolean).map((user) => user.trim().replace(/\s*\(.*?\)\s*/, "")).filter(Boolean);
+			const normalizedUsers = text.split(/[,，;\n\s]+/).filter(Boolean).map((user) => user.trim().replace(/\s*\(.*?\)\s*/, "")).filter(Boolean);
+			return Array.from(new Set(normalizedUsers)).slice(0, MAX_PASTE_USERS);
 		};
+		/**
+		* 将用户列表按指定大小分批
+		* @param usersList - 用户列表
+		* @param batchSize - 每批大小
+		*/
+		const chunkUsersList = (usersList, batchSize) => {
+			const chunks = [];
+			for (let i = 0; i < usersList.length; i += batchSize) chunks.push(usersList.slice(i, i + batchSize));
+			return chunks;
+		};
+		/**
+		* 合并用户列表并去重
+		* @param existingUsers - 现有用户列表
+		* @param newUsers - 新用户列表
+		*/
 		const mergeUsers = (existingUsers, newUsers) => {
 			const userMap = /* @__PURE__ */ new Map();
 			for (const user of [...existingUsers, ...newUsers]) if (!userMap.has(user.id)) userMap.set(user.id, user);
 			return Array.from(userMap.values());
 		};
+		/**
+		* 处理 Enter 键创建自定义用户
+		* @param event - 键盘事件
+		*/
 		const handleEnterCreate = (event) => {
 			if (event.key !== "Enter" || !allowCreate || !searchQuery.value.trim()) return;
 			const customUser = createCustomUser(searchQuery.value.trim());
 			if (!selectedUsers.value.some((user) => user.id === customUser.id)) onAddUser(customUser);
 		};
+		/**
+		* 处理粘贴事件
+		* @param event - 粘贴事件
+		*/
 		const handlePaste = async (event) => {
 			event.preventDefault();
 			const pastedText = event.clipboardData?.getData("text")?.trim();
@@ -2679,13 +3074,19 @@
 			try {
 				const usersList = parsePastedText(pastedText);
 				if (usersList.length === 0) return;
-				const formattedUsers = formatUsers(await lookupUsers({
-					apiBaseUrl,
-					tenantId,
-					exactSearchKey: "login_name",
-					usersList,
-					enableMultiTenantMode
-				}), enableMultiTenantMode);
+				const lookupBatches = chunkUsersList(usersList, LOOKUP_BATCH_SIZE);
+				const lookupResults = [];
+				for (const batch of lookupBatches) {
+					const result = await lookupUsers({
+						apiBaseUrl,
+						tenantId,
+						exactSearchKey: "login_name",
+						usersList: batch,
+						enableMultiTenantMode
+					});
+					lookupResults.push(...result);
+				}
+				const formattedUsers = formatUsers(lookupResults, enableMultiTenantMode);
 				if (onBatchAddUsers) {
 					let mergedUsers = mergeUsers(selectedUsers.value, formattedUsers);
 					if (freePaste) {
@@ -2708,7 +3109,20 @@
 			handlePaste
 		};
 	};
-	const useResizeObserver = (target, callback, options = {}) => {
+	//#endregion
+	//#region src/hooks/use-resize-observer.ts
+	/**
+	* ResizeObserver Hook
+	* @module hooks/useResizeObserver
+	*/
+	/**
+	* 监听元素大小变化的 Hook
+	* @param target - 目标元素引用
+	* @param callback - 大小变化时的回调函数
+	* @param options - 配置选项
+	* @returns 停止观察的函数
+	*/
+	var useResizeObserver = (target, callback, options = {}) => {
 		const { immediate = true } = options;
 		let observer = null;
 		const cleanup = () => {
@@ -2748,9 +3162,25 @@
 		(0, vue.onUnmounted)(cleanup);
 		return cleanup;
 	};
-	const useTenantData = (apiBaseUrl, tenantId, enableMultiTenantMode = true) => {
+	//#endregion
+	//#region src/hooks/use-tenant-data.ts
+	/**
+	* 租户数据处理 Hook
+	* @module hooks/useTenantData
+	*/
+	/**
+	* 使用租户数据的Hook
+	* @param apiBaseUrl - API基础URL
+	* @param tenantId - 租户ID
+	* @param enableMultiTenantMode - 是否启用多租户模式
+	* @returns 租户数据和加载状态
+	*/
+	var useTenantData = (apiBaseUrl, tenantId, enableMultiTenantMode = true) => {
 		const tenants = (0, vue.ref)({});
 		const loading = (0, vue.ref)(false);
+		/**
+		* 获取租户数据
+		*/
 		const fetchTenants = async () => {
 			if (!apiBaseUrl || !tenantId) {
 				console.warn("获取租户需要提供有效的API基础URL和租户ID");
@@ -2779,7 +3209,15 @@
 			fetchTenants
 		};
 	};
-	const debounce = (fn, delay) => {
+	//#endregion
+	//#region src/utils/common.ts
+	/**
+	* 防抖函数
+	* @param fn - 需要防抖的函数
+	* @param delay - 延迟时间（毫秒）
+	* @returns 防抖后的函数
+	*/
+	var debounce = (fn, delay) => {
 		let timer = null;
 		return function(...args) {
 			if (timer) clearTimeout(timer);
@@ -2789,7 +3227,14 @@
 			}, delay);
 		};
 	};
-	const calculateVisibleTags = (container, items, containerWidth) => {
+	/**
+	* 计算标签容器可见数量
+	* @param container - 容器元素
+	* @param items - 项目元素列表
+	* @param containerWidth - 容器宽度
+	* @returns 可见项目数量
+	*/
+	var calculateVisibleTags = (container, items, containerWidth) => {
 		if (!container || !items.length) return 0;
 		let totalWidth = 0;
 		let visibleCount = 0;
@@ -2806,10 +3251,27 @@
 		}
 		return Math.max(1, visibleCount);
 	};
-	const useUserSearch = (apiBaseUrl, tenantId, enableMultiTenantMode = true) => {
+	//#endregion
+	//#region src/hooks/use-user-search.ts
+	/**
+	* 用户搜索 Hook
+	* @module hooks/useUserSearch
+	*/
+	/**
+	* 使用用户搜索的Hook
+	* @param apiBaseUrl - API基础URL
+	* @param tenantId - 租户ID
+	* @param enableMultiTenantMode - 是否启用多租户模式
+	* @returns 用户搜索相关状态和方法
+	*/
+	var useUserSearch = (apiBaseUrl, tenantId, enableMultiTenantMode = true) => {
 		const searchResults = (0, vue.ref)([]);
 		const loading = (0, vue.ref)(false);
 		const searchQuery = (0, vue.ref)("");
+		/**
+		* 执行用户搜索
+		* @param keyword - 搜索关键词
+		*/
 		const performSearch = async (keyword) => {
 			if (!keyword?.length) {
 				searchResults.value = [];
@@ -2837,11 +3299,18 @@
 			}
 		};
 		const debouncedSearch = debounce(performSearch, 300);
+		/**
+		* 处理输入变化
+		* @param value - 输入值
+		*/
 		const handleSearchInput = (value) => {
 			loading.value = true;
 			searchQuery.value = value.trim();
 			debouncedSearch(searchQuery.value);
 		};
+		/**
+		* 清空搜索
+		*/
 		const clearSearch = () => {
 			searchQuery.value = "";
 			searchResults.value = [];
@@ -2856,8 +3325,23 @@
 			clearSearch
 		};
 	};
-	const useUserSelection = (options) => {
+	//#endregion
+	//#region src/hooks/use-user-selection.ts
+	/**
+	* 用户选择公共逻辑 Hook
+	* @module hooks/useUserSelection
+	*/
+	/**
+	* 用户选择公共逻辑 Hook
+	* @param options - 配置选项
+	* @returns 用户选择相关方法
+	*/
+	var useUserSelection = (options) => {
 		const { selectedUserIds, excludeUserIds, userGroup, searchQuery } = options;
+		/**
+		* 创建自定义用户对象
+		* @param loginName - 用户登录名
+		*/
 		const createCustomUser = (loginName) => ({
 			id: loginName,
 			name: loginName,
@@ -2865,11 +3349,19 @@
 			tenantId: "",
 			login_name: loginName
 		});
+		/**
+		* 检查用户是否已选中
+		* @param userId - 用户ID
+		*/
 		const isUserSelected = (userId) => {
 			return selectedUserIds.value.includes(userId);
 		};
-		const filterOptions = (options$1) => {
-			return options$1.filter((user) => !isUserSelected(user.id)).filter((user) => !excludeUserIds?.value?.includes(user.id));
+		/**
+		* 过滤选项（排除已选和排除列表）
+		* @param options - 原始选项列表
+		*/
+		const filterOptions = (options) => {
+			return options.filter((user) => !isUserSelected(user.id)).filter((user) => !excludeUserIds?.value?.includes(user.id));
 		};
 		return {
 			createCustomUser,
@@ -2886,6 +3378,8 @@
 			})
 		};
 	};
+	//#endregion
+	//#region src/components/me-tag.vue?vue&type=script&setup=true&lang.ts
 	var me_tag_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		name: "MeTag",
 		__name: "me-tag",
@@ -2904,9 +3398,21 @@
 		emits: ["click"],
 		setup(__props, { expose: __expose, emit: __emit }) {
 			__expose();
+			/**
+			* "我"标签组件
+			*/
 			const { t } = use_i18n_default();
+			/**
+			* 组件属性
+			*/
 			const props = __props;
+			/**
+			* 组件事件
+			*/
 			const emit = __emit;
+			/**
+			* 处理点击事件
+			*/
 			const handleClick = () => {
 				if (props.isDisabled) return;
 				emit("click");
@@ -2924,11 +3430,15 @@
 			return __returned__;
 		}
 	});
-	var __plugin_vue_export_helper_default = (sfc, props) => {
+	//#endregion
+	//#region \0plugin-vue:export-helper
+	var _plugin_vue_export_helper_default = (sfc, props) => {
 		const target = sfc.__vccOpts || sfc;
 		for (const [key, val] of props) target[key] = val;
 		return target;
 	};
+	//#endregion
+	//#region src/components/me-tag.vue
 	function _sfc_render$3(_ctx, _cache, $props, $setup, $data, $options) {
 		return $props.currentUserId ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 			key: 0,
@@ -2936,14 +3446,22 @@
 			onClick: (0, vue.withModifiers)($setup.handleClick, ["stop"])
 		}, (0, vue.toDisplayString)($setup.t("我")), 3)) : (0, vue.createCommentVNode)("v-if", true);
 	}
-	var me_tag_default = /* @__PURE__ */ __plugin_vue_export_helper_default(me_tag_vue_vue_type_script_setup_true_lang_default, [
+	var me_tag_default = /* @__PURE__ */ _plugin_vue_export_helper_default(me_tag_vue_vue_type_script_setup_true_lang_default, [
 		["render", _sfc_render$3],
 		["__scopeId", "data-v-a1054364"],
 		["__file", "/Users/brooklin/project/bkui-monorepo/packages/bk-user-selector/src/components/me-tag.vue"]
 	]);
+	//#endregion
+	//#region src/assets/user-group.svg
 	var user_group_default = "data:image/svg+xml,%3csvg%20viewBox='0%200%201024%201024'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20style='fill:%20%23A3C5FD;'%3e%3cpath%20fill-rule='evenodd'%20d='M405.7858816%20162.66256256C416.4461344%20160.6535248%20439.8986944%20159.44810208%20457.3815104%20160.25171712%20484.2453504%20161.05533248%20494.052784%20163.4661776%20516.226112%20174.7167888%20567.8217376%20200.43247136%20597.670448%20242.22045568%20606.6250624%20301.28616416%20617.711728%20374.415136%20593.4063488%20443.5260352%20535.8409792%20500.180896%20509.8299584%20525.8965792%20505.565856%20537.5489984%20514.0940608%20557.237568%20521.3430336%20572.9080608%20546.0748224%20586.5695168%20629.2248%20620.3213504%20691.054272%20645.2334208%20760.985536%20687.4232096%20767.8080992%20703.8973216%20774.6306624%20720.3714304%20784.8645056%20752.114224%20791.6870688%20777.4280992%20799.7888608%20807.1618592%20793.3927072%20818.8142784%20761.8383584%20832.4757344%20720.4765728%20850.155264%20669.3073536%20857.3878016%20546.9276416%20862.2094912%20392.9935776%20868.2366048%20227.12002944%20858.5932224%20162.30568672%20840.1100768%20134.5890272%20832.4757344%20108.15159776%20815.1980096%20100.47621504%20799.5275136%2093.6536528%20786.2678656%2094.08006304%20784.2588288%20105.59313696%20746.4889184%20116.67980096%20709.924432%20119.23826176%20705.5045504%20141.41158944%20685.4141728%20143.84821888%20683.2001312%20146.05397248%20681.2036448%20148.2232096%20679.3252416L152.13038144%20676.0501632C159.5946992%20670.0236288%20167.98497088%20664.6722176%20184.94031712%20656.0863296L191.29263904%20652.915344C215.97973152%20640.7492736%20256.51622304%20622.3959904%20329.458464%20589.3821696%20359.7335872%20575.3189056%20371.2466592%20563.6664896%20375.084352%20542.772496%20377.2164032%20530.316464%20374.6579424%20526.7001952%20345.2356416%20496.9664352%20295.34565344%20446.338688%20274.02514592%20396.9163584%20273.59873568%20331.0199232%20273.59873568%20291.24097568%20282.12693888%20265.52529312%20307.71154784%20228.15719168%20332.8697472%20191.19089792%20365.703328%20169.49329056%20405.7858816%20162.66256256ZM668.7713728%20226.60405184C756.683056%20211.50282816%20820.4190272%20263.09867616%20827.0124032%20354.9644544%20831.8475456%20416.6277856%20815.1443264%20461.931456%20770.3093664%20510.1714752%20752.287472%20529.4674848%20747.891888%20536.5986176%20748.3314464%20548.344016%20748.7710048%20555.8946272%20751.4083552%20565.123152%20754.485264%20568.8984576%20757.5621728%20572.2542848%20788.331264%20588.1944672%20823.0563776%20604.1346464%20944.3745024%20659.92528%20966.791984%20682.996592%20958.4403712%20744.6599232%20954.923904%20771.9260224%20956.6821376%20771.0870656%20890.308816%20787.0272448%20867.4517792%20792.8999456%20845.0343008%20798.3531648%20841.0782752%20799.6116%20835.3640128%20801.2895136%20833.1662208%20797.9336864%20830.5288704%20781.5740256%20824.3750528%20739.6261824%20812.0674176%20710.6821696%20790.0894976%20687.6108576%20752.287472%20647.3409248%20703.9360448%20619.6553504%20624.3759712%20593.6476864%20597.5629088%20584.4191616%20560.64%20550.8608864%20560.64%20534.920704%20560.64%20527.7895712%20569.8707264%20514.7857408%20589.6508544%20494.6507744%20620.859504%20461.931456%20639.7605152%20429.631616%20648.5516832%20394.8149056%20655.5846208%20366.7098496%20652.0681504%20283.23364096%20642.837424%20254.7091072%20635.3649312%20231.63779328%20634.4858144%20232.47675008%20668.7713728%20226.60405184Z'%3e%3c/path%3e%3c/svg%3e";
+	//#endregion
+	//#region src/assets/user.svg
 	var user_default = "data:image/svg+xml,%3c?xml%20version='1.0'%20encoding='UTF-8'?%3e%3csvg%20width='32px'%20height='32px'%20viewBox='0%200%2032%2032'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3e%3ctitle%3eIcon/用户%3c/title%3e%3cg%20id='Icon/用户'%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%3e%3cg%20id='user-(1)'%20transform='translate(3,%202)'%20fill='%23A3C5FD'%20fill-rule='nonzero'%3e%3cpath%20d='M13.0077612,27.9989067%20C10.3002732,27.9989067%207.59285518,28.0018792%204.88515705,27.997455%20C3.95018807,27.9959342%203.05044678,27.8282323%202.22816433,27.3628696%20C0.998627601,26.6672451%200.29953695,25.6114692%200.0864200465,24.2387462%20C-0.0656962495,23.259079%200.0147040645,22.4675755%200.0874005263,21.4879775%20C0.187970957,20.13461%200.423078914,19.3321844%200.863249688,18.0430358%20C1.22365046,16.9873982%201.73014453,16.0067633%202.49702917,15.175719%20C3.42254341,14.1726178%204.6014447,13.7297906%205.9255989,13.6440041%20C6.33292322,13.6073668%206.66741099,13.712025%206.9979768,13.9263185%20C7.58886318,14.3094892%208.17393665,14.7060014%208.79220674,15.0421658%20C10.1097776,15.758321%2011.5447274,16.1099698%2013.0616182,16.0930337%20C14.6806203,16.0750607%2016.2142496,15.63963%2017.592821,14.8169502%20C18.0555431,14.5407189%2018.5150436,14.256538%2018.9569652,13.9491996%20C19.3610679,13.6681294%2019.7808585,13.5749462%2020.274326,13.6337733%20C21.462472,13.7340074%2022.3872158,14.1103345%2023.2340106,14.8851094%20C23.902636,15.496952%2024.3685096,16.2520257%2024.7518119,17.0611566%20C25.272453,18.1598604%2025.5462904,18.7976948%2025.7441396,19.9861253%20C25.9499728,21.2233595%2026.0256808,22.2792045%2025.9924842,23.5308171%20C25.9627193,24.6543374%2025.6405577,25.6840525%2024.8535729,26.5307194%20C24.1686994,27.2671979%2023.3129402,27.7090574%2022.3211027,27.8808379%20C21.9232331,27.9495501%2021.5154185,27.9922014%2021.1120162,27.9935148%20C18.4104811,28.0036073%2015.7090862,27.9989067%2013.0077612,27.9989067%20L13.0077612,27.9989067%20Z%20M5.91775495,6.98479749%20C5.84814002,3.25685016%209.08684454,-0.00255470186%2013.0162355,1.5025268e-06%20C16.9117994,0.00256071584%2020.1304739,3.23452217%2020.1095656,7.04113598%20C20.0884528,10.8082092%2016.8998935,14.015354%2013.0058002,14.0149393%20C9.10134181,14.0145245%205.83322254,10.7695672%205.91775495,6.98479749%20Z'%20id='形状'%3e%3c/path%3e%3c/g%3e%3c/g%3e%3c/svg%3e";
+	//#endregion
+	//#region src/assets/virtual.svg
 	var virtual_default = "data:image/svg+xml,%3c?xml%20version='1.0'%20encoding='UTF-8'?%3e%3csvg%20width='32px'%20height='32px'%20viewBox='0%200%2032%2032'%20version='1.1'%20xmlns='http://www.w3.org/2000/svg'%20xmlns:xlink='http://www.w3.org/1999/xlink'%3e%3ctitle%3eIcon/虚拟icon%3c/title%3e%3cg%20id='Icon/虚拟icon'%20stroke='none'%20stroke-width='1'%20fill='none'%20fill-rule='evenodd'%3e%3cpath%20d='M27.4705882,3%20C28.315259,3%2029,3.68474098%2029,4.52941178%20L29,22.4623054%20C29,23.3069762%2028.315259,23.9917172%2027.4705882,23.9917172%20L20.5882353,23.9917172%20L20.5882353,27.0244081%20L24.0294118,27.0244081%20C24.2405794,27.0244081%2024.4117647,27.1955933%2024.4117647,27.406761%20L24.4117647,28.617647%20C24.4117647,28.8288148%2024.2405795,29%2024.0294118,29%20L7.97058824,29%20C7.75942054,29%207.58823529,28.8288148%207.58823529,28.617647%20L7.58823529,27.406761%20C7.58823531,27.1955933%207.75942055,27.0244081%207.97058824,27.0244081%20L11.4117647,27.0244081%20L11.4117647,23.9917172%20L4.52941178,23.9917172%20C3.68474098,23.9917172%203,23.3069762%203,22.4623054%20L3,4.52941178%20C3,3.68474098%203.68474098,3%204.52941178,3%20L27.4705882,3%20Z%20M19,24%20L13,24%20L13,27%20L19,27%20L19,24%20Z%20M23.4117647,7%20L8.58823529,7%20C8.03595054,7%207.58823529,7.44771525%207.58823529,8%20L7.58823529,19%20C7.58823529,19.5522847%208.03595054,20%208.58823529,20%20L23.4117647,20%20C23.9640495,20%2024.4117647,19.5522847%2024.4117647,19%20L24.4117647,8%20C24.4117647,7.44771525%2023.9640495,7%2023.4117647,7%20Z%20M12,10%20C12.5522847,10%2013,10.4477153%2013,11%20L13,13%20C13,13.5522847%2012.5522847,14%2012,14%20C11.4477153,14%2011,13.5522847%2011,13%20L11,11%20C11,10.4477153%2011.4477153,10%2012,10%20Z%20M20,10%20C20.5522847,10%2021,10.4477153%2021,11%20L21,13%20C21,13.5522847%2020.5522847,14%2020,14%20C19.4477153,14%2019,13.5522847%2019,13%20L19,11%20C19,10.4477153%2019.4477153,10%2020,10%20Z%20M26,5%20C25.4477153,5%2025,5.44771525%2025,6%20C25,6.55228475%2025.4477153,7%2026,7%20C26.5522847,7%2027,6.55228475%2027,6%20C27,5.44771525%2026.5522847,5%2026,5%20Z'%20id='蒙版'%20fill='%23A3C5FD'%20fill-rule='nonzero'%3e%3c/path%3e%3c/g%3e%3c/svg%3e";
+	//#endregion
+	//#region src/components/user-render.ts
 	var user_render_default = (0, vue.defineComponent)({
 		name: "UserRender",
 		props: {
@@ -2980,13 +3498,13 @@
 				const loginName = user.login_name || user.bk_username || user.id;
 				return `${props.avatarBaseUrl}${loginName}.png?default_when_absent=true`;
 			};
-			const defaultRender = (h$1, props$1) => {
-				return h$1("div", { style: {
+			const defaultRender = (h, props) => {
+				return h("div", { style: {
 					display: "flex",
 					alignItems: "center"
 				} }, [
-					props$1.hasAvatar ? h$1("img", {
-						src: getAvatarUrl(props$1.user),
+					props.hasAvatar ? h("img", {
+						src: getAvatarUrl(props.user),
 						style: {
 							width: "20px",
 							height: "20px",
@@ -2995,11 +3513,11 @@
 							flexShrink: 0
 						}
 					}) : null,
-					h$1("span", props$1.user.name),
-					props$1.user.tenantId !== props$1.tenantId && props$1.user.tenantId ? h$1("span", { style: {
+					h("span", props.user.name),
+					props.user.tenantId !== props.tenantId && props.user.tenantId ? h("span", { style: {
 						color: "#f59500",
 						marginLeft: "4px"
-					} }, `@${props$1.tenants[props$1.user.tenantId] || props$1.user.tenantId}`) : null
+					} }, `@${props.tenants[props.user.tenantId] || props.user.tenantId}`) : null
 				]);
 			};
 			return () => {
@@ -3012,6 +3530,8 @@
 			};
 		}
 	});
+	//#endregion
+	//#region src/components/selection-popover.vue?vue&type=script&setup=true&lang.ts
 	var selection_popover_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		name: "SelectionPopover",
 		__name: "selection-popover",
@@ -3061,6 +3581,16 @@
 				required: false,
 				default: () => []
 			},
+			recentUsers: {
+				type: Array,
+				required: false,
+				default: () => []
+			},
+			recentUsersName: {
+				type: String,
+				required: false,
+				default: ""
+			},
 			renderListItem: {
 				type: Function,
 				required: false
@@ -3094,11 +3624,23 @@
 		emits: ["click-outside", "select-user"],
 		setup(__props, { expose: __expose, emit: __emit }) {
 			__expose();
+			/**
+			* 用户选择器下拉菜单组件
+			*/
 			const { t } = use_i18n_default();
 			const slotContainerRef = (0, vue.ref)(null);
 			const contentContainerRef = (0, vue.ref)(null);
+			/**
+			* 组件属性
+			*/
 			const props = __props;
+			/**
+			* 组件事件
+			*/
 			const emit = __emit;
+			/**
+			* 按分组整理用户列表，如果有 userGroup, 则在最前面增加用户群组 userGroup
+			*/
 			const groupedUsers = (0, vue.computed)(() => {
 				const groups = {};
 				if (Array.isArray(props.userGroup) && props.userGroup.length > 0) groups[props.userGroupName] = props.userGroup.map((group) => ({
@@ -3113,25 +3655,41 @@
 				});
 				return groups;
 			});
+			const hasMainOptions = (0, vue.computed)(() => Object.values(groupedUsers.value).some((group) => group.length > 0));
+			const hasRecentUsers = (0, vue.computed)(() => props.recentUsers.length > 0);
+			const hasDropdownOptions = (0, vue.computed)(() => hasMainOptions.value || hasRecentUsers.value);
+			/**
+			* 判断用户是否为当前高亮项
+			*/
 			const isHighlighted = (user) => {
 				if (props.highlightedIndex < 0 || !props.flatOptions.length) return false;
-				return props.flatOptions[props.highlightedIndex]?.id === user.id;
+				return props.flatOptions[props.highlightedIndex] === user;
 			};
+			/**
+			* 选择用户
+			*/
 			const selectUser = (user) => {
 				emit("select-user", user);
 			};
+			/**
+			* 点击外部
+			*/
 			const handleClickOutside = ({ event }) => {
 				const target = event.target;
 				if (slotContainerRef.value?.contains(target)) return;
 				if (contentContainerRef.value?.contains(target)) return;
 				emit("click-outside", event);
 			};
+			/**
+			* 监听高亮索引变化，自动滚动到高亮项
+			*/
 			(0, vue.watch)(() => props.highlightedIndex, (newIndex) => {
 				if (newIndex < 0 || !contentContainerRef.value) return;
 				(0, vue.nextTick)(() => {
 					const highlightedElement = contentContainerRef.value?.querySelector(".user-option.is-highlighted");
 					if (highlightedElement) highlightedElement.scrollIntoView({
 						block: "nearest",
+						inline: "nearest",
 						behavior: "auto"
 					});
 				});
@@ -3143,6 +3701,9 @@
 				props,
 				emit,
 				groupedUsers,
+				hasMainOptions,
+				hasRecentUsers,
+				hasDropdownOptions,
 				isHighlighted,
 				selectUser,
 				handleClickOutside,
@@ -3163,15 +3724,28 @@
 			return __returned__;
 		}
 	});
+	//#endregion
+	//#region src/components/selection-popover.vue
 	var _hoisted_1$1 = { ref: "contentContainerRef" };
 	var _hoisted_2$1 = {
 		key: 0,
 		class: "no-data"
 	};
-	var _hoisted_3$1 = { class: "group-name" };
-	var _hoisted_4$1 = { class: "group-count" };
-	var _hoisted_5 = ["onClick"];
-	var _hoisted_6 = { ref: "slotContainerRef" };
+	var _hoisted_3$1 = {
+		key: 0,
+		class: "dropdown-panel dropdown-panel-main"
+	};
+	var _hoisted_4$1 = { class: "group-name" };
+	var _hoisted_5 = { class: "group-count" };
+	var _hoisted_6 = ["onClick"];
+	var _hoisted_7 = {
+		key: 1,
+		class: "dropdown-panel dropdown-panel-recent"
+	};
+	var _hoisted_8 = { class: "group-name" };
+	var _hoisted_9 = { class: "group-count" };
+	var _hoisted_10 = ["onClick"];
+	var _hoisted_11 = { ref: "slotContainerRef" };
 	function _sfc_render$2(_ctx, _cache, $props, $setup, $data, $options) {
 		return (0, vue.openBlock)(), (0, vue.createBlock)($setup["Popover"], {
 			arrow: false,
@@ -3190,7 +3764,10 @@
 				mode: "spin",
 				size: "mini"
 			}, {
-				default: (0, vue.withCtx)(() => [$props.options.length === 0 && $props.userGroup.length === 0 ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_2$1, [(0, vue.createElementVNode)("span", null, (0, vue.toDisplayString)($props.emptyText), 1)])) : ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, { key: 1 }, (0, vue.renderList)($setup.groupedUsers, (group, groupName) => {
+				default: (0, vue.withCtx)(() => [!$setup.hasDropdownOptions ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_2$1, [(0, vue.createElementVNode)("span", null, (0, vue.toDisplayString)($props.emptyText), 1)])) : ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
+					key: 1,
+					class: (0, vue.normalizeClass)(["dropdown-panels", { "is-two-column": $setup.hasMainOptions && $setup.hasRecentUsers }])
+				}, [$setup.hasMainOptions ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_3$1, [((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)($setup.groupedUsers, (group, groupName) => {
 					return (0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 						key: groupName,
 						class: "user-group"
@@ -3198,7 +3775,7 @@
 						key: 0,
 						class: "group-header",
 						onClick: _cache[0] || (_cache[0] = (0, vue.withModifiers)(() => {}, ["prevent"]))
-					}, [(0, vue.createElementVNode)("span", _hoisted_3$1, (0, vue.toDisplayString)(groupName), 1), (0, vue.createElementVNode)("span", _hoisted_4$1, "(" + (0, vue.toDisplayString)(group.length) + ")", 1)])) : (0, vue.createCommentVNode)("v-if", true), ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(group, (user) => {
+					}, [(0, vue.createElementVNode)("span", _hoisted_4$1, (0, vue.toDisplayString)(groupName), 1), (0, vue.createElementVNode)("span", _hoisted_5, "(" + (0, vue.toDisplayString)(group.length) + ")", 1)])) : (0, vue.createCommentVNode)("v-if", true), ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)(group, (user) => {
 						return (0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
 							key: user.id,
 							class: (0, vue.normalizeClass)(["user-option", { "is-highlighted": $setup.isHighlighted(user) }]),
@@ -3218,20 +3795,50 @@
 							"tenant-id",
 							"tenants",
 							"user"
-						])], 42, _hoisted_5);
+						])], 42, _hoisted_6);
 					}), 128))]);
-				}), 128))]),
+				}), 128))])) : (0, vue.createCommentVNode)("v-if", true), $setup.hasRecentUsers ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", _hoisted_7, [$props.recentUsersName ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
+					key: 0,
+					class: "group-header",
+					onClick: _cache[2] || (_cache[2] = (0, vue.withModifiers)(() => {}, ["prevent"]))
+				}, [(0, vue.createElementVNode)("span", _hoisted_8, (0, vue.toDisplayString)($props.recentUsersName), 1), (0, vue.createElementVNode)("span", _hoisted_9, "(" + (0, vue.toDisplayString)($props.recentUsers.length) + ")", 1)])) : (0, vue.createCommentVNode)("v-if", true), ((0, vue.openBlock)(true), (0, vue.createElementBlock)(vue.Fragment, null, (0, vue.renderList)($props.recentUsers, (user) => {
+					return (0, vue.openBlock)(), (0, vue.createElementBlock)("div", {
+						key: user.id,
+						class: (0, vue.normalizeClass)(["user-option", { "is-highlighted": $setup.isHighlighted(user) }]),
+						onClick: (0, vue.withModifiers)(($event) => $setup.selectUser(user), ["prevent"]),
+						onMousedown: _cache[3] || (_cache[3] = (0, vue.withModifiers)(() => {}, ["prevent"]))
+					}, [(0, vue.createVNode)($setup["UserRender"], {
+						"avatar-base-url": $props.avatarBaseUrl,
+						"has-avatar": $props.hasAvatar,
+						render: $props.renderListItem,
+						"tenant-id": $props.tenantId,
+						tenants: $props.tenants,
+						user
+					}, null, 8, [
+						"avatar-base-url",
+						"has-avatar",
+						"render",
+						"tenant-id",
+						"tenants",
+						"user"
+					])], 42, _hoisted_10);
+				}), 128))])) : (0, vue.createCommentVNode)("v-if", true)], 2))]),
 				_: 1
 			}, 8, ["loading"])], 512)]),
-			default: (0, vue.withCtx)(() => [(0, vue.createElementVNode)("div", _hoisted_6, [(0, vue.renderSlot)(_ctx.$slots, "default", {}, void 0, true)], 512)]),
+			default: (0, vue.withCtx)(() => [(0, vue.createElementVNode)("div", _hoisted_11, [(0, vue.renderSlot)(_ctx.$slots, "default", {}, void 0, true)], 512)]),
 			_: 3
 		}, 8, ["is-show", "width"]);
 	}
-	var selection_popover_default = /* @__PURE__ */ __plugin_vue_export_helper_default(selection_popover_vue_vue_type_script_setup_true_lang_default, [
+	var selection_popover_default = /* @__PURE__ */ _plugin_vue_export_helper_default(selection_popover_vue_vue_type_script_setup_true_lang_default, [
 		["render", _sfc_render$2],
 		["__scopeId", "data-v-9173accf"],
 		["__file", "/Users/brooklin/project/bkui-monorepo/packages/bk-user-selector/src/components/selection-popover.vue"]
 	]);
+	//#endregion
+	//#region src/components/user-tag.vue?vue&type=script&setup=true&lang.ts
+	/**
+	* 用户标签组件
+	*/
 	var user_tag_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		name: "UserTag",
 		__name: "user-tag",
@@ -3276,10 +3883,22 @@
 		emits: ["click", "close"],
 		setup(__props, { expose: __expose, emit: __emit }) {
 			__expose();
+			/**
+			* 组件属性
+			*/
+			/**
+			* 组件事件
+			*/
 			const emit = __emit;
+			/**
+			* 处理点击事件
+			*/
 			const handleClick = () => {
 				emit("click");
 			};
+			/**
+			* 处理关闭事件
+			*/
 			const handleClose = () => {
 				emit("close");
 			};
@@ -3301,6 +3920,8 @@
 			return __returned__;
 		}
 	});
+	//#endregion
+	//#region src/components/user-tag.vue
 	function _sfc_render$1(_ctx, _cache, $props, $setup, $data, $options) {
 		return (0, vue.openBlock)(), (0, vue.createBlock)($setup["Tag"], {
 			class: (0, vue.normalizeClass)(["user-tag", {
@@ -3331,15 +3952,22 @@
 			_: 1
 		}, 8, ["class"]);
 	}
-	var user_tag_default = /* @__PURE__ */ __plugin_vue_export_helper_default(user_tag_vue_vue_type_script_setup_true_lang_default, [
+	var user_tag_default = /* @__PURE__ */ _plugin_vue_export_helper_default(user_tag_vue_vue_type_script_setup_true_lang_default, [
 		["render", _sfc_render$1],
 		["__scopeId", "data-v-d1173d20"],
 		["__file", "/Users/brooklin/project/bkui-monorepo/packages/bk-user-selector/src/components/user-tag.vue"]
 	]);
+	//#endregion
+	//#region src/components/user-selector.vue?vue&type=script&setup=true&lang.ts
 	var user_selector_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ (0, vue.defineComponent)({
 		name: "BkUserSelector",
 		__name: "user-selector",
 		props: {
+			autoFocus: {
+				type: Boolean,
+				required: false,
+				default: false
+			},
 			draggable: {
 				type: Boolean,
 				required: false,
@@ -3380,6 +4008,21 @@
 				required: false,
 				default: false
 			},
+			allowCrossOriginCredentials: {
+				type: Boolean,
+				required: false,
+				default: true
+			},
+			allowedApiOrigins: {
+				type: Array,
+				required: false,
+				default: () => []
+			},
+			allowPrivateApiHost: {
+				type: Boolean,
+				required: false,
+				default: true
+			},
 			apiBaseUrl: {
 				type: String,
 				required: true,
@@ -3435,6 +4078,11 @@
 				required: false,
 				default: ""
 			},
+			recentUserIds: {
+				type: Array,
+				required: false,
+				default: () => []
+			},
 			renderListItem: {
 				type: Function,
 				required: false
@@ -3464,17 +4112,47 @@
 			"change",
 			"dragEnd",
 			"dragStart",
+			"error",
 			"focus",
+			"unauthorized",
 			"update:modelValue"
 		],
 		setup(__props, { expose: __expose, emit: __emit }) {
-			__expose();
+			/**
+			* 蓝鲸用户选择器组件
+			* @module components/UserSelector
+			*/
 			const { t } = use_i18n_default();
 			(0, bkui_vue.provideGlobalConfig)({ prefix: "bk" });
+			/**
+			* 组件属性
+			*/
 			const props = __props;
+			/**
+			* 组件事件
+			*/
 			const emit = __emit;
-			const { tenants = {} } = useTenantData(props.apiBaseUrl, props.tenantId, props.enableMultiTenantMode);
+			const handleApiError = (error) => {
+				emit("error", error);
+			};
+			const handleApiUnauthorized = (error) => {
+				emit("unauthorized", error);
+			};
+			provideApiConfig(props.apiBaseUrl, props.tenantId, props.allowedApiOrigins, props.allowPrivateApiHost, props.allowCrossOriginCredentials, {
+				onError: handleApiError,
+				onUnauthorized: handleApiUnauthorized
+			});
+			/**
+			* 获取租户数据
+			*/
+			const { tenants } = useTenantData(props.apiBaseUrl, props.tenantId, props.enableMultiTenantMode);
+			/**
+			* 用户搜索
+			*/
 			const { searchResults, loading: searchLoading, searchQuery, clearSearch, handleSearchInput } = useUserSearch(props.apiBaseUrl, props.tenantId, props.enableMultiTenantMode);
+			/**
+			* 当前用户处理
+			*/
 			const { fetchCurrentUser } = useCurrentUser({
 				apiBaseUrl: props.apiBaseUrl,
 				tenantId: props.tenantId,
@@ -3482,18 +4160,30 @@
 				exactSearchKey: props.exactSearchKey,
 				enableMultiTenantMode: props.enableMultiTenantMode
 			});
+			/**
+			* DOM 引用
+			*/
 			const containerRef = (0, vue.ref)(null);
 			const sortableContainerRef = (0, vue.ref)(null);
 			const collapsedContainerRef = (0, vue.ref)(null);
 			const frontInputRef = (0, vue.ref)(null);
 			const inlineInputRef = (0, vue.ref)(null);
 			const lastInputRef = (0, vue.ref)(null);
+			/**
+			* 组件状态
+			*/
 			const isFocused = (0, vue.ref)(false);
 			const activeTagIndex = (0, vue.ref)(-1);
 			const sortableInstance = (0, vue.ref)(null);
 			const visibleUsers = (0, vue.ref)([]);
 			const hiddenCount = (0, vue.ref)(0);
 			const highlightedIndex = (0, vue.ref)(-1);
+			const recentUsers = (0, vue.ref)([]);
+			let recentUsersRequestId = 0;
+			let recentUserIdsSnapshot = [];
+			/**
+			* 已选用户列表 (内部状态)
+			*/
 			const selectedUsers = (0, vue.ref)([]);
 			const isTextareaMode = (0, vue.computed)(() => props.type === "textarea");
 			const textareaHeight = (0, vue.ref)(props.rows * 32);
@@ -3505,38 +4195,112 @@
 					overflowY: "auto"
 				};
 			});
+			/**
+			* 未聚焦状态下展示的用户列表：textarea 模式展示全部，input 模式展示折叠后的
+			*/
 			const collapsedDisplayUsers = (0, vue.computed)(() => {
 				return isTextareaMode.value ? selectedUsers.value : visibleUsers.value;
 			});
-			const showDropdown = (0, vue.computed)(() => {
-				return isFocused.value && (props.userGroup.length > 0 || searchQuery.value.trim() !== "");
-			});
+			/**
+			* 模型值 ID 列表
+			*/
 			const modelValueIds = (0, vue.computed)(() => {
 				if (props.multiple) return Array.isArray(props.modelValue) ? props.modelValue : [];
 				return props.modelValue ? [props.modelValue] : [];
 			});
+			/**
+			* 用 computed 处理国际化
+			*/
 			const computedPlaceholder = (0, vue.computed)(() => props.placeholder || t("请输入人员名称搜索"));
 			const computedUserGroupName = (0, vue.computed)(() => props.userGroupName || t("用户群组"));
 			const computedEmptyText = (0, vue.computed)(() => props.emptyText || t("无匹配人员"));
+			const computedRecentUsersName = (0, vue.computed)(() => t("最近选择"));
+			/**
+			* 已选用户ID列表
+			*/
 			const selectedUserIds = (0, vue.computed)(() => selectedUsers.value.map((user) => user.id));
+			const isUserMatchedByQuery = (user, query) => {
+				if (!query) return true;
+				return [
+					user.id,
+					user.name,
+					user.bk_username,
+					user.username,
+					user.login_name,
+					user.display_name,
+					user.full_name
+				].some((field) => String(field || "").includes(query));
+			};
+			const getLookupFields = (exactSearchKey) => {
+				return exactSearchKey.split(",").map((field) => field.trim()).filter(Boolean);
+			};
+			const findUserByLookupId = (users, lookupId, lookupFields) => {
+				return users.find((user) => {
+					if (user.id === lookupId) return true;
+					const indexedUser = user;
+					return lookupFields.some((field) => String(indexedUser[field] || "") === lookupId);
+				});
+			};
+			const sortUsersByLookupIds = (users, lookupIds, lookupFields) => {
+				return lookupIds.map((lookupId) => findUserByLookupId(users, lookupId, lookupFields)).filter(Boolean);
+			};
+			const lookupFormattedUsersByIds = async (lookupIds) => {
+				const primaryLookupFields = getLookupFields(props.exactSearchKey);
+				const formattedUsers = formatUsers(await lookupUsers({
+					apiBaseUrl: props.apiBaseUrl,
+					tenantId: props.tenantId,
+					exactSearchKey: props.exactSearchKey,
+					usersList: lookupIds,
+					enableMultiTenantMode: props.enableMultiTenantMode
+				}), props.enableMultiTenantMode);
+				const unresolvedIds = lookupIds.filter((lookupId) => !findUserByLookupId(formattedUsers, lookupId, primaryLookupFields));
+				if (unresolvedIds.length === 0 || props.exactSearchKey === "bk_username") return sortUsersByLookupIds(formattedUsers, lookupIds, primaryLookupFields);
+				const fallbackUsers = formatUsers(await lookupUsers({
+					apiBaseUrl: props.apiBaseUrl,
+					tenantId: props.tenantId,
+					exactSearchKey: DEFAULT_EXACT_SEARCH_KEY,
+					usersList: unresolvedIds,
+					enableMultiTenantMode: props.enableMultiTenantMode
+				}), props.enableMultiTenantMode);
+				const mergedUsers = [...formattedUsers];
+				fallbackUsers.forEach((user) => {
+					if (!mergedUsers.some((item) => item.id === user.id)) mergedUsers.push(user);
+				});
+				return sortUsersByLookupIds(mergedUsers, lookupIds, [...new Set([...primaryLookupFields, DEFAULT_EXACT_SEARCH_KEY])]);
+			};
+			/**
+			* 是否已达到最大选择数量
+			*/
 			const isMaxCountReached = (0, vue.computed)(() => {
 				if (!props.maxCount || props.maxCount <= 0) return false;
 				return selectedUsers.value.length >= props.maxCount;
 			});
+			/**
+			* "我"标签是否禁用（已选中当前用户时禁用，或已达到最大数量）
+			*/
 			const isMeTagDisabled = (0, vue.computed)(() => isMaxCountReached.value || !!props.currentUserId && selectedUsers.value.some((user) => user[props.exactSearchKey] === props.currentUserId));
+			/**
+			* UserTag 公共属性
+			*/
 			const userTagCommonProps = (0, vue.computed)(() => ({
 				avatarBaseUrl: props.avatarBaseUrl,
 				currentTenantId: props.tenantId,
 				hasAvatar: props.hasAvatar,
 				renderTag: props.renderTag,
-				tenants
+				tenants: tenants.value
 			}));
+			/**
+			* 使用用户选择公共逻辑 hook
+			*/
 			const { filteredUserGroup, filterOptions, createCustomUser } = useUserSelection({
 				selectedUserIds,
 				excludeUserIds: (0, vue.toRef)(props, "excludeUserIds"),
 				userGroup: (0, vue.toRef)(props, "userGroup"),
 				searchQuery
 			});
+			/**
+			* 使用输入处理公共逻辑 hook
+			*/
 			const { handlePaste } = useInputHandler({
 				apiBaseUrl: props.apiBaseUrl,
 				tenantId: props.tenantId,
@@ -3549,8 +4313,11 @@
 				onAddUser: addUser,
 				onBatchAddUsers: props.multiple ? updateSelectedUsers : void 0
 			});
+			/**
+			* 显示的选项（过滤后的搜索结果）
+			*/
 			const displayOptions = (0, vue.computed)(() => filterOptions(searchResults.value));
-			const flatOptions = (0, vue.computed)(() => {
+			const mainNavigableUsers = (0, vue.computed)(() => {
 				const userGroupOptions = filteredUserGroup.value.map((group) => ({
 					...group,
 					tenantId: "",
@@ -3564,6 +4331,27 @@
 					...virtualUsers
 				];
 			});
+			const filteredRecentUsers = (0, vue.computed)(() => {
+				const query = searchQuery.value.trim();
+				return recentUsers.value.filter((user) => !selectedUserIds.value.includes(user.id)).filter((user) => !props.excludeUserIds.includes(user.id)).filter((user) => isUserMatchedByQuery(user, query));
+			});
+			/**
+			* 下拉框显示状态
+			*/
+			const showDropdown = (0, vue.computed)(() => {
+				return isFocused.value && (filteredUserGroup.value.length > 0 || filteredRecentUsers.value.length > 0 || searchQuery.value.trim() !== "");
+			});
+			/**
+			* 扁平化的选项列表（合并 userGroup 和 displayOptions，用于键盘导航）
+			* 顺序与 selection-popover.vue 中 groupedUsers 的渲染顺序保持一致：
+			* 用户群组 → 普通用户 → 虚拟账号 → 最近选择
+			*/
+			const flatOptions = (0, vue.computed)(() => {
+				return [...mainNavigableUsers.value, ...filteredRecentUsers.value];
+			});
+			/**
+			* 输入框宽度（根据输入内容动态计算）
+			*/
 			const inputWidth = (0, vue.computed)(() => {
 				const query = searchQuery.value;
 				if (!query) return "20px";
@@ -3572,6 +4360,9 @@
 				}, 0);
 				return `${Math.max(20, charWidth + 4)}px`;
 			});
+			/**
+			* 初始化已选用户数据
+			*/
 			const initSelectedUsers = async () => {
 				const ids = modelValueIds.value;
 				if (ids.length === 0) {
@@ -3585,26 +4376,43 @@
 					type: USER_TYPE.USER_GROUP
 				}));
 				try {
-					const result = await lookupUsers({
-						apiBaseUrl: props.apiBaseUrl,
-						tenantId: props.tenantId,
-						exactSearchKey: "bk_username",
-						usersList: ids,
-						enableMultiTenantMode: props.enableMultiTenantMode
-					});
-					const selectedList = [...userGroupSelected, ...formatUsers(result, props.enableMultiTenantMode)];
-					if (props.allowCreate) selectedList.push(...ids.filter((id) => !selectedList.some((user) => user.id === id)).map((id) => ({
-						id,
-						name: id,
-						type: USER_TYPE.CUSTOM,
-						tenantId: ""
-					})));
-					selectedUsers.value = ids.map((id) => selectedList.find((user) => user.id === id)).filter(Boolean);
+					const selectedList = [...userGroupSelected, ...await lookupFormattedUsersByIds(ids)];
+					if (props.allowCreate) {
+						const lookupFields = [...new Set([...getLookupFields(props.exactSearchKey), DEFAULT_EXACT_SEARCH_KEY])];
+						selectedList.push(...ids.filter((id) => !findUserByLookupId(selectedList, id, lookupFields)).map((id) => ({
+							id,
+							name: id,
+							type: USER_TYPE.CUSTOM,
+							tenantId: ""
+						})));
+					}
+					selectedUsers.value = sortUsersByLookupIds(selectedList, ids, [...new Set([...getLookupFields(props.exactSearchKey), DEFAULT_EXACT_SEARCH_KEY])]);
 				} catch (error) {
 					console.error("获取选中用户信息失败:", error);
 					selectedUsers.value = [];
 				}
 			};
+			const initRecentUsers = async () => {
+				const ids = props.recentUserIds.filter(Boolean);
+				const requestId = ++recentUsersRequestId;
+				recentUserIdsSnapshot = [...ids];
+				if (ids.length === 0) {
+					recentUsers.value = [];
+					return;
+				}
+				try {
+					const formattedUsers = (await lookupFormattedUsersByIds(ids)).filter((user) => user.data_source_type !== USER_TYPE.VIRTUAL && user.type !== USER_TYPE.USER_GROUP);
+					if (requestId !== recentUsersRequestId) return;
+					recentUsers.value = formattedUsers;
+				} catch (error) {
+					if (requestId !== recentUsersRequestId) return;
+					console.error("获取最近选择用户信息失败:", error);
+					recentUsers.value = [];
+				}
+			};
+			/**
+			* 更新选中用户并触发事件
+			*/
 			function updateSelectedUsers(users) {
 				selectedUsers.value = users;
 				if (props.multiple) {
@@ -3616,6 +4424,9 @@
 					emit("change", user);
 				}
 			}
+			/**
+			* 初始化排序功能
+			*/
 			const initSortable = () => {
 				if (!props.draggable || !props.multiple || !sortableContainerRef.value) return;
 				if (sortableInstance.value) sortableInstance.value.destroy();
@@ -3636,6 +4447,9 @@
 					}
 				});
 			};
+			/**
+			* 计算可见用户
+			*/
 			const calculateVisibleUsers = () => {
 				if (!selectedUsers.value.length) {
 					visibleUsers.value = [];
@@ -3659,18 +4473,24 @@
 				visibleUsers.value = selectedUsers.value.slice(0, visibleCount);
 				hiddenCount.value = Math.max(0, selectedUsers.value.length - visibleCount);
 			};
+			/**
+			* 处理聚焦
+			*/
 			const handleFocus = () => {
 				isFocused.value = true;
 				activeTagIndex.value = selectedUsers.value.length - 1;
 				(0, vue.nextTick)(() => focusCurrentInput());
 			};
+			/**
+			* 延迟计算可见用户
+			*/
 			const scheduleVisibleUsersCalculation = () => {
 				if (!isFocused.value) (0, vue.nextTick)(calculateVisibleUsers);
 			};
-			const handleClickOutside = (event) => {
-				const target = event.target;
-				const container = containerRef.value;
-				if (container?.contains(target) || container === target) return;
+			/**
+			* 主动失焦（供外部调用或内部复用）
+			*/
+			const blur = () => {
 				if (isFocused.value) emit("blur");
 				isFocused.value = false;
 				activeTagIndex.value = selectedUsers.value.length - 1;
@@ -3678,26 +4498,56 @@
 				highlightedIndex.value = -1;
 				scheduleVisibleUsersCalculation();
 			};
+			/**
+			* 处理失焦
+			*/
+			const handleClickOutside = (event) => {
+				const target = event.target;
+				const container = containerRef.value;
+				if (container?.contains(target) || container === target) return;
+				blur();
+			};
+			/**
+			* 处理容器点击
+			*/
 			const handleContainerClick = () => {
 				activeTagIndex.value = selectedUsers.value.length - 1;
 				(0, vue.nextTick)(() => focusCurrentInput());
 			};
+			/**
+			* 聚焦当前光标位置的输入框
+			* activeTagIndex 语义：
+			*   -1 = 最前面（第一个标签之前）
+			*   0 ~ length-1 = 对应标签后面
+			*/
 			const focusCurrentInput = () => {
 				if (activeTagIndex.value === -1 && selectedUsers.value.length > 0) frontInputRef.value?.focus();
 				else if (activeTagIndex.value >= selectedUsers.value.length - 1) lastInputRef.value?.focus();
 				else inlineInputRef.value?.[0]?.focus();
 			};
+			/**
+			* 处理标签点击
+			*/
 			const handleTagClick = (index) => {
 				activeTagIndex.value = index;
 				(0, vue.nextTick)(() => focusCurrentInput());
 			};
+			/**
+			* 处理输入框聚焦
+			*/
 			const handleInputFocus = () => {
 				emit("focus");
 				isFocused.value = true;
 			};
+			/**
+			* 处理输入变化
+			*/
 			const handleInput = () => {
 				handleSearchInput(searchQuery.value);
 			};
+			/**
+			* 添加当前用户（"我"）
+			*/
 			const addCurrentUser = async () => {
 				if (!props.currentUserId || selectedUsers.value.some((user) => user[props.exactSearchKey] === props.currentUserId)) return;
 				if (props.multiple && isMaxCountReached.value) return;
@@ -3712,11 +4562,17 @@
 					(0, vue.nextTick)(() => focusCurrentInput());
 				}
 			};
+			/**
+			* 处理粘贴事件
+			*/
 			const onPaste = async (event) => {
 				await handlePaste(event);
 				activeTagIndex.value = selectedUsers.value.length - 1;
 				(0, vue.nextTick)(() => focusCurrentInput());
 			};
+			/**
+			* 处理键盘事件
+			*/
 			const handleKeyDown = (event) => {
 				if (event.key === "Backspace" && !searchQuery.value && selectedUsers.value.length > 0) {
 					if (activeTagIndex.value >= 0) {
@@ -3760,6 +4616,12 @@
 					return;
 				}
 			};
+			/**
+			* 添加用户
+			* activeTagIndex 语义：
+			*   -1 = 在最前面插入
+			*   0 ~ length-1 = 在对应标签后面插入
+			*/
 			function addUser(user) {
 				if (!user?.id) return;
 				if (props.multiple && isMaxCountReached.value) {
@@ -3792,6 +4654,9 @@
 				isFocused.value = true;
 				(0, vue.nextTick)(() => focusCurrentInput());
 			}
+			/**
+			* 移除用户（通过 x 按钮删除）
+			*/
 			const removeUser = (user) => {
 				if (!user?.id) return;
 				const removedIndex = selectedUsers.value.findIndex((item) => item.id === user.id);
@@ -3802,9 +4667,15 @@
 				else if (activeTagIndex.value >= updatedUsers.length) activeTagIndex.value = updatedUsers.length - 1;
 				scheduleVisibleUsersCalculation();
 			};
+			/**
+			* 监听选中用户变化
+			*/
 			(0, vue.watch)(selectedUsers, () => {
 				scheduleVisibleUsersCalculation();
 			}, { deep: true });
+			/**
+			* 监听聚焦状态变化
+			*/
 			(0, vue.watch)(isFocused, (newVal) => {
 				if (isTextareaMode.value) {
 					const prevContainer = newVal ? collapsedContainerRef.value : containerRef.value?.querySelector(".tags-container.focused");
@@ -3812,35 +4683,73 @@
 				}
 				if (newVal) (0, vue.nextTick)(() => initSortable());
 			});
+			/**
+			* 监听 flatOptions 变化，重置高亮索引到第一项
+			*/
 			(0, vue.watch)(flatOptions, (newOptions) => {
 				if (newOptions.length > 0 && showDropdown.value) highlightedIndex.value = 0;
 				else highlightedIndex.value = -1;
 			});
+			/**
+			* 监听用户群组变化
+			*/
 			(0, vue.watch)(() => props.userGroup, () => {
 				initSelectedUsers();
 			});
+			(0, vue.watch)(() => props.recentUserIds, () => {
+				const newIds = props.recentUserIds.filter(Boolean);
+				if (recentUserIdsSnapshot.length === newIds.length && recentUserIdsSnapshot.every((id, index) => id === newIds[index])) return;
+				initRecentUsers();
+			}, { deep: true });
+			/**
+			* 监听 modelValue 变化
+			*/
 			(0, vue.watch)(() => props.modelValue, () => {
 				const currentIds = selectedUsers.value.map((u) => u.id);
 				const newIds = modelValueIds.value;
 				if (currentIds.length !== newIds.length || !currentIds.every((id, index) => id === newIds[index])) initSelectedUsers();
 			}, { deep: true });
+			/**
+			* 使用 ResizeObserver 监听容器大小变化
+			*/
 			useResizeObserver(containerRef, () => {
 				scheduleVisibleUsersCalculation();
 			});
+			let initPromise;
+			/**
+			* 组件挂载前初始化
+			*/
 			(0, vue.onBeforeMount)(() => {
-				initSelectedUsers();
+				initPromise = Promise.all([initSelectedUsers(), initRecentUsers()]).then(() => void 0);
 			});
-			(0, vue.onMounted)(() => {
+			/**
+			* 组件挂载后初始化
+			*/
+			(0, vue.onMounted)(async () => {
 				initSortable();
 				(0, vue.nextTick)(calculateVisibleUsers);
+				if (props.autoFocus && !props.disabled) {
+					await initPromise;
+					await (0, vue.nextTick)();
+					handleFocus();
+				}
 			});
+			/**
+			* 组件卸载前清理
+			*/
 			(0, vue.onUnmounted)(() => {
 				sortableInstance.value?.destroy();
 			});
+			__expose({
+				focus: handleFocus,
+				blur
+			});
 			const __returned__ = {
 				t,
 				props,
 				emit,
+				handleApiError,
+				handleApiUnauthorized,
 				tenants,
 				searchResults,
 				searchLoading,
@@ -3860,17 +4769,35 @@
 				visibleUsers,
 				hiddenCount,
 				highlightedIndex,
+				recentUsers,
+				get recentUsersRequestId() {
+					return recentUsersRequestId;
+				},
+				set recentUsersRequestId(v) {
+					recentUsersRequestId = v;
+				},
+				get recentUserIdsSnapshot() {
+					return recentUserIdsSnapshot;
+				},
+				set recentUserIdsSnapshot(v) {
+					recentUserIdsSnapshot = v;
+				},
 				selectedUsers,
 				isTextareaMode,
 				textareaHeight,
 				textareaStyle,
 				collapsedDisplayUsers,
-				showDropdown,
 				modelValueIds,
 				computedPlaceholder,
 				computedUserGroupName,
 				computedEmptyText,
+				computedRecentUsersName,
 				selectedUserIds,
+				isUserMatchedByQuery,
+				getLookupFields,
+				findUserByLookupId,
+				sortUsersByLookupIds,
+				lookupFormattedUsersByIds,
 				isMaxCountReached,
 				isMeTagDisabled,
 				userTagCommonProps,
@@ -3879,14 +4806,19 @@
 				createCustomUser,
 				handlePaste,
 				displayOptions,
+				mainNavigableUsers,
+				filteredRecentUsers,
+				showDropdown,
 				flatOptions,
 				inputWidth,
 				initSelectedUsers,
+				initRecentUsers,
 				updateSelectedUsers,
 				initSortable,
 				calculateVisibleUsers,
 				handleFocus,
 				scheduleVisibleUsersCalculation,
+				blur,
 				handleClickOutside,
 				handleContainerClick,
 				focusCurrentInput,
@@ -3898,6 +4830,12 @@
 				handleKeyDown,
 				addUser,
 				removeUser,
+				get initPromise() {
+					return initPromise;
+				},
+				set initPromise(v) {
+					initPromise = v;
+				},
 				get Popover() {
 					return bkui_vue.Popover;
 				},
@@ -3918,6 +4856,8 @@
 			return __returned__;
 		}
 	});
+	//#endregion
+	//#region src/components/user-selector.vue
 	var _hoisted_1 = {
 		ref: "sortableContainerRef",
 		class: "tag-list"
@@ -3942,6 +4882,8 @@
 			"is-show": $setup.showDropdown,
 			loading: $setup.searchLoading,
 			options: $setup.displayOptions,
+			"recent-users": $setup.filteredRecentUsers,
+			"recent-users-name": $setup.computedRecentUsersName,
 			"render-list-item": $props.renderListItem,
 			"search-query": $setup.searchQuery,
 			"tenant-id": $props.tenantId,
@@ -4093,6 +5035,8 @@
 			"is-show",
 			"loading",
 			"options",
+			"recent-users",
+			"recent-users-name",
 			"render-list-item",
 			"search-query",
 			"tenant-id",
@@ -4101,12 +5045,15 @@
 			"user-group-name"
 		])], 2);
 	}
-	var user_selector_default = /* @__PURE__ */ __plugin_vue_export_helper_default(user_selector_vue_vue_type_script_setup_true_lang_default, [
+	var user_selector_default = /* @__PURE__ */ _plugin_vue_export_helper_default(user_selector_vue_vue_type_script_setup_true_lang_default, [
 		["render", _sfc_render],
 		["__scopeId", "data-v-089550be"],
 		["__file", "/Users/brooklin/project/bkui-monorepo/packages/bk-user-selector/src/components/user-selector.vue"]
 	]);
+	//#endregion
+	//#region src/vue3.ts
 	var vue3_default = user_selector_default;
+	//#endregion
 	exports.BkUserSelector = user_selector_default;
 	exports.default = vue3_default;
 });