@sdata/web-vue 1.11.0 → 1.12.0

package/es/_components/select-view/style/index.css

@@ -30,12 +30,10 @@
   font-weight: 500;
   font-size: 12px;
   line-height: 22px;
+  white-space: nowrap;
   vertical-align: middle;
   border: 1px solid transparent;
   border-radius: var(--border-radius-small);
-  overflow: hidden;
-  white-space: nowrap;
-  text-overflow: ellipsis;
 }
 .sd-tag .sd-icon-hover.sd-tag-icon-hover::before {
   width: 16px;
@@ -90,9 +88,18 @@
   color: var(--color-text-2);
 }
 .sd-tag-text {
-  overflow: hidden;
-  white-space: nowrap;
-  text-overflow: ellipsis;
+  min-width: 0;
+  max-width: 100%;
+}
+.sd-tag-ellipsis-line-clamp {
+  height: auto;
+}
+.sd-tag-no-ellipsis {
+  min-width: fit-content;
+}
+.sd-tag-no-ellipsis .sd-tag-text {
+  min-width: fit-content;
+  max-width: none;
 }
 .sd-tag .sd-tag.sd-tag-checked.sd-tag-red {
   color: rgb(var(--red-6));

package/es/_components/virtual-list/virtual-list.vue_vue_type_script_lang.js

@@ -1,8 +1,8 @@
-import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getPrefixCls } from "../../_utils/global-config.js";
 import { isObject, isString } from "../../_utils/is.js";
 import { useVirtualSize } from "./use-virtual-size.js";
-import { _asyncToGenerator } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/asyncToGenerator.js";
+import { _asyncToGenerator } from "../../_virtual/_@oxc-project_runtime@0.130.0/helpers/asyncToGenerator.js";
 import { computed, defineComponent, nextTick, onBeforeUnmount, onMounted, onUpdated, ref, watch } from "vue";
 import { OverlayScrollbars } from "overlayscrollbars";
 import { DynamicScroller, DynamicScrollerItem, RecycleScroller } from "vue-virtual-scroller";

package/es/_hooks/use-allow-search.d.ts

@@ -0,0 +1,10 @@
+import { Ref } from 'vue';
+interface UseAllowSearchOptions<T> {
+    compatPropNames?: readonly string[];
+    getCompatValue?: () => T | undefined;
+    getDefaultValue?: () => T | undefined;
+}
+export declare const useAllowSearch: <T>(allowSearch?: Ref<T | undefined>, options?: UseAllowSearchOptions<T>) => {
+    mergedAllowSearch: import("vue").ComputedRef<T | undefined>;
+};
+export {};

package/es/_hooks/use-allow-search.js

@@ -0,0 +1,31 @@
+import { configProviderInjectionKey } from "../config-provider/context.js";
+import { computed, getCurrentInstance, inject } from "vue";
+//#region components/_hooks/use-allow-search.ts
+var ALLOW_SEARCH_PROP_NAMES = ["allowSearch", "allow-search"];
+var useAllowSearch = (allowSearch, options = {}) => {
+	const instance = getCurrentInstance();
+	const configProviderCtx = inject(configProviderInjectionKey, void 0);
+	const hasAllowSearchProp = computed(() => {
+		const rawProps = instance === null || instance === void 0 ? void 0 : instance.vnode.props;
+		if (!rawProps) return false;
+		return ALLOW_SEARCH_PROP_NAMES.some((propName) => Object.hasOwn(rawProps, propName));
+	});
+	const hasCompatProp = computed(() => {
+		var _options$compatPropNa;
+		const rawProps = instance === null || instance === void 0 ? void 0 : instance.vnode.props;
+		if (!rawProps || !((_options$compatPropNa = options.compatPropNames) === null || _options$compatPropNa === void 0 ? void 0 : _options$compatPropNa.length)) return false;
+		return options.compatPropNames.some((propName) => Object.hasOwn(rawProps, propName));
+	});
+	return { mergedAllowSearch: computed(() => {
+		var _options$getDefaultVa, _options$getDefaultVa2;
+		if (hasAllowSearchProp.value) return allowSearch === null || allowSearch === void 0 ? void 0 : allowSearch.value;
+		if (hasCompatProp.value) {
+			var _options$getCompatVal;
+			return (_options$getCompatVal = options.getCompatValue) === null || _options$getCompatVal === void 0 ? void 0 : _options$getCompatVal.call(options);
+		}
+		if ((configProviderCtx === null || configProviderCtx === void 0 ? void 0 : configProviderCtx.allowSearch) === true) return true;
+		return (_options$getDefaultVa = (_options$getDefaultVa2 = options.getDefaultValue) === null || _options$getDefaultVa2 === void 0 ? void 0 : _options$getDefaultVa2.call(options)) !== null && _options$getDefaultVa !== void 0 ? _options$getDefaultVa : allowSearch === null || allowSearch === void 0 ? void 0 : allowSearch.value;
+	}) };
+};
+//#endregion
+export { useAllowSearch };

package/es/_hooks/use-scrollbar.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { isBoolean } from "../_utils/is.js";
 import { computed } from "vue";
 //#region components/_hooks/use-scrollbar.ts

package/es/_utils/color.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 //#region components/_utils/color.ts
 var hsvToRgb = (h, s, v) => {
 	const i = Math.floor(h * 6);

package/es/_utils/date.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { isArray, isDayjs, isQuarter } from "./is.js";
 import originDayjs from "dayjs";
 import AdvancedFormat from "dayjs/plugin/advancedFormat";
@@ -44,6 +44,12 @@ var methods = {
 	startOf(time, unit) {
 		return time.startOf(unit);
 	},
+	/**
+	* Similar to `startOf`, returns start date of a week; used in week pickers
+	* @param time Selected date
+	* @param weekStart Start day of a week
+	* @returns Start date of the week containing the selected date
+	*/
 	startOfWeek(time, weekStart) {
 		const currentDay = time.day();
 		let startOfWeek = time.subtract(currentDay - weekStart, "day");

package/es/_utils/dom.js

@@ -48,7 +48,7 @@ var getOverlay = (type) => {
 };
 var querySelector = (selectors, container) => {
 	var _querySelector;
-	if (isServerRendering) return /* @__PURE__ */ NOOP();
+	if (isServerRendering) return void 0;
 	return (_querySelector = (container !== null && container !== void 0 ? container : document).querySelector(selectors)) !== null && _querySelector !== void 0 ? _querySelector : void 0;
 };
 var getElement = (target, container) => {

package/es/_utils/global-config.js

@@ -1,5 +1,5 @@
 import { configProviderInjectionKey } from "../config-provider/context.js";
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getCurrentInstance, inject } from "vue";
 //#region components/_utils/global-config.ts
 var COMPONENT_PREFIX = "Sd";

package/es/_utils/omit.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 //#region components/_utils/omit.ts
 var omit = (object, path) => {
 	const result = _objectSpread2({}, object);

package/es/_utils/responsive-observe.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 //#region components/_utils/responsive-observe.ts
 var responsiveArray = [
 	"xxl",

package/es/_utils/virtual-dropdown.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 //#region components/_utils/virtual-dropdown.ts
 var DEFAULT_VIRTUAL_DROPDOWN_HEIGHT = "200px";
 function resolveDropdownVirtualListProps(virtualListProps, triggerProps, defaultItemSize) {

package/es/_utils/vue-utils.js

@@ -1,34 +1,20 @@
 import { isArray, isFunction, isString } from "./is.js";
 import { Fragment, cloneVNode, isVNode } from "vue";
 //#region components/_utils/vue-utils.ts
-var ShapeFlags = /* @__PURE__ */ function(ShapeFlags) {
-	ShapeFlags[ShapeFlags["ELEMENT"] = 1] = "ELEMENT";
-	ShapeFlags[ShapeFlags["FUNCTIONAL_COMPONENT"] = 2] = "FUNCTIONAL_COMPONENT";
-	ShapeFlags[ShapeFlags["STATEFUL_COMPONENT"] = 4] = "STATEFUL_COMPONENT";
-	ShapeFlags[ShapeFlags["COMPONENT"] = ShapeFlags.STATEFUL_COMPONENT | ShapeFlags.FUNCTIONAL_COMPONENT] = "COMPONENT";
-	ShapeFlags[ShapeFlags["TEXT_CHILDREN"] = 8] = "TEXT_CHILDREN";
-	ShapeFlags[ShapeFlags["ARRAY_CHILDREN"] = 16] = "ARRAY_CHILDREN";
-	ShapeFlags[ShapeFlags["SLOTS_CHILDREN"] = 32] = "SLOTS_CHILDREN";
-	ShapeFlags[ShapeFlags["TELEPORT"] = 64] = "TELEPORT";
-	ShapeFlags[ShapeFlags["SUSPENSE"] = 128] = "SUSPENSE";
-	ShapeFlags[ShapeFlags["COMPONENT_SHOULD_KEEP_ALIVE"] = 256] = "COMPONENT_SHOULD_KEEP_ALIVE";
-	ShapeFlags[ShapeFlags["COMPONENT_KEPT_ALIVE"] = 512] = "COMPONENT_KEPT_ALIVE";
-	return ShapeFlags;
-}({});
 var isElement = (vn) => {
-	return Boolean(vn && vn.shapeFlag & ShapeFlags.ELEMENT);
+	return Boolean(vn && vn.shapeFlag & 1);
 };
 var isComponent = (vn, _type) => {
-	return Boolean(vn && vn.shapeFlag & ShapeFlags.COMPONENT);
+	return Boolean(vn && vn.shapeFlag & 6);
 };
 var isTextChildren = (child, _children) => {
 	return Boolean(child && child.shapeFlag & 8);
 };
 var isArrayChildren = (vn, _children) => {
-	return Boolean(vn && vn.shapeFlag & ShapeFlags.ARRAY_CHILDREN);
+	return Boolean(vn && vn.shapeFlag & 16);
 };
 var isSlotsChildren = (vn, _children) => {
-	return Boolean(vn && vn.shapeFlag & ShapeFlags.SLOTS_CHILDREN);
+	return Boolean(vn && vn.shapeFlag & 32);
 };
 var getFirstComponent = (children) => {
 	if (!children) return;

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/asyncToGenerator.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.124.0/helpers/asyncToGenerator.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/asyncToGenerator.js
 function asyncGeneratorStep(n, t, e, r, o, a, c) {
 	try {
 		var i = n[a](c), u = i.value;

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/defineProperty.js

@@ -1,5 +1,5 @@
 import { toPropertyKey } from "./toPropertyKey.js";
-//#region \0@oxc-project+runtime@0.124.0/helpers/defineProperty.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/defineProperty.js
 function _defineProperty(e, r, t) {
 	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
 		value: t,

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/extends.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.124.0/helpers/extends.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/extends.js
 function _extends() {
 	return _extends = Object.assign ? Object.assign.bind() : function(n) {
 		for (var e = 1; e < arguments.length; e++) {

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/objectDestructuringEmpty.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.124.0/helpers/objectDestructuringEmpty.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/objectDestructuringEmpty.js
 function _objectDestructuringEmpty(t) {
 	if (null == t) throw new TypeError("Cannot destructure " + t);
 }

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/objectSpread2.js

@@ -1,5 +1,5 @@
 import { _defineProperty } from "./defineProperty.js";
-//#region \0@oxc-project+runtime@0.124.0/helpers/objectSpread2.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/objectSpread2.js
 function ownKeys(e, r) {
 	var t = Object.keys(e);
 	if (Object.getOwnPropertySymbols) {

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/objectWithoutProperties.js

@@ -1,5 +1,5 @@
 import { _objectWithoutPropertiesLoose } from "./objectWithoutPropertiesLoose.js";
-//#region \0@oxc-project+runtime@0.124.0/helpers/objectWithoutProperties.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/objectWithoutProperties.js
 function _objectWithoutProperties(e, t) {
 	if (null == e) return {};
 	var o, r, i = _objectWithoutPropertiesLoose(e, t);

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/objectWithoutPropertiesLoose.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.124.0/helpers/objectWithoutPropertiesLoose.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/objectWithoutPropertiesLoose.js
 function _objectWithoutPropertiesLoose(r, e) {
 	if (null == r) return {};
 	var t = {};

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/toPrimitive.js

@@ -1,5 +1,5 @@
 import { _typeof } from "./typeof.js";
-//#region \0@oxc-project+runtime@0.124.0/helpers/toPrimitive.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/toPrimitive.js
 function toPrimitive(t, r) {
 	if ("object" != _typeof(t) || !t) return t;
 	var e = t[Symbol.toPrimitive];

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/toPropertyKey.js

@@ -1,6 +1,6 @@
 import { _typeof } from "./typeof.js";
 import { toPrimitive } from "./toPrimitive.js";
-//#region \0@oxc-project+runtime@0.124.0/helpers/toPropertyKey.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/toPropertyKey.js
 function toPropertyKey(t) {
 	var i = toPrimitive(t, "string");
 	return "symbol" == _typeof(i) ? i : i + "";

package/es/_virtual/{_@oxc-project_runtime@0.124.0 → _@oxc-project_runtime@0.130.0}/helpers/typeof.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.124.0/helpers/typeof.js
+//#region \0@oxc-project+runtime@0.130.0/helpers/typeof.js
 function _typeof(o) {
 	"@babel/helpers - typeof";
 	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {

package/es/affix/affix.vue_vue_type_script_lang.js

@@ -1,4 +1,4 @@
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getPrefixCls } from "../_utils/global-config.js";
 import { isUndefined, isWindow } from "../_utils/is.js";
 import resize_observer_default from "../_components/resize-observer.js";
@@ -16,23 +16,45 @@ var affix_vue_vue_type_script_lang_default = defineComponent({
 	name: "Affix",
 	components: { ResizeObserver: resize_observer_default },
 	props: {
+		/**
+		* @zh 距离窗口顶部达到指定偏移量后触发
+		* @en Triggered when the specified offset is reached from the top of the window
+		*/
 		offsetTop: {
 			type: Number,
 			default: 0
 		},
+		/**
+		* @zh 距离窗口底部达到指定偏移量后触发
+		* @en Triggered when the specified offset is reached from the bottom of the window
+		*/
 		offsetBottom: { type: Number },
+		/**
+		* @zh 滚动容器，默认是 `window`
+		* @en Scroll container, default is `window`
+		*/
 		target: { type: [
 			String,
 			Object,
 			Function
 		] },
+		/**
+		* @zh `target`的外层滚动元素，默认是 `window`。`Affix `将会监听该元素的滚动事件，并实时更新固钉的位置。主要是为了解决 `target` 属性指定为非 `window` 元素时，如果外层元素滚动，可能会导致固钉跑出容器问题
+		* @en The outer scroll element of `target`, the default is `window`. `Affix` will monitor the scroll event of the element and update the position of the anchor in real time. The main purpose is to solve the problem that if the outer element scrolls when the target attribute is specified as a non-window element, it may cause the nail to escape from the container.
+		*/
 		targetContainer: { type: [
 			String,
 			Object,
 			Function
 		] }
 	},
-	emits: { change: (_fixed) => true },
+	emits: { 
+	/**
+	* @zh 固定状态发生改变时触发
+	* @en Triggered when the fixed state changes
+	* @param {boolean} fixed
+	*/
+change: (_fixed) => true },
 	setup(props, { emit }) {
 		const prefixCls = getPrefixCls("affix");
 		const { target, targetContainer } = toRefs(props);
@@ -109,7 +131,13 @@ var affix_vue_vue_type_script_lang_default = defineComponent({
 			updatePositionThrottle
 		};
 	},
-	methods: { updatePosition() {
+	methods: { 
+	/**
+	* @zh 更新位置
+	* @en Update position
+	* @public
+	*/
+updatePosition() {
 		this.updatePositionThrottle();
 	} }
 });

package/es/alert/alert.vue_vue_type_script_lang.js

@@ -18,32 +18,87 @@ var alert_vue_vue_type_script_lang_default = defineComponent({
 		IconCloseCircleFill
 	},
 	props: {
+		/**
+		* @zh 警告提示的类型。2.41.0 新增 `normal` 类型
+		* @en Type of the alert. 2.41.0 Added `normal` type
+		* @values info, success, warning, error, normal
+		*/
 		type: {
 			type: String,
 			default: "info"
 		},
+		/**
+		* @zh 是否展示图标
+		* @en Whether to show the icon
+		*/
 		showIcon: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否展示关闭按钮
+		* @en Whether to show the close button
+		*/
 		closable: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 警告提示的标题
+		* @en The title of the alert
+		*/
 		title: String,
+		/**
+		* @zh 是否作为顶部公告使用（去除边框和圆角）
+		* @en Whether to use as the top announcement (remove the border and rounded corners)
+		*/
 		banner: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 内容是否居中显示
+		* @en Whether the content is displayed in the center
+		*/
 		center: {
 			type: Boolean,
 			default: false
 		}
 	},
 	emits: {
+		/**
+		* @zh 点击关闭按钮时触发
+		* @en Triggered when the close button is clicked
+		* @param {MouseEvent} ev
+		*/
 		close: (_ev) => true,
+		/**
+		* @zh 关闭动画结束后触发
+		* @en Triggered after the close animation ends
+		*/
 		afterClose: () => true
 	},
+	/**
+	* @zh 标题
+	* @en Title
+	* @slot title
+	*/
+	/**
+	* @zh 图标
+	* @en Icon
+	* @slot icon
+	*/
+	/**
+	* @zh 操作项
+	* @en Actions
+	* @slot action
+	*/
+	/**
+	* @zh 关闭元素
+	* @en Close element
+	* @slot close-element
+	* @version 2.36.0
+	*/
 	setup(props, { slots, emit }) {
 		const prefixCls = getPrefixCls("alert");
 		const visible = ref(true);

package/es/anchor/anchor-link.vue_vue_type_script_lang.js

@@ -5,7 +5,15 @@ import { computed, defineComponent, inject, onMounted, ref } from "vue";
 var anchor_link_vue_vue_type_script_lang_default = defineComponent({
 	name: "AnchorLink",
 	props: {
+		/**
+		* @zh 锚点链接的文本内容
+		* @en The text content of the anchor link
+		*/
 		title: String,
+		/**
+		* @zh 锚点链接的地址
+		* @en The address of the anchor link
+		*/
 		href: String
 	},
 	setup(props) {

package/es/anchor/anchor.vue_vue_type_script_lang.js

@@ -16,6 +16,11 @@ var BOUNDARY_POSITIONS = [
 var anchor_vue_vue_type_script_lang_default = defineComponent({
 	name: "Anchor",
 	props: {
+		/**
+		* @zh 滚动边界值，设置该值为数字后，将会在距离滚动容器 `boundary` 距离时停止滚动。
+		* @en Scrolling boundary value. After setting the value to a number, it will stop scrolling when the distance is `boundary` from the scrolling container.
+		* @values 'start', 'end', 'center', 'nearest', number
+		*/
 		boundary: {
 			type: [Number, String],
 			default: "start",
@@ -23,22 +28,49 @@ var anchor_vue_vue_type_script_lang_default = defineComponent({
 				return isNumber(value) || BOUNDARY_POSITIONS.includes(value);
 			}
 		},
+		/**
+		* @zh 是否显示左侧轴线
+		* @en Whether to show the left axis
+		*/
 		lineLess: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 滚动容器
+		* @en Scroll container
+		*/
 		scrollContainer: { type: [String, Object] },
+		/**
+		* @zh 是否改变hash。设置为 `false` 时点击锚点不会改变页面的 hash
+		* @en Whether to change the hash. When set to `false`, clicking on the anchor will not change the hash of the page
+		*/
 		changeHash: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否使用平滑滚动
+		* @en Whether to use smooth scrolling
+		*/
 		smooth: {
 			type: Boolean,
 			default: true
 		}
 	},
 	emits: {
+		/**
+		* @zh 用户点击链接时触发
+		* @en Triggered when the user clicks on the link
+		* @property { string | undefined } hash
+		* @property {string} preHash
+		*/
 		select: (_hash, _preHash) => true,
+		/**
+		* @zh 链接发生改变时触发
+		* @en Triggered when the link changes
+		* @property {string} hash
+		*/
 		change: (_hash) => true
 	},
 	setup(props, { emit }) {