Files
Netcatty/application/state/terminalSidePanelTabs.ts
T
陈大猫 fa4d0d5348 feat(ui): customizable dense toolbars (show / collapse / hide) (#2183)
* feat(ui): customizable dense toolbars with show/collapse/hide

Add a shared toolbar layout model so terminal, SFTP, and side-panel
action strips can right-click customize placement, overflow collapsed
items into the more menu, and persist order plus placement.

* fix(ui): harden toolbar layout placement after review

Address review findings: availability-aware reachability, skip
unavailable reorder neighbors, Popover overflow for nested SFTP menus,
path chrome outside customize context menu, and side-panel hide close.

* fix(ui): only close side panel when hide placement sticks

Return the next layout from setPlacement so hide-of-last-reachable
does not tear down the panel, keep an active hidden tab chip visible,
and rebuild terminal shown order with highlight collapse coercion.

* fix(ui): narrow SFTP overflow spill and close ⋮ after leaf actions

Respect user show/collapse/hide, then temporarily move non-pinned shown
actions into ⋮ when the SFTP toolbar is narrow. Close overflow after
leaf clicks while keeping nested bookmark/encoding panels usable.
2026-07-14 17:11:03 +08:00

131 lines
3.8 KiB
TypeScript

import { useCallback, useMemo } from 'react';
import {
normalizeToolbarItemLayout,
reorderToolbarItems,
type ToolbarItemLayout,
type ToolbarItemLayoutDefaults,
type ToolbarItemPlacement,
} from '../../domain/toolbarItemLayout';
import {
STORAGE_KEY_TERMINAL_SIDE_PANEL_TAB_LAYOUT,
STORAGE_KEY_TERMINAL_SIDE_PANEL_TAB_ORDER,
} from '../../infrastructure/config/storageKeys';
import { localStorageAdapter } from '../../infrastructure/persistence/localStorageAdapter';
import { useToolbarItemLayout } from './useToolbarItemLayout';
export type TerminalSidePanelTabId =
| 'sftp'
| 'scripts'
| 'history'
| 'theme'
| 'system'
| 'notes'
| 'ai';
export const TERMINAL_SIDE_PANEL_TAB_DEFAULT_ORDER: TerminalSidePanelTabId[] = [
'sftp',
'scripts',
'history',
'theme',
'system',
'notes',
'ai',
];
export const TERMINAL_SIDE_PANEL_TAB_IDS = new Set<TerminalSidePanelTabId>(
TERMINAL_SIDE_PANEL_TAB_DEFAULT_ORDER,
);
export const TERMINAL_SIDE_PANEL_TAB_LAYOUT_DEFAULTS: ToolbarItemLayoutDefaults = {
order: [...TERMINAL_SIDE_PANEL_TAB_DEFAULT_ORDER],
placement: Object.fromEntries(
TERMINAL_SIDE_PANEL_TAB_DEFAULT_ORDER.map((id) => [id, 'show' as const]),
),
};
/** Order-only normalizer (legacy + tests). */
export function normalizeTerminalSidePanelTabOrder(value: unknown): TerminalSidePanelTabId[] {
return normalizeToolbarItemLayout(value, TERMINAL_SIDE_PANEL_TAB_LAYOUT_DEFAULTS)
.order as TerminalSidePanelTabId[];
}
export function reorderTerminalSidePanelTab(
order: TerminalSidePanelTabId[],
draggedTab: TerminalSidePanelTabId,
targetTab: TerminalSidePanelTabId,
placement: 'before' | 'after' = 'before',
): TerminalSidePanelTabId[] {
const layout: ToolbarItemLayout = {
order,
placement: Object.fromEntries(order.map((id) => [id, 'show' as ToolbarItemPlacement])),
};
return reorderToolbarItems(layout, draggedTab, targetTab, placement)
.order as TerminalSidePanelTabId[];
}
/**
* Seed the modern layout storage from the legacy order-only key when needed.
*/
function migrateSidePanelTabLayoutIfNeeded(): void {
try {
const modern = localStorageAdapter.read(STORAGE_KEY_TERMINAL_SIDE_PANEL_TAB_LAYOUT);
if (modern != null) return;
const legacy = localStorageAdapter.read(STORAGE_KEY_TERMINAL_SIDE_PANEL_TAB_ORDER);
if (legacy == null) return;
const layout = normalizeToolbarItemLayout(legacy, TERMINAL_SIDE_PANEL_TAB_LAYOUT_DEFAULTS);
localStorageAdapter.write(STORAGE_KEY_TERMINAL_SIDE_PANEL_TAB_LAYOUT, layout);
} catch {
// Best effort.
}
}
migrateSidePanelTabLayoutIfNeeded();
export function useTerminalSidePanelTabOrder(): {
sidePanelTabOrder: TerminalSidePanelTabId[];
setSidePanelTabOrder: (order: TerminalSidePanelTabId[]) => void;
layout: ToolbarItemLayout;
setPlacement: ReturnType<typeof useToolbarItemLayout>['setPlacement'];
move: ReturnType<typeof useToolbarItemLayout>['move'];
reorder: (draggedId: string, targetId: string, placement?: 'before' | 'after') => void;
resetLayout: () => void;
partition: ReturnType<typeof useToolbarItemLayout>['partition'];
} {
const {
layout,
setPlacement,
setOrder,
move,
reorder,
reset,
partition,
} = useToolbarItemLayout(
STORAGE_KEY_TERMINAL_SIDE_PANEL_TAB_LAYOUT,
TERMINAL_SIDE_PANEL_TAB_LAYOUT_DEFAULTS,
);
const sidePanelTabOrder = layout.order as TerminalSidePanelTabId[];
const setSidePanelTabOrder = useCallback(
(order: TerminalSidePanelTabId[]) => {
setOrder(order);
},
[setOrder],
);
return useMemo(
() => ({
sidePanelTabOrder,
setSidePanelTabOrder,
layout,
setPlacement,
move,
reorder,
resetLayout: reset,
partition,
}),
[layout, move, partition, reorder, reset, setPlacement, setSidePanelTabOrder, sidePanelTabOrder],
);
}