tabby-group-server-stats 1.7.4 → 1.7.5

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tabby-group-server-stats",
-    "version": "1.7.4",
+    "version": "1.7.5",
     "description": "Tabby server monitoring: CPU, memory, disk, network and GPU metrics with grouped labels and hover details. Tabby 服务器监控：显存、磁盘、网络、自定义指标与多标签组。",
     "keywords": [
         "tabby-plugin",
@@ -54,7 +54,9 @@
         "PUBLISHING.zh-CN.md",
         "README.en.md",
         "presets.json",
-        "docs/images"
+        "docs/images",
+        "docs/tutorial.zh-CN.pdf",
+        "docs/tutorial.en.pdf"
     ],
     "repository": {
         "type": "git",

package/typings/builtin-metrics.d.ts

@@ -1,16 +1,22 @@
 import { CustomMetric, CustomMetricGroup } from './metric-model';
-export type BuiltinMetricKey = 'cpu' | 'ram' | 'disk' | 'net';
+export type BuiltinMetricKey = 'ram' | 'net' | 'load';
+export type LegacyBuiltinMetricKey = 'cpu' | 'disk';
+type StoredBuiltinMetricKey = BuiltinMetricKey | LegacyBuiltinMetricKey;
 export interface BuiltinDefinitions {
     cpu: CustomMetric;
     ram: CustomMetric;
     disk: CustomMetric;
     net: CustomMetricGroup;
+    load: CustomMetricGroup;
 }
 export interface BuiltinConfig {
-    defaultMetrics?: Partial<Record<BuiltinMetricKey, boolean>>;
+    defaultMetrics?: Partial<Record<StoredBuiltinMetricKey, boolean>>;
     defaultMetricOverrides?: Partial<BuiltinDefinitions>;
     showDefaultIcons?: boolean;
-    builtinOrder?: BuiltinMetricKey[];
+    builtinOrder?: StoredBuiltinMetricKey[];
+    builtinDefaultsVersion?: number;
+    customMetrics?: CustomMetric[];
+    metricGroups?: CustomMetricGroup[];
 }
 /** Keep disabled slots in the saved order; only the visible definitions are filtered. */
 export declare function normalizeBuiltinOrder(value?: readonly unknown[]): BuiltinMetricKey[];
@@ -19,8 +25,10 @@ export interface OrderedMetricItem {
     metric?: CustomMetric;
     group?: CustomMetricGroup;
 }
-/** Mix built-in singles and the network group before the unchanged custom item order. */
+/** Mix built-in singles and groups before the unchanged custom item order. */
 export declare function orderBuiltinItems(metrics: CustomMetric[], groups: CustomMetricGroup[], order?: readonly unknown[]): OrderedMetricItem[];
+/** Load is normalized by logical processor count, not the busy-CPU percentage. */
+export declare function createCpuLoadCommand(minutes: 1 | 5, detail?: boolean): string;
 /** Each sample owns its shell variables; concurrent panes never share a temp file. */
 export declare function createCpuSampleCommand(counter?: 'busy' | 'iowait' | 'steal'): string;
 export declare function createNetworkRateCommand(direction: 'rx' | 'tx' | 'total'): string;
@@ -28,9 +36,12 @@ export declare function createNetworkDetailCommand(direction: 'rx' | 'tx' | 'tot
 /** Fresh objects are returned so settings drafts cannot mutate the factory defaults. */
 export declare function getBuiltinDefaults(): BuiltinDefinitions;
 /** Editing ignores legacy visibility switches so a disabled built-in can be configured. */
-export declare function getBuiltinDefinition<K extends BuiltinMetricKey>(key: K, conf?: BuiltinConfig): BuiltinDefinitions[K];
+export declare function getBuiltinDefinition<K extends StoredBuiltinMetricKey>(key: K, conf?: BuiltinConfig): BuiltinDefinitions[K];
 /** UI and collection consume the same editable built-in definitions. */
 export declare function getBuiltinDefinitions(conf?: BuiltinConfig): {
     customMetrics: CustomMetric[];
     metricGroups: CustomMetricGroup[];
 };
+/** One-time, lossless upgrade; the caller saves config only when this returns true. */
+export declare function migrateLegacyBuiltinConfig(conf: BuiltinConfig): boolean;
+export {};

package/typings/components/bottom-bar.component.d.ts

@@ -4,6 +4,7 @@ import { AppService, ConfigService } from 'tabby-core';
 import { StatsService } from '../services/stats.service';
 import { CustomMetric, CustomMetricGroup } from '../config';
 import { BuiltinMetricKey } from '../builtin-metrics';
+import { PaneGroupMode } from '../services/metric-scope.service';
 export declare class ServerStatsBottomBarComponent implements OnInit, OnDestroy {
     private statsService;
     private config;
@@ -13,6 +14,14 @@ export declare class ServerStatsBottomBarComponent implements OnInit, OnDestroy
     private sanitizer;
     visible: boolean;
     paneVisible: boolean;
+    menuOpen: boolean;
+    menuPosition: {
+        left: number;
+        top: number;
+    };
+    paneGroupMode: PaneGroupMode | undefined;
+    private paneToggle?;
+    private paneMenu?;
     loading: boolean;
     currentStats: any;
     customMetrics: CustomMetric[];
@@ -37,6 +46,17 @@ export declare class ServerStatsBottomBarComponent implements OnInit, OnDestroy
     private canDisplay;
     private isCurrentRequest;
     togglePaneVisibility(): void;
+    setPaneVisibility(visible: boolean): void;
+    setPaneGroupMode(mode: PaneGroupMode): void;
+    togglePaneMenu(event?: Event): void;
+    private positionPaneMenu;
+    private menuButtons;
+    private closePaneMenu;
+    onToggleKeydown(event: KeyboardEvent): void;
+    onMenuKeydown(event: KeyboardEvent): void;
+    onDocumentKeydown(event: KeyboardEvent): void;
+    onOutsideInteraction(event: Event): void;
+    onViewportResize(): void;
     renderExternalStats(stats: any | null): void;
     setExternalLoading(isLoading: boolean): void;
     hideExternal(): void;

package/typings/components/metric-strip.component.d.ts

@@ -21,6 +21,7 @@ export declare class MetricStripComponent implements OnInit, OnChanges, OnDestro
     session: any;
     autoDetailMetric: string | null;
     groupPopup?: ElementRef<HTMLElement>;
+    singlePopup?: ElementRef<HTMLElement>;
     carouselSlots?: QueryList<ElementRef<HTMLElement>>;
     private portal;
     private carouselWidths;
@@ -85,6 +86,9 @@ export declare class MetricStripComponent implements OnInit, OnChanges, OnDestro
     private updateCarousel;
     expanded(group: CustomMetricGroup, metric: CustomMetric): boolean;
     enterMetric(metric: CustomMetric): void;
+    enterSingle(metric: CustomMetric, event: Event): void;
+    keepSingle(metric: CustomMetric): void;
+    leaveSingle(metric: CustomMetric): void;
     leaveMetric(metric: CustomMetric): void;
     enterChild(group: CustomMetricGroup, metric: CustomMetric): void;
     enterGroup(group: CustomMetricGroup, event: Event): void;

package/typings/components/settings.component.d.ts

@@ -98,6 +98,11 @@ export declare class ServerStatsSettingsComponent {
     get metricGroups(): CustomMetricGroup[];
     get metricEditorTitle(): string;
     private uiText;
+    openTutorial(): void;
+    private copyLabel;
+    private independentCopy;
+    copyGroup(index: number): void;
+    copyChild(index: number): void;
     groupModeLabel(mode: string): string;
     groupModeHelp(mode: string): string;
     private newId;

package/typings/config.d.ts

@@ -3,10 +3,12 @@ import { CustomMetric, CustomMetricGroup, ColorCondition } from './metric-model'
 export { CustomMetric, CustomMetricGroup, ColorCondition, ConditionOperator, MetricStatus, MetricResult, DisplayScope } from './metric-model';
 export { getSvgPresetPath, isSvgPreset, isUrlOrDataUri, isFaIcon, formatFontAwesomeIcon, TECH_ICON_PATHS, POPULAR_ICON_PRESETS, DEFAULT_METRIC_ICONS } from './icons/presets';
 export interface DefaultMetricsConfig {
-    cpu: boolean;
     ram: boolean;
-    disk: boolean;
     net: boolean;
+    load: boolean;
+    /** Retained only to migrate older editable definitions without data loss. */
+    cpu?: boolean;
+    disk?: boolean;
 }
 export declare function evaluateColor(value: any, rules?: ColorCondition[], defaultColor?: string): string;
 export declare class ServerStatsConfigProvider extends ConfigProvider {
@@ -16,6 +18,7 @@ export declare class ServerStatsConfigProvider extends ConfigProvider {
                 enabled: boolean;
                 displayMode: string;
                 paneVisibility: Record<string, boolean>;
+                paneGroupModes: Record<string, string | boolean>;
                 defaultInterval: number;
                 debugLogging: boolean;
                 location: {
@@ -28,12 +31,17 @@ export declare class ServerStatsConfigProvider extends ConfigProvider {
                     layout: string;
                 };
                 defaultMetrics: {
-                    cpu: boolean;
                     ram: boolean;
-                    disk: boolean;
                     net: boolean;
+                    load: boolean;
+                    cpu: boolean;
+                    disk: boolean;
+                };
+                builtinDefaultsVersion: number;
+                builtinOrder: string[];
+                defaultMetricOverrides: {
+                    __nonStructural: boolean;
                 };
-                defaultMetricOverrides: {};
                 showDefaultIcons: boolean;
                 customMetrics: CustomMetric[];
                 metricGroups: CustomMetricGroup[];

package/typings/metric-display.d.ts

@@ -10,6 +10,9 @@ export declare function isNumericDisplayValue(value: string): boolean;
 export declare function formatNetworkRate(value: string): string;
 /** Use the requested capacity label, retaining the existing numbers and thresholds. */
 export declare function formatCapacityUnit(value: string): string;
+/** Add grouping without rounding capacity readings or changing their precision. */
+export declare function formatGroupedNumber(value: string): string;
+export declare function isCapacityUnit(unit: string): boolean;
 export interface NumericRatio {
     numerator: string;
     denominator: string;

package/typings/services/metric-scope.service.d.ts

@@ -4,6 +4,7 @@ import { ScopeContext } from '../display-scope';
 /** A saved layout's origin, persisted in its recovery token, never inferred from titles. */
 export declare const LAYOUT_SCOPE_MARKER = "__tabbyGroupServerStatsLayoutProfileId";
 export declare const INSTANCE_VISIBILITY_MARKER = "__tabbyGroupServerStatsVisibilityId";
+export type PaneGroupMode = 'overview' | 'carousel' | 'static';
 export declare class MetricScopeService implements OnDestroy {
     private config;
     private app;
@@ -32,7 +33,11 @@ export declare class MetricScopeService implements OnDestroy {
     /** A layout occurrence is stable across reopen; other panes own recovery-only IDs. */
     visibilityKey(session: any): string | undefined;
     isPaneVisible(session: any): boolean;
+    private panePreferenceKey;
+    private savePanePreference;
     setPaneVisible(session: any, visible: boolean): void;
+    getPaneGroupMode(session: any): PaneGroupMode | undefined;
+    setPaneGroupMode(session: any, mode: PaneGroupMode): void;
     /** Upgrade already restored layouts without guessing from a focused or sibling pane. */
     private rememberLegacyPanes;
     private paneTargetFor;

package/typings/services/stats.service.d.ts

@@ -1,6 +1,6 @@
 import { ConfigService } from 'tabby-core';
 import { CustomMetric, CustomMetricGroup } from '../metric-model';
-import { MetricScopeService } from './metric-scope.service';
+import { MetricScopeService, PaneGroupMode } from './metric-scope.service';
 import { Subject } from 'rxjs';
 export declare class StatsService {
     private config;
@@ -22,6 +22,8 @@ export declare class StatsService {
     private scopeContext;
     isPaneVisible(session: any): boolean;
     setPaneVisible(session: any, visible: boolean): void;
+    getPaneGroupMode(session: any): PaneGroupMode | undefined;
+    setPaneGroupMode(session: any, mode: PaneGroupMode): void;
     /** Disabled/out-of-scope commands never run. Unavailable items still refresh to detect recovery. */
     getVisibleConfig(session: any): {
         customMetrics: CustomMetric[];