@veltra/desktop 1.2.31 → 1.2.33

package/dist/types/index.d.ts

@@ -47,7 +47,8 @@ import { TextEmits, TextExposed, TextProps, _TextExposed } from "./text.js";
 import { CheckboxGroupEmits, CheckboxGroupExposed, CheckboxGroupProps } from "./checkbox-group.js";
 import { TableEditorEmits, TableEditorExposed, TableEditorProps, _TableEditorExposed } from "./table-editor.js";
 import { NavEmits, NavExposed, NavItem, NavProps, _NavExposed } from "./nav.js";
-import { DualNavEmits, DualNavExposed, DualNavProps, DualNavRootItem, _DualNavExposed } from "./dual-nav.js";
+import { DualNavEmits, DualNavExposed, DualNavProps, DualNavRailVariant, DualNavRootItem, _DualNavExposed } from "./dual-nav.js";
+import { GroupNavEmits, GroupNavGroup, GroupNavProps } from "./group-nav.js";
 import { PasswordInputEmits, PasswordInputExposed, PasswordInputProps, _PasswordInputExposed } from "./password-input.js";
 import { DatePickerEmits, DatePickerExposed, DatePickerProps, _DatePickerExposed } from "./date-picker.js";
 import { DropdownEmits, DropdownExposed, DropdownProps, _DropdownExposed } from "./dropdown.js";
@@ -82,7 +83,7 @@ export type * from "@veltra/utils";
 
 //#region src/types/index.d.ts
 declare namespace index_d_exports {
-  export { ActionEmits, ActionExposed, ActionGroupExposed, ActionGroupProps, ActionProps, AnimationEmits, AnimationExposed, AnimationProps, AutoCompleteEmits, AutoCompleteExposed, AutoCompleteProps, BadgeEmits, BadgeExposed, BadgeProps, BarType, BatchEditColumn, BatchEditEmits, BatchEditExposed, BatchEditFeature, BatchEditFormStatus, BatchEditProps, BatchEditSlots, BatchEditStates, BreadcrumbEmits, BreadcrumbExposed, BreadcrumbItem, BreadcrumbProps, BreadcrumbSlotScope, BreakCols, Breakpoint, ButtonEmits, ButtonExposed, ButtonProps, ButtonType, CalendarDay, CalendarEmits, CalendarExposed, CalendarMonth, CalendarProps, CalendarYear, CardActionProps, CardContentProps, CardCoverProps, CardEmits, CardExposed, CardProps, CascadeEmits, CascadeExposed, CascadeNode, CascadeProps, CheckTagEmits, CheckTagExposed, CheckTagProps, CheckboxButtonEmits, CheckboxButtonProps, CheckboxEmits, CheckboxExposed, CheckboxGroupEmits, CheckboxGroupExposed, CheckboxGroupProps, CheckboxProps, CodeEditorEmits, CodeEditorExposed, CodeEditorLang, CodeEditorProps, CollapseEmits, CollapseItemProps, CollapseModelValue, CollapseProps, CollapseValue, ConditionConnector, ConditionEditorEmits, ConditionEditorExposed, ConditionEditorProps, ConditionExpression, ConditionField, ConditionGroup, ConditionLeaf, ConditionNode, ConditionValue, ContextmenuEmits, ContextmenuExposed, ContextmenuItem, ContextmenuProps, CssTransitionEmits, CssTransitionExposed, CssTransitionProps, DatePanelEmits, DatePanelProps, DatePickerEmits, DatePickerExposed, DatePickerProps, DateRangePickerEmits, DateRangePickerExposed, DateRangePickerProps, DialogEmits, DialogExposed, DialogProps, DialogTransition, DrawerDirection, DrawerEmits, DrawerExposed, DrawerMode, DrawerProps, DropdownEmits, DropdownExposed, DropdownProps, DualNavEmits, DualNavExposed, DualNavProps, DualNavRootItem, EmptyEmits, EmptyExposed, EmptyProps, ExpressionEditorEmits, ExpressionEditorExposed, ExpressionEditorProps, ExpressionSelectableLevels, FileViewerEmits, FileViewerExposed, FileViewerItem, FileViewerKind, FileViewerProps, FloatButtonEmits, FloatButtonExposed, FloatButtonItem, FloatButtonProps, FormEmits, FormExposed, FormItemEmits, FormItemExposed, FormItemProps, FormProps, GanttChartEmits, GanttChartExposed, GanttChartProps, GridEmits, GridExposed, GridInputEmits, GridInputExposed, GridInputProps, GridItemProps, GridProps, GroupInputEmits, GroupInputExposed, GroupInputProps, IconEmits, IconExposed, IconProps, InputEmits, InputExposed, InputProps, LayoutEmits, LayoutExposed, LayoutProps, ListEmits, ListExposed, ListProps, LoadingEmits, LoadingExposed, LoadingProps, LoadingType, Message, MessageConfirmEmits, MessageConfirmExposed, MessageConfirmProps, MessageEmits, MessageExposed, MessageInstance, MessageOptions, MessageProps, MessageType, MultiAutoCompleteEmits, MultiAutoCompleteExposed, MultiAutoCompleteProps, MultiSelectEmits, MultiSelectExposed, MultiSelectProps, MultiTreeSelectEmits, MultiTreeSelectExposed, MultiTreeSelectProps, NavEmits, NavExposed, NavItem, NavProps, NodeRenderExposed, NodeRenderProps, NotificationEmits, NotificationExposed, NotificationProps, NumberEmits, NumberExposed, NumberInputEmits, NumberInputExposed, NumberInputProps, NumberProps, NumberRangeInputEmits, NumberRangeInputExposed, NumberRangeInputProps, NumberRangeTuple, PaginatorEmits, PaginatorExposed, PaginatorProps, PaletteColorType, PaletteEmits, PaletteExposed, PaletteHSV, PaletteProps, PaletteRGB, PanelItem, PanelType, PasswordInputEmits, PasswordInputExposed, PasswordInputProps, PopConfirmEmits, PopConfirmExposed, PopConfirmProps, PopEmits, PopExposed, PopProps, ProgressEmits, ProgressExposed, ProgressNodesEmits, ProgressNodesExposed, ProgressNodesProps, ProgressProps, QuickBatchEditEmits, QuickBatchEditExposed, QuickBatchEditProps, RadioEmits, RadioExposed, RadioGroupEmits, RadioGroupExposed, RadioGroupProps, RadioProps, RichTextEditorEmits, RichTextEditorExposed, RichTextEditorProps, RichTextFormat, ScrollEmits, ScrollExposed, ScrollPosition, ScrollProps, SelectEmits, SelectExposed, SelectProps, SliderEmits, SliderExposed, SliderProps, StepsEmits, StepsExposed, StepsProps, StepsSlotScope, SwitchEmits, SwitchExposed, SwitchProps, TabItem, TableColumn, TableColumnAlign, TableColumnNode, TableColumnRenderContext, TableColumnSlotsScope, TableEditorEmits, TableEditorExposed, TableEditorProps, TableEmits, TableExposed, TableProps, TableRow, TableRowSlotsScope, TableSummaryContext, TabsEmits, TabsExposed, TabsHorizontalEmits, TabsHorizontalExposed, TabsHorizontalProps, TabsProps, TabsVerticalEmits, TabsVerticalExposed, TabsVerticalProps, TagEmits, TagExposed, TagProps, TextEditorEmits, TextEditorExposed, TextEditorProps, TextEmits, TextExposed, TextProps, TextareaEmits, TextareaExposed, TextareaProps, ThemeExposed, ThemeProps, TipAlign, TipDirection, TipEmits, TipExposed, TipProps, ToolbarItem, TreeEmit, TreeExposed, TreeNode, TreeNodeProps, TreeProps, TreeSelectEmits, TreeSelectExposed, TreeSelectProps, UploaderEmits, UploaderExposed, UploaderProps, VariableItem, WatermarkEmits, WatermarkExposed, WatermarkProps, _ActionExposed, _ActionGroupExposed, _AnimationExposed, _AutoCompleteExposed, _BadgeExposed, _BatchEditExposed, _BreadcrumbExposed, _ButtonExposed, _CalendarExposed, _CardExposed, _CascadeExposed, _CheckTagExposed, _CodeEditorExposed, _ConditionEditorExposed, _ContextmenuExposed, _CssTransitionExposed, _DatePickerExposed, _DateRangePickerExposed, _DialogExposed, _DrawerExposed, _DropdownExposed, _DualNavExposed, _EmptyExposed, _ExpressionEditorExposed, _FileViewerExposed, _FloatButtonExposed, _FormExposed, _GanttChartExposed, _GridExposed, _GridInputExposed, _GroupInputExposed, _InputExposed, _LayoutExposed, _ListExposed, _LoadingExposed, _MessageConfirmExposed, _MessageExposed, _MultiAutoCompleteExposed, _MultiSelectExposed, _MultiTreeSelectExposed, _NavExposed, _NotificationExposed, _PaginatorExposed, _PaletteExposed, _PasswordInputExposed, _PopConfirmExposed, _PopExposed, _ProgressExposed, _ProgressNodesExposed, _QuickBatchEditExposed, _RadioExposed, _RadioGroupExposed, _RichTextEditorExposed, _ScrollExposed, _SelectExposed, _SliderExposed, _StepsExposed, _SwitchExposed, _TableEditorExposed, _TableExposed, _TabsExposed, _TabsHorizontalExposed, _TabsVerticalExposed, _TextEditorExposed, _TextExposed, _TextareaExposed, _ThemeExposed, _TipExposed, _TreeExposed, _TreeSelectExposed, _UploaderExposed, _WatermarkExposed };
+  export { ActionEmits, ActionExposed, ActionGroupExposed, ActionGroupProps, ActionProps, AnimationEmits, AnimationExposed, AnimationProps, AutoCompleteEmits, AutoCompleteExposed, AutoCompleteProps, BadgeEmits, BadgeExposed, BadgeProps, BarType, BatchEditColumn, BatchEditEmits, BatchEditExposed, BatchEditFeature, BatchEditFormStatus, BatchEditProps, BatchEditSlots, BatchEditStates, BreadcrumbEmits, BreadcrumbExposed, BreadcrumbItem, BreadcrumbProps, BreadcrumbSlotScope, BreakCols, Breakpoint, ButtonEmits, ButtonExposed, ButtonProps, ButtonType, CalendarDay, CalendarEmits, CalendarExposed, CalendarMonth, CalendarProps, CalendarYear, CardActionProps, CardContentProps, CardCoverProps, CardEmits, CardExposed, CardProps, CascadeEmits, CascadeExposed, CascadeNode, CascadeProps, CheckTagEmits, CheckTagExposed, CheckTagProps, CheckboxButtonEmits, CheckboxButtonProps, CheckboxEmits, CheckboxExposed, CheckboxGroupEmits, CheckboxGroupExposed, CheckboxGroupProps, CheckboxProps, CodeEditorEmits, CodeEditorExposed, CodeEditorLang, CodeEditorProps, CollapseEmits, CollapseItemProps, CollapseModelValue, CollapseProps, CollapseValue, ConditionConnector, ConditionEditorEmits, ConditionEditorExposed, ConditionEditorProps, ConditionExpression, ConditionField, ConditionGroup, ConditionLeaf, ConditionNode, ConditionValue, ContextmenuEmits, ContextmenuExposed, ContextmenuItem, ContextmenuProps, CssTransitionEmits, CssTransitionExposed, CssTransitionProps, DatePanelEmits, DatePanelProps, DatePickerEmits, DatePickerExposed, DatePickerProps, DateRangePickerEmits, DateRangePickerExposed, DateRangePickerProps, DialogEmits, DialogExposed, DialogProps, DialogTransition, DrawerDirection, DrawerEmits, DrawerExposed, DrawerMode, DrawerProps, DropdownEmits, DropdownExposed, DropdownProps, DualNavEmits, DualNavExposed, DualNavProps, DualNavRailVariant, DualNavRootItem, EmptyEmits, EmptyExposed, EmptyProps, ExpressionEditorEmits, ExpressionEditorExposed, ExpressionEditorProps, ExpressionSelectableLevels, FileViewerEmits, FileViewerExposed, FileViewerItem, FileViewerKind, FileViewerProps, FloatButtonEmits, FloatButtonExposed, FloatButtonItem, FloatButtonProps, FormEmits, FormExposed, FormItemEmits, FormItemExposed, FormItemProps, FormProps, GanttChartEmits, GanttChartExposed, GanttChartProps, GridEmits, GridExposed, GridInputEmits, GridInputExposed, GridInputProps, GridItemProps, GridProps, GroupInputEmits, GroupInputExposed, GroupInputProps, GroupNavEmits, GroupNavGroup, GroupNavProps, IconEmits, IconExposed, IconProps, InputEmits, InputExposed, InputProps, LayoutEmits, LayoutExposed, LayoutProps, ListEmits, ListExposed, ListProps, LoadingEmits, LoadingExposed, LoadingProps, LoadingType, Message, MessageConfirmEmits, MessageConfirmExposed, MessageConfirmProps, MessageEmits, MessageExposed, MessageInstance, MessageOptions, MessageProps, MessageType, MultiAutoCompleteEmits, MultiAutoCompleteExposed, MultiAutoCompleteProps, MultiSelectEmits, MultiSelectExposed, MultiSelectProps, MultiTreeSelectEmits, MultiTreeSelectExposed, MultiTreeSelectProps, NavEmits, NavExposed, NavItem, NavProps, NodeRenderExposed, NodeRenderProps, NotificationEmits, NotificationExposed, NotificationProps, NumberEmits, NumberExposed, NumberInputEmits, NumberInputExposed, NumberInputProps, NumberProps, NumberRangeInputEmits, NumberRangeInputExposed, NumberRangeInputProps, NumberRangeTuple, PaginatorEmits, PaginatorExposed, PaginatorProps, PaletteColorType, PaletteEmits, PaletteExposed, PaletteHSV, PaletteProps, PaletteRGB, PanelItem, PanelType, PasswordInputEmits, PasswordInputExposed, PasswordInputProps, PopConfirmEmits, PopConfirmExposed, PopConfirmProps, PopEmits, PopExposed, PopProps, ProgressEmits, ProgressExposed, ProgressNodesEmits, ProgressNodesExposed, ProgressNodesProps, ProgressProps, QuickBatchEditEmits, QuickBatchEditExposed, QuickBatchEditProps, RadioEmits, RadioExposed, RadioGroupEmits, RadioGroupExposed, RadioGroupProps, RadioProps, RichTextEditorEmits, RichTextEditorExposed, RichTextEditorProps, RichTextFormat, ScrollEmits, ScrollExposed, ScrollPosition, ScrollProps, SelectEmits, SelectExposed, SelectProps, SliderEmits, SliderExposed, SliderProps, StepsEmits, StepsExposed, StepsProps, StepsSlotScope, SwitchEmits, SwitchExposed, SwitchProps, TabItem, TableColumn, TableColumnAlign, TableColumnNode, TableColumnRenderContext, TableColumnSlotsScope, TableEditorEmits, TableEditorExposed, TableEditorProps, TableEmits, TableExposed, TableProps, TableRow, TableRowSlotsScope, TableSummaryContext, TabsEmits, TabsExposed, TabsHorizontalEmits, TabsHorizontalExposed, TabsHorizontalProps, TabsProps, TabsVerticalEmits, TabsVerticalExposed, TabsVerticalProps, TagEmits, TagExposed, TagProps, TextEditorEmits, TextEditorExposed, TextEditorProps, TextEmits, TextExposed, TextProps, TextareaEmits, TextareaExposed, TextareaProps, ThemeExposed, ThemeProps, TipAlign, TipDirection, TipEmits, TipExposed, TipProps, ToolbarItem, TreeEmit, TreeExposed, TreeNode, TreeNodeProps, TreeProps, TreeSelectEmits, TreeSelectExposed, TreeSelectProps, UploaderEmits, UploaderExposed, UploaderProps, VariableItem, WatermarkEmits, WatermarkExposed, WatermarkProps, _ActionExposed, _ActionGroupExposed, _AnimationExposed, _AutoCompleteExposed, _BadgeExposed, _BatchEditExposed, _BreadcrumbExposed, _ButtonExposed, _CalendarExposed, _CardExposed, _CascadeExposed, _CheckTagExposed, _CodeEditorExposed, _ConditionEditorExposed, _ContextmenuExposed, _CssTransitionExposed, _DatePickerExposed, _DateRangePickerExposed, _DialogExposed, _DrawerExposed, _DropdownExposed, _DualNavExposed, _EmptyExposed, _ExpressionEditorExposed, _FileViewerExposed, _FloatButtonExposed, _FormExposed, _GanttChartExposed, _GridExposed, _GridInputExposed, _GroupInputExposed, _InputExposed, _LayoutExposed, _ListExposed, _LoadingExposed, _MessageConfirmExposed, _MessageExposed, _MultiAutoCompleteExposed, _MultiSelectExposed, _MultiTreeSelectExposed, _NavExposed, _NotificationExposed, _PaginatorExposed, _PaletteExposed, _PasswordInputExposed, _PopConfirmExposed, _PopExposed, _ProgressExposed, _ProgressNodesExposed, _QuickBatchEditExposed, _RadioExposed, _RadioGroupExposed, _RichTextEditorExposed, _ScrollExposed, _SelectExposed, _SliderExposed, _StepsExposed, _SwitchExposed, _TableEditorExposed, _TableExposed, _TabsExposed, _TabsHorizontalExposed, _TabsVerticalExposed, _TextEditorExposed, _TextExposed, _TextareaExposed, _ThemeExposed, _TipExposed, _TreeExposed, _TreeSelectExposed, _UploaderExposed, _WatermarkExposed };
 }
 import * as import__veltra_utils from "@veltra/utils";
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/desktop",
-  "version": "1.2.31",
+  "version": "1.2.33",
   "files": [
     "dist",
     "src"
@@ -57,11 +57,11 @@
     "@cat-kit/core": ">=1.1.8",
     "@cat-kit/excel": ">=1.0.0",
     "@cat-kit/fe": "^1.1.8",
-    "@veltra/compositions": "1.2.31",
-    "@veltra/directives": "1.2.31",
-    "@veltra/icons": "1.2.31",
-    "@veltra/styles": "1.2.31",
-    "@veltra/utils": "1.2.31",
+    "@veltra/compositions": "1.2.33",
+    "@veltra/directives": "1.2.33",
+    "@veltra/icons": "1.2.33",
+    "@veltra/styles": "1.2.33",
+    "@veltra/utils": "1.2.33",
     "vue": ">=3.5.39"
   },
   "devDependencies": {
@@ -72,6 +72,7 @@
     "@codemirror/lang-json": "6.0.2",
     "@codemirror/lang-sql": "6.10.0",
     "@codemirror/language": "6.12.4",
+    "@codemirror/legacy-modes": "6.5.3",
     "@codemirror/lint": "6.9.7",
     "@codemirror/search": "6.7.1",
     "@codemirror/state": "6.7.0",

package/src/components/batch-edit/use-handlers.ts

@@ -196,7 +196,10 @@ export function useHandlers(options: Options): EditReturned {
     const { deleteMethod } = props
 
     if (deleteMethod) {
-      await deleteMethod([row.data])
+      const result = await deleteMethod([row.data])
+      if (result === false) {
+        return
+      }
     }
 
     const data = [...(props.data ?? [])]

package/src/components/code-editor/lang-loaders.ts

@@ -8,7 +8,9 @@ const LANG_LOADERS: Record<CodeEditorLang, () => Promise<Extension>> = {
   sql: () => import('@codemirror/lang-sql').then((m) => m.sql()),
   java: () => import('@codemirror/lang-java').then((m) => m.java()),
   json: () => import('@codemirror/lang-json').then((m) => m.json()),
-  spel: () => import('./langs/spel').then((m) => m.spel())
+  spel: () => import('./langs/spel').then((m) => m.spel()),
+  bash: () => import('./langs/bash').then((m) => m.bash()),
+  powershell: () => import('./langs/powershell').then((m) => m.powershell())
 }
 
 /** 按需加载语言扩展；模块缓存由运行时保证，重复切换同一语言不会重复下载 */

package/src/components/code-editor/langs/bash/index.ts

@@ -0,0 +1,7 @@
+import { LanguageSupport, StreamLanguage } from '@codemirror/language'
+import { shell } from '@codemirror/legacy-modes/mode/shell'
+
+/** Bash / shell 脚本语言支持（基于 CodeMirror legacy shell mode） */
+export function bash(): LanguageSupport {
+  return new LanguageSupport(StreamLanguage.define(shell))
+}

package/src/components/code-editor/langs/powershell/index.ts

@@ -0,0 +1,7 @@
+import { LanguageSupport, StreamLanguage } from '@codemirror/language'
+import { powerShell } from '@codemirror/legacy-modes/mode/powershell'
+
+/** PowerShell 语言支持（基于 CodeMirror legacy powershell mode） */
+export function powershell(): LanguageSupport {
+  return new LanguageSupport(StreamLanguage.define(powerShell))
+}

package/src/components/dual-nav/dual-nav-app.vue

@@ -1,5 +1,5 @@
 <template>
-  <u-tip v-model:visible="tipVisible" direction="right" hide-arrow :disabled="tipSuppressed">
+  <u-tip v-model:visible="tipVisible" direction="right" hide-arrow :disabled="tipDisabled">
     <button
       type="button"
       v-ripple="!app.disabled"
@@ -15,6 +15,7 @@
     >
       <UNavIcon v-if="app.icon" :icon="app.icon" :class="cls.e('app-icon')" />
       <span v-else :class="cls.e('app-fallback')">{{ app.title[0] }}</span>
+      <span v-if="labeled" :class="cls.e('app-label')">{{ displayTitle }}</span>
     </button>
 
     <template #content>
@@ -31,7 +32,7 @@
 <script setup lang="ts">
 import { vRipple } from '@veltra/directives'
 import { bem } from '@veltra/utils'
-import { shallowRef } from 'vue'
+import { computed, shallowRef } from 'vue'
 
 import type { DualNavRootItem } from '../../types'
 import UNavIcon from '../nav/nav-icon.vue'
@@ -41,7 +42,16 @@ defineOptions({ name: 'UDualNavApp' })
 
 const cls = bem('dual-nav')
 
-defineProps<{ app: DualNavRootItem; active: boolean; selected: boolean }>()
+/** 左轨菜单名称最多展示字数 */
+const LABEL_MAX_LENGTH = 4
+
+const props = defineProps<{
+  app: DualNavRootItem
+  active: boolean
+  selected: boolean
+  /** 是否在图标下方显示菜单名称 */
+  labeled?: boolean
+}>()
 
 const emit = defineEmits<{ click: [] }>()
 
@@ -49,6 +59,15 @@ const tipVisible = shallowRef(false)
 /** 点击后暂时禁用 hover 弹出，移出触发区后恢复 */
 const tipSuppressed = shallowRef(false)
 
+const displayTitle = computed(() => props.app.title.slice(0, LABEL_MAX_LENGTH))
+
+/** labeled 且标题未截断、无描述时，tooltip 无额外信息 */
+const tipUnnecessary = computed(() => {
+  return !!props.labeled && props.app.title.length <= LABEL_MAX_LENGTH && !props.app.description
+})
+
+const tipDisabled = computed(() => tipSuppressed.value || tipUnnecessary.value)
+
 function handleClick() {
   tipSuppressed.value = true
   tipVisible.value = false

package/src/components/dual-nav/dual-nav.vue

@@ -1,5 +1,5 @@
 <template>
-  <div :class="cls.b">
+  <div :class="[cls.b, railVariant === 'labeled' && cls.m('labeled')]">
     <div :class="cls.e('rail')">
       <DualNavApp
         v-for="app in menus"
@@ -7,6 +7,7 @@
         :app="app"
         :active="isAppActive(app)"
         :selected="isAppSelected(app)"
+        :labeled="railVariant === 'labeled'"
         @click="handleAppClick(app)"
       />
     </div>
@@ -72,7 +73,7 @@ import { findFirstLeaf, findRootApp } from './helper'
 
 defineOptions({ name: 'UDualNav' })
 
-const props = defineProps<DualNavProps>()
+const props = withDefaults(defineProps<DualNavProps>(), { railVariant: 'icon' })
 const emit = defineEmits<DualNavEmits>()
 
 const cls = bem('dual-nav')

package/src/components/dual-nav/style.scss

@@ -2,7 +2,9 @@
 @use 'pkg:@veltra/styles/functions' as fn;
 @use 'pkg:@veltra/styles/vars';
 
-@include m.b(dual-nav) {
+$root-name: dual-nav;
+
+@include m.b($root-name) {
   display: flex;
   height: 100%;
   min-height: 0;
@@ -21,6 +23,23 @@
     background-color: fn.use-var(bg-color, middle);
   }
 
+  @include m.m(labeled) {
+    @include m.bem($root-name, rail) {
+      width: var(--u-nav-rail-labeled-width);
+      padding: 8px 4px;
+      gap: 2px;
+    }
+
+    @include m.bem($root-name, app) {
+      aspect-ratio: auto;
+      max-width: none;
+      flex-direction: column;
+      gap: 2px;
+      padding: 6px 2px;
+      min-height: 0;
+    }
+  }
+
   @include m.e(divider) {
     flex-shrink: 0;
     width: 1px;
@@ -164,6 +183,16 @@
     line-height: 1;
   }
 
+  @include m.e(app-label) {
+    max-width: 100%;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    font-size: fn.use-var(font-size-assist, default);
+    line-height: 1.2;
+    text-align: center;
+  }
+
   @include m.e(app-tip) {
     display: flex;
     flex-direction: column;

package/src/components/group-nav/group-nav-item.vue

@@ -0,0 +1,32 @@
+<template>
+  <li
+    :class="[cls.e('item'), bem.is('active', active), bem.is('disabled', item.disabled ?? false)]"
+    @click="handleClick"
+  >
+    <NavIcon v-if="item.icon" :icon="item.icon" :class="cls.e('icon')" />
+
+    <span :class="cls.e('item-title')">
+      {{ item.title }}
+    </span>
+  </li>
+</template>
+
+<script setup lang="ts">
+import { bem } from '@veltra/utils'
+
+import type { NavItem } from '../../types/nav'
+import NavIcon from '../nav/nav-icon.vue'
+
+defineOptions({ name: 'UGroupNavItem' })
+
+const props = defineProps<{ item: NavItem; active: boolean }>()
+
+const emit = defineEmits<{ (e: 'click', item: NavItem): void }>()
+
+const cls = bem('group-nav')
+
+function handleClick() {
+  if (props.item.disabled) return
+  emit('click', props.item)
+}
+</script>

package/src/components/group-nav/group-nav.vue

@@ -0,0 +1,36 @@
+<template>
+  <u-scroll tag="ul" :class="cls.b" :container-class="cls.e('container')">
+    <li v-for="(group, index) of groups" :key="group.title || index" :class="cls.e('group')">
+      <div :class="cls.e('group-label')">{{ group.title }}</div>
+      <ul :class="cls.e('group-list')">
+        <GroupNavItem
+          v-for="(child, childIndex) of group.children"
+          :key="child.path || childIndex"
+          :item="child"
+          :active="currentPath === child.path"
+          @click="handleItemClick"
+        />
+      </ul>
+    </li>
+  </u-scroll>
+</template>
+
+<script lang="ts" setup>
+import { bem } from '@veltra/utils'
+
+import type { GroupNavEmits, GroupNavProps } from '../../types/group-nav'
+import type { NavItem } from '../../types/nav'
+import { UScroll } from '../scroll'
+import GroupNavItem from './group-nav-item.vue'
+
+defineOptions({ name: 'UGroupNav' })
+
+defineProps<GroupNavProps>()
+const emit = defineEmits<GroupNavEmits>()
+
+const cls = bem('group-nav')
+
+function handleItemClick(item: NavItem) {
+  emit('item-click', item)
+}
+</script>

package/src/components/group-nav/index.ts

@@ -0,0 +1 @@
+export { default as UGroupNav } from './group-nav.vue'

package/src/components/group-nav/style.scss

@@ -0,0 +1,121 @@
+@use 'pkg:@veltra/styles/mixins' as m;
+@use 'pkg:@veltra/styles/functions' as fn;
+@use 'pkg:@veltra/styles/vars';
+
+@include m.b(group-nav) {
+  margin: 0;
+  padding: 0;
+  user-select: none;
+  color: var(--u-nav-color);
+  background-color: var(--u-nav-bg-color);
+  backdrop-filter: fn.use-var(bg-filter);
+  -webkit-backdrop-filter: fn.use-var(bg-filter);
+  background-image: var(--u-nav-bg-image);
+  background-size: cover;
+  background-repeat: no-repeat;
+  border: 1px solid fn.use-var(border, color);
+  border-radius: calc(fn.use-var(radius, large) + 6px);
+  box-shadow:
+    0 1px 2px rgba(15, 23, 42, 0.05),
+    0 12px 28px rgba(15, 23, 42, 0.08);
+
+  @include m.e(container) {
+    padding: 8px;
+  }
+
+  @include m.e(group, group-list, item) {
+    list-style: none;
+    margin: 0;
+    padding: 0;
+  }
+
+  // 组与组之间统一间距（仅 groups，无独立叶子）
+  @include m.e(group) {
+    & + & {
+      margin-top: 16px;
+    }
+  }
+
+  @include m.e(group-label) {
+    padding: 0 8px 6px;
+    font-size: fn.use-var(font-size-assist, default);
+    font-weight: 500;
+    line-height: 1.4;
+    letter-spacing: 0.02em;
+    color: fn.use-var(text-color, second);
+  }
+
+  @include m.e(group-list) {
+    display: flex;
+    flex-direction: column;
+    gap: 3px;
+  }
+
+  @include m.e(item) {
+    width: 100%;
+    min-height: var(--u-nav-height-default);
+    margin: 0;
+    padding: 0 8px;
+    gap: 8px;
+    cursor: pointer;
+    color: inherit;
+    border-radius: calc(fn.use-var(radius, default) + 4px);
+    transition:
+      background-color 0.15s ease,
+      color 0.15s ease;
+
+    @include m.flex;
+
+    &:hover {
+      background-color: var(--u-nav-hover-bg);
+      color: var(--u-nav-hover-color);
+    }
+
+    @include m.is(active) {
+      position: relative;
+      background-color: var(--u-nav-active-bg);
+      color: var(--u-nav-active-color);
+
+      &::before {
+        content: '';
+        position: absolute;
+        left: 0;
+        top: 50%;
+        width: 3px;
+        height: 56%;
+        min-height: 10px;
+        border-radius: 9999px;
+        background-color: fn.use-var(color, primary);
+        transform: translateY(-50%);
+        pointer-events: none;
+      }
+    }
+
+    @include m.is(disabled) {
+      opacity: 0.55;
+      cursor: not-allowed;
+    }
+  }
+
+  @include m.e(icon) {
+    width: 16px;
+    height: 16px;
+    font-size: 16px;
+    flex-shrink: 0;
+    display: inline-flex;
+    justify-content: center;
+    align-items: center;
+    border-radius: calc(fn.use-var(radius, small) + 2px);
+    color: inherit;
+    object-fit: contain;
+  }
+
+  @include m.e(item-title) {
+    flex: 1;
+    min-width: 0;
+    font-size: fn.use-var(font-size-main, default);
+    font-weight: 500;
+    letter-spacing: 0.01em;
+    @include m.ellipsis;
+  }
+}

package/src/components/group-nav/style.ts

@@ -0,0 +1,3 @@
+import '../nav/style'
+import '../scroll/style'
+import './style.scss'

package/src/components/index.ts

@@ -112,6 +112,8 @@ export * from './nav'
 
 export * from './dual-nav'
 
+export * from './group-nav'
+
 export * from './grid-input'
 
 export * from './switch'

package/src/style.ts

@@ -38,6 +38,7 @@ import './components/layout/style'
 import './components/list/style'
 import './components/loading/style'
 import './components/dual-nav/style'
+import './components/group-nav/style'
 import './components/nav/style'
 import './components/message-confirm/style'
 import './components/message/style'

package/src/types/batch-edit.ts

@@ -58,7 +58,11 @@ export interface BatchEditProps extends TableProps {
   ) => void | Promise<void>
   /** label的宽度 */
   labelWidth?: string | number
-  /** 删除方法 */
+  /**
+   * 删除方法
+   * @description 删除时调用。如果返回 false，则不删除
+   * @returns 如果返回 false，则不删除
+   */
   deleteMethod?: (data: Record<string, any>[]) => any
   /**
    * 保存方法

package/src/types/code-editor.ts

@@ -1,6 +1,6 @@
 import type { DeconstructValue, FormComponentProps } from '@veltra/utils'
 
-export type CodeEditorLang = 'js' | 'sql' | 'java' | 'json' | 'spel'
+export type CodeEditorLang = 'js' | 'sql' | 'java' | 'json' | 'spel' | 'bash' | 'powershell'
 
 /** 代码编辑器组件属性（不支持 `size`） */
 export interface CodeEditorProps extends Omit<FormComponentProps, 'size'> {

package/src/types/dual-nav.ts

@@ -2,6 +2,9 @@ import type { DeconstructValue } from '@veltra/utils'
 
 import type { NavItem } from './nav'
 
+/** 双栏导航左轨变体 */
+export type DualNavRailVariant = 'icon' | 'labeled'
+
 /** 双栏导航根级应用项；`description` 在左轨 tooltip 与右栏顶部展示 */
 export interface DualNavRootItem extends NavItem {
   /** 子导航 */
@@ -14,6 +17,12 @@ export interface DualNavProps {
   currentPath?: string
   /** 根级应用导航列表 */
   menus?: DualNavRootItem[]
+  /**
+   * 左轨变体
+   * - `icon`：仅图标（默认）
+   * - `labeled`：加宽左轨，图标下方显示菜单名称（最多 4 个字）
+   */
+  railVariant?: DualNavRailVariant
 }
 
 /** 双栏导航组件定义的事件 */

package/src/types/group-nav.ts

@@ -0,0 +1,20 @@
+import type { NavItem } from './nav'
+
+/** 分组：标题 + 叶子菜单 */
+export interface GroupNavGroup {
+  title: string
+  children: NavItem[]
+}
+
+/** 分组导航组件属性 */
+export interface GroupNavProps {
+  /** 当前路径 */
+  currentPath?: string
+  /** 分组列表（每组仅渲染一层叶子，更深嵌套舍弃） */
+  groups?: GroupNavGroup[]
+}
+
+/** 分组导航组件定义的事件 */
+export interface GroupNavEmits {
+  (e: 'item-click', item: NavItem): void
+}

package/src/types/index.ts

@@ -49,6 +49,7 @@ export * from './table-editor'
 export * from './table'
 export * from './nav'
 export * from './dual-nav'
+export * from './group-nav'
 export * from './password-input'
 export * from './date-picker'
 export * from './dropdown'