@vue-spark/app-helpers 0.1.0 → 0.3.0

package/dist/permission/index.js

@@ -115,7 +115,8 @@ function createPermission(options = {}) {
 const vPermission = { mounted(el, binding) {
 	const { value, arg, instance } = binding;
 	const permission = instance && instance.$permission;
-	if (!permission || !permission.check(value, arg)) el.remove();
+	if (!permission) throw new Error("`vPermission` directive must be used after `app.use(createPermission())`");
+	if (!permission.check(value, arg)) el.remove();
 } };
 
 //#endregion

package/dist/tabs/index.d.ts

@@ -3,6 +3,13 @@ import { EffectScope } from "vue";
 //#region src/tabs/index.d.ts
 type TabType = string;
 type TabsSideType = 'left' | 'right';
+interface TabsHelperRemoveOptions {
+  /**
+   * 当前激活的标签被移除时，是否激活下一个标签
+   * @default true
+   */
+  activeNext?: boolean;
+}
 interface TabsHelperOptions<TabData extends {}> {
   /**
    * 判断标签是否可移除，返回假值时，标签将不可移除
@@ -89,8 +96,15 @@ interface TabsHelper<TabData extends {}> {
    * 添加标签和标签数据，遇到重复的标签将会跳过，否则会在添加后更新激活标签
    * @param tab 标签
    * @param tabData 标签数据
+   * @param options 选项
    */
-  addTab: (tab: TabType, tabData: TabData) => void;
+  addTab: (tab: TabType, tabData: TabData, options?: {
+    /**
+     * 是否激活该标签
+     * @default true
+     */
+    active?: boolean;
+  }) => void;
   /**
    * 判断是否存在指定标签
    * @param tab 标签
@@ -119,19 +133,22 @@ interface TabsHelper<TabData extends {}> {
   /**
    * 移除指定标签，若移除的是当前激活标签则移除前会自动激活下一个标签
    * @param tab 指定标签，默认为当前激活的标签
+   * @param options 选项
    */
-  removeTab: (tab?: TabType) => Promise<void>;
+  removeTab: (tab?: TabType, options?: TabsHelperRemoveOptions) => Promise<void>;
   /**
    * 移除除过指定标签的其他可移除的标签，并将指定标签设置为激活标签
    * @param tab 指定标签，默认为当前激活的标签
+   * @param options 选项
    */
-  removeOtherTabs: (tab?: TabType) => Promise<void>;
+  removeOtherTabs: (tab?: TabType, options?: TabsHelperRemoveOptions) => Promise<void>;
   /**
    * 移除指定标签的指定方向侧的所有可移除的标签，若当前激活的标签存在被移除的标签内，则将指定标签设置为激活标签
    * @param tab 指定标签，默认为当前激活的标签
+   * @param options 选项
    */
-  removeSideTabs: (side: TabsSideType, tab?: TabType) => Promise<void>;
+  removeSideTabs: (side: TabsSideType, tab?: TabType, options?: TabsHelperRemoveOptions) => Promise<void>;
 }
 declare function createTabsHelper<TabData extends {}>(userOptions?: TabsHelperOptions<TabData>): TabsHelper<TabData>;
 //#endregion
-export { TabsHelper, TabsHelperOptions, TabsSideType, createTabsHelper };
+export { TabsHelper, TabsHelperOptions, TabsHelperRemoveOptions, TabsSideType, createTabsHelper };

package/dist/tabs/index.js

@@ -66,10 +66,10 @@ function createTabsHelper(userOptions = {}) {
 			const index = helper.indexOf(targetTab);
 			return side === "left" ? tabs.slice(0, index) : tabs.slice(index + 1);
 		},
-		addTab(targetTab, tabData) {
+		addTab(targetTab, tabData, { active = true } = {}) {
 			if (!helper.hasTab(targetTab)) {
 				setTab(targetTab, tabData);
-				setActiveTab(targetTab);
+				active && setActiveTab(targetTab);
 			}
 		},
 		hasTab(targetTab) {
@@ -101,28 +101,28 @@ function createTabsHelper(userOptions = {}) {
 			}
 			return valid;
 		},
-		async removeTab(targetTab = helper.activeTab) {
+		async removeTab(targetTab = helper.activeTab, { activeNext = true } = {}) {
 			if (tabMap.value.size <= 1 || !targetTab || !canRemoveTab(targetTab) || !await helper.tryRemoveTabs([targetTab])) return;
 			const tabs = helper.getTabs();
 			const index = helper.indexOf(targetTab);
 			const isActive = targetTab === helper.activeTab;
 			const nextTab = isActive ? tabs[index - 1] || tabs[index + 1] : null;
-			nextTab && setActiveTab(nextTab);
+			nextTab && activeNext && setActiveTab(nextTab);
 			removeTabs([targetTab]);
 		},
-		async removeOtherTabs(targetTab = helper.activeTab) {
+		async removeOtherTabs(targetTab = helper.activeTab, { activeNext = true } = {}) {
 			if (!targetTab) return;
 			const otherTabs = helper.getTabs().filter(([tab]) => tab !== targetTab && canRemoveTab(tab));
 			if (!await helper.tryRemoveTabs(otherTabs)) return;
-			targetTab !== helper.activeTab && setActiveTab(targetTab);
+			activeNext && targetTab !== helper.activeTab && setActiveTab(targetTab);
 			removeTabs(otherTabs);
 		},
-		async removeSideTabs(side, targetTab = helper.activeTab) {
+		async removeSideTabs(side, targetTab = helper.activeTab, { activeNext = true } = {}) {
 			if (!targetTab) return;
 			const sideTabs = helper.getSideTabs(targetTab, side).filter(canRemoveTab);
 			if (!await helper.tryRemoveTabs(sideTabs)) return;
 			const activeInSide = targetTab !== helper.activeTab && sideTabs.some(([tab]) => tab === helper.activeTab);
-			activeInSide && setActiveTab(targetTab);
+			activeInSide && activeNext && setActiveTab(targetTab);
 			removeTabs(sideTabs);
 		}
 	};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vue-spark/app-helpers",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "packageManager": "pnpm@10.11.0",
   "description": "Lightweight Helpers for Vue 3 Application Development.",
   "author": "leihaohao <https://github.com/l246804>",
@@ -56,20 +56,20 @@
   "devDependencies": {
     "@antfu/eslint-config": "^4.14.1",
     "@sxzz/prettier-config": "^2.2.3",
-    "@tsconfig/node22": "^22.0.2",
-    "@types/node": "^22.15.17",
+    "@tsconfig/node24": "^24.0.0",
+    "@types/node": "^24.10.0",
     "@vue/tsconfig": "^0.7.0",
     "bumpp": "^10.1.0",
     "eslint": "^9.26.0",
     "eslint-plugin-format": "^1.0.1",
-    "happy-dom": "^17.4.7",
+    "happy-dom": "^20.0.0",
     "lint-staged": "^16.1.2",
     "prettier": "^3.5.3",
     "simple-git-hooks": "^2.13.0",
     "tsdown": "^0.11.9",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.3",
+    "vitest": "^4.0.3",
     "vue": "^3.5.16",
     "vue-router": "^4.5.1"
   },